🌼 RAPS
Download

Changelog

Release history and version changes for RAPS.

View all releases on GitHub β†’

v5.7.0

minor
Safeguard: rollback & backup script generators for 32 operations Pre-operation backup scripts capture current state Post-operation rollback scripts to undo changes Dry-run mode for script preview

Added

  • `raps safeguard rollback "<command>"` β€” generates a script that undoes the given operation
  • `raps safeguard backup "<command>"` β€” generates a script that captures current state before a destructive operation
  • `raps safeguard list` β€” shows all 32 supported reversible operations
  • Backup scripts for bucket delete: downloads all objects, saves metadata, takes snapshot manifest
  • Rollback scripts for admin user operations: add/remove/update with email and project-id mapping
  • Pipeline and sync operation backup via pre-operation snapshots
  • All generated scripts include set -euo pipefail, inline comments, chmod +x
Download v5.7.0 β†’

v5.6.2

minor
Company CRUD commands (create, get, search, update) Account user CRUD (create, get, update-account) User list shows company names instead of UUIDs Auth login expiry auto-refresh

Added

  • Company management: create, get, search, update commands
  • User create (invite) command at account level
  • User get command for fetching user details
  • User update-account command (company, status)
  • Project get command for project details
  • Company name resolution in user list table output
  • Added date column in user list
  • Status summary in user list footer

Fixed

  • Auth login expiry: auto-refresh or re-login instead of "Already logged in"
  • BIM 360 find_user_by_email now handles array response format
  • add-to-project 409 Conflict shows friendly "already a member" message
  • UpdateAccountUserRequest serialization: company assignments now persist on BIM 360
Download v5.6.2 β†’

v5.6.0

minor
Bulk Add 130x Faster BIM 360 Instant Fallback Smart Circuit Breakers Batch Project Create

Added

  • BIM 360 fallback for project creation β€” `raps admin project create` now works on both ACC and BIM 360 accounts
  • `raps admin project batch-create` command for bulk project provisioning from CSV/JSON
  • Learned BIM 360 flag: after first ACC probe failure, all subsequent calls skip the probe entirely
  • Endpoint-aware circuit breakers: `/construction/` URLs now classified as `account-admin` with bulk-tuned thresholds
  • Connection pool scaling: `pool_max_idle_per_host` now scales with concurrency level

Changed

  • MCP bulk concurrency raised from 10 to 20 for faster MCP-driven bulk operations
  • ACCβ†’BIM 360 fallback uses single probe (no retry) β€” instant detection instead of 3 retries with backoff
  • Circuit breaker threshold for bulk operations dynamically set to `(total / 4).max(20)` to prevent false trips under load

Fixed

  • Bulk user add no longer wastes 60+ seconds per project on BIM 360 accounts retrying the ACC endpoint
  • Circuit breaker no longer blocks all bulk requests by misclassifying `/construction/` URLs as generic "other" endpoint
  • Rate budget registry now includes `account-admin` known limit (100 req/min) for accurate throttling
Download v5.6.0 β†’

v5.4.8

minor
Command UX Clarity BIM 360 Auto-Routing Marketplace Plugin System URL Shortener Worker

Added

  • `raps project list` auto-routes to Admin API for BIM 360 hubs (prefix `b.`) β€” no need to use `raps admin project list` separately
  • Marketplace plugin system: install, search, list, and uninstall plugins with Ed25519 signature verification
  • `go.rapscli.xyz` URL shortener Cloudflare Worker with admin UI, collision retry, and KV storage
  • `raps object audit`, `raps object tag`, `raps lint` commands
  • `raps config wizard`, `raps snapshot create/diff/list` commands
  • `--delay-ms` flag on `raps admin user add/remove/update` for rate limiting

