Jeden/Docs

CLI command

jeden config get

Read one effective schema-backed setting.

Exact invocation#

Shell
jeden config get <key> [--json] [--cwd path]

Inputs and options#

  • Required: an exact key from the setting schema, including contracts.communication, contracts.functionality, communication.mode, or one of the four communication.* overrides. Optional: --json for metadata and --cwd for the project layer.

Output and state effect#

Prints the effective string or JSON value; JSON mode also returns type, description, default, and enum metadata. It does not write configuration. Layers apply in order: legacy user config.json, canonical user config.yml, then project config.json; an absent layer contributes nothing, but a broken earlier layer is not hidden by a later override. The real CLI journey JEDEN_BIN=target/debug/jeden JEDEN_TEST_SOURCE_REVISION=&lt;candidate-commit&gt; node tests/config/unreadable/layers.mjs uses an isolated home and project beneath .build/config-layers, checks precedence, invalid syntax and root shape, non-text and directory read refusals, byte preservation and recovery. Before configuration checks it requires a clean checkout at the declared revision and a native --version identity ending in that commit's short SHA. Its report retains those identity observations, executable/test digests, actual commands, statuses, output and final file observations; source authorship alone is not a passing run.

Refusals and boundaries#

  • key-missing: reading the key `jeden config get` acts on: config get requires a key, and the command line ends before one; key-unknown: reading the key `&lt;key&gt;`: unknown config key: &lt;key&gt;; no setting of Jeden has that name, observed: every key there is; argument-unexpected: a word after the key. Each exits 2; jeden errors show jeden.config prints them with their tests.
  • Reading the layers is jeden.config.read, run before every command but --version, --help and errors; each refusal names the file and exits 1, and the file is never read as empty: layer-unreadable (configuration &lt;path&gt; cannot be read, with what the system answered, such as a directory in its place or bytes that are not UTF-8), layer-not-parsed (configuration &lt;path&gt; is not valid: it does not parse as JSON|YAML, with where the reader stopped), layer-root-not-object (configuration &lt;path&gt; is not valid: its root must be an object of settings, observed: what the root is) and layer-settings-invalid (configuration &lt;path&gt; does not hold valid settings, with the value the settings reader names). Fix the named file or move it aside.
  • Before the layers, jeden.config.environment loads the environment files: env-file-unreadable, env-line-not-declaration (the line, counted from 1, and what it holds), env-value-not-json (a double-quoted value that is no JSON string) and env-value-quote-open (a single quote left open; the value is not shown). Each names the file and exits 1.
  • 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.