@domainlang/cli 0.5.2 → 0.6.0

package/out/services/dependency-resolver.js

@@ -0,0 +1,448 @@
+/**
+ * Dependency Resolution Service (CLI-only)
+ *
+ * Discovers and resolves transitive dependencies for DomainLang packages.
+ * Generates lock files for reproducible builds.
+ *
+ * Algorithm:
+ * 1. Parse root model.yaml
+ * 2. Download all direct dependencies
+ * 3. Parse each dependency's model.yaml
+ * 4. Recursively discover transitive dependencies
+ * 5. Resolve version constraints using "Latest Wins" strategy
+ * 6. Generate lock file with pinned commit hashes
+ *
+ * Resolution Strategy ("Latest Wins"):
+ * - SemVer tags (same major): Pick highest compatible version
+ * - Same branch: No conflict, resolve once
+ * - Commit pins: Error (explicit pins are intentional)
+ * - Major version mismatch: Error
+ * - Tag vs Branch: Error (incompatible intent)
+ *
+ * This module contains network operations and should ONLY be used in CLI contexts.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import YAML from 'yaml';
+import { GitUrlParser, GitUrlResolver } from './git-url-resolver.js';
+import { parseSemVer, pickLatestSemVer, detectRefType } from './semver.js';
+export class DependencyResolver {
+    constructor(workspaceRoot, gitResolver) {
+        /** Override messages for CLI output */
+        this.overrideMessages = [];
+        /** Resolution messages from "Latest Wins" auto-resolution */
+        this.resolutionMessages = [];
+        this.workspaceRoot = workspaceRoot;
+        // Per PRS-010: Project-local cache at .dlang/packages/
+        const cacheDir = path.join(workspaceRoot, '.dlang', 'packages');
+        this.gitResolver = gitResolver || new GitUrlResolver(cacheDir);
+    }
+    /**
+     * Resolves all dependencies for a workspace.
+     *
+     * Process:
+     * 1. Load root model.yaml
+     * 2. Build dependency graph (discover transitive deps)
+     * 3. Resolve version constraints
+     * 4. Generate lock file
+     * 5. Download all dependencies to cache
+     *
+     * @returns Generated lock file
+     */
+    async resolveDependencies() {
+        // Load root package config
+        const rootConfig = await this.loadPackageConfig(this.workspaceRoot);
+        if (!rootConfig.dependencies || Object.keys(rootConfig.dependencies).length === 0) {
+            // No dependencies
+            return { version: '1', dependencies: {} };
+        }
+        // Build dependency graph
+        const graph = await this.buildDependencyGraph(rootConfig);
+        // Apply overrides before conflict detection
+        this.applyOverrides(graph, rootConfig.overrides);
+        // Detect version conflicts and package-level cycles before resolving
+        this.detectVersionConflicts(graph);
+        this.detectPackageCycles(graph);
+        // Resolve version constraints
+        await this.resolveVersions(graph);
+        // Generate and return lock file (caller writes to disk)
+        return this.generateLockFile(graph);
+    }
+    /**
+     * Applies ref overrides from model.yaml to resolve conflicts explicitly.
+     *
+     * Overrides take precedence over all other constraints.
+     *
+     * @example
+     * ```yaml
+     * overrides:
+     *   domainlang/core: v2.0.0
+     * ```
+     */
+    applyOverrides(graph, overrides) {
+        if (!overrides)
+            return;
+        for (const [pkg, overrideRef] of Object.entries(overrides)) {
+            const node = graph.nodes[pkg];
+            if (node) {
+                // Override replaces all constraints with a single definitive ref
+                node.constraints = new Set([overrideRef]);
+                node.refConstraint = overrideRef;
+                // Track that this was an override for messaging
+                this.overrideMessages.push(`Override applied: ${pkg}@${overrideRef}`);
+            }
+        }
+    }
+    /**
+     * Returns any override messages from the last dependency resolution.
+     */
+    getOverrideMessages() {
+        return this.overrideMessages;
+    }
+    /**
+     * Builds the complete dependency graph by recursively discovering transitive dependencies.
+     */
+    async buildDependencyGraph(rootConfig) {
+        const graph = {
+            nodes: {},
+            root: rootConfig.name || 'root',
+        };
+        // Process root dependencies
+        const queue = [];
+        for (const [depName, refConstraint] of Object.entries(rootConfig.dependencies || {})) {
+            queue.push({
+                packageKey: depName,
+                refConstraint,
+                parent: graph.root
+            });
+        }
+        // BFS to discover all transitive dependencies
+        const visited = new Set();
+        while (queue.length > 0) {
+            const entry = queue.shift();
+            if (!entry)
+                break;
+            const { packageKey, refConstraint, parent } = entry;
+            // Skip if already processed
+            if (visited.has(packageKey)) {
+                // Update dependents list and record constraint
+                const existing = graph.nodes[packageKey];
+                if (!existing.dependents.includes(parent)) {
+                    existing.dependents.push(parent);
+                }
+                if (!existing.constraints)
+                    existing.constraints = new Set();
+                existing.constraints.add(refConstraint);
+                continue;
+            }
+            visited.add(packageKey);
+            // Parse package identifier
+            const gitInfo = GitUrlParser.parse(packageKey);
+            // Download package to get its model.yaml
+            const packagePath = await this.gitResolver.resolve(packageKey);
+            const packageDir = path.dirname(packagePath);
+            // Load package config
+            const packageConfig = await this.loadPackageConfig(packageDir);
+            // Add to graph
+            graph.nodes[packageKey] = {
+                packageKey,
+                refConstraint,
+                constraints: new Set([refConstraint]),
+                repoUrl: gitInfo.repoUrl,
+                dependencies: packageConfig.dependencies || {},
+                dependents: [parent],
+            };
+            // Queue transitive dependencies
+            for (const [transDepName, transRefConstraint] of Object.entries(packageConfig.dependencies || {})) {
+                queue.push({
+                    packageKey: transDepName,
+                    refConstraint: transRefConstraint,
+                    parent: packageKey,
+                });
+            }
+        }
+        return graph;
+    }
+    /**
+     * Resolves ref constraints to specific commits.
+     *
+     * Simple algorithm: Use the ref specified in the constraint.
+     * Detects refType (tag, branch, or commit) based on format.
+     */
+    async resolveVersions(graph) {
+        for (const [packageKey, node] of Object.entries(graph.nodes)) {
+            // Parse package to get repo info
+            const gitInfo = GitUrlParser.parse(packageKey);
+            // Extract ref from constraint
+            const ref = this.extractRefFromConstraint(node.refConstraint);
+            // Detect ref type based on format
+            const refType = detectRefType(ref);
+            // Resolve ref to commit hash
+            const commitHash = await this.resolveCommitHash(gitInfo.repoUrl, ref, gitInfo);
+            node.resolvedRef = ref;
+            node.refType = refType;
+            node.commitHash = commitHash;
+        }
+    }
+    /**
+     * Extracts a ref from a constraint string.
+     *
+     * Examples:
+     * - "^1.0.0" → "1.0.0" (treated as tag)
+     * - "~2.3.0" → "2.3.0" (treated as tag)
+     * - "1.5.0" → "1.5.0" (treated as tag)
+     * - "main" → "main" (treated as branch)
+     * - "abc123def" → "abc123def" (treated as commit)
+     * - "owner/repo@1.0.0" → "1.0.0"
+     */
+    extractRefFromConstraint(constraint) {
+        // Remove semver operators (legacy support)
+        let ref = constraint.replace(/^[\^~>=<]/, '');
+        // Extract ref from full import URL if present
+        if (ref.includes('@')) {
+            ref = ref.split('@')[1];
+        }
+        return ref || 'main';
+    }
+    /**
+     * Resolves a version (tag/branch) to a commit hash.
+     */
+    async resolveCommitHash(_repoUrl, _version, gitInfo) {
+        // Use GitUrlResolver to resolve the commit
+        const commitHash = await this.gitResolver.resolveCommit(gitInfo);
+        return commitHash;
+    }
+    /**
+     * Generates a lock file from the resolved dependency graph.
+     */
+    generateLockFile(graph) {
+        const dependencies = {};
+        for (const [packageKey, node] of Object.entries(graph.nodes)) {
+            if (!node.resolvedRef || !node.commitHash) {
+                throw new Error(`Failed to resolve ref for '${packageKey}'.\n` +
+                    `Hint: Check that the package exists and the ref is valid.`);
+            }
+            dependencies[packageKey] = {
+                ref: node.resolvedRef,
+                refType: node.refType ?? 'commit',
+                resolved: node.repoUrl || '',
+                commit: node.commitHash,
+                // Future: Calculate integrity hash
+            };
+        }
+        return {
+            version: '1',
+            dependencies,
+        };
+    }
+    /**
+     * Loads and parses a package's model.yaml file.
+     */
+    async loadPackageConfig(packageDir) {
+        const yamlPath = path.join(packageDir, 'model.yaml');
+        try {
+            const yamlContent = await fs.readFile(yamlPath, 'utf-8');
+            return this.parseYaml(yamlContent);
+        }
+        catch {
+            // No model.yaml found
+            return {};
+        }
+    }
+    /**
+     * Parses model.yaml content.
+     *
+     * Expected structure:
+     * model:
+     *   name: package-name
+     *   version: 1.0.0
+     *   entry: index.dlang
+     *
+     * dependencies:
+     *   package-name:
+     *     source: owner/repo
+     *     ref: v1.0.0
+     */
+    parseYaml(content) {
+        const parsed = YAML.parse(content);
+        const config = {};
+        if (parsed.model) {
+            config.name = parsed.model.name;
+            config.version = parsed.model.version;
+            config.entry = parsed.model.entry;
+        }
+        if (parsed.dependencies) {
+            config.dependencies = {};
+            for (const [, depInfo] of Object.entries(parsed.dependencies)) {
+                if (depInfo.source) {
+                    const refConstraint = depInfo.ref || 'main';
+                    // Store as "source@ref" for consistency with import resolution
+                    config.dependencies[depInfo.source] = refConstraint;
+                }
+            }
+        }
+        // Parse overrides section for explicit ref control
+        if (parsed.overrides) {
+            config.overrides = parsed.overrides;
+        }
+        return config;
+    }
+    /**
+     * Detects ref conflicts and applies "Latest Wins" resolution strategy.
+     *
+     * Resolution Rules:
+     * - SemVer tags (same major): Pick highest version automatically
+     * - Same branch refs: No conflict, use single resolution
+     * - Commit SHA conflicts: Error (explicit pins are intentional)
+     * - Major version mismatch: Error (breaking change)
+     * - Tag vs Branch: Error (incompatible intent)
+     *
+     * Modifies graph nodes in-place to set the resolved constraint.
+     * Throws an error only for unresolvable conflicts.
+     */
+    detectVersionConflicts(graph) {
+        const resolutionMessages = [];
+        for (const [pkg, node] of Object.entries(graph.nodes)) {
+            const constraints = node.constraints ?? new Set([node.refConstraint]);
+            if (constraints.size <= 1)
+                continue; // No conflict
+            const refs = Array.from(constraints);
+            const refTypes = refs.map(ref => ({
+                ref,
+                type: detectRefType(ref),
+                semver: parseSemVer(ref),
+            }));
+            // Check for mixed types (tag vs branch vs commit)
+            const types = new Set(refTypes.map(r => r.type));
+            // Case 1: All commits - must be exact match
+            if (types.size === 1 && types.has('commit')) {
+                this.throwConflictError(pkg, refs, node.dependents, 'Explicit commit pins cannot be automatically resolved.\n' +
+                    'Add an override in model.yaml:\n\n' +
+                    '  overrides:\n' +
+                    `    ${pkg}: ${refs[0]}`);
+            }
+            // Case 2: Mixed types (tag vs branch or tag vs commit)
+            if (types.size > 1) {
+                this.throwConflictError(pkg, refs, node.dependents, 'Cannot mix ref types (tags, branches, commits).\n' +
+                    'Add an override in model.yaml to specify which to use:\n\n' +
+                    '  overrides:\n' +
+                    `    ${pkg}: <ref>`);
+            }
+            // Case 3: All branches - must be same branch
+            if (types.size === 1 && types.has('branch')) {
+                const uniqueBranches = new Set(refs);
+                if (uniqueBranches.size > 1) {
+                    this.throwConflictError(pkg, refs, node.dependents, 'Different branch refs cannot be automatically resolved.\n' +
+                        'Add an override in model.yaml:\n\n' +
+                        '  overrides:\n' +
+                        `    ${pkg}: ${refs[0]}`);
+                }
+                // Same branch - no conflict, continue
+                continue;
+            }
+            // Case 4: All SemVer tags - apply "Latest Wins"
+            const semvers = refTypes
+                .filter((r) => r.semver !== undefined)
+                .map(r => r.semver);
+            if (semvers.length !== refs.length) {
+                // Some refs don't parse as SemVer - can't auto-resolve
+                this.throwConflictError(pkg, refs, node.dependents, 'Not all refs are valid SemVer tags.\n' +
+                    'Add an override in model.yaml:\n\n' +
+                    '  overrides:\n' +
+                    `    ${pkg}: <ref>`);
+            }
+            // Check major version compatibility
+            const majors = new Set(semvers.map(s => s.major));
+            if (majors.size > 1) {
+                const majorList = Array.from(majors).sort().join(' vs ');
+                this.throwConflictError(pkg, refs, node.dependents, `Major version mismatch (v${majorList}). This may indicate breaking changes.\n` +
+                    'Add an override in model.yaml if you want to force a version:\n\n' +
+                    '  overrides:\n' +
+                    `    ${pkg}: ${refs[refs.length - 1]}`);
+            }
+            // All same major version - pick latest (Latest Wins!)
+            const latest = pickLatestSemVer(refs);
+            if (latest && latest !== node.refConstraint) {
+                // Update the node to use the resolved ref
+                node.refConstraint = latest;
+                // Log the resolution for user feedback
+                const otherRefs = refs.filter(r => r !== latest).join(', ');
+                resolutionMessages.push(`Resolved ${pkg}: using ${latest} (satisfies ${otherRefs})`);
+            }
+        }
+        // Store resolution messages for later output
+        if (resolutionMessages.length > 0) {
+            this.resolutionMessages = resolutionMessages;
+        }
+    }
+    /**
+     * Throws a formatted conflict error with actionable hints.
+     */
+    throwConflictError(pkg, refs, dependents, hint) {
+        const depLines = dependents.map((d, i) => `  └─ ${d} requires ${pkg}@${refs[i] || refs[0]}`).join('\n');
+        throw new Error(`Dependency ref conflict for '${pkg}'\n` +
+            depLines + '\n\n' +
+            hint);
+    }
+    /**
+     * Returns any resolution messages from the last dependency resolution.
+     * Useful for CLI output to inform users about auto-resolved conflicts.
+     */
+    getResolutionMessages() {
+        return this.resolutionMessages;
+    }
+    /**
+     * Detects package-level cycles in the dependency graph and throws a clear error.
+     */
+    detectPackageCycles(graph) {
+        const GRAY = 1, BLACK = 2;
+        const color = {};
+        const stack = [];
+        const visit = (pkg) => {
+            color[pkg] = GRAY;
+            stack.push(pkg);
+            const deps = Object.keys(graph.nodes[pkg]?.dependencies ?? {});
+            for (const dep of deps) {
+                if (!graph.nodes[dep])
+                    continue; // Unknown dep will resolve later
+                if (color[dep] === GRAY) {
+                    // Found a back edge: cycle
+                    const cycleStart = stack.indexOf(dep);
+                    const cyclePath = [...stack.slice(cycleStart), dep].join(' → ');
+                    throw new Error(`Cyclic package dependency detected:\n` +
+                        `  ${cyclePath}\n\n` +
+                        `Hint: Extract shared types into a separate package that both can depend on.`);
+                }
+                if (color[dep] !== BLACK)
+                    visit(dep);
+            }
+            stack.pop();
+            color[pkg] = BLACK;
+        };
+        for (const pkg of Object.keys(graph.nodes)) {
+            if (!color[pkg])
+                visit(pkg);
+        }
+    }
+    /**
+     * Loads an existing lock file from disk.
+     */
+    static async loadLockFile(workspaceRoot) {
+        const lockPath = path.join(workspaceRoot, 'model.lock');
+        try {
+            const content = await fs.readFile(lockPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // No lock file
+            return undefined;
+        }
+    }
+    /**
+     * Parses a lock file from JSON format.
+     */
+    static parseLockFile(content) {
+        return JSON.parse(content);
+    }
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/out/services/dependency-resolver.js.map

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

package/out/services/git-url-resolver.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Git Repository Resolver Service (CLI-only)
+ *
+ * Resolves git-based package imports to local cached repositories.
+ * Supports simplified GitHub syntax (owner/repo@version) and full URLs.
+ *
+ * Design: Repository-level imports (not individual files)
+ * - Imports load entire package
+ * - Package entry point defined in model.yaml
+ * - Version pinning at repository level
+ *
+ * This module contains network operations (git clone, git ls-remote) and
+ * should ONLY be used in CLI contexts, never in the LSP.
+ */
+import type { GitImportInfo, LockFile } from './types.js';
+/**
+ * Parses import URLs into structured git import information.
+ *
+ * Supported formats:
+ * - owner/repo@version (GitHub assumed)
+ * - owner/repo (GitHub, defaults to main)
+ * - https://github.com/owner/repo@version
+ * - https://gitlab.com/owner/repo@version
+ * - https://git.example.com/owner/repo@version
+ */
+export declare class GitUrlParser {
+    /**
+     * Determines if an import string is a git repository import.
+     */
+    static isGitUrl(importStr: string): boolean;
+    /**
+     * Parses a git import URL into structured components.
+     *
+     * @param importStr - The import URL string
+     * @returns Parsed git import information
+     * @throws Error if URL format is invalid
+     */
+    static parse(importStr: string): GitImportInfo;
+    /**
+     * Checks if string is GitHub shorthand format.
+     */
+    private static isGitHubShorthand;
+    /**
+     * Parses GitHub shorthand (owner/repo or owner/repo@version).
+     */
+    private static parseGitHubShorthand;
+    /**
+     * Parses full git URLs (https://...).
+     *
+     * Supported:
+     * - https://github.com/owner/repo@version
+     * - https://gitlab.com/owner/repo@version
+     * - https://git.example.com/owner/repo@version
+     */
+    private static parseFullUrl;
+}
+/**
+ * Resolves git repository imports to local entry point files.
+ *
+ * Implements a content-addressable cache:
+ * - Cache location: .dlang/packages/ (project-local, per PRS-010)
+ * - Cache key: {owner}/{repo}/{commit-hash}
+ * - Downloads entire repository on first use
+ * - Reads model.yaml to find entry point
+ * - Returns path to entry point file
+ */
+export declare class GitUrlResolver {
+    private cacheDir;
+    private lockFile?;
+    /**
+     * Creates a GitUrlResolver with a project-local cache directory.
+     *
+     * @param cacheDir - The cache directory path. Per PRS-010, this should be
+     *                   the project's `.dlang/packages/` directory for isolation
+     *                   and reproducibility (like node_modules).
+     */
+    constructor(cacheDir: string);
+    /**
+     * Sets the lock file for dependency resolution.
+     *
+     * When a lock file is set, all package imports will use
+     * the locked commit hashes instead of resolving versions.
+     * This ensures reproducible builds and handles transitive dependencies.
+     *
+     * @param lockFile - The parsed lock file from the workspace root
+     */
+    setLockFile(lockFile: LockFile | undefined): void;
+    /**
+     * Resolves a git import URL to the package's entry point file path.
+     *
+     * Process:
+     * 1. Parse git URL
+     * 2. Check lock file for pinned version (transitive dependency support)
+     * 3. Resolve version to commit hash (if not locked)
+     * 4. Check cache
+     * 5. Download repository if not cached
+     * 6. Read model.yaml to find entry point
+     * 7. Return path to entry point file
+     *
+     * @param importUrl - The git import URL
+     * @returns Path to the package's entry point file
+     */
+    resolve(importUrl: string): Promise<string>;
+    /**
+     * Reads model.yaml to get the package entry point.
+     * Falls back to index.dlang if no model.yaml found.
+     */
+    private getEntryPoint;
+    /**
+     * Parses model.yaml content to extract entry point.
+     *
+     * Expected structure:
+     * model:
+     *   entry: index.dlang
+     */
+    private parseYaml;
+    /**
+     * Resolves a version (tag/branch) to a commit hash using git ls-remote.
+     */
+    resolveCommit(gitInfo: GitImportInfo): Promise<string>;
+    /**
+     * Gets the local cache path for a git repository.
+     *
+     * Format: .dlang/packages/{owner}/{repo}/{version}/
+     *
+     * Per PRS-010: Project-local cache structure mirrors the Design Considerations
+     * section showing `.dlang/packages/{owner}/{repo}/{version}/` layout.
+     */
+    getCachePath(gitInfo: GitImportInfo, commitHash: string): string;
+    /**
+     * Checks if a file or directory exists in the cache.
+     */
+    private existsInCache;
+    /**
+     * Downloads a git repository to the cache.
+     *
+     * Uses shallow clone for efficiency (only downloads the specific commit).
+     */
+    downloadRepo(gitInfo: GitImportInfo, commitHash: string, cachePath: string): Promise<void>;
+    /**
+     * Clears the entire cache.
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Gets cache statistics (size, number of cached repos, etc.).
+     *
+     * Cache structure: .dlang/packages/{owner}/{repo}/{version}/
+     */
+    getCacheStats(): Promise<{
+        totalSize: number;
+        repoCount: number;
+        cacheDir: string;
+    }>;
+    /**
+     * Gets the total size of a directory in bytes.
+     */
+    private getDirectorySize;
+}