Knowledge Wiki Orchestrata Ultimate

Orchestrata Ultimate / RTM / 032-concierge-volk

RTM: 032-concierge-volk

Requirement to symbol to test rows for 032-concierge-volk: Concierge Volk (U:Cx).

At a glance

Item Value
Requirement IDs 54
Traced from src/ 48 (88.9%)
Untraced 6
Cited from tests/ 4 (7.4%)
Traced in src/ but not cited from tests/ 44

Reading this matrix

This matrix lists each of the 54 requirement IDs of spec 032-concierge-volk with the src/ symbols that cite it and the tests that cite it. 48 of them (88.9%) have at least one citing symbol and 6 have none.

4 requirements are also cited from tests/, and 44 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-032-* (6).

Requirement to symbols to tests

Requirement Symbols in src/ Tests citing it
REQ-032-001 ConciergeVolk is defined as a class extending BaseVolk orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-002 alias is set to the string constant "U:Cx" orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-003 role is set to the string constant "Concierge (Intake)" orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-004 ConciergeVolk is registered with the DI container under alias U:Cx none none
REQ-032-005 ConciergeVolk exposes MAX_QA_ROUNDS as a class-level integer constant equal to 4 orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-006 conversation_history is initialised as an empty list on instantiation orchestrata_ultimate/agents/volks/concierge/volk __init__ L126 none
REQ-032-007 original_intent is initialised as None or empty string on instantiation orchestrata_ultimate/agents/volks/concierge/volk __init__ L126 none
REQ-032-008 prolog_facts is initialised as an empty string on instantiation orchestrata_ultimate/agents/volks/concierge/volk __init__ L126 none
REQ-032-009 round_count is initialised to 0 on instantiation orchestrata_ultimate/agents/volks/concierge/volk __init__ L126 none
REQ-032-010 All instance state attributes persist for the lifetime of the handling Volk instance orchestrata_ultimate/agents/volks/concierge/volk __init__ L126 none
REQ-032-011 process(packet) inspects the CXP packet subject field for routing orchestrata_ultimate/agents/volks/concierge/volk process L185 none
REQ-032-012 Packets with subject "intent" are routed to _handle_intent() orchestrata_ultimate/agents/volks/concierge/volk process L185 none
REQ-032-013 Packets with subject "response" are routed to _handle_response() orchestrata_ultimate/agents/volks/concierge/volk process L185 none
REQ-032-014 Packets with unrecognised subjects are rejected with a logged error orchestrata_ultimate/agents/volks/concierge/volk process L185 tests/agents/volks/concierge/test_volk.py::test_process_unrecognized_subject_logs_warning
REQ-032-015 Subject matching is case-insensitive or normalised before comparison none none
REQ-032-016 _handle_intent() stores the packet body as original_intent on the first call orchestrata_ultimate/agents/volks/concierge/volk _handle_intent L213 none
REQ-032-017 _handle_intent() appends the human intent message to conversation_history orchestrata_ultimate/agents/volks/concierge/volk _handle_intent L213 none
REQ-032-018 _handle_intent() calls the LLM with CONCIERGE_SYSTEM_PROMPT and current... orchestrata_ultimate/agents/volks/concierge/volk _handle_intent L213 none
REQ-032-019 _handle_intent() routes the LLM response to HUMAN as clarifying questions orchestrata_ultimate/agents/volks/concierge/volk _handle_intent L213 none
REQ-032-020 _handle_intent() never compiles or finalises requirements on the first call (G162-1) orchestrata_ultimate/agents/volks/concierge/volk _handle_intent L213 none
REQ-032-021 round_count increments to 1 after _handle_intent() completes none none
REQ-032-022 _handle_response() appends the human answer to conversation_history before the LLM call orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-023 _handle_response() increments round_count before LLM invocation orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-024 _handle_response() calls the LLM with the full conversation_history each time orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-025 _handle_response() checks for REQUIREMENTS_COMPLETE signal in LLM response orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-026 _handle_response() checks whether round_count >= MAX_QA_ROUNDS (G213) orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-027 If REQUIREMENTS_COMPLETE is signalled or MAX_QA_ROUNDS is reached, _finalize() is called orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-028 If neither condition is met, LLM response is sent to HUMAN as follow-up questions orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-029 MAX_QA_ROUNDS is checked after every response round without exception none none
REQ-032-030 When round_count >= MAX_QA_ROUNDS, _finalize() is called unconditionally regardless of... orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-031 No additional questions are sent to HUMAN after forced finalization is triggered orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-032 Forced finalization compiles requirements from all conversation_history accumulated to... orchestrata_ultimate/agents/volks/concierge/volk _handle_response L268 none
REQ-032-033 _finalize() calls the LLM with a finalization prompt requesting all structured fields none none
REQ-032-034 _finalize() parses REQUIREMENTS_COMPLETE token from LLM response none none
REQ-032-035 _finalize() parses PROLOG_FACTS block from LLM response and stores it in prolog_facts orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-036 _finalize() parses ESCALATE_TO field from LLM response orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-037 _finalize() parses TASK_SUMMARY paragraph from LLM response orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-038 _finalize() parses PROJECT_NAME field from LLM response orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-039 Missing or malformed structured fields are handled without raising an exception orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-040 All parsed fields are included in the outbound CXP packet to U:BA orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-041 UI detection scans combined conversation_history text for UI-related keywords orchestrata_ultimate/agents/volks/concierge/volk detect_ui_requirement L173 tests/agents/volks/concierge/test_volk.py::test_detect_ui_requirement_scans_full_conversation
REQ-032-042 Detected UI requirement flag is included in the handoff packet to U:BA orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-043 UI detection is applied at finalization time, not during elicitation rounds orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-044 After finalization, a CXP packet is always sent to U:BA orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-045 The outbound packet to U:BA includes TASK_SUMMARY, PROJECT_NAME, PROLOG_FACTS,... orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-046 ESCALATE_TO is parsed and logged but U:BA is the fixed pipeline destination orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-047 No other Volk receives the requirements packet directly from U:Cx orchestrata_ultimate/agents/volks/concierge/volk _finalize L358 none
REQ-032-048 CONCIERGE_SYSTEM_PROMPT is defined as a module-level string constant orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-049 The prompt instructs the LLM to elicit requirements across seven dimensions (D1-D7) orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-050 The prompt instructs the LLM to signal REQUIREMENTS_COMPLETE when dimensions are... orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-051 The prompt instructs the LLM to emit PROLOG_FACTS in valid Prolog syntax orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-052 The prompt instructs the LLM to emit TASK_SUMMARY, PROJECT_NAME, and ESCALATE_TO on... orchestrata_ultimate/agents/volks/concierge/volk ConciergeVolk L104 none
REQ-032-053 The gateway chat handler (cxp.send to alias U:Cx) MUST dispatch to the real, live... orchestrata_ultimate/agents/kernel_handler _build_no_reply_packet L514
orchestrata_ultimate/agents/kernel_handler _build_terminal_packet L407
orchestrata_ultimate/gateway/handlers/cxp _maybe_reply_as_concierge L193
+1 more		 tests/agents/test_kernel_handler_ack_only.py::test_no_reply_terminal_is_machine_detectable
REQ-032-054 When the live ConciergeVolk kernel is not reachable (unwired, unready within the gRPC... orchestrata_ultimate/agents/kernel_handler _build_no_reply_packet L514
orchestrata_ultimate/agents/kernel_handler _build_terminal_packet L407
orchestrata_ultimate/gateway/handlers/cxp _maybe_reply_as_concierge L193		 tests/gateway/test_cxp_send_receipt_check.py::test_failed_receipt_triggers_unavailable_notice