Local snapshot: add phase 5d startup readiness contract

Author: ProfRandom92

.agents/skills/ctxt-antigravity-runtime/SKILL.md

@@ -29,6 +29,7 @@ Use these commands first to inspect the shared contract and runtime surface:
 
 ```powershell
 cargo run --bin ctxt -- --json self report
+cargo run --bin ctxt -- --json startup readiness
 cargo run --bin ctxt -- --json startup flow
 cargo run --bin ctxt -- --json schema
 cargo run --bin ctxt -- --json capabilities
@@ -98,6 +99,14 @@ The startup flow is a contract-only checklist. It does not run commands automati
 
 Agents remain responsible for executing allowed commands one by one only when the active phase permits those commands. Use official docs only for architecture or best-practice claims.
 
+# Startup Readiness Contract
+
+Agents should call `ctxt --json startup readiness` before starting review workflow work.
+
+Readiness is a contract-only report. It does not run commands automatically. `ready_for_review_workflow: true` does not imply external execution is allowed. `ready_for_external_execution: false` remains the hard boundary.
+
+Use official docs only for architecture and best-practice claims.
+
 # Plan Artifacts Only
 
 For Antigravity plan artifacts only, use:

.agents/skills/ctxt-runtime/SKILL.md

@@ -64,6 +64,7 @@ Use these commands for safe, JSON-oriented runtime inspection:
 
 ```powershell
 cargo run --bin ctxt -- --json self report
+cargo run --bin ctxt -- --json startup readiness
 cargo run --bin ctxt -- --json startup flow
 cargo run --bin ctxt -- --json agent list
 cargo run --bin ctxt -- --json agent discover
@@ -174,6 +175,14 @@ Agents should call `ctxt --json startup flow` to discover the safe session start
 
 Agents remain responsible for executing allowed commands one by one only when the active phase permits those commands. Use official docs only for architecture or best-practice claims.
 
+# Phase 5d Note
+
+Phase 5d adds a deterministic startup readiness contract through `ctxt --json startup readiness`.
+
+Agents should call `ctxt --json startup readiness` before starting review workflow work. Readiness is a contract-only report. It does not run commands automatically.
+
+`ready_for_review_workflow: true` does not imply external execution is allowed. `ready_for_external_execution: false` remains the hard boundary. Use official docs only for architecture and best-practice claims.
+
 # Cross-Agent Compatibility
 
 Codex and Antigravity should both route through `ctxt`.

docs/AGENT_RUNTIME_CLI.md

@@ -224,6 +224,16 @@ The startup flow is a contract-only checklist. It does not execute the flow, inv
 
 External tools may use `ctxt --json startup flow` as a deterministic startup checklist. They remain responsible for executing allowed commands one by one only when the active phase permits those commands.
 
+## Phase 5d Behavior
+
+Phase 5d adds a deterministic startup readiness contract.
+
+`ctxt --json startup readiness` returns a static readiness report for the deterministic review workflow. It reports that review workflow contracts are ready and that external execution remains disabled.
+
+The readiness report is not an execution gate. It does not execute commands, invoke Codex CLI, invoke Antigravity CLI, invoke external agents, use network, execute subagents, apply proposals, apply review recommendations, or perform git writes.
+
+External tools may use `ctxt --json startup readiness` to decide whether the deterministic review workflow is available. `ready_for_review_workflow: true` does not imply external execution is allowed; `ready_for_external_execution: false` remains the hard boundary.
+
 ## Future Phases
 
 Later phases may add real Codex CLI or Antigravity CLI invocation behind explicit gates. Those phases should preserve the run artifact, keep JSON output machine-readable, and record provenance before and after external execution.

src/cli.rs

@@ -107,6 +107,7 @@ enum Command {
     Schema,
     SelfReport,
     StartupFlow,
+    StartupReadiness,
     SubagentsList,
     RunsList,
     RunsRead {
@@ -407,6 +408,13 @@ where
                 1
             }
         },