Changed

  • `raps folder rights` renamed to `raps folder permissions` (alias `rights` preserved)
  • `raps admin folder rights` renamed to `raps admin folder set-permissions` (alias `rights` preserved)
  • Bulk user commands (`add`, `remove`, `update`) now show `[bulk]` tag in help with cross-references to single-project equivalents
  • `raps admin --help` now states Account Administrator role requirement

Fixed

  • BIM 360 HQ v2 add-user corrected to use `/users/import` endpoint
  • Invite emails suppressed during bulk add operations
  • Silent skip on email lookup miss now properly reported
  • `--role` flag added to `add-to-project` (was missing)
  • ANSI logo suppressed on terminals without escape sequence support
  • Clap flag conflicts resolved for snapshot/pipeline commands
Download v5.4.8 β†’

v5.3.0

minor
Test Coverage Suite Coverage Dashboard RFI Scenario Tests DA/Admin Mock Coverage

Added

  • Interactive HTML test coverage dashboard (`docs/coverage-report.html`) with animated SVG gauges, tier filtering, search, and per-module collapsible sections
  • RFI CRUD scenario tests (81% line coverage): list/get/create/update/delete with JSON, table, filter, CSV import, and error path coverage
  • Admin operations scenario tests (53% line coverage): list/status/resume/cancel with isolated HOME tempdir (no APS credentials needed)
  • DA activities scenario tests: list/create/delete with JSON file, missing-field validation, alias-error paths
  • DA appbundles scenario tests: list/create/delete round-trips
  • DA workitems scenario tests: list, run qualified/unqualified, status, input/output args
  • Object copy scenario tests (40% line coverage): batch-copy empty bucket, batch-rename no matches, arg-validation, error paths
  • Config context scenario tests: show/set/clear round-trips, env var source, unknown key errors
  • WORKFLOW.md coverage policy: 10-file priority list, 40% threshold, 5-step agent workflow

Changed

  • TEST_COVERAGE_MATRIX.md updated with per-file coverage percentages across all command modules
Download v5.3.0 β†’

v5.2.0

minor
Init Wizard Status Dashboard Account Context Banner rapscli-api Worker

Added

  • `raps init` 6-step wizard: credential setup, 2-legged auth test, login, hub discovery, enterprise context, and summary
  • `raps status` command shows full context dashboard: auth state, hub tier, account, connected projects
  • Account context banner shown inline in `raps hub list` and all admin commands with HubTier classification (Personal/BIM360/ACC/Enterprise)
  • `admin user add-to-all-projects` command for bulk user provisioning
  • rapscli-api Cloudflare Worker: install script endpoint, version API (shields.io badges), URN decoder, APS status, URL shortener

Changed

  • Admin commands auto-resolve `--account` flag via hub list when omitted
  • Device code verification URL now includes `?code=XXXX-XXXX` query parameter for pre-fill
  • Device auth provides fallback plain URL when ANSI rendering is not supported

Fixed

  • Standardized exit codes across all CLI commands and SDK crates (0=success, 1=general error, 2=usage error, etc.)
Download v5.2.0 β†’

v5.1.0

minor
Device Code Auth Headless OAuth Auth Proxy Worker Non-Interactive PKCE

Added

  • Device code auth flow via Cloudflare Worker proxy at rapscli.xyz/device with short user codes (XXXX-XXXX)
  • DeviceSession Durable Object with state machine (pending β†’ authorized β†’ consumed) and 5-minute TTL cleanup
  • Landing page at rapscli.xyz/device for entering device codes from any browser on any device
  • Automatic headless detection switches to device code flow with descriptive UX messaging
  • MCP auth guidance updated with device flow instructions for headless/MCP environments

Changed

  • Device code flow no longer requires interactive stdin β€” works in fully non-interactive environments
  • Headless detection message describes new "enter code at URL" experience instead of manual URL paste

Fixed

  • Removed interactive-mode guard from device code flow that incorrectly blocked headless usage
Download v5.1.0 β†’

v5.0.0

major
Redis Distributed Cache Serverless Dispatch Webhook Gateway CI/CD Pipelines

