@speclife/core 0.1.0

package/dist/adapters/environment-adapter.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Environment adapters for language-specific worktree setup
+ *
+ * These adapters handle dependency bootstrapping when creating worktrees,
+ * ensuring the worktree is ready to build without manual intervention.
+ */
+import { type ProgressCallback } from '../types.js';
+/** Bootstrap strategy for environment setup */
+export type BootstrapStrategy = 'symlink' | 'install' | 'none';
+/** Result of environment detection */
+export interface DetectionResult {
+    /** Environment name (e.g., 'nodejs', 'python') */
+    name: string;
+    /** Confidence level 0-1 */
+    confidence: number;
+    /** Detected package manager */
+    packageManager?: string;
+    /** Files that triggered detection */
+    markerFiles: string[];
+}
+/** Result of bootstrap operation */
+export interface BootstrapResult {
+    /** Environment that was bootstrapped */
+    environment: string;
+    /** Strategy used */
+    strategy: BootstrapStrategy;
+    /** Whether bootstrap was successful */
+    success: boolean;
+    /** Human-readable message */
+    message: string;
+    /** Path that was set up (if applicable) */
+    path?: string;
+    /** Whether tsconfig was patched for monorepo support */
+    tsconfigPatched?: boolean;
+    /** Detected monorepo info */
+    monorepo?: MonorepoInfo;
+}
+/** Monorepo information */
+export interface MonorepoInfo {
+    /** Whether this is a monorepo */
+    isMonorepo: boolean;
+    /** Type of monorepo setup */
+    type?: 'npm-workspaces' | 'yarn-workspaces' | 'pnpm-workspaces' | 'lerna';
+    /** Root package.json path */
+    rootPackageJson: string;
+    /** List of workspace package paths */
+    workspacePackages: WorkspacePackage[];
+}
+/** A workspace package in a monorepo */
+export interface WorkspacePackage {
+    /** Package name (from package.json) */
+    name: string;
+    /** Relative path from project root */
+    path: string;
+    /** Absolute path */
+    absolutePath: string;
+    /** Entry point for TypeScript (src/index.ts or similar) */
+    entryPoint?: string;
+}
+/** Environment adapter interface */
+export interface EnvironmentAdapter {
+    /** Unique identifier for this environment */
+    readonly name: string;
+    /** Human-readable display name */
+    readonly displayName: string;
+    /** Priority for detection (higher = checked first) */
+    readonly priority: number;
+    /**
+     * Detect if this environment is present in the project
+     * @param projectRoot - Path to the project root
+     * @returns Detection result or null if not detected
+     */
+    detect(projectRoot: string): Promise<DetectionResult | null>;
+    /**
+     * Bootstrap the environment in a worktree
+     * @param worktreePath - Path to the worktree
+     * @param sourceRoot - Path to the source project root
+     * @param strategy - Bootstrap strategy to use
+     * @param onProgress - Progress callback
+     */
+    bootstrap(worktreePath: string, sourceRoot: string, strategy: BootstrapStrategy, onProgress?: ProgressCallback): Promise<BootstrapResult>;
+    /**
+     * Clean up environment artifacts before worktree removal
+     * @param worktreePath - Path to the worktree
+     */
+    cleanup(worktreePath: string): Promise<void>;
+}
+/** Registry of environment adapters */
+export interface EnvironmentRegistry {
+    /** Register an adapter */
+    register(adapter: EnvironmentAdapter): void;
+    /** Get all registered adapters sorted by priority */
+    getAdapters(): EnvironmentAdapter[];
+    /** Get adapter by name */
+    getAdapter(name: string): EnvironmentAdapter | undefined;
+    /** Detect all environments in a project */
+    detectEnvironments(projectRoot: string): Promise<DetectionResult[]>;
+    /**
+     * Bootstrap all detected environments
+     * @param worktreePath - Path to the worktree
+     * @param sourceRoot - Path to the source project root
+     * @param strategy - Bootstrap strategy to use
+     * @param onProgress - Progress callback
+     */
+    bootstrapAll(worktreePath: string, sourceRoot: string, strategy: BootstrapStrategy, onProgress?: ProgressCallback): Promise<BootstrapResult[]>;
+    /** Clean up all environments */
+    cleanupAll(worktreePath: string): Promise<void>;
+}
+/**
+ * Create an environment registry with optional initial adapters
+ */
+export declare function createEnvironmentRegistry(initialAdapters?: EnvironmentAdapter[]): EnvironmentRegistry;
+/**
+ * Node.js environment adapter
+ * Detects: package.json, package-lock.json, yarn.lock, pnpm-lock.yaml
+ * Bootstraps: symlinks node_modules from source to worktree
+ *
+ * For monorepos: Detects workspace packages and auto-patches tsconfig.json
+ * with paths mappings to ensure TypeScript resolves to worktree source.
+ */
+export declare function createNodejsAdapter(): EnvironmentAdapter;
+/**
+ * Python environment adapter
+ * Detects: requirements.txt, pyproject.toml, setup.py, Pipfile
+ * Bootstraps: symlinks .venv from source to worktree
+ */
+export declare function createPythonAdapter(): EnvironmentAdapter;
+/**
+ * Go environment adapter
+ * Detects: go.mod
+ * Bootstraps: no-op (Go uses global module cache)
+ */
+export declare function createGoAdapter(): EnvironmentAdapter;
+/**
+ * Rust environment adapter
+ * Detects: Cargo.toml
+ * Bootstraps: no-op (Rust uses global cargo cache)
+ */
+export declare function createRustAdapter(): EnvironmentAdapter;
+/**
+ * Create the default environment registry with all built-in adapters
+ */
+export declare function createDefaultEnvironmentRegistry(): EnvironmentRegistry;
+/**
+ * Detect if a project is a monorepo and identify workspace packages
+ */
+export declare function detectMonorepo(projectRoot: string): MonorepoInfo;
+/**
+ * Patch tsconfig files in a worktree to add paths for local workspace packages
+ * This ensures TypeScript resolves to worktree source, not the symlinked main repo
+ */
+export declare function patchTsconfigForMonorepo(worktreePath: string, monorepo: MonorepoInfo, onProgress?: ProgressCallback): boolean;
+//# sourceMappingURL=environment-adapter.d.ts.map

package/dist/adapters/environment-adapter.d.ts.map

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