opkg 0.9.0 → 0.9.2

package/packages/core/dist/generated/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/packages/core/dist/generated/version.js

@@ -0,0 +1,3 @@
+// Auto-generated by build script. Do not edit manually.
+export const VERSION = '0.9.0';
+//# sourceMappingURL=version.js.map

package/packages/core/dist/generated/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/packages/core/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @opkg/core - OpenPackage Core Library
+ *
+ * Provides all business logic for OpenPackage operations.
+ * This package has ZERO terminal/UI dependencies and can be consumed by:
+ *   - opkg CLI (terminal UI via @clack/prompts)
+ *   - opkg GUI (Tauri desktop app)
+ *   - opkg SDK (programmatic usage)
+ *   - CI/CD integrations
+ *
+ * All user-facing output and prompts are abstracted through
+ * OutputPort and PromptPort interfaces.
+ */
+export type { OutputPort, UnifiedSpinner } from './core/ports/output.js';
+export type { PromptPort, PromptChoice, PromptGroupChoices, TextPromptOptions } from './core/ports/prompt.js';
+export type { ProgressPort, ProgressEvent, ProgressLogLevel, ProgressEventBase, InstallProgressEvent, PublishProgressEvent, UninstallProgressEvent, SearchProgressEvent, LifecycleProgressEvent, } from './core/ports/progress.js';
+export { consoleOutput } from './core/ports/console-output.js';
+export { nonInteractivePrompt, NonInteractivePromptError } from './core/ports/console-prompt.js';
+export { consoleProgress, silentProgress } from './core/ports/console-progress.js';
+export { resolveOutput, resolvePrompt, resolveProgress } from './core/ports/resolve.js';
+export { createExecutionContext, getContextVariables, getDisplayTargetDir } from './core/execution-context.js';
+export { createInteractionPolicy, PromptTier, type InteractionMode, type InteractionPolicy, } from './core/interaction-policy.js';
+export { createOrchestrator } from './core/install/orchestrator/index.js';
+export { runUnifiedInstallPipeline } from './core/install/unified/pipeline.js';
+export { runMultiContextPipeline } from './core/install/unified/multi-context-pipeline.js';
+export { runUninstallPipeline, runSelectiveUninstallPipeline } from './core/uninstall/uninstall-pipeline.js';
+export { executeUninstallCandidate } from './core/uninstall/uninstall-executor.js';
+export { collectWorkspaceResources, buildGroupedUninstallOptions, executeBatchUninstall, type WorkspaceCollectionResult, type GroupedUninstallOptions, type UninstallChoiceValue, type BatchUninstallSummary, } from './core/uninstall/workspace-resource-collector.js';
+export { runDirectUninstallFlow, type DirectUninstallOptions, type DirectUninstallResult, type CandidateFormatters, } from './core/uninstall/direct-uninstall-flow.js';
+export { runPublishPipeline } from './core/publish/publish-pipeline.js';
+export { runLocalPublishPipeline } from './core/publish/local-publish-pipeline.js';
+export { runUnpublishPipeline } from './core/unpublish/unpublish-pipeline.js';
+export { runLocalUnpublishPipeline } from './core/unpublish/local-unpublish-pipeline.js';
+export { runInteractiveUnpublishFlow, type InteractiveUnpublishResult, } from './core/unpublish/interactive-unpublish-flow.js';
+export { runSaveToSourcePipeline } from './core/save/save-to-source-pipeline.js';
+export { runSetPipeline } from './core/set/set-pipeline.js';
+export { runAddToSourcePipeline, runAddToSourcePipelineBatch } from './core/add/add-to-source-pipeline.js';
+export { processAddResource, type AddResourceResult, type ProcessAddResourceOptions, } from './core/add/add-orchestrator.js';
+export { runRemoveFromSourcePipeline, runRemoveFromSourcePipelineBatch } from './core/remove/remove-from-source-pipeline.js';
+export { runListPipeline } from './core/list/list-pipeline.js';
+export { resolvePackageView, resolveLocalPackage, resolveRemoteForPackage, type LocalPackageResult, type ResolvedViewResult, type LocalPackageViewResult, type RemoteViewResult, type NotFoundViewResult, type ViewPipelineOptions, } from './core/view/view-pipeline.js';
+export { printLocalPackageView, printRemotePackageView, } from './core/view/view-printers.js';
+export { runSearchPipeline, type SearchOptions, type PackageMatch, type SearchResult, } from './core/search/search-pipeline.js';
+export { createPackage } from './core/package-creation.js';
+export type { ExecutionContext, ExecutionOptions, ContextVariables, } from './types/execution-context.js';
+export type { CommandResult, PackageYml, Package, PackageFile, InstallOptions, UninstallOptions, SaveOptions, OpenPackageConfig, ProfileConfig, Profile, } from './types/index.js';
+export type { Platform, PlatformDefinition, } from './types/platform.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/index.d.ts.map

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

