Run trace reference

Location

Every workflow execution writes a JSON trace to:

~/.cori/runs/<run-key>/<utc-timestamp>.json

The run key encodes the workflow identity (path hash for local workflows, remote/<host>/<owner>/<repo>@<sha> for remote ones). The filename is the UTC timestamp of the run start in ISO 8601 format.

Reading traces

# List recent runs
cori runs list

# Show the full trace for a specific run
cori runs show <run-id>

Trace shape

{
  "run_id": "01HX...",
  "workflow_id": "translate-product-sheets-fr",
  "workflow_ref": "./translate_product_sheets_fr",
  "started_at": "2025-01-15T09:03:22.000Z",
  "completed_at": "2025-01-15T09:04:47.000Z",
  "status": "completed",
  "requesting_identity": "user@machine.local",
  "parameters": {
    "input_file": "products.csv",
    "spreadsheet_id": "1BxiM...",
    "dry_run": false
  },
  "result": { ... },
  "activities": [
    {
      "step": "01_read_source_rows",
      "kind": "cli",
      "task_queue": "user@machine.local",
      "worker_identity": "user@machine.local",
      "started_at": "2025-01-15T09:03:23.000Z",
      "completed_at": "2025-01-15T09:03:24.500Z",
      "status": "completed",
      "attempts": 1,
      "output": { ... }
    }
  ]
}

Top-level fields

Field	Description
`run_id`	Unique run identifier (used with `cori runs show`)
`workflow_id`	Value of `id` from the manifest
`workflow_ref`	The path or ref used to run the workflow
`started_at`	Run start time (ISO 8601 UTC)
`completed_at`	Run end time (or `null` if not completed)
`status`	`completed`, `failed`, or `running`
`requesting_identity`	Identity of the machine/user that ran `cori run`
`parameters`	Parameter values used for this run
`result`	Final workflow output
`activities`	Array of per-step activity traces

Activity trace fields

Field	Description
`step`	Step filename without the `.ts` extension
`kind`	Activity kind (`cli`, `mcp_tool`, `code`, `llm`)
`task_queue`	Temporal task queue the activity was dispatched to
`worker_identity`	Identity of the worker that executed this activity
`started_at`	Activity start time
`completed_at`	Activity end time
`status`	`completed`, `failed`, or `timed_out`
`attempts`	Number of attempts made
`output`	Activity output (matches step's `output` Zod schema)

TODO: Confirm exact field names against crates/cori-cli/src/commands/run.rs. The fields above reflect the documented shape; specific field names may differ slightly in the current implementation.