---

name: preflight kind: function version: 0.15.0

Goal

Report the dependency-installation and environment-variable readiness of a target *.prose.md contract before it is run.

Parameters

• target: path to the *.prose.md file to preflight

Returns

• report: preflight report listing dependency installation status and environment variable status (set/not set, never revealing values). The report reads pass when every use dependency is installed and every declared environment variable is set, and fail (with the missing items listed) otherwise.

Errors

• not-found: target file does not exist
• not-system: target file is not a valid contract to preflight

Invariants

• Never log, print, or include environment variable values in any output — only their set/not-set status.

Execution

• Resolve the full set of contracts the target depends on, transitively, from the target's declared dependencies (the resolver).
• Collect all environment: declarations across the resolved contract tree (the env-checker).
• Check each env var with test -n "${VAR+x}" via Bash — this returns whether the variable exists without ever reading its value.
• Check that all use dependencies are installed in <openprose-root>/deps/ (the dep-checker).
• Report readiness as pass (all satisfied) or fail (with missing items listed).