stata-run

The argument is the Stata code or absolute path to a .do file to execute.

1. If the argument ends in .do or .ado, call:

   stata_run(code=<argument>, is_file=True, echo=True, as_json=True)

Otherwise call:

   stata_run(code=<argument>, echo=True, as_json=True)

1. If success is true, display the stdout output. Note the output is truncated to 5,000 chars; if the response includes a log_path, offer to tail the full log with /stata-log <log_path>.

1. If success is false, display the error message and rc code. Suggest using /stata-lint <path> for syntax issues or /stata-help <command> for documentation.

1. If the command produces graphs, note that /stata-graph can export them.

If using background mode (background=True): you may do other work or fire parallel tasks, but you MUST call stata_task_status(task_id=<id>, wait=True, timeout=<N>, tail_lines=<M>) for every task before returning to the user. Set timeout to match expected runtime; set tail_lines to how much output you want inline vs. reading separately via stata_read_log. Loop on timeout until status is 'done' or 'failed'.