package/packages/core/dist/index.js

@@ -0,0 +1,72 @@
+/**
+ * @opkg/core - OpenPackage Core Library
+ *
+ * Provides all business logic for OpenPackage operations.
+ * This package has ZERO terminal/UI dependencies and can be consumed by:
+ *   - opkg CLI (terminal UI via @clack/prompts)
+ *   - opkg GUI (Tauri desktop app)
+ *   - opkg SDK (programmatic usage)
+ *   - CI/CD integrations
+ *
+ * All user-facing output and prompts are abstracted through
+ * OutputPort and PromptPort interfaces.
+ */
+export { consoleOutput } from './core/ports/console-output.js';
+export { nonInteractivePrompt, NonInteractivePromptError } from './core/ports/console-prompt.js';
+export { consoleProgress, silentProgress } from './core/ports/console-progress.js';
+export { resolveOutput, resolvePrompt, resolveProgress } from './core/ports/resolve.js';
+// ============================================================================
+// Execution Context & Interaction Policy
+// ============================================================================
+export { createExecutionContext, getContextVariables, getDisplayTargetDir } from './core/execution-context.js';
+export { createInteractionPolicy, PromptTier, } from './core/interaction-policy.js';
+// ============================================================================
+// Install Pipelines
+// ============================================================================
+export { createOrchestrator } from './core/install/orchestrator/index.js';
+export { runUnifiedInstallPipeline } from './core/install/unified/pipeline.js';
+export { runMultiContextPipeline } from './core/install/unified/multi-context-pipeline.js';
+// ============================================================================
+// Uninstall Pipeline
+// ============================================================================
+export { runUninstallPipeline, runSelectiveUninstallPipeline } from './core/uninstall/uninstall-pipeline.js';
+export { executeUninstallCandidate } from './core/uninstall/uninstall-executor.js';
+export { collectWorkspaceResources, buildGroupedUninstallOptions, executeBatchUninstall, } from './core/uninstall/workspace-resource-collector.js';
+export { runDirectUninstallFlow, } from './core/uninstall/direct-uninstall-flow.js';
+// ============================================================================
+// Publish / Unpublish Pipelines
+// ============================================================================
+export { runPublishPipeline } from './core/publish/publish-pipeline.js';
+export { runLocalPublishPipeline } from './core/publish/local-publish-pipeline.js';
+export { runUnpublishPipeline } from './core/unpublish/unpublish-pipeline.js';
+export { runLocalUnpublishPipeline } from './core/unpublish/local-unpublish-pipeline.js';
+export { runInteractiveUnpublishFlow, } from './core/unpublish/interactive-unpublish-flow.js';
+// ============================================================================
+// Save / Set Pipelines
+// ============================================================================
+export { runSaveToSourcePipeline } from './core/save/save-to-source-pipeline.js';
+export { runSetPipeline } from './core/set/set-pipeline.js';
+// ============================================================================
+// Add / Remove Pipelines
+// ============================================================================
+export { runAddToSourcePipeline, runAddToSourcePipelineBatch } from './core/add/add-to-source-pipeline.js';
+export { processAddResource, } from './core/add/add-orchestrator.js';
+export { runRemoveFromSourcePipeline, runRemoveFromSourcePipelineBatch } from './core/remove/remove-from-source-pipeline.js';
+// ============================================================================
+// List Pipeline
+// ============================================================================
+export { runListPipeline } from './core/list/list-pipeline.js';
+// ============================================================================
+// View Pipeline
+// ============================================================================
+export { resolvePackageView, resolveLocalPackage, resolveRemoteForPackage, } from './core/view/view-pipeline.js';
+export { printLocalPackageView, printRemotePackageView, } from './core/view/view-printers.js';
+// ============================================================================
+// Search Pipeline
+// ============================================================================
+export { runSearchPipeline, } from './core/search/search-pipeline.js';
+// ============================================================================
+// Package Creation & Context
+// ============================================================================
+export { createPackage } from './core/package-creation.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmBH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAExF,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EACL,uBAAuB,EACvB,UAAU,GAGX,MAAM,8BAA8B,CAAC;AAEtC,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAE3F,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAC7G,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GAKtB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,sBAAsB,GAIvB,MAAM,2CAA2C,CAAC;AAEnD,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EACL,2BAA2B,GAE5B,MAAM,gDAAgD,CAAC;AAExD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAC3G,OAAO,EACL,kBAAkB,GAGnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAE7H,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GAOxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EACL,iBAAiB,GAIlB,MAAM,kCAAkC,CAAC;AAE1C,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/packages/core/dist/types/api.d.ts

