opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/install/validators/options-validator.js

@@ -0,0 +1,28 @@
+/**
+ * Validate that resolution flags are not conflicting.
+ * @throws Error if both --remote and --local are specified
+ */
+export function validateResolutionFlags(options) {
+    if (options.remote && options.local) {
+        throw new Error('--remote and --local cannot be used together. Choose one resolution mode.');
+    }
+}
+/**
+ * Validate conflict strategy value.
+ * @returns Normalized strategy value
+ * @throws Error if invalid strategy
+ */
+export function validateConflictStrategy(strategy) {
+    if (!strategy)
+        return undefined;
+    const normalized = strategy.toLowerCase();
+    const allowedStrategies = [
+        'namespace', 'overwrite', 'skip', 'ask'
+    ];
+    if (!allowedStrategies.includes(normalized)) {
+        throw new Error(`Invalid --conflicts value '${strategy}'. ` +
+            `Use one of: namespace, overwrite, skip, ask.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=options-validator.js.map

package/packages/core/dist/core/install/validators/options-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-validator.js","sourceRoot":"","sources":["../../../../src/core/install/validators/options-validator.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA+D;IAE/D,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA4B;IAE5B,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAyC;QAC9D,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK;KACxC,CAAC;IAEF,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAiB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,KAAK;YAC3C,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IAED,OAAO,UAAgD,CAAC;AAC1D,CAAC"}

package/packages/core/dist/core/install/validators/target-validator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validate that target directory is not inside .openpackage metadata.
+ * @throws Error if target is inside metadata directory
+ */
+export declare function assertTargetDirOutsideMetadata(targetDir: string): void;
+//# sourceMappingURL=target-validator.d.ts.map

package/packages/core/dist/core/install/validators/target-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-validator.d.ts","sourceRoot":"","sources":["../../../../src/core/install/validators/target-validator.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAgBtE"}

package/packages/core/dist/core/install/validators/target-validator.js

@@ -0,0 +1,19 @@
+import { normalizePathForProcessing } from '../../../utils/path-normalization.js';
+import { DIR_PATTERNS, PACKAGE_PATHS } from '../../../constants/index.js';
+/**
+ * Validate that target directory is not inside .openpackage metadata.
+ * @throws Error if target is inside metadata directory
+ */
+export function assertTargetDirOutsideMetadata(targetDir) {
+    const normalized = normalizePathForProcessing(targetDir ?? '.');
+    if (!normalized || normalized === '.') {
+        return; // default install root
+    }
+    if (normalized === DIR_PATTERNS.OPENPACKAGE ||
+        normalized.startsWith(`${DIR_PATTERNS.OPENPACKAGE}/`)) {
+        throw new Error(`Installation target '${targetDir}' cannot point inside ${DIR_PATTERNS.OPENPACKAGE} ` +
+            `(reserved for metadata like ${PACKAGE_PATHS.INDEX_RELATIVE}). ` +
+            `Choose a workspace path outside metadata.`);
+    }
+}
+//# sourceMappingURL=target-validator.js.map

package/packages/core/dist/core/install/validators/target-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-validator.js","sourceRoot":"","sources":["../../../../src/core/install/validators/target-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,SAAiB;IAC9D,MAAM,UAAU,GAAG,0BAA0B,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,CAAC,uBAAuB;IACjC,CAAC;IAED,IACE,UAAU,KAAK,YAAY,CAAC,WAAW;QACvC,UAAU,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC,WAAW,GAAG,CAAC,EACrD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,wBAAwB,SAAS,yBAAyB,YAAY,CAAC,WAAW,GAAG;YACrF,+BAA+B,aAAa,CAAC,cAAc,KAAK;YAChE,2CAA2C,CAC5C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/packages/core/dist/core/install/version-selection.d.ts

@@ -0,0 +1,51 @@
+import { type RemotePullFailure } from '../remote-pull.js';
+import { InstallResolutionMode } from './types.js';
+import { type VersionSelectionOptions, type VersionSelectionResult } from '../../utils/version-ranges.js';
+export interface VersionSourceSummary {
+    localVersions: string[];
+    remoteVersions: string[];
+    availableVersions: string[];
+    remoteStatus: 'skipped' | 'success' | 'failed';
+    warnings: string[];
+    remoteError?: string;
+    fallbackToLocalOnly?: boolean;
+    remoteFailure?: RemotePullFailure;
+}
+export interface GatherVersionSourcesArgs {
+    packageName: string;
+    mode: InstallResolutionMode;
+    localVersions?: string[];
+    remoteVersions?: string[];
+    profile?: string;
+    apiKey?: string;
+}
+export interface InstallVersionSelectionArgs extends GatherVersionSourcesArgs {
+    constraint: string;
+    explicitPrereleaseIntent?: boolean;
+    selectionOptions?: VersionSelectionOptions;
+}
+export interface InstallVersionSelectionResult {
+    selectedVersion: string | null;
+    selection: VersionSelectionResult;
+    sources: VersionSourceSummary;
+    constraint: string;
+    mode: InstallResolutionMode;
+}
+export interface UnifiedInstallVersionSelectionArgs {
+    packageName: string;
+    constraint: string;
+    mode: InstallResolutionMode;
+    selectionOptions?: VersionSelectionOptions;
+    explicitPrereleaseIntent?: boolean;
+    profile?: string;
+    apiKey?: string;
+    localVersions?: string[];
+    remoteVersions?: string[];
+    filterAvailableVersions?: (versions: string[]) => string[];
+}
+export interface UnifiedInstallVersionSelectionResult extends InstallVersionSelectionResult {
+    resolutionSource?: 'local' | 'remote';
+}
+export declare function gatherVersionSourcesForInstall(args: GatherVersionSourcesArgs): Promise<VersionSourceSummary>;
+export declare function selectInstallVersionUnified(args: UnifiedInstallVersionSelectionArgs): Promise<UnifiedInstallVersionSelectionResult>;
+//# sourceMappingURL=version-selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-selection.d.ts","sourceRoot":"","sources":["../../../src/core/install/version-selection.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAQvC,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA4B,SAAQ,wBAAwB;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,MAAM,WAAW,kCAAkC;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,uBAAuB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,oCAAqC,SAAQ,6BAA6B;IACzF,gBAAgB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACvC;AAoBD,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4ElH;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,kCAAkC,GACvC,OAAO,CAAC,oCAAoC,CAAC,CA4G/C"}

package/packages/core/dist/core/install/version-selection.js

@@ -0,0 +1,272 @@
+import * as semver from 'semver';
+import { listPackageVersions } from '../directory.js';
+import { fetchRemotePackageMetadata } from '../remote-pull.js';
+import { describeRemoteFailure } from './remote-reporting.js';
+import { selectVersionWithWipPolicy } from '../../utils/version-ranges.js';
+import { isScopedName } from '../scoping/package-scoping.js';
+import { resolveOutput } from '../ports/resolve.js';
+import { extractRemoteErrorReason } from '../../utils/error-reasons.js';
+import { UNVERSIONED } from '../../constants/index.js';
+import { createCacheManager } from '../cache-manager.js';
+export async function gatherVersionSourcesForInstall(args) {
+    const normalizedLocal = normalizeAndSortVersions(args.localVersions ?? await listPackageVersions(args.packageName));
+    let remoteVersions = [];
+    let remoteStatus = 'skipped';
+    let remoteError;
+    let remoteFailure;
+    const warnings = [];
+    if (args.mode !== 'local-only') {
+        if (args.remoteVersions) {
+            remoteVersions = normalizeAndSortVersions(args.remoteVersions);
+            remoteStatus = 'success';
+        }
+        else {
+            const remoteLookup = await fetchRemoteVersions(args.packageName, {
+                profile: args.profile,
+                apiKey: args.apiKey,
+                skipCache: args.mode === 'remote-primary'
+            });
+            if (remoteLookup.success) {
+                remoteVersions = normalizeAndSortVersions(remoteLookup.versions);
+                remoteStatus = 'success';
+            }
+            else {
+                remoteStatus = 'failed';
+                remoteError = describeRemoteFailure(args.packageName, remoteLookup.failure);
+                remoteFailure = remoteLookup.failure;
+            }
+        }
+    }
+    if (args.mode === 'local-only') {
+        return {
+            localVersions: normalizedLocal,
+            remoteVersions: [],
+            availableVersions: normalizedLocal,
+            remoteStatus: 'skipped',
+            warnings
+        };
+    }
+    if (args.mode === 'remote-primary') {
+        if (remoteStatus !== 'success') {
+            throw new Error(remoteError ?? `Remote registry data required to resolve ${args.packageName}`);
+        }
+        return {
+            localVersions: normalizedLocal,
+            remoteVersions,
+            availableVersions: remoteVersions,
+            remoteStatus,
+            warnings,
+            remoteFailure
+        };
+    }
+    const fallbackToLocalOnly = remoteStatus !== 'success';
+    if (fallbackToLocalOnly && remoteError && isScopedName(args.packageName)) {
+        const reason = extractRemoteErrorReason(remoteError);
+        warnings.push(`Remote pull failed for \`${args.packageName}\` (reason: ${reason})`);
+    }
+    return {
+        localVersions: normalizedLocal,
+        remoteVersions,
+        availableVersions: fallbackToLocalOnly ? normalizedLocal : mergeAndSortVersions(normalizedLocal, remoteVersions),
+        remoteStatus,
+        warnings,
+        remoteError,
+        fallbackToLocalOnly,
+        remoteFailure
+    };
+}
+export async function selectInstallVersionUnified(args) {
+    const mergedSelectionOptions = {
+        ...(args.selectionOptions ?? {}),
+        ...(args.explicitPrereleaseIntent ? { explicitPrereleaseIntent: true } : {})
+    };
+    const applyFilter = (versions) => args.filterAvailableVersions ? args.filterAvailableVersions(versions) : versions;
+    const attemptWithSources = (sources, modeContext) => {
+        const filteredVersions = applyFilter(sources.availableVersions);
+        const selection = selectVersionWithWipPolicy(filteredVersions, args.constraint, mergedSelectionOptions);
+        const selectedVersion = selection.version;
+        let resolutionSource;
+        if (selectedVersion) {
+            const inLocal = sources.localVersions.includes(selectedVersion);
+            const inRemote = sources.remoteVersions.includes(selectedVersion);
+            if (inLocal && !inRemote) {
+                resolutionSource = 'local';
+            }
+            else if (!inLocal && inRemote) {
+                resolutionSource = 'remote';
+            }
+            else if (inLocal && inRemote) {
+                resolutionSource = modeContext === 'remote-primary' ? 'remote' : 'local';
+            }
+        }
+        return {
+            selectedVersion,
+            selection,
+            sources,
+            resolutionSource
+        };
+    };
+    const gatherBase = {
+        packageName: args.packageName,
+        localVersions: args.localVersions,
+        remoteVersions: args.remoteVersions,
+        profile: args.profile,
+        apiKey: args.apiKey
+    };
+    if (args.mode === 'local-only') {
+        const sources = await gatherVersionSourcesForInstall({
+            ...gatherBase,
+            mode: 'local-only'
+        });
+        const result = attemptWithSources(sources, 'local-only');
+        return {
+            ...result,
+            constraint: args.constraint,
+            mode: args.mode
+        };
+    }
+    if (args.mode === 'remote-primary') {
+        const sources = await gatherVersionSourcesForInstall({
+            ...gatherBase,
+            mode: 'remote-primary'
+        });
+        const result = attemptWithSources(sources, 'remote-primary');
+        return {
+            ...result,
+            constraint: args.constraint,
+            mode: args.mode
+        };
+    }
+    // Default mode: local-first with remote fallback.
+    const localSources = await gatherVersionSourcesForInstall({
+        ...gatherBase,
+        mode: 'local-only'
+    });
+    const localAttempt = attemptWithSources(localSources, 'local-only');
+    if (localAttempt.selectedVersion) {
+        return {
+            ...localAttempt,
+            constraint: args.constraint,
+            mode: args.mode
+        };
+    }
+    const fallbackSources = await gatherVersionSourcesForInstall({
+        ...gatherBase,
+        mode: 'default'
+    });
+    if (fallbackSources.remoteStatus === 'failed') {
+        const reason = fallbackSources.remoteError ??
+            `Remote metadata lookup failed while resolving ${args.packageName}`;
+        throw new Error(reason);
+    }
+    const fallbackAttempt = attemptWithSources(fallbackSources, args.mode);
+    return {
+        ...fallbackAttempt,
+        constraint: args.constraint,
+        mode: args.mode
+    };
+}
+async function fetchRemoteVersions(packageName, options, output) {
+    const out = output ?? resolveOutput();
+    const cacheManager = createCacheManager();
+    // Check cached metadata first (skip if --remote flag is set)
+    if (!options.skipCache) {
+        const cachedMeta = await cacheManager.getCachedMetadata(packageName);
+        if (cachedMeta && cachedMeta.versions.length > 0) {
+            return { success: true, versions: cachedMeta.versions };
+        }
+    }
+    const spinner = out.spinner();
+    spinner.start(`Checking remote versions for ${packageName}...`);
+    try {
+        const metadataResult = await fetchRemotePackageMetadata(packageName, undefined, {
+            profile: options.profile,
+            apiKey: options.apiKey,
+            recursive: false
+        });
+        if (!metadataResult.success) {
+            return { success: false, failure: metadataResult };
+        }
+        const versions = extractVersionsFromRemoteResponse(metadataResult.response);
+        // Cache the fetched versions
+        if (versions.length > 0) {
+            await cacheManager.cacheMetadata(packageName, versions);
+        }
+        return { success: true, versions };
+    }
+    finally {
+        spinner.stop();
+    }
+}
+function extractVersionsFromRemoteResponse(response) {
+    const collected = new Set();
+    const candidates = [];
+    const packageAny = response.package;
+    if (Array.isArray(packageAny?.versions)) {
+        candidates.push(...packageAny.versions);
+    }
+    const responseAny = response;
+    if (Array.isArray(responseAny?.versions)) {
+        candidates.push(...responseAny.versions);
+    }
+    if (Array.isArray(responseAny?.availableVersions)) {
+        candidates.push(...responseAny.availableVersions);
+    }
+    for (const candidate of candidates) {
+        const normalized = extractVersionString(candidate);
+        if (normalized) {
+            collected.add(normalized);
+        }
+    }
+    if (response.version) {
+        const normalizedVersion = response.version.version ?? UNVERSIONED;
+        collected.add(normalizedVersion);
+    }
+    return Array.from(collected);
+}
+function extractVersionString(candidate) {
+    if (typeof candidate === 'string') {
+        return semver.valid(candidate) ? candidate : null;
+    }
+    if (candidate && typeof candidate === 'object') {
+        const value = candidate.version;
+        if (value === undefined || value === null) {
+            return UNVERSIONED;
+        }
+        if (typeof value === 'string') {
+            if (semver.valid(value)) {
+                return value;
+            }
+        }
+    }
+    return null;
+}
+function normalizeAndSortVersions(versions) {
+    const normalized = new Set();
+    for (const version of versions) {
+        if (typeof version !== 'string') {
+            continue;
+        }
+        const trimmed = version.trim();
+        if (!trimmed) {
+            continue;
+        }
+        if (!semver.valid(trimmed)) {
+            continue;
+        }
+        normalized.add(trimmed);
+    }
+    const sorted = Array.from(normalized).sort(semver.rcompare);
+    return sorted;
+}
+function mergeAndSortVersions(left, right) {
+    const merged = new Set();
+    for (const version of [...left, ...right]) {
+        if (semver.valid(version)) {
+            merged.add(version);
+        }
+    }
+    const sorted = Array.from(merged).sort(semver.rcompare);
+    return sorted;
+}
+//# sourceMappingURL=version-selection.js.map

