opkg 0.9.0 → 0.9.2

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

@@ -0,0 +1,360 @@
+/**
+ * Core type definitions for the Platform Flows System
+ *
+ * Flows define declarative transformations for moving content between
+ * universal package format and platform-specific workspace files.
+ */
+import type { MapPipeline } from '../core/flows/map-pipeline/types.js';
+/**
+ * A Flow defines how to transform content from a source to a target.
+ * Flows execute through a pipeline: load → extract → filter → map → transform → embed → merge → write
+ */
+export interface Flow {
+    /**
+     * Source file pattern, array of patterns, or switch expression (supports glob patterns like *.md)
+     * When array is provided, first matching pattern is used (priority order)
+     */
+    from: string | string[] | SwitchExpression;
+    /** Target path, multi-target configuration, or switch expression */
+    to: string | MultiTargetFlows | SwitchExpression;
+    /** Map pipeline - MongoDB-inspired document transformations */
+    map?: MapPipeline;
+    /** Keys to include (whitelist) */
+    pick?: string[];
+    /** Keys to exclude (blacklist) */
+    omit?: string[];
+    /** JSONPath expression to extract subset of data */
+    path?: string;
+    /** Embed content under this key in the target */
+    embed?: string;
+    /** TOML section name (for TOML targets) */
+    section?: string;
+    /** Conditional execution */
+    when?: Condition;
+    /** Merge strategy when target exists (default: "replace") */
+    merge?: MergeStrategy;
+    /** Custom handler name for edge cases */
+    handler?: string;
+    /** Priority for conflict resolution (higher = wins, default: 0) */
+    priority?: number;
+    /** Description for documentation/debugging */
+    description?: string;
+}
+/**
+ * Multi-target flow configuration
+ * Allows transforming one source to multiple targets with different transforms
+ */
+export interface MultiTargetFlows {
+    [targetPath: string]: Partial<Flow>;
+}
+/**
+ * Flow pattern with optional schema reference
+ * Used in switch case values to specify format detection schema
+ */
+export interface FlowPatternValue {
+    /** Glob pattern (e.g., "agents/**\/*.md") */
+    pattern: string;
+    /** Explicit path to schema (e.g., "./schemas/formats/claude-agent.schema.json") */
+    schema?: string;
+}
+/**
+ * Switch case value - either a simple string path or a pattern with schema
+ */
+export type SwitchCaseValue = string | FlowPatternValue;
+/**
+ * Switch expression for conditional target path resolution
+ * Inspired by MongoDB's $switch aggregation operator
+ */
+export interface SwitchExpression {
+    $switch: {
+        /** Context variable to evaluate (e.g., "$$targetRoot") */
+        field: string;
+        /** Pattern cases to match (evaluated in order, first match wins) */
+        cases: SwitchCase[];
+        /** Optional default value if no pattern matches */
+        default?: SwitchCaseValue;
+    };
+}
+/**
+ * Switch case for pattern matching
+ */
+export interface SwitchCase {
+    /** Pattern to match (string for equality/glob, object for shape matching) */
+    pattern: string | object;
+    /** Target path to use if pattern matches (string or pattern with schema) */
+    value: SwitchCaseValue;
+}
+/**
+ * Merge strategies for handling conflicts when target file exists
+ */
+export type MergeStrategy = "deep" | "shallow" | "replace" | "composite";
+/**
+ * Key mapping configuration
+ * Maps source keys to target keys with optional transformations
+ */
+export interface KeyMap {
+    [sourceKey: string]: string | KeyMapConfig;
+}
+/**
+ * Advanced key mapping with transformations and defaults
+ */
+export interface KeyMapConfig {
+    /** Target key path (supports dot notation) */
+    to: string;
+    /** Transform to apply to the value */
+    transform?: string | string[];
+    /** Default value if source key is missing */
+    default?: any;
+    /** Value lookup table - map source values to target values */
+    values?: Record<string, any>;
+    /** Whether to remove the key if value is undefined/null */
+    required?: boolean;
+}
+/**
+ * Conditions for flow execution
+ */
+export interface Condition {
+    /** File or directory exists */
+    exists?: string;
+    /** Platform is enabled */
+    platform?: string;
+    /** Key exists in source data */
+    key?: string;
+    /** Key equals specific value */
+    equals?: any;
+    /** Equality check: [left, right] - supports $$variables */
+    $eq?: [string, string];
+    /** Not equal check: [left, right] - supports $$variables */
+    $ne?: [string, string];
+    /** All conditions must be true */
+    and?: Condition[];
+    /** Any condition must be true */
+    or?: Condition[];
+    /** Condition must be false */
+    not?: Condition;
+}
+/**
+ * Transform function interface
+ */
+export interface Transform {
+    /** Transform name (used in pipe array) */
+    name: string;
+    /** Execute the transform */
+    execute(input: any, options?: any, context?: TransformContext): any;
+    /** Validate transform options */
+    validate?(options?: any): boolean;
+    /** Description for documentation */
+    description?: string;
+    /** Whether transform is reversible (for save flows) */
+    reversible?: boolean;
+}
+/**
+ * Context passed to transforms
+ */
+export interface TransformContext {
+    /** Workspace root directory */
+    workspaceRoot: string;
+    /** Package root directory */
+    packageRoot: string;
+    /** Current platform ID */
+    platform: string;
+    /** Package name */
+    packageName: string;
+    /** Source file path */
+    sourcePath: string;
+    /** Target file path */
+    targetPath: string;
+    /** Custom variables */
+    variables: Record<string, any>;
+    /** Flow being executed */
+    flow: Flow;
+}
+/**
+ * Transform registry
+ */
+export interface TransformRegistry {
+    /** Register a transform */
+    register(transform: Transform): void;
+    /** Get a transform by name */
+    get(name: string): Transform | undefined;
+    /** Execute a transform */
+    execute(name: string, input: any, options?: any, context?: TransformContext): any;
+    /** Check if transform exists */
+    has(name: string): boolean;
+    /** List all registered transforms */
+    list(): string[];
+}
+/**
+ * Flow execution context
+ */
+export interface FlowContext {
+    /** Workspace root directory */
+    workspaceRoot: string;
+    /** Package root directory (in .opkg registry) */
+    packageRoot: string;
+    /** Current platform ID */
+    platform: string;
+    /** Package name */
+    packageName: string;
+    /** Custom variables for template substitution (includes 'source' and 'platform') */
+    variables: Record<string, any>;
+    /** Direction: install (package→workspace) or save (workspace→package) */
+    direction: "install" | "save";
+    /** Dry run mode (don't write files) */
+    dryRun?: boolean;
+}
+/**
+ * Result of flow execution
+ */
+export interface FlowResult {
+    /** Source file path */
+    source: string;
+    /** Target file path(s) */
+    target: string | string[];
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Whether content was transformed (vs. simple copy) */
+    transformed: boolean;
+    /**
+     * Keys contributed by this flow (after transformations)
+     * Used for precise removal during uninstall of merged files
+     * Example: ["mcp.server1", "mcp.server2"]
+     * Only populated when merge strategy is used
+     */
+    keys?: string[];
+    /** Merge strategy used (if applicable) */
+    merge?: 'deep' | 'shallow' | 'replace' | 'composite';
+    /** Error if execution failed */
+    error?: Error;
+    /** Warnings encountered during execution */
+    warnings?: string[];
+    /** Merge conflicts detected */
+    conflicts?: FlowConflict[];
+    /** Transform pipeline applied */
+    pipeline?: string[];
+    /** Execution time in milliseconds */
+    executionTime?: number;
+}
+/**
+ * Conflict detected during merge
+ */
+export interface FlowConflict {
+    /** Target file where conflict occurred */
+    target?: string;
+    /** Path where conflict occurred */
+    path: string;
+    /** Package that won (based on priority) */
+    winner: string;
+    /** Package(s) that lost */
+    losers: string[];
+    /** Packages involved (for platform-flows compatibility) */
+    packages?: string[];
+    /** Conflict type */
+    type: "key" | "value" | "array" | "object";
+    /** Resolution applied */
+    resolution: string;
+    /** Conflict details */
+    details?: string;
+}
+/**
+ * Flow executor interface
+ */
+export interface FlowExecutor {
+    /** Execute a single flow */
+    executeFlow(flow: Flow, context: FlowContext): Promise<FlowResult>;
+    /** Execute multiple flows */
+    executeFlows(flows: Flow[], context: FlowContext): Promise<FlowResult[]>;
+    /** Execute a multi-target flow */
+    executeMultiTarget(flow: Flow, context: FlowContext): Promise<FlowResult[]>;
+    /** Validate a flow configuration */
+    validateFlow(flow: Flow): ValidationResult;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation errors */
+    errors: ValidationError[];
+    /** Validation warnings */
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    /** Error message */
+    message: string;
+    /** Path to the error (for nested structures) */
+    path?: string;
+    /** Error code */
+    code?: string;
+}
+/**
+ * Validation warning
+ */
+export interface ValidationWarning {
+    /** Warning message */
+    message: string;
+    /** Path to the warning */
+    path?: string;
+    /** Warning code */
+    code?: string;
+}
+/**
+ * Supported file formats
+ */
+export type FileFormat = "json" | "jsonc" | "yaml" | "yml" | "toml" | "markdown" | "md" | "text" | "txt";
+/**
+ * Content with metadata
+ */
+export interface ParsedContent {
+    /** Parsed content */
+    data: any;
+    /** Original format */
+    format: FileFormat;
+    /** Raw content */
+    raw: string;
+    /** Frontmatter (for markdown) */
+    frontmatter?: any;
+    /** Body (for markdown) */
+    body?: string;
+}
+/**
+ * Priority calculation for conflict resolution
+ */
+export interface Priority {
+    /** Numeric priority (higher = wins) */
+    value: number;
+    /** Source of priority (workspace, direct, nested) */
+    source: "workspace" | "direct" | "nested";
+    /** Depth in dependency tree (0 = direct) */
+    depth: number;
+    /** Package name */
+    package: string;
+}
+/**
+ * MCP server configuration (universal format)
+ * This is the canonical format used in package files (mcp.jsonc)
+ */
+export interface McpServer {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    env_vars?: string[];
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    enabled?: boolean;
+    timeout?: number;
+    enabled_tools?: string[];
+    disabled_tools?: string[];
+}
+/**
+ * MCP configuration root (universal format)
+ */
+export interface McpConfig {
+    mcp: Record<string, McpServer>;
+}
+//# sourceMappingURL=flows.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Core type definitions for the Platform Flows System
+ *
+ * Flows define declarative transformations for moving content between
+ * universal package format and platform-specific workspace files.
+ */
+export {};
+//# sourceMappingURL=flows.js.map

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

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

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

