🌼 RAPS
Завантажити
Ця сторінка ще не перекладена українською. Показано англійську версію. Переглянути англійською

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 →