Function run_compile 

pub async fn run_compile(path: &str, out: Option<&str>) -> i32

Compile the .agent.md document at path. Writes the signed descriptor JSON to out if given, else prints it to stdout.

Returns a process exit code: 0 on success, 1 on read/parse/compile failure or a failing stage diagnostic.