githits 0.3.3 → 0.4.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   version
-} from "./shared/chunk-tze0rsay.js";
+} from "./shared/chunk-fqzth5mv.js";
 export {
   version
 };

package/dist/shared/{chunk-2d202fpq.js → chunk-1cyka46a.js}

@@ -1,7 +1,7 @@
 import {
   __require,
   version
-} from "./chunk-tze0rsay.js";
+} from "./chunk-fqzth5mv.js";
 
 // src/services/app-config-paths.ts
 var APP_DIR = "githits";
@@ -169,12 +169,15 @@ class AuthServiceImpl {
     return url.toString();
   }
   startCallbackServer(port, expectedState) {
-    return new Promise((resolve, reject) => {
-      let callbackHandled = false;
-      let resolved = false;
-      let closeTimer;
-      const server = createServer((req, res) => {
-        const url = new URL(req.url ?? "", `http://127.0.0.1:${port}`);
+    let closeTimer;
+    const server = createServer();
+    let callbackHandled = false;
+    let resolved = false;
+    const result = new Promise((resolve) => {
+      server.on("request", (req, res) => {
+        const address = server.address();
+        const actualPort = typeof address === "object" && address !== null ? address.port : port;
+        const url = new URL(req.url ?? "", `http://127.0.0.1:${actualPort}`);
         if (url.pathname === "/favicon.ico") {
           res.writeHead(204);
           res.end();
@@ -209,9 +212,23 @@ class AuthServiceImpl {
           clearTimeout(closeTimer);
         closeTimer = setTimeout(() => closeServer(server), 1500);
       });
-      server.listen(port, "127.0.0.1");
-      server.on("error", (err) => {
+    });
+    return new Promise((resolve, reject) => {
+      const onError = (err) => {
         reject(new Error(`Failed to start callback server: ${err.message}`));
+      };
+      server.once("error", onError);
+      server.listen(port, "127.0.0.1", () => {
+        server.off("error", onError);
+        server.on("error", () => {});
+        resolve({
+          result,
+          close: async () => {
+            if (closeTimer)
+              clearTimeout(closeTimer);
+            await closeServer(server);
+          }
+        });
       });
     });
   }
@@ -557,7 +574,18 @@ function sendHtmlResponse(res, statusCode, html) {
   res.end(html);
 }
 function closeServer(server) {
-  server.close();
+  return new Promise((resolve, reject) => {
+    if (!server.listening) {
+      resolve();
+      return;
+    }
+    server.close((error) => {
+      if (error)
+        reject(error);
+      else
+        resolve();
+    });
+  });
 }
 function escapeHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
@@ -837,13 +865,11 @@ class ClientUpdateRequiredError extends Error {
   }
 }
 function isClientUpdateRequiredGraphQLError(input) {
-  if (input.code === "CLIENT_UPDATE_REQUIRED") {
-    return true;
-  }
-  const message = input.message;
-  if (!isGraphQLSchemaMismatchMessage(message)) {
+  return input.code === "CLIENT_UPDATE_REQUIRED";
+}
+function isGraphQLSchemaMismatchError(input) {
+  if (!isGraphQLSchemaMismatchMessage(input.message))
     return false;
-  }
   return !input.code || input.code === "GRAPHQL_VALIDATION_FAILED" || input.code === "BAD_USER_INPUT";
 }
 function isGraphQLSchemaMismatchMessage(message) {
@@ -1499,6 +1525,10 @@ query UnifiedSearch(
         id
         resultType
         targetLabel
+        requestedTargetLabel
+        freshTargetLabel
+        servedTargetLabel
+        freshness
         title
         summary
         score
@@ -1537,6 +1567,9 @@ query UnifiedSearch(
       sourceStatus {
         source
         targetLabel
+        requestedTargetLabel
+        freshTargetLabel
+        servedTargetLabel
         indexingStatus
         codeIndexState
         resultCount
@@ -1558,6 +1591,32 @@ query UnifiedSearch(
       query
       queryWarnings
       sources
+      requestedSources
+      targetMode
+      requestedTargets {
+        registry
+        name
+        version
+        repoUrl
+        gitRef
+      }
+      filters {
+        fileIntent
+        kind
+        category
+        publicOnly
+        pathPrefix
+      }
+      limit
+      offset
+      targets {
+        requested
+        resolvedRequested
+        served
+        freshness
+        indexingRef
+        requestedRefKind
+      }
       expiresAt
     }
   }
@@ -1573,6 +1632,32 @@ query UnifiedSearchStatus($searchRef: String!, $includeResults: Boolean!) {
     query
     queryWarnings
     sources
+    requestedSources
+    targetMode
+    requestedTargets {
+      registry
+      name
+      version
+      repoUrl
+      gitRef
+    }
+    filters {
+      fileIntent
+      kind
+      category
+      publicOnly
+      pathPrefix
+    }
+    limit
+    offset
+    targets {
+      requested
+      resolvedRequested
+      served
+      freshness
+      indexingRef
+      requestedRefKind
+    }
     expiresAt
     results {
       query
@@ -1582,6 +1667,10 @@ query UnifiedSearchStatus($searchRef: String!, $includeResults: Boolean!) {
         id
         resultType
         targetLabel
+        requestedTargetLabel
+        freshTargetLabel
+        servedTargetLabel
+        freshness
         title
         summary
         score
@@ -1620,6 +1709,9 @@ query UnifiedSearchStatus($searchRef: String!, $includeResults: Boolean!) {
       sourceStatus {
         source
         targetLabel
+        requestedTargetLabel
+        freshTargetLabel
+        servedTargetLabel
         indexingStatus
         codeIndexState
         resultCount
@@ -1716,6 +1808,10 @@ var unifiedSearchHitSchema = z2.object({
   id: z2.string(),
   resultType: unifiedSearchResultTypeSchema,
   targetLabel: z2.string(),
+  requestedTargetLabel: z2.string().nullable().optional(),
+  freshTargetLabel: z2.string().nullable().optional(),
+  servedTargetLabel: z2.string().nullable().optional(),
+  freshness: z2.string().nullable().optional(),
   title: z2.string().nullable().optional(),
   summary: z2.string().nullable().optional(),
   score: z2.number().nullable().optional(),
@@ -1734,6 +1830,9 @@ var unifiedSearchPageInfoSchema = z2.object({
 var unifiedSearchSourceStatusSchema = z2.object({
   source: unifiedSearchSourceSchema,
   targetLabel: z2.string(),
+  requestedTargetLabel: z2.string().nullable().optional(),
+  freshTargetLabel: z2.string().nullable().optional(),
+  servedTargetLabel: z2.string().nullable().optional(),
   indexingStatus: z2.string().nullable().optional(),
   codeIndexState: z2.string().nullable().optional(),
   resultCount: z2.number().int().nullable().optional(),
@@ -1762,6 +1861,28 @@ var unifiedSearchSessionStatusSchema = z2.enum([
   "TIMEOUT",
   "FAILED"
 ]);
+var unifiedSearchFiltersSchema = z2.object({
+  fileIntent: z2.string().nullable().optional(),
+  kind: z2.string().nullable().optional(),
+  category: z2.string().nullable().optional(),
+  publicOnly: z2.boolean().nullable().optional(),
+  pathPrefix: z2.string().nullable().optional()
+}).nullable().optional();
+var unifiedSearchProgressTargetSchema = z2.object({
+  requested: z2.string().nullable().optional(),
+  resolvedRequested: z2.string().nullable().optional(),
+  served: z2.string().nullable().optional(),
+  freshness: z2.string().nullable().optional(),
+  indexingRef: z2.string().nullable().optional(),
+  requestedRefKind: z2.string().nullable().optional()
+});
+var unifiedSearchRequestedTargetSchema = z2.object({
+  registry: z2.string().nullable().optional(),
+  name: z2.string().nullable().optional(),
+  version: z2.string().nullable().optional(),
+  repoUrl: z2.string().nullable().optional(),
+  gitRef: z2.string().nullable().optional()
+});
 var unifiedSearchProgressSchema = z2.object({
   searchRef: z2.string(),
   status: unifiedSearchSessionStatusSchema,
@@ -1771,6 +1892,13 @@ var unifiedSearchProgressSchema = z2.object({
   query: z2.string(),
   queryWarnings: z2.array(z2.string()),
   sources: z2.array(unifiedSearchSourceSchema),
+  requestedSources: z2.array(unifiedSearchSourceSchema).nullable().optional(),
+  targetMode: z2.string().nullable().optional(),
+  requestedTargets: z2.array(unifiedSearchRequestedTargetSchema).nullable().optional(),
+  filters: unifiedSearchFiltersSchema,
+  limit: z2.number().int().nullable().optional(),
+  offset: z2.number().int().nullable().optional(),
+  targets: z2.array(unifiedSearchProgressTargetSchema).nullable().optional(),
   expiresAt: z2.string().nullable().optional(),
   results: unifiedSearchResultSchema.nullable().optional()
 });
@@ -2271,6 +2399,15 @@ class CodeNavigationServiceImpl {
     if (isClientUpdateRequiredGraphQLError({ message, code })) {
       return new ClientUpdateRequiredError;
     }
+    if (isGraphQLSchemaMismatchError({ message, code })) {
+      const sanitized = "Backend protocol mismatch. Your CLI may be newer than the server, or the server may require a newer CLI. Run `githits update-check` to verify your installed version. Set GITHITS_DEBUG=code-nav-wire to inspect GraphQL details during local development.";
+      debugLog("code-nav", {
+        event: "graphql-schema-mismatch",
+        code: code ?? "omitted",
+        message
+      });
+      return new CodeNavigationBackendError(isDebugAreaEnabled("code-nav-wire") ? message : sanitized, undefined, code, retryable);
+    }
     switch (code) {
       case "PACKAGE_INDEXING":
         return new CodeNavigationIndexingError(this.createIndexingMessage(indexingRef), indexingRef, parseAvailableVersions(extensions));
@@ -2375,6 +2512,10 @@ class CodeNavigationServiceImpl {
         id: entry.id,
         resultType: entry.resultType,
         targetLabel: entry.targetLabel,
+        requestedTargetLabel: entry.requestedTargetLabel ?? undefined,
+        freshTargetLabel: entry.freshTargetLabel ?? undefined,
+        servedTargetLabel: entry.servedTargetLabel ?? undefined,
+        freshness: entry.freshness ?? undefined,
         title: entry.title ?? undefined,
         summary: entry.summary ?? undefined,
         score: entry.score ?? undefined,
@@ -2413,6 +2554,9 @@ class CodeNavigationServiceImpl {
       sourceStatus: result.sourceStatus.map((entry) => ({
         source: entry.source,
         targetLabel: entry.targetLabel,
+        requestedTargetLabel: entry.requestedTargetLabel ?? undefined,
+        freshTargetLabel: entry.freshTargetLabel ?? undefined,
+        servedTargetLabel: entry.servedTargetLabel ?? undefined,
         indexingStatus: entry.indexingStatus ?? undefined,
         codeIndexState: entry.codeIndexState ?? undefined,
         resultCount: entry.resultCount ?? undefined,
@@ -2436,6 +2580,26 @@ class CodeNavigationServiceImpl {
       query: progress.query,
       queryWarnings: progress.queryWarnings,
       sources: progress.sources,
+      requestedSources: progress.requestedSources ?? undefined,
+      targetMode: normaliseTargetMode(progress.targetMode),
+      requestedTargets: progress.requestedTargets?.map((target) => ({
+        registry: target.registry ? target.registry : undefined,
+        name: target.name ?? undefined,
+        version: target.version ?? undefined,
+        repoUrl: target.repoUrl ?? undefined,
+        gitRef: target.gitRef ?? undefined
+      })),
+      filters: normaliseProgressFilters(progress.filters),
+      limit: progress.limit ?? undefined,
+      offset: progress.offset ?? undefined,
+      targets: progress.targets?.map((target) => ({
+        requested: target.requested ?? undefined,
+        resolvedRequested: target.resolvedRequested ?? undefined,
+        served: target.served ?? undefined,
+        freshness: target.freshness ?? undefined,
+        indexingRef: target.indexingRef ?? undefined,
+        requestedRefKind: normaliseRequestedRefKind(target.requestedRefKind)
+      })),
       expiresAt: progress.expiresAt ?? undefined
     };
   }
@@ -2755,6 +2919,43 @@ function isAuthMessage(message) {
   const lower = message.toLowerCase();
   return lower.includes("unauthorized") || lower.includes("forbidden") || lower.includes("permission") || lower.includes("authentication");
 }
+function normaliseTargetMode(value) {
+  if (value === "PACKAGES" || value === "REPO" || value === "MIXED") {
+    return value;
+  }
+  return;
+}
+function normaliseRequestedRefKind(value) {
+  switch (value) {
+    case "OMITTED_VERSION":
+    case "LATEST_VERSION":
+    case "EXACT_VERSION":
+    case "DEFAULT_BRANCH":
+    case "HEAD":
+    case "BRANCH":
+    case "SHA":
+      return value;
+    default:
+      return;
+  }
+}
+function normaliseProgressFilters(filters) {
+  if (!filters)
+    return;
+  const out = {};
+  if (filters.fileIntent)
+    out.fileIntent = filters.fileIntent;
+  if (filters.kind)
+    out.kind = filters.kind;
+  if (filters.category)
+    out.category = filters.category;
+  if (typeof filters.publicOnly === "boolean") {
+    out.publicOnly = filters.publicOnly;
+  }
+  if (filters.pathPrefix)
+    out.pathPrefix = filters.pathPrefix;
+  return Object.keys(out).length > 0 ? out : undefined;
+}
 function isTargetNotFoundMessage(message) {
   const lower = message.toLowerCase();
   return lower.includes("not found") || lower.includes("unknown package") || lower.includes("no such package") || lower.includes("does not exist");
@@ -4412,6 +4613,15 @@ class PackageIntelligenceServiceImpl {
     if (isClientUpdateRequiredGraphQLError({ message, code })) {
       return new ClientUpdateRequiredError;
     }
+    if (isGraphQLSchemaMismatchError({ message, code })) {
+      const sanitized = "Backend protocol mismatch. Your CLI may be newer than the server, or the server may require a newer CLI. Run `githits update-check` to verify your installed version. Set GITHITS_DEBUG=pkg-graphql to inspect GraphQL details during local development.";
+      debugLog("pkg-graphql", {
+        event: "graphql-schema-mismatch",
+        code: code ?? "omitted",
+        message
+      });
+      return new PackageIntelligenceBackendError(isDebugAreaEnabled("pkg-graphql") ? message : sanitized, undefined, code, retryable);
+    }
     switch (code) {
       case "NOT_FOUND":
       case "PACKAGE_NOT_FOUND":
@@ -4814,7 +5024,7 @@ class PackageIntelligenceServiceImpl {
     return this.normaliseChangelogReport(data, params);
   }
   normaliseChangelogReport(data, params) {
-    const source = data.source && data.source.trim() ? data.source : undefined;
+    const source = data.source?.trim() ? data.source : undefined;
     const rawEntries = data.entries ?? [];
     if (!source && rawEntries.length === 0) {
       const target = params.repoUrl ?? (params.registry && params.packageName ? `${params.registry.toLowerCase()}:${params.packageName}` : "package");

package/dist/shared/{chunk-b6avnx6d.js → chunk-1h7sanjw.js}

@@ -2,8 +2,8 @@ import {
   createAuthCommandDependencies,
   createAuthStatusDependencies,
   createContainer
-} from "./chunk-2d202fpq.js";
-import"./chunk-tze0rsay.js";
+} from "./chunk-1cyka46a.js";
+import"./chunk-fqzth5mv.js";
 export {
   createContainer,
   createAuthStatusDependencies,

package/dist/shared/{chunk-tze0rsay.js → chunk-fqzth5mv.js}

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // package.json
-var version = "0.3.3";
+var version = "0.4.0";
 
 export { __require, version };

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Code examples from global open source for developers and AI assistants.",
   "mcpServers": {
     "githits": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "githits",
   "description": "CLI companion for GitHits - code examples from global open source for developers and AI assistants",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "type": "module",
   "files": [
     "dist",

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Code examples from global open source for developers and AI assistants",
   "author": {
     "name": "GitHits"