opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/scope-resolution.js

@@ -0,0 +1,143 @@
+import { join } from 'path';
+import { getOpenPackageDirectories } from './directory.js';
+import { DIR_PATTERNS, OPENPACKAGE_DIRS } from '../constants/index.js';
+import { normalizePackageName, SCOPED_PACKAGE_REGEX } from '../utils/package-name.js';
+/**
+ * Get the package directory for a given scope
+ *
+ * @param cwd - Current working directory
+ * @param scope - Package scope
+ * @param packageName - Package name (required for project/global, ignored for root)
+ * @param customPath - Optional custom path (overrides scope-based resolution)
+ * @returns Absolute path to package directory
+ */
+export function getScopePackageDir(cwd, scope, packageName, customPath) {
+    // Custom path takes precedence over scope
+    if (customPath) {
+        // Note: This is a simple delegation - full validation happens elsewhere
+        // This function just returns the path for consistency with the API
+        return customPath;
+    }
+    if (scope === 'root') {
+        // Root scope: current directory is the package
+        return cwd;
+    }
+    if (!packageName) {
+        throw new Error(`Package name is required for ${scope} scope`);
+    }
+    const normalizedName = normalizePackageName(packageName);
+    if (scope === 'project') {
+        // Project scope: .openpackage/packages/<name>/
+        return getScopedPackagePath(join(cwd, DIR_PATTERNS.OPENPACKAGE, OPENPACKAGE_DIRS.PACKAGES), normalizedName);
+    }
+    if (scope === 'global') {
+        // Global scope: ~/.openpackage/packages/<name>/
+        const dirs = getOpenPackageDirectories();
+        return getScopedPackagePath(join(dirs.data, OPENPACKAGE_DIRS.PACKAGES), normalizedName);
+    }
+    throw new Error(`Invalid scope: ${scope}`);
+}
+/**
+ * Get the openpackage.yml path for a given scope
+ *
+ * @param cwd - Current working directory
+ * @param scope - Package scope
+ * @param packageName - Package name (required for project/global, ignored for root)
+ * @param customPath - Optional custom path (overrides scope-based resolution)
+ * @returns Absolute path to openpackage.yml
+ */
+export function getScopePackageYmlPath(cwd, scope, packageName, customPath) {
+    const packageDir = getScopePackageDir(cwd, scope, packageName, customPath);
+    return join(packageDir, 'openpackage.yml');
+}
+/**
+ * Get a human-readable description of the scope
+ *
+ * @param scope - Package scope
+ * @returns Description string
+ */
+export function getScopeDescription(scope) {
+    switch (scope) {
+        case 'root':
+            return 'Current directory (root package)';
+        case 'project':
+            return 'Project-scoped (.openpackage/packages/)';
+        case 'global':
+            return 'Global shared (~/.openpackage/packages/)';
+        default:
+            return 'Unknown scope';
+    }
+}
+/**
+ * Get the relative display path for a scope
+ * Used in CLI output to show where package will be created
+ *
+ * @param scope - Package scope
+ * @param packageName - Package name (optional)
+ * @param customPath - Optional custom path for display
+ * @returns Display path string
+ */
+export function getScopeDisplayPath(scope, packageName, customPath) {
+    if (customPath) {
+        return customPath;
+    }
+    if (scope === 'root') {
+        return './openpackage.yml';
+    }
+    if (!packageName) {
+        return scope === 'project'
+            ? './.openpackage/packages/<package-name>/'
+            : '~/.openpackage/packages/<package-name>/';
+    }
+    const normalizedName = normalizePackageName(packageName);
+    return scope === 'project'
+        ? `./.openpackage/packages/${normalizedName}/`
+        : `~/.openpackage/packages/${normalizedName}/`;
+}
+/**
+ * Parse and validate workspace scope from CLI (project or global only)
+ * Used by list, uninstall, view - rejects root scope.
+ *
+ * @param scopeValue - Raw scope value from CLI option
+ * @returns Validated WorkspaceScope
+ */
+export function parseWorkspaceScope(scopeValue) {
+    const parsed = parseScope(scopeValue);
+    if (parsed === 'root') {
+        throw new Error('root scope not supported; use project or global');
+    }
+    return parsed;
+}
+/**
+ * Parse and validate scope option from CLI
+ *
+ * @param scopeValue - Raw scope value from CLI option
+ * @returns Validated PackageScope
+ */
+export function parseScope(scopeValue) {
+    const normalized = scopeValue.toLowerCase().trim();
+    if (normalized === 'root' || normalized === 'r') {
+        return 'root';
+    }
+    if (normalized === 'project' || normalized === 'p') {
+        return 'project';
+    }
+    if (normalized === 'global' || normalized === 'g') {
+        return 'global';
+    }
+    throw new Error(`Invalid scope: '${scopeValue}'\n` +
+        `Valid scopes: root, project, global`);
+}
+/**
+ * Helper to get the package path handling scoped packages (@scope/name)
+ * Scoped packages get nested directory structure: @scope/name/
+ */
+function getScopedPackagePath(baseDir, packageName) {
+    const scopedMatch = packageName.match(SCOPED_PACKAGE_REGEX);
+    if (scopedMatch) {
+        const [, scope, localName] = scopedMatch;
+        return join(baseDir, '@' + scope, localName);
+    }
+    return join(baseDir, packageName);
+}
+//# sourceMappingURL=scope-resolution.js.map