Added

  • CacheBackend trait abstraction with MemoryBackend and feature-gated RedisBackend (deadpool connection pool)
  • Job queue via Redis Streams with 3 priority levels (critical/normal/background) and dead-letter queue
  • `raps swarm worker start` command with semaphore-based concurrency, heartbeat, and SIGTERM graceful shutdown
  • Docker Compose deployment stack (Redis, worker replicas, proxy, webhook gateway, dashboard)
  • ServerlessDispatchAgent for Fly.io Machines API with scale-to-zero
  • `--serverless` and `--notify` flags on `raps translate start`
  • `raps job` command (status, list, cancel) for managing Fly.io machine jobs
  • `raps pipeline create` with cron/webhook triggers and `.pipeline.yaml` output
  • Cloudflare Worker webhook gateway with Durable Objects event backlog (HMAC-SHA256 validation)
  • `raps webhook serve --serverless` for deploying webhook gateway via wrangler
  • `raps webhook drain` for authenticated event retrieval from gateway
  • GitHub Actions workflow example for serverless model translation
  • GitLab CI pipeline example with setup/translate/verify stages
  • Fly.io configuration with scale-to-zero and shared-cpu-2x sizing

Changed

  • `raps swarm` command now supports `worker` subcommand (feature-gated behind `redis`)
  • Translate command accepts `--serverless` flag for Fly.io dispatch instead of local processing

Fixed

  • MCP TOOLS constant synced with get_tools() (added workflow_compare_versions, workflow_setup_project)
Download v5.0.0 β†’

v5.0.0

major
Swarm Orchestration HTTP/2 Multiplexing TUI Swarm Dashboard ASVS L2 100%

Added

  • Swarm orchestration kernel: circuit breaker, retry policy, rate budget, region routing, response cache, and HTTP middleware wiring
  • API metrics collector with per-endpoint latency and error tracking
  • Structured audit logger with JSON output for swarm operations
  • Checkpoint store for durable progress checkpointing with automatic resume
  • TUI Swarm Dashboard (F8) showing circuit breakers, rate budgets, cache stats, API metrics, and checkpoints
  • Compound MCP tools: bulk_upload, bulk_download, search_and_download, upload_and_translate, translate_and_download
  • Swarm CLI commands: `raps swarm status`, `raps swarm reset`, `raps swarm run`

Changed

  • HTTP/2 multiplexing enabled with adaptive window, connection pool tuning (idle timeout 90s, max idle 10 per host), TCP keepalive (30s)
Download v5.0.0 β†’

v4.17.0

minor
Pipeline MCP Tools 105 MCP Tools Pipeline Validate Pipeline Discovery

Added

  • MCP tool `pipeline_validate` β€” validate pipeline YAML/JSON files for syntax errors
  • MCP tool `pipeline_dry_run` β€” preview pipeline execution without running commands
  • MCP tool `pipeline_run` β€” execute pipeline files with dry-run, ignore-failure, and variable options
  • MCP tool `pipeline_list_templates` β€” discover pipeline files in a directory
Download v4.17.0 β†’

v4.16.0

minor
Pipeline v2 Engine GitHub Actions GitLab CI Templates CI/CD Integrations

Added

  • Pipeline v2 engine with retry policies, timeout per step, conditional execution (if/unless), parallel steps, and for-each loops
  • Expression evaluation in pipelines: `${{ steps.id.exit_code == 0 }}`
  • Official GitHub Actions: setup, pipeline, upload, translate (dmytro-yemelianov/raps-actions)
  • Official GitLab CI templates: .raps-setup, .raps-pipeline, .raps-upload, .raps-translate

Changed

  • Pipeline YAML format extended with v2 fields while maintaining backward compatibility with v1 format
Download v4.16.0 β†’

v4.15.0

minor
ASVS Security npm Fix Path Traversal Log Redaction

