| # 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`. |
|
|