package/packages/core/dist/core/scope-resolution.js.map

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

package/packages/core/dist/core/scoping/package-scoping.d.ts

@@ -0,0 +1,35 @@
+export { isScopedName } from '../../utils/package-name.js';
+import type { PromptPort } from '../ports/prompt.js';
+/**
+ * Extract the local (non-scope) part from a package name.
+ */
+export declare function getLocalPart(name: string): string;
+export declare function findScopedVariantsInRegistry(baseName: string): Promise<string[]>;
+/**
+ * Fetch the configured default scope for a given profile (if any).
+ */
+export declare function getDefaultScopeForProfile(profileName?: string): Promise<string | undefined>;
+/**
+ * Suggest a scoped package name using the configured default scope.
+ */
+export declare function suggestScopedNameFromConfig(unscopedName: string, profileName?: string): Promise<string | undefined>;
+/**
+ * Prompt user for a new scoped name and ensure it does not already exist locally.
+ */
+export declare function promptForNewScopedName(baseName: string, profileName?: string, message?: string, prompt?: PromptPort): Promise<string>;
+/**
+ * Determine the scoped name to use when pushing an unscoped package.
+ */
+export declare function resolveScopedNameForPush(unscopedName: string, profileName?: string, prompt?: PromptPort): Promise<string>;
+export declare function resolveScopedNameForPushWithUserScope(unscopedName: string, username: string, profileName?: string, prompt?: PromptPort): Promise<string>;
+export interface SaveNameResolution {
+    effectiveName: string;
+    selectedExistingScopedName?: string;
+    newScopedName?: string;
+    nameChanged: boolean;
+}
+/**
+ * Resolve which name should be used for a save invocation, prompting when needed.
+ */
+export declare function resolveEffectiveNameForSave(inputName: string, profileName?: string, prompt?: PromptPort): Promise<SaveNameResolution>;
+//# sourceMappingURL=package-scoping.d.ts.map

package/packages/core/dist/core/scoping/package-scoping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-scoping.d.ts","sourceRoot":"","sources":["../../../src/core/scoping/package-scoping.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAoBD,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYtF;AA+BD;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQjG;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,qCAAqC,CACzD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAkEjB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAmE7B"}

package/packages/core/dist/core/scoping/package-scoping.js