Added

  • Path traversal protection for all download operations (sanitize_filename, validate_path_within, safe_join)
  • Automatic log redaction via RedactingMakeWriter for Bearer tokens, cookies, API keys, URL params
  • Restricted directory permissions (0o700) for log and config directories

Changed

  • Extended log redaction patterns: Authorization headers, Cookie headers, X-API-Key, URL query params
  • Pipeline variable injection hardening with shell metacharacter validation

Fixed

  • npm publishing pipeline β€” all 5 platform binary packages now correctly listed in optionalDependencies
  • Auth error messages now redact sensitive text before logging
Download v4.15.0 β†’

v4.14.0

minor
API Health Tracking Live Progress Spinners Headless Auth Major Refactor

Added

  • Live progress spinners with API health and latency tracking across all commands
  • Streaming bucket listing per-region with concurrent fetching
  • Headless environment detection for `auth login` β€” auto-switches to device code flow on SSH, CI, containers
  • Unix pipe support (stdin/stdout) across CLI commands
  • Manual PKCE-based device code flow replacing broken browser-based flow

Changed

  • Major refactor: split MCP server.rs (6,312 lines) into 8 focused modules
  • Split 14 monolithic files into focused modules across all crates
  • Improved keychain fallback warnings with actionable guidance
  • Comprehensive MCP server review fixes (20 issues)

Fixed

  • Validate empty auth code input and reset refreshing flag on error
  • Validate client credentials before auth operations
  • Device code flow replaced with working PKCE-based implementation
Download v4.14.0 β†’

v4.13.0

minor
API Bug Fixes Code Quality Review Findings Stability

Fixed

  • Resolved 6 API alignment bugs including 2 blocking and 4 high severity issues
  • Resolved 11 medium and low severity review findings across codebase
Download v4.13.0 β†’

v4.12.0

minor
AEC GraphQL TUI Dashboard 7 Tabs 33 Views

Added

  • AEC GraphQL API for faster hubs/projects loading with REST fallback
  • Expanded TUI Dashboard from 4 to 7 tabs with 33 views

Changed

  • Dashboard made optional behind `--features dashboard` flag to reduce default binary size
Download v4.12.0 β†’

v4.11.0

minor
101 MCP Tools Code Hardening Auth Safety UX Improvements

Added

  • 29 new MCP tools bringing total to 101: project CRUD, user management, template convert, and more

Changed

  • Improved robustness, UX safety, and code quality across 18 findings
  • Hardened error handling and auth safety across all crates
Download v4.11.0 β†’

v4.9.0

minor
Profiler Overhaul Structured Logging JSON Log Format Env Config

Changed

  • Overhauled profiler accuracy, tracking, and reporting
  • Enhanced logging with structured fields and JSON file format
  • Environment variable configuration for log levels
Download v4.9.0 β†’

v4.8.0

minor
Tracing Logging Performance Profiler Reedline Shell Keychain Fallback

Added

  • Tracing-based structured logging across all crates
  • Performance profiler for command execution timing
  • Resilient keychain fallback for token storage

Changed

  • Switched interactive shell from rustyline to reedline for better UX
  • Improved logging infrastructure with configurable verbosity
Download v4.8.0 β†’

v4.7.0

minor
6 Auth Presets -p Short Flag Viewer/Editor/Admin Storage/Automation

Added

  • 5 new auth login presets: viewer, editor, storage, automation, admin
  • `-p` short flag for `--preset`
Download v4.7.0 β†’

v4.6.0

minor
Auth Presets DA Auto-Qualification 9 New Doc Pages Full CLI Docs

Added

  • Auth `--preset all` flag for non-interactive scope selection
  • DA auto-qualification of bare bundle/activity names with owner nickname
  • DA auto-creation of "default" alias after bundle/activity creation
  • 9 new docs pages: webhooks, design-automation, issues, acc-modules, rfis, reality-capture, plugins, generate, completions

