Change Log

​

KDX CLI v2026.2.1

• Project-Scoped Resource Sync: Fixed an issue where syncing project-scoped resources (e.g., task templates) would fail with “TaskTemplate must have a project” errors. The PUT payload now correctly includes the project reference for project-scoped resources, mirroring the existing pattern for organization-scoped resources.
• OpenAPI Schema Parsing: The CLI now gracefully handles missing $ref schema references in the server’s OpenAPI specification. When broken references are encountered (e.g., a missing ValidationFailedResponse), the CLI patches in empty object stubs and retries parsing instead of failing.

• Task template and other project-scoped resource syncing now works correctly with kdx sync push and kdx sync deploy
• CLI operations no longer fail when the platform’s OpenAPI spec contains missing schema definitions

​

KDX CLI v2026.2.0

• kdx document stats - Document statistics summary
• kdx document schema - Display document schema
• kdx document tags - List and inspect tags
• kdx document features - List and inspect features
• kdx document node - Inspect individual nodes
• kdx document text - Extract text content
• kdx document page - Page-level operations
• kdx document find - Multi-criteria search across nodes
• kdx document spatial find - Spatial search by coordinates
• kdx document spatial bbox - Bounding box queries
• kdx document data objects - List data objects
• kdx document data attributes - List data attributes
• kdx document data exceptions - List data exceptions
• kdx document audit - View audit trail entries

• kdx knowledge attach - Attach files to knowledge sets
• kdx knowledge download - Download knowledge set items
• attachmentPath support in kdx sync for knowledge items

• kdx get module <slug> --download - Download module implementation packages directly

• Project-scoped resources with auto-pull for task templates
• Graceful handling of missing files in pull operations

# Document inspection with enriched output
kdx document stats invoice.kddb
kdx document find invoice.kddb --type paragraph --content "total"
kdx document spatial bbox invoice.kddb --page 1 --x1 0 --y1 0 --x2 500 --y2 200
kdx document audit invoice.kddb

# Knowledge management
kdx knowledge attach my-org/knowledge-set:1.0.0 ./data.csv
kdx knowledge download my-org/knowledge-set:1.0.0 item-id -o output.csv

# Module download
kdx get module my-org/my-model:1.0.0 --download

​

KDX CLI v0.6.0

• Document Family Content Commands: New kdx document-family content subcommand for direct access to content objects (kddb files) within document families:
  • kdx document-family content list - List all content objects with IDs, timestamps, and labels
  • kdx document-family content download - Download kddb files directly, bypassing DFM export timeouts
  • --latest flag - Automatically select the most recent content object
  • --output flag - Specify custom output filename
• Store Upload & Watch Commands: New commands for document upload and processing workflows:
  • kdx store upload - Upload files (PDF, images, documents) to document stores
  • kdx store watch - Monitor document processing progress with real-time status updates
  • --label flag - Wait for specific processing labels (PREPARED, FIRST-PASS, LABELED, PROCESSED)
  • --timeout flag - Configure wait timeout for long-running processing

• Project Create Organization Lookup: Fixed organization resolution when creating projects from templates
• Dynamic API Flags: Improved handling of dynamic flags for kdx run operations
• Document Family Data Export: Fixed data export to always use latest content object

# List content objects in a document family
kdx document-family content list 70b894f5-8d32-4584-b780-89f89210e078

# Download the latest kddb file
kdx document-family content download 70b894f5-8d32-4584-b780-89f89210e078 --latest -o document.kddb

# Upload and monitor processing
kdx store upload satori/project-processing:1.0.0 ./report.pdf
kdx store watch abc123 --label PROCESSED --timeout 600

• Document Family Commands
• Store Commands

​

v8 Documentation Preview

• kdx document info - Display document summary with metadata and statistics
• kdx document print - Pretty print document structure as an ASCII tree with depth limiting and feature display
• kdx document select - Query nodes by type using selector syntax
• kdx document natives list/extract - List and extract embedded files (PDFs, images, etc.)
• kdx document external list/get/set/delete - Manage key-value external data store
• kdx document metadata get/set - View and modify document metadata

# Quick document inspection
kdx document info invoice.kddb
kdx document print invoice.kddb --depth 3
kdx document select invoice.kddb "//paragraph"

# Extract embedded PDF
kdx document natives extract invoice.kddb original.pdf -o extracted.pdf

• Native Documents: Store and retrieve binary files within KDDB documents
• External Data: Flexible key-value store for custom data and processing results
• Metadata: Document properties including UUID, version, and custom fields
• Content Nodes: Hierarchical document structure with types and content
• Selectors: XPath-like query syntax for finding nodes

• CLI Document Commands
• SDK Native Documents
• SDK External Data
• SDK Metadata

​

Kodexa Document SDK v8.0.0

• SDK Documentation Tab: Added a dedicated SDK section to the developer portal with comprehensive guides for Python and TypeScript
• Python Getting Started: Complete guide covering installation, document creation, node manipulation, selectors, features, tags, and saving
• TypeScript Getting Started: Full guide including WASM initialization, async patterns, memory management, and browser/Node.js setup

• High-performance document processing via Go backend with CFFI bindings
• ~100x faster in-memory mode for processing pipelines
• Full support for KDDB format, hierarchical nodes, features, tags, and XPath-like selectors
• Context manager support for automatic resource cleanup

pip install kodexa-document

• WebAssembly-powered SDK for Node.js and modern browsers
• ~5x faster than pure JavaScript implementations
• Full async API with TypeScript type safety
• Works with both file-based and in-browser SQLite

npm install @kodexa-ai/document-wasm-ts

• Create, load, and save KDDB documents
• Hierarchical ContentNode tree structure
• XPath-like selector queries
• Features (key-value metadata) and Tags (annotations with confidence)
• JSON and binary export formats

• Python SDK Documentation
• TypeScript SDK Documentation
• PyPI - kodexa-document
• npm - @kodexa-ai/document-wasm-ts

​

KDX 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 }}

​

KDX 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)

​

KDX 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)

​

KDX 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)