@@ -0,0 +1,271 @@
+/**
+ * Common types and interfaces for the OpenPackage CLI application
+ */
+export * from './flows.js';
+export * from './platform-flows.js';
+export * from './conversion-context.js';
+export * from './execution-context.js';
+import type { Platform, PlatformDefinition, PlatformPaths, PlatformDirectoryPaths } from './platform.js';
+export type { Platform, PlatformDefinition, PlatformPaths, PlatformDirectoryPaths };
+export * from './resources.js';
+export * from './install.js';
+export interface OpenPackageDirectories {
+    config: string;
+    data: string;
+    cache: string;
+    runtime: string;
+}
+export interface ConfigDefaults {
+    license?: string;
+}
+export interface ProfileConfigDefaults {
+    author?: string;
+    scope?: string;
+}
+export interface TelemetryConfig {
+    disabled?: boolean;
+}
+export interface OpenPackageConfig {
+    defaults?: ConfigDefaults;
+    profiles?: Record<string, ProfileConfig>;
+    telemetry?: TelemetryConfig;
+}
+export interface ProfileConfig {
+    description?: string;
+    defaults?: ProfileConfigDefaults;
+}
+export interface ProfileCredentials {
+    api_key: string;
+}
+export interface Profile {
+    name: string;
+    config: ProfileConfig;
+    credentials?: ProfileCredentials;
+}
+export interface AuthOptions {
+    profile?: string;
+    apiKey?: string;
+}
+export interface PackageFile {
+    path: string;
+    content: string;
+    encoding?: string;
+}
+export interface Package {
+    metadata: PackageYml;
+    files: PackageFile[];
+    /**
+     * Internal format metadata (for conversion system)
+     * Not serialized or persisted
+     */
+    _format?: any;
+}
+export interface PackageRepository {
+    type: string;
+    url: string;
+    directory?: string;
+}
+export interface PackageDependency {
+    name: string;
+    /**
+     * Registry source: semver version or range
+     * Mutually exclusive with path (local) and url
+     */
+    version?: string;
+    /**
+     * Dual meaning based on context:
+     * - When url is absent: Local filesystem path
+     * - When url is present: Subdirectory within git repository
+     */
+    path?: string;
+    /**
+     * Git/HTTP source URL with optional embedded ref (#ref)
+     * Format: <git-url>[#<ref>]
+     * Examples:
+     *   - https://github.com/user/repo.git
+     *   - https://github.com/user/repo.git#main
+     *   - https://github.com/user/repo.git#v1.0.0
+     * Mutually exclusive with version
+     */
+    url?: string;
+    /**
+     * @deprecated Use url instead
+     * Still read for backward compatibility, never written
+     */
+    git?: string;
+    /**
+     * @deprecated Embed in url as #ref
+     * Still read for backward compatibility, never written
+     */
+    ref?: string;
+    /**
+     * @deprecated Use path instead
+     * Already migrated in v0.8.x, kept for older files
+     */
+    subdirectory?: string;
+    /**
+     * Base path within the repository (Phase 5: Resource model)
+     * Relative path from repository root to the installation base.
+     * Used for reproducibility when ambiguous base was resolved by user.
+     * Examples:
+     *   - "" (empty string) = repo root
+     *   - "plugins/my-plugin" = subdirectory within repo
+     */
+    base?: string;
+}
+export interface PackageYml {
+    name: string;
+    version?: string;
+    private?: boolean;
+    partial?: boolean;
+    description?: string;
+    keywords?: string[];
+    author?: string;
+    license?: string;
+    homepage?: string;
+    repository?: PackageRepository;
+    dependencies?: PackageDependency[];
+    'dev-dependencies'?: PackageDependency[];
+    packages?: PackageDependency[];
+    'dev-packages'?: PackageDependency[];
+}
+export interface InstallOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    variables?: Record<string, any>;
+    dev?: boolean;
+    platforms?: string[];
+    resolvedPlatforms?: Platform[];
+    remote?: boolean;
+    local?: boolean;
+    profile?: string;
+    apiKey?: string;
+    conflictStrategy?: 'ask' | 'namespace' | 'overwrite' | 'skip';
+    conflictDecisions?: Record<string, 'namespace' | 'overwrite' | 'skip'>;
+    resolutionMode?: 'default' | 'remote-primary' | 'local-only';
+    global?: boolean;
+    /**
+     * Specific plugins to install from a marketplace (bypasses interactive selection).
+     * Comma-separated or array of plugin names.
+     */
+    plugins?: string[];
+    /**
+     * Agent filter: install only matching agents from source.
+     */
+    agents?: string[];
+    /**
+     * Skill filter: install only matching skills from source.
+     */
+    skills?: string[];
+    /**
+     * Rule filter: install only matching rules from source.
+     */
+    rules?: string[];
+    /**
+     * Command filter: install only matching commands from source.
+     */
+    commands?: string[];
+    /**
+     * Interactive resource selection: display menu to select specific resources to install.
+     * Mutually exclusive with --agents and --skills.
+     * Ignored for marketplace sources (which already have plugin selection).
+     */
+    interactive?: boolean;
+    /**
+     * Internal: when true, do not write to the workspace manifest during install.
+     * Used by recursive dependency resolution (bulk install) to avoid bubbling transitive deps
+     * into the workspace `openpackage.yml`.
+     */
+    skipManifestUpdate?: boolean;
+}
+export interface UninstallOptions {
+    dryRun?: boolean;
+    recursive?: boolean;
+    global?: boolean;
+}
+export interface SaveOptions {
+    force?: boolean;
+    rename?: string;
+    platformSpecific?: boolean;
+    apply?: boolean;
+}
+export interface RegistryEntry {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    downloadCount?: number;
+    lastUpdated: string;
+}
+export interface PackageStatus {
+    name: string;
+    version: string;
+    status: 'installed' | 'outdated' | 'modified' | 'error';
+    installedAt?: string;
+    availableVersion?: string;
+}
+export interface CommandResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    warnings?: string[];
+}
+export declare class OpenPackageError extends Error {
+    code: string;
+    details?: any;
+    constructor(message: string, code: string, details?: any);
+}
+export declare enum ErrorCodes {
+    PACKAGE_NOT_FOUND = "PACKAGE_NOT_FOUND",
+    INVALID_PACKAGE = "INVALID_PACKAGE",
+    FILE_SYSTEM_ERROR = "FILE_SYSTEM_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    CONFIG_ERROR = "CONFIG_ERROR"
+}
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+export interface Logger {
+    debug(message: string, meta?: any): void;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+}
+export interface SaveDiscoveredFile {
+    fullPath: string;
+    relativePath: string;
+    sourceDir: string;
+    registryPath: string;
+    mtime: number;
+    contentHash: string;
+    forcePlatformSpecific?: boolean;
+    isRootFile?: boolean;
+}
+export type DiscoveredFile = SaveDiscoveredFile;
+export interface UninstallDiscoveredFile {
+    fullPath: string;
+    sourceDir: string;
+    isRootFile?: boolean;
+}
+export interface ContentAnalysisResult {
+    universalFiles: Array<{
+        file: SaveDiscoveredFile;
+        finalRegistryPath: string;
+    }>;
+    platformSpecificFiles: Array<{
+        file: SaveDiscoveredFile;
+        platformName: string;
+        finalRegistryPath: string;
+    }>;
+}
+export interface FileIdInfo {
+    fullPath: string;
+    id: string | null;
+    packageName: string | null;
+    isValid: boolean;
+    frontmatter: any | null;
+}
+//# sourceMappingURL=index.d.ts.map

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

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