@ginkoai/cli 1.0.0 → 1.4.1

package/dist/utils/context-loader.js

@@ -0,0 +1,411 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-22
+ * @tags: [context-loading, progressive, strategic, performance, adr-037, task-011]
+ * @related: [config-loader.ts, reference-parser.ts, start-reflection.ts]
+ * @priority: high
+ * @complexity: high
+ * @dependencies: [fs-extra, path, reference-parser, config-loader]
+ */
+/**
+ * Progressive Context Loader (TASK-011)
+ *
+ * Implements strategic priority-ordered context loading that follows reference chains
+ * to achieve 80% of needed context from 3-5 core documents instead of 50+ files.
+ *
+ * Goals:
+ * - Load context in <1 second
+ * - Achieve 80% context from ≤5 documents
+ * - Reduce token usage by 70% vs full-scan approach
+ * - Follow reference chains with depth limit
+ * - Work mode filtering for documentation depth
+ *
+ * Based on PRD-009, ADR-037, and TASK-011
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { extractReferences, resolveReference } from './reference-parser.js';
+import { loadProjectConfig, loadLocalConfig, resolveProjectPath } from './config-loader.js';
+import { BacklogBase } from '../commands/backlog/base.js';
+/**
+ * Context Loader - Strategic progressive loading
+ */
+export class ContextLoader {
+    loaded = new Map();
+    visited = new Set(); // Circular reference detection
+    config = null;
+    startTime = 0;
+    cacheHits = 0;
+    maxReferenceDepth = 0;
+    backlog = null;
+    constructor() {
+        this.startTime = Date.now();
+    }
+    /**
+     * Load context strategically with priority ordering
+     * Priority: session log → sprint → backlog fallback → references → modules
+     *
+     * @param options - Loading options
+     * @returns StrategyContext with loaded documents and metrics
+     */
+    async loadContextStrategic(options = {}) {
+        this.startTime = Date.now();
+        const config = await loadProjectConfig();
+        const localConfig = await loadLocalConfig();
+        this.config = config;
+        // Initialize backlog for task status checking
+        this.backlog = new BacklogBase();
+        try {
+            await this.backlog.init();
+        }
+        catch {
+            // Backlog not available, continue without it
+            this.backlog = null;
+        }
+        const workMode = options.workMode || config.workMode.default;
+        const maxDepth = options.maxDepth ?? config.contextLoading.maxDepth;
+        const followRefs = options.followReferences ?? config.contextLoading.followReferences;
+        const references = new Map();
+        const loadOrder = [];
+        // 0. Load always-load core modules (TASK-015)
+        await this.loadAlwaysLoadModules(config, workMode, loadOrder, localConfig.projectRoot);
+        // 1. Load session log (short-term memory)
+        const sessionLog = await this.loadSessionContext(options.sessionDir || path.join(localConfig.projectRoot, '.ginko/sessions', localConfig.userSlug));
+        if (sessionLog) {
+            loadOrder.push('session-log');
+        }
+        // 2. Load current sprint (long-term bootstrap)
+        const sprint = await this.loadSprintContext();
+        if (sprint) {
+            loadOrder.push('current-sprint');
+        }
+        // 3. Fallback: If no sprint, load active backlog items
+        if (!sprint && this.backlog) {
+            await this.loadBacklogContext(loadOrder, workMode);
+        }
+        // 4. Extract references from loaded docs
+        if (followRefs) {
+            const combinedContent = [
+                sessionLog?.content || '',
+                sprint?.content || ''
+            ].join('\n');
+            const extractedRefs = extractReferences(combinedContent);
+            // 5. Follow references with depth limit, work mode, and status filtering
+            const filteredRefs = this.filterByWorkMode(extractedRefs, workMode);
+            await this.followReferences(filteredRefs, maxDepth, references, loadOrder);
+        }
+        // Calculate metrics
+        const metrics = this.calculateMetrics();
+        return {
+            documents: this.loaded,
+            references,
+            metrics,
+            loadOrder,
+            workMode
+        };
+    }
+    /**
+     * Load session log from sessions directory
+     */
+    async loadSessionContext(sessionDir) {
+        const sessionLogPath = path.join(sessionDir, 'current-session-log.md');
+        if (!(await fs.pathExists(sessionLogPath))) {
+            return null;
+        }
+        return this.loadDocument(sessionLogPath, 'session-log');
+    }
+    /**
+     * Load current sprint document
+     */
+    async loadSprintContext() {
+        try {
+            const sprintPath = await resolveProjectPath('currentSprint');
+            if (!(await fs.pathExists(sprintPath))) {
+                return null;
+            }
+            return this.loadDocument(sprintPath, 'sprint');
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load always-load core modules based on work mode (TASK-015)
+     * These provide foundational knowledge for immediate AI productivity
+     */
+    async loadAlwaysLoadModules(config, workMode, loadOrder, projectRoot) {
+        const alwaysLoadConfig = config.contextLoading.alwaysLoad;
+        if (!alwaysLoadConfig) {
+            return; // No always-load configuration
+        }
+        const modulePaths = alwaysLoadConfig[workMode] || [];
+        for (const modulePath of modulePaths) {
+            const absolutePath = path.join(projectRoot, modulePath);
+            if (await fs.pathExists(absolutePath)) {
+                const doc = await this.loadDocument(absolutePath, 'core-module');
+                if (doc) {
+                    loadOrder.push(path.basename(modulePath, '.md'));
+                }
+            }
+        }
+    }
+    /**
+     * Load active backlog items as fallback when no sprint exists
+     * Only loads in-progress and high-priority items based on work mode
+     */
+    async loadBacklogContext(loadOrder, workMode) {
+        if (!this.backlog)
+            return;
+        try {
+            // Load in-progress items (always relevant)
+            const inProgress = await this.backlog.listItems({ status: 'in-progress' });
+            // Load high-priority todo items (limited by work mode)
+            const highPriority = await this.backlog.listItems({
+                status: 'todo',
+                priority: 'critical'
+            });
+            // Combine and limit based on work mode
+            const itemsToLoad = [...inProgress, ...highPriority];
+            const limit = workMode === 'hack-ship' ? 1 : workMode === 'think-build' ? 3 : 5;
+            for (const item of itemsToLoad.slice(0, limit)) {
+                const itemPath = path.join(this.backlog['itemsDir'], `${item.id}.md`);
+                if (await fs.pathExists(itemPath)) {
+                    await this.loadDocument(itemPath, 'backlog-item');
+                    loadOrder.push(item.id);
+                }
+            }
+        }
+        catch (error) {
+            // Backlog loading failed, continue without it
+        }
+    }
+    /**
+     * Follow reference chains recursively with depth limit
+     */
+    async followReferences(refs, maxDepth, referencesMap, loadOrder, currentDepth = 0) {
+        if (currentDepth >= maxDepth) {
+            return;
+        }
+        // Track maximum depth reached
+        this.maxReferenceDepth = Math.max(this.maxReferenceDepth, currentDepth);
+        for (const ref of refs) {
+            const refKey = `${ref.type}:${ref.id}`;
+            // Skip if already visited (circular reference)
+            if (this.visited.has(refKey)) {
+                this.cacheHits++;
+                continue;
+            }
+            this.visited.add(refKey);
+            // Check backlog status for tasks/features (skip completed)
+            if (this.backlog && (ref.type === 'task' || ref.type === 'feature')) {
+                const item = await this.backlog.loadItem(ref.id);
+                if (item && item.status === 'done') {
+                    // Skip completed items - they're not relevant to current work
+                    this.visited.add(refKey); // Mark as visited to avoid re-checking
+                    continue;
+                }
+            }
+            // Resolve reference
+            const resolved = await resolveReference(ref);
+            referencesMap.set(refKey, resolved);
+            if (!resolved.exists || !resolved.filePath) {
+                continue;
+            }
+            // Load referenced document
+            const doc = await this.loadDocument(resolved.filePath, ref.type);
+            if (!doc)
+                continue;
+            loadOrder.push(ref.rawText);
+            // Extract nested references and follow recursively
+            const nestedRefs = extractReferences(doc.content);
+            const filteredNestedRefs = this.filterByWorkMode(nestedRefs, this.getCurrentWorkMode());
+            await this.followReferences(filteredNestedRefs, maxDepth, referencesMap, loadOrder, currentDepth + 1);
+        }
+    }
+    /**
+     * Filter references by work mode documentation depth
+     */
+    filterByWorkMode(refs, workMode) {
+        if (!this.config)
+            return refs;
+        const allowedTypes = this.config.workMode.documentationDepth[workMode];
+        // Map reference types to config path keys
+        const typeMapping = {
+            task: 'backlog',
+            feature: 'backlog',
+            prd: 'prds',
+            adr: 'adrs',
+            sprint: 'sprints'
+        };
+        return refs.filter(ref => {
+            const pathKey = typeMapping[ref.type];
+            // Check if this reference type should be loaded for this work mode
+            if (workMode === 'hack-ship') {
+                // Only load sprints and tasks in hack-ship mode
+                return ref.type === 'sprint' || ref.type === 'task';
+            }
+            if (workMode === 'think-build') {
+                // Load sprints, tasks, PRDs, ADRs
+                return ['sprint', 'task', 'prd', 'adr'].includes(ref.type);
+            }
+            // full-planning: load everything
+            return true;
+        });
+    }
+    /**
+     * Load a document and add to loaded cache
+     */
+    async loadDocument(filePath, type) {
+        // Check if already loaded (cache)
+        if (this.loaded.has(filePath)) {
+            this.cacheHits++;
+            return this.loaded.get(filePath);
+        }
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const tokens = this.estimateTokens(content);
+            const relativePath = this.getRelativePath(filePath);
+            const doc = {
+                path: filePath,
+                relativePath,
+                content,
+                type,
+                tokens,
+                loadedAt: Date.now(),
+                referencedBy: []
+            };
+            this.loaded.set(filePath, doc);
+            return doc;
+        }
+        catch (error) {
+            // File doesn't exist or can't be read
+            return null;
+        }
+    }
+    /**
+     * Estimate token count (rough approximation: 1 token ≈ 4 characters)
+     */
+    estimateTokens(content) {
+        return Math.ceil(content.length / 4);
+    }
+    /**
+     * Get relative path from absolute path
+     */
+    getRelativePath(absolutePath) {
+        try {
+            const projectRoot = process.cwd();
+            return path.relative(projectRoot, absolutePath);
+        }
+        catch {
+            return absolutePath;
+        }
+    }
+    /**
+     * Get current work mode (from config or default)
+     */
+    getCurrentWorkMode() {
+        return this.config?.workMode.default || 'think-build';
+    }
+    /**
+     * Calculate context efficiency metrics
+     */
+    calculateMetrics() {
+        const totalTokens = Array.from(this.loaded.values())
+            .reduce((sum, doc) => sum + doc.tokens, 0);
+        const bootstrapTimeMs = Date.now() - this.startTime;
+        // Baseline: full-scan would load ~50 documents × 500 tokens = 25,000 tokens
+        const baselineTokens = 25000;
+        const tokenReductionPercent = Math.round(((baselineTokens - totalTokens) / baselineTokens) * 100);
+        return {
+            documentsLoaded: this.loaded.size,
+            totalTokens,
+            bootstrapTimeMs,
+            cacheHits: this.cacheHits,
+            referenceDepth: this.maxReferenceDepth,
+            tokenReductionPercent: Math.max(0, tokenReductionPercent)
+        };
+    }
+    /**
+     * Measure context efficiency (for testing and monitoring)
+     */
+    measureContextEfficiency(context) {
+        const { metrics } = context;
+        const issues = [];
+        // Goal: Context loading completes in <1 second
+        if (metrics.bootstrapTimeMs > 1000) {
+            issues.push(`Bootstrap time ${metrics.bootstrapTimeMs}ms exceeds 1000ms target`);
+        }
+        // Goal: 80% context from ≤5 documents
+        if (metrics.documentsLoaded > 5) {
+            issues.push(`Loaded ${metrics.documentsLoaded} documents, target is ≤5 for 80% context`);
+        }
+        // Goal: 70% token reduction
+        if (metrics.tokenReductionPercent < 70) {
+            issues.push(`Token reduction ${metrics.tokenReductionPercent}% below 70% target`);
+        }
+        return {
+            meetsGoals: issues.length === 0,
+            issues
+        };
+    }
+    /**
+     * Reset loader state (for testing)
+     */
+    reset() {
+        this.loaded.clear();
+        this.visited.clear();
+        this.config = null;
+        this.startTime = Date.now();
+        this.cacheHits = 0;
+        this.maxReferenceDepth = 0;
+    }
+}
+/**
+ * Convenience function: Load context strategically
+ */
+export async function loadContextStrategic(options = {}) {
+    const loader = new ContextLoader();
+    return loader.loadContextStrategic(options);
+}
+/**
+ * Format context summary for display
+ */
+export function formatContextSummary(context) {
+    const { metrics, loadOrder, documents } = context;
+    const lines = [];
+    lines.push(`📊 Context Loading Summary`);
+    lines.push(`   Work Mode: ${context.workMode}`);
+    lines.push(`   Documents: ${metrics.documentsLoaded}`);
+    lines.push(`   Tokens: ${metrics.totalTokens.toLocaleString()}`);
+    lines.push(`   Time: ${metrics.bootstrapTimeMs}ms`);
+    lines.push(`   Token Reduction: ${metrics.tokenReductionPercent}%`);
+    lines.push(`   Reference Depth: ${metrics.referenceDepth}`);
+    lines.push(`   Cache Hits: ${metrics.cacheHits}`);
+    lines.push('');
+    lines.push(`📄 Load Order:`);
+    loadOrder.forEach((item, index) => {
+        lines.push(`   ${index + 1}. ${item}`);
+    });
+    return lines.join('\n');
+}
+/**
+ * Get document content by path (convenience)
+ */
+export function getDocumentContent(context, path) {
+    const doc = context.documents.get(path);
+    return doc?.content || null;
+}
+/**
+ * Get all loaded document paths
+ */
+export function getLoadedPaths(context) {
+    return Array.from(context.documents.keys());
+}
+/**
+ * Filter documents by type
+ */
+export function getDocumentsByType(context, type) {
+    return Array.from(context.documents.values()).filter(doc => doc.type === type);
+}
+//# sourceMappingURL=context-loader.js.map

package/dist/utils/context-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-loader.js","sourceRoot":"","sources":["../../src/utils/context-loader.ts"],"names":[],"mappings":"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"}

package/dist/utils/dispatcher-logger.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-02
+ * @tags: [write-dispatch, logging, session-log, adr-041]
+ * @related: [../core/session-log-manager.ts, ../../../../src/write-dispatcher.ts, ../../../../src/adapters/graph-adapter.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+import { type LogEntry } from '../core/session-log-manager.js';
+/**
+ * Write log entry using WriteDispatcher if available, fallback to SessionLogManager
+ *
+ * Strategy:
+ * 1. If dispatcher is initialized and enabled, use it for dual-write
+ * 2. Otherwise, use SessionLogManager directly (legacy mode)
+ *
+ * This enables gradual migration to graph-first writes while maintaining
+ * backward compatibility.
+ */
+export declare function appendLogEntry(sessionDir: string, entry: LogEntry, userEmail?: string): Promise<void>;
+/**
+ * Initialize WriteDispatcher for CLI commands
+ *
+ * Call this at the start of commands that need write dispatch.
+ * Safe to call multiple times (idempotent).
+ */
+export declare function initializeWriteDispatcher(ginkoDir: string): Promise<void>;
+//# sourceMappingURL=dispatcher-logger.d.ts.map

package/dist/utils/dispatcher-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-logger.d.ts","sourceRoot":"","sources":["../../src/utils/dispatcher-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,gCAAgC,CAAC;AAOxC;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,QAAQ,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAwBf;AA+DD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC/E"}

package/dist/utils/dispatcher-logger.js

@@ -0,0 +1,128 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-02
+ * @tags: [write-dispatch, logging, session-log, adr-041]
+ * @related: [../core/session-log-manager.ts, ../../../../src/write-dispatcher.ts, ../../../../src/adapters/graph-adapter.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+import { SessionLogManager, } from '../core/session-log-manager.js';
+import { getDispatcher, isDispatcherInitialized, } from '../lib/write-dispatcher/write-dispatcher.js';
+/**
+ * Write log entry using WriteDispatcher if available, fallback to SessionLogManager
+ *
+ * Strategy:
+ * 1. If dispatcher is initialized and enabled, use it for dual-write
+ * 2. Otherwise, use SessionLogManager directly (legacy mode)
+ *
+ * This enables gradual migration to graph-first writes while maintaining
+ * backward compatibility.
+ */
+export async function appendLogEntry(sessionDir, entry, userEmail) {
+    // Check if dispatcher is available
+    if (isDispatcherInitialized()) {
+        try {
+            const dispatcher = getDispatcher();
+            // Convert LogEntry to KnowledgeDocument
+            const document = convertLogEntryToDocument(entry, userEmail);
+            // Dispatch write (will route to graph and/or local based on config)
+            await dispatcher.dispatch(document);
+            return; // Success via dispatcher
+        }
+        catch (error) {
+            // Log dispatcher error but don't block
+            console.warn('[DispatcherLogger] Dispatcher write failed, falling back to local:', error instanceof Error ? error.message : String(error));
+        }
+    }
+    // Fallback to SessionLogManager (legacy mode or dispatcher failure)
+    await SessionLogManager.appendEntry(sessionDir, entry);
+}
+/**
+ * Convert LogEntry to KnowledgeDocument for dispatcher
+ */
+function convertLogEntryToDocument(entry, userEmail) {
+    // Generate unique ID for log entry
+    const timestamp = new Date(entry.timestamp).getTime();
+    const id = `log_${timestamp}_${entry.category}`;
+    // Generate title from description (first 60 chars)
+    const title = entry.description.substring(0, 60).trim() + (entry.description.length > 60 ? '...' : '');
+    // Format content with all entry details
+    const content = formatLogEntryContent(entry);
+    return {
+        type: 'LogEntry',
+        id,
+        title,
+        content,
+        data: {
+            category: entry.category,
+            impact: entry.impact,
+            timestamp: entry.timestamp,
+        },
+        metadata: {
+            category: entry.category,
+            impact: entry.impact,
+            files: entry.files || [],
+            timestamp: entry.timestamp,
+            userEmail,
+            tags: [entry.category, entry.impact],
+        },
+    };
+}
+/**
+ * Format log entry content as markdown
+ */
+function formatLogEntryContent(entry) {
+    const timestamp = new Date(entry.timestamp).toLocaleTimeString('en-US', {
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    });
+    const filesSection = entry.files && entry.files.length > 0
+        ? `\n\n**Files:**\n${entry.files.map(f => `- ${f}`).join('\n')}`
+        : '';
+    return `# [${entry.category.toUpperCase()}] ${timestamp}
+
+${entry.description}${filesSection}
+
+**Impact:** ${entry.impact}
+**Timestamp:** ${entry.timestamp}
+`;
+}
+/**
+ * Initialize WriteDispatcher for CLI commands
+ *
+ * Call this at the start of commands that need write dispatch.
+ * Safe to call multiple times (idempotent).
+ */
+export async function initializeWriteDispatcher(ginkoDir) {
+    if (isDispatcherInitialized()) {
+        return; // Already initialized
+    }
+    try {
+        const { initializeDispatcher, } = await import('../lib/write-dispatcher/write-dispatcher.js');
+        const { createGraphAdapterFromEnv, } = await import('../lib/write-dispatcher/adapters/graph-adapter.js');
+        const { createLocalAdapterFromEnv, } = await import('../lib/write-dispatcher/adapters/local-adapter.js');
+        // Initialize dispatcher with graph as primary
+        const dispatcher = initializeDispatcher({
+            primaryAdapter: 'graph',
+            dualWrite: process.env.GINKO_DUAL_WRITE === 'true',
+        });
+        // Register adapters
+        const graphAdapter = createGraphAdapterFromEnv();
+        const localAdapter = await createLocalAdapterFromEnv(ginkoDir);
+        dispatcher.registerAdapter(graphAdapter);
+        dispatcher.registerAdapter(localAdapter);
+        // Validate configuration
+        const validation = dispatcher.validate();
+        if (!validation.valid) {
+            console.warn('[DispatcherLogger] Dispatcher validation warnings:', validation.errors);
+        }
+    }
+    catch (error) {
+        // Dispatcher initialization failed - will fallback to SessionLogManager
+        console.warn('[DispatcherLogger] Failed to initialize dispatcher, using local writes only:', error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=dispatcher-logger.js.map

package/dist/utils/dispatcher-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-logger.js","sourceRoot":"","sources":["../../src/utils/dispatcher-logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/ginko-root.d.ts

@@ -9,8 +9,9 @@
  * @dependencies: [fs-extra, path]
  */
 /**
- * Find the ginko root directory by walking up the directory tree
- * Similar to how git finds the .git directory
+ * Find the ginko root directory
+ * Prefers git repository root for monorepo compatibility,
+ * falls back to walking up directory tree
  *
  * @param startDir - Directory to start searching from (defaults to cwd)
  * @returns Path to ginko root directory, or null if not found

package/dist/utils/ginko-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ginko-root.d.ts","sourceRoot":"","sources":["../../src/utils/ginko-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiC7E;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3F;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9F"}
+{"version":3,"file":"ginko-root.d.ts","sourceRoot":"","sources":["../../src/utils/ginko-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyBH;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8C7E;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3F;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9F"}

package/dist/utils/ginko-root.js

@@ -10,14 +10,47 @@
  */
 import fs from 'fs-extra';
 import path from 'path';
+import { execSync } from 'child_process';
 /**
- * Find the ginko root directory by walking up the directory tree
- * Similar to how git finds the .git directory
+ * Get git repository root using git command
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns Path to git root directory, or null if not in a git repo
+ */
+function getGitRoot(startDir) {
+    try {
+        const gitRoot = execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf8',
+            cwd: startDir || process.cwd(),
+            stdio: ['pipe', 'pipe', 'ignore'] // Suppress stderr
+        }).trim();
+        return path.resolve(gitRoot);
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Find the ginko root directory
+ * Prefers git repository root for monorepo compatibility,
+ * falls back to walking up directory tree
  *
  * @param startDir - Directory to start searching from (defaults to cwd)
  * @returns Path to ginko root directory, or null if not found
  */
 export async function findGinkoRoot(startDir) {
+    // First, try to use git repository root (preferred for monorepos)
+    const gitRoot = getGitRoot(startDir);
+    if (gitRoot) {
+        const gitGinkoPath = path.join(gitRoot, '.ginko');
+        if (await fs.pathExists(gitGinkoPath)) {
+            const stats = await fs.stat(gitGinkoPath);
+            if (stats.isDirectory()) {
+                return gitRoot;
+            }
+        }
+    }
+    // Fall back to walking up directory tree (for non-git projects)
     let currentDir = startDir || process.cwd();
     const root = path.parse(currentDir).root;
     while (currentDir !== root) {