Skip to content

Common Workflows

Runtime v2 operations preserve evidence through one sequence: validate the workspace and profile, submit durable work, resolve the terminal result, inspect causal state, then replay, compare, cancel, or recover deliberately.

Run the complete lexical workflow

bijux-canon-runtime init --workspace ./canon-workspace --json
export BIJUX_CANON_RUNTIME_WORKING_ROOT=./canon-workspace

bijux-canon-runtime v2 run \
  "What evidence does this corpus support?" \
  --source-directory ./documents \
  --profile offline-lexical \
  --wait \
  --wait-timeout-seconds 30

The operation discovers regular admitted documents, retains their original bytes, prepares an immutable corpus, builds the selected index, retrieves bounded evidence, produces a citation-required answer, and records bounded research and agent evidence. Each transition is retained under one job, run, attempt, configuration and causal artifact graph.

Control each lifecycle explicitly

Use separate commands when corpus and index reuse matters:

bijux-canon-runtime v2 ingest ./documents \
  --profile offline-lexical \
  --wait
bijux-canon-runtime v2 index CORPUS_ID \
  --profile offline-lexical \
  --wait
bijux-canon-runtime v2 search "bounded query" \
  --index-id INDEX_ID \
  --profile offline-lexical \
  --wait
bijux-canon-runtime v2 ask "grounded question" \
  --corpus-id CORPUS_ID \
  --index-id INDEX_ID \
  --profile offline-lexical \
  --wait

Use v2 research for counterevidence-aware bounded research. Every submission accepts a strict --request FILE alternative for automation.

Follow or cancel durable work

bijux-canon-runtime v2 status JOB_ID \
  --follow \
  --timeout-seconds 30
bijux-canon-runtime v2 cancel JOB_ID

Follow mode uses worker notification and a deadline. Client timeout and durable cancellation are distinct states; inspect the job after either event.

Inspect retained evidence

bijux-canon-runtime v2 result JOB_ID
bijux-canon-runtime v2 inspect RUN_ID \
  --attempt-id ATTEMPT_ID \
  --limit 20
bijux-canon-runtime v2 artifact-payload ARTIFACT_ID \
  --offset 0 \
  --max-bytes 65536

Inspection is bounded by default and summarizes oversized arbitrary values. The payload command returns an independently verifiable digest, total size and continuation offset for one immutable byte page.

Replay and compare

bijux-canon-runtime v2 replay RUN_ID \
  --source-attempt-id ATTEMPT_ID \
  --network-policy disabled \
  --wait

bijux-canon-runtime v2 compare RUN_ID RUN_ID \
  --baseline-attempt-id ATTEMPT_ID \
  --candidate-attempt-id REPLAY_ATTEMPT_ID \
  --dimension outcome \
  --dimension claims \
  --dimension citations

Replay produces a new attempt and refuses changed or missing governed inputs. Comparison retains both attempt identities and the selected comparison dimensions; it never chooses tolerance after observing a favorable result.

Back up or relocate

bijux-canon-runtime v2 backup nightly-2026-08-25
bijux-canon-runtime v2 restore BACKUP_GENERATION ./restored-workspace

Backup requires a quiescent workspace. Restore verifies the database, admitted CAS, indexes, controls and workspace-owned model state before activating a new destination. Use restore for relocation rather than moving a workspace tree.