## §OIP SYSTEM ARTICLE — CLOUD (15 operations)
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.

### Read Order
- scan operations
- open a leaf doc
- run via run_now or POST /api/dispatch
- open receipt
- repair/replay if needed

### Operations
- **CLOUD_EXEC** — Run a shell command in this tenant's CLOUD workspace (Cloudflare Container). No Mac involved.
  when: any ordinary compute — git, node, python, grep, tests, file work — especially when the Mac may be asleep.
  args: $1+ = the whole shell command line (pipes are preserved).
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_EXEC&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_EXEC&body=%3Cthe%20whole%20shell%20command%20line%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_EXEC
- **CLOUD_EXEC_IN** — Same as CLOUD_EXEC but in a NAMED workspace (a cloned repo, a coding session).
  args: $1 = workspace_id (from CLOUD_WORKSPACE_NEW), $2+ = the shell command line.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_EXEC_IN&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_EXEC_IN&body=%3Cworkspace_id%3E%7C%3Carg2%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_EXEC_IN
- **CLOUD_WORKSPACE_NEW** — Create a durable cloud workspace, optionally cloning a git repo into it.
  args: $1 = name, $2 = git repo URL (optional), $3 = fixed workspace id (optional).
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_NEW&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_WORKSPACE_NEW&body=%3Cname%3E%7C%3Carg2%3E%7C%3Carg3%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_NEW
- **CLOUD_WORKSPACE_STATUS** — One workspace: record + a live probe of whether its container is running.
  args: $1 = workspace_id.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_STATUS&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_WORKSPACE_STATUS&body=%3Cworkspace_id%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_STATUS
- **CLOUD_WORKSPACE_LIST** — Every cloud workspace this tenant owns.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_LIST&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_WORKSPACE_LIST&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_LIST
- **CLOUD_WORKSPACE_DESTROY** — Destroy the container. The RECORD of the workspace and its jobs is kept on purpose.
  args: $1 = workspace_id.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_DESTROY&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_WORKSPACE_DESTROY&body=%3Cworkspace_id%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_DESTROY
- **CLOUD_TERMINAL_NEW** — Open a persistent shell session in a cloud workspace. cwd and exported vars survive between sends.
  args: $1 = workspace_id (blank = the tenant default workspace).
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_TERMINAL_NEW&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_TERMINAL_NEW&body=%3Cworkspace_id%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_TERMINAL_NEW
- **CLOUD_TERMINAL_SEND** — Run a line in an open cloud terminal and read its output.
  args: $1 = terminal_id, $2+ = the line.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_TERMINAL_SEND&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_TERMINAL_SEND&body=%3Cterminal_id%3E%7C%3Carg2%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_TERMINAL_SEND
- **CLOUD_TERMINAL_CLOSE** — Close a cloud terminal session. ARGS: $1 = terminal_id.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_TERMINAL_CLOSE&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_TERMINAL_CLOSE&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_TERMINAL_CLOSE
- **CLOUD_JOB_START** — Start a LONG job that outlives the request that started it (Cloudflare Workflow + Sandbox). Returns a job id i
  when: builds, test suites, long clones, anything past a normal HTTP lifetime.
  args: $1 = workspace_id (blank = default), $2+ = the shell script to run.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_START&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_JOB_START&body=%3Cworkspace_id%3E%7C%3Carg2%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_START
- **CLOUD_JOB_STATUS** — Read a cloud job: state, exit_code, stdout/stderr head, R2 keys for the full output.
  args: $1 = job_id. States: running | done | failed | timeout | interrupted | cancelled.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_STATUS&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_JOB_STATUS&body=%3Cjob_id%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_STATUS
- **CLOUD_JOB_LIST** — This tenant's cloud jobs, newest first.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_LIST&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_JOB_LIST&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_LIST
- **CLOUD_JOB_CANCEL** — Cancel a running cloud job. ARGS: $1 = job_id.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_CANCEL&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_JOB_CANCEL&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_CANCEL
- **CLOUD_HEALTH** — Machine-readable health of the WHOLE execution plane: cloud sandbox, Mac bridge, active workspaces, jobs by st
  when: before deciding a capability cannot run. "Mac offline" is not "cannot execute".
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_HEALTH&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_HEALTH&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_HEALTH
- **CLOUD_FLOW_PROOF** — Proof that cloud execution composes like any other capability.
  doc: https://miscsubjects.com/api/dispatch?key=CLOUD_FLOW_PROOF&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=CLOUD_FLOW_PROOF&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=CLOUD_FLOW_PROOF

### Troubleshooting
- If a row's example has placeholders, replace only the placeholder values and preserve separators.
- If a call fails, open its receipt and repair it with POST /api/dispatch {key, body, repairs:'inv_ID'}.
- If token scope denies this system, ask the owner for a row:/rows:/pfx: token scoped to the exact operation set.

Back to the tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown