use serde_json::{json, Value};
use crate::envelope::print_success_json;
use crate::error::{CliError, ErrorKind};
pub const COMMANDS: &[&str] = &[
"doctor",
"commands",
"schema",
"version",
"goto",
"view",
"press",
"click-at",
"write",
"keys",
"type",
"wait",
"hover",
"drag",
"fill-form",
"select-option",
"pick",
"upload",
"back",
"forward",
"reload",
"eval",
"grab",
"print-pdf",
"monitor",
"run",
"exec",
"extract",
"text",
"scroll",
"cookie",
"attr",
"assert",
"console",
"net",
"page",
"dialog",
"scrape",
"batch-scrape",
"crawl",
"map",
"search",
"parse",
"qr",
"find-paths",
"sg-scan",
"sg-rewrite",
"sheet-write",
"mitm",
"workflow",
"config",
"emulate",
"resize",
"perf",
"lighthouse",
"screencast",
"heap",
"extension",
"devtools3p",
"webmcp",
"completions",
];
pub const PARITY_DEFAULT_ON_REQUIRED: &[&str] = &[
"goto",
"view",
"press",
"write",
"keys",
"type",
"wait",
"hover",
"drag",
"fill-form",
"select-option",
"pick",
"upload",
"back",
"forward",
"reload",
"eval",
"grab",
"console",
"net",
"page",
"dialog",
"emulate",
"resize",
"perf",
"lighthouse",
"run",
"exec",
"doctor",
"commands",
"schema",
"version",
"completions",
];
pub const DEVTOOLS_TOOL_MAP: &[(&str, &str)] = &[
("click", "press"),
("drag", "drag"),
("fill", "write"),
("fill_form", "fill-form"),
("handle_dialog", "dialog"),
("hover", "hover"),
("press_key", "keys"),
("type_text", "type"),
("upload_file", "upload"),
("click_at", "click-at"),
("navigate_page", "goto|back|forward|reload"),
("new_page", "page new"),
("list_pages", "page list"),
("select_page", "page select"),
("close_page", "page close"),
("get_tab_id", "page tab-id"),
("wait_for", "wait"),
("emulate", "emulate"),
("resize_page", "resize"),
("performance_start_trace", "perf start"),
("performance_stop_trace", "perf stop"),
("performance_analyze_insight", "perf insight"),
("list_network_requests", "net list"),
("get_network_request", "net get"),
("evaluate_script", "eval"),
("list_console_messages", "console list"),
("get_console_message", "console get"),
("take_screenshot", "grab"),
("take_snapshot", "view"),
("lighthouse_audit", "lighthouse"),
("screencast_start", "screencast start"),
("screencast_stop", "screencast stop"),
("take_heapsnapshot", "heap take"),
("close_heapsnapshot", "heap close"),
("compare_heapsnapshots", "heap compare"),
("get_heapsnapshot_summary", "heap summary"),
("get_heapsnapshot_details", "heap details"),
("get_heapsnapshot_class_nodes", "heap class-nodes"),
("get_heapsnapshot_dominators", "heap dominators"),
("get_heapsnapshot_duplicate_strings", "heap dup-strings"),
("get_heapsnapshot_edges", "heap edges"),
("get_heapsnapshot_retainers", "heap retainers"),
("get_heapsnapshot_retaining_paths", "heap paths"),
("get_heapsnapshot_object_details", "heap object-details"),
("install_extension", "extension install"),
("list_extensions", "extension list"),
("reload_extension", "extension reload"),
("trigger_extension_action", "extension trigger"),
("uninstall_extension", "extension uninstall"),
("list_3p_developer_tools", "devtools3p list"),
("execute_3p_developer_tool", "devtools3p exec"),
("list_webmcp_tools", "webmcp list"),
("execute_webmcp_tool", "webmcp exec"),
];
pub fn list_commands(json: bool) -> Result<(), CliError> {
let map: Vec<Value> = DEVTOOLS_TOOL_MAP
.iter()
.map(|(tool, cli)| json!({ "tool": tool, "cli": cli }))
.collect();
let data = json!({
"commands": COMMANDS,
"schema_version": 1,
"parity_default_on": PARITY_DEFAULT_ON_REQUIRED,
"devtools_tool_map": map,
"binary": "browser-automation-cli",
});
if json {
print_success_json(data)?;
} else {
for c in COMMANDS {
println!("{c}");
}
}
Ok(())
}
fn schema_object(description: &str, properties: Value, required: &[&str]) -> Value {
json!({
"type": "object",
"description": description,
"properties": properties,
"required": required,
"additionalProperties": false,
})
}
fn schema_for(cmd: &str) -> Option<Value> {
let props = match cmd {
"doctor" => schema_object(
"Diagnose local Chrome install and one-shot readiness",
json!({
"offline": { "type": "boolean", "description": "Skip network probes" },
"quick": { "type": "boolean", "description": "Skip live launch test" },
"fix": { "type": "boolean", "description": "Apply safe repairs when possible" },
"json": { "type": "boolean" }
}),
&[],
),
"commands" => schema_object(
"List available commands",
json!({ "json": { "type": "boolean" } }),
&[],
),
"schema" => schema_object(
"JSON Schema fragment for one command",
json!({
"cmd": { "type": "string", "description": "Command name from `commands`" }
}),
&["cmd"],
),
"version" => schema_object("Print CLI version (JSON when --json)", json!({}), &[]),
"goto" => schema_object(
"Navigate to URL and wait for load (one-shot)",
json!({
"url": { "type": "string", "description": "Absolute URL or about:blank" },
"init_script": { "type": "string", "description": "JS to evaluate before navigation (tool-ref initScript)" },
"handle_before_unload": {
"type": "string",
"enum": ["accept", "dismiss"],
"description": "Auto-handle beforeunload via CDP: accept | dismiss (GAP-003; CLI flag alone defaults to accept; never injects preventDefault)"
},
"navigation_timeout_ms": { "type": "integer", "description": "Navigation timeout override in milliseconds" }
}),
&["url"],
),
"view" => schema_object(
"Accessibility snapshot with @eN refs",
json!({
"verbose": { "type": "boolean" },
"path": { "type": "string", "description": "Optional file to write tree text" }
}),
&[],
),
"press" => schema_object(
"Click element by CSS selector or @eN",
json!({
"target": { "type": "string" },
"dblclick": { "type": "boolean" },
"include_snapshot": { "type": "boolean" }
}),
&["target"],
),
"click-at" => schema_object(
"Click at page CSS coordinates (requires --experimental-vision)",
json!({
"x": { "type": "number" },
"y": { "type": "number" },
"dblclick": { "type": "boolean" },
"include_snapshot": { "type": "boolean" }
}),
&["x", "y"],
),
"write" => schema_object(
"Smart fill: text, select option, checkbox/radio true|false",
json!({
"target": { "type": "string" },
"value": { "type": "string" },
"include_snapshot": { "type": "boolean" }
}),
&["target", "value"],
),
"keys" => schema_object(
"Press a CDP key name",
json!({ "key": { "type": "string" } }),
&["key"],
),
"type" => schema_object(
"Type text into a target",
json!({
"target": { "type": "string" },
"text": { "type": "string" },
"clear": { "type": "boolean" },
"submit": { "type": "string", "description": "Optional key after type (e.g. Enter)" },
"focus_only": { "type": "boolean", "description": "Focus target without typing" },
"include_snapshot": { "type": "boolean" }
}),
&["text"],
),
"wait" => schema_object(
"Wait ms and/or text and/or CSS selector (comma OR / array) and/or URL and/or load state (GAP-019/024)",
json!({
"ms": { "type": "integer", "minimum": 0 },
"text": {
"oneOf": [
{ "type": "string" },
{ "type": "array", "items": { "type": "string" } }
],
"description": "Repeatable --text values; any match wins (OR)"
},
"selector": {
"oneOf": [
{ "type": "string", "description": "CSS selector; comma-separated OR supported (GAP-019)" },
{ "type": "array", "items": { "type": "string" } }
]
},
"selectors": { "type": "array", "items": { "type": "string" }, "description": "OR list of CSS selectors" },
"url": { "type": "string", "description": "Exact location.href match (GAP-024)" },
"url_contains": { "type": "string", "description": "Substring match on location.href (GAP-024)" },
"navigation": { "type": "boolean", "description": "Wait for load lifecycle (GAP-024)" },
"state": {
"type": "string",
"enum": ["load", "domcontentloaded", "networkidle", "none"]
},
"wait_timeout_ms": { "type": "integer", "minimum": 0 },
"include_snapshot": { "type": "boolean" }
}),
&[],
),
"hover" => schema_object(
"Hover element by CSS selector or @eN",
json!({ "target": { "type": "string" } }),
&["target"],
),
"drag" => schema_object(
"Drag from one target to another",
json!({
"from": { "type": "string" },
"to": { "type": "string" }
}),
&["from", "to"],
),
"fill-form" => schema_object(
"Fill multiple fields from JSON array",
json!({
"json": {
"type": "string",
"description": "JSON array of {target,value} objects"
}
}),
&["json"],
),
"select-option" | "select_option" | "pick" => schema_object(
"Pick option from custom select / badge popover / role=option (GAP-023)",
json!({
"target": { "type": "string", "description": "Trigger control (badge/button)" },
"option": { "type": "string", "description": "Option text, CSS selector, or role label" },
"value": { "type": "string" },
"include_snapshot": { "type": "boolean" }
}),
&["target", "option"],
),
"upload" => schema_object(
"Upload a regular file to a file input",
json!({
"target": { "type": "string" },
"path": { "type": "string" }
}),
&["target", "path"],
),
"back" => schema_object("History back", json!({}), &[]),
"forward" => schema_object("History forward", json!({}), &[]),
"reload" => schema_object(
"Reload page",
json!({ "ignore_cache": { "type": "boolean" } }),
&[],
),
"eval" => schema_object(
"Evaluate JavaScript expression or function declaration",
json!({
"expression": { "type": "string" },
"args": { "type": "string", "description": "JSON array of function args" },
"dialog_action": { "type": "string", "description": "accept|dismiss during evaluate" },
"file_path": { "type": "string", "description": "Optional path to write result" }
}),
&["expression"],
),
"grab" => schema_object(
"Screenshot (png/jpeg/webp)",
json!({
"path": { "type": "string" },
"format": { "type": "string", "enum": ["png", "jpeg", "webp"] },
"full_page": { "type": "boolean" },
"quality": { "type": "integer" },
"element": { "type": "string", "description": "CSS selector or @eN" }
}),
&[],
),
"print-pdf" => schema_object(
"Print current page to PDF via CDP Page.printToPDF (one-shot)",
json!({
"path": { "type": "string", "description": "Output PDF path" },
"url": { "type": "string", "description": "Optional URL to navigate before print" }
}),
&[],
),
"monitor" => schema_object(
"One-shot change check against a baseline file (hash/text)",
json!({
"action": { "type": "string", "enum": ["check"] },
"url": { "type": "string" },
"baseline": { "type": "string", "description": "Baseline file path" },
"write_baseline": { "type": "boolean" },
"engine": { "type": "string", "enum": ["http", "browser"] }
}),
&["action", "url", "baseline"],
),
"run" => schema_object(
"Execute multi-step script in one process; script file is NDJSON (one object per line) or a top-level JSON array of step objects",
json!({ "script": { "type": "string", "description": "Path to script file (.jsonl NDJSON or .json array of steps)" } }),
&["script"],
),
"exec" => schema_object(
"Single-step inline command (same surface as run steps)",
json!({
"args": {
"type": "array",
"items": { "type": "string" },
"description": "e.g. [\"goto\", \"about:blank\"] or [\"wait\", \"--ms\", \"100\"]"
}
}),
&["args"],
),
"extract" => schema_object(
"Extract text or attribute from target, or LLM extract with --llm",
json!({
"target": { "type": "string", "description": "CSS/@eN, http(s) URL, or file path for --llm" },
"attr": { "type": "string" },
"llm": { "type": "boolean" },
"question": { "type": "string" },
"schema_json": { "type": "string", "description": "Path to JSON schema file" }
}),
&["target"],
),
"text" => schema_object(
"Extract visible text from target (PRD §7)",
json!({
"target": { "type": "string" }
}),
&["target"],
),
"scroll" => schema_object(
"Scroll window or element by pixel deltas",
json!({
"target": { "type": "string", "description": "Optional CSS/@eN" },
"delta_x": { "type": "number" },
"delta_y": { "type": "number" },
"dx": { "type": "number", "description": "Alias for delta_x" },
"dy": { "type": "number", "description": "Alias for delta_y" }
}),
&[],
),
"cookie" => schema_object(
"Cookie list/set/clear for the one-shot browser process",
json!({
"action": { "type": "string", "enum": ["list", "set", "clear"] },
"url": { "type": "string" },
"json": { "type": "string", "description": "JSON array for set" }
}),
&["action"],
),
"attr" => schema_object(
"Read one attribute from target",
json!({
"target": { "type": "string" },
"name": { "type": "string" }
}),
&["target", "name"],
),
"assert" => schema_object(
"Assertion helpers (url/text/console)",
json!({
"kind": { "type": "string", "enum": ["url", "text", "console", "console_empty", "console_no_match"] },
"pattern": { "type": "string", "description": "For console_no_match (GAP-025)" },
"value": { "type": "string" },
"url": { "type": "string" },
"url_contains": { "type": "string" },
"text": { "type": "string" },
"text_contains": { "type": "string" },
"contains": { "type": "boolean" },
"target": { "type": "string" },
"level": { "type": "string" },
"max": { "type": "integer" }
}),
&[],
),
"console" => schema_object(
"List/get/clear/dump captured console messages (needs --capture-console)",
json!({
"action": { "type": "string", "enum": ["list", "get", "clear", "dump"] },
"id": { "type": "integer", "minimum": 0 },
"path": { "type": "string" }
}),
&["action"],
),
"net" => schema_object(
"List or get captured network requests (needs --capture-network)",
json!({
"action": { "type": "string", "enum": ["list", "get"] },
"id": { "type": "integer", "minimum": 0 },
"request_path": { "type": "string" },
"response_path": { "type": "string" }
}),
&["action"],
),
"page" => schema_object(
"Page info or multi-tab list|new|select|close|tab-id",
json!({
"action": {
"type": "string",
"enum": ["info", "list", "new", "select", "close", "tab-id"]
},
"url": { "type": "string" },
"index": { "type": "integer", "minimum": 0 },
"background": { "type": "boolean", "description": "Open new tab without focusing (page new)" },
"isolated_context": {
"type": "string",
"description": "Named isolated browser context for page new (tool-ref isolatedContext; GAP-004; flag alone = default-isolated)"
},
"page_id": { "type": "integer", "minimum": 0, "description": "Tool-ref pageId alias for index (select/close)" },
"bring_to_front": { "type": "boolean", "description": "Bring selected tab to front (page select; default true)" }
}),
&[],
),
"dialog" => schema_object(
"Accept or dismiss open dialog",
json!({
"action": { "type": "string", "enum": ["accept", "dismiss"] },
"text": { "type": "string", "description": "Optional prompt response text (accept only)" },
"if_present": {
"type": "boolean",
"description": "Soft-ok when no dialog is showing (GAP-006); envelope dialog_shown:false"
}
}),
&["action"],
),
"scrape" => schema_object(
"Navigate and return body text / formats (local HTTP or CDP scrape)",
json!({
"url": { "type": "string" },
"format": {
"oneOf": [
{
"type": "string",
"enum": [
"text", "markdown", "html", "raw-html", "links", "metadata",
"screenshot", "summary", "product", "branding"
]
},
{
"type": "array",
"items": {
"type": "string",
"enum": [
"text", "markdown", "html", "raw-html", "links", "metadata",
"screenshot", "summary", "product", "branding"
]
}
}
],
"description": "Single format, CSV multi-format, or array (GAP-009); browser applies via outerHTML"
},
"formats": {
"description": "Alias of format for multi-value (GAP-018)",
"oneOf": [
{ "type": "string" },
{ "type": "array", "items": { "type": "string" } }
]
},
"engine": {
"type": "string",
"enum": ["http", "browser"],
"description": "Default browser (CDP)"
},
"only_main_content": { "type": "boolean" },
"webhook_url": {
"type": "string",
"description": "Optional one-shot operator POST of result data (not product telemetry)"
}
}),
&["url"],
),
"batch-scrape" => schema_object(
"Scrape many URLs from a file (HTTP or browser engine, one-shot)",
json!({
"urls_file": { "type": "string", "description": "Path to file with one URL per line" },
"format": {
"type": "string",
"enum": ["text", "markdown", "html", "links", "metadata", "raw-html", "screenshot", "summary", "product", "branding"],
"description": "Single format or CSV multi-format when supported"
},
"engine": {
"type": "string",
"enum": ["http", "browser"],
"description": "Default http; browser uses CDP per URL (GAP-010)"
},
"concurrency": { "type": "integer", "minimum": 1 }
}),
&["urls_file"],
),
"crawl" => schema_object(
"Crawl from a seed URL (HTTP BFS or browser, one-shot)",
json!({
"url": { "type": "string" },
"limit": { "type": "integer", "minimum": 1 },
"max_pages": { "type": "integer", "minimum": 1, "description": "Alias of limit" },
"max_depth": { "type": "integer", "minimum": 0 },
"format": { "type": "string" },
"same_host": { "type": "boolean" },
"engine": {
"type": "string",
"enum": ["http", "browser"],
"description": "Default http; browser engine for JS-rendered crawl (GAP-010)"
}
}),
&["url"],
),
"map" => schema_object(
"Map site URLs from a seed (HTTP)",
json!({
"url": { "type": "string" },
"limit": { "type": "integer", "minimum": 1 },
"max_depth": { "type": "integer", "minimum": 0 }
}),
&["url"],
),
"search" => schema_object(
"Local search (HTTP SERP links or URL map)",
json!({
"query": { "type": "string" },
"limit": { "type": "integer", "minimum": 1 }
}),
&["query"],
),
"parse" => schema_object(
"Parse a local file (html/md/txt/pdf/docx/xlsx)",
json!({
"path": { "type": "string" },
"redact_pii": { "type": "boolean" }
}),
&["path"],
),
"qr" => schema_object(
"QR encode/decode one-shot (no Chrome)",
json!({
"action": { "type": "string", "enum": ["encode", "decode"] },
"text": { "type": "string" },
"format": { "type": "string", "enum": ["png", "svg", "terminal"] },
"path": { "type": "string" }
}),
&["action"],
),
"find-paths" => schema_object(
"Discover filesystem paths (fd-like; no Chrome)",
json!({
"pattern": { "type": "string" },
"paths": { "type": "array", "items": { "type": "string" } },
"extension": { "type": "string" },
"hidden": { "type": "boolean" },
"no_ignore": { "type": "boolean" },
"max_depth": { "type": "integer" },
"type": { "type": "string", "enum": ["f", "d"] },
"limit": { "type": "integer" },
"glob": { "type": "string", "description": "Shell-style glob e.g. **/*.rs" }
}),
&[],
),
"sg-scan" => schema_object(
"Structural lint scan for forbidden product patterns (one-shot; no Chrome)",
json!({
"paths": { "type": "array", "items": { "type": "string" } },
"limit": { "type": "integer" }
}),
&[],
),
"sg-rewrite" => schema_object(
"Structural rewrite dry-run/apply for safe patterns only (one-shot; no Chrome)",
json!({
"paths": { "type": "array", "items": { "type": "string" } },
"apply": { "type": "boolean" }
}),
&[],
),
"sheet-write" => schema_object(
"Write XLSX from CSV/JSON (write-only; no Chrome)",
json!({
"input": { "type": "string" },
"out": { "type": "string" },
"sheet": { "type": "string" }
}),
&["input", "out"],
),
"mitm" => schema_object(
"MITM capture / CA / HAR (one-shot local 127.0.0.1)",
json!({
"action": {
"type": "string",
"enum": [
"status", "list", "get", "har", "export",
"domains", "apis", "init-ca", "start"
]
},
"id": { "type": "string" },
"out": { "type": "string" },
"seconds": { "type": "integer", "minimum": 1 },
"limit": { "type": "integer", "minimum": 1 }
}),
&["action"],
),
"workflow" => schema_object(
"Workflow journal DAG (petgraph + SQLite under XDG state)",
json!({
"action": { "type": "string", "enum": ["run", "resume", "status"] },
"manifest": { "type": "string", "description": "JSON workflow manifest path" },
"journal": { "type": "string" },
"name": { "type": "string" }
}),
&["action"],
),
"config" => schema_object(
"XDG config and path management (no product env at runtime)",
json!({
"action": {
"type": "string",
"enum": ["path", "init", "show", "set", "get", "list-keys"]
},
"key": {
"type": "string",
"description": "For set/get: lang|timeout|artifacts_dir|ignore_robots|namespace|encryption_key|color|log_level|log_to_file|chrome_path|lighthouse_path|openrouter_api_key|llm_base_url|llm_model|cache_backend|cache_redis_url"
},
"value": { "type": "string" }
}),
&["action"],
),
"emulate" => schema_object(
"Emulate UA locale timezone network geo media CPU viewport headers",
json!({
"user_agent": { "type": "string" },
"locale": { "type": "string" },
"timezone": { "type": "string" },
"offline": { "type": "boolean" },
"latitude": { "type": "number" },
"longitude": { "type": "number" },
"media": { "type": "string" },
"network_conditions": { "type": "string" },
"cpu_throttling_rate": { "type": "number" },
"color_scheme": { "type": "string" },
"extra_headers": { "type": "string" },
"viewport": { "type": "string" }
}),
&[],
),
"resize" => schema_object(
"Resize viewport",
json!({
"width": { "type": "integer" },
"height": { "type": "integer" },
"scale": { "type": "number" },
"mobile": { "type": "boolean" }
}),
&["width", "height"],
),
"perf" => schema_object(
"Performance start|stop|insight",
json!({
"action": { "type": "string", "enum": ["start", "stop", "insight"] },
"path": { "type": "string" },
"reload": { "type": "boolean" },
"name": { "type": "string" }
}),
&["action"],
),
"lighthouse" => schema_object(
"External lighthouse audit with JSON scores",
json!({
"url": { "type": "string" },
"out_dir": { "type": "string" },
"device": { "type": "string" },
"mode": { "type": "string" },
"lighthouse_path": { "type": "string" }
}),
&["url"],
),
"screencast" => schema_object(
"Screencast start|stop (requires --experimental-screencast)",
json!({
"action": { "type": "string", "enum": ["start", "stop"] },
"path": { "type": "string" }
}),
&["action"],
),
"heap" => schema_object(
"Heap snapshot tools (deep ops need --category-memory)",
json!({
"action": { "type": "string" },
"path": { "type": "string" },
"base": { "type": "string" },
"current": { "type": "string" },
"id": { "type": "integer" },
"node": { "type": "integer" }
}),
&["action"],
),
"extension" => schema_object(
"Extension tools (requires --category-extensions)",
json!({
"action": { "type": "string" },
"path": { "type": "string" },
"id": { "type": "string" }
}),
&["action"],
),
"devtools3p" => schema_object(
"Third-party tools surface (requires --category-third-party)",
json!({
"action": { "type": "string", "enum": ["list", "exec"] },
"name": { "type": "string" },
"params": { "type": "string" },
"url": { "type": "string" }
}),
&["action"],
),
"webmcp" => schema_object(
"Web surface tools (requires --category-webmcp)",
json!({
"action": { "type": "string", "enum": ["list", "exec"] },
"name": { "type": "string" },
"input": { "type": "string" },
"url": { "type": "string" }
}),
&["action"],
),
"completions" => schema_object(
"Generate shell completions (no Chrome)",
json!({
"shell": {
"type": "string",
"enum": ["bash", "zsh", "fish", "elvish", "powershell"]
}
}),
&["shell"],
),
_ => return None,
};
Some(props)
}
pub fn schema_for_cmd(cmd: &str, json: bool) -> Result<(), CliError> {
if !COMMANDS.contains(&cmd) {
return Err(CliError::with_suggestion(
ErrorKind::Usage,
format!("unknown command for schema: {cmd}"),
"use `browser-automation-cli commands --json` to list commands",
));
}
let fragment = schema_for(cmd)
.unwrap_or_else(|| schema_object(&format!("Schema fragment for `{cmd}`"), json!({}), &[]));
let data = json!({
"command": cmd,
"schema_version": 1,
"schema": fragment,
"type": fragment.get("type").cloned().unwrap_or(json!("object")),
"description": fragment.get("description").cloned().unwrap_or(json!("")),
"properties": fragment.get("properties").cloned().unwrap_or(json!({})),
"required": fragment.get("required").cloned().unwrap_or(json!([])),
});
if json {
print_success_json(data)?;
} else {
println!(
"{}",
serde_json::to_string_pretty(&data).unwrap_or_default()
);
}
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn parity_default_on_subset_of_commands() {
for req in PARITY_DEFAULT_ON_REQUIRED {
assert!(
COMMANDS.contains(req),
"parity command missing from COMMANDS: {req}"
);
}
}
#[test]
fn commands_unique() {
let mut seen = std::collections::BTreeSet::new();
for c in COMMANDS {
assert!(seen.insert(*c), "duplicate command: {c}");
}
}
#[test]
fn config_schema_includes_list_keys_and_cache_keys() {
let frag = schema_for("config").expect("config schema");
let action_enum = frag
.pointer("/properties/action/enum")
.and_then(|v| v.as_array())
.expect("action.enum");
let actions: Vec<&str> = action_enum.iter().filter_map(|v| v.as_str()).collect();
assert!(
actions.contains(&"list-keys"),
"config action enum must include list-keys: {actions:?}"
);
for required in ["path", "init", "show", "set", "get", "list-keys"] {
assert!(
actions.contains(&required),
"missing config action {required} in {actions:?}"
);
}
let key_desc = frag
.pointer("/properties/key/description")
.and_then(|v| v.as_str())
.unwrap_or("");
for key in [
"lang",
"timeout",
"artifacts_dir",
"ignore_robots",
"namespace",
"encryption_key",
"color",
"log_level",
"log_to_file",
"chrome_path",
"lighthouse_path",
"openrouter_api_key",
"llm_base_url",
"llm_model",
"cache_backend",
"cache_redis_url",
] {
assert!(
key_desc.contains(key),
"config key description missing {key}: {key_desc}"
);
}
}
#[test]
fn run_schema_documents_ndjson_and_array() {
let frag = schema_for("run").expect("run schema");
let desc = frag
.get("description")
.and_then(|v| v.as_str())
.unwrap_or("");
let script_desc = frag
.pointer("/properties/script/description")
.and_then(|v| v.as_str())
.unwrap_or("");
assert!(
desc.to_ascii_lowercase().contains("array")
|| script_desc.to_ascii_lowercase().contains("array"),
"run schema must document JSON array scripts: desc={desc} script={script_desc}"
);
assert!(
desc.to_ascii_lowercase().contains("ndjson")
|| script_desc.to_ascii_lowercase().contains("ndjson")
|| script_desc.contains("jsonl"),
"run schema must document NDJSON scripts: desc={desc} script={script_desc}"
);
}
}