opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/install/resolution/types.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Types for the recursive dependency resolution system.
+ * Used by graph builder, package loader, installation planner, and executor.
+ */
+import type { PackageYml } from '../../../types/index.js';
+import type { InstallationContext } from '../unified/context.js';
+import type { InstallOptions } from '../../../types/index.js';
+import type { Platform } from '../../platforms.js';
+import type { VersionSolution } from './version-solver.js';
+/** Parsed manifest (openpackage.yml) - alias for PackageYml */
+export type ParsedManifest = PackageYml;
+/**
+ * Canonical identifier for a dependency that's stable across resolution.
+ * Used for deduplication and cycle detection.
+ */
+export interface DependencyId {
+    /** Computed unique key (hash of source properties) */
+    key: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Source type for this dependency */
+    sourceType: 'registry' | 'path' | 'git';
+}
+/**
+ * Raw dependency declaration as found in a manifest.
+ * This is the unresolved, unparsed form directly from openpackage.yml.
+ */
+export interface DependencyDeclaration {
+    /** Package name as declared */
+    name: string;
+    /** Version constraint (for registry deps) */
+    version?: string;
+    /** Local path (relative to declaring manifest) */
+    path?: string;
+    /** Git URL */
+    url?: string;
+    /** Git ref (branch, tag, commit) - also from url#ref */
+    ref?: string;
+    /** Base path override (for reproducibility) */
+    base?: string;
+    /** Whether this is a dev dependency */
+    isDev: boolean;
+    /** Path to the manifest file that declared this dependency */
+    declaredIn: string;
+    /** Depth in dependency tree (0 = workspace root direct deps) */
+    depth: number;
+}
+/**
+ * Resolved source with all ambiguity removed.
+ * Used to load package content and build installation context.
+ */
+export interface ResolvedSource {
+    type: 'registry' | 'path' | 'git';
+    /** Registry: package name */
+    packageName?: string;
+    /** Registry: resolved version */
+    resolvedVersion?: string;
+    /** Registry: optional registry path */
+    registryPath?: string;
+    /** Path: absolute filesystem path */
+    absolutePath?: string;
+    /** Git: repository URL */
+    gitUrl?: string;
+    /** Git: ref (branch, tag, commit) */
+    gitRef?: string;
+    /** Git: resource path within repo */
+    resourcePath?: string;
+    /** Common: content root after loading */
+    contentRoot?: string;
+    /** Common: path to manifest file */
+    manifestPath?: string;
+}
+/**
+ * Base detection result (from existing base-resolver / loaders).
+ */
+export interface BaseDetectionResult {
+    base?: string;
+    relative?: string;
+    source?: 'openpackage' | 'plugin' | 'marketplace' | 'pattern' | 'user-selection' | 'manifest';
+    pattern?: string;
+    matchType?: string;
+}
+/**
+ * Package data after loading from source.
+ */
+export interface LoadedPackageData {
+    /** Package name from manifest */
+    name: string;
+    /** Package version */
+    version: string;
+    /** Absolute path to content root */
+    contentRoot: string;
+    /** Absolute path to repo root (for git sources), when available */
+    repoRoot?: string;
+    /** Package metadata (PackageYml) */
+    metadata: PackageYml;
+    /** Parsed manifest */
+    manifest: ParsedManifest;
+    /** Base detection results */
+    baseDetection?: BaseDetectionResult;
+    /** Format detection (plugin, standard, etc.) - from loader */
+    formatDetection?: {
+        format?: unknown;
+    };
+}
+/**
+ * Resolution state for a dependency node.
+ */
+export type NodeState = 'pending' | 'discovering' | 'discovered' | 'loading' | 'loaded' | 'installing' | 'installed' | 'failed' | 'skipped';
+/**
+ * A node in the dependency graph.
+ * Represents a single package with its metadata and resolution state.
+ */
+export interface ResolutionDependencyNode {
+    /** Unique identifier */
+    id: DependencyId;
+    /** Original declaration(s) that led to this node */
+    declarations: DependencyDeclaration[];
+    /** Resolved source information */
+    source: ResolvedSource;
+    /** Children (dependencies of this package) */
+    children: DependencyId[];
+    /** Parents (packages that depend on this) */
+    parents: DependencyId[];
+    /** Resolution state */
+    state: NodeState;
+    /** Loaded package data (populated in Phase 2) */
+    loaded?: LoadedPackageData;
+    /** Installation context (populated in Phase 3) */
+    installContext?: InstallationContext;
+}
+/**
+ * Detected cycle in the dependency graph.
+ */
+export interface DependencyCycle {
+    /** Nodes involved in the cycle */
+    nodes: DependencyId[];
+    /** How the cycle was resolved */
+    resolution: 'skipped' | 'error' | 'ignored';
+}
+/**
+ * Graph metadata.
+ */
+export interface GraphMetadata {
+    /** When graph was built */
+    builtAt: Date;
+    /** Workspace root */
+    workspaceRoot: string;
+    /** Total node count */
+    nodeCount: number;
+    /** Maximum depth */
+    maxDepth: number;
+    /** Warnings accumulated during discovery */
+    warnings: string[];
+}
+/**
+ * The complete dependency graph.
+ */
+export interface DependencyGraph {
+    /** All nodes keyed by their unique ID */
+    nodes: Map<string, ResolutionDependencyNode>;
+    /** Root node IDs - entry points */
+    roots: DependencyId[];
+    /** Topologically sorted installation order */
+    installationOrder: DependencyId[];
+    /** Detected cycles */
+    cycles: DependencyCycle[];
+    /** Graph metadata */
+    metadata: GraphMetadata;
+}
+/**
+ * A package skipped during planning.
+ */
+export interface SkippedPackage {
+    id: DependencyId;
+    reason: 'not-loaded' | 'already-installed' | 'cycle' | 'failed';
+}
+/**
+ * Installation plan produced by the planner.
+ */
+export interface InstallationPlan {
+    /** Contexts to install, in order */
+    contexts: InstallationContext[];
+    /** Packages skipped and why */
+    skipped: SkippedPackage[];
+    /** The graph this plan was built from */
+    graph: DependencyGraph;
+    /** Estimated operations (for reporting) */
+    estimatedOperations?: number;
+}
+/**
+ * Options for the graph builder.
+ */
+export interface GraphBuilderOptions {
+    /** Include dev-dependencies at workspace root level */
+    includeDev?: boolean;
+    /** Maximum recursion depth */
+    maxDepth?: number;
+    /** Workspace root directory (cwd for path resolution when using workspace manifest) */
+    workspaceRoot: string;
+    /**
+     * Optional root manifest path. When set, the graph is built from this manifest
+     * instead of workspace .openpackage/openpackage.yml. Path resolution for root-level
+     * deps uses dirname(rootManifestPath).
+     */
+    rootManifestPath?: string;
+    /**
+     * When true, include the root manifest package itself as a node in the graph.
+     * This makes the executor install the root package along with its dependencies
+     * in a single unified flow. Default: false.
+     */
+    includeRoot?: boolean;
+    /** Skip git cache (for --remote flag) */
+    skipCache?: boolean;
+}
+/**
+ * Options for the package loader.
+ */
+export interface PackageLoaderOptions {
+    /** Enable parallel loading for same-depth nodes */
+    parallel?: boolean;
+    /** Enable in-memory cache of loaded packages */
+    cacheEnabled?: boolean;
+    /** Install options passed to source loaders */
+    installOptions?: InstallOptions;
+}
+/**
+ * Options for the installation planner.
+ */
+export interface InstallationPlannerOptions {
+    /** Resolved platforms (shared across all packages) */
+    platforms: Platform[];
+    /** Install options */
+    installOptions: InstallOptions;
+    /** Force reinstall even if already installed */
+    force?: boolean;
+}
+/**
+ * Options for the dependency resolution executor.
+ */
+export interface ExecutorOptions {
+    /** Graph builder options */
+    graphOptions: GraphBuilderOptions;
+    /** Package loader options */
+    loaderOptions: PackageLoaderOptions;
+    /** Installation planner options */
+    plannerOptions: InstallationPlannerOptions;
+    /** Dry run: stop after planning, do not install */
+    dryRun?: boolean;
+    /** Fail on first installation failure */
+    failFast?: boolean;
+}
+/**
+ * Result for a single package installation.
+ */
+export interface PackageResult {
+    id: DependencyId;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+/**
+ * Summary of execution.
+ */
+export interface ExecutionSummary {
+    total: number;
+    installed: number;
+    failed: number;
+    skipped: number;
+}
+/**
+ * Result of running the dependency resolution executor.
+ */
+export interface ExecutionResult {
+    /** Whether all packages installed successfully */
+    success: boolean;
+    /** Error message if overall failure */
+    error?: string;
+    /** Per-package results */
+    results: PackageResult[];
+    /** Summary counts */
+    summary?: ExecutionSummary;
+    /** The dependency graph (for debugging/reporting) */
+    graph?: DependencyGraph;
+    /** Warnings accumulated during execution */
+    warnings?: string[];
+    /** Version solution from semver constraint resolution */
+    versionSolution?: VersionSolution;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/core/install/resolution/types.d.ts.map

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

package/packages/core/dist/core/install/resolution/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for the recursive dependency resolution system.
+ * Used by graph builder, package loader, installation planner, and executor.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/core/install/resolution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/install/resolution/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/packages/core/dist/core/install/resolution/version-solver.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Semver constraint resolution for registry packages in the dependency graph.
+ * Finds compatible versions across multiple declarations with different constraints.
+ */
+import type { DependencyGraph } from './types.js';
+export interface VersionSolution {
+    resolved: Map<string, string>;
+    conflicts: VersionConflict[];
+}
+export interface VersionConflict {
+    packageName: string;
+    ranges: string[];
+    requestedBy: string[];
+}
+export interface SolverOptions {
+    force?: boolean;
+    allowPrerelease?: boolean;
+    onConflict?: (conflict: VersionConflict, availableVersions: string[]) => Promise<string | null>;
+}
+/**
+ * Solve version constraints for all registry packages in the dependency graph.
+ * Groups nodes by package name, finds intersecting semver ranges, and picks
+ * the highest satisfying version.
+ */
+export declare function solveVersions(graph: DependencyGraph, options?: SolverOptions): Promise<VersionSolution>;
+/**
+ * Check if a specific version satisfies all given constraints.
+ */
+export declare function versionSatisfiesAll(version: string, ranges: string[], allowPrerelease?: boolean): boolean;
+/**
+ * Find the intersection range of multiple semver ranges (as a displayable string).
+ * Returns null if ranges are incompatible.
+ */
+export declare function intersectRanges(ranges: string[]): string | null;
+/**
+ * Create an interactive conflict handler that uses promptVersionSelection.
+ * Returns a handler function suitable for the onConflict option.
+ *
+ * @param promptVersionSelection - The prompt function to use for version selection
+ * @returns An onConflict handler function
+ */
+export declare function createInteractiveConflictHandler(promptVersionSelection: (packageName: string, versions: string[], action?: string) => Promise<string | null>): (conflict: VersionConflict, availableVersions: string[]) => Promise<string | null>;
+//# sourceMappingURL=version-solver.d.ts.map

package/packages/core/dist/core/install/resolution/version-solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-solver.d.ts","sourceRoot":"","sources":["../../../../src/core/install/resolution/version-solver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjG;AAOD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgD1B;AA2FD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAAE,EAChB,eAAe,UAAQ,GACtB,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAe/D;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC3G,CAAC,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQpF"}

package/packages/core/dist/core/install/resolution/version-solver.js

@@ -0,0 +1,166 @@
+/**
+ * Semver constraint resolution for registry packages in the dependency graph.
+ * Finds compatible versions across multiple declarations with different constraints.
+ */
+import semver from 'semver';
+/**
+ * Solve version constraints for all registry packages in the dependency graph.
+ * Groups nodes by package name, finds intersecting semver ranges, and picks
+ * the highest satisfying version.
+ */
+export async function solveVersions(graph, options = {}) {
+    const { force = false, allowPrerelease = false, onConflict } = options;
+    const resolved = new Map();
+    const conflicts = [];
+    const registryPackages = groupRegistryNodesByPackage(graph);
+    for (const [packageName, nodes] of registryPackages) {
+        const constraints = extractConstraints(nodes);
+        if (constraints.length === 0) {
+            continue;
+        }
+        const ranges = constraints.map(c => c.range);
+        const requestedBy = constraints.map(c => c.requestedBy);
+        const availableVersions = extractAvailableVersions(nodes);
+        const satisfyingVersion = findHighestSatisfyingVersion(ranges, availableVersions, allowPrerelease);
+        if (satisfyingVersion) {
+            resolved.set(packageName, satisfyingVersion);
+        }
+        else if (force && availableVersions.length > 0) {
+            const highest = semver.maxSatisfying(availableVersions, '*', { includePrerelease: allowPrerelease });
+            if (highest) {
+                resolved.set(packageName, highest);
+            }
+            conflicts.push({ packageName, ranges, requestedBy });
+        }
+        else {
+            const conflict = { packageName, ranges, requestedBy };
+            if (onConflict && availableVersions.length > 0) {
+                const chosenVersion = await onConflict(conflict, availableVersions);
+                if (chosenVersion) {
+                    resolved.set(packageName, chosenVersion);
+                    continue;
+                }
+            }
+            conflicts.push(conflict);
+        }
+    }
+    return { resolved, conflicts };
+}
+function groupRegistryNodesByPackage(graph) {
+    const grouped = new Map();
+    for (const node of graph.nodes.values()) {
+        if (node.source.type !== 'registry' || !node.source.packageName) {
+            continue;
+        }
+        const packageName = node.source.packageName;
+        const existing = grouped.get(packageName) || [];
+        existing.push(node);
+        grouped.set(packageName, existing);
+    }
+    return grouped;
+}
+function extractConstraints(nodes) {
+    const constraints = [];
+    for (const node of nodes) {
+        for (const decl of node.declarations) {
+            const range = normalizeVersionRange(decl.version);
+            if (range) {
+                constraints.push({
+                    range,
+                    requestedBy: decl.declaredIn
+                });
+            }
+        }
+    }
+    return constraints;
+}
+function normalizeVersionRange(version) {
+    if (!version)
+        return null;
+    const normalized = version.trim().toLowerCase();
+    if (normalized === '*' || normalized === 'latest' || normalized === '') {
+        return null;
+    }
+    return version.trim();
+}
+function extractAvailableVersions(nodes) {
+    const versions = new Set();
+    for (const node of nodes) {
+        if (node.source.resolvedVersion) {
+            versions.add(node.source.resolvedVersion);
+        }
+        if (node.loaded?.version) {
+            versions.add(node.loaded.version);
+        }
+    }
+    return Array.from(versions).filter(v => semver.valid(v));
+}
+function findHighestSatisfyingVersion(ranges, availableVersions, allowPrerelease) {
+    if (availableVersions.length === 0) {
+        return null;
+    }
+    const satisfyingVersions = availableVersions.filter(version => {
+        return ranges.every(range => {
+            try {
+                return semver.satisfies(version, range, { includePrerelease: allowPrerelease });
+            }
+            catch {
+                return false;
+            }
+        });
+    });
+    if (satisfyingVersions.length === 0) {
+        return null;
+    }
+    return semver.maxSatisfying(satisfyingVersions, '*', { includePrerelease: allowPrerelease });
+}
+/**
+ * Check if a specific version satisfies all given constraints.
+ */
+export function versionSatisfiesAll(version, ranges, allowPrerelease = false) {
+    return ranges.every(range => {
+        try {
+            return semver.satisfies(version, range, { includePrerelease: allowPrerelease });
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Find the intersection range of multiple semver ranges (as a displayable string).
+ * Returns null if ranges are incompatible.
+ */
+export function intersectRanges(ranges) {
+    if (ranges.length === 0)
+        return null;
+    if (ranges.length === 1)
+        return ranges[0];
+    const validRanges = ranges.filter(r => {
+        try {
+            return semver.validRange(r) !== null;
+        }
+        catch {
+            return false;
+        }
+    });
+    if (validRanges.length === 0)
+        return null;
+    return validRanges.join(' ');
+}
+/**
+ * Create an interactive conflict handler that uses promptVersionSelection.
+ * Returns a handler function suitable for the onConflict option.
+ *
+ * @param promptVersionSelection - The prompt function to use for version selection
+ * @returns An onConflict handler function
+ */
+export function createInteractiveConflictHandler(promptVersionSelection) {
+    return async (conflict, availableVersions) => {
+        const sortedVersions = [...availableVersions].sort((a, b) => semver.rcompare(a, b));
+        const rangesStr = conflict.ranges.join(', ');
+        const action = `(requested ranges: ${rangesStr})`;
+        return promptVersionSelection(conflict.packageName, sortedVersions, action);
+    };
+}
+//# sourceMappingURL=version-solver.js.map

package/packages/core/dist/core/install/resolution/version-solver.js.map

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

package/packages/core/dist/core/install/resource-discoverer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resource Discovery Module
+ *
+ * Discovers all installable resources within a package/plugin:
+ * - Agents (agents/.../*.md)
+ * - Skills (skills/.../ directories with SKILL.md)
+ * - Commands (commands/.../*.md)
+ * - Rules (rules/.../*.md)
+ * - Hooks (hooks/.../)
+ * - MCP servers (mcp.jsonc, mcp.json)
+ */
+import type { ResourceDiscoveryResult } from './resource-types.js';
+/**
+ * Discover all installable resources within a package
+ *
+ * @param basePath - Base path to search from (detectedBase or contentRoot)
+ * @param repoRoot - Repository root path for relative path calculation
+ * @returns Discovery result with all found resources
+ */
+export declare function discoverResources(basePath: string, repoRoot: string): Promise<ResourceDiscoveryResult>;
+//# sourceMappingURL=resource-discoverer.d.ts.map

package/packages/core/dist/core/install/resource-discoverer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-discoverer.d.ts","sourceRoot":"","sources":["../../../src/core/install/resource-discoverer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC,CA2ClC"}