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