An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.
Rust
Emit structured doctor JSON diagnostics
Yeachan-Heo53d6909b9b68
diff --git a/ROADMAP.md b/ROADMAP.mdindex 2e34ba55..ff5eca28 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -309,7 +309,7 @@ Priority order: P0 = blocks CI/green state, P1 = blocks integration wiring, P2 =20. **Session state classification gap (working vs blocked vs finished vs truly stale)** — **done**: agent manifests now derive machine states such as `working`, `blocked_background_job`, `blocked_merge_conflict`, `degraded_mcp`, `interrupted_transport`, `finished_pending_report`, and `finished_cleanable`, and terminal-state persistence records commit provenance plus derived state so downstream monitoring can distinguish quiet progress from truly idle sessions.21. **Resumed `/status` JSON parity gap** — dogfooding shows fresh `claw status --output-format json` now emits structured JSON, but resumed slash-command status still leaks through a text-shaped path in at least one dispatch path. Local CI-equivalent repro fails `rust/crates/rusty-claude-cli/tests/resume_slash_commands.rs::resumed_status_command_emits_structured_json_when_requested` with `expected value at line 1 column 1`, so resumed automation can receive text where JSON was explicitly requested. **Action:** unify fresh vs resumed `/status` rendering through one output-format contract and add regression coverage so resumed JSON output is guaranteed valid.22. **Opaque failure surface for session/runtime crashes** — repeated dogfood-facing failures can currently collapse to generic wrappers like `Something went wrong while processing your request. Please try again, or use /new to start a fresh session.` without exposing whether the fault was provider auth, session corruption, slash-command dispatch, render failure, or transport/runtime panic. This blocks fast self-recovery and turns actionable clawability bugs into blind retries. **Action:** preserve a short user-safe failure class (`provider_auth`, `session_load`, `command_dispatch`, `render`, `runtime_panic`, etc.), attach a local trace/session id, and ensure operators can jump from the chat-visible error to the exact failure log quickly.-23. **`doctor --output-format json` check-level structure gap** — direct dogfooding shows `claw doctor --output-format json` exposes `has_failures` at the top level, but individual check results (`auth`, `config`, `workspace`, `sandbox`, `system`) are buried inside flat prose fields like `message` / `report`. That forces claws to string-scrape human text instead of consuming stable machine-readable diagnostics. **Action:** emit structured per-check JSON (`name`, `status`, `summary`, `details`, and relevant typed fields such as sandbox fallback reason) while preserving the current human-readable report for text mode.+23. **`doctor --output-format json` check-level structure gap** — **done**: `claw doctor --output-format json` now keeps the human-readable `message`/`report` while also emitting structured per-check diagnostics (`name`, `status`, `summary`, `details`, plus typed fields like workspace paths and sandbox fallback data), with regression coverage in `output_format_contract.rs`.24. **Plugin lifecycle init/shutdown test flakes under workspace-parallel execution** — dogfooding surfaced that `build_runtime_runs_plugin_lifecycle_init_and_shutdown` can fail under `cargo test --workspace` while passing in isolation because sibling tests race on tempdir-backed shell init script paths. This is test brittleness rather than a code-path regression, but it still destabilizes CI confidence and wastes diagnosis cycles. **Action:** isolate temp resources per test robustly (unique dirs + no shared cwd assumptions), audit cleanup timing, and add a regression guard so the plugin lifecycle test remains stable under parallel workspace execution.**P3 — Swarm efficiency**13. Swarm branch-lock protocol — **done**: `branch_lock::detect_branch_lock_collisions()` now detects same-branch/same-scope and nested-module collisions before parallel lanes drift into duplicate implementationdiff --git a/rust/crates/rusty-claude-cli/src/main.rs b/rust/crates/rusty-claude-cli/src/main.rsindex faf4c187..6d2c9b78 100644--- a/rust/crates/rusty-claude-cli/src/main.rs+++ b/rust/crates/rusty-claude-cli/src/main.rs@@ -51,7 +51,7 @@ use runtime::{Session, TokenUsage, ToolError, ToolExecutor, UsageTracker,};use serde::Deserialize;-use serde_json::json;+use serde_json::{json, Map, Value};use tools::{GlobalToolRegistry, RuntimeToolDefinition, ToolSearchOutput};const DEFAULT_MODEL: &str = "claude-opus-4-6";@@ -870,6 +870,7 @@ struct DiagnosticCheck {level: DiagnosticLevel,summary: String,details: Vec<String>,+ data: Map<String, Value>,}impl DiagnosticCheck {@@ -879,6 +880,7 @@ impl DiagnosticCheck {level,summary: summary.into(),details: Vec::new(),+ data: Map::new(),}}@@ -886,6 +888,37 @@ impl DiagnosticCheck {self.details = details;self}++ fn with_data(mut self, data: Map<String, Value>) -> Self {+ self.data = data;+ self+ }++ fn json_value(&self) -> Value {+ let mut value = Map::from_iter([+ (+ "name".to_string(),+ Value::String(self.name.to_ascii_lowercase()),+ ),+ (+ "status".to_string(),+ Value::String(self.level.label().to_string()),+ ),+ ("summary".to_string(), Value::String(self.summary.clone())),+ (+ "details".to_string(),+ Value::Array(+ self.details+ .iter()+ .cloned()+ .map(Value::String)+ .collect::<Vec<_>>(),+ ),+ ),+ ]);+ value.extend(self.data.clone());+ Value::Object(value)+ }}#[derive(Debug, Clone, PartialEq, Eq)]@@ -894,26 +927,29 @@ struct DoctorReport {}impl DoctorReport {+ fn counts(&self) -> (usize, usize, usize) {+ (+ self.checks+ .iter()+ .filter(|check| check.level == DiagnosticLevel::Ok)+ .count(),+ self.checks+ .iter()+ .filter(|check| check.level == DiagnosticLevel::Warn)+ .count(),+ self.checks+ .iter()+ .filter(|check| check.level == DiagnosticLevel::Fail)+ .count(),+ )+ }+fn has_failures(&self) -> bool {self.checks.iter().any(|check| check.level.is_failure())}fn render(&self) -> String {- let ok_count = self- .checks- .iter()- .filter(|check| check.level == DiagnosticLevel::Ok)- .count();- let warn_count = self- .checks- .iter()- .filter(|check| check.level == DiagnosticLevel::Warn)- .count();- let fail_count = self- .checks- .iter()- .filter(|check| check.level == DiagnosticLevel::Fail)- .count();+ let (ok_count, warn_count, fail_count) = self.counts();let mut lines = vec!["Doctor".to_string(),format!(@@ -923,6 +959,28 @@ impl DoctorReport {lines.extend(self.checks.iter().map(render_diagnostic_check));lines.join("\n\n")}++ fn json_value(&self) -> Value {+ let report = self.render();+ let (ok_count, warn_count, fail_count) = self.counts();+ json!({+ "kind": "doctor",+ "message": report,+ "report": report,+ "has_failures": self.has_failures(),+ "summary": {+ "total": self.checks.len(),+ "ok": ok_count,+ "warnings": warn_count,+ "failures": fail_count,+ },+ "checks": self+ .checks+ .iter()+ .map(DiagnosticCheck::json_value)+ .collect::<Vec<_>>(),+ })+ }}fn render_diagnostic_check(check: &DiagnosticCheck) -> String {@@ -980,15 +1038,9 @@ fn run_doctor(output_format: CliOutputFormat) -> Result<(), Box<dyn std::error::let message = report.render();match output_format {CliOutputFormat::Text => println!("{message}"),- CliOutputFormat::Json => println!(- "{}",- serde_json::to_string_pretty(&json!({- "kind": "doctor",- "message": message,- "report": message,- "has_failures": report.has_failures(),- }))?- ),+ CliOutputFormat::Json => {+ println!("{}", serde_json::to_string_pretty(&report.json_value())?);+ }}if report.has_failures() {return Err("doctor found failing checks".into());@@ -996,6 +1048,7 @@ fn run_doctor(output_format: CliOutputFormat) -> Result<(), Box<dyn std::error::Ok(())}+#[allow(clippy::too_many_lines)]fn check_auth_health() -> DiagnosticCheck {let api_key_present = env::var("ANTHROPIC_API_KEY").ok()@@ -1060,6 +1113,21 @@ fn check_auth_health() -> DiagnosticCheck {},).with_details(details)+ .with_data(Map::from_iter([+ ("api_key_present".to_string(), json!(api_key_present)),+ ("auth_token_present".to_string(), json!(auth_token_present)),+ ("saved_oauth_present".to_string(), json!(true)),+ ("saved_oauth_expired".to_string(), json!(expired)),+ (+ "saved_oauth_expires_at".to_string(),+ json!(token_set.expires_at),+ ),+ (+ "refresh_token_present".to_string(),+ json!(token_set.refresh_token.is_some()),+ ),+ ("scopes".to_string(), json!(token_set.scopes)),+ ]))}Ok(None) => DiagnosticCheck::new("Auth",@@ -1082,12 +1150,31 @@ fn check_auth_health() -> DiagnosticCheck {} else {"absent"}- )]),+ )])+ .with_data(Map::from_iter([+ ("api_key_present".to_string(), json!(api_key_present)),+ ("auth_token_present".to_string(), json!(auth_token_present)),+ ("saved_oauth_present".to_string(), json!(false)),+ ("saved_oauth_expired".to_string(), json!(false)),+ ("saved_oauth_expires_at".to_string(), Value::Null),+ ("refresh_token_present".to_string(), json!(false)),+ ("scopes".to_string(), json!(Vec::<String>::new())),+ ])),Err(error) => DiagnosticCheck::new("Auth",DiagnosticLevel::Fail,format!("failed to inspect saved credentials: {error}"),- ),+ )+ .with_data(Map::from_iter([+ ("api_key_present".to_string(), json!(api_key_present)),+ ("auth_token_present".to_string(), json!(auth_token_present)),+ ("saved_oauth_present".to_string(), Value::Null),+ ("saved_oauth_expired".to_string(), Value::Null),+ ("saved_oauth_expires_at".to_string(), Value::Null),+ ("refresh_token_present".to_string(), Value::Null),+ ("scopes".to_string(), Value::Null),+ ("saved_oauth_error".to_string(), json!(error.to_string())),+ ])),}}@@ -1121,7 +1208,7 @@ fn check_config_health(} else {details.extend(discovered_paths- .into_iter()+ .iter().map(|path| format!("Discovered file {path}")),);}@@ -1139,6 +1226,22 @@ fn check_config_health(},).with_details(details)+ .with_data(Map::from_iter([+ ("discovered_files".to_string(), json!(discovered_paths)),+ (+ "discovered_files_count".to_string(),+ json!(discovered_count),+ ),+ (+ "loaded_config_files".to_string(),+ json!(loaded_entries.len()),+ ),+ ("resolved_model".to_string(), json!(runtime_config.model())),+ (+ "mcp_servers".to_string(),+ json!(runtime_config.mcp().servers().len()),+ ),+ ]))}Err(error) => DiagnosticCheck::new("Config",@@ -1149,10 +1252,21 @@ fn check_config_health(vec!["Discovered files <none>".to_string()]} else {discovered_paths- .into_iter()+ .iter().map(|path| format!("Discovered file {path}")).collect()- }),+ })+ .with_data(Map::from_iter([+ ("discovered_files".to_string(), json!(discovered_paths)),+ (+ "discovered_files_count".to_string(),+ json!(discovered_count),+ ),+ ("loaded_config_files".to_string(), json!(0)),+ ("resolved_model".to_string(), Value::Null),+ ("mcp_servers".to_string(), Value::Null),+ ("load_error".to_string(), json!(error.to_string())),+ ])),}}@@ -1194,6 +1308,38 @@ fn check_workspace_health(context: &StatusContext) -> DiagnosticCheck {context.memory_file_count, context.loaded_config_files, context.discovered_config_files),])+ .with_data(Map::from_iter([+ ("cwd".to_string(), json!(context.cwd.display().to_string())),+ (+ "project_root".to_string(),+ json!(context+ .project_root+ .as_ref()+ .map(|path| path.display().to_string())),+ ),+ ("in_git_repo".to_string(), json!(in_repo)),+ ("git_branch".to_string(), json!(context.git_branch)),+ (+ "git_state".to_string(),+ json!(context.git_summary.headline()),+ ),+ (+ "changed_files".to_string(),+ json!(context.git_summary.changed_files),+ ),+ (+ "memory_file_count".to_string(),+ json!(context.memory_file_count),+ ),+ (+ "loaded_config_files".to_string(),+ json!(context.loaded_config_files),+ ),+ (+ "discovered_config_files".to_string(),+ json!(context.discovered_config_files),+ ),+ ]))}fn check_sandbox_health(status: &runtime::SandboxStatus) -> DiagnosticCheck {@@ -1224,9 +1370,43 @@ fn check_sandbox_health(status: &runtime::SandboxStatus) -> DiagnosticCheck {},).with_details(details)+ .with_data(Map::from_iter([+ ("enabled".to_string(), json!(status.enabled)),+ ("active".to_string(), json!(status.active)),+ ("supported".to_string(), json!(status.supported)),+ (+ "namespace_supported".to_string(),+ json!(status.namespace_supported),+ ),+ (+ "namespace_active".to_string(),+ json!(status.namespace_active),+ ),+ (+ "network_supported".to_string(),+ json!(status.network_supported),+ ),+ ("network_active".to_string(), json!(status.network_active)),+ (+ "filesystem_mode".to_string(),+ json!(status.filesystem_mode.as_str()),+ ),+ (+ "filesystem_active".to_string(),+ json!(status.filesystem_active),+ ),+ ("allowed_mounts".to_string(), json!(status.allowed_mounts)),+ ("in_container".to_string(), json!(status.in_container)),+ (+ "container_markers".to_string(),+ json!(status.container_markers),+ ),+ ("fallback_reason".to_string(), json!(status.fallback_reason)),+ ]))}fn check_system_health(cwd: &Path, config: Option<&runtime::RuntimeConfig>) -> DiagnosticCheck {+ let default_model = config.and_then(runtime::RuntimeConfig::model);let mut details = vec![format!("OS {} {}", env::consts::OS, env::consts::ARCH),format!("Working dir {}", cwd.display()),@@ -1234,7 +1414,7 @@ fn check_system_health(cwd: &Path, config: Option<&runtime::RuntimeConfig>) -> Dformat!("Build target {}", BUILD_TARGET.unwrap_or("<unknown>")),format!("Git SHA {}", GIT_SHA.unwrap_or("<unknown>")),];- if let Some(model) = config.and_then(runtime::RuntimeConfig::model) {+ if let Some(model) = default_model {details.push(format!("Default model {model}"));}DiagnosticCheck::new(@@ -1243,6 +1423,15 @@ fn check_system_health(cwd: &Path, config: Option<&runtime::RuntimeConfig>) -> D"captured local runtime metadata",).with_details(details)+ .with_data(Map::from_iter([+ ("os".to_string(), json!(env::consts::OS)),+ ("arch".to_string(), json!(env::consts::ARCH)),+ ("working_dir".to_string(), json!(cwd.display().to_string())),+ ("version".to_string(), json!(VERSION)),+ ("build_target".to_string(), json!(BUILD_TARGET)),+ ("git_sha".to_string(), json!(GIT_SHA)),+ ("default_model".to_string(), json!(default_model)),+ ]))}fn resume_command_can_absorb_token(current_command: &str, token: &str) -> bool {diff --git a/rust/crates/rusty-claude-cli/tests/output_format_contract.rs b/rust/crates/rusty-claude-cli/tests/output_format_contract.rsindex 3700fbd0..03c1c5c8 100644--- a/rust/crates/rusty-claude-cli/tests/output_format_contract.rs+++ b/rust/crates/rusty-claude-cli/tests/output_format_contract.rs@@ -200,6 +200,41 @@ fn doctor_and_resume_status_emit_json_when_requested() {let doctor = assert_json_command(&root, &["--output-format", "json", "doctor"]);assert_eq!(doctor["kind"], "doctor");assert!(doctor["message"].is_string());+ let summary = doctor["summary"].as_object().expect("doctor summary");+ assert!(summary["ok"].as_u64().is_some());+ assert!(summary["warnings"].as_u64().is_some());+ assert!(summary["failures"].as_u64().is_some());++ let checks = doctor["checks"].as_array().expect("doctor checks");+ assert_eq!(checks.len(), 5);+ let check_names = checks+ .iter()+ .map(|check| {+ assert!(check["status"].as_str().is_some());+ assert!(check["summary"].as_str().is_some());+ assert!(check["details"].is_array());+ check["name"].as_str().expect("doctor check name")+ })+ .collect::<Vec<_>>();+ assert_eq!(+ check_names,+ vec!["auth", "config", "workspace", "sandbox", "system"]+ );++ let workspace = checks+ .iter()+ .find(|check| check["name"] == "workspace")+ .expect("workspace check");+ assert!(workspace["cwd"].as_str().is_some());+ assert!(workspace["in_git_repo"].is_boolean());++ let sandbox = checks+ .iter()+ .find(|check| check["name"] == "sandbox")+ .expect("sandbox check");+ assert!(sandbox["filesystem_mode"].as_str().is_some());+ assert!(sandbox["enabled"].is_boolean());+ assert!(sandbox["fallback_reason"].is_null() || sandbox["fallback_reason"].is_string());let session_path = root.join("session.jsonl");fs::write(