mix scoria.install (scoria v0.1.0)

Copy Markdown View Source

Installs Scoria through planner-led safe apply with three verification modes.

Modes

  • Default applymix scoria.install runs the planner and applies only planner-classified create/update operations. manual_review entries never receive silent overwrites.
  • --dry-run — builds and prints the install plan without writing host files.
  • --check — builds the install plan, prints it, and exits with a tri-state result. --check never writes host files.

Exit codes and automation trailer

ResultExit codeTrailer status
Compliant (all surfaces converged)0compliant
Drift or manual review required1drift or manual_review
Planner/check failure2error

Check mode prints a machine-parseable trailer as the final line:

SCORIA_CHECK_RESULT status=<status> exit_code=<code>

Post-upgrade verification:

mix scoria.install --check

See docs/operator_verification.md for the upgrade-safe dry-run → check → remediate → apply workflow.

Apply freshness

Apply compares each plan entry fingerprint captured at plan build time to the live disk fingerprint before writes (Scoria.Install.Manifest.validate_freshness/2). The stored .scoria/install/manifest.json file is not the apply gate input. If apply blocks for stale fingerprints, re-run --dry-run and --check without editing managed files between check and apply.

See docs/operator_verification.md for the Check vs apply drift detection subsection.

Summary

Functions

do_run(router_path, tailwind_path \\ nil, config_path \\ nil)

run(args)

Callback implementation for Mix.Task.run/1.