package/packages/core/dist/core/install/version-selection.js.map

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

package/packages/core/dist/core/interaction-policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Interaction Policy
+ *
+ * Single source of truth for whether the CLI can prompt the user.
+ * Created once at command entry and threaded through all handlers.
+ *
+ * Prompt Tiers:
+ *   0 - Required:           Platform selection, marketplace plugin pick
+ *   1 - Disambiguation:     Ambiguous base directory selection
+ *   2 - Confirmation:       Overwrite confirmations
+ *   3 - ConflictResolution: Version conflict selection
+ *   4 - OptionalMenu:       --interactive resource selection menus
+ */
+export declare enum PromptTier {
+    Required = 0,
+    Disambiguation = 1,
+    Confirmation = 2,
+    ConflictResolution = 3,
+    OptionalMenu = 4
+}
+export type InteractionMode = 'never' | 'auto' | 'always';
+export interface InteractionPolicy {
+    readonly mode: InteractionMode;
+    readonly isTTY: boolean;
+    canPrompt(tier: PromptTier): boolean;
+}
+/**
+ * Create an interaction policy from command options.
+ *
+ * Mode resolution:
+ *   --interactive + TTY  → 'always' (all tiers allowed)
+ *   --interactive + !TTY → throws (user explicitly asked for interactive)
+ *   CI=true or !TTY      → 'never'  (no prompts, errors or safe defaults)
+ *   default TTY           → 'auto'   (ambient prompts for tiers 0-3, never tier 4)
+ */
+export declare function createInteractionPolicy(options: {
+    interactive?: boolean;
+    force?: boolean;
+}): InteractionPolicy;
+//# sourceMappingURL=interaction-policy.d.ts.map

