CLI command
jeden artifact
Read one UTF-8 session artifact or copy it to a requested output file.
Exact invocation#
jeden artifact <session-id-or-path> <name> [output]Inputs and options#
- Required: session identifier or path and artifact name.
- Optional: an output path. Without it, artifact text is printed and normalized to end with a newline.
Output and state effect#
Canonicalizes the session artifact root and selected file, reads the artifact as text, and either prints it or writes the same text to the output path.
Refusals and boundaries#
- The functionality is
jeden.session.artifacts(tests/sessions/listing/artifacts.mjs). Exit2before any file is read:session-missing,name-missing(artifact requires an artifact name after the session),argument-unexpected(a word after the output) andartifact-escapes(artifact path escapes session: <name> resolves outside the session's artifact directory, observed: where it resolves). - 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). - Exit
1:artifact-not-found(the session keeps no artifact of that name),artifact-not-text(cannot read artifact PATH as UTF-8) andoutput-unwritable(cannot write artifact to PATH), each with what the system answered. - 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.