@@ -0,0 +1,47 @@
+/**
+ * API response types for the Package Registry
+ */
+export interface ApiPackage {
+    name: string;
+    description: string;
+    keywords: string[];
+    isPrivate: boolean;
+    createdAt: string;
+    updatedAt: string;
+    versions?: Array<ApiPackageVersion | string>;
+}
+export interface ApiPackageVersion {
+    version?: string;
+    tarballSize?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PullPackageRequestOptions {
+    version?: string;
+    recursive?: boolean;
+    paths?: string[];
+    includeManifest?: boolean;
+}
+export interface PushPackageResponse {
+    message: string;
+    package: ApiPackage;
+    version: ApiPackageVersion;
+}
+export interface PullPackageDownload {
+    name: string;
+    downloadUrl?: string;
+}
+export interface PullPackageResponse {
+    package: ApiPackage;
+    version: ApiPackageVersion;
+    downloads: PullPackageDownload[];
+    versions?: Array<ApiPackageVersion | string>;
+    availableVersions?: string[];
+}
+export interface ApiError {
+    error: string;
+    message: string;
+    statusCode: number;
+    details?: any;
+}
+//# sourceMappingURL=api.d.ts.map

package/packages/core/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf"}

package/packages/core/dist/types/api.js

@@ -0,0 +1,5 @@
+/**
+ * API response types for the Package Registry
+ */
+export {};
+//# sourceMappingURL=api.js.map

package/packages/core/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/core/dist/types/conversion-context.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Conversion Context Types
+ *
+ * Provides immutable tracking of package format identity and conversion history
+ * throughout the installation pipeline. This replaces the fragile approach of storing
+ * format metadata in mutable `_format` fields.
+ *
+ * @see plans/conversion-context-architecture.md
+ */
+import type { Platform } from './platform.js';
+/**
+ * Complete conversion context for a package
+ *
+ * Tracks both the original format (immutable identity) and current format (mutable state)
+ * as the package moves through the conversion pipeline.
+ */
+export interface PackageConversionContext {
+    /**
+     * Original format identity (immutable once set)
+     *
+     * This represents what the package originally was when first discovered/loaded.
+     * Used as the canonical source for `$$source` variable in flow conditionals.
+     */
+    readonly originalFormat: FormatIdentity;
+    /**
+     * Current format state (mutable)
+     *
+     * Represents what format the package is currently in. Updated as conversions occur.
+     */
+    currentFormat: FormatState;
+    /**
+     * Complete conversion history (audit trail)
+     *
+     * Records every conversion that has been applied to this package.
+     * Useful for debugging and understanding the transformation pipeline.
+     */
+    conversionHistory: ConversionRecord[];
+    /**
+     * Target platform for current operation
+     *
+     * The platform we're converting/installing to. Used for `$$platform` variable.
+     */
+    targetPlatform?: Platform;
+}
+/**
+ * Immutable format identity
+ *
+ * Represents the original format of a package when first discovered.
+ * Never changes after initial detection.
+ */
+export interface FormatIdentity {
+    /**
+     * Format type classification
+     */
+    readonly type: 'universal' | 'platform-specific';
+    /**
+     * Platform identifier (if platform-specific)
+     *
+     * This is the canonical source for `$$source` in flow conditionals.
+     * Examples: 'claude-plugin', 'claude', 'cursor', 'openpackage'
+     */
+    readonly platform?: Platform;
+    /**
+     * When this format was first detected
+     */
+    readonly detectedAt: Date;
+    /**
+     * Confidence score from format detection (0-1)
+     *
+     * 1.0 = Definitive detection (e.g., .claude-plugin/plugin.json exists)
+     * 0.5-0.9 = Heuristic detection (majority of files match pattern)
+     * < 0.5 = Low confidence (mixed or unclear)
+     */
+    readonly confidence: number;
+}
+/**
+ * Mutable format state
+ *
+ * Represents the current format of the package at any point in the pipeline.
+ * Updated as conversions are applied.
+ */
+export interface FormatState {
+    /**
+     * Current format type
+     */
+    type: 'universal' | 'platform-specific';
+    /**
+     * Current platform (if platform-specific)
+     */
+    platform?: Platform;
+}
+/**
+ * Record of a single conversion operation
+ *
+ * Captures the transformation that occurred, including source, destination,
+ * and the target platform that motivated the conversion.
+ */
+export interface ConversionRecord {
+    /**
+     * Format before conversion
+     */
+    from: FormatState;
+    /**
+     * Format after conversion
+     */
+    to: FormatState;
+    /**
+     * Target platform that motivated this conversion
+     */
+    targetPlatform: Platform;
+    /**
+     * When this conversion occurred
+     */
+    timestamp: Date;
+}
+/**
+ * Result of creating/loading a package with context
+ *
+ * Used at entry points (package loaders, transformers) to return both
+ * the package data and its conversion context together.
+ */
+export interface PackageWithContext<T = any> {
+    /**
+     * The package data
+     */
+    package: T;
+    /**
+     * The conversion context
+     */
+    context: PackageConversionContext;
+}
+/**
+ * Options for serializing context to JSON
+ */
+export interface ContextSerializationOptions {
+    /**
+     * Pretty-print the JSON output
+     */
+    pretty?: boolean;
+    /**
+     * Include full history (default: true)
+     */
+    includeHistory?: boolean;
+}
+/**
+ * Serialized context format for storage
+ *
+ * Simplified format for JSON serialization (dates as ISO strings)
+ */
+export interface SerializedConversionContext {
+    originalFormat: {
+        type: 'universal' | 'platform-specific';
+        platform?: string;
+        detectedAt: string;
+        confidence: number;
+    };
+    currentFormat: {
+        type: 'universal' | 'platform-specific';
+        platform?: string;
+    };
+    conversionHistory: Array<{
+        from: {
+            type: 'universal' | 'platform-specific';
+            platform?: string;
+        };
+        to: {
+            type: 'universal' | 'platform-specific';
+            platform?: string;
+        };
+        targetPlatform: string;
+        timestamp: string;
+    }>;
+    targetPlatform?: string;
+}
+//# sourceMappingURL=conversion-context.d.ts.map

package/packages/core/dist/types/conversion-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-context.d.ts","sourceRoot":"","sources":["../../src/types/conversion-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;OAIG;IACH,aAAa,EAAE,WAAW,CAAC;IAE3B;;;;;OAKG;IACH,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAEtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;IAEjD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAEhB;;OAEG;IACH,cAAc,EAAE,QAAQ,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE;QACd,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,EAAE;QACb,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE;YACJ,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;YACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,EAAE,EAAE;YACF,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;YACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/packages/core/dist/types/conversion-context.js

@@ -0,0 +1,11 @@
+/**
+ * Conversion Context Types
+ *
+ * Provides immutable tracking of package format identity and conversion history
+ * throughout the installation pipeline. This replaces the fragile approach of storing
+ * format metadata in mutable `_format` fields.
+ *
+ * @see plans/conversion-context-architecture.md
+ */
+export {};
+//# sourceMappingURL=conversion-context.js.map

package/packages/core/dist/types/conversion-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-context.js","sourceRoot":"","sources":["../../src/types/conversion-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/packages/core/dist/types/execution-context.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Execution Context Types
+ *
+ * Type definitions for the execution context system that handles
+ * directory resolution for commands with --global support.
+ */
+import type { TelemetryCollector } from '../core/telemetry.js';
+import type { InteractionPolicy } from '../core/interaction-policy.js';
+import type { OutputPort } from '../core/ports/output.js';
+import type { PromptPort } from '../core/ports/prompt.js';
+import type { ProgressPort } from '../core/ports/progress.js';
+/**
+ * ExecutionContext - Single source of truth for directory resolution
+ *
+ * Strictly separates:
+ * - sourceCwd: Where we resolve input arguments (local paths, relative paths)
+ * - targetDir: Where we write output files (installation destination)
+ *
+ * Also carries port interfaces for decoupled output and prompting,
+ * enabling the same core logic to be driven by CLI, GUI, or CI.
+ */
+export interface ExecutionContext {
+    /**
+     * Absolute path to the original working directory.
+     * Used for resolving input arguments (e.g., ./package, ../local-plugin).
+     */
+    sourceCwd: string;
+    /**
+     * Absolute path to the target directory where files will be written.
+     * - For normal commands: current working directory
+     * - For --global commands: home directory
+     * - For --cwd commands: specified directory
+     */
+    targetDir: string;
+    /**
+     * True if targetDir is the home directory.
+     * Convenience flag for conditional logic and display.
+     */
+    isGlobal: boolean;
+    /**
+     * Optional telemetry collector for tracking install events.
+     * When present, successful installations will report telemetry.
+     */
+    telemetryCollector?: TelemetryCollector;
+    /**
+     * Indicates interactive mode (--interactive).
+     * When true, suppress detailed output to keep the interface clean.
+     */
+    interactive?: boolean;
+    /**
+     * Interaction policy controlling prompt behavior across all tiers.
+     * Created once at command entry and threaded through all handlers.
+     */
+    interactionPolicy?: InteractionPolicy;
+    /**
+     * Output port for all user-facing messages (info, success, error, warn, etc.).
+     * When not provided, defaults to consoleOutput (plain console.log).
+     * CLI provides ClackOutputAdapter; GUI provides its own adapter.
+     */
+    output?: OutputPort;
+    /**
+     * Prompt port for all interactive user prompts (confirm, select, text, etc.).
+     * When not provided, defaults to nonInteractivePrompt (throws on prompt).
+     * CLI provides ClackPromptAdapter; GUI provides its own adapter.
+     */
+    prompt?: PromptPort;
+    /**
+     * Progress port for streaming structured progress events to the UI.
+     * When not provided, defaults to silentProgress (no-op).
+     * CLI provides ClackProgressAdapter; GUI provides its own adapter.
+     */
+    progress?: ProgressPort;
+    /**
+     * Rich output port for use during prompt-driven phases.
+     * When prompts fire, surrounding output should match their visual style.
+     * Use `withRichOutput()` to temporarily swap to these ports.
+     * Set by the CLI (or other UI adapter) at context creation; undefined when not available.
+     */
+    richOutput?: OutputPort;
+    /**
+     * Rich progress port, paired with richOutput.
+     */
+    richProgress?: ProgressPort;
+}
+/**
+ * Options for creating an ExecutionContext
+ */
+export interface ExecutionOptions {
+    /**
+     * --global flag: Install to home directory
+     */
+    global?: boolean;
+    /**
+     * --cwd flag: Explicit target directory
+     * (Ignored if global is true)
+     */
+    cwd?: string;
+    /**
+     * Indicates interactive mode (--interactive).
+     * When true, commands should operate in interactive selection mode.
+     */
+    interactive?: boolean;
+}
+/**
+ * Context variables exposed to platform flows and conditional logic
+ */
+export interface ContextVariables {
+    /**
+     * Normalized target path for display.
+     * Shows as ~/ when targeting home directory.
+     */
+    $$targetRoot: string;
+    /**
+     * Original working directory for debugging.
+     */
+    $$sourceCwd: string;
+    /**
+     * Global flag for convenience in conditional logic.
+     */
+    $$isGlobal: boolean;
+}
+//# sourceMappingURL=execution-context.d.ts.map

package/packages/core/dist/types/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../src/types/execution-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/packages/core/dist/types/execution-context.js

@@ -0,0 +1,8 @@
+/**
+ * Execution Context Types
+ *
+ * Type definitions for the execution context system that handles
+ * directory resolution for commands with --global support.
+ */
+export {};
+//# sourceMappingURL=execution-context.js.map

package/packages/core/dist/types/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/types/execution-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}