opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/install/list-handler.js

@@ -0,0 +1,112 @@
+/**
+ * List Handler Module
+ *
+ * Handles --interactive option integration with install orchestrator
+ */
+import { resolve } from 'path';
+import { logger } from '../../utils/logger.js';
+import { resolveOutput, resolvePrompt } from '../ports/resolve.js';
+import { PromptTier } from '../../core/interaction-policy.js';
+import { discoverResources } from './resource-discoverer.js';
+import { promptResourceSelection } from './resource-selection-menu.js';
+import { buildResourceInstallContexts } from './unified/context-builders.js';
+import { runMultiContextPipeline } from './unified/multi-context-pipeline.js';
+import { getLoaderForSource } from './sources/loader-factory.js';
+import { applyBaseDetection } from './preprocessing/base-resolver.js';
+/**
+ * Handle interactive resource selection (--interactive option)
+ *
+ * @param context - Installation context
+ * @param options - Normalized install options
+ * @param execContext - Execution context
+ * @returns Command result
+ */
+export async function handleListSelection(context, options, execContext) {
+    logger.info('Handling interactive resource selection', {
+        packageName: context.source.packageName
+    });
+    const out = resolveOutput(execContext);
+    // Load source to get content root and base detection
+    const loader = getLoaderForSource(context.source);
+    const loaded = await loader.load(context.source, options, execContext);
+    // Update context with loaded data
+    context.source.packageName = loaded.packageName;
+    context.source.version = loaded.version;
+    context.source.contentRoot = loaded.contentRoot;
+    context.source.pluginMetadata = loaded.pluginMetadata;
+    // Apply base detection
+    if (loaded.sourceMetadata?.baseDetection) {
+        applyBaseDetection(context, loaded);
+    }
+    // Determine base path and repo root
+    const basePath = context.detectedBase || loaded.contentRoot || execContext.targetDir;
+    const repoRoot = loaded.sourceMetadata?.repoPath || loaded.contentRoot || basePath;
+    logger.debug('Resource discovery paths', {
+        basePath,
+        repoRoot,
+        detectedBase: context.detectedBase
+    });
+    // Discover all resources with spinner
+    const s = out.spinner();
+    s.start('Discovering resources');
+    const discovery = await discoverResources(basePath, repoRoot);
+    if (discovery.total === 0) {
+        s.stop('No resources found');
+    }
+    else {
+        s.stop(`Found ${discovery.total} resource${discovery.total === 1 ? '' : 's'}`);
+    }
+    // Check if any resources found
+    if (discovery.total === 0) {
+        out.warn('No installable resources found in this package');
+        return {
+            success: true,
+            data: { installed: 0, skipped: 0 }
+        };
+    }
+    // Interactive or non-interactive selection
+    let selected;
+    const policy = execContext.interactionPolicy;
+    if (!policy?.canPrompt(PromptTier.OptionalMenu)) {
+        throw new Error('Interactive resource selection requires a TTY. Use --agents, --skills, --rules, or --commands to specify resources directly.');
+    }
+    selected = await promptResourceSelection(discovery, context.source.packageName, context.source.version, resolveOutput(execContext), resolvePrompt(execContext));
+    if (selected.length === 0) {
+        return {
+            success: true,
+            data: { installed: 0, skipped: 0 }
+        };
+    }
+    // Convert selected resources to ResourceInstallationSpec format
+    const resourceSpecs = selected.map(s => ({
+        name: s.displayName,
+        resourceType: s.resourceType,
+        resourcePath: s.resourcePath,
+        basePath: resolve(basePath),
+        resourceKind: s.installKind,
+        matchedBy: 'filename',
+        resourceVersion: s.version
+    }));
+    // Build resource contexts for installation
+    const resourceContexts = buildResourceInstallContexts(context, resourceSpecs, repoRoot).map(rc => {
+        // Ensure path-based loader can resolve repo-relative resourcePath
+        if (rc.source.type === 'path') {
+            rc.source.localPath = repoRoot;
+        }
+        return rc;
+    });
+    // Run multi-context pipeline with grouped report for multi-resource selection
+    const result = await runMultiContextPipeline(resourceContexts, {
+        groupReport: true,
+        groupReportPackageName: context.source.packageName
+    });
+    return {
+        success: result.success,
+        error: result.error,
+        data: {
+            installed: result.data?.installed || 0,
+            skipped: result.data?.skipped || 0
+        }
+    };
+}
+//# sourceMappingURL=list-handler.js.map

