onreza-release 1.0.0

package/schema.json

@@ -0,0 +1,461 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "description": "Configuration file for gitverse-release tool",
+  "properties": {
+    "$schema": {
+      "description": "JSON Schema reference for IDE support",
+      "type": "string"
+    },
+    "binaries": {
+      "default": {
+        "continueOnError": false,
+        "distDir": "./dist",
+        "enabled": false,
+        "inputFormat": "directory",
+        "mainPackage": "./package.json",
+        "name": "",
+        "outDir": "./npm",
+        "platforms": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"],
+        "publishCommand": "npm publish --access public",
+        "retryAttempts": 3
+      },
+      "description": "Binary distribution settings for publishing platform-specific npm packages",
+      "properties": {
+        "archiveNameTemplate": {
+          "default": "{{name}}-{{platform}}.tar.gz",
+          "description": "Template for archive file names. Placeholders: {{name}}, {{platform}}. Used only with inputFormat: 'tar.gz'",
+          "examples": ["{{platform}}.tar.gz", "{{name}}-{{platform}}.tar.gz", "{{name}}_{{platform}}_release.tar.gz"],
+          "type": "string"
+        },
+        "binName": {
+          "description": "Binary name in $PATH. Defaults to 'name' value",
+          "type": "string"
+        },
+        "continueOnError": {
+          "default": false,
+          "description": "Continue publishing remaining packages if one fails",
+          "type": "boolean"
+        },
+        "distDir": {
+          "default": "./dist",
+          "description": "Directory containing platform-specific binaries (e.g., dist/yougile-linux-x64/yougile)",
+          "type": "string"
+        },
+        "enabled": {
+          "default": false,
+          "description": "Enable binary distribution",
+          "type": "boolean"
+        },
+        "inputFormat": {
+          "default": "directory",
+          "description": "Input format for binaries. 'directory' expects binaries in dist/name-platform/name, 'tar.gz' expects archives in dist/name-platform.tar.gz",
+          "enum": ["directory", "tar.gz"],
+          "type": "string"
+        },
+        "mainPackage": {
+          "default": "./package.json",
+          "description": "Path to main package.json for updating optionalDependencies",
+          "type": "string"
+        },
+        "name": {
+          "description": "Base name for packages (e.g., 'yougile' creates @scope/yougile-linux-x64)",
+          "type": "string"
+        },
+        "outDir": {
+          "default": "./npm",
+          "description": "Output directory for generated npm packages",
+          "type": "string"
+        },
+        "packageNameTemplate": {
+          "description": "Template for package names. Placeholders: {{scope}}, {{name}}, {{platform}}. Default: '{{name}}-{{platform}}' (without scope) or '@{{scope}}/{{name}}-{{platform}}' (with scope)",
+          "examples": ["{{name}}-{{platform}}", "@{{scope}}/{{name}}-{{platform}}", "{{name}}-bin-{{platform}}"],
+          "type": "string"
+        },
+        "platformMap": {
+          "additionalProperties": {
+            "enum": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64", "win32-arm64"],
+            "type": "string"
+          },
+          "description": "Mapping of source file keys to npm platforms. Keys are identifiers in archive names (e.g., 'linux-x64'), values are npm platforms",
+          "type": "object"
+        },
+        "platforms": {
+          "default": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"],
+          "description": "Platforms to publish",
+          "items": {
+            "enum": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64", "win32-arm64"],
+            "type": "string"
+          },
+          "type": "array",
+          "uniqueItems": true
+        },
+        "publishCommand": {
+          "default": "npm publish --access public",
+          "description": "Command to publish packages. Supports placeholders: {{packageDir}}, {{version}}, {{platform}}, {{scope}}, {{name}}",
+          "type": "string"
+        },
+        "retryAttempts": {
+          "default": 3,
+          "description": "Number of retry attempts for publish command",
+          "maximum": 10,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "scope": {
+          "description": "npm scope for platform packages (e.g., '@rainypixel'). Optional - if not set, packages are published without scope",
+          "type": "string"
+        },
+        "sourceBinName": {
+          "description": "Binary name inside archive (if different from 'name'). Used only with inputFormat: 'tar.gz'",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "changelog": {
+      "default": {
+        "showAuthor": true,
+        "showHash": true,
+        "types": {}
+      },
+      "description": "CHANGELOG generation settings",
+      "properties": {
+        "showAuthor": {
+          "default": true,
+          "description": "Show commit author in changelog entries",
+          "type": "boolean"
+        },
+        "showHash": {
+          "default": true,
+          "description": "Show commit hash in changelog entries",
+          "type": "boolean"
+        },
+        "types": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {
+            "build": "🏗️ Build System",
+            "chore": "🔧 Chores",
+            "ci": "👷 CI/CD",
+            "docs": "📝 Documentation",
+            "feat": "✨ Features",
+            "fix": "🐛 Bug Fixes",
+            "perf": "⚡ Performance",
+            "refactor": "♻️ Refactoring",
+            "revert": "⏪ Reverts",
+            "style": "💄 Styling",
+            "test": "✅ Tests"
+          },
+          "description": "Mapping of commit types to changelog section titles",
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "commitlint": {
+      "default": {
+        "bodyMaxLineLength": null,
+        "comments": true,
+        "footerMaxLineLength": null,
+        "format": "ts",
+        "headerMaxLength": 100,
+        "headerMinLength": null,
+        "output": "commitlint.config.ts",
+        "scopeRequired": false,
+        "scopes": ["deps", "ci", "docs"],
+        "strictMode": false,
+        "subjectCase": null,
+        "subjectFullStop": false,
+        "warningRules": ["header-max-length"]
+      },
+      "description": "Commitlint config generation settings",
+      "properties": {
+        "bodyMaxLineLength": {
+          "default": null,
+          "description": "Maximum line length for commit body. Set to null to disable",
+          "type": ["number", "null"]
+        },
+        "comments": {
+          "default": true,
+          "description": "Include explanatory comments in generated config",
+          "type": "boolean"
+        },
+        "footerMaxLineLength": {
+          "default": null,
+          "description": "Maximum line length for commit footer. Set to null to disable",
+          "type": ["number", "null"]
+        },
+        "format": {
+          "default": "ts",
+          "description": "Output format for commitlint config",
+          "enum": ["ts", "js", "json"],
+          "type": "string"
+        },
+        "headerMaxLength": {
+          "default": 100,
+          "description": "Maximum commit header length",
+          "type": "number"
+        },
+        "headerMinLength": {
+          "default": null,
+          "description": "Minimum commit header length. Set to null to disable",
+          "type": ["number", "null"]
+        },
+        "output": {
+          "default": "commitlint.config.ts",
+          "description": "Output path for generated commitlint config",
+          "type": "string"
+        },
+        "scopeRequired": {
+          "default": false,
+          "description": "Whether scope is required in commit messages",
+          "type": "boolean"
+        },
+        "scopes": {
+          "default": ["deps", "ci", "docs"],
+          "description": "Additional scopes beyond monorepo package names",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "strictMode": {
+          "default": false,
+          "description": "Enable strict mode: all rules become errors, subject-case enforced as lower-case, body/footer line lengths enforced",
+          "type": "boolean"
+        },
+        "subjectCase": {
+          "default": null,
+          "description": "Required case for commit subject. Set to null to allow any case",
+          "enum": [
+            "lower-case",
+            "upper-case",
+            "camel-case",
+            "kebab-case",
+            "pascal-case",
+            "sentence-case",
+            "snake-case",
+            "start-case",
+            null
+          ],
+          "type": ["string", "null"]
+        },
+        "subjectFullStop": {
+          "default": false,
+          "description": "Forbid full stop (period) at the end of subject",
+          "type": "boolean"
+        },
+        "warningRules": {
+          "default": ["header-max-length"],
+          "description": "Rules that should be warnings (level 1) instead of errors (level 2). Ignored when strictMode is enabled",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "git": {
+      "default": {
+        "commitChanges": true,
+        "commitMessage": "chore(release): {{package}} v{{version}} [skip ci]",
+        "push": true,
+        "tagMessage": "Release {{package}} v{{version}}",
+        "useTokenForPush": false
+      },
+      "description": "Git operations configuration",
+      "properties": {
+        "beforeCommit": {
+          "description": "Command to run before creating commit (e.g., 'bun run format', 'npm run lint:fix'). Useful for formatting changed files",
+          "examples": ["bun run format", "npm run lint:fix", "prettier --write ."],
+          "type": "string"
+        },
+        "commitChanges": {
+          "default": true,
+          "description": "Create git commit with version changes",
+          "type": "boolean"
+        },
+        "commitMessage": {
+          "default": "chore(release): {{package}} v{{version}} [skip ci]",
+          "description": "Commit message template. Supports {{package}} and {{version}} placeholders",
+          "type": "string"
+        },
+        "push": {
+          "default": true,
+          "description": "Push changes and tags to remote repository",
+          "type": "boolean"
+        },
+        "tagMessage": {
+          "default": "Release {{package}} v{{version}}",
+          "description": "Git tag message template. Supports {{package}} and {{version}} placeholders",
+          "type": "string"
+        },
+        "useTokenForPush": {
+          "default": false,
+          "description": "Use GVR_TOKEN for HTTPS push instead of default git credentials. Useful for CI/CD when pushing to protected branches",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "gitverse": {
+      "default": {
+        "checkExisting": true,
+        "enabled": true,
+        "failOnError": true
+      },
+      "description": "GitVerse release creation settings",
+      "properties": {
+        "checkExisting": {
+          "default": true,
+          "description": "Check if release already exists before creating. Enables idempotent pipeline runs",
+          "type": "boolean"
+        },
+        "enabled": {
+          "default": true,
+          "description": "Enable GitVerse release creation via API. Requires GVR_TOKEN environment variable",
+          "type": "boolean"
+        },
+        "failOnError": {
+          "default": true,
+          "description": "Fail the entire release process if GitVerse release creation fails (after retries). When false, release creation errors are logged as warnings",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "monorepo": {
+      "default": {
+        "enabled": false,
+        "packages": []
+      },
+      "description": "Monorepo configuration for managing multiple packages",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "description": "Enable monorepo mode. When true, requires --package flag in CLI",
+          "type": "boolean"
+        },
+        "packages": {
+          "default": [],
+          "description": "List of packages in the monorepo",
+          "items": {
+            "properties": {
+              "changelog": {
+                "default": "CHANGELOG.md",
+                "description": "Path to CHANGELOG file relative to package directory",
+                "type": "string"
+              },
+              "name": {
+                "description": "Short package name used in CLI (e.g., 'sdk', 'release')",
+                "type": "string"
+              },
+              "packageName": {
+                "description": "Package name in package.json (e.g., 'gitverse-api-sdk')",
+                "type": "string"
+              },
+              "path": {
+                "description": "Relative path to package directory from repository root",
+                "type": "string"
+              },
+              "tagPrefix": {
+                "description": "Git tag prefix for this package (e.g., 'v', 'sdk-v', 'release-v')",
+                "type": "string"
+              }
+            },
+            "required": ["name", "path", "packageName", "tagPrefix"],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "retry": {
+      "default": {
+        "enabled": true,
+        "initialDelay": 2000,
+        "maxAttempts": 5,
+        "maxDelay": 30000,
+        "operations": ["push", "createRelease"]
+      },
+      "description": "Retry mechanism for network operations (push, API calls)",
+      "properties": {
+        "enabled": {
+          "default": true,
+          "description": "Enable retry mechanism with exponential backoff",
+          "type": "boolean"
+        },
+        "initialDelay": {
+          "default": 2000,
+          "description": "Initial delay between retries in milliseconds",
+          "maximum": 10000,
+          "minimum": 100,
+          "type": "integer"
+        },
+        "maxAttempts": {
+          "default": 5,
+          "description": "Maximum number of retry attempts",
+          "maximum": 10,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "maxDelay": {
+          "default": 30000,
+          "description": "Maximum delay between retries in milliseconds (caps exponential backoff)",
+          "maximum": 60000,
+          "minimum": 1000,
+          "type": "integer"
+        },
+        "operations": {
+          "default": ["push", "createRelease"],
+          "description": "List of operations to retry",
+          "items": {
+            "enum": ["push", "createRelease"],
+            "type": "string"
+          },
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "type": "object"
+    },
+    "versioning": {
+      "default": {
+        "allowPrerelease": false,
+        "preMajorMode": "auto",
+        "prereleasePrefix": "beta",
+        "tagPrefix": "v"
+      },
+      "description": "Semantic versioning configuration",
+      "properties": {
+        "allowPrerelease": {
+          "default": false,
+          "description": "Allow prerelease versions (e.g., 1.0.0-beta.0)",
+          "type": "boolean"
+        },
+        "preMajorMode": {
+          "default": "auto",
+          "description": "Pre-major version bump behavior for BREAKING CHANGES: 'auto' (< 1.0.0 → minor, >= 1.0.0 → major), 'enabled' (always minor), 'disabled' (always major), or version string (e.g., '2.0.0')",
+          "type": "string"
+        },
+        "prereleasePrefix": {
+          "default": "beta",
+          "description": "Prerelease identifier prefix (e.g., 'beta', 'alpha', 'rc')",
+          "type": "string"
+        },
+        "tagPrefix": {
+          "default": "v",
+          "description": "Git tag prefix (e.g., 'v', 'sdk-v'). Only used in single-package mode",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "title": "GitVerse Release Configuration",
+  "type": "object"
+}