opkg 0.6.1 → 0.7.0

package/schemas/map-pipeline-v1.json

@@ -0,0 +1,256 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openpackage.ai/schemas/map-pipeline-v1.json",
+  "title": "Map Pipeline",
+  "description": "MongoDB-inspired transformation pipeline for document field operations",
+  "type": "array",
+  "minItems": 1,
+  "items": {
+    "type": "object",
+    "oneOf": [
+      {
+        "title": "$set Operation",
+        "description": "Set field values with context variable resolution",
+        "required": ["$set"],
+        "properties": {
+          "$set": {
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": false
+      },
+      {
+        "title": "$rename Operation",
+        "description": "Rename fields with wildcard support",
+        "required": ["$rename"],
+        "properties": {
+          "$rename": {
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": { "type": "string" }
+          }
+        },
+        "additionalProperties": false
+      },
+      {
+        "title": "$unset Operation",
+        "description": "Remove fields from document",
+        "required": ["$unset"],
+        "properties": {
+          "$unset": {
+            "oneOf": [
+              { "type": "string" },
+              {
+                "type": "array",
+                "items": { "type": "string" },
+                "minItems": 1
+              }
+            ]
+          }
+        },
+        "additionalProperties": false
+      },
+      {
+        "title": "$switch Operation",
+        "description": "Pattern matching with value replacement",
+        "required": ["$switch"],
+        "properties": {
+          "$switch": {
+            "type": "object",
+            "required": ["field", "cases"],
+            "properties": {
+              "field": {
+                "type": "string",
+                "description": "Field path to check and replace"
+              },
+              "cases": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "required": ["pattern", "value"],
+                  "properties": {
+                    "pattern": {
+                      "description": "Pattern to match (string glob or object shape)"
+                    },
+                    "value": {
+                      "description": "Value to set if pattern matches"
+                    }
+                  }
+                }
+              },
+              "default": {
+                "description": "Default value if no pattern matches"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      },
+      {
+        "title": "$transform Operation",
+        "description": "Pipeline transformation on a field",
+        "required": ["$transform"],
+        "properties": {
+          "$transform": {
+            "type": "object",
+            "required": ["field", "steps"],
+            "properties": {
+              "field": {
+                "type": "string",
+                "description": "Field path to transform"
+              },
+              "steps": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "oneOf": [
+                    {
+                      "title": "filter step",
+                      "properties": {
+                        "filter": {
+                          "type": "object",
+                          "properties": {
+                            "value": { "description": "Filter by value equality" },
+                            "key": { "description": "Filter by key equality" }
+                          }
+                        }
+                      },
+                      "required": ["filter"],
+                      "additionalProperties": false
+                    },
+                    {
+                      "title": "keys step",
+                      "properties": { "keys": { "const": true } },
+                      "required": ["keys"],
+                      "additionalProperties": false
+                    },
+                    {
+                      "title": "values step",
+                      "properties": { "values": { "const": true } },
+                      "required": ["values"],
+                      "additionalProperties": false
+                    },
+                    {
+                      "title": "entries step",
+                      "properties": { "entries": { "const": true } },
+                      "required": ["entries"],
+                      "additionalProperties": false
+                    },
+                    {
+                      "title": "map step",
+                      "properties": {
+                        "map": {
+                          "type": "string",
+                          "enum": ["capitalize", "uppercase", "lowercase"]
+                        }
+                      },
+                      "required": ["map"],
+                      "additionalProperties": false
+                    },
+                    {
+                      "title": "join step",
+                      "properties": {
+                        "join": {
+                          "type": "string",
+                          "description": "Separator string for joining array elements"
+                        }
+                      },
+                      "required": ["join"],
+                      "additionalProperties": false
+                    },
+                    {
+                      "title": "replace step",
+                      "properties": {
+                        "replace": {
+                          "type": "object",
+                          "description": "Regex replacement with capture group support",
+                          "required": ["pattern", "with"],
+                          "properties": {
+                            "pattern": {
+                              "type": "string",
+                              "description": "Regex pattern to match"
+                            },
+                            "with": {
+                              "type": "string",
+                              "description": "Replacement string (supports $1, $2 capture groups)"
+                            },
+                            "flags": {
+                              "type": "string",
+                              "description": "Optional regex flags (e.g., 'g', 'i')"
+                            }
+                          },
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": ["replace"],
+                      "additionalProperties": false
+                    }
+                  ]
+                }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      },
+      {
+        "title": "$copy Operation",
+        "description": "Copy field with optional pattern-based transformation",
+        "required": ["$copy"],
+        "properties": {
+          "$copy": {
+            "type": "object",
+            "required": ["from", "to"],
+            "properties": {
+              "from": {
+                "type": "string",
+                "description": "Source field path"
+              },
+              "to": {
+                "type": "string",
+                "description": "Target field path"
+              },
+              "transform": {
+                "type": "object",
+                "required": ["cases"],
+                "properties": {
+                  "cases": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                      "type": "object",
+                      "required": ["pattern", "value"],
+                      "properties": {
+                        "pattern": { "description": "Pattern to match" },
+                        "value": { "description": "Value to set if pattern matches" }
+                      }
+                    }
+                  },
+                  "default": {
+                    "description": "Default value if no pattern matches"
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    ]
+  },
+  "examples": [
+    [{ "$set": { "name": "$$filename" } }],
+    [{ "$rename": { "mcp": "mcpServers" } }],
+    [{ "$switch": { "field": "model", "cases": [{ "pattern": "anthropic/claude-sonnet-*", "value": "sonnet" }], "default": "inherit" } }],
+    [{ "$transform": { "field": "tools", "steps": [{ "filter": { "value": true } }, { "keys": true }, { "map": "capitalize" }, { "join": ", " }] } }],
+    [{ "$copy": { "from": "permission", "to": "permissionMode", "transform": { "cases": [{ "pattern": { "edit": "deny", "bash": "deny" }, "value": "plan" }], "default": "default" } } }]
+  ]
+}

package/schemas/platforms-v1.json

@@ -0,0 +1,400 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openpackage.dev/schemas/platforms-v1.json",
+  "title": "OpenPackage Platforms Configuration",
+  "description": "Platform definitions for OpenPackage CLI, supporting both flow-based and legacy subdirs configurations",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/definitions/platformConfig"
+  },
+  "definitions": {
+    "platformConfig": {
+      "type": "object",
+      "description": "Configuration for a single platform",
+      "required": ["name", "rootDir"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name of the platform"
+        },
+        "rootDir": {
+          "type": "string",
+          "description": "Platform root directory (e.g., '.cursor', '.claude')",
+          "pattern": "^\\."
+        },
+        "rootFile": {
+          "type": "string",
+          "description": "Optional root file for platform detection (e.g., 'AGENTS.md')"
+        },
+        "aliases": {
+          "type": "array",
+          "description": "Alternative names for the platform",
+          "items": {
+            "type": "string"
+          }
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether the platform is enabled (default: true)",
+          "default": true
+        },
+        "export": {
+          "type": "array",
+          "description": "Export flows: Package → Workspace (install, apply)",
+          "items": {
+            "$ref": "#/definitions/flow"
+          }
+        },
+        "import": {
+          "type": "array",
+          "description": "Import flows: Workspace → Package (save)",
+          "items": {
+            "$ref": "#/definitions/flow"
+          }
+        },
+        "subdirs": {
+          "type": "array",
+          "description": "Legacy subdirectory mappings (deprecated, use flows instead)",
+          "items": {
+            "$ref": "#/definitions/subdirConfig"
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "Platform description for documentation"
+        },
+        "variables": {
+          "type": "object",
+          "description": "Custom variables for flow template substitution",
+          "additionalProperties": true
+        }
+      }
+    },
+    "flow": {
+      "type": "object",
+      "description": "Defines a transformation from source to target",
+      "required": ["from", "to"],
+      "properties": {
+        "from": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Source file pattern (supports glob patterns and {name} placeholders)"
+            },
+            {
+              "type": "array",
+              "description": "Array of source patterns with priority (first match wins)",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1
+            }
+          ]
+        },
+        "to": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single target path"
+            },
+            {
+              "type": "object",
+              "description": "Multi-target configuration",
+              "additionalProperties": {
+                "$ref": "#/definitions/multiTargetFlowConfig"
+              }
+            }
+          ]
+        },
+        "map": {
+          "type": "array",
+          "description": "Map Pipeline - array of transformation operations (includes $pipe for transform registry operations)",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "description": "A single map operation ($set, $rename, $unset, $switch, $pipeline, $copy, $pipe)"
+          }
+        },
+        "pick": {
+          "type": "array",
+          "description": "Keys to include (whitelist)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "omit": {
+          "type": "array",
+          "description": "Keys to exclude (blacklist)",
+          "items": {
+            "type": "string"
+          }
+        },
+        "path": {
+          "type": "string",
+          "description": "JSONPath expression to extract subset of data"
+        },
+        "embed": {
+          "type": "string",
+          "description": "Embed content under this key in the target"
+        },
+        "section": {
+          "type": "string",
+          "description": "TOML section name (for TOML targets)"
+        },
+        "when": {
+          "$ref": "#/definitions/condition",
+          "description": "Conditional execution"
+        },
+        "merge": {
+          "type": "string",
+          "enum": ["deep", "shallow", "replace", "composite"],
+          "description": "Merge strategy when target exists (default: 'replace')",
+          "default": "replace"
+        },
+        "handler": {
+          "type": "string",
+          "description": "Custom handler name for edge cases"
+        },
+        "priority": {
+          "type": "number",
+          "description": "Priority for conflict resolution (higher = wins, default: 0)",
+          "default": 0
+        },
+        "description": {
+          "type": "string",
+          "description": "Flow description for documentation/debugging"
+        }
+      }
+    },
+    "multiTargetFlowConfig": {
+      "type": "object",
+      "description": "Configuration for a single target in a multi-target flow",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether this target is enabled (default: true)",
+          "default": true
+        },
+        "map": {
+          "type": "array",
+          "description": "Map Pipeline overrides (includes $pipe for transform registry operations)",
+          "minItems": 1,
+          "items": {
+            "type": "object"
+          }
+        },
+        "pick": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "omit": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "path": {
+          "type": "string"
+        },
+        "embed": {
+          "type": "string"
+        },
+        "section": {
+          "type": "string"
+        },
+        "merge": {
+          "type": "string",
+          "enum": ["deep", "shallow", "replace", "composite"]
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+
+    "condition": {
+      "type": "object",
+      "description": "Conditions for flow execution",
+      "properties": {
+        "exists": {
+          "type": "string",
+          "description": "File or directory must exist"
+        },
+        "platform": {
+          "type": "string",
+          "description": "Platform must be enabled"
+        },
+        "key": {
+          "type": "string",
+          "description": "Key must exist in source data"
+        },
+        "equals": {
+          "description": "Key must equal specific value"
+        },
+        "and": {
+          "type": "array",
+          "description": "All conditions must be true",
+          "items": {
+            "$ref": "#/definitions/condition"
+          }
+        },
+        "or": {
+          "type": "array",
+          "description": "Any condition must be true",
+          "items": {
+            "$ref": "#/definitions/condition"
+          }
+        },
+        "not": {
+          "$ref": "#/definitions/condition",
+          "description": "Condition must be false"
+        }
+      }
+    },
+    "subdirConfig": {
+      "type": "object",
+      "description": "Legacy subdirectory mapping (deprecated)",
+      "required": ["universalDir", "platformDir"],
+      "properties": {
+        "universalDir": {
+          "type": "string",
+          "description": "Universal directory name (e.g., 'rules', 'commands')"
+        },
+        "platformDir": {
+          "type": "string",
+          "description": "Platform-specific directory name"
+        },
+        "exts": {
+          "type": "array",
+          "description": "Allowed file extensions (undefined = all, [] = none)",
+          "items": {
+            "type": "string",
+            "pattern": "^\\."
+          }
+        },
+        "transformations": {
+          "type": "array",
+          "description": "Extension transformations",
+          "items": {
+            "$ref": "#/definitions/extensionTransformation"
+          }
+        }
+      }
+    },
+    "extensionTransformation": {
+      "type": "object",
+      "description": "Extension transformation between package and workspace",
+      "required": ["packageExt", "workspaceExt"],
+      "properties": {
+        "packageExt": {
+          "type": "string",
+          "description": "Package (registry) extension",
+          "pattern": "^\\."
+        },
+        "workspaceExt": {
+          "type": "string",
+          "description": "Workspace extension",
+          "pattern": "^\\."
+        }
+      }
+    },
+    "globalConfig": {
+      "type": "object",
+      "description": "Global flows configuration",
+      "properties": {
+        "export": {
+          "type": "array",
+          "description": "Global export flows (package → workspace) applied before platform-specific flows",
+          "items": {
+            "$ref": "#/definitions/flow"
+          }
+        },
+        "import": {
+          "type": "array",
+          "description": "Global import flows (workspace → package) applied before platform-specific flows",
+          "items": {
+            "$ref": "#/definitions/flow"
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "Configuration description"
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "cursor": {
+        "name": "Cursor",
+        "rootDir": ".cursor",
+        "rootFile": "AGENTS.md",
+        "export": [
+          {
+            "from": "rules/{name}.md",
+            "to": ".cursor/rules/{name}.mdc",
+            "description": "Transform rules to .mdc format"
+          },
+          {
+            "from": "commands/{name}.md",
+            "to": ".cursor/commands/{name}.md"
+          },
+          {
+            "from": ["mcp.jsonc", "mcp.json"],
+            "to": ".cursor/mcp.json",
+            "pipe": ["filter-comments"],
+            "merge": "deep"
+          }
+        ],
+        "import": [
+          {
+            "from": [".cursor/rules/{name}.mdc", ".cursor/rules/{name}.md"],
+            "to": "rules/{name}.md"
+          },
+          {
+            "from": ".cursor/commands/{name}.md",
+            "to": "commands/{name}.md"
+          },
+          {
+            "from": [".cursor/mcp.json", ".cursor/mcp.jsonc"],
+            "to": "mcp.jsonc"
+          }
+        ]
+      },
+      "claude": {
+        "name": "Claude Code",
+        "rootDir": ".claude",
+        "rootFile": "CLAUDE.md",
+        "aliases": ["claudecode"],
+        "export": [
+          {
+            "from": "rules/{name}.md",
+            "to": ".claude/rules/{name}.md"
+          },
+          {
+            "from": "agents/{name}.md",
+            "to": ".claude/agents/{name}.md",
+            "map": [
+              { "$set": { "name": "$$filename" } }
+            ]
+          }
+        ],
+        "import": [
+          {
+            "from": ".claude/rules/{name}.md",
+            "to": "rules/{name}.md"
+          },
+          {
+            "from": ".claude/agents/{name}.md",
+            "to": "agents/{name}.md",
+            "map": [
+              { "$unset": "name" }
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}