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