CLI command
jeden artifacts
List files in one session's artifact directory.
Exact invocation#
jeden artifacts <session-id-or-path> [--json]Inputs and options#
- Required: a session identifier or path.
- Optional:
--jsonprints[{name, bytes}].
Output and state effect#
Prints sorted name<TAB>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.artifactsprints every cause with its test (tests/sessions/listing/artifacts.mjs).session-missingandargument-unexpectedexit2before the session is read. - Finding the session is
jeden.session.find, exit1:session-not-found(session not found: <path>; nothing is at that path, observed: the session root a name without/is looked up under; fix:jeden sessions, orjeden sessions search <query>to find one by what it holds),session-unexaminable(<path> cannot be examined, never reported as not found),session-not-a-directory,session-state-absent(RPCsession/openof a directory withoutstate.json) andlast-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) exits69; any other refusal or failure exits1. A refusal a functionality declares ends withfix: …andcause: <operation>.<cause>, andjeden errors show <operation>lists every cause of that functionality.