@skillsmith/core 0.1.0

package/dist/src/session/SessionRecovery.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Session Recovery for Claude-Flow Memory
+ * SMI-641: Session ID Storage in Claude-Flow Memory
+ *
+ * Provides session recovery capabilities:
+ * - Find latest session from memory
+ * - Restore session context
+ * - Resume from last checkpoint
+ * - Merge with new session if needed
+ */
+import type { SessionData, Checkpoint, SessionContext } from './SessionContext.js';
+import type { SessionManager, CommandExecutor, SessionOptions } from './SessionManager.js';
+/**
+ * Recovery result status
+ */
+export type RecoveryStatus = 'restored' | 'merged' | 'not_found' | 'error';
+/**
+ * Result of a session recovery attempt
+ */
+export interface RecoveryResult {
+    status: RecoveryStatus;
+    session: SessionData | null;
+    checkpoint: Checkpoint | null;
+    message: string;
+}
+/**
+ * Options for session recovery
+ */
+export interface RecoveryOptions {
+    /** Session ID to recover (uses current if not specified) */
+    sessionId?: string;
+    /** Whether to merge with a new session if recovery fails */
+    mergeOnFailure?: boolean;
+    /** Options for new session if merging */
+    newSessionOptions?: SessionOptions;
+}
+/**
+ * Session Recovery handles restoring sessions from claude-flow memory
+ */
+export declare class SessionRecovery {
+    private manager;
+    private executor;
+    constructor(manager: SessionManager, executor: CommandExecutor);
+    /**
+     * Find the latest session from memory
+     */
+    findLatestSession(): Promise<SessionData | null>;
+    /**
+     * Search for recent sessions in memory
+     */
+    private searchForRecentSession;
+    /**
+     * Restore session context from memory
+     */
+    restoreSession(options?: RecoveryOptions): Promise<RecoveryResult>;
+    /**
+     * Resume from the last checkpoint in a session
+     */
+    resumeFromCheckpoint(session: SessionData, checkpointId?: string): Promise<RecoveryResult>;
+    /**
+     * Merge a previous session with a new one
+     *
+     * This is useful when starting a new session but wanting to
+     * preserve context from a previous incomplete session.
+     */
+    mergeWithNewSession(previousSession: SessionData, newSessionOptions: SessionOptions): Promise<RecoveryResult>;
+    /**
+     * Create a session context from recovery result
+     */
+    createContext(result: RecoveryResult): SessionContext;
+    /**
+     * Retrieve checkpoint data from memory
+     */
+    private retrieveCheckpointData;
+    /**
+     * Run session restore hook
+     */
+    private runSessionRestoreHook;
+}
+/**
+ * Factory function to create SessionRecovery with default dependencies
+ */
+export declare function createSessionRecovery(manager: SessionManager, executor: CommandExecutor): SessionRecovery;
+//# sourceMappingURL=SessionRecovery.d.ts.map

package/dist/src/session/SessionRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionRecovery.d.ts","sourceRoot":"","sources":["../../../src/session/SessionRecovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAE1F;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAA;AAE1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,cAAc,CAAA;CACnC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;gBAErB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe;IAK9D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAetD;;OAEG;YACW,sBAAsB;IA+CpC;;OAEG;IACG,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAsD5E;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgDhG;;;;;OAKG;IACG,mBAAmB,CACvB,eAAe,EAAE,WAAW,EAC5B,iBAAiB,EAAE,cAAc,GAChC,OAAO,CAAC,cAAc,CAAC;IAqC1B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc;IAIrD;;OAEG;YACW,sBAAsB;IAepC;;OAEG;YACW,qBAAqB;CAQpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe,GACxB,eAAe,CAEjB"}

package/dist/src/session/SessionRecovery.js

