Change Log

​

Kodexa CLI v0.5.2

• Increased Client Timeout: Extended HTTP client timeout from 60 seconds to 10 minutes (600s) to prevent premature failures during long-running deployment operations, particularly beneficial for large manifest deployments, multiple resource/module deployments, and deployments to slow or distant environments
• Improved Branch Mapping Error Handling: Changed behavior when no branch mapping is found - now displays informational message and exits gracefully instead of returning error, providing better UX when working on unmapped branches

• Better CI/CD Integration: Non-disruptive behavior when working on unmapped branches doesn’t fail pipelines unnecessarily
• Clearer User Feedback: Informational messages clearly distinguish between configuration issues and actual errors
• Enhanced Reliability: Deployments that previously failed due to timeout will now complete successfully

• Prevents deployment timeouts for operations with large manifests or multiple resources
• Better user experience when working with selective branch mapping configurations
• More reliable long-running deployment operations

• macOS (Intel)
• macOS (Apple Silicon)
• Linux (x86_64)
• Linux (ARM64)
• Windows (x86_64)

​

Kodexa Sync Action v2.2.0

• Slack Notifications: Send rich deployment summaries to Slack automatically with slack-channel-id and slack-token inputs
• GitHub Job Summary: Add deployment summary to workflow run with annotate-summary: true
• Renamed Input: workers → threads to match kdx-cli flag naming

• 🚀 Deployment status (or 🔍 for dry runs)
• Repository and branch information
• Resource counts (created, updated, unchanged)
• Direct link to the GitHub Actions run

- uses: kodexa-ai/kdx-sync-action@v2
  with:
    threads: 8
    annotate-summary: true
    slack-channel-id: $\{{ secrets.SLACK_CHANNEL_ID }}
    slack-token: $\{{ secrets.SLACK_BOT_TOKEN }}
  env:
    KODEXA_PROD_API_KEY: $\{{ secrets.KODEXA_PROD_API_KEY }}

​

Kodexa CLI v0.5.0

• Tag-Based Deployment Mappings: Deploy using git tags in addition to branches, enabling release-driven workflows with tag_mappings configuration supporting semantic versions, release candidates, and preview tags
• Manual Deployment Overrides: New --branch and --tag flags provide explicit control over deployment routing without requiring git operations, perfect for CI/CD, testing, and rollback scenarios
• JSON Deployment Reports: Generate structured JSON reports of deployment actions with --json-report <path> for CI/CD integration
• Parallel Resource Deployment: New --threads <n> flag for configuring parallel threads during resource deployment - significantly faster for large deployments
• Resource Filtering: Filter resources during deployment with --filter <pattern> for selective deployments

• Enhanced Error Messages: Clear, actionable error messages with hints when mappings are not found
• Better User Feedback: Deployment mode indicators showing whether using branch detection, tag detection, or manual override
• Improved Mapping Resolution: Support for multiple overlapping mappings, enabling sophisticated multi-environment deployment strategies

# Deploy with JSON report
kdx sync deploy --json-report ./deploy-report.json

# Deploy with parallel threads (8)
kdx sync deploy --threads 8

# Deploy specific tag mapping
kdx sync deploy --tag v1.0.0

# Filter resources during deployment
kdx sync deploy --filter "invoice-*"

branch_mappings:
  - pattern: "main"
    target: production
    environment: prod

tag_mappings:
  - pattern: "v*"
    target: production
    environment: prod
  - pattern: "rc-*"
    target: staging
    environment: staging

• macOS (Intel)
• macOS (Apple Silicon)
• Linux (x86_64)
• Linux (ARM64)
• Windows (x86_64)

​

Kodexa CLI v0.4.1

• Enhanced Client Debugging: Added detailed API request/response logging when debug mode is enabled, providing comprehensive information for troubleshooting
• Improved Module Syncing: Updated module syncing to build and display full slugs with organization prefixes, improving clarity in logs and progress reporting
• Enhanced Deployment Output: Deployment command now includes the environment URL in planned deployment messages, providing clearer context for users
• Alternate Extension Support: Added support for both .yaml and .yml extensions when reading resource files, with improved error hints showing all attempted file paths

• Better Error Messages: Error messages now reference full slugs with organization prefixes, making it easier to identify and debug issues
• Improved Error Handling: Enhanced deployment error handling to capture and report errors without terminating the process immediately
• Robust Payload Handling: New utility function to safely extract string values from interface types
• Debug Mode Formatting: Conditionally display full response bodies based on debug mode for cleaner output in normal operation

• Fixed gofmt formatting in resource_types_test.go

• macOS (Intel)
• macOS (Apple Silicon)
• Linux (x86_64)
• Linux (ARM64)
• Windows (x86_64)

​

Kodexa CLI v0.3.0

• Knowledge Set Support: New knowledgeset resource type with full CRUD operations, including example configurations for financial knowledge sets and full support in metadata API and sync operations
• Immutable Resource Types: Added support for immutable resources (featuretype and featureinstance) that cannot be modified once created, maintaining database integrity. Sync operations automatically skip updates for immutable resources with appropriate warnings

• macOS (Intel)
• macOS (Apple Silicon)
• Linux (x86_64)
• Linux (ARM64)
• Windows (x86_64)