Jeden/Docs

CLI command

jeden workspace discover

Validate an existing workspace and preview the state Jeden would adopt.

Exact invocation#

Shell
jeden workspace discover [path] [--json]

Inputs and options#

  • Optional: an existing repository or directory path; the current directory is used when omitted.

Output and state effect#

Canonicalizes the path, validates any existing project config, detects the Git root, and reports associated session counts. It writes no configuration and changes no source or ledger file.

Refusals and boundaries#

  • The same path, directory, Git, session-root and project-config causes of jeden.workspace as workspace adopt; a second path is argument-unexpected. No partial state is retained.
  • 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: <operation>.<cause>, and jeden errors show <operation> lists every cause of that functionality.