Fixed

  • DA `appbundle-create` deserialization error (Optional `endpointUrl`)
  • DA `activity-create` and `run` "Cannot parse id" for bare names
  • Pipeline sample template bucket create syntax
  • DA `workitems` startAfterTime format
Download v4.6.0 β†’

v4.5.0

minor
HTTP Retry Faster Buckets Flag Conflict Fix Company List

Added

  • Automatic HTTP retry on 429/5xx with exponential backoff
  • New `admin company-list` command
  • New docs pages for api, report, and template commands

Changed

  • Reduced bucket list per-region timeout from 30s to 10s
  • Simplified report.rs and admin.rs modules

Fixed

  • Clap `-o`/`--output` flag conflict causing panics
  • Status counting bug in admin operations
Download v4.5.0 β†’

v4.4.0

minor
51 MCP Tools Folder Permissions Operation Lifecycle Full ACC CRUD

Added

  • 14 new MCP tools bringing total to 51
  • Bulk folder permission management with `admin_folder_rights`
  • Operation lifecycle tools: `admin_operation_resume`, `admin_operation_cancel`
  • Full RFI CRUD: `rfi_create`, `rfi_update`
  • Full Assets CRUD: `asset_create`, `asset_update`, `asset_delete`
  • Full Submittals CRUD: `submittal_create`, `submittal_update`
  • Full Checklists CRUD: `checklist_create`, `checklist_update`
  • Support for all permission levels (ViewOnly, ViewDownload, UploadOnly, ViewDownloadUpload, ViewDownloadUploadEdit, FolderControl)
  • Support for folder types (ProjectFiles, Plans, Custom paths)

Changed

  • Enhanced `admin_project_list` with advanced filter expressions
  • Improved auth guidance for new tool categories
  • Updated tool availability summary with new tool groups
Download v4.4.0 β†’

v4.3.0

minor
Python Package PyPI Distribution Python Bindings

Added

  • Python package `raps-aps` available on PyPI
  • Python bindings for RAPS core functionality
  • Cross-language support for Python developers
  • pip installation support

Changed

  • Improved distribution channels
  • Enhanced cross-platform compatibility
Download v4.3.0 β†’

v3.8.0

minor
Interactive Shell Rust 2024 Edition TAB Completion Parameter Hints

Added

  • Interactive Shell mode with REPL for executing commands without retyping `raps`
  • TAB completion for commands, subcommands, and arguments
  • Parameter hints showing available options as you type
  • Command history with arrow key navigation
  • Fuzzy search for command discovery

Changed

  • Migrated to Rust 2024 Edition for improved language features
  • Updated minimum supported Rust version (MSRV) to 1.88
  • Enhanced MCP server stability with better argument validation
  • Improved error messages across all commands

Fixed

  • MCP server tool invocation with stricter argument validation
  • Cached APS client instances to reduce lock contention
  • Output format validation in MCP tools
Download v3.8.0 β†’

v3.7.0

minor
Major Security Improvements Performance Boost Parallel Uploads Secure Token Storage

Added

  • Parallel multipart uploads with 3-10x speed improvement for large files
  • Secure token storage with OS keychain as default
  • Comprehensive security tests for plugin system
  • Token migration helper for moving to secure storage
  • JSON/YAML/CSV output support for issue commands
  • Streaming file operations to reduce memory usage

Changed

  • Keychain storage is now the default instead of plaintext files
  • Plugin hooks now use command whitelisting for security
  • Consistent retry logic applied across all HTTP operations
  • Enhanced configuration with profile-based keychain settings

Fixed

  • Critical: Command injection vulnerability in plugin hooks
  • Critical: Plaintext token storage replaced with encrypted keychain
  • Output format bug in issue list command now supports all formats
  • Unsafe environment variable manipulation replaced with safe alternatives
  • Memory buffering issues with large file uploads
Download v3.7.0 β†’

v3.4.0

