opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/pattern-matcher.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pattern matching utilities for base detection.
+ *
+ * Extracts patterns from platforms.jsonc and matches resource paths
+ * against them using segment-indexed matching with deepest match resolution.
+ */
+/**
+ * A pattern match result
+ */
+export interface PatternMatch {
+    /** The pattern that matched */
+    pattern: string;
+    /** Segment index where the match begins (0-based) */
+    startIndex: number;
+    /** The matched portion of the path */
+    matchedPath: string;
+    /** The base portion (everything before the match) */
+    basePath: string;
+}
+/**
+ * Extract all "from" patterns from a platforms configuration object.
+ *
+ * @param platformsConfig - The platforms.jsonc configuration object
+ * @returns Array of unique patterns
+ */
+export declare function extractAllFromPatterns(platformsConfig: any): string[];
+/**
+ * Match a resource path against an array of patterns.
+ * Returns all matches with their segment indices.
+ *
+ * @param resourcePath - The path to match (e.g., "plugins/ui/agents/designer.md")
+ * @param patterns - Array of glob patterns to match against
+ * @returns Array of pattern matches
+ */
+export declare function matchPatterns(resourcePath: string, patterns: string[]): PatternMatch[];
+/**
+ * Select the deepest match from an array of pattern matches.
+ *
+ * The deepest match is the one with the highest startIndex
+ * (i.e., the pattern that matches furthest from the root).
+ *
+ * If multiple patterns match at the same depth, returns all of them
+ * as ambiguous matches.
+ *
+ * @param matches - Array of pattern matches
+ * @returns Object with deepest match(es) and whether it's ambiguous
+ */
+export declare function selectDeepestMatch(matches: PatternMatch[]): {
+    match: PatternMatch;
+    isAmbiguous: boolean;
+    ambiguousMatches?: PatternMatch[];
+};
+/**
+ * Match a resource path and return the deepest match.
+ * This is a convenience function that combines matchPatterns and selectDeepestMatch.
+ *
+ * @param resourcePath - The path to match
+ * @param patterns - Array of glob patterns
+ * @returns Deepest match result, or null if no matches
+ */
+export declare function findDeepestMatch(resourcePath: string, patterns: string[]): {
+    match: PatternMatch;
+    isAmbiguous: boolean;
+    ambiguousMatches?: PatternMatch[];
+} | null;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/packages/core/dist/utils/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../src/utils/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IAEnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,GAAG,GAAG,MAAM,EAAE,CAuBrE;AAiDD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAmDtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG;IAC3D,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;CACnC,CA+BA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,GACjB;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;CACnC,GAAG,IAAI,CAQP"}

package/packages/core/dist/utils/pattern-matcher.js

