Knowledge Wiki Orchestrata Ultimate

Orchestrata Ultimate / RTM / 000-orchestrata-cli

RTM: 000-orchestrata-cli

Requirement to symbol to test rows for 000-orchestrata-cli: Orchestrata CLI.

At a glance

Item Value
Requirement IDs 112
Traced from src/ 89 (79.5%)
Untraced 23
Cited from tests/ 5 (4.5%)
Traced in src/ but not cited from tests/ 84

Reading this matrix

This matrix lists each of the 112 requirement IDs of spec 000-orchestrata-cli with the src/ symbols that cite it and the tests that cite it. 89 of them (79.5%) have at least one citing symbol and 23 have none.

5 requirements are also cited from tests/, and 84 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-000-* (23).

Requirement to symbols to tests

Requirement Symbols in src/ Tests citing it
REQ-000-001 orchestrata init <project> creates project directory orchestrata_ultimate/kernel/cli_main init L908 none
REQ-000-002 orchestrata init initializes context.json orchestrata_ultimate/kernel/cli_main init L908
orchestrata_ultimate/kernel/cli_main time_now_iso L1018		 none
REQ-000-003 orchestrata init creates orchestrata.yaml config orchestrata_ultimate/kernel/cli_main init L908 none
REQ-000-004 orchestrata init loads Prolog governance rules none none
REQ-000-005 orchestrata init registers project in Memgraph orchestrata_ultimate/kernel/cli_main init L908 none
REQ-000-006 orchestrata init opens first session automatically orchestrata_ultimate/kernel/cli_main init L908 none
REQ-000-007 orchestrata init --template <type> applies project template orchestrata_ultimate/kernel/cli_main init L908 none
REQ-000-008 orchestrata init validates project name orchestrata_ultimate/kernel/cli_main init L908 none
REQ-000-009 orchestrata start boots Kernel (Spec 001) orchestrata_ultimate/kernel/cli_main _boot_agent_runtime L649
orchestrata_ultimate/kernel/cli_main _boot_create_components L180
orchestrata_ultimate/kernel/cli_main _boot_monolithic L723
+2 more		 none
REQ-000-010 orchestrata start starts Postman routing (Spec 002) orchestrata_ultimate/kernel/cli_main _boot_create_components L180
orchestrata_ultimate/kernel/cli_main _boot_monolithic L723
orchestrata_ultimate/kernel/cli_main start L830		 none
REQ-000-011 orchestrata start loads Prolog rules (Spec 007) orchestrata_ultimate/kernel/cli_main _boot_intent_pipeline L222
orchestrata_ultimate/kernel/cli_main _boot_monolithic L723
orchestrata_ultimate/kernel/cli_main start L830		 none
REQ-000-012 orchestrata start connects Redis orchestrata_ultimate/kernel/cli_main start L830 none
REQ-000-013 orchestrata start connects Neo4j orchestrata_ultimate/kernel/cli_main start L830 none
REQ-000-014 orchestrata start opens session (Spec 006) none none
REQ-000-015 orchestrata start starts health endpoint orchestrata_ultimate/kernel/cli_main _boot_monolithic L723
orchestrata_ultimate/kernel/cli_main _boot_start_services L709
orchestrata_ultimate/kernel/cli_main _start_health_server L119
+3 more		 none
REQ-000-016 orchestrata start --config <path> loads custom config orchestrata_ultimate/kernel/cli_main _load_config L40
orchestrata_ultimate/kernel/cli_main _resolve_env_vars L68		 none
REQ-000-017 orchestrata stop archives current session orchestrata_ultimate/kernel/cli_main stop L1030 tests/kernel/test_cli_main_coverage.py::test_stop_archives_unclosed_session
REQ-000-018 orchestrata stop drains message queues orchestrata_ultimate/kernel/cli_main stop L1030 none
REQ-000-019 orchestrata stop disconnects Redis and Neo4j orchestrata_ultimate/kernel/cli_main stop L1030 none
REQ-000-020 orchestrata stop shuts down Kernel and Postman orchestrata_ultimate/kernel/cli_main _read_pid_file L1129
orchestrata_ultimate/kernel/cli_main stop L1030		 none
REQ-000-021 orchestrata status shows runtime state orchestrata_ultimate/kernel/cli_main status L1148 none
REQ-000-022 orchestrata status shows connected services orchestrata_ultimate/kernel/cli_main status L1148 none
REQ-000-023 orchestrata status shows active volks with work_status orchestrata_ultimate/kernel/cli_main status L1148
orchestrata_ultimate/kernel/pipeline get_status L501
orchestrata_ultimate/kernel/pipeline status_report L513
+1 more		 none
REQ-000-024 orchestrata status shows session info orchestrata_ultimate/kernel/cli_main status L1148 none
REQ-000-025 orchestrata status shows health endpoint URL orchestrata_ultimate/kernel/cli_main status L1148 none
REQ-000-026 Graceful shutdown on SIGINT/SIGTERM orchestrata_ultimate/kernel/cli_main _boot_monolithic L723
orchestrata_ultimate/kernel/cli_main get_metadata L369
orchestrata_ultimate/kernel/cli_main stop L359		 none
REQ-000-027 orchestrata config team --add <volks> activates volks orchestrata_ultimate/kernel/cli_main team L1262 none
REQ-000-028 orchestrata config team --remove <volks> deactivates volks orchestrata_ultimate/kernel/cli_main team L1262 none
REQ-000-029 Team changes update Prolog facts (active_volk/1) orchestrata_ultimate/kernel/cli_main _write_team_file L1243
orchestrata_ultimate/kernel/cli_main team L1262		 none
REQ-000-030 Valid volk aliases enforced (U:Ox, U:PS, U:Vz, U:Ux, U:PM, U:Ar, U:Qa, U:Cx) orchestrata_ultimate/kernel/cli_main _validate_volks L1231
orchestrata_ultimate/kernel/cli_main team L1262		 tests/kernel/test_cli_main_coverage.py::TestValidateVolks
REQ-000-031 Invalid volk alias rejected with error message orchestrata_ultimate/kernel/cli_main _validate_volks L1231
orchestrata_ultimate/kernel/cli_main team L1262		 none
REQ-000-032 Team configuration persisted in orchestrata.yaml orchestrata_ultimate/kernel/cli_main _project_config_path L1219
orchestrata_ultimate/kernel/cli_main team L1262		 none
REQ-000-033 orchestrata intent "<text>" submits to Intent Broker (Spec 003) orchestrata_ultimate/kernel/cli_client _rpc_call L91
orchestrata_ultimate/kernel/cli_client gateway_rpc L133
orchestrata_ultimate/kernel/cli_main intent L1391
+1 more		 none
REQ-000-034 Intent Broker parses natural language into structured intent orchestrata_ultimate/kernel/cli_main intent L1391 none
REQ-000-035 Prolog validates intent (may_execute, constitutional_check) orchestrata_ultimate/kernel/pipeline submit_intent L345 none
REQ-000-036 Validated intent routed to appropriate Volk via CXP packet orchestrata_ultimate/kernel/pipeline submit_intent L345 none
REQ-000-037 CLI returns thread_id for tracking orchestrata_ultimate/kernel/cli_main intent L1391
orchestrata_ultimate/kernel/pipeline submit_intent L345		 none
REQ-000-038 CLI displays which volk received the intent orchestrata_ultimate/kernel/cli_main intent L1391 none
REQ-000-039 orchestrata respond --thread <id> "<text>" sends response to volk orchestrata_ultimate/kernel/cli_main respond L1413
orchestrata_ultimate/kernel/pipeline respond L442
orchestrata_ultimate/orchestrator/pipeline_escalation _collect_prior_human_answers L361
+3 more		 tests/kernel/test_get_last_human_message_thread_filter.py::test_peek_default_unchanged
REQ-000-040 Response travels as CXP packet through Postman orchestrata_ultimate/kernel/cli_main respond L1413
orchestrata_ultimate/kernel/pipeline respond L442
orchestrata_ultimate/orchestrator/pipeline_escalation respond L494
+1 more		 none
REQ-000-041 Blocked intents show governance reason orchestrata_ultimate/kernel/cli_main intent L1391
orchestrata_ultimate/kernel/pipeline submit_intent L345
orchestrata_ultimate/orchestrator/pipeline_escalation respond L494
+1 more		 none
REQ-000-042 orchestrata agents list shows all registered volks orchestrata_ultimate/kernel/cli_main agents_list L1312 none
REQ-000-043 Agent list shows alias, role, status per volk orchestrata_ultimate/kernel/cli_main agents_list L1312 none
REQ-000-044 orchestrata agents health shows health per volk orchestrata_ultimate/kernel/cli_main agents_health L1331 none
REQ-000-045 Health shows responding/idle/error state orchestrata_ultimate/kernel/cli_main agents_health L1331 none
REQ-000-046 orchestrata packets --thread <id> shows CXP flow orchestrata_ultimate/kernel/cli_main packets L1347 none
REQ-000-047 Packet display shows delivery_status per message orchestrata_ultimate/kernel/cli_main packets L1347 none
REQ-000-048 Packet display shows work_status per message orchestrata_ultimate/kernel/cli_main packets L1347 none
REQ-000-049 Packet display shows from_agent, to_agent, subject orchestrata_ultimate/kernel/cli_main packets L1347 none
REQ-000-050 orchestrata status combines agents + packets + session view none none
REQ-000-051 orchestrata review <volk> shows volk output/artifacts orchestrata_ultimate/kernel/cli_main review L1525
orchestrata_ultimate/kernel/pipeline get_output_display L101
orchestrata_ultimate/kernel/pipeline review_volk L565		 none
REQ-000-052 Review displays on active thread orchestrata_ultimate/kernel/cli_main review L1525
orchestrata_ultimate/kernel/pipeline review_volk L565		 none
REQ-000-053 orchestrata approve --thread <id> sends work_status=resolved orchestrata_ultimate/kernel/cli_main approve L1436
orchestrata_ultimate/kernel/pipeline_checkpoint clear L282
orchestrata_ultimate/kernel/pipeline_escalation _dispatch_approval L493
+5 more		 tests/session/test_pipeline_cli_escalation.py::test_approve_resumes_from_next_stage_after_real_escalation
REQ-000-054 Approve unblocks downstream volks orchestrata_ultimate/kernel/cli_main approve L1436
orchestrata_ultimate/kernel/pipeline_escalation _dispatch_approval L493
orchestrata_ultimate/kernel/pipeline_escalation approve L399
+2 more		 none
REQ-000-055 orchestrata reject --thread <id> "<reason>" sends feedback orchestrata_ultimate/kernel/cli_main reject L1462
orchestrata_ultimate/orchestrator/pipeline_escalation reject L477
orchestrata_ultimate/session/cli/pipeline pipeline_reject L391		 none
REQ-000-056 Reject keeps volk working with feedback orchestrata_ultimate/kernel/cli_main reject L1462
orchestrata_ultimate/orchestrator/pipeline_escalation _reenter_escalated_stage L376
orchestrata_ultimate/orchestrator/pipeline_escalation reject L477
+1 more		 none
REQ-000-057 Approve/reject travel as CXP packets through Postman orchestrata_ultimate/kernel/cli_main approve L1436
orchestrata_ultimate/kernel/cli_main reject L1462
orchestrata_ultimate/kernel/pipeline_escalation approve L399
+4 more		 none
REQ-000-058 Human must explicitly approve — no auto-approval orchestrata_ultimate/kernel/cli_main approve L1436
orchestrata_ultimate/kernel/pipeline_escalation approve L399
orchestrata_ultimate/orchestrator/pipeline_escalation EscalationState L136
+7 more		 none
REQ-000-059 orchestrata governance check "<action>" queries Prolog orchestrata_ultimate/kernel/cli_main check L1545 none
REQ-000-060 Check evaluates may_execute, constitutional_check, ethical_check orchestrata_ultimate/kernel/cli_main check L1545 none
REQ-000-061 Check returns allowed/denied with reason orchestrata_ultimate/kernel/cli_main check L1545
orchestrata_ultimate/orchestrator/engine GovernanceResult L143
orchestrata_ultimate/orchestrator/orchestrator PolicyDecision L80		 none
REQ-000-062 orchestrata governance log shows decision history orchestrata_ultimate/kernel/cli_main log L1565 none
REQ-000-063 Log shows which Prolog rule fired per decision orchestrata_ultimate/kernel/cli_main log L1565 none
REQ-000-064 orchestrata governance policies lists active policies orchestrata_ultimate/kernel/cli_main policies L1584 none
REQ-000-065 Policies show constitutional constraints orchestrata_ultimate/kernel/cli_main policies L1584 none
REQ-000-066 All governance queries go through Prolog engine (Spec 007) orchestrata_ultimate/governance/prolog_client GovernancePrologClient L169
orchestrata_ultimate/governance/prolog_gate PrologGate L40
orchestrata_ultimate/governance/prolog_gate assert_fact L283
+1 more		 none
REQ-000-067 orchestrata verify runs full verification across all specs orchestrata_ultimate/kernel/cli_main verify L1609 none
REQ-000-068 orchestrata verify --spec <id> verifies specific spec orchestrata_ultimate/kernel/cli_main verify L1609 none
REQ-000-069 Verification reports verified/partial/missing per requirement orchestrata_ultimate/kernel/cli_main verify L1609 none
REQ-000-070 Verification uses knowledge graph for traceability (Spec 008) orchestrata_ultimate/kernel/cli_main verify L1609 none
REQ-000-071 Verification results stored in Memgraph none none
REQ-000-072 RTM generated from verification results none none
REQ-000-073 orchestrata knowledge query "<query>" queries Neo4j orchestrata_ultimate/kernel/cli_main query L1660 none
REQ-000-074 Query returns decisions, facts, artifacts from sessions orchestrata_ultimate/kernel/cli_main query L1660 none
REQ-000-075 Query supports temporal queries (what happened in session N) orchestrata_ultimate/kernel/cli_main query L1660 none
REQ-000-076 Query results formatted for terminal display orchestrata_ultimate/kernel/cli_main query L1660 none
REQ-000-077 orchestrata session status shows current session state none none
REQ-000-078 orchestrata session list shows all sessions none none
REQ-000-079 orchestrata session end closes current session none none
REQ-000-080 orchestrata session end --archive archives to Neo4j none none
REQ-000-081 Session end updates context.md none none
REQ-000-082 Session end creates git checkpoint none none
REQ-000-083 orchestrata session resume loads previous session none none
REQ-000-084 Resume restores agent state none none
REQ-000-085 orchestrata session facts shows session facts none none
REQ-000-086 Session commands wrap orchestrata-session (Spec 006) orchestrata_ultimate/kernel/cli_main session L1677 none
REQ-000-087 No volk work_status transitions to resolved without may_complete/2 orchestrata_ultimate/governance/prolog_gate may_complete L175 none
REQ-000-088 may_complete/2 checks all_acceptance_criteria_met orchestrata_ultimate/governance/prolog_gate may_complete L175 none
REQ-000-089 may_complete/2 checks all_outputs_verified orchestrata_ultimate/governance/prolog_gate assert_task_output L296
orchestrata_ultimate/governance/prolog_gate may_complete L175		 none
REQ-000-090 may_complete/2 checks no_open_questions orchestrata_ultimate/governance/prolog_gate assert_open_question L303
orchestrata_ultimate/governance/prolog_gate may_complete L175
orchestrata_ultimate/governance/prolog_gate retract_open_question L310		 none
REQ-000-091 may_complete/2 checks downstream_volk_not_blocked none none
REQ-000-092 Failed gate returns reason to volk orchestrata_ultimate/governance/prolog_gate may_complete L175 none
REQ-000-093 Volk continues working until all gates pass none none
REQ-000-094 Click framework for all commands orchestrata_ultimate/kernel/cli_main cli L794 none
REQ-000-095 orchestrata version shows version orchestrata_ultimate/kernel/cli_main version L851 none
REQ-000-096 --json flag for machine-readable output orchestrata_ultimate/kernel/cli_main _emit L877
orchestrata_ultimate/kernel/cli_main watch L1493		 none
REQ-000-097 Clear error messages (no raw tracebacks) orchestrata_ultimate/kernel/cli_main watch L1493
orchestrata_ultimate/kernel/cli_watch _call_rpc L186
orchestrata_ultimate/kernel/cli_watch _recv_frame L180
+2 more		 tests/kernel/test_cli_client.py::TestGatewayRpcConnectionRefused
tests/kernel/test_cli_watch.py::TestStreamThreadEventsConnectionRefused
REQ-000-098 Help text for every command and subcommand none none
REQ-000-109 uv sync installs orchestrata script to venv bin directory none none
REQ-000-110 uv run orchestrata works from any directory within the workspace none none
REQ-000-111 Root pyproject.toml defines [project.scripts] entry point none none
REQ-000-112 Entry point resolves to orchestrata.kernel.cli_main:main orchestrata_ultimate/kernel/cli_main main L1685 none
REQ-000-099 Single orchestrata entry point replaces 5 existing CLIs orchestrata_ultimate/kernel/cli_main cli L794 none
REQ-000-100 orchestrata-kernel start subsumed by orchestrata start orchestrata_ultimate/kernel/cli_main cli L794 none
REQ-000-101 orchestrata-postman start subsumed by orchestrata start orchestrata_ultimate/kernel/cli_main cli L794 none
REQ-000-102 orchestrata-session commands wrapped by orchestrata session orchestrata_ultimate/kernel/cli_main cli L794 none
REQ-000-103 orchestrata-console replaced by full command tree orchestrata_ultimate/kernel/cli_main cli L794 none
REQ-000-104 U:Cx (Concierge) intake workflow: clarify, gather facts, escalate none none
REQ-000-105 U:Ar (Architect) 5-step pipeline: research, questions, design, tasks, review loop orchestrata_ultimate/agents/volks/architect/volk ArchitectVolk L149 none
REQ-000-106 U:Vz (VizInt) reviews architecture for gaps before implementation none none
REQ-000-107 Each volk has a world-class expert system prompt orchestrata_ultimate/agents/volks/persona compose_persona L34 none
REQ-000-108 Every volk action traced to a numbered spec none none