+        Ok(Command::StartupReadiness) => match handle_startup_readiness(json_output) {
+            Ok(_) => 0,
+            Err(e) => {
+                emit_error(json_output, &e);
+                1
+            }
+        },
         Ok(Command::SubagentsList) => match handle_subagents_list(json_output) {
             Ok(_) => 0,
             Err(e) => {
@@ -1046,7 +1054,9 @@ fn parse_subagents_command(argv: &[String]) -> Result<Command, String> {
 
 fn parse_startup_command(argv: &[String]) -> Result<Command, String> {
     if argv.len() < 2 {
-        return Err("missing subcommand for 'startup'. Usage: ctxt startup flow".to_string());
+        return Err(
+            "missing subcommand for 'startup'. Usage: ctxt startup flow | readiness".to_string(),
+        );
     }
 
     match argv[1].as_str() {
@@ -1059,8 +1069,17 @@ fn parse_startup_command(argv: &[String]) -> Result<Command, String> {
             }
             Ok(Command::StartupFlow)
         }
+        "readiness" => {
+            if argv.len() > 2 {
+                return Err(format!(
+                    "unexpected argument '{}' for 'startup readiness'",
+                    argv[2]
+                ));
+            }
+            Ok(Command::StartupReadiness)
+        }
         "run" | "execute" => Err(format!(
-            "unsupported subcommand '{}' for 'startup': startup flow execution is not supported",
+            "unsupported subcommand '{}' for 'startup': startup command execution is not supported",
             argv[1]
         )),
         other => Err(format!("unsupported subcommand '{}' for 'startup'", other)),
@@ -2925,48 +2944,55 @@ fn handle_startup_flow(_json_output: bool) -> Result<(), String> {
             "recommended_sequence": [
                 {
                     "order": 1,
+                    "command": "ctxt --json startup readiness",
+                    "purpose": "confirm deterministic review workflow readiness without enabling external execution",
+                    "required": true,
+                    "executes": false
+                },
+                {
+                    "order": 2,
                     "command": "ctxt --json self report",
                     "purpose": "read local runtime baseline and safe entrypoints",
                     "required": true,
                     "executes": false
                 },
                 {
-                    "order": 2,
+                    "order": 3,
                     "command": "ctxt --json schema",
                     "purpose": "read stable JSON command and artifact contracts",
                     "required": true,
                     "executes": false
                 },
                 {
-                    "order": 3,
+                    "order": 4,
                     "command": "ctxt --json capabilities",
                     "purpose": "read supported features and disabled gates",
                     "required": true,
                     "executes": false
                 },
                 {
-                    "order": 4,
+                    "order": 5,
                     "command": "ctxt --json subagents list",
                     "purpose": "read deterministic review and planning role contracts",
                     "required": true,
                     "executes": false
                 },
                 {
-                    "order": 5,
+                    "order": 6,
                     "command": "ctxt --json proposals list",
                     "purpose": "list local proposal artifact references without applying them",
                     "required": true,
                     "executes": false
                 },
                 {
-                    "order": 6,
+                    "order": 7,
                     "command": "ctxt --json reviews list",
                     "purpose": "list local review artifact references without generating or applying reviews",
                     "required": true,
                     "executes": false
                 },
                 {
-                    "order": 7,
+                    "order": 8,
                     "command": "ctxt --json validate --run",
                     "purpose": "run local validation only when the phase permits validation execution",
                     "required": true,
@@ -2986,6 +3012,60 @@ fn handle_startup_flow(_json_output: bool) -> Result<(), String> {
     Ok(())
 }
 
+fn handle_startup_readiness(_json_output: bool) -> Result<(), String> {
+    println!(
+        "{}",
+        serde_json::json!({
+            "ok": true,
+            "command": "startup readiness",
+            "schema_version": "0.1",
+            "ready_for_review_workflow": true,
+            "ready_for_external_execution": false,
+            "contracts": {
+                "self_report": true,
+                "schema": true,
+                "capabilities": true,
+                "subagents": true,
+                "proposals": true,
+                "reviews": true,
+                "startup_flow": true,
+                "validation_runner": true
+            },
+            "disabled_gates": {
+                "network": true,
+                "external_agents": true,
+                "provider_calls": true,
+                "proposal_apply": true,
+                "review_apply": true,
+                "subagent_execution": true,
+                "git_write": true,
+                "mcp_server": true,
+                "hooks": true,
+                "plugins": true
+            },
+            "recommended_next_commands": [
+                "ctxt --json startup flow",
+                "ctxt --json self report",
+                "ctxt --json schema",
+                "ctxt --json capabilities",
+                "ctxt --json subagents list",
+                "ctxt --json proposals list",
+                "ctxt --json reviews list",
+                "ctxt --json validate --run"
+            ],
+            "safety": {
+                "readiness_executed_commands": false,
+                "network_used": false,
+                "external_agents_invoked": false,
+                "subagents_executed": false,
+                "apply_performed": false,
+                "git_write_performed": false
+            }
+        })
+    );
+    Ok(())
+}
+
 fn handle_capabilities(_json_output: bool) -> Result<(), String> {
     println!(
         "{}",
@@ -3007,7 +3087,8 @@ fn handle_capabilities(_json_output: bool) -> Result<(), String> {
                 {"phase": "4h", "name": "proposal capabilities", "status": "stable"},
                 {"phase": "5a", "name": "deterministic subagent role contract", "status": "stable"},
                 {"phase": "5b", "name": "deterministic review artifact contract", "status": "stable"},
-                {"phase": "5c", "name": "deterministic startup review flow contract", "status": "stable"}
+                {"phase": "5c", "name": "deterministic startup review flow contract", "status": "stable"},
+                {"phase": "5d", "name": "deterministic startup readiness contract", "status": "stable"}
             ],
             "safety": {
                 "network_default": "deny",
@@ -3034,6 +3115,10 @@ fn handle_capabilities(_json_output: bool) -> Result<(), String> {
                 "review_artifact_contract": true,
                 "startup_flow_contract": true,
                 "startup_flow_execution": false,
+                "startup_readiness_contract": true,
+                "startup_readiness_execution": false,
+                "ready_for_review_workflow": true,
+                "ready_for_external_execution": false,
                 "review_generation": false,
                 "review_apply": false,
                 "proposal_apply": false,
@@ -3138,6 +3223,15 @@ fn handle_capabilities(_json_output: bool) -> Result<(), String> {
                     "network_used": false,
                     "external_agent_invoked": false,
                     "apply_performed": false
+                },
+                {
+                    "name": "startup readiness",
+                    "json": true,
+                    "side_effects": false,
+                    "read_only": true,
+                    "network_used": false,
+                    "external_agent_invoked": false,
+                    "apply_performed": false
                 }
             ]
         })
@@ -3485,6 +3579,53 @@ fn handle_schema(_json_output: bool) -> Result<(), String> {
                         "executes"
                     ]
                 },
+                {
+                    "command": "startup readiness",
+                    "status": "stable",
+                    "notes": [
+                        "read-only",
+                        "static contract",
+                        "does not execute commands",
+                        "review workflow readiness only",
+                        "external execution disabled",
+                        "no external agents",
+                        "no network",
+                        "no apply"
+                    ],
+                    "required_fields": [
+                        "ok",
+                        "command",
+                        "schema_version",
+                        "ready_for_review_workflow",
+                        "ready_for_external_execution",
+                        "contracts",
+                        "disabled_gates",
+                        "recommended_next_commands",
+                        "safety"
+                    ],
+                    "contract_fields": [
+                        "self_report",
+                        "schema",
+                        "capabilities",
+                        "subagents",
+                        "proposals",
+                        "reviews",
+                        "startup_flow",
+                        "validation_runner"
+                    ],
+                    "disabled_gate_fields": [
+                        "network",
+                        "external_agents",
+                        "provider_calls",
+                        "proposal_apply",
+                        "review_apply",
+                        "subagent_execution",
+                        "git_write",
+                        "mcp_server",
+                        "hooks",
+                        "plugins"
+                    ]
+                },
                 {
                     "command": "agent discover",
                     "status": "stable",
@@ -3566,6 +3707,7 @@ fn handle_self_report(_json_output: bool) -> Result<(), String> {
             },
             "safe_entrypoints": [
                 "ctxt --json schema",
+                "ctxt --json startup readiness",
                 "ctxt --json startup flow",
                 "ctxt --json capabilities",
                 "ctxt --json subagents list",
@@ -3589,6 +3731,10 @@ fn handle_self_report(_json_output: bool) -> Result<(), String> {
                 "review_artifacts_contract_only": true,
                 "startup_flow_execution": false,
                 "startup_flow_contract_only": true,
+                "startup_readiness_execution": false,
+                "startup_readiness_contract_only": true,
+                "ready_for_review_workflow": true,
+                "ready_for_external_execution": false,
                 "network_default": "deny",
                 "apply_automatic": false
             },