@substrate-ai/core 0.19.54

package/dist/git/git-worktree-manager-impl.js

@@ -0,0 +1,336 @@
+/**
+ * GitWorktreeManagerImpl — concrete implementation of GitWorktreeManager.
+ *
+ * Subscribes to task:ready events to create worktrees and to
+ * task:complete / task:failed events to clean them up.
+ *
+ * Architecture constraints:
+ *  - Uses child_process.spawn for all git operations (via git-utils)
+ *  - Branch names: "substrate/task-{taskId}"
+ *  - Worktree path: {projectRoot}/.substrate-worktrees/{taskId}
+ *  - Implements IBaseService lifecycle (initialize / shutdown)
+ */
+import * as path from 'node:path';
+import { access } from 'node:fs/promises';
+import * as gitUtils from './git-utils.js';
+// Branch name prefix for substrate task branches
+const BRANCH_PREFIX = 'substrate/task-';
+// Default base directory for worktrees (relative to projectRoot)
+const DEFAULT_WORKTREE_BASE = '.substrate-worktrees';
+// ---------------------------------------------------------------------------
+// GitWorktreeManagerImpl
+// ---------------------------------------------------------------------------
+export class GitWorktreeManagerImpl {
+    _eventBus;
+    _projectRoot;
+    _baseDirectory;
+    _db;
+    _logger;
+    /** Bound listener references for cleanup in shutdown() */
+    _onTaskReady;
+    _onTaskComplete;
+    _onTaskFailed;
+    constructor(eventBus, projectRoot, baseDirectory = DEFAULT_WORKTREE_BASE, db = null, logger) {
+        this._eventBus = eventBus;
+        this._projectRoot = projectRoot;
+        this._baseDirectory = baseDirectory;
+        this._db = db;
+        this._logger = logger ?? console;
+        // Bind listeners once so we can remove them in shutdown()
+        // Note: _handleTaskReady is async; it awaits worktree creation and emits
+        // worktree:created only after the worktree exists. The WorkerPoolManager
+        // subscribes to worktree:created (not task:ready) to avoid race conditions.
+        this._onTaskReady = ({ taskId }) => {
+            this._handleTaskReady(taskId).catch((err) => {
+                this._logger.error({ taskId, err }, 'Unhandled error in _handleTaskReady');
+            });
+        };
+        this._onTaskComplete = ({ taskId }) => {
+            void this._handleTaskDone(taskId);
+        };
+        this._onTaskFailed = ({ taskId }) => {
+            void this._handleTaskDone(taskId);
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // IBaseService lifecycle
+    // ---------------------------------------------------------------------------
+    async initialize() {
+        this._logger.info({ projectRoot: this._projectRoot }, 'GitWorktreeManager.initialize()');
+        // Validate git version on startup
+        await this.verifyGitVersion();
+        // Clean up orphaned worktrees from previous crashes
+        const cleaned = await this.cleanupAllWorktrees();
+        if (cleaned > 0) {
+            this._logger.info({ cleaned }, 'Recovered orphaned worktrees on startup');
+        }
+        // Subscribe to task:ready to create worktrees
+        this._eventBus.on('task:ready', this._onTaskReady);
+        // Subscribe to completion events to trigger cleanup
+        this._eventBus.on('task:complete', this._onTaskComplete);
+        this._eventBus.on('task:failed', this._onTaskFailed);
+        this._logger.info('GitWorktreeManager initialized');
+    }
+    async shutdown() {
+        this._logger.info('GitWorktreeManager.shutdown()');
+        // Unsubscribe from event bus
+        this._eventBus.off('task:ready', this._onTaskReady);
+        this._eventBus.off('task:complete', this._onTaskComplete);
+        this._eventBus.off('task:failed', this._onTaskFailed);
+        // Clean up any remaining worktrees
+        await this.cleanupAllWorktrees();
+        this._logger.info('GitWorktreeManager shutdown complete');
+    }
+    // ---------------------------------------------------------------------------
+    // Event handlers
+    // ---------------------------------------------------------------------------
+    async _handleTaskReady(taskId) {
+        this._logger.debug({ taskId }, 'task:ready — creating worktree');
+        try {
+            await this.createWorktree(taskId);
+        }
+        catch (err) {
+            this._logger.error({ taskId, err }, 'Failed to create worktree for task');
+        }
+    }
+    async _handleTaskDone(taskId) {
+        this._logger.debug({ taskId }, 'task done — cleaning up worktree');
+        try {
+            await this.cleanupWorktree(taskId);
+        }
+        catch (err) {
+            // Log but don't rethrow — cleanup failure should not block task completion
+            this._logger.warn({ taskId, err }, 'Failed to cleanup worktree for task');
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // GitWorktreeManager interface
+    // ---------------------------------------------------------------------------
+    async createWorktree(taskId, baseBranch = 'main') {
+        if (!taskId || taskId.trim().length === 0) {
+            throw new Error('createWorktree: taskId must be a non-empty string');
+        }
+        const branchName = BRANCH_PREFIX + taskId;
+        const worktreePath = this.getWorktreePath(taskId);
+        this._logger.debug({ taskId, branchName, worktreePath, baseBranch }, 'createWorktree');
+        // Create the worktree via git-utils
+        await gitUtils.createWorktree(this._projectRoot, taskId, branchName, baseBranch);
+        const createdAt = new Date();
+        // Emit worktree:created event
+        this._eventBus.emit('worktree:created', {
+            taskId,
+            branchName,
+            worktreePath,
+            createdAt,
+        });
+        const info = {
+            taskId,
+            branchName,
+            worktreePath,
+            createdAt,
+        };
+        this._logger.info({ taskId, branchName, worktreePath }, 'Worktree created');
+        return info;
+    }
+    async cleanupWorktree(taskId) {
+        const branchName = BRANCH_PREFIX + taskId;
+        const worktreePath = this.getWorktreePath(taskId);
+        this._logger.debug({ taskId, branchName, worktreePath }, 'cleanupWorktree');
+        // Guard: Check if worktree directory exists before attempting removal.
+        // This makes cleanupWorktree idempotent and prevents double-cleanup races.
+        let worktreeExists = false;
+        try {
+            await access(worktreePath);
+            worktreeExists = true;
+        }
+        catch {
+            // Worktree directory doesn't exist — already cleaned up or never created
+            this._logger.debug({ taskId, worktreePath }, 'cleanupWorktree: worktree does not exist, skipping removal');
+        }
+        // Remove worktree directory (only if it exists)
+        if (worktreeExists) {
+            try {
+                await gitUtils.removeWorktree(worktreePath, this._projectRoot);
+            }
+            catch (err) {
+                this._logger.warn({ taskId, worktreePath, err }, 'removeWorktree failed during cleanup');
+            }
+        }
+        // Delete the task branch
+        try {
+            await gitUtils.removeBranch(branchName, this._projectRoot);
+        }
+        catch (err) {
+            this._logger.warn({ taskId, branchName, err }, 'removeBranch failed during cleanup');
+        }
+        // Emit worktree:removed event
+        this._eventBus.emit('worktree:removed', {
+            taskId,
+            branchName,
+        });
+        this._logger.info({ taskId, branchName }, 'Worktree cleaned up');
+    }
+    async cleanupAllWorktrees() {
+        this._logger.debug({ projectRoot: this._projectRoot }, 'cleanupAllWorktrees');
+        const orphanedPaths = await gitUtils.getOrphanedWorktrees(this._projectRoot, this._baseDirectory);
+        let cleaned = 0;
+        for (const worktreePath of orphanedPaths) {
+            // Extract taskId from path (last segment of the path)
+            const taskId = path.basename(worktreePath);
+            // Remove orphaned worktree
+            let worktreeRemoved = false;
+            try {
+                await gitUtils.removeWorktree(worktreePath, this._projectRoot);
+                worktreeRemoved = true;
+                this._logger.debug({ taskId, worktreePath }, 'cleanupAllWorktrees: removed orphaned worktree');
+            }
+            catch (err) {
+                this._logger.warn({ taskId, worktreePath, err }, 'cleanupAllWorktrees: failed to remove worktree');
+            }
+            // Remove orphaned branch
+            const branchName = BRANCH_PREFIX + taskId;
+            try {
+                const branchRemoved = await gitUtils.removeBranch(branchName, this._projectRoot);
+                if (branchRemoved) {
+                    this._logger.debug({ taskId, branchName }, 'cleanupAllWorktrees: removed orphaned branch');
+                }
+            }
+            catch (err) {
+                this._logger.warn({ taskId, branchName, err }, 'cleanupAllWorktrees: failed to remove branch');
+            }
+            // Only count as cleaned if worktree removal succeeded
+            if (worktreeRemoved) {
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            this._logger.info({ cleaned }, 'cleanupAllWorktrees: recovered orphaned worktrees');
+        }
+        return cleaned;
+    }
+    async detectConflicts(taskId, targetBranch = 'main') {
+        if (!taskId || taskId.trim().length === 0) {
+            throw new Error('detectConflicts: taskId must be a non-empty string');
+        }
+        const branchName = BRANCH_PREFIX + taskId;
+        const worktreePath = this.getWorktreePath(taskId);
+        this._logger.debug({ taskId, branchName, targetBranch }, 'detectConflicts');
+        // Verify the worktree exists
+        try {
+            await access(worktreePath);
+        }
+        catch {
+            throw new Error(`detectConflicts: Worktree for task "${taskId}" not found at "${worktreePath}". ` +
+                `The worktree may have already been cleaned up.`);
+        }
+        // Run simulated merge on the project root (target branch working dir)
+        const mergeClean = await gitUtils.simulateMerge(branchName, this._projectRoot);
+        let conflictingFiles = [];
+        try {
+            if (!mergeClean) {
+                // Get the list of conflicting files
+                conflictingFiles = await gitUtils.getConflictingFiles(this._projectRoot);
+            }
+        }
+        finally {
+            // Always abort the simulated merge to clean up state
+            await gitUtils.abortMerge(this._projectRoot);
+        }
+        const report = {
+            hasConflicts: !mergeClean || conflictingFiles.length > 0,
+            conflictingFiles,
+            taskId,
+            targetBranch,
+        };
+        // Emit worktree:conflict event if conflicts exist
+        if (report.hasConflicts) {
+            this._eventBus.emit('worktree:conflict', {
+                taskId,
+                branch: branchName,
+                conflictingFiles: report.conflictingFiles,
+            });
+        }
+        this._logger.info({ taskId, hasConflicts: report.hasConflicts, conflictCount: conflictingFiles.length }, 'Conflict detection complete');
+        return report;
+    }
+    async mergeWorktree(taskId, targetBranch = 'main') {
+        if (!taskId || taskId.trim().length === 0) {
+            throw new Error('mergeWorktree: taskId must be a non-empty string');
+        }
+        const branchName = BRANCH_PREFIX + taskId;
+        this._logger.debug({ taskId, branchName, targetBranch }, 'mergeWorktree');
+        // Call detectConflicts() first to check for conflicts (also verifies worktree exists)
+        const conflictReport = await this.detectConflicts(taskId, targetBranch);
+        if (conflictReport.hasConflicts) {
+            // Return failure result without attempting merge
+            this._logger.info({ taskId, conflictCount: conflictReport.conflictingFiles.length }, 'Merge skipped due to conflicts');
+            return {
+                success: false,
+                mergedFiles: [],
+                conflicts: conflictReport,
+            };
+        }
+        // Perform actual merge
+        const mergeSuccess = await gitUtils.performMerge(branchName, this._projectRoot);
+        if (!mergeSuccess) {
+            throw new Error(`mergeWorktree: git merge --no-ff failed for task "${taskId}" branch "${branchName}"`);
+        }
+        // Get the list of merged files
+        const mergedFiles = await gitUtils.getMergedFiles(this._projectRoot);
+        // Emit worktree:merged event
+        this._eventBus.emit('worktree:merged', {
+            taskId,
+            branch: branchName,
+            mergedFiles,
+        });
+        const result = {
+            success: true,
+            mergedFiles,
+        };
+        this._logger.info({ taskId, branchName, mergedFileCount: mergedFiles.length }, 'Worktree merged successfully');
+        return result;
+    }
+    async listWorktrees() {
+        this._logger.debug({ projectRoot: this._projectRoot, baseDirectory: this._baseDirectory }, 'listWorktrees');
+        const worktreePaths = await gitUtils.getOrphanedWorktrees(this._projectRoot, this._baseDirectory);
+        const results = [];
+        for (const worktreePath of worktreePaths) {
+            const taskId = path.basename(worktreePath);
+            const branchName = BRANCH_PREFIX + taskId;
+            // Try to get the creation time from the worktree directory
+            let createdAt;
+            try {
+                const { stat } = await import('node:fs/promises');
+                const stats = await stat(worktreePath);
+                createdAt = stats.birthtime ?? stats.ctime;
+            }
+            catch {
+                // If we can't stat the directory, use current time as fallback
+                createdAt = new Date();
+            }
+            results.push({
+                taskId,
+                branchName,
+                worktreePath,
+                createdAt,
+            });
+        }
+        this._logger.debug({ count: results.length }, 'listWorktrees: found worktrees');
+        return results;
+    }
+    getWorktreePath(taskId) {
+        return path.join(this._projectRoot, this._baseDirectory, taskId);
+    }
+    async verifyGitVersion() {
+        try {
+            await gitUtils.verifyGitVersion();
+        }
+        catch (err) {
+            throw new Error(`GitWorktreeManager: git version check failed: ${String(err)}`);
+        }
+    }
+}
+export function createGitWorktreeManager(options) {
+    return new GitWorktreeManagerImpl(options.eventBus, options.projectRoot, options.baseDirectory, options.db ?? null, options.logger);
+}
+//# sourceMappingURL=git-worktree-manager-impl.js.map

package/dist/git/git-worktree-manager-impl.js.map

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

package/dist/git/git-worktree-manager.d.ts

@@ -0,0 +1,122 @@
+/**
+ * GitWorktreeManager — interface and types for git worktree lifecycle management.
+ *
+ * Responsible for:
+ *  - Creating per-task git worktrees (AC1)
+ *  - Providing worktree paths to WorkerPoolManager (AC2, AC6)
+ *  - Cleaning up worktrees on task completion (AC3)
+ *  - Recovering orphaned worktrees on startup (AC4)
+ *  - Validating git version on startup (AC5)
+ *
+ * Implementation: GitWorktreeManagerImpl (git-worktree-manager-impl.ts)
+ */
+import type { IBaseService } from '../types.js';
+/**
+ * Describes a created worktree associated with a task.
+ */
+export interface WorktreeInfo {
+    /** Task this worktree belongs to */
+    taskId: string;
+    /** Branch name in the form "substrate/task-{taskId}" */
+    branchName: string;
+    /** Absolute path to the worktree directory */
+    worktreePath: string;
+    /** When the worktree was created */
+    createdAt: Date;
+}
+/**
+ * Result of a conflict detection check for a task's worktree branch.
+ * Returned by detectConflicts() after simulating a merge.
+ */
+export interface ConflictReport {
+    /** Whether conflicts were found */
+    hasConflicts: boolean;
+    /** List of files with conflicts (empty if no conflicts) */
+    conflictingFiles: string[];
+    /** Task ID being checked */
+    taskId: string;
+    /** Target branch that was used for conflict detection */
+    targetBranch: string;
+}
+/**
+ * Result of a merge operation for a task's worktree branch.
+ * Returned by mergeWorktree().
+ */
+export interface MergeResult {
+    /** Whether the merge succeeded */
+    success: boolean;
+    /** List of files that were merged (only populated on success) */
+    mergedFiles: string[];
+    /** Conflict report if merge failed due to conflicts */
+    conflicts?: ConflictReport;
+}
+/**
+ * Manages the lifecycle of git worktrees for parallel task execution.
+ *
+ * Each task gets an isolated git worktree to prevent file conflicts between
+ * concurrently running agents (FR16, FR17, NFR10).
+ */
+export interface GitWorktreeManager extends IBaseService {
+    /**
+     * Create a git worktree and branch for the given task.
+     *
+     * @param taskId     - The task identifier
+     * @param baseBranch - Branch to base the worktree on (defaults to 'main')
+     * @returns          - WorktreeInfo with path and branch details
+     * @throws           - Error if git command fails
+     */
+    createWorktree(taskId: string, baseBranch?: string): Promise<WorktreeInfo>;
+    /**
+     * Remove the worktree and branch associated with a task.
+     *
+     * @param taskId - The task identifier
+     * @throws       - Error if git removal command fails
+     */
+    cleanupWorktree(taskId: string): Promise<void>;
+    /**
+     * Scan for orphaned worktrees and clean them up.
+     *
+     * Used during initialization to recover from crashes.
+     *
+     * @returns - Count of worktrees that were cleaned up
+     */
+    cleanupAllWorktrees(): Promise<number>;
+    /**
+     * Get the consistent worktree path for a given task.
+     *
+     * @param taskId - The task identifier
+     * @returns      - Absolute path: {projectRoot}/.substrate-worktrees/{taskId}
+     */
+    getWorktreePath(taskId: string): string;
+    /**
+     * Verify that git is installed and version >= 2.20.
+     *
+     * @throws - Error with clear message if git is missing or too old
+     */
+    verifyGitVersion(): Promise<void>;
+    /**
+     * Detect merge conflicts between a task's worktree branch and a target branch.
+     *
+     * @param taskId       - The task identifier
+     * @param targetBranch - The branch to merge into (defaults to 'main')
+     * @returns            - ConflictReport with hasConflicts and conflictingFiles
+     * @throws             - Error if the worktree for this task does not exist
+     */
+    detectConflicts(taskId: string, targetBranch?: string): Promise<ConflictReport>;
+    /**
+     * Merge a task's worktree branch into a target branch.
+     *
+     * @param taskId       - The task identifier
+     * @param targetBranch - The branch to merge into (defaults to 'main')
+     * @returns            - MergeResult with success status and merged files
+     * @throws             - Error if merge command fails unexpectedly
+     */
+    mergeWorktree(taskId: string, targetBranch?: string): Promise<MergeResult>;
+    /**
+     * List all currently tracked worktrees.
+     *
+     * @returns - Array of WorktreeInfo for all tracked worktrees
+     */
+    listWorktrees(): Promise<WorktreeInfo[]>;
+}
+//# sourceMappingURL=git-worktree-manager.d.ts.map

package/dist/git/git-worktree-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree-manager.d.ts","sourceRoot":"","sources":["../../src/git/git-worktree-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM/C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,SAAS,EAAE,IAAI,CAAA;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAA;IACrB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAA;CACrB;AAMD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;;;;;;;OAOG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAE1E;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;;;OAMG;IACH,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAEtC;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IAEvC;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjC;;;;;;;OAOG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAE/E;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAE1E;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACzC"}

package/dist/git/git-worktree-manager.js

@@ -0,0 +1,14 @@
+/**
+ * GitWorktreeManager — interface and types for git worktree lifecycle management.
+ *
+ * Responsible for:
+ *  - Creating per-task git worktrees (AC1)
+ *  - Providing worktree paths to WorkerPoolManager (AC2, AC6)
+ *  - Cleaning up worktrees on task completion (AC3)
+ *  - Recovering orphaned worktrees on startup (AC4)
+ *  - Validating git version on startup (AC5)
+ *
+ * Implementation: GitWorktreeManagerImpl (git-worktree-manager-impl.ts)
+ */
+export {};
+//# sourceMappingURL=git-worktree-manager.js.map

package/dist/git/git-worktree-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree-manager.js","sourceRoot":"","sources":["../../src/git/git-worktree-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/git/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @substrate-ai/core git barrel export.
+ * Re-exports all git-related utilities, interfaces, and implementations.
+ */
+export * from './git-utils.js';
+export type { GitWorktreeManager, WorktreeInfo, ConflictReport, MergeResult } from './git-worktree-manager.js';
+export { GitWorktreeManagerImpl, createGitWorktreeManager, } from './git-worktree-manager-impl.js';
+export type { GitWorktreeManagerOptions, LegacyDbLike } from './git-worktree-manager-impl.js';
+export type { GitManager, GitManagerOptions } from './git-manager.js';
+export { GitManagerImpl, createGitManager } from './git-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/git/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/git/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC9G,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gCAAgC,CAAA;AACvC,YAAY,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAC7F,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/git/index.js

@@ -0,0 +1,8 @@
+/**
+ * @substrate-ai/core git barrel export.
+ * Re-exports all git-related utilities, interfaces, and implementations.
+ */
+export * from './git-utils.js';
+export { GitWorktreeManagerImpl, createGitWorktreeManager, } from './git-worktree-manager-impl.js';
+export { GitManagerImpl, createGitManager } from './git-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/git/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAA;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export * from './types.js';
+export type { EventMap, EventHandler } from './events/index.js';
+export type { TypedEventBus } from './events/index.js';
+export { TypedEventBusImpl, createEventBus } from './events/index.js';
+export type { CoreEvents, EventTaskResult, EventTaskError } from './events/index.js';
+export * from './dispatch/index.js';
+export * from './persistence/index.js';
+export * from './routing/index.js';
+export * from './config/index.js';
+export type { ITelemetryPersistence } from './telemetry/index.js';
+export { estimateCost } from './telemetry/index.js';
+export type { Recommendation } from './telemetry/index.js';
+export * from './telemetry/index.js';
+export * from './adapters/index.js';
+export * from './context/index.js';
+export * from './quality-gates/index.js';
+export * from './git/index.js';
+export * from './version-manager/index.js';
+export * from './supervisor/index.js';
+export * from './budget/index.js';
+export { estimateCost as estimateCostForProvider } from './cost-tracker/token-rates.js';
+export type { CostTracker, CostTrackerOptions } from './cost-tracker/index.js';
+export { CostTrackerImpl, createCostTracker } from './cost-tracker/index.js';
+export { CostTrackerSubscriber, createCostTrackerSubscriber } from './cost-tracker/index.js';
+export type { CostTrackerSubscriberOptions } from './cost-tracker/index.js';
+export type { CostEntry, TaskCostSummary, SessionCostSummary, AgentCostBreakdown, } from './cost-tracker/index.js';
+export type { TokenRates, ModelRates } from './cost-tracker/index.js';
+export { TOKEN_RATES, PROVIDER_ALIASES, getTokenRate, estimateCostSafe } from './cost-tracker/index.js';
+export type { Recommendation as MonitorRecommendation } from './monitor/recommendation-types.js';
+export * from './monitor/index.js';
+export { callLLM } from './llm/client.js';
+export type { LLMCallParams, LLMCallResult } from './llm/client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAA;AAI1B,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGpF,cAAc,qBAAqB,CAAA;AAGnC,cAAc,wBAAwB,CAAA;AAGtC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,mBAAmB,CAAA;AAOjC,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,cAAc,sBAAsB,CAAA;AAGpC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,0BAA0B,CAAA;AAGxC,cAAc,gBAAgB,CAAA;AAG9B,cAAc,4BAA4B,CAAA;AAG1C,cAAc,uBAAuB,CAAA;AAGrC,cAAc,mBAAmB,CAAA;AAWjC,OAAO,EAAE,YAAY,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AACvF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAC5F,YAAY,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAC3E,YAAY,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAKvG,YAAY,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAChG,cAAc,oBAAoB,CAAA;AAGlC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,47 @@
+// @substrate-ai/core public API — exports added per story (40-3+)
+// Core primitive types (TaskId, WorkerId, AgentId, TaskStatus, etc.)
+// TaskId and WorkerId are defined here; the events subsystem also defines them
+// but we use this module as the canonical source to avoid TS2308 ambiguity.
+export * from './types.js';
+export { TypedEventBusImpl, createEventBus } from './events/index.js';
+// Dispatch: Dispatcher, DispatchRequest, DispatchHandle, DispatchResult, DispatchConfig
+export * from './dispatch/index.js';
+// Persistence: DatabaseAdapter, DatabaseAdapterConfig, SyncAdapter, isSyncAdapter, InitSchemaFn
+export * from './persistence/index.js';
+// Routing: RoutingDecision, RoutingPolicy, IRoutingResolver, ModelResolution
+export * from './routing/index.js';
+// Config: SubstrateConfig and related types
+export * from './config/index.js';
+export { estimateCost } from './telemetry/index.js';
+export * from './telemetry/index.js';
+// Adapter subsystem (WorkerAdapter, AdapterRegistry, SpawnCommand, AdapterOptions, etc.)
+export * from './adapters/index.js';
+// Context compiler subsystem (ContextCompiler, TaskDescriptor, CompileResult, *Schema, etc.)
+export * from './context/index.js';
+// Quality gates subsystem (QualityGate, GatePipeline, GateResult, etc.)
+export * from './quality-gates/index.js';
+// Git utilities, worktree management, and git manager
+export * from './git/index.js';
+// Version manager (VersionManager, VersionManagerImpl, UpdateChecker, VersionCache, etc.)
+export * from './version-manager/index.js';
+// Supervisor: analysis engine, experimenter framework
+export * from './supervisor/index.js';
+// Budget: BudgetTracker interface and stub implementation
+export * from './budget/index.js';
+// CostTracker: token rates, cost tracking, and subscriber
+// estimateCost: telemetry's (model, tokens) version is the canonical @substrate-ai/core export (exported above).
+// estimateCostForProvider: cost-tracker variant (provider, model, inputTokens, outputTokens, rateTable?)
+// CostEntry/TaskCostSummary/SessionCostSummary/AgentCostBreakdown re-exported here from
+// cost-tracker/types.js which points to the same declarations as persistence/cost-types.js,
+// so TypeScript treats them as non-ambiguous identical declarations.
+// estimateCost is intentionally excluded from the root re-export to prevent a runtime
+// collision with telemetry's estimateCost; the cost-tracker variant is accessible as
+// estimateCostForProvider from the root barrel, and as estimateCost from cost-tracker/index.ts.
+export { estimateCost as estimateCostForProvider } from './cost-tracker/token-rates.js';
+export { CostTrackerImpl, createCostTracker } from './cost-tracker/index.js';
+export { CostTrackerSubscriber, createCostTrackerSubscriber } from './cost-tracker/index.js';
+export { TOKEN_RATES, PROVIDER_ALIASES, getTokenRate, estimateCostSafe } from './cost-tracker/index.js';
+export * from './monitor/index.js';
+// LLM client: callLLM, LLMCallParams, LLMCallResult (story 42-10)
+export { callLLM } from './llm/client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,qEAAqE;AACrE,+EAA+E;AAC/E,4EAA4E;AAC5E,cAAc,YAAY,CAAA;AAM1B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGrE,wFAAwF;AACxF,cAAc,qBAAqB,CAAA;AAEnC,gGAAgG;AAChG,cAAc,wBAAwB,CAAA;AAEtC,6EAA6E;AAC7E,cAAc,oBAAoB,CAAA;AAElC,4CAA4C;AAC5C,cAAc,mBAAmB,CAAA;AAQjC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yFAAyF;AACzF,cAAc,qBAAqB,CAAA;AAEnC,6FAA6F;AAC7F,cAAc,oBAAoB,CAAA;AAElC,wEAAwE;AACxE,cAAc,0BAA0B,CAAA;AAExC,sDAAsD;AACtD,cAAc,gBAAgB,CAAA;AAE9B,0FAA0F;AAC1F,cAAc,4BAA4B,CAAA;AAE1C,sDAAsD;AACtD,cAAc,uBAAuB,CAAA;AAErC,0DAA0D;AAC1D,cAAc,mBAAmB,CAAA;AAEjC,0DAA0D;AAC1D,iHAAiH;AACjH,yGAAyG;AACzG,wFAAwF;AACxF,4FAA4F;AAC5F,qEAAqE;AACrE,sFAAsF;AACtF,qFAAqF;AACrF,gGAAgG;AAChG,OAAO,EAAE,YAAY,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAEvF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAS5F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAMvG,cAAc,oBAAoB,CAAA;AAElC,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA"}