Orchestrata Ultimate / RTM / 004-cxp
RTM: 004-cxp
Requirement to symbol to test rows for 004-cxp: CXP Protocol (Cross-agent eXchange Protocol).
At a glance
| Item | Value |
|---|---|
| Requirement IDs | 273 |
Traced from src/ |
203 (74.4%) |
| Untraced | 70 |
Cited from tests/ |
2 (0.7%) |
Traced in src/ but not cited from tests/ |
201 |
Reading this matrix
This matrix lists each of the 273 requirement IDs of spec 004-cxp with the src/ symbols that cite it and the tests that cite it. 203 of them (74.4%) have at least one citing symbol and 70 have none.
2 requirements are also cited from tests/, and 201 are traced in code but never named by a test. A test citation is a @traces on a test function; it shows intent to cover, not that the test runs or reaches the symbol.
Rows showing none in the symbols column are the gaps to close first. The densest untraced groups are REQ-004-US-010 (10), REQ-004-US-005 (9), REQ-004-US-001 (7).
Requirement to symbols to tests
| Requirement | Symbols in src/ |
Tests citing it |
|---|---|---|
REQ-004-US-001-001 Define CXPPacket base class with all required fields |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet _init_from_fields L217 |
none |
REQ-004-US-001-002 Implement message_id as UUID string |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/deterministic_ids generate_deterministic_id L27+1 more |
none |
REQ-004-US-001-003 Implement from_agent as Volk alias string |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/interfaces from_agent L61 |
none |
REQ-004-US-001-004 Implement to_agent as Volk alias string |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/interfaces to_agent L69 |
none |
REQ-004-US-001-005 Implement thread_id as string identifier |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/interfaces thread_id L77 |
none |
REQ-004-US-001-006 Implement subject as string (max 200 chars) |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/interfaces subject L85 |
none |
REQ-004-US-001-007 Implement payload as generic object (dict or bytes) |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/interfaces payload L93 |
none |
REQ-004-US-001-008 Implement timestamp as ISO8601 string |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97orchestrata_ultimate/cxp/interfaces timestamp L101 |
none |
REQ-004-US-001-009 Implement priority as integer (0-10 range) |
orchestrata_ultimate/core/packet/enums Priority L110orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/core/packet/packet __init__ L97+1 more |
none |
REQ-004-US-001-010 Implement delivery_status enum (queued, delivered, acknowledged, failed) |
orchestrata_ultimate/core/packet/enums DeliveryStatus L33orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/cxp/interfaces delivery_status L117 |
none |
REQ-004-US-001-011 Implement work_status enum (pending, in_progress, resolved, archived) |
orchestrata_ultimate/core/packet/enums WorkStatus L73orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/cxp/interfaces work_status L125 |
none |
REQ-004-US-001-012 Implement protocol_version as semver string |
orchestrata_ultimate/core/packet/packet CXPPacket L68orchestrata_ultimate/cxp/interfaces protocol_version L133orchestrata_ultimate/cxp/version ProtocolVersion L16 |
none |
REQ-004-US-001-013 Validate message_id is valid UUID |
orchestrata_ultimate/cxp/headers validate_uuid L101 |
none |
REQ-004-US-001-014 Validate from_agent matches Volk alias pattern (U:[A-Z][a-z]) |
orchestrata_ultimate/cxp/headers validate_volk_alias L116orchestrata_ultimate/cxp/validator _check_sender L177 |
none |
REQ-004-US-001-015 Validate to_agent matches Volk alias pattern |
orchestrata_ultimate/cxp/headers validate_volk_alias L116orchestrata_ultimate/cxp/validator _check_recipient L188 |
none |
REQ-004-US-001-016 Validate thread_id is non-empty string |
none | none |
REQ-004-US-001-017 Validate subject is non-empty string |
orchestrata_ultimate/cxp/headers validate_subject L131orchestrata_ultimate/cxp/validator _check_subject L235 |
none |
REQ-004-US-001-018 Validate subject length ≤200 characters |
orchestrata_ultimate/cxp/headers validate_subject L131 |
none |
REQ-004-US-001-019 Validate payload is valid JSON or bytes |
orchestrata_ultimate/cxp/validator _check_payload L199 |
none |
REQ-004-US-001-020 Validate timestamp is valid ISO8601 |
none | none |
REQ-004-US-001-021 Validate priority is integer 0-10 |
none | none |
REQ-004-US-001-022 Validate delivery_status is valid enum value |
none | none |
REQ-004-US-001-023 Validate work_status is valid enum value |
none | none |
REQ-004-US-001-024 Validate protocol_version is valid semver |
orchestrata_ultimate/cxp/version __init__ L24 |
none |
REQ-004-US-001-025 Add type hints to all packet fields |
orchestrata_ultimate/cxp/interfaces IPacket L40 |
none |
REQ-004-US-001-026 Use Pydantic for runtime validation |
none | none |
REQ-004-US-001-027 Implement init with field validation |
orchestrata_ultimate/core/packet/packet __init__ L97 |
none |
REQ-004-US-001-028 Implement repr for debugging |
orchestrata_ultimate/core/packet/packet __repr__ L711 |
none |
REQ-004-US-001-029 Implement eq for comparison |
orchestrata_ultimate/core/packet/packet __eq__ L722 |
none |
REQ-004-US-001-030 Implement hash for dict keys |
none | none |
REQ-004-US-002-001 Implement get_headers() method returning dict |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/core/packet/packet get_headers L426orchestrata_ultimate/cxp/headers HeaderManager L256+3 more |
none |
REQ-004-US-002-002 Extract message_id to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-003 Extract from_agent to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-004 Extract to_agent to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-005 Extract thread_id to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-006 Extract subject to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-007 Extract timestamp to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-008 Extract priority to header |
orchestrata_ultimate/core/packet/compat get L341orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-009 Extract delivery_status to header |
orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-010 Extract work_status to header |
orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-011 Extract protocol_version to header |
orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-012 Header extraction completes in <1ms |
orchestrata_ultimate/cxp/headers get_headers L270 |
none |
REQ-004-US-002-013 Validate all required headers present |
orchestrata_ultimate/cxp/headers HeaderManager L256orchestrata_ultimate/cxp/headers validate_all_headers L371 |
none |
REQ-004-US-002-014 Validate header types are correct |
orchestrata_ultimate/cxp/headers validate_header L340 |
none |
REQ-004-US-002-015 Validate header values are non-empty |
orchestrata_ultimate/core/packet/packet _validate L268orchestrata_ultimate/cxp/headers validate_all_headers L371 |
none |
REQ-004-US-002-016 Reject packets with missing headers |
orchestrata_ultimate/cxp/headers validate_all_headers L371 |
none |
REQ-004-US-002-017 Reject packets with invalid header types |
orchestrata_ultimate/cxp/exceptions FieldValidationError L126orchestrata_ultimate/cxp/headers validate_all_headers L371 |
none |
REQ-004-US-002-018 Provide detailed error messages for invalid headers |
orchestrata_ultimate/cxp/exceptions FieldValidationError L126 |
none |
REQ-004-US-002-019 Implement set_delivery_status() method |
orchestrata_ultimate/cxp/headers set_delivery_status L435 |
none |
REQ-004-US-002-020 Implement set_work_status() method |
orchestrata_ultimate/cxp/headers set_work_status L480 |
none |
REQ-004-US-002-021 Implement set_priority() method |
orchestrata_ultimate/cxp/headers set_priority L404 |
none |
REQ-004-US-002-022 Validate new status values |
orchestrata_ultimate/cxp/headers set_delivery_status L435orchestrata_ultimate/cxp/headers set_work_status L480 |
none |
REQ-004-US-002-023 Prevent modification of immutable headers (message_id, from_agent, to_agent) |
none | none |
REQ-004-US-002-024 Update timestamp on header modification |
none | none |
REQ-004-US-003-001 Support JSON object payloads |
orchestrata_ultimate/cxp/payload PayloadManager L51 |
none |
REQ-004-US-003-002 Support JSON array payloads |
orchestrata_ultimate/cxp/payload set_payload L207 |
none |
REQ-004-US-003-003 Support nested JSON structures |
orchestrata_ultimate/cxp/payload set_payload L207 |
none |
REQ-004-US-003-004 Validate JSON schema when provided |
orchestrata_ultimate/cxp/validator validate_schema L126 |
none |
REQ-004-US-003-005 Handle JSON serialization errors gracefully |
orchestrata_ultimate/cxp/exceptions SerializationError L72orchestrata_ultimate/cxp/json_serializer to_json L166 |
none |
REQ-004-US-003-006 Support Unicode in JSON payloads |
none | none |
REQ-004-US-003-007 Limit JSON payload size to 10MB |
orchestrata_ultimate/cxp/payload get_payload_size L341orchestrata_ultimate/cxp/payload validate_payload_size L377 |
none |
REQ-004-US-003-008 Support binary payloads (bytes) |
orchestrata_ultimate/cxp/payload PayloadManager L51orchestrata_ultimate/cxp/payload _set_binary_payload L452 |
none |
REQ-004-US-003-009 Encode binary as base64 for transport |
orchestrata_ultimate/cxp/json_serializer CXPEncoder L34orchestrata_ultimate/cxp/json_serializer default L55 |
none |
REQ-004-US-003-010 Decode base64 to binary on receipt |
orchestrata_ultimate/cxp/json_serializer _decode_bytes_hook L96orchestrata_ultimate/cxp/json_serializer from_json L216 |
none |
REQ-004-US-003-011 Validate binary payload size ≤100MB |
orchestrata_ultimate/cxp/payload get_payload_size L341orchestrata_ultimate/cxp/payload validate_payload_size L377 |
none |
REQ-004-US-003-012 Support content-type metadata for binary |
orchestrata_ultimate/cxp/payload _is_json_content_type L515orchestrata_ultimate/cxp/payload get_content_type L312 |
none |
REQ-004-US-003-013 Handle binary encoding errors gracefully |
orchestrata_ultimate/cxp/exceptions SerializationError L72orchestrata_ultimate/cxp/payload _set_binary_payload L452 |
none |
REQ-004-US-003-014 Validate payload is not None |
none | none |
REQ-004-US-003-015 Validate payload type (dict or bytes) |
orchestrata_ultimate/cxp/validator _check_payload L199 |
none |
REQ-004-US-003-016 Validate JSON payload structure |
orchestrata_ultimate/cxp/payload _set_json_payload L414 |
none |
REQ-004-US-003-017 Validate binary payload encoding |
orchestrata_ultimate/cxp/payload _set_binary_payload L452 |
none |
REQ-004-US-003-018 Reject oversized payloads |
orchestrata_ultimate/cxp/payload PayloadManager L51orchestrata_ultimate/cxp/payload validate_payload_size L377 |
none |
REQ-004-US-003-019 Provide detailed error messages |
orchestrata_ultimate/core/packet/exceptions CXPError L25 |
none |
REQ-004-US-003-020 Implement get_payload() method |
orchestrata_ultimate/cxp/payload PayloadManager L51orchestrata_ultimate/cxp/payload get_payload L90 |
none |
REQ-004-US-003-021 Implement get_payload_json() for JSON extraction |
orchestrata_ultimate/cxp/payload get_payload_json L125 |
none |
REQ-004-US-003-022 Implement get_payload_binary() for binary extraction |
orchestrata_ultimate/cxp/payload get_payload_binary L164 |
none |
REQ-004-US-003-023 Raise error if payload type mismatch |
orchestrata_ultimate/cxp/exceptions InvalidPacketError L48orchestrata_ultimate/cxp/payload get_payload_json L125 |
none |
REQ-004-US-003-024 Support payload type checking (is_json, is_binary) |
orchestrata_ultimate/cxp/payload PayloadManager L51orchestrata_ultimate/cxp/payload is_binary L283orchestrata_ultimate/cxp/payload is_json L253 |
none |
REQ-004-US-004-001 Define DeliveryStatus enum |
orchestrata_ultimate/core/packet/enums DeliveryStatus L33 |
none |
REQ-004-US-004-002 Implement QUEUED status |
orchestrata_ultimate/core/packet/enums DeliveryStatus L33 |
none |
REQ-004-US-004-003 Implement DELIVERED status |
orchestrata_ultimate/core/packet/enums DeliveryStatus L33 |
none |
REQ-004-US-004-004 Implement ACKNOWLEDGED status |
orchestrata_ultimate/core/packet/enums DeliveryStatus L33 |
none |
REQ-004-US-004-005 Implement FAILED status |
orchestrata_ultimate/core/packet/enums DeliveryStatus L33 |
none |
REQ-004-US-004-006 Validate status transitions |
orchestrata_ultimate/core/packet/packet _check_delivery_transition L310orchestrata_ultimate/cxp/delivery_status validate_delivery_transition L35orchestrata_ultimate/cxp/interfaces set_status L276 |
none |
REQ-004-US-004-007 Allow QUEUED → DELIVERED transition |
orchestrata_ultimate/core/packet/packet mark_delivered L374orchestrata_ultimate/cxp/delivery_status validate_delivery_transition L35 |
none |
REQ-004-US-004-008 Allow DELIVERED → ACKNOWLEDGED transition |
orchestrata_ultimate/core/packet/packet mark_acknowledged L393orchestrata_ultimate/cxp/delivery_status validate_delivery_transition L35 |
none |
REQ-004-US-004-009 Allow QUEUED → FAILED transition |
orchestrata_ultimate/core/packet/packet mark_failed L384orchestrata_ultimate/cxp/delivery_status validate_delivery_transition L35 |
none |
REQ-004-US-004-010 Allow DELIVERED → FAILED transition |
orchestrata_ultimate/core/packet/packet mark_failed L384orchestrata_ultimate/cxp/delivery_status validate_delivery_transition L35 |
none |
REQ-004-US-004-011 Prevent invalid transitions (e.g., ACKNOWLEDGED → QUEUED) |
orchestrata_ultimate/core/packet/exceptions StateTransitionError L56orchestrata_ultimate/core/packet/packet _check_delivery_transition L310orchestrata_ultimate/cxp/delivery_status validate_delivery_transition L35 |
none |
REQ-004-US-004-012 Record timestamp for each transition |
orchestrata_ultimate/cxp/delivery_status set_status L108 |
none |
REQ-004-US-004-013 Log status transitions |
none | none |
REQ-004-US-004-014 Implement is_queued() method |
none | none |
REQ-004-US-004-015 Implement is_delivered() method |
none | none |
REQ-004-US-004-016 Implement is_acknowledged() method |
none | none |
REQ-004-US-004-017 Implement is_failed() method |
none | none |
REQ-004-US-004-018 Implement get_delivery_history() method |
orchestrata_ultimate/cxp/delivery_status DeliveryTracker L67orchestrata_ultimate/cxp/delivery_status get_history L144orchestrata_ultimate/cxp/dispatcher get_dispatch_history L146+1 more |
none |
REQ-004-US-004-019 Support filtering packets by status |
none | none |
REQ-004-US-004-020 Record failure reason for FAILED status |
orchestrata_ultimate/cxp/delivery_status DeliveryTracker L67orchestrata_ultimate/cxp/delivery_status record_failure L161orchestrata_ultimate/cxp/dispatcher CXPDispatcher L36+1 more |
none |
REQ-004-US-004-021 Support retry count tracking |
orchestrata_ultimate/core/packet/packet mark_for_retry L356orchestrata_ultimate/cxp/delivery_status DeliveryTracker L67orchestrata_ultimate/cxp/delivery_status increment_retry L181+1 more |
none |
REQ-004-US-004-022 Implement max retry limit |
orchestrata_ultimate/core/packet/packet can_retry L300orchestrata_ultimate/cxp/delivery_status can_retry L218orchestrata_ultimate/cxp/exceptions MaxRetriesExceededError L204+1 more |
none |
REQ-004-US-004-023 Log delivery failures |
none | none |
REQ-004-US-004-024 Notify sender on delivery failure |
orchestrata_ultimate/core/packet/packet create_error L532 |
none |
REQ-004-US-005-001 Define WorkStatus enum |
orchestrata_ultimate/core/packet/enums WorkStatus L73 |
none |
REQ-004-US-005-002 Implement PENDING status |
orchestrata_ultimate/core/packet/enums WorkStatus L73 |
none |
REQ-004-US-005-003 Implement IN_PROGRESS status |
orchestrata_ultimate/core/packet/enums WorkStatus L73 |
none |
REQ-004-US-005-004 Implement RESOLVED status |
orchestrata_ultimate/core/packet/enums WorkStatus L73 |
none |
REQ-004-US-005-005 Implement ARCHIVED status |
orchestrata_ultimate/core/packet/enums WorkStatus L73 |
none |
REQ-004-US-005-006 Validate status transitions |
orchestrata_ultimate/core/packet/packet _check_work_transition L333orchestrata_ultimate/cxp/work_status validate_work_transition L21 |
none |
REQ-004-US-005-007 Allow PENDING → IN_PROGRESS transition |
orchestrata_ultimate/core/packet/packet start_work L400orchestrata_ultimate/cxp/work_status start_work L152orchestrata_ultimate/cxp/work_status validate_work_transition L21 |
none |
REQ-004-US-005-008 Allow IN_PROGRESS → RESOLVED transition |
orchestrata_ultimate/core/packet/packet resolve_work L409orchestrata_ultimate/cxp/work_status resolve_work L162orchestrata_ultimate/cxp/work_status validate_work_transition L21 |
none |
REQ-004-US-005-009 Allow RESOLVED → ARCHIVED transition |
orchestrata_ultimate/core/packet/packet archive_work L414orchestrata_ultimate/cxp/work_status archive_work L176orchestrata_ultimate/cxp/work_status validate_work_transition L21 |
none |
REQ-004-US-005-010 Allow IN_PROGRESS → PENDING transition (re-queue) |
orchestrata_ultimate/core/packet/packet requeue_work L419orchestrata_ultimate/cxp/work_status requeue_work L186orchestrata_ultimate/cxp/work_status validate_work_transition L21 |
none |
REQ-004-US-005-011 Prevent invalid transitions (e.g., ARCHIVED → PENDING) |
orchestrata_ultimate/core/packet/exceptions StateTransitionError L56orchestrata_ultimate/core/packet/packet _check_work_transition L333orchestrata_ultimate/cxp/work_status validate_work_transition L21 |
none |
REQ-004-US-005-012 Record timestamp for each transition |
orchestrata_ultimate/cxp/work_status _ensure_tracked L66orchestrata_ultimate/cxp/work_status set_status L82 |
none |
REQ-004-US-005-013 Log status transitions |
none | none |
REQ-004-US-005-014 Implement is_pending() method |
none | none |
REQ-004-US-005-015 Implement is_in_progress() method |
none | none |
REQ-004-US-005-016 Implement is_resolved() method |
none | none |
REQ-004-US-005-017 Implement is_archived() method |
none | none |
REQ-004-US-005-018 Implement get_work_history() method |
orchestrata_ultimate/cxp/work_status get_history L133 |
none |
REQ-004-US-005-019 Support filtering packets by work status |
none | none |
REQ-004-US-005-020 Track assigned_to Volk for IN_PROGRESS |
none | none |
REQ-004-US-005-021 Track resolution result for RESOLVED |
none | none |
REQ-004-US-005-022 Track resolution timestamp |
orchestrata_ultimate/cxp/work_status _ensure_tracked L66orchestrata_ultimate/cxp/work_status set_status L82 |
none |
REQ-004-US-005-023 Track time_in_progress duration |
orchestrata_ultimate/cxp/work_status get_work_duration L199 |
none |
REQ-004-US-005-024 Support work notes/comments |
none | none |
REQ-004-US-006-001 Implement to_json() method |
orchestrata_ultimate/cxp/interfaces to_json L164orchestrata_ultimate/cxp/json_serializer JSONSerializer L108orchestrata_ultimate/cxp/json_serializer to_json L166+2 more |
none |
REQ-004-US-006-002 Serialize all packet fields to JSON |
orchestrata_ultimate/core/packet/compat to_dict L82orchestrata_ultimate/core/packet/packet to_dict L557orchestrata_ultimate/cxp/json_serializer to_dict L262+1 more |
none |
REQ-004-US-006-003 Handle datetime serialization (ISO8601) |
orchestrata_ultimate/core/packet/compat to_dict L82orchestrata_ultimate/core/packet/compat to_dict L293orchestrata_ultimate/core/packet/packet to_dict L557+2 more |
none |
REQ-004-US-006-004 Handle enum serialization (string values) |
orchestrata_ultimate/core/packet/compat to_dict L82orchestrata_ultimate/core/packet/compat to_dict L293orchestrata_ultimate/core/packet/packet to_dict L557+2 more |
none |
REQ-004-US-006-005 Handle UUID serialization (string) |
none | none |
REQ-004-US-006-006 Handle binary payload (base64) |
orchestrata_ultimate/cxp/json_serializer CXPEncoder L34orchestrata_ultimate/cxp/json_serializer default L55 |
none |
REQ-004-US-006-007 Serialize in <10ms for typical packet |
none | none |
REQ-004-US-006-008 Validate JSON output is valid |
none | none |
REQ-004-US-006-009 Implement from_json() class method |
orchestrata_ultimate/cxp/interfaces from_json L172orchestrata_ultimate/cxp/json_serializer JSONSerializer L108orchestrata_ultimate/cxp/json_serializer from_json L216+2 more |
none |
REQ-004-US-006-010 Deserialize all packet fields from JSON |
orchestrata_ultimate/core/packet/packet _from_dict_flat L668orchestrata_ultimate/core/packet/packet _from_dict_legacy L633orchestrata_ultimate/cxp/json_serializer from_dict L290+1 more |
none |
REQ-004-US-006-011 Parse datetime from ISO8601 |
orchestrata_ultimate/core/packet/compat from_dict L96orchestrata_ultimate/core/packet/packet _parse_iso_datetime L51orchestrata_ultimate/core/packet/packet from_dict L613+3 more |
none |
REQ-004-US-006-012 Parse enum from string values |
orchestrata_ultimate/core/packet/compat from_dict L96orchestrata_ultimate/core/packet/packet from_dict L613 |
none |
REQ-004-US-006-013 Parse UUID from string |
none | none |
REQ-004-US-006-014 Decode binary payload from base64 |
orchestrata_ultimate/cxp/json_serializer _decode_bytes_hook L96 |
none |
REQ-004-US-006-015 Deserialize in <10ms for typical packet |
orchestrata_ultimate/cxp/json_serializer from_json L216 |
none |
REQ-004-US-006-016 Validate all required fields present |
orchestrata_ultimate/cxp/json_serializer from_dict L290 |
none |
REQ-004-US-006-017 Implement to_bytes() method using MessagePack |
orchestrata_ultimate/cxp/binary_serializer BinarySerializer L88orchestrata_ultimate/cxp/binary_serializer to_bytes L126orchestrata_ultimate/cxp/interfaces to_bytes L180 |
none |
REQ-004-US-006-018 Serialize all packet fields to binary |
orchestrata_ultimate/cxp/binary_serializer _encode_value L46orchestrata_ultimate/cxp/binary_serializer to_bytes L126 |
none |
REQ-004-US-006-019 Binary serialization in <5ms |
orchestrata_ultimate/cxp/binary_serializer to_bytes L126 |
none |
REQ-004-US-006-020 Support compression for large payloads |
none | none |
REQ-004-US-006-021 Implement from_bytes() class method |
orchestrata_ultimate/cxp/binary_serializer BinarySerializer L88orchestrata_ultimate/cxp/binary_serializer from_bytes L168orchestrata_ultimate/cxp/interfaces from_bytes L188 |
none |
REQ-004-US-006-022 Deserialize all packet fields from binary |
orchestrata_ultimate/cxp/binary_serializer _decode_value L67orchestrata_ultimate/cxp/binary_serializer from_bytes L168 |
none |
REQ-004-US-006-023 Binary deserialization in <5ms |
orchestrata_ultimate/cxp/binary_serializer from_bytes L168 |
none |
REQ-004-US-006-024 Support decompression for compressed payloads |
orchestrata_ultimate/cxp/binary_serializer from_bytes L168 |
none |
REQ-004-US-006-025 Support pretty-print JSON for debugging |
orchestrata_ultimate/cxp/json_serializer to_json L166orchestrata_ultimate/cxp/serializer CXPSerializer L20orchestrata_ultimate/cxp/serializer to_json L41 |
none |
REQ-004-US-006-026 Support compact JSON for production |
orchestrata_ultimate/cxp/json_serializer to_json L166 |
none |
REQ-004-US-006-027 Support serialization with/without payload |
none | none |
REQ-004-US-006-028 Support partial serialization (headers only) |
none | none |
REQ-004-US-007-001 Validate all required fields present |
orchestrata_ultimate/core/packet/packet validate L453orchestrata_ultimate/cxp/schema _validate_object L190 |
none |
REQ-004-US-007-002 Validate field types match specification |
orchestrata_ultimate/cxp/headers validate_header L340orchestrata_ultimate/cxp/schema _check_type L319orchestrata_ultimate/cxp/schema _validate_value L230 |
none |
REQ-004-US-007-003 Validate field value constraints |
orchestrata_ultimate/cxp/schema _validate_pattern L269orchestrata_ultimate/cxp/validator _setup_default_rules L60 |
none |
REQ-004-US-007-004 Validate enum values |
orchestrata_ultimate/cxp/schema _validate_enum L259 |
none |
REQ-004-US-007-005 Validate string lengths |
orchestrata_ultimate/cxp/headers validate_subject L131orchestrata_ultimate/cxp/schema _validate_string_length L282orchestrata_ultimate/cxp/validator _check_subject L235 |
none |
REQ-004-US-007-006 Validate numeric ranges |
orchestrata_ultimate/cxp/schema _validate_numeric_bounds L303orchestrata_ultimate/cxp/validator _check_priority L224 |
none |
REQ-004-US-007-007 Define JSON schema for CXP packets |
orchestrata_ultimate/cxp/schema SchemaRegistry L112 |
none |
REQ-004-US-007-008 Implement validate() method |
orchestrata_ultimate/core/packet/packet validate L453orchestrata_ultimate/cxp/interfaces validate L148orchestrata_ultimate/cxp/interfaces validate L209+1 more |
none |
REQ-004-US-007-009 Validate packet against JSON schema |
orchestrata_ultimate/cxp/interfaces validate_schema L217orchestrata_ultimate/cxp/schema SchemaRegistry L112orchestrata_ultimate/cxp/schema validate_against_schema L159+1 more |
none |
REQ-004-US-007-010 Validate payload against custom schema (if provided) |
orchestrata_ultimate/cxp/schema SchemaRegistry L112orchestrata_ultimate/cxp/schema register_schema L144orchestrata_ultimate/cxp/schema validate_against_schema L159+1 more |
none |
REQ-004-US-007-011 Schema validation in <5ms |
orchestrata_ultimate/cxp/validator validate_schema L126 |
none |
REQ-004-US-007-012 Provide detailed validation errors |
orchestrata_ultimate/core/packet/results ValidationResult L103orchestrata_ultimate/cxp/exceptions SchemaValidationError L152orchestrata_ultimate/cxp/validator validate L99 |
none |
REQ-004-US-007-013 Validate delivery_status consistency with timestamps |
none | none |
REQ-004-US-007-014 Validate work_status consistency with timestamps |
none | none |
REQ-004-US-007-015 Validate from_agent ≠ to_agent |
orchestrata_ultimate/cxp/validator _check_sender_not_recipient L214 |
none |
REQ-004-US-007-016 Validate thread_id format |
none | none |
REQ-004-US-007-017 Validate protocol_version compatibility |
orchestrata_ultimate/cxp/version is_compatible_with L105orchestrata_ultimate/cxp/version_compat check_compatibility L37 |
none |
REQ-004-US-007-018 Support custom validator functions |
orchestrata_ultimate/cxp/interfaces IValidator L198orchestrata_ultimate/cxp/validator ValidationRule L38orchestrata_ultimate/cxp/validator register_validator L157 |
none |
REQ-004-US-007-019 Register validators per field |
orchestrata_ultimate/cxp/interfaces register_validator L224orchestrata_ultimate/cxp/validator register_validator L157 |
none |
REQ-004-US-007-020 Support validator chains |
orchestrata_ultimate/cxp/validator _setup_default_rules L60 |
none |
REQ-004-US-007-021 Provide validator error messages |
orchestrata_ultimate/cxp/validator ValidationRule L38orchestrata_ultimate/cxp/validator add_rule L250 |
none |
REQ-004-US-008-001 Generate thread_id for new conversations |
orchestrata_ultimate/cxp/threads create_thread L68 |
none |
REQ-004-US-008-002 Use UUID format for thread_id |
orchestrata_ultimate/cxp/threads create_thread L68 |
none |
REQ-004-US-008-003 Validate thread_id format |
none | none |
REQ-004-US-008-004 Support thread_id inheritance (replies use same thread_id) |
orchestrata_ultimate/core/packet/packet create_ack L512 |
none |
REQ-004-US-008-005 Implement get_thread_packets(thread_id) method |
orchestrata_ultimate/cxp/interfaces get_thread_packets L250orchestrata_ultimate/cxp/threads get_thread_packets L162orchestrata_ultimate/postman/sync_router get_thread_packets L260 |
none |
REQ-004-US-008-006 Return packets in chronological order |
orchestrata_ultimate/cxp/threads get_thread_packets L162orchestrata_ultimate/postman/sync_router get_thread_packets L260 |
none |
REQ-004-US-008-007 Support filtering by sender |
none | none |
REQ-004-US-008-008 Support filtering by recipient |
none | none |
REQ-004-US-008-009 Support filtering by status |
none | none |
REQ-004-US-008-010 Thread correlation in <2ms |
orchestrata_ultimate/cxp/threads get_thread_packets L162 |
none |
REQ-004-US-008-011 Track thread creation timestamp |
orchestrata_ultimate/cxp/threads create_thread L68orchestrata_ultimate/cxp/types ThreadMetadata L84 |
none |
REQ-004-US-008-012 Track thread participants (from_agent, to_agent) |
orchestrata_ultimate/cxp/threads create_thread L68orchestrata_ultimate/cxp/types ThreadMetadata L84orchestrata_ultimate/cxp/types add_participant L110 |
none |
REQ-004-US-008-013 Track thread message count |
orchestrata_ultimate/cxp/types ThreadMetadata L84orchestrata_ultimate/cxp/types touch L116 |
none |
REQ-004-US-008-014 Track thread status (active, resolved, archived) |
orchestrata_ultimate/cxp/threads ThreadManager L33orchestrata_ultimate/cxp/types ThreadMetadata L84orchestrata_ultimate/cxp/types ThreadStatus L74 |
none |
REQ-004-US-008-015 Support thread subject tracking |
orchestrata_ultimate/cxp/threads create_thread L68orchestrata_ultimate/cxp/types ThreadMetadata L84 |
none |
REQ-004-US-008-016 Create new thread on first message |
orchestrata_ultimate/cxp/interfaces create_thread L237orchestrata_ultimate/cxp/threads create_thread L68 |
none |
REQ-004-US-008-017 Add message to existing thread |
orchestrata_ultimate/cxp/interfaces add_to_thread L245orchestrata_ultimate/cxp/threads add_to_thread L128orchestrata_ultimate/postman/sync_router _persist_to_thread_sync L163 |
none |
REQ-004-US-008-018 Close thread when work_status = ARCHIVED |
orchestrata_ultimate/cxp/interfaces close_thread L258orchestrata_ultimate/cxp/threads close_thread L206 |
none |
REQ-004-US-008-019 Support thread re-opening |
orchestrata_ultimate/cxp/interfaces reopen_thread L263orchestrata_ultimate/cxp/threads reopen_thread L231 |
none |
REQ-004-US-008-020 Archive old threads after 30 days |
orchestrata_ultimate/cxp/threads archive_stale_threads L258 |
none |
REQ-004-US-009-001 Define priority range 0-10 |
orchestrata_ultimate/core/packet/enums Priority L110 |
none |
REQ-004-US-009-002 Implement priority constants (LOW=3, NORMAL=5, HIGH=7, URGENT=10) |
orchestrata_ultimate/core/packet/enums Priority L110orchestrata_ultimate/cxp/priority get_priority_level L84 |
none |
REQ-004-US-009-003 Default priority = 5 (NORMAL) |
orchestrata_ultimate/core/packet/packet __init__ L97 |
none |
REQ-004-US-009-004 Validate priority range |
orchestrata_ultimate/cxp/priority PriorityManager L48orchestrata_ultimate/cxp/priority validate_priority L142orchestrata_ultimate/cxp/validator _check_priority L224 |
none |
REQ-004-US-009-005 Sort packets by priority (descending) |
orchestrata_ultimate/cxp/postman_adapter _sort_key L66orchestrata_ultimate/cxp/priority PriorityManager L48orchestrata_ultimate/cxp/priority sort_by_priority L61 |
none |
REQ-004-US-009-006 Sort packets by timestamp (ascending) within same priority |
orchestrata_ultimate/cxp/postman_adapter _sort_key L66orchestrata_ultimate/cxp/priority PriorityManager L48orchestrata_ultimate/cxp/priority sort_by_priority L61 |
none |
REQ-004-US-009-007 Implement compare_priority() method |
none | none |
REQ-004-US-009-008 Support priority queue operations |
orchestrata_ultimate/cxp/postman_adapter dequeue L189orchestrata_ultimate/cxp/postman_adapter enqueue L110 |
none |
REQ-004-US-009-009 Implement set_priority() method |
orchestrata_ultimate/cxp/headers set_priority L404 |
none |
REQ-004-US-009-010 Allow priority increase (escalation) |
orchestrata_ultimate/cxp/headers set_priority L404 |
none |
REQ-004-US-009-011 Allow priority decrease (demotion) |
orchestrata_ultimate/cxp/headers set_priority L404 |
none |
REQ-004-US-009-012 Log priority changes |
none | none |
REQ-004-US-009-013 Prevent priority manipulation attacks |
orchestrata_ultimate/cxp/priority clamp_priority L161orchestrata_ultimate/cxp/priority validate_priority L142 |
none |
REQ-004-US-009-014 System messages have URGENT priority |
orchestrata_ultimate/cxp/priority get_default_priority L121 |
none |
REQ-004-US-009-015 Error messages have HIGH priority |
orchestrata_ultimate/cxp/priority get_default_priority L121 |
none |
REQ-004-US-009-016 User requests have NORMAL priority |
orchestrata_ultimate/cxp/priority get_default_priority L121 |
none |
REQ-004-US-009-017 Background tasks have LOW priority |
orchestrata_ultimate/cxp/priority get_default_priority L121 |
none |
REQ-004-US-009-018 Support custom priority policies per Volk |
none | none |
REQ-004-US-010-001 Use semantic versioning (major.minor.patch) |
orchestrata_ultimate/cxp/version ProtocolVersion L16orchestrata_ultimate/cxp/version major L48orchestrata_ultimate/cxp/version minor L53+1 more |
none |
REQ-004-US-010-002 Current version = 1.0.0 |
orchestrata_ultimate/cxp/version __init__ L24 |
none |
REQ-004-US-010-003 Validate version format |
orchestrata_ultimate/cxp/version __init__ L24orchestrata_ultimate/cxp/version parse_version L136 |
none |
REQ-004-US-010-004 Store version in protocol_version field |
orchestrata_ultimate/core/packet/packet __init__ L97 |
none |
REQ-004-US-010-005 Implement check_compatibility(version) method |
orchestrata_ultimate/cxp/version_compat check_compatibility L37 |
none |
REQ-004-US-010-006 Support same major version compatibility |
orchestrata_ultimate/cxp/version is_compatible_with L105orchestrata_ultimate/cxp/version_compat check_compatibility L37 |
none |
REQ-004-US-010-007 Reject incompatible major versions |
orchestrata_ultimate/cxp/version_compat CompatibilityResult L21orchestrata_ultimate/cxp/version_compat check_compatibility L37 |
none |
REQ-004-US-010-008 Support backward compatibility (older clients, newer server) |
orchestrata_ultimate/core/packet/packet _init_from_header L178orchestrata_ultimate/cxp/version_compat check_compatibility L37 |
none |
REQ-004-US-010-009 Warn on minor version mismatch |
orchestrata_ultimate/cxp/version_compat CompatibilityResult L21orchestrata_ultimate/cxp/version_compat check_compatibility L37 |
none |
REQ-004-US-010-010 Support protocol version negotiation |
orchestrata_ultimate/cxp/version_compat negotiate_version L70 |
none |
REQ-004-US-010-011 Return supported versions in handshake |
orchestrata_ultimate/cxp/version_compat get_supported_versions L107 |
none |
REQ-004-US-010-012 Select highest compatible version |
orchestrata_ultimate/cxp/version_compat negotiate_version L70 |
none |
REQ-004-US-010-013 Fallback to older version if needed |
orchestrata_ultimate/cxp/version_compat negotiate_version L70 |
none |
REQ-004-US-010-014 Log version negotiation results |
none | none |
REQ-004-US-010-015 Support packet migration from v1.0.0 to v2.0.0 |
none | none |
REQ-004-US-010-016 Implement upgrade_packet() method |
none | none |
REQ-004-US-010-017 Preserve all existing fields |
none | none |
REQ-004-US-010-018 Add new fields with defaults |
none | none |
REQ-004-US-010-019 Log packet upgrades |
none | none |
REQ-004-US-010-020 Document breaking changes in CHANGELOG.md |
none | none |
REQ-004-US-010-021 Document migration guides |
none | none |
REQ-004-US-010-022 Document version compatibility matrix |
none | none |
REQ-004-US-010-023 Document deprecation timeline |
none | none |
REQ-004-PERF-001 JSON serialization: <10ms for typical packet (1KB payload) |
orchestrata_ultimate/cxp/json_serializer _needs_custom_encoding L141orchestrata_ultimate/cxp/json_serializer _value_needs_encoding L129orchestrata_ultimate/cxp/json_serializer to_json L166 |
none |
REQ-004-PERF-002 JSON deserialization: <10ms for typical packet |
orchestrata_ultimate/cxp/json_serializer from_json L216 |
none |
REQ-004-PERF-003 Binary serialization: <5ms for typical packet |
orchestrata_ultimate/cxp/binary_serializer to_bytes L126 |
none |
REQ-004-PERF-004 Binary deserialization: <5ms for typical packet |
orchestrata_ultimate/cxp/binary_serializer from_bytes L168 |
none |
REQ-004-PERF-005 Large payload (10MB JSON): <100ms serialization |
none | none |
REQ-004-PERF-006 Field validation: <1ms per packet |
none | none |
REQ-004-PERF-007 Schema validation: <5ms per packet |
orchestrata_ultimate/cxp/schema SchemaRegistry L112orchestrata_ultimate/cxp/schema validate_against_schema L159orchestrata_ultimate/cxp/validator validate_schema L126 |
none |
REQ-004-PERF-008 Cross-field validation: <2ms per packet |
orchestrata_ultimate/cxp/validator _check_sender_not_recipient L214 |
none |
REQ-004-PERF-009 Thread correlation: <2ms per lookup |
orchestrata_ultimate/cxp/threads get_thread_packets L162 |
none |
REQ-004-PERF-010 Packet memory footprint: <10KB (excluding payload) |
none | none |
REQ-004-PERF-011 Thread metadata: <1KB per thread |
orchestrata_ultimate/cxp/types ThreadMetadata L84 |
none |
REQ-004-PERF-012 Validation cache: <100KB total |
none | none |
REQ-004-PERF-013 Support 10,000 packets in memory simultaneously |
orchestrata_ultimate/cxp/threads ThreadManager L33 |
none |
REQ-004-INTG-001 Store packet facts in Prolog (Article II) |
orchestrata_ultimate/cxp/interfaces assert_packet L304orchestrata_ultimate/cxp/prolog_bridge PrologBridge L114orchestrata_ultimate/cxp/prolog_bridge _escape_prolog_string L105+2 more |
none |
REQ-004-INTG-002 Query packets by message_id |
none | none |
REQ-004-INTG-003 Query packets by thread_id |
orchestrata_ultimate/cxp/interfaces query_by_thread L313orchestrata_ultimate/cxp/prolog_bridge PrologBridge L114orchestrata_ultimate/cxp/prolog_bridge _atom_to_alias L91+2 more |
none |
REQ-004-INTG-004 Query packets by sender/recipient |
none | none |
REQ-004-INTG-005 Query packets by status |
orchestrata_ultimate/cxp/interfaces query_by_status L318orchestrata_ultimate/cxp/prolog_bridge _atom_to_alias L91orchestrata_ultimate/cxp/prolog_bridge _terms_to_packet L577+1 more |
none |
REQ-004-INTG-006 Isolate packets per session (Article III) |
orchestrata_ultimate/cxp/session_adapter SessionAdapter L25orchestrata_ultimate/cxp/session_adapter add_packet L138orchestrata_ultimate/cxp/session_adapter is_bound L88+2 more |
none |
REQ-004-INTG-007 Load packets on session resume |
none | none |
REQ-004-INTG-008 Archive packets on session end |
none | none |
REQ-004-INTG-009 Support cross-session thread continuation |
none | none |
REQ-004-INTG-010 Postman accepts CXP packets for delivery |
orchestrata_ultimate/core/protocols/components PostmanProtocol L124orchestrata_ultimate/cxp/postman_adapter PostmanAdapter L81orchestrata_ultimate/cxp/postman_adapter _assert_enqueueable L149+2 more |
none |
REQ-004-INTG-011 Postman updates delivery_status |
orchestrata_ultimate/cxp/postman_adapter acknowledge L266orchestrata_ultimate/cxp/postman_adapter reject L294orchestrata_ultimate/postman/postman Postman L84 |
none |
REQ-004-INTG-012 Postman manages packet queues |
orchestrata_ultimate/core/protocols/components PostmanProtocol L124orchestrata_ultimate/cxp/postman_adapter PostmanAdapter L81orchestrata_ultimate/cxp/postman_adapter active_queues L335+3 more |
none |
REQ-004-INTG-013 Postman handles delivery failures |
orchestrata_ultimate/cxp/exceptions DeliveryError L168orchestrata_ultimate/cxp/postman_adapter reject L294orchestrata_ultimate/postman/postman Postman L84 |
none |
REQ-004-INTG-014 All Volks send CXP packets |
none | none |
REQ-004-INTG-015 All Volks receive CXP packets |
none | none |
REQ-004-INTG-016 Volks validate received packets |
orchestrata_ultimate/core/packet/packet validate L453 |
none |
REQ-004-INTG-017 Volks acknowledge received packets |
orchestrata_ultimate/core/packet/packet create_ack L512orchestrata_ultimate/cxp/postman_adapter acknowledge L266 |
none |
REQ-004-SUCC-001 All 250+ checkboxes in this file are marked |
none | none |
REQ-004-SUCC-002 All 10 user stories (US-001 to US-010) implemented |
none | none |
REQ-004-SUCC-003 All performance requirements met |
none | none |
REQ-004-SUCC-004 All integration requirements satisfied |
none | none |
REQ-004-SUCC-005 Unit tests passing for all user stories |
orchestrata_ultimate/gateway/cli run_serve L50 |
tests/gateway/test_cli_behavioral.py::TestRunServeLifecycle |
REQ-004-SUCC-006 Integration tests passing with Postman and Volks |
orchestrata_ultimate/gateway/cli main L74 |
tests/gateway/test_cli_behavioral.py::TestMainServeDispatch |
REQ-004-SUCC-007 Documentation complete |
none | none |