package/packages/core/dist/core/interaction-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-policy.d.ts","sourceRoot":"","sources":["../../src/core/interaction-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oBAAY,UAAU;IACpB,QAAQ,IAAI;IACZ,cAAc,IAAI;IAClB,YAAY,IAAI;IAChB,kBAAkB,IAAI;IACtB,YAAY,IAAI;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,iBAAiB,CA4BpB"}

package/packages/core/dist/core/interaction-policy.js

@@ -0,0 +1,60 @@
+/**
+ * Interaction Policy
+ *
+ * Single source of truth for whether the CLI can prompt the user.
+ * Created once at command entry and threaded through all handlers.
+ *
+ * Prompt Tiers:
+ *   0 - Required:           Platform selection, marketplace plugin pick
+ *   1 - Disambiguation:     Ambiguous base directory selection
+ *   2 - Confirmation:       Overwrite confirmations
+ *   3 - ConflictResolution: Version conflict selection
+ *   4 - OptionalMenu:       --interactive resource selection menus
+ */
+export var PromptTier;
+(function (PromptTier) {
+    PromptTier[PromptTier["Required"] = 0] = "Required";
+    PromptTier[PromptTier["Disambiguation"] = 1] = "Disambiguation";
+    PromptTier[PromptTier["Confirmation"] = 2] = "Confirmation";
+    PromptTier[PromptTier["ConflictResolution"] = 3] = "ConflictResolution";
+    PromptTier[PromptTier["OptionalMenu"] = 4] = "OptionalMenu";
+})(PromptTier || (PromptTier = {}));
+/**
+ * Create an interaction policy from command options.
+ *
+ * Mode resolution:
+ *   --interactive + TTY  → 'always' (all tiers allowed)
+ *   --interactive + !TTY → throws (user explicitly asked for interactive)
+ *   CI=true or !TTY      → 'never'  (no prompts, errors or safe defaults)
+ *   default TTY           → 'auto'   (ambient prompts for tiers 0-3, never tier 4)
+ */
+export function createInteractionPolicy(options) {
+    const isTTY = process.stdin.isTTY === true;
+    let mode;
+    if (options.interactive) {
+        if (!isTTY) {
+            throw new Error('--interactive requires an interactive terminal (TTY). ' +
+                'Use specific filters (--agents, --skills, etc.) for non-interactive installs.');
+        }
+        mode = 'always';
+    }
+    else if (!isTTY || process.env.CI === 'true') {
+        mode = 'never';
+    }
+    else {
+        mode = 'auto';
+    }
+    return {
+        mode,
+        isTTY,
+        canPrompt(tier) {
+            if (mode === 'never')
+                return false;
+            if (mode === 'always')
+                return true;
+            // 'auto': allow ambient prompts (tiers 0-3), never tier 4 (optional menus)
+            return tier < PromptTier.OptionalMenu;
+        }
+    };
+}
+//# sourceMappingURL=interaction-policy.js.map