@@ -0,0 +1,257 @@
+/**
+ * Session Recovery for Claude-Flow Memory
+ * SMI-641: Session ID Storage in Claude-Flow Memory
+ *
+ * Provides session recovery capabilities:
+ * - Find latest session from memory
+ * - Restore session context
+ * - Resume from last checkpoint
+ * - Merge with new session if needed
+ */
+import { createSessionContext, getLatestCheckpoint } from './SessionContext.js';
+/**
+ * Session Recovery handles restoring sessions from claude-flow memory
+ */
+export class SessionRecovery {
+    manager;
+    executor;
+    constructor(manager, executor) {
+        this.manager = manager;
+        this.executor = executor;
+    }
+    /**
+     * Find the latest session from memory
+     */
+    async findLatestSession() {
+        // First try to get current session pointer
+        const currentId = await this.manager.getCurrentSessionId();
+        if (currentId) {
+            const session = await this.manager.getSession(currentId);
+            if (session) {
+                return session;
+            }
+        }
+        // If no current session, try to list recent sessions
+        return this.searchForRecentSession();
+    }
+    /**
+     * Search for recent sessions in memory
+     */
+    async searchForRecentSession() {
+        try {
+            // Use claude-flow memory list to find session keys
+            const command = 'npx claude-flow@alpha memory list --pattern "session/*"';
+            const { stdout } = await this.executor.execute(command);
+            // Parse output to find session keys
+            const lines = stdout.trim().split('\n').filter(Boolean);
+            const sessionKeys = lines.filter((line) => line.includes('session/') && !line.includes('session/current'));
+            if (sessionKeys.length === 0) {
+                return null;
+            }
+            // Get all sessions and find the most recent
+            const sessions = [];
+            for (const keyLine of sessionKeys) {
+                // Extract session ID from key (format varies by claude-flow version)
+                const match = keyLine.match(/session\/([a-f0-9-]+)/i);
+                if (match) {
+                    const sessionId = match[1];
+                    const session = await this.manager.getSession(sessionId);
+                    if (session) {
+                        sessions.push(session);
+                    }
+                }
+            }
+            if (sessions.length === 0) {
+                return null;
+            }
+            // Return the most recently active session
+            return sessions.reduce((latest, current) => {
+                const latestTime = new Date(latest.lastActivity).getTime();
+                const currentTime = new Date(current.lastActivity).getTime();
+                return currentTime > latestTime ? current : latest;
+            });
+        }
+        catch {
+            // Memory list may not be supported or empty
+            return null;
+        }
+    }
+    /**
+     * Restore session context from memory
+     */
+    async restoreSession(options = {}) {
+        try {
+            let session = null;
+            // Try to get specific session or find latest
+            if (options.sessionId) {
+                session = await this.manager.getSession(options.sessionId);
+            }
+            else {
+                session = await this.findLatestSession();
+            }
+            if (!session) {
+                // No session found
+                if (options.mergeOnFailure && options.newSessionOptions) {
+                    // Create a new session instead
+                    const newSession = await this.manager.startSession(options.newSessionOptions);
+                    return {
+                        status: 'merged',
+                        session: newSession,
+                        checkpoint: null,
+                        message: 'No previous session found. Created new session.',
+                    };
+                }
+                return {
+                    status: 'not_found',
+                    session: null,
+                    checkpoint: null,
+                    message: 'No session found to restore.',
+                };
+            }
+            // Get the latest checkpoint for resume information
+            const latestCheckpoint = getLatestCheckpoint(session);
+            // Run session restore hook
+            await this.runSessionRestoreHook(session.sessionId);
+            return {
+                status: 'restored',
+                session,
+                checkpoint: latestCheckpoint,
+                message: `Session ${session.sessionId} restored from memory.`,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                session: null,
+                checkpoint: null,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Resume from the last checkpoint in a session
+     */
+    async resumeFromCheckpoint(session, checkpointId) {
+        try {
+            // Find the checkpoint to resume from
+            let checkpoint = null;
+            if (checkpointId) {
+                checkpoint = session.checkpoints.find((cp) => cp.id === checkpointId) ?? null;
+            }
+            else {
+                checkpoint = getLatestCheckpoint(session);
+            }
+            if (!checkpoint) {
+                return {
+                    status: 'not_found',
+                    session,
+                    checkpoint: null,
+                    message: 'No checkpoint found to resume from.',
+                };
+            }
+            // Retrieve checkpoint data from memory
+            const checkpointData = await this.retrieveCheckpointData(checkpoint.memoryKey);
+            if (!checkpointData) {
+                return {
+                    status: 'error',
+                    session,
+                    checkpoint,
+                    message: `Checkpoint data not found at ${checkpoint.memoryKey}`,
+                };
+            }
+            return {
+                status: 'restored',
+                session,
+                checkpoint,
+                message: `Resumed from checkpoint: ${checkpoint.description}`,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                session,
+                checkpoint: null,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Merge a previous session with a new one
+     *
+     * This is useful when starting a new session but wanting to
+     * preserve context from a previous incomplete session.
+     */
+    async mergeWithNewSession(previousSession, newSessionOptions) {
+        try {
+            // Create new session
+            const newSession = await this.manager.startSession({
+                ...newSessionOptions,
+                // Preserve issue ID if not specified
+                issueId: newSessionOptions.issueId ?? previousSession.issueId,
+                // Preserve worktree if not specified
+                worktree: newSessionOptions.worktree ?? previousSession.worktree,
+            });
+            // Copy relevant context from previous session
+            for (const file of previousSession.filesModified) {
+                await this.manager.recordFileModified(file);
+            }
+            // Create a merge checkpoint
+            await this.manager.createCheckpoint(`Merged from previous session ${previousSession.sessionId}`);
+            return {
+                status: 'merged',
+                session: this.manager.getCurrentSession(),
+                checkpoint: null,
+                message: `New session created with context from ${previousSession.sessionId}`,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                session: null,
+                checkpoint: null,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Create a session context from recovery result
+     */
+    createContext(result) {
+        return createSessionContext(result.session);
+    }
+    /**
+     * Retrieve checkpoint data from memory
+     */
+    async retrieveCheckpointData(memoryKey) {
+        try {
+            const command = `npx claude-flow@alpha memory get --key "${memoryKey}"`;
+            const { stdout } = await this.executor.execute(command);
+            if (!stdout.trim()) {
+                return null;
+            }
+            return JSON.parse(stdout.trim());
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Run session restore hook
+     */
+    async runSessionRestoreHook(sessionId) {
+        try {
+            const command = `npx claude-flow@alpha hooks session-restore --session-id "${sessionId}"`;
+            await this.executor.execute(command);
+        }
+        catch {
+            // Hooks are optional
+        }
+    }
+}
+/**
+ * Factory function to create SessionRecovery with default dependencies
+ */
+export function createSessionRecovery(manager, executor) {
+    return new SessionRecovery(manager, executor);
+}
+//# sourceMappingURL=SessionRecovery.js.map

package/dist/src/session/SessionRecovery.js.map

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

package/dist/src/session/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Session Management Module
+ * SMI-641: Session ID Storage in Claude-Flow Memory
+ *
+ * Provides session lifecycle management with claude-flow memory integration
+ * for context restoration across sessions.
+ *
+ * @example
+ * ```typescript
+ * import { SessionManager, SessionRecovery, DefaultCommandExecutor } from '@skillsmith/core'
+ *
+ * const executor = new DefaultCommandExecutor()
+ * const manager = new SessionManager(executor)
+ *
+ * // Start a new session
+ * const session = await manager.startSession({
+ *   issueId: 'SMI-641',
+ *   worktree: 'phase-2c-session',
+ *   description: 'Implementing session storage'
+ * })
+ *
+ * // Create checkpoints
+ * await manager.createCheckpoint('Completed SessionManager')
+ *
+ * // Record modified files
+ * await manager.recordFileModified('packages/core/src/session/SessionManager.ts')
+ *
+ * // End session
+ * await manager.endSession()
+ *
+ * // Later, recover session
+ * const recovery = new SessionRecovery(manager, executor)
+ * const result = await recovery.restoreSession()
+ * ```
+ */
+export { SessionManager, DefaultCommandExecutor, type SessionOptions, type MemoryResult, type CommandExecutor, } from './SessionManager.js';
+export { ActiveSessionContext, NullSessionContext, createSessionContext, isActiveContext, getSessionDuration, formatSessionDuration, getLatestCheckpoint, type Checkpoint, type SessionData, type SessionContext, } from './SessionContext.js';
+export { SessionRecovery, createSessionRecovery, type RecoveryStatus, type RecoveryResult, type RecoveryOptions, } from './SessionRecovery.js';
+export { SessionHealthMonitor, getHealthMonitor, initializeHealthMonitor, shutdownHealthMonitor, type SessionHealth, type SessionHealthStatus, type HealthMonitorConfig, } from './SessionHealthMonitor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAA"}

package/dist/src/session/index.js

@@ -0,0 +1,44 @@
+/**
+ * Session Management Module
+ * SMI-641: Session ID Storage in Claude-Flow Memory
+ *
+ * Provides session lifecycle management with claude-flow memory integration
+ * for context restoration across sessions.
+ *
+ * @example
+ * ```typescript
+ * import { SessionManager, SessionRecovery, DefaultCommandExecutor } from '@skillsmith/core'
+ *
+ * const executor = new DefaultCommandExecutor()
+ * const manager = new SessionManager(executor)
+ *
+ * // Start a new session
+ * const session = await manager.startSession({
+ *   issueId: 'SMI-641',
+ *   worktree: 'phase-2c-session',
+ *   description: 'Implementing session storage'
+ * })
+ *
+ * // Create checkpoints
+ * await manager.createCheckpoint('Completed SessionManager')
+ *
+ * // Record modified files
+ * await manager.recordFileModified('packages/core/src/session/SessionManager.ts')
+ *
+ * // End session
+ * await manager.endSession()
+ *
+ * // Later, recover session
+ * const recovery = new SessionRecovery(manager, executor)
+ * const result = await recovery.restoreSession()
+ * ```
+ */
+// SessionManager - Core session lifecycle management
+export { SessionManager, DefaultCommandExecutor, } from './SessionManager.js';
+// SessionContext - Session state types and utilities
+export { ActiveSessionContext, NullSessionContext, createSessionContext, isActiveContext, getSessionDuration, formatSessionDuration, getLatestCheckpoint, } from './SessionContext.js';
+// SessionRecovery - Session restoration from memory
+export { SessionRecovery, createSessionRecovery, } from './SessionRecovery.js';
+// SessionHealthMonitor - SMI-761: Session health monitoring
+export { SessionHealthMonitor, getHealthMonitor, initializeHealthMonitor, shutdownHealthMonitor, } from './SessionHealthMonitor.js';
+//# sourceMappingURL=index.js.map

package/dist/src/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,qDAAqD;AACrD,OAAO,EACL,cAAc,EACd,sBAAsB,GAIvB,MAAM,qBAAqB,CAAA;AAE5B,qDAAqD;AACrD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GAIpB,MAAM,qBAAqB,CAAA;AAE5B,oDAAoD;AACpD,OAAO,EACL,eAAe,EACf,qBAAqB,GAItB,MAAM,sBAAsB,CAAA;AAE7B,4DAA4D;AAC5D,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GAItB,MAAM,2BAA2B,CAAA"}

package/dist/src/sources/BaseSourceAdapter.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Base Source Adapter
+ * Abstract base class providing common functionality for source adapters
+ *
+ * SMI-1013: Enhanced with token bucket rate limiting and request queuing
+ */
+import type { ISourceAdapter } from './ISourceAdapter.js';
+import { RateLimiter, type RateLimitConfig as TokenBucketConfig } from '../security/RateLimiter.js';
+import { type RetryConfig } from '../utils/retry.js';
+import type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
+/**
+ * Extended source config with token bucket rate limiting (SMI-1013)
+ */
+export interface ExtendedSourceConfig extends SourceConfig {
+    /** Use token bucket rate limiter with queue support (SMI-1013) */
+    useTokenBucket?: boolean;
+    /** Token bucket configuration (overrides legacy rateLimit) */
+    tokenBucketConfig?: TokenBucketConfig;
+    /** Enable retry logic for transient network failures (SMI-880) */
+    enableRetry?: boolean;
+    /** Retry configuration (SMI-880) */
+    retryConfig?: RetryConfig;
+}
+/**
+ * Abstract base class for source adapters
+ *
+ * Provides:
+ * - Configuration management
+ * - Rate limiting
+ * - Request timing
+ * - Error handling utilities
+ *
+ * Subclasses must implement:
+ * - search()
+ * - getRepository()
+ * - fetchSkillContent()
+ * - doHealthCheck()
+ */
+export declare abstract class BaseSourceAdapter implements ISourceAdapter {
+    readonly config: ExtendedSourceConfig;
+    readonly id: string;
+    readonly name: string;
+    readonly type: string;
+    protected initialized: boolean;
+    protected lastRequestTime: number;
+    protected requestCount: number;
+    protected windowStart: number;
+    /** Token bucket rate limiter (SMI-1013) */
+    protected rateLimiter: RateLimiter | null;
+    constructor(config: SourceConfig | ExtendedSourceConfig);
+    /**
+     * Initialize the adapter
+     * Override in subclasses for custom initialization
+     */
+    initialize(): Promise<void>;
+    /**
+     * Subclass initialization hook
+     */
+    protected doInitialize(): Promise<void>;
+    /**
+     * Check source health
+     */
+    checkHealth(): Promise<SourceHealth>;
+    /**
+     * Subclass health check implementation
+     */
+    protected abstract doHealthCheck(): Promise<Partial<SourceHealth>>;
+    /**
+     * Search for repositories
+     */
+    abstract search(options: SourceSearchOptions): Promise<SourceSearchResult>;
+    /**
+     * Get repository metadata
+     */
+    abstract getRepository(location: SourceLocation): Promise<SourceRepository>;
+    /**
+     * Fetch skill content
+     */
+    abstract fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
+    /**
+     * Check if skill exists at location
+     */
+    skillExists(location: SourceLocation): Promise<boolean>;
+    /**
+     * Get skill file SHA for change detection
+     */
+    getSkillSha(location: SourceLocation): Promise<string | null>;
+    /**
+     * Dispose of resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Subclass disposal hook
+     */
+    protected doDispose(): Promise<void>;
+    /**
+     * Wait for rate limit before making a request
+     */
+    protected waitForRateLimit(): Promise<void>;
+    /**
+     * Make a rate-limited fetch request with retry support
+     *
+     * SMI-1013: Uses token bucket rate limiter with queue support when enabled,
+     * otherwise falls back to legacy window-based rate limiting.
+     *
+     * SMI-880: Automatically retries on transient network failures (ETIMEDOUT,
+     * ECONNRESET, 5xx) with exponential backoff when enableRetry is true.
+     */
+    protected fetchWithRateLimit(url: string, options?: RequestInit): Promise<Response>;
+    /**
+     * Get rate limiter status (SMI-1013)
+     *
+     * Returns information about the token bucket rate limiter state,
+     * including queue status if queuing is enabled.
+     */
+    getRateLimiterStatus(): {
+        usingTokenBucket: boolean;
+        queueStatus?: {
+            totalQueued: number;
+            queues: Map<string, number>;
+        } | number;
+    };
+    /**
+     * Update rate limit tracking from response headers
+     */
+    protected updateRateLimitFromResponse(response: Response): void;
+    /**
+     * Build the default skill file path
+     */
+    protected getDefaultSkillPath(location: SourceLocation): string;
+    /**
+     * Build the default branch
+     */
+    protected getDefaultBranch(location: SourceLocation): string;
+    /**
+     * Delay helper
+     */
+    protected delay(ms: number): Promise<void>;
+    /**
+     * Validate configuration
+     */
+    protected validateConfig(): void;
+}
+//# sourceMappingURL=BaseSourceAdapter.d.ts.map

package/dist/src/sources/BaseSourceAdapter.d.ts.map

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