Changelog

All notable changes to the Turqoa platform are documented on this page. Releases follow semantic versioning (MAJOR.MINOR.PATCH). Each release includes a summary of new features, improvements, bug fixes, and any breaking changes.

Version History Format

Major versions (e.g., 3.0.0) introduce significant new capabilities or breaking changes requiring migration.
Minor versions (e.g., 3.1.0) add new features and improvements that are backward-compatible.
Patch versions (e.g., 3.1.1) contain bug fixes and security patches only.

v3.2.0 --- 2026-03-20

New Features

Drone patrol scheduling --- Define recurring drone patrol routes with configurable intervals and zone coverage. Patrols execute automatically during configured hours.
Enhanced damage detection model (v2.8) --- New AI model with 23% improvement in detecting structural container damage. Reduced false positive rate by 40% on cosmetic damage.
Bulk transaction export --- Export gate transactions in bulk as CSV or JSON from the Command Center. Supports date range, lane, and status filters.
OIDC group sync --- SSO role mapping now supports nested group claims from OIDC providers. Groups are synced on each login when update_on_login is enabled.

Improvements

Gate transaction processing latency reduced from 3.2s to 2.4s (average) through inference pipeline optimization.
Command Center dashboard now loads 50% faster with lazy-loaded camera feeds.
Audit log query performance improved for time-range queries exceeding 30 days.
Camera auto-discovery now detects firmware version and flags cameras with known vulnerabilities.

Bug Fixes

Fixed an issue where OCR confidence scores were not displayed for chassis ID reads.
Resolved a race condition in the Decision Engine when two transactions for the same container were processed simultaneously.
Fixed shift handover notes not persisting when the session timed out during editing.
Corrected timezone display in the audit log export for terminals in UTC+ offsets.

v3.1.0 --- 2026-01-15

New Features

Maritime vessel tracking --- Real-time AIS-based vessel tracking integrated into the Command Center. Displays vessel name, heading, speed, and ETA at berth.
Configurable decision modes per lane --- Each gate lane can now independently operate in Shadow, Advisory, or Live mode. Previously this was a system-wide setting.
Incident replay --- Security operators can replay incident timelines with synchronized multi-camera playback and AI overlay visualization.
SCIM 2.0 user provisioning --- Support for automated user and group synchronization from identity providers via SCIM.

Improvements

TOS adapter now supports Navis N4 v3.10 API endpoints.
Hazmat placard detection accuracy improved by 18% with expanded training data.
Command Center now supports dark mode (toggle in user preferences).
Reduced GPU memory usage for the seal detection model by 15%.

Bug Fixes

Fixed camera stream reconnection logic that caused a 30-second delay after network interruptions.
Resolved an issue where deactivated users could still access the API with existing tokens.
Fixed incorrect gate throughput calculation when lanes were taken offline mid-shift.
Corrected SAML assertion validation that rejected valid assertions with clock skew > 60s.

v3.0.0 --- 2025-10-01

New Features

Complete platform redesign --- New Command Center UI built for multi-monitor setups and high-density information display.
Decision Engine v2 --- Rewritten rule engine with support for composite conditions, weighted scoring, and configurable decision trees.
Terminal Security module --- AI-driven perimeter monitoring with zone-based intrusion detection and automated alerting.
Drone Verification module --- Autonomous drone integration for yard audits, incident response, and aerial inspection.
Hybrid deployment model --- On-premise AI inference with cloud-based management plane for multi-terminal operations.

Breaking Changes

Action required: Review the migration guide before upgrading from v2.x.

Change	Impact	Migration
Decision Engine rule format changed from JSON to YAML	All custom rules must be converted	Run `turqoa migrate rules --from json --to yaml`
API v1 endpoints deprecated and removed	API consumers must update to v2 endpoints	See API Migration Guide
Database schema v3 requires migration	Downtime required for schema migration	Run `turqoa db migrate --to v3` (estimated: 5-15 min)
Camera configuration moved from file to database	Camera configs must be re-imported	Run `turqoa cameras import --from /etc/turqoa/cameras.yaml`
Minimum GPU requirement changed to NVIDIA T4	Older GPUs (P4, K80) no longer supported	Hardware upgrade required

Migration from v2.x

# 1. Back up the database
turqoa db backup --output /backups/pre-v3-migration.sql

# 2. Update Turqoa
turqoa update --version 3.0.0

# 3. Run database migration
turqoa db migrate --to v3

# 4. Convert decision rules
turqoa migrate rules --from json --to yaml

# 5. Re-import camera configurations
turqoa cameras import --from /etc/turqoa/cameras.yaml

# 6. Verify the deployment
turqoa diagnose

Improvements

End-to-end gate transaction latency reduced by 35% compared to v2.x.
Support for up to 24 gate lanes per deployment (previously 12).
Audit log now uses cryptographic chaining for tamper evidence.

Bug Fixes

Resolved memory leak in the camera stream ingestion service under sustained high load.
Fixed incorrect container number parsing for non-ISO container codes.
Corrected time zone handling in shift reports for terminals spanning multiple zones.

Previous Releases

For changelog entries prior to v3.0.0, see the archived changelog.