@@ -0,0 +1,234 @@
+import { SCOPED_PACKAGE_REGEX, normalizePackageName, validatePackageName, isScopedName } from '../../utils/package-name.js';
+export { isScopedName } from '../../utils/package-name.js';
+import { listAllPackages, getPackagePath } from '../directory.js';
+import { exists } from '../../utils/fs.js';
+import { configManager } from '../config.js';
+import { resolvePrompt } from '../ports/resolve.js';
+import { UserCancellationError } from '../../utils/errors.js';
+/**
+ * Extract the local (non-scope) part from a package name.
+ */
+export function getLocalPart(name) {
+    const match = name.match(SCOPED_PACKAGE_REGEX);
+    return match ? match[2] : name;
+}
+/**
+ * Get all scoped package names in the local registry that share the same local name.
+ */
+const PACKAGE_LIST_CACHE_TTL_MS = 5000;
+let cachedPackageList = null;
+let cachedPackageListTimestamp = 0;
+async function getCachedPackageList() {
+    const now = Date.now();
+    if (cachedPackageList && now - cachedPackageListTimestamp < PACKAGE_LIST_CACHE_TTL_MS) {
+        return cachedPackageList;
+    }
+    cachedPackageList = await listAllPackages();
+    cachedPackageListTimestamp = now;
+    return cachedPackageList;
+}
+export async function findScopedVariantsInRegistry(baseName) {
+    const normalizedBase = normalizePackageName(baseName);
+    const packages = await getCachedPackageList();
+    return packages.filter(candidate => {
+        const match = candidate.match(SCOPED_PACKAGE_REGEX);
+        if (!match) {
+            return false;
+        }
+        const localPart = normalizePackageName(match[2]);
+        return localPart === normalizedBase;
+    });
+}
+async function isPackageNameTaken(name) {
+    const normalized = normalizePackageName(name);
+    return await exists(getPackagePath(normalized));
+}
+function buildScopedNameFromScope(unscopedName, scope) {
+    const normalizedScope = normalizePackageName(scope.replace(/^@/, ''));
+    const normalizedName = normalizePackageName(unscopedName);
+    return `@${normalizedScope}/${normalizedName}`;
+}
+async function ensureScopedNameAvailable(name) {
+    try {
+        validatePackageName(name);
+    }
+    catch (error) {
+        throw new Error(error.message.replace('%s', name));
+    }
+    if (!isScopedName(name)) {
+        throw new Error('Name must be scoped (e.g. @scope/name)');
+    }
+    if (await isPackageNameTaken(name)) {
+        throw new Error(`Package '${name}' already exists in local registry. Choose a different scoped name.`);
+    }
+}
+/**
+ * Fetch the configured default scope for a given profile (if any).
+ */
+export async function getDefaultScopeForProfile(profileName) {
+    if (!profileName) {
+        return undefined;
+    }
+    const config = await configManager.getAll();
+    const profileConfig = config.profiles?.[profileName];
+    return profileConfig?.defaults?.scope;
+}
+/**
+ * Suggest a scoped package name using the configured default scope.
+ */
+export async function suggestScopedNameFromConfig(unscopedName, profileName) {
+    const defaultScope = await getDefaultScopeForProfile(profileName);
+    if (!defaultScope) {
+        return undefined;
+    }
+    const normalizedScope = normalizePackageName(defaultScope.replace(/^@/, ''));
+    const normalizedName = normalizePackageName(unscopedName);
+    return `@${normalizedScope}/${normalizedName}`;
+}
+/**
+ * Prompt user for a new scoped name and ensure it does not already exist locally.
+ */
+export async function promptForNewScopedName(baseName, profileName, message, prompt) {
+    const prm = prompt ?? resolvePrompt();
+    const initial = await suggestScopedNameFromConfig(baseName, profileName);
+    const scopedName = await prm.text(message ?? `Enter a scoped name for '${baseName}' (format @scope/${baseName}):`, {
+        initial,
+        validate: async (value) => {
+            if (!value)
+                return 'Name is required';
+            try {
+                await ensureScopedNameAvailable(value);
+                return true;
+            }
+            catch (error) {
+                return error.message;
+            }
+        }
+    });
+    if (!scopedName) {
+        throw new UserCancellationError('Operation cancelled by user');
+    }
+    return normalizePackageName(scopedName);
+}
+/**
+ * Determine the scoped name to use when pushing an unscoped package.
+ */
+export async function resolveScopedNameForPush(unscopedName, profileName, prompt) {
+    if (isScopedName(unscopedName)) {
+        throw new Error(`Expected unscoped name, received '${unscopedName}'`);
+    }
+    return await promptForNewScopedName(unscopedName, profileName, `Remote registry requires a scope. Enter a scoped name for '${unscopedName}' (format @scope/${unscopedName}):`, prompt);
+}
+export async function resolveScopedNameForPushWithUserScope(unscopedName, username, profileName, prompt) {
+    if (isScopedName(unscopedName)) {
+        throw new Error(`Expected unscoped name, received '${unscopedName}'`);
+    }
+    if (!username?.trim()) {
+        throw new Error('Username is required to apply default scope.');
+    }
+    const prm = prompt ?? resolvePrompt();
+    const normalizedName = normalizePackageName(unscopedName);
+    const choice = await prm.select(`Package '${normalizedName}' must be scoped before pushing. Choose a scope:`, [
+        {
+            title: `Use default scope @${username}`,
+            value: 'default',
+            description: `Renames to @${username}/${normalizedName}`
+        },
+        {
+            title: 'Enter scope...',
+            value: 'custom',
+            description: `Enter a custom scope for ${normalizedName}`
+        }
+    ], 'Use arrow keys to select, Enter to confirm');
+    if (!choice) {
+        throw new UserCancellationError('Operation cancelled by user');
+    }
+    let scope = username;
+    if (choice === 'custom') {
+        const profileScope = await getDefaultScopeForProfile(profileName);
+        const initialScope = profileScope?.replace(/^@/, '') || username;
+        const enteredScope = await prm.text(`Enter a scope (without @) for '${normalizedName}':`, {
+            initial: initialScope,
+            validate: async (value) => {
+                if (!value)
+                    return 'Scope is required';
+                const candidate = buildScopedNameFromScope(normalizedName, value);
+                try {
+                    await ensureScopedNameAvailable(candidate);
+                    return true;
+                }
+                catch (error) {
+                    return error.message;
+                }
+            }
+        });
+        if (!enteredScope) {
+            throw new UserCancellationError('Operation cancelled by user');
+        }
+        scope = enteredScope;
+    }
+    const scopedName = buildScopedNameFromScope(normalizedName, scope);
+    await ensureScopedNameAvailable(scopedName);
+    return scopedName;
+}
+/**
+ * Resolve which name should be used for a save invocation, prompting when needed.
+ */
+export async function resolveEffectiveNameForSave(inputName, profileName, prompt) {
+    const prm = prompt ?? resolvePrompt();
+    const normalizedInput = normalizePackageName(inputName);
+    if (isScopedName(normalizedInput)) {
+        return {
+            effectiveName: normalizedInput,
+            nameChanged: false
+        };
+    }
+    const scopedVariants = await findScopedVariantsInRegistry(normalizedInput);
+    if (scopedVariants.length === 0) {
+        return {
+            effectiveName: normalizedInput,
+            nameChanged: false
+        };
+    }
+    const choice = await prm.select(`Found scoped packages matching '${normalizedInput}'. How should this save proceed?`, [
+        ...scopedVariants.map(variant => ({
+            title: `Use existing scoped package ${variant}`,
+            value: variant,
+            description: `Treat this package as '${variant}'`
+        })),
+        {
+            title: 'Create a new scoped name',
+            value: '__create_new_scoped__',
+            description: 'Create a brand new scoped identity (will prompt for name)'
+        },
+        {
+            title: `Keep unscoped name '${normalizedInput}'`,
+            value: '__keep_unscoped__',
+            description: 'Continue saving as unscoped (push will still require scoping later)'
+        }
+    ], 'Use arrow keys to select, Enter to confirm');
+    if (!choice) {
+        throw new UserCancellationError('Operation cancelled by user');
+    }
+    if (choice === '__keep_unscoped__') {
+        return {
+            effectiveName: normalizedInput,
+            nameChanged: false
+        };
+    }
+    if (choice === '__create_new_scoped__') {
+        const newScopedName = await promptForNewScopedName(normalizedInput, profileName, undefined, prm);
+        return {
+            effectiveName: newScopedName,
+            newScopedName,
+            nameChanged: newScopedName !== normalizedInput
+        };
+    }
+    const normalizedChoice = normalizePackageName(choice);
+    return {
+        effectiveName: normalizedChoice,
+        selectedExistingScopedName: normalizedChoice,
+        nameChanged: normalizedChoice !== normalizedInput
+    };
+}
+//# sourceMappingURL=package-scoping.js.map