@@ -0,0 +1,195 @@
+/**
+ * Pattern matching utilities for base detection.
+ *
+ * Extracts patterns from platforms.jsonc and matches resource paths
+ * against them using segment-indexed matching with deepest match resolution.
+ */
+import { minimatch } from 'minimatch';
+import { logger } from './logger.js';
+/**
+ * Extract all "from" patterns from a platforms configuration object.
+ *
+ * @param platformsConfig - The platforms.jsonc configuration object
+ * @returns Array of unique patterns
+ */
+export function extractAllFromPatterns(platformsConfig) {
+    const patterns = new Set();
+    // Global flows
+    if (platformsConfig.global?.export) {
+        for (const flow of platformsConfig.global.export) {
+            addFlowPatterns(flow.from, patterns);
+        }
+    }
+    // Platform-specific flows
+    for (const [key, value] of Object.entries(platformsConfig)) {
+        if (key === 'global' || key === '$schema')
+            continue;
+        const platformDef = value;
+        if (platformDef.export) {
+            for (const flow of platformDef.export) {
+                addFlowPatterns(flow.from, patterns);
+            }
+        }
+    }
+    return Array.from(patterns);
+}
+/**
+ * Add patterns from a flow's "from" field.
+ * Handles string, array, and $switch expressions.
+ */
+function addFlowPatterns(from, patterns) {
+    if (typeof from === 'string') {
+        patterns.add(from);
+    }
+    else if (typeof from === 'object' && from !== null && 'pattern' in from && typeof from.pattern === 'string') {
+        // Pattern object (e.g. { pattern: "agents/**/*.md", schema?: "..." })
+        patterns.add(from.pattern);
+    }
+    else if (Array.isArray(from)) {
+        for (const p of from) {
+            if (typeof p === 'string') {
+                patterns.add(p);
+            }
+            else if (typeof p === 'object' && p !== null && 'pattern' in p && typeof p.pattern === 'string') {
+                patterns.add(p.pattern);
+            }
+        }
+    }
+    else if (typeof from === 'object' && from.$switch) {
+        // Handle $switch expressions - extract patterns from cases
+        if (from.$switch.cases) {
+            for (const c of from.$switch.cases) {
+                if (typeof c.value === 'string') {
+                    patterns.add(c.value);
+                }
+                else if (Array.isArray(c.value)) {
+                    for (const v of c.value) {
+                        if (typeof v === 'string') {
+                            patterns.add(v);
+                        }
+                        else if (typeof v === 'object' && v !== null && 'pattern' in v && typeof v.pattern === 'string') {
+                            patterns.add(v.pattern);
+                        }
+                    }
+                }
+                else if (typeof c.value === 'object' && c.value !== null && 'pattern' in c.value && typeof c.value.pattern === 'string') {
+                    patterns.add(c.value.pattern);
+                }
+            }
+        }
+        if (from.$switch.default) {
+            if (typeof from.$switch.default === 'string') {
+                patterns.add(from.$switch.default);
+            }
+            else if (typeof from.$switch.default === 'object' && from.$switch.default !== null && 'pattern' in from.$switch.default && typeof from.$switch.default.pattern === 'string') {
+                patterns.add(from.$switch.default.pattern);
+            }
+        }
+    }
+}
+/**
+ * Match a resource path against an array of patterns.
+ * Returns all matches with their segment indices.
+ *
+ * @param resourcePath - The path to match (e.g., "plugins/ui/agents/designer.md")
+ * @param patterns - Array of glob patterns to match against
+ * @returns Array of pattern matches
+ */
+export function matchPatterns(resourcePath, patterns) {
+    const matches = [];
+    // Normalize path: remove leading/trailing slashes, split into segments
+    const normalizedPath = resourcePath.replace(/^\/+|\/+$/g, '');
+    const segments = normalizedPath.split('/').filter(s => s.length > 0);
+    if (segments.length === 0) {
+        return matches;
+    }
+    // Try matching each pattern
+    for (const pattern of patterns) {
+        // Normalize pattern
+        const normalizedPattern = pattern.replace(/^\/+|\/+$/g, '');
+        const patternSegments = normalizedPattern.split('/').filter(s => s.length > 0);
+        if (patternSegments.length === 0)
+            continue;
+        // Try matching the pattern starting at each segment index
+        for (let startIndex = 0; startIndex < segments.length; startIndex++) {
+            const candidatePath = segments.slice(startIndex).join('/');
+            // Use minimatch to test if the candidate path matches the pattern
+            if (minimatch(candidatePath, normalizedPattern, { dot: true })) {
+                const basePath = startIndex > 0 ? segments.slice(0, startIndex).join('/') : '';
+                matches.push({
+                    pattern: normalizedPattern,
+                    startIndex,
+                    matchedPath: candidatePath,
+                    basePath
+                });
+                // Only record the first (earliest) match for this pattern
+                break;
+            }
+        }
+    }
+    logger.debug('Pattern matching results', {
+        resourcePath: normalizedPath,
+        matchCount: matches.length,
+        matches: matches.map(m => ({
+            pattern: m.pattern,
+            startIndex: m.startIndex,
+            basePath: m.basePath
+        }))
+    });
+    return matches;
+}
+/**
+ * Select the deepest match from an array of pattern matches.
+ *
+ * The deepest match is the one with the highest startIndex
+ * (i.e., the pattern that matches furthest from the root).
+ *
+ * If multiple patterns match at the same depth, returns all of them
+ * as ambiguous matches.
+ *
+ * @param matches - Array of pattern matches
+ * @returns Object with deepest match(es) and whether it's ambiguous
+ */
+export function selectDeepestMatch(matches) {
+    if (matches.length === 0) {
+        throw new Error('Cannot select deepest match from empty array');
+    }
+    if (matches.length === 1) {
+        return {
+            match: matches[0],
+            isAmbiguous: false
+        };
+    }
+    // Find the maximum start index
+    const maxStartIndex = Math.max(...matches.map(m => m.startIndex));
+    // Get all matches at that depth
+    const deepestMatches = matches.filter(m => m.startIndex === maxStartIndex);
+    if (deepestMatches.length === 1) {
+        return {
+            match: deepestMatches[0],
+            isAmbiguous: false
+        };
+    }
+    // Multiple matches at the same depth - ambiguous
+    return {
+        match: deepestMatches[0], // Return first as default
+        isAmbiguous: true,
+        ambiguousMatches: deepestMatches
+    };
+}
+/**
+ * Match a resource path and return the deepest match.
+ * This is a convenience function that combines matchPatterns and selectDeepestMatch.
+ *
+ * @param resourcePath - The path to match
+ * @param patterns - Array of glob patterns
+ * @returns Deepest match result, or null if no matches
+ */
+export function findDeepestMatch(resourcePath, patterns) {
+    const matches = matchPatterns(resourcePath, patterns);
+    if (matches.length === 0) {
+        return null;
+    }
+    return selectDeepestMatch(matches);
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/packages/core/dist/utils/pattern-matcher.js.map

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

package/packages/core/dist/utils/platform-yaml-merge.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated This module has moved to core/platform-yaml-merge.
+ * This re-export exists for backward compatibility.
+ */
+export { mergeInlinePlatformOverride } from '../core/platform-yaml-merge.js';
+//# sourceMappingURL=platform-yaml-merge.d.ts.map

package/packages/core/dist/utils/platform-yaml-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-yaml-merge.d.ts","sourceRoot":"","sources":["../../src/utils/platform-yaml-merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC"}

package/packages/core/dist/utils/platform-yaml-merge.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated This module has moved to core/platform-yaml-merge.
+ * This re-export exists for backward compatibility.
+ */
+export { mergeInlinePlatformOverride } from '../core/platform-yaml-merge.js';
+//# sourceMappingURL=platform-yaml-merge.js.map

package/packages/core/dist/utils/platform-yaml-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-yaml-merge.js","sourceRoot":"","sources":["../../src/utils/platform-yaml-merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC"}

package/packages/core/dist/utils/plugin-naming.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Context for generating scoped package names from GitHub sources.
+ * Used for both Claude plugins and OpenPackage repositories.
+ */
+export interface GitHubPackageNamingContext {
+    gitUrl?: string;
+    path?: string;
+    resourcePath?: string;
+    packageName?: string;
+    repoPath?: string;
+}
+/**
+ * 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 declare function generateGitHubPackageName(context: GitHubPackageNamingContext): string;
+/**
+ * DEPRECATED: Use generateGitHubPackageName instead.
+ * Kept for backward compatibility with plugin-specific code.
+ *
+ * @deprecated
+ */
+export declare function generatePluginName(context: GitHubPackageNamingContext): string;
+/**
+ * DEPRECATED: Use GitHubPackageNamingContext instead.
+ * Kept for backward compatibility.
+ *
+ * @deprecated
+ */
+export type PluginNamingContext = GitHubPackageNamingContext;
+/**
+ * Generate a scoped name for a marketplace.
+ * Uses the unified GitHub package naming system.
+ *
+ * Format:
+ * - GitHub: gh@username/repo
+ * - Non-GitHub: marketplace-name
+ */
+export declare function generateMarketplaceName(gitUrl: string | undefined, marketplaceManifestName?: string, repoPath?: string): string;
+/**
+ * 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 declare function parseScopedPluginName(name: string): {
+    username: string;
+    repo: string;
+    plugin?: string;
+    isGitHub: boolean;
+} | 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 declare function splitPackageNameForTelemetry(packageName: string): {
+    baseName: string;
+    resourcePath?: string;
+};
+/**
+ * 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 declare function deriveNamespaceSlug(packageName: string, existingSlugs?: Set<string>): string;
+/**
+ * Check if a name is a scoped plugin name (either new gh@ format or old @ format).
+ */
+export declare function isScopedPluginName(name: string): boolean;
+/**
+ * Check if a name uses the new GitHub format (gh@username/...).
+ */
+export declare function isGitHubPluginName(name: string): boolean;
+/**
+ * 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 declare function detectOldPluginNaming(dep: {
+    name: string;
+    git?: string;
+    url?: string;
+    path?: string;
+    subdirectory?: string;
+}): string | 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 declare function detectOldGitHubNaming(dep: {
+    name: string;
+    git?: string;
+    url?: string;
+    path?: string;
+    subdirectory?: string;
+}): string | null;
+//# sourceMappingURL=plugin-naming.d.ts.map

package/packages/core/dist/utils/plugin-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-naming.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-naming.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CA4CR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAER;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,uBAAuB,CAAC,EAAE,MAAM,EAChC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,IAAI,CAkDP;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAyCA;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,MAAM,CAqDR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAkD5I;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CA4D5I"}