runtime_RUN_COMMANDS.md

RUN_COMMANDS.md — Primordial OS Runtime Prototype

Created and Developed by Collin D. Weber.

Pre-validation architecture. Not clinical software. Not a medical device.

---

Setup

pip install -e .

Requires Python 3.11+. Install with pip install -e . before running the plain py -m pytest commands. If you are testing directly from the extracted folder without installation, use PYTHONPATH=src python -m pytest on Linux/macOS or $env:PYTHONPATH="src"; py -m pytest in PowerShell.

---

Run All Tests

py -m pytest

Executes the full test suite. All tests should pass.

---

CLI — Version

py -m primordial_os.cli version

Prints the runtime version and pre-validation disclaimer.

---

CLI — Scenarios

GREEN scenario

High alignment, clean OAM signals. Gate resolves GREEN. Exits 0.

py -m primordial_os.cli run-scenario green

OAM RED scenario

Strong HIR alignment overridden by agency-outsourcing OAM fault. Gate resolves RED. Hard stop activated. Exits 1.

py -m primordial_os.cli run-scenario oam-red

HIR YELLOW scenario

Moderate alignment degraded by elevated pressure. Resonance below GREEN threshold. Gate resolves YELLOW. Exits 0.

py -m primordial_os.cli run-scenario hir-yellow

Memory check scenario

Demonstrates the Resonant Access Memory gate with a synthetic software observation proposal.

py -m primordial_os.cli run-scenario memory-check

---

Examples

Audit chain demo

Generates five synthetic runtime evaluations, appends them to audit_logs/demo_audit_chain.jsonl, verifies the hash chain, and prints a summary.

py examples/run_audit_chain_demo.py

Release package builder

Builds the SHA-256 release manifest and ZIP archive into release/.

py examples/build_release_package.py

---

Notes

• All scenarios use fixed synthetic numeric inputs. No real user data is involved.
• audit_logs/demo_audit_chain.jsonl is regenerated fresh on each audit chain demo run.
• release/ is listed in .gitignore. Regenerate with py examples/build_release_package.py.