package/packages/core/dist/core/scoping/package-scoping.js.map

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

package/packages/core/dist/core/search/search-pipeline.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Search Pipeline
+ *
+ * Core logic for searching packages across project, global, and registry sources.
+ * No terminal-UI dependencies — display is handled by the CLI command layer.
+ */
+import type { ExecutionContext } from '../../types/execution-context.js';
+export interface PackageMatch {
+    name: string;
+    source: 'project' | 'global' | 'registry';
+    versions?: string[];
+    description?: string;
+    keywords?: string[];
+}
+export interface SearchResult {
+    matches: PackageMatch[];
+}
+export interface SearchOptions {
+    project?: boolean;
+    global?: boolean;
+    registry?: boolean;
+    all?: boolean;
+    json?: boolean;
+}
+/**
+ * Weighted matching against package metadata.
+ * Returns true if query matches name, keywords, or description (checked in that order).
+ */
+export declare function matchesQuery(query: string, name: string, description?: string, keywords?: string[]): boolean;
+/**
+ * Scan a /packages directory and return PackageMatch entries.
+ */
+export declare function scanPackagesDirectory(packagesDir: string, source: 'project' | 'global', query?: string): Promise<PackageMatch[]>;
+/**
+ * Scan the local registry directory and return PackageMatch entries.
+ */
+export declare function scanRegistryDirectory(query?: string): Promise<PackageMatch[]>;
+export interface RunSearchOptions {
+    query?: string;
+    showProject: boolean;
+    showGlobal: boolean;
+    showRegistry: boolean;
+    /** Factory to create execution contexts (injected by CLI layer) */
+    createContext: (opts: {
+        global: boolean;
+        cwd?: string;
+    }) => Promise<ExecutionContext>;
+    cwd?: string;
+}
+/**
+ * Run the search pipeline across configured sources.
+ * Returns a SearchResult with matches — display is the caller's concern.
+ */
+export declare function runSearchPipeline(options: RunSearchOptions): Promise<SearchResult>;
+//# sourceMappingURL=search-pipeline.d.ts.map

