Downcity
ServicesTask Service

Run Artifacts and Debugging

run directory semantics, status interpretation, and practical troubleshooting steps

Run Artifacts and Debugging

Every task execution creates a run directory:

.ship/task/<taskId>/<timestamp>/

Core artifacts

FilePurpose
input.mddefinition snapshot for this run
output.mdoutput body (agent: successfully delivered channel text; script: script output)
result.mdhuman-readable summary
run.jsonfinal status payload
run-progress.jsonlive progress snapshot
dialogue.mdmulti-round summary (agent)
dialogue.jsonstructured round records (agent)
messages.jsonlexecution context message stream
error.mdfailure summary

run.json key fields

  • executionId
  • status
  • executionStatus
  • resultStatus
  • resultErrors
  • dialogueRounds
  • startedAt / endedAt

Common patterns

  • resultStatus=invalid

    • usually output too short
  • executionStatus=failure

    • usually script execution failure, agent runtime failure, or failed chat_send delivery
  • Task skipped (already running)

    • overlap trigger skipped by per-task serial guard
  • one-shot when=time:... no longer auto-runs

    • expected behavior after execution: paused + @manual

Table of Contents