Jeden/Docs

CLI command

jeden artifacts

List files in one session's artifact directory.

Exact invocation#

Shell
jeden artifacts <session-id-or-path> [--json]

Inputs and options#

  • Required: a session identifier or path.
  • Optional: --json prints [{name, bytes}].

Output and state effect#

Prints sorted name&lt;TAB&gt;byte-size rows for regular artifact files, or the JSON array, and prints nothing (or []) when the session has no artifact directory. It does not mutate state.

Refusals and boundaries#

  • The functionality is jeden.session.artifacts; jeden errors show jeden.session.artifacts prints every cause with its test (tests/sessions/listing/artifacts.mjs). session-missing and argument-unexpected exit 2 before the session is read.
  • Finding the session is jeden.session.find, exit 1: session-not-found (session not found: &lt;path&gt;; nothing is at that path, observed: the session root a name without / is looked up under; fix: jeden sessions, or jeden sessions search &lt;query&gt; to find one by what it holds), session-unexaminable (&lt;path&gt; cannot be examined, never reported as not found), session-not-a-directory, session-state-absent (RPC session/open of a directory without state.json) and last-session-unrecorded (a session command that names none in a workspace that recorded none).
  • artifacts-unlistable: the artifacts of SESSION at PATH cannot be read: this user cannot list the directory or an entry of it; an unreadable entry refuses the whole list, never omitted from it.
  • A command line of the wrong form (an unknown command or option, a missing, unexpected or invalid argument, a missing confirmation) prints the error and the usage and exits 2; a refusal that retrying unchanged can help (a dependency down or not answering, a rate limit) exits 69; any other refusal or failure exits 1. A refusal a functionality declares ends with fix: … and cause: &lt;operation&gt;.&lt;cause&gt;, and jeden errors show &lt;operation&gt; lists every cause of that functionality.