opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/plugin-naming.js

@@ -0,0 +1,401 @@
+import { basename } from 'path';
+import { extractGitHubInfo } from './git-url-parser.js';
+import { DIR_TO_TYPE } from '../constants/index.js';
+import { logger } from './logger.js';
+/**
+ * Generate a scoped name for any GitHub-sourced package.
+ *
+ * Works for:
+ * - Claude Code plugins
+ * - OpenPackage repositories
+ * - Marketplace plugins
+ *
+ * Format:
+ * - GitHub repo with path: gh@username/repo/path
+ * - GitHub repo (package is the repo): gh@username/repo
+ * - Non-GitHub or local: use packageName as-is (no scoping)
+ *
+ * Fallback behavior:
+ * - If packageName is undefined → use path basename or repo name
+ */
+export function generateGitHubPackageName(context) {
+    const { gitUrl, path, resourcePath, packageName, repoPath } = context;
+    const pathToUse = resourcePath ?? path;
+    const normalizePath = (value) => value.replace(/\\/g, '/').replace(/^\.\/?/, '').toLowerCase();
+    // If no Git URL, use package name or fallback
+    if (!gitUrl) {
+        if (packageName && pathToUse) {
+            return `${packageName}/${normalizePath(pathToUse)}`;
+        }
+        return packageName || (pathToUse ? basename(pathToUse) : 'unnamed-package');
+    }
+    // Try to extract GitHub info
+    const githubInfo = extractGitHubInfo(gitUrl);
+    // If not GitHub, use package name as-is
+    if (!githubInfo) {
+        logger.debug('Non-GitHub URL, using package name as-is', { gitUrl });
+        if (packageName && pathToUse) {
+            return `${packageName}/${normalizePath(pathToUse)}`;
+        }
+        return packageName || (pathToUse ? basename(pathToUse) : 'unnamed-package');
+    }
+    // GitHub URL - generate scoped name
+    const { username, repo } = githubInfo;
+    // If there's a subdirectory path, include it for uniqueness
+    if (pathToUse) {
+        // Use the full path for maximum clarity and unambiguity
+        // Example: plugins/feature-dev -> gh@username/repo/plugins/feature-dev
+        const normalizedPath = normalizePath(pathToUse);
+        return `gh@${username}/${repo}/${normalizedPath}`;
+    }
+    else {
+        // Root of repo: gh@username/repo
+        return `gh@${username}/${repo}`;
+    }
+}
+/**
+ * DEPRECATED: Use generateGitHubPackageName instead.
+ * Kept for backward compatibility with plugin-specific code.
+ *
+ * @deprecated
+ */
+export function generatePluginName(context) {
+    return generateGitHubPackageName(context);
+}
+/**
+ * Generate a scoped name for a marketplace.
+ * Uses the unified GitHub package naming system.
+ *
+ * Format:
+ * - GitHub: gh@username/repo
+ * - Non-GitHub: marketplace-name
+ */
+export function generateMarketplaceName(gitUrl, marketplaceManifestName, repoPath) {
+    // Reuse the unified naming function for consistency
+    return generateGitHubPackageName({
+        gitUrl,
+        packageName: marketplaceManifestName,
+        repoPath
+    });
+}
+/**
+ * Parse a scoped plugin name into its components.
+ * Supports GitHub (gh@username/repo or gh@username/repo/path) and
+ * old (@username/...) formats.
+ * Returns null if the name is not scoped.
+ */
+export function parseScopedPluginName(name) {
+    // GitHub format: gh@username/repo or gh@username/repo/...
+    const ghMatch = name.match(/^gh@([^\/]+)\/([^\/]+)(?:\/(.+))?$/);
+    if (ghMatch) {
+        const [, username, repo, rest] = ghMatch;
+        // If has path after repo
+        if (rest) {
+            return {
+                username,
+                repo,
+                plugin: rest,
+                isGitHub: true
+            };
+        }
+        // Standalone repo: gh@username/repo
+        return {
+            username,
+            repo,
+            plugin: undefined,
+            isGitHub: true
+        };
+    }
+    // Old format with plugin: @username/repo/plugin
+    const oldPluginMatch = name.match(/^@([^\/]+)\/([^\/]+)\/(.+)$/);
+    if (oldPluginMatch) {
+        const [, username, repo, plugin] = oldPluginMatch;
+        return {
+            username,
+            repo,
+            plugin,
+            isGitHub: false
+        };
+    }
+    // Old format standalone: @username/repo
+    const oldRepoMatch = name.match(/^@([^\/]+)\/([^\/]+)$/);
+    if (oldRepoMatch) {
+        const [, username, repo] = oldRepoMatch;
+        return {
+            username,
+            repo,
+            plugin: undefined,
+            isGitHub: false
+        };
+    }
+    return null;
+}
+/**
+ * Split a package name into base package name and resource path for telemetry.
+ * Handles GitHub-scoped names that may include resource paths.
+ *
+ * Examples:
+ * - "gh@user/repo/agents/designer" → { baseName: "gh@user/repo", resourcePath: "agents/designer" }
+ * - "gh@user/repo" → { baseName: "gh@user/repo", resourcePath: undefined }
+ * - "@scope/package/path" → { baseName: "@scope/package", resourcePath: "path" }
+ * - "simple-package" → { baseName: "simple-package", resourcePath: undefined }
+ *
+ * @param packageName - Full package name (may include resource path)
+ * @returns Object with base package name and optional resource path
+ */
+export function splitPackageNameForTelemetry(packageName) {
+    // Handle GitHub format: gh@username/repo[/path]
+    const ghMatch = packageName.match(/^gh@([^\/]+)\/([^\/]+)(?:\/(.+))?$/);
+    if (ghMatch) {
+        const [, username, repo, path] = ghMatch;
+        return {
+            baseName: `gh@${username}/${repo}`,
+            resourcePath: path
+        };
+    }
+    // Handle scoped format: @scope/name[/path]
+    const scopedMatch = packageName.match(/^@([^\/]+)\/([^\/]+)(?:\/(.+))?$/);
+    if (scopedMatch) {
+        const [, scope, name, path] = scopedMatch;
+        return {
+            baseName: `@${scope}/${name}`,
+            resourcePath: path
+        };
+    }
+    // Handle unscoped format with path: name/path
+    // Need to be careful not to split "owner/repo" GitHub shorthand
+    // If it doesn't match gh@ or @ format, treat first segment as package name
+    const segments = packageName.split('/');
+    if (segments.length > 1) {
+        // Ambiguous case: could be "name/path" or just "owner/repo"
+        // For telemetry safety, only split if we have 2+ slashes (clear path indicator)
+        if (segments.length > 2) {
+            return {
+                baseName: segments[0],
+                resourcePath: segments.slice(1).join('/')
+            };
+        }
+    }
+    // No path detected, return as-is
+    return {
+        baseName: packageName,
+        resourcePath: undefined
+    };
+}
+/**
+ * Strip a file extension from a path segment (e.g. "code-reviewer.md" → "code-reviewer").
+ */
+function stripExtension(segment) {
+    const dotIdx = segment.lastIndexOf('.');
+    return dotIdx > 0 ? segment.slice(0, dotIdx) : segment;
+}
+/**
+ * Derive a short, human-readable namespace slug from a full package name.
+ *
+ * Uses "smart leaf detection": walks the sub-path segments and identifies
+ * the meaningful name segment that sits before the first resource-type
+ * directory marker (rules, agents, commands, skills, hooks — as defined
+ * by DIR_TO_TYPE in the resource registry).
+ *
+ * The slug uses `/` as separators so it produces real nested directories.
+ *
+ * ### Escalation for uniqueness
+ *
+ * If `existingSlugs` is provided, the function progressively escalates
+ * to avoid collisions:
+ *   1. `leaf`               (e.g. "feature-dev")
+ *   2. `repo/leaf`          (e.g. "claude-plugins/feature-dev")
+ *   3. `owner/repo/leaf`    (e.g. "anthropics/claude-plugins/feature-dev")
+ *
+ * For repo-level packages (no sub-path):
+ *   1. `repo`               (e.g. "essentials")
+ *   2. `owner/repo`         (e.g. "anthropics/essentials")
+ *
+ * For plain registry names (not scoped): returned as-is with no escalation.
+ *
+ * ### Examples
+ *
+ *  | Package Name                                                  | Slug (no collision) |
+ *  |---------------------------------------------------------------|---------------------|
+ *  | gh@owner/repo/plugins/foo/commands/bar/baz/hello.md           | foo                 |
+ *  | gh@anthropics/claude-plugins/plugins/feature-dev/agents/x.md  | feature-dev         |
+ *  | gh@anthropics/essentials                                      | essentials          |
+ *  | gh@owner/repo/agents/designer.md                              | repo                |
+ *  | gh@owner/repo/tools/linter                                    | repo                |
+ *  | my-plain-package                                              | my-plain-package    |
+ *  | @scope/package-name                                           | package-name        |
+ *
+ * @param packageName    Full canonical package name
+ * @param existingSlugs  Set of slugs already in use by other installed packages.
+ *                       When provided, the function escalates to avoid collisions.
+ */
+export function deriveNamespaceSlug(packageName, existingSlugs) {
+    const parsed = parseScopedPluginName(packageName);
+    // ── Plain registry name (not scoped) ──────────────────────────────────
+    if (!parsed) {
+        return packageName;
+    }
+    const { username, repo, plugin } = parsed;
+    const resourceDirNames = new Set(Object.keys(DIR_TO_TYPE));
+    // ── Determine the leaf ────────────────────────────────────────────────
+    let leaf;
+    if (!plugin) {
+        // Repo-level package: gh@owner/repo — leaf is repo
+        leaf = repo;
+    }
+    else {
+        const segments = plugin.split('/');
+        const markerIndex = segments.findIndex(seg => resourceDirNames.has(seg));
+        if (markerIndex > 0) {
+            // Segment immediately before the first resource marker
+            leaf = stripExtension(segments[markerIndex - 1]);
+        }
+        else {
+            // Marker at index 0 (e.g. "agents/designer.md") or no marker found
+            // Both cases fall back to repo
+            leaf = repo;
+        }
+    }
+    // ── Build escalation candidates ───────────────────────────────────────
+    const candidates = !plugin
+        ? [repo, `${username}/${repo}`]
+        : leaf === repo
+            ? // Leaf is already the repo — start at repo, escalate to owner/repo
+                [repo, `${username}/${repo}`]
+            : [leaf, `${repo}/${leaf}`, `${username}/${repo}/${leaf}`];
+    // ── Pick the shortest non-colliding slug ──────────────────────────────
+    if (!existingSlugs || existingSlugs.size === 0) {
+        return candidates[0];
+    }
+    for (const candidate of candidates) {
+        if (!existingSlugs.has(candidate)) {
+            return candidate;
+        }
+    }
+    // All candidates collide (extremely unlikely) — fall back to full name
+    // with problematic characters stripped
+    return packageName.replace(/^gh@/, '').replace(/@/g, '');
+}
+/**
+ * Check if a name is a scoped plugin name (either new gh@ format or old @ format).
+ */
+export function isScopedPluginName(name) {
+    return parseScopedPluginName(name) !== null;
+}
+/**
+ * Check if a name uses the new GitHub format (gh@username/...).
+ */
+export function isGitHubPluginName(name) {
+    return name.startsWith('gh@');
+}
+/**
+ * Detect if a plugin dependency uses old naming format.
+ * Returns the correct new name if migration needed, null otherwise.
+ *
+ * Old format: @username/marketplace-name/plugin (marketplace name from marketplace.json)
+ * New format: @username/repo/plugin (always use repo name)
+ */
+export function detectOldPluginNaming(dep) {
+    // Only check GitHub git/url sources with scoped names
+    const gitUrlRaw = dep.url || dep.git;
+    if (!gitUrlRaw || !dep.name.startsWith('@')) {
+        return null;
+    }
+    // Parse url to get base url (strip ref if present)
+    const gitUrl = gitUrlRaw.includes('#') ? gitUrlRaw.split('#', 2)[0] : gitUrlRaw;
+    const githubInfo = extractGitHubInfo(gitUrl);
+    if (!githubInfo) {
+        return null;
+    }
+    const { username, repo } = githubInfo;
+    // Parse the current name
+    const nameMatch = dep.name.match(/^@([^\/]+)\/(?:([^\/]+)\/)?([^\/]+)$/);
+    if (!nameMatch) {
+        return null;
+    }
+    const [, nameUsername, middlePart, pluginPart] = nameMatch;
+    // Check if username matches
+    if (nameUsername !== username) {
+        return null;
+    }
+    // If there's a path, this should be a 3-part name
+    if (dep.path) {
+        // Expected format: @username/repo/plugin
+        const expectedName = `@${username}/${repo}/${pluginPart}`;
+        // If middle part doesn't match repo name, it's old format
+        if (middlePart !== repo) {
+            return expectedName;
+        }
+    }
+    else {
+        // No subdirectory - should be 2-part name: @username/repo
+        const expectedName = `@${username}/${repo}`;
+        // If current name has 3 parts or doesn't match repo, it's old format
+        if (middlePart || nameUsername + '/' + (middlePart || pluginPart) !== username + '/' + repo) {
+            return expectedName;
+        }
+    }
+    return null;
+}
+/**
+ * Detect if a plugin dependency uses old GitHub naming format without gh@ prefix.
+ * Returns the correct new name if migration needed, null otherwise.
+ *
+ * Old format: @username/repo or @username/repo/path
+ * New format: gh@username/repo or gh@username/repo/path
+ *
+ * Also handles path mismatches where package name doesn't match the path/subdirectory field.
+ */
+export function detectOldGitHubNaming(dep) {
+    // Skip if not a git/url source
+    const gitUrlRaw = dep.url || dep.git;
+    if (!gitUrlRaw) {
+        return null;
+    }
+    // Parse url to get base url (strip ref if present)
+    const gitUrl = gitUrlRaw.includes('#') ? gitUrlRaw.split('#', 2)[0] : gitUrlRaw;
+    const githubInfo = extractGitHubInfo(gitUrl);
+    if (!githubInfo) {
+        return null;
+    }
+    const { username, repo } = githubInfo;
+    // Get the actual path (prefer path over subdirectory, normalize subdirectory)
+    const actualPath = dep.path || (dep.subdirectory?.startsWith('./')
+        ? dep.subdirectory.substring(2)
+        : dep.subdirectory);
+    // Check if name is missing gh@ prefix
+    if (!dep.name.startsWith('gh@')) {
+        // Handle old format with @ prefix
+        if (dep.name.startsWith('@')) {
+            // @username/repo/path or @username/repo
+            if (actualPath) {
+                return `gh@${username}/${repo}/${actualPath}`;
+            }
+            return `gh@${username}/${repo}`;
+        }
+        // Handle format without @ prefix: username/repo/path or username/repo
+        // This happens when the @ was stripped somewhere
+        if (actualPath) {
+            return `gh@${username}/${repo}/${actualPath}`;
+        }
+        return `gh@${username}/${repo}`;
+    }
+    // Check if package name path matches the actual path field
+    // This handles cases where name has basename instead of full path
+    if (actualPath && dep.name.startsWith('gh@')) {
+        // Extract the path portion from the package name
+        const nameMatch = dep.name.match(/^gh@([^\/]+)\/([^\/]+)(?:\/(.+))?$/);
+        if (nameMatch) {
+            const [, nameUsername, nameRepo, namePath] = nameMatch;
+            // Verify username and repo match
+            if (nameUsername === username && nameRepo === repo) {
+                // If actualPath exists but namePath is different, update to use full path
+                if (namePath !== actualPath) {
+                    return `gh@${username}/${repo}/${actualPath}`;
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=plugin-naming.js.map

package/packages/core/dist/utils/plugin-naming.js.map

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

package/packages/core/dist/utils/resolution-mode.d.ts

@@ -0,0 +1,10 @@
+import type { InstallOptions } from '../types/index.js';
+import type { InstallResolutionMode } from '../types/install.js';
+/**
+ * Determine the resolution mode based on CLI flags
+ */
+export declare function determineResolutionMode(options: InstallOptions & {
+    local?: boolean;
+    remote?: boolean;
+}): InstallResolutionMode;
+//# sourceMappingURL=resolution-mode.d.ts.map

package/packages/core/dist/utils/resolution-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-mode.d.ts","sourceRoot":"","sources":["../../src/utils/resolution-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,qBAAqB,CAcvB"}

package/packages/core/dist/utils/resolution-mode.js

@@ -0,0 +1,16 @@
+/**
+ * Determine the resolution mode based on CLI flags
+ */
+export function determineResolutionMode(options) {
+    if (options.resolutionMode) {
+        return options.resolutionMode;
+    }
+    if (options.remote) {
+        return 'remote-primary';
+    }
+    if (options.local) {
+        return 'local-only';
+    }
+    return 'default';
+}
+//# sourceMappingURL=resolution-mode.js.map

package/packages/core/dist/utils/resolution-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-mode.js","sourceRoot":"","sources":["../../src/utils/resolution-mode.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA+D;IAE/D,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,cAAc,CAAC;IAChC,CAAC;IAED,IAAK,OAAe,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAK,OAAe,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/packages/core/dist/utils/resource-arg-parser.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Unified resource argument parsing for the install command.
+ *
+ * Parses resource specifications in priority order:
+ * 1. URL (GitHub URLs)
+ * 2. Resource Name (with or without `@` symbol)
+ * 3. Filepath (absolute or relative)
+ *
+ * Supports version specifications only at repo/package level, not on sub-paths.
+ */
+/**
+ * Resource specification interface
+ */
+export interface ResourceSpec {
+    /** How the resource was specified */
+    type: 'github-url' | 'github-shorthand' | 'registry' | 'filepath';
+    /** Repository identifier (for git sources) */
+    repo?: string;
+    /** Git URL (for git sources) */
+    gitUrl?: string;
+    /** Git ref/version (branch, tag, commit) */
+    ref?: string;
+    /** Path within repo/package to the resource */
+    path?: string;
+    /** Package name (for registry sources) */
+    name?: string;
+    /** Version constraint (for registry sources) */
+    version?: string;
+    /** Absolute path (for filepath sources) */
+    absolutePath?: string;
+    /** Whether path points to a directory */
+    isDirectory?: boolean;
+}
+/**
+ * Parse a resource argument string into a ResourceSpec.
+ *
+ * Resolution order:
+ * 1. GitHub URL → Extract repo + path
+ * 2. GitHub Shorthand (gh@) → Parse segments
+ * 3. Filepath → Resolve and validate
+ * 4. Registry Name → Parse name + version
+ *
+ * @param input - Raw user input
+ * @param cwd - Current working directory for resolving relative paths
+ * @returns Parsed ResourceSpec
+ */
+export declare function parseResourceArg(input: string, cwd?: string): Promise<ResourceSpec>;
+//# sourceMappingURL=resource-arg-parser.d.ts.map

package/packages/core/dist/utils/resource-arg-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-arg-parser.d.ts","sourceRoot":"","sources":["../../src/utils/resource-arg-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,IAAI,EAAE,YAAY,GAAG,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;IAElE,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqCvB"}