@gitsense/gscb-git-tools 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -3,16 +3,17 @@ import { Repository, GitCommitInfo } from '@gitsense/gscb-git';
 
 /**
  * Component: Shared Types
- * Block-UUID: a4699409-238b-4360-9ac0-ca441128fe55
- * Parent-UUID: 3b1e5a1f-0e3a-4b0d-8e1a-7f8b9c0d1e2f
- * Version: 5.4.0
- * Description: Add branch context to GitBlobMeta for efficient branch lookups
+ * Block-UUID: 91ba4c76-8e03-4a47-9668-9d36d091ff92
+ * Parent-UUID: 63f9f2ef-c6b2-47d4-87d4-d39946090fa1
+ * Version: 6.1.0
+ * Description: Add displayRepoPath option to support shadow repositories
  * Language: TypeScript
  * Created-at: 2025-02-28T12:00:00.000Z
- * Updated-at: 2025-10-09T03:50:09.655Z
+ * Updated-at: 2026-05-13T19:57:00.000Z
  * Authors: OpenRouter - DeepSeek v3 (v1.0.0), Claude 3.5 Sonnet (v2.0.0), Bard, together.ai - DeepSeek v3 (v3.2.0),
  *          DeepSeek v3 (v4.0.0), together.ai - DeepSeek v3 (v5.0.0), Qwen 3 Coder 480B - Cerebras (v5.1.0),
- *          Qwen 3 Coder 480B - Cerebras (v5.2.0), Qwen 3 Coder 480B - Cerebras (v5.3.0), Claude 4.0 Sonnet (v5.4.0)
+ *          Qwen 3 Coder 480B - Cerebras (v5.2.0), Qwen 3 Coder 480B - Cerebras (v5.3.0), Claude 4.0 Sonnet (v5.4.0),
+ *          GLM-4.7 (v6.0.0), GLM-4.7 (v6.1.0)
  */
 
 /**
@@ -26,6 +27,8 @@ interface ImportOptions {
     promptName?: string;
     skipBinaryFiles?: boolean;
     verbose?: boolean;
+    structuredOutput?: boolean;
+    displayRepoPath?: string;
 }
 /**
  * Allowed group types
@@ -46,17 +49,31 @@ interface ChatManagerOptions {
     verbose?: boolean;
     skipPatterns?: RegExp[];
     includePatterns?: RegExp[];
+    displayRepoPath?: string;
+}
+/**
+ * Event types for structured output
+ */
+type ImportEventType = 'init' | 'resume_detected' | 'scan_complete' | 'plan' | 'file_start' | 'file_done' | 'file_skip' | 'complete' | 'error';
+/**
+ * Event payload for structured output
+ */
+interface ImportEvent {
+    type: ImportEventType;
+    timestamp: string;
+    data: Record<string, unknown>;
 }
 
 /**
  * Component: Git Repository Importer (Core)
- * Block-UUID: 90d78242-374a-4a78-9ce6-e502bf172d87
- * Parent-UUID: 31839e44-58af-43ea-baab-96674d745ad0
- * Version: 6.6.0
- * Purpose: Core implementation of GitImporter class
+ * Block-UUID: 23dda2c0-82ba-4d2e-bf83-c26bc2d394da
+ * Parent-UUID: 90d78242-374a-4a78-9ce6-e502bf172d87
+ * Version: 6.7.0
+ * Purpose: Add structured output event emission (init, complete, error)
  * Language: TypeScript
  * Created-at: 2025-03-15T05:57:33.811Z
- * Authors: Claude 3.5 Sonnet (v5.0.1), Bard, Claude 3.5 Sonnet (v6.0.0), Claude 3.7 Sonnet (v6.3.0), OpenRouter - Gemini Flash 2.0 (v6.4.0), OpenRouter - Gemini Flash 2.0 (v6.5.0), together.ai - DeepSeek v3 (v6.6.0)
+ * Updated-at: 2026-05-13T14:46:00.000Z
+ * Authors: Claude 3.5 Sonnet (v5.0.1), Bard, Claude 3.5 Sonnet (v6.0.0), Claude 3.7 Sonnet (v6.3.0), OpenRouter - Gemini Flash 2.0 (v6.4.0), OpenRouter - Gemini Flash 2.0 (v6.5.0), together.ai - DeepSeek v3 (v6.6.0), GLM-4.7 (v6.7.0)
  */
 
 declare class GitImporter {
@@ -95,43 +112,48 @@ declare class GitImporter {
 
 /**
  * Component: Logger
- * Block-UUID: 68b41f13-71ad-4b4e-a488-460e234ed5b1
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Purpose: Centralized logging utility for the application.
+ * Block-UUID: 7c6851c4-f157-4955-a840-11b6e8b9b513
+ * Parent-UUID: 7c3b5d3f-96bd-4626-b408-a3322720c1d3
+ * Version: 2.1.0
+ * Purpose: Ensure error messages always go to stderr, even in structured mode
  * Language: TypeScript
  * Created-at: 2025-03-12T18:06:11.373Z
- * Authors: OpenRouter - Gemini Flash 2.0 (v1.0.0)
+ * Updated-at: 2026-05-13T15:10:00.000Z
+ * Authors: OpenRouter - Gemini Flash 2.0 (v1.0.0), GLM-4.7 (v2.0.0), GLM-4.7 (v2.1.0)
  */
 declare class Logger {
     private readonly verbose;
-    constructor(verbose?: boolean);
+    private readonly structuredOutput;
+    constructor(verbose?: boolean, structuredOutput?: boolean);
+    /**
+     * Emits a structured event to stdout.
+     * Only writes if structuredOutput is enabled.
+     */
+    emit(type: string, data?: Record<string, unknown>): void;
     /**
      * Logs messages to the console if verbose mode is enabled.
+     * Suppressed in structured mode to avoid polluting the NDJSON stream.
      */
     log(message: string, details?: unknown, isError?: boolean): void;
     /**
      * Logs a debug message.
-     * @param message - The message to log.
-     * @param details - Optional details to include in the log.
+     * Suppressed in structured mode.
      */
     debug(message: string, details?: unknown): void;
     /**
      * Logs an info message.
-     * @param message - The message to log.
-     * @param details - Optional details to include in the log.
+     * Suppressed in structured mode.
      */
     info(message: string, details?: unknown): void;
     /**
      * Logs a warning message.
-     * @param message - The message to log.
-     * @param details - Optional details to include in the log.
+     * Suppressed in structured mode.
      */
     warn(message: string, details?: unknown): void;
     /**
      * Logs an error message.
-     * @param message - The message to log.
-     * @param error - Optional error object to include in the log.
+     * IMPORTANT: Always writes to stderr, even in structured mode.
+     * This ensures non-fatal errors (e.g., rollback failures) are visible for debugging.
      */
     error(message: string, error?: unknown): void;
 }
@@ -214,4 +236,4 @@ declare class ChatManager {
     getChatById(chatId: number): Promise<Chat>;
 }
 
-export { ChatManager, GitImporter, type ImportOptions, Logger };
+export { ChatManager, GitImporter, type ImportEvent, type ImportEventType, type ImportOptions, Logger };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gitsense/gscb-git-tools",
-    "version": "0.6.0",
+    "version": "0.8.0",
     "description": "Git repository tools for the GitSense Chat Bridge (GSCB)",
     "type": "module",
     "main": "./dist/cjs/index.js",
@@ -24,7 +24,7 @@
     },
     "dependencies": {
         "events": "^3.3.0",
-        "@gitsense/gscb-db": "^0.5.0",
+        "@gitsense/gscb-db": "^0.7.0",
         "@gitsense/gscb-git": "^0.2.0",
         "@gitsense/gscb-utils": "^0.1.0"
     },