package/packages/core/dist/core/search/search-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/search/search-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAMzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAQ5G;AAqBD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,EAAE,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBnF;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,mEAAmE;IACnE,aAAa,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuBxF"}

package/packages/core/dist/core/search/search-pipeline.js

@@ -0,0 +1,120 @@
+/**
+ * Search Pipeline
+ *
+ * Core logic for searching packages across project, global, and registry sources.
+ * No terminal-UI dependencies — display is handled by the CLI command layer.
+ */
+import { join } from 'path';
+import { listAllPackages, listPackageVersions } from '../directory.js';
+import { getLocalPackagesDir } from '../../utils/paths.js';
+import { exists, listDirectories } from '../../utils/fs.js';
+import { parsePackageYml } from '../../utils/package-yml.js';
+import { FILE_PATTERNS } from '../../constants/index.js';
+// ---------------------------------------------------------------------------
+// Matching
+// ---------------------------------------------------------------------------
+/**
+ * Weighted matching against package metadata.
+ * Returns true if query matches name, keywords, or description (checked in that order).
+ */
+export function matchesQuery(query, name, description, keywords) {
+    const q = query.toLowerCase();
+    if (name.toLowerCase().includes(q))
+        return true;
+    if (keywords?.some(kw => kw.toLowerCase().includes(q)))
+        return true;
+    if (description?.toLowerCase().includes(q))
+        return true;
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Scanning
+// ---------------------------------------------------------------------------
+/**
+ * Try to load metadata from an openpackage.yml in a package directory.
+ */
+async function loadPackageMetadata(packageDir) {
+    const ymlPath = join(packageDir, FILE_PATTERNS.OPENPACKAGE_YML);
+    if (!(await exists(ymlPath)))
+        return null;
+    try {
+        const yml = await parsePackageYml(ymlPath);
+        return { description: yml.description, keywords: yml.keywords };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan a /packages directory and return PackageMatch entries.
+ */
+export async function scanPackagesDirectory(packagesDir, source, query) {
+    if (!(await exists(packagesDir)))
+        return [];
+    const dirs = await listDirectories(packagesDir);
+    const names = dirs
+        .filter(name => !name.startsWith('.'))
+        .sort((a, b) => a.localeCompare(b));
+    const matches = [];
+    for (const name of names) {
+        if (!query) {
+            matches.push({ name, source });
+            continue;
+        }
+        const metadata = await loadPackageMetadata(join(packagesDir, name));
+        if (matchesQuery(query, name, metadata?.description, metadata?.keywords)) {
+            matches.push({
+                name,
+                source,
+                description: metadata?.description,
+                keywords: metadata?.keywords,
+            });
+        }
+    }
+    return matches;
+}
+/**
+ * Scan the local registry directory and return PackageMatch entries.
+ */
+export async function scanRegistryDirectory(query) {
+    const packages = await listAllPackages();
+    const matches = [];
+    for (const packageName of packages) {
+        const versions = await listPackageVersions(packageName);
+        if (versions.length === 0)
+            continue;
+        if (!query || matchesQuery(query, packageName)) {
+            matches.push({
+                name: packageName,
+                source: 'registry',
+                versions,
+            });
+        }
+    }
+    return matches.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Run the search pipeline across configured sources.
+ * Returns a SearchResult with matches — display is the caller's concern.
+ */
+export async function runSearchPipeline(options) {
+    const result = { matches: [] };
+    if (options.showProject) {
+        const ctx = await options.createContext({ global: false, cwd: options.cwd });
+        const projectPackagesDir = getLocalPackagesDir(ctx.targetDir);
+        const projectMatches = await scanPackagesDirectory(projectPackagesDir, 'project', options.query);
+        result.matches.push(...projectMatches);
+    }
+    if (options.showGlobal) {
+        const ctx = await options.createContext({ global: true, cwd: options.cwd });
+        const globalPackagesDir = getLocalPackagesDir(ctx.targetDir);
+        const globalMatches = await scanPackagesDirectory(globalPackagesDir, 'global', options.query);
+        result.matches.push(...globalMatches);
+    }
+    if (options.showRegistry) {
+        const registryMatches = await scanRegistryDirectory(options.query);
+        result.matches.push(...registryMatches);
+    }
+    return result;
+}
+//# sourceMappingURL=search-pipeline.js.map

package/packages/core/dist/core/search/search-pipeline.js.map

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

package/packages/core/dist/core/set/set-output.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Output formatting and display for the set command
+ */
+import type { PackageYml } from '../../types/index.js';
+import type { ConfigChange, SetPipelineResult } from './set-types.js';
+import type { OutputPort } from '../ports/output.js';
+/**
+ * Display changes that will be applied to the manifest
+ */
+export declare function displayConfigChanges(changes: ConfigChange[], output?: OutputPort): void;
+/**
+ * Display success message after updating manifest
+ */
+export declare function displaySetSuccess(result: SetPipelineResult, cwd: string, output?: OutputPort): void;
+/**
+ * Display current package configuration for interactive mode
+ */
+export declare function displayCurrentConfig(config: PackageYml, packagePath: string, output?: OutputPort): void;
+/**
+ * Display no-changes message
+ */
+export declare function displayNoChanges(packageName: string, output?: OutputPort): void;
+//# sourceMappingURL=set-output.d.ts.map

package/packages/core/dist/core/set/set-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-output.d.ts","sourceRoot":"","sources":["../../../src/core/set/set-output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAevF;AA4BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,UAAU,GAClB,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAWvG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAK/E"}