minor
Version Display Fix OAuth Callback Improvements Windows Compatibility

Added

  • Automatic port fallback system for OAuth callback server with RAPS-themed ports (12495, 7495, 9247)
  • Intelligent port selection with helpful error messages when ports are unavailable

Changed

  • OAuth callback server binding changed from 0.0.0.0 to 127.0.0.1 for better Windows localhost support
  • Updated logo reference in README from PNG to WebP format

Fixed

  • Version display now automatically syncs with Cargo.toml using env!("CARGO_PKG_VERSION")
  • Windows compatibility for OAuth callback server
Download v3.4.0 β†’

v3.1.0

minor
Rust 2024 Edition CI Speedups Command Dispatch Fix

Added

  • Comprehensive command dispatch tests (19 tests covering all subcommands)
  • `cargo-nextest` for parallel test execution in CI
  • `sccache` for build caching in release workflows
  • Parallel build jobs in CI with `lld` linker for faster builds

Changed

  • Migrated to Rust 2024 Edition
  • Updated MSRV to Rust 1.88
  • Wrapped `std::env::set_var/remove_var` in `unsafe` blocks (Rust 2024 requirement)
  • Use `div_ceil` instead of manual ceiling division

Fixed

  • Critical bug: `raps auth test` and other commands panicking with "unreachable code"
  • Command dispatch logic that was corrupting CLI state
Download v3.1.0 β†’

v3.0.0

major
MCP Server AI Assistant Integration 14 MCP Tools

Added

  • MCP (Model Context Protocol) server for AI assistant integration
  • Support for Claude Desktop, Cursor IDE, and other MCP clients
  • 14 MCP tools: auth_test, auth_status, bucket_list, bucket_create, bucket_get, bucket_delete, object_list, object_delete, object_signed_url, object_urn, translate_start, translate_status, hub_list, project_list
  • Natural language APS operations via AI assistants
  • New `raps serve` command to start the MCP server

Changed

  • Added Serialize derive to API response types for MCP JSON serialization
  • Updated documentation with MCP server setup guides
Download v3.0.0 β†’

v2.1.0

minor
Stability improvements Bug fixes Documentation updates

Added

  • Improved error messages for common authentication issues
  • Better progress indicators for long-running operations

Changed

  • Updated dependencies to latest versions
  • Improved documentation and examples

Fixed

  • Fixed edge case in token refresh during concurrent requests
  • Resolved issue with special characters in file paths
Download v2.1.0 β†’

v2.0.0

major
ACC Checklists support Plugin system Pipeline automation improvements

Added

  • ACC Checklists module with full CRUD operations
  • Plugin system for external extensions
  • Command aliases for frequent operations
  • Test data generation (`raps generate`)
  • Demo scenarios (`raps demo`)

Changed

  • Improved pipeline execution with better error reporting
  • Enhanced authentication flow with device-code support
  • Updated to latest APS API versions

Fixed

  • Token refresh race condition in concurrent operations
  • Large file upload progress reporting accuracy
  • JSON output formatting for nested objects
Download v2.0.0 β†’

v1.0.0

major
First stable release Complete APS API coverage CI/CD ready

Added

  • Authentication (2-legged, 3-legged, device-code, token)
  • Object Storage Service (buckets, objects, signed URLs)
  • Model Derivative (translation, manifests, derivatives)
  • Data Management (hubs, projects, folders, items)
  • Webhooks (create, list, delete, test)
  • Design Automation (engines, activities, work items)
  • ACC Issues (CRUD, comments, attachments)
  • ACC RFIs (CRUD, status management)
  • ACC Assets (CRUD, categories)
  • ACC Submittals (CRUD)
  • Reality Capture (photoscenes, processing)
  • Pipeline automation (YAML/JSON definitions)
  • Multiple output formats (JSON, YAML, CSV, table)
  • Shell completions (bash, zsh, fish, PowerShell, elvish)
Download v1.0.0 β†’