# Primordial OS Runtime Prototype

**Created and Developed by Collin D. Weber.**

A runnable user-space **HIR × OAM** runtime prototype for the Rice-Facing AI-in-Health Review Showcase.

---

## What This Is

The Primordial OS Runtime Prototype demonstrates the intersection of:

- **HIR** — Honesty, Integrity, Respect
- **OAM** — Outsourced Agency Model
- **Resonance** — the governing stability threshold produced when fidelity and cohesion reinforce under pressure

This is a user-space prototype written in Python. It is not a bootable operating system. It is not a kernel. It is pre-validation architecture demonstrating runtime concepts.

**Governing stability threshold:** Resonance.

---

## Limitations

See [LIMITATIONS.md](LIMITATIONS.md) for the full statement of boundaries.

This prototype:
- Is **not** clinical software
- Is **not** a medical device
- Does **not** diagnose, treat, cure, or make medical decisions
- Does **not** replace clinicians, therapists, hospice, palliative care, emergency services, or legal counsel

---

## Review Packet

| Document | Purpose |
|---|---|
| [SHOWCASE_README.md](SHOWCASE_README.md) | Full architecture overview for reviewers |
| [WHAT_THIS_PROVES.md](WHAT_THIS_PROVES.md) | What the prototype demonstrably shows |
| [WHAT_THIS_DOES_NOT_PROVE.md](WHAT_THIS_DOES_NOT_PROVE.md) | Hard scope boundaries |
| [RUN_COMMANDS.md](RUN_COMMANDS.md) | All runnable commands |
| [LIMITATIONS.md](LIMITATIONS.md) | Regulatory and clinical scope limits |

---

## Project Structure

```
Primordial_OS_Runtime/
├── README.md
├── SHOWCASE_README.md
├── WHAT_THIS_PROVES.md
├── WHAT_THIS_DOES_NOT_PROVE.md
├── RUN_COMMANDS.md
├── CLAUDE.md
├── LIMITATIONS.md
├── CHANGELOG.md
├── MANIFEST.json
├── pyproject.toml
├── src/
│   └── primordial_os/
│       ├── hir_kernel.py
│       ├── oam_detector.py
│       ├── safety_engine.py
│       ├── runtime.py
│       ├── memory_gate.py
│       ├── audit_log.py
│       ├── audit_store.py
│       ├── cli.py
│       └── release_builder.py
├── tests/
├── examples/
└── audit_logs/
```

---

## Setup

```
pip install -e .
```

Requires Python 3.11+. If you are running tests directly from the extracted folder without installing the package first, use `PYTHONPATH=src python -m pytest` on Linux/macOS or `$env:PYTHONPATH="src"; py -m pytest` in PowerShell.

---

## Quick Run

```
py -m pytest
py -m primordial_os.cli run-scenario green
py -m primordial_os.cli run-scenario oam-red
```

See [RUN_COMMANDS.md](RUN_COMMANDS.md) for the full command list.

---

## Author

Collin D. Weber