package/packages/core/dist/core/install/list-handler.js.map

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

package/packages/core/dist/core/install/local-source-resolution.d.ts

@@ -0,0 +1,30 @@
+import type { InstallResolutionMode } from './types.js';
+type MutableSourceKind = 'workspaceMutable' | 'globalMutable';
+export interface MutableSourceInfo {
+    kind: MutableSourceKind;
+    packageRootDir: string;
+    version: string;
+}
+export interface CandidateVersionsResult {
+    localVersions: string[];
+    sourceKind?: MutableSourceKind | 'registry';
+    contentRoot?: string;
+}
+export declare function detectWorkspaceMutableSource(cwd: string, packageName: string): Promise<MutableSourceInfo | null>;
+export declare function detectGlobalMutableSource(packageName: string): Promise<MutableSourceInfo | null>;
+export declare function resolveCandidateVersionsForInstall(args: {
+    cwd: string;
+    packageName: string;
+    mode: InstallResolutionMode;
+}): Promise<CandidateVersionsResult>;
+export declare function resolvePackageContentRoot(args: {
+    cwd: string;
+    packageName: string;
+    version: string;
+}): Promise<string>;
+export declare function maybeWarnHigherRegistryVersion(args: {
+    packageName: string;
+    selectedVersion: string;
+}): Promise<string | undefined>;
+export {};
+//# sourceMappingURL=local-source-resolution.d.ts.map

package/packages/core/dist/core/install/local-source-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-source-resolution.d.ts","sourceRoot":"","sources":["../../../src/core/install/local-source-resolution.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,iBAAiB,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA6BD,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQnC;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQnC;AAED,wBAAsB,kCAAkC,CAAC,IAAI,EAAE;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,qBAAqB,CAAC;CAC7B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA8BnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB9B"}

package/packages/core/dist/core/install/local-source-resolution.js

