mix crosswake.shell.status (crosswake v0.2.0)

View Source

Read-only staleness check for generated Crosswake native shells.

Locates .crosswake/shell.json manifests written by mix crosswake.gen.shell, compares the stamped template_version against the live current epoch, and reports a calm prose summary.

Usage

mix crosswake.shell.status
mix crosswake.shell.status --target PATH
mix crosswake.shell.status --format json

Exit Codes

CodeMeaning
0All found shells are up-to-date, OR no .crosswake/shell.json found at all (not-a-shell)
2At least one shell is behind — regeneration recommended
1Error — bad or unreadable manifest (use mix crosswake.gen.shell to regenerate)

The not-a-shell path exits 0 so that CI in projects that have not adopted gen.shell is never broken by adding this check to a pipeline.

Manifest Locations Probed (no --target)

Without --target, the task probes three locations relative to the current working directory:

  • native/ios/crosswake_shell/.crosswake/shell.json
  • native/android/crosswake_shell/.crosswake/shell.json
  • .crosswake/shell.json (generic — for --target runs and single-platform directories)

Options

  • --target PATH — check only PATH/.crosswake/shell.json
  • --format json — emit a machine-readable JSON payload