package/packages/core/dist/core/interaction-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-policy.js","sourceRoot":"","sources":["../../src/core/interaction-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,mDAAY,CAAA;IACZ,+DAAkB,CAAA;IAClB,2DAAgB,CAAA;IAChB,uEAAsB,CAAA;IACtB,2DAAgB,CAAA;AAClB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAUD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAGvC;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;IAE3C,IAAI,IAAqB,CAAC;IAC1B,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,wDAAwD;gBACxD,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,QAAQ,CAAC;IAClB,CAAC;SAAM,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAC/C,IAAI,GAAG,OAAO,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK;QACL,SAAS,CAAC,IAAgB;YACxB,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YACnC,IAAI,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACnC,2EAA2E;YAC3E,OAAO,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,80 @@
+import type { CommandResult, ExecutionContext } from '../../types/index.js';
+import { type UntrackedScanResult } from './untracked-files-scanner.js';
+export { classifySourceKey } from '../resources/source-key-classifier.js';
+export type PackageSyncState = 'synced' | 'partial' | 'missing';
+export interface ListFileMapping {
+    source: string;
+    target: string;
+    exists: boolean;
+}
+/**
+ * A single resource within a package (e.g., one rule, one agent, one skill)
+ */
+export interface ListResourceInfo {
+    /** Display name (filename sans .md for files, directory name for skills) */
+    name: string;
+    /** Resource type: agent, skill, command, rule, hook, mcp, or 'other' for unrecognized */
+    resourceType: string;
+    /** Files belonging to this resource */
+    files: ListFileMapping[];
+}
+/**
+ * Resources grouped by type within a package
+ */
+export interface ListResourceGroup {
+    /** Resource type label (e.g., 'rules', 'agents', 'skills') */
+    resourceType: string;
+    /** Individual resources of this type */
+    resources: ListResourceInfo[];
+}
+export interface ListPackageReport {
+    name: string;
+    version?: string;
+    path: string;
+    state: PackageSyncState;
+    totalFiles: number;
+    existingFiles: number;
+    fileList?: ListFileMapping[];
+    resourceGroups?: ListResourceGroup[];
+    dependencies?: string[];
+}
+export interface ListTreeNode {
+    report: ListPackageReport;
+    children: ListTreeNode[];
+}
+export interface ListPipelineOptions {
+    /** Include full file list for each package */
+    includeFiles?: boolean;
+    /** Build full recursive dependency tree */
+    all?: boolean;
+    /** Filter to tracked view only */
+    tracked?: boolean;
+    /** Filter to untracked view only */
+    untracked?: boolean;
+    /** Filter by platform names */
+    platforms?: string[];
+}
+export interface ListPipelineResult {
+    packages: ListPackageReport[];
+    tree?: ListTreeNode[];
+    rootPackageNames?: string[];
+    /** When a specific package is targeted, this contains its info for the header */
+    targetPackage?: ListPackageReport;
+    /** Total tracked files that exist on disk */
+    trackedCount: number;
+    /** Total tracked files that are missing on disk */
+    missingCount: number;
+    /** Total untracked files found */
+    untrackedCount: number;
+    /** Untracked files scan result */
+    untrackedFiles?: UntrackedScanResult;
+}
+/**
+ * Group file mappings into resource groups by analyzing source keys.
+ *
+ * For skills, all files sharing the same skills/<name>/ prefix are grouped into one resource.
+ * For other types, each source key maps to one resource.
+ */
+export declare function groupFilesIntoResources(fileList: ListFileMapping[]): ListResourceGroup[];
+export declare function runListPipeline(packageName: string | undefined, execContext: ExecutionContext, options?: ListPipelineOptions): Promise<CommandResult<ListPipelineResult>>;
+//# sourceMappingURL=list-pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/list/list-pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAW5E,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAO5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,iFAAiF;IACjF,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AA2HD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,iBAAiB,EAAE,CA6DxF;AAkMD,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAyN5C"}