@@ -0,0 +1,103 @@
+import os from 'os';
+import path from 'path';
+import { DIR_PATTERNS, OPENPACKAGE_DIRS, UNVERSIONED } from '../../constants/index.js';
+import { listPackageVersions, getPackageVersionPath } from '../directory.js';
+import { exists } from '../../utils/fs.js';
+import { parsePackageYml } from '../../utils/package-yml.js';
+import { getLocalPackageDir } from '../../utils/paths.js';
+import { SCOPED_PACKAGE_REGEX, normalizePackageName } from '../../utils/package-name.js';
+import semver from 'semver';
+function getGlobalMutablePackageDir(packageName) {
+    const normalizedName = normalizePackageName(packageName);
+    const scopedMatch = normalizedName.match(SCOPED_PACKAGE_REGEX);
+    const baseDir = path.join(os.homedir(), DIR_PATTERNS.OPENPACKAGE, OPENPACKAGE_DIRS.PACKAGES);
+    if (scopedMatch) {
+        const [, scope, localName] = scopedMatch;
+        return path.join(baseDir, `@${scope}`, localName);
+    }
+    return path.join(baseDir, normalizedName);
+}
+async function loadMutableSourceVersion(packageRootDir) {
+    const manifestPath = path.join(packageRootDir, 'openpackage.yml');
+    if (!(await exists(manifestPath))) {
+        return null;
+    }
+    try {
+        const manifest = await parsePackageYml(manifestPath);
+        return manifest.version ?? UNVERSIONED;
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectWorkspaceMutableSource(cwd, packageName) {
+    const packageRootDir = getLocalPackageDir(cwd, packageName);
+    const version = await loadMutableSourceVersion(packageRootDir);
+    if (!version) {
+        return null;
+    }
+    return { kind: 'workspaceMutable', packageRootDir, version };
+}
+export async function detectGlobalMutableSource(packageName) {
+    const packageRootDir = getGlobalMutablePackageDir(packageName);
+    const version = await loadMutableSourceVersion(packageRootDir);
+    if (!version) {
+        return null;
+    }
+    return { kind: 'globalMutable', packageRootDir, version };
+}
+export async function resolveCandidateVersionsForInstall(args) {
+    const { cwd, packageName, mode } = args;
+    if (mode === 'remote-primary') {
+        return { localVersions: [] };
+    }
+    const workspaceSource = await detectWorkspaceMutableSource(cwd, packageName);
+    if (workspaceSource) {
+        return {
+            localVersions: [workspaceSource.version],
+            sourceKind: workspaceSource.kind,
+            contentRoot: workspaceSource.packageRootDir
+        };
+    }
+    const globalMutable = await detectGlobalMutableSource(packageName);
+    if (globalMutable) {
+        return {
+            localVersions: [globalMutable.version],
+            sourceKind: globalMutable.kind,
+            contentRoot: globalMutable.packageRootDir
+        };
+    }
+    const registryVersions = await listPackageVersions(packageName);
+    return {
+        localVersions: registryVersions,
+        sourceKind: 'registry'
+    };
+}
+export async function resolvePackageContentRoot(args) {
+    const { cwd, packageName, version } = args;
+    const workspaceSource = await detectWorkspaceMutableSource(cwd, packageName);
+    if (workspaceSource) {
+        return path.join(workspaceSource.packageRootDir, path.sep);
+    }
+    const globalMutable = await detectGlobalMutableSource(packageName);
+    if (globalMutable) {
+        return path.join(globalMutable.packageRootDir, path.sep);
+    }
+    const versionPath = getPackageVersionPath(packageName, version);
+    return path.join(versionPath, path.sep);
+}
+export async function maybeWarnHigherRegistryVersion(args) {
+    if (!semver.valid(args.selectedVersion)) {
+        return undefined;
+    }
+    const registryVersions = await listPackageVersions(args.packageName);
+    if (registryVersions.length === 0) {
+        return undefined;
+    }
+    const highest = registryVersions[0];
+    if (semver.valid(highest) && semver.gt(highest, args.selectedVersion)) {
+        return `Newer version available in local registry: ${args.packageName}@${args.selectedVersion} (selected) < ${args.packageName}@${highest} (registry)`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=local-source-resolution.js.map

package/packages/core/dist/core/install/local-source-resolution.js.map

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

package/packages/core/dist/core/install/marketplace-handler.d.ts

@@ -0,0 +1,129 @@
+import type { InstallationContext } from './unified/context.js';
+import type { CommandResult, InstallOptions, ExecutionContext } from '../../types/index.js';
+import { type PluginSourceSpec } from './plugin-sources.js';
+/**
+ * Claude Code marketplace manifest schema.
+ * See: https://code.claude.com/docs/en/plugin-marketplaces
+ */
+export interface MarketplaceManifest {
+    name: string;
+    description?: string;
+    homepage?: string;
+    plugins: MarketplacePluginEntry[];
+}
+/**
+ * Marketplace plugin entry.
+ * Each entry defines a plugin and where to find it.
+ * When strict is false, all plugin metadata can be defined here instead of in plugin.json.
+ */
+export interface MarketplacePluginEntry {
+    name: string;
+    source: PluginSourceSpec;
+    description?: string;
+    version?: string;
+    author?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string | {
+        type?: string;
+        url?: string;
+    };
+    license?: string;
+    keywords?: string[];
+    category?: string;
+    tags?: string[];
+    commands?: string | string[];
+    agents?: string | string[];
+    hooks?: string | object;
+    mcpServers?: string | object;
+    lspServers?: string | object;
+    strict?: boolean;
+}
+/**
+ * Parse and validate a marketplace manifest.
+ *
+ * @param manifestPath - Path to marketplace.json file
+ * @param context - Context for fallback naming
+ * @returns Parsed marketplace manifest
+ */
+export declare function parseMarketplace(manifestPath: string, context?: {
+    gitUrl?: string;
+    repoPath?: string;
+}): Promise<MarketplaceManifest>;
+/**
+ * Display interactive plugin selection prompt using single selection.
+ *
+ * @param marketplace - Parsed marketplace manifest
+ * @returns Selected plugin name (empty string if user cancelled)
+ */
+export declare function promptPluginSelection(marketplace: MarketplaceManifest, execContext?: ExecutionContext): Promise<string>;
+/**
+ * Install mode type
+ */
+export type InstallMode = 'full' | 'partial';
+/**
+ * Prompt user to choose between full plugin install or partial (individual resources).
+ *
+ * @param pluginName - Name of the plugin being installed
+ * @returns Install mode ('full' or 'partial'), or empty string if cancelled
+ */
+export declare function promptInstallMode(pluginName: string, execContext?: ExecutionContext): Promise<InstallMode | ''>;
+/**
+ * Install selected plugins from a marketplace.
+ *
+ * @param marketplaceDir - Absolute path to cloned marketplace repository root
+ * @param marketplace - Parsed marketplace manifest
+ * @param selectedName - Name of plugin to install
+ * @param installMode - Install mode ('full' or 'partial')
+ * @param marketplaceGitUrl - Git URL of the marketplace repository
+ * @param marketplaceGitRef - Git ref (branch/tag/sha) if specified
+ * @param marketplaceCommitSha - Commit SHA of cached marketplace
+ * @param options - Install options
+ * @param cwd - Current working directory for installation
+ */
+export declare function installMarketplacePlugins(marketplaceDir: string, marketplace: MarketplaceManifest, selectedName: string, installMode: InstallMode, marketplaceGitUrl: string, marketplaceGitRef: string | undefined, marketplaceCommitSha: string, options: InstallOptions, execContext: ExecutionContext, convenienceOptions?: {
+    agents?: string[];
+    skills?: string[];
+    rules?: string[];
+    commands?: string[];
+}): Promise<CommandResult>;
+/**
+ * Validate that requested plugin names exist in marketplace.
+ *
+ * @param marketplace - Parsed marketplace manifest
+ * @param requestedPlugins - Array of plugin names to validate
+ * @returns Object with valid and invalid plugin name arrays
+ */
+export declare function validatePluginNames(marketplace: MarketplaceManifest, requestedPlugins: string[]): {
+    valid: string[];
+    invalid: string[];
+};
+/**
+ * Resolved plugin info for resource discovery (used by --interactive).
+ */
+export interface ResolvedPluginInfo {
+    pluginEntry: MarketplacePluginEntry;
+    context: InstallationContext;
+    basePath: string;
+    repoRoot: string;
+}
+/**
+ * Resolve plugin content roots for resource discovery.
+ * Loads each plugin's source and returns resolved paths and contexts
+ * without installing anything.
+ *
+ * @param marketplaceDir - Absolute path to cloned marketplace repository root
+ * @param marketplace - Parsed marketplace manifest
+ * @param pluginNames - Plugin names to resolve
+ * @param marketplaceGitUrl - Git URL of the marketplace repository
+ * @param marketplaceGitRef - Git ref (branch/tag/sha) if specified
+ * @param marketplaceCommitSha - Commit SHA of cached marketplace
+ * @param options - Install options
+ * @param execContext - Execution context
+ * @returns Array of resolved plugin info objects
+ */
+export declare function resolvePluginContentRoots(marketplaceDir: string, marketplace: MarketplaceManifest, pluginNames: string[], marketplaceGitUrl: string, marketplaceGitRef: string | undefined, marketplaceCommitSha: string, options: InstallOptions, execContext: ExecutionContext): Promise<ResolvedPluginInfo[]>;
+//# sourceMappingURL=marketplace-handler.d.ts.map

package/packages/core/dist/core/install/marketplace-handler.d.ts.map

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