cs/docs/readme_osf.md

# Primordial OS HIR Runtime Prototype v0.1

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

## Overview

This OSF release contains the **Primordial OS HIR Runtime Prototype v0.1** and supporting documentation.

This is **not** a finished bootable hardware operating system. It is an early software runtime / governance-kernel prototype for bounded AI and system autonomy using **Honesty, Integrity, and Respect (HIR)** as operational constraints.

The central operating rule is:

> Autonomy is allowed only when HIR resonance remains stable under pressure.

The prototype is intended for documentation, inspection, reproducibility review, and further technical development.

---

## Release Contents

Recommended OSF upload set:

```text
Primordial_OS_HIR_Runtime_Prototype_v0.1_Collin_D_Weber.zip
Primordial_OS_HIR_Runtime_Prototype_v0.1_Collin_D_Weber.zip.sha256
README_OSF.md
HIR_Architecture_Specification_v1.0_Collin_D_Weber.md
Primordial_OS_Baseline_Instruction_Set_v1.0_Collin_D_Weber.md
Claude_Final_Verification_Screenshot.png
```

The runtime archive reportedly contains:

```text
primordial_os/
├── README.md
├── MANIFEST.md
├── LIMITATIONS.md
├── CHECKSUMS.sha256
├── config.json
├── sample_audit_log.jsonl
├── __main__.py
├── cli.py
├── hir/
│   ├── kernel.py
│   ├── equations.py
│   ├── failure_modes.py
│   ├── state.py
│   └── config.py
├── gates/
│   ├── action.py
│   └── diamond.py
├── audit/
│   └── log.py
├── web/
│   ├── server.py
│   └── index.html
├── scenarios/
│   └── examples.py
└── tests/
    └── test_kernel.py
```

---

## Verification Summary

Final Claude-reported verification from the packaged archive:

```text
Archive:  Primordial_OS_HIR_Runtime_Prototype_v0.1_Collin_D_Weber.zip
Size:     50,406 bytes
Files:    26 files
SHA-256:  85b9fdf98a4a3258aa38f92d18124c529d47e535c8b3e2e36f36715c217a34d2

sha256sum -c CHECKSUMS.sha256 → 25/25 OK
python -m unittest primordial_os.tests.test_kernel → 24/24 pass
sample audit log → 7 records, chain intact
dashboard endpoints → responding
GREEN scenario → routes to execute
RED carceral scenario → routes to halt
/api/verify → returns intact
python -m primordial_os demo → all 7 scenarios route as expected
```

---

## Local Checksum Verification

On Windows PowerShell, verify the release archive with:

```powershell
Get-FileHash ".\Primordial_OS_HIR_Runtime_Prototype_v0.1_Collin_D_Weber.zip" -Algorithm SHA256
```

Expected SHA-256:

```text
85b9fdf98a4a3258aa38f92d18124c529d47e535c8b3e2e36f36715c217a34d2
```

A matching checksum confirms that the archive being reviewed is the same packaged prototype described in this release note.

---

## Running the Prototype

From the extracted archive folder:

```bash
python -m primordial_os demo
python -m primordial_os repl
python -m primordial_os serve
python -m primordial_os verify-audit
python -m unittest primordial_os.tests.test_kernel -v
```

Default local dashboard:

```text
http://127.0.0.1:8765
```

---

## What This Prototype Demonstrates

The v0.1 prototype demonstrates a software structure for:

- HIR runtime / governance-kernel logic
- Diamond validation gates
- Honesty / Integrity / Respect checks
- Green / Yellow / Red state routing
- Configurable equation parameters
- Failure-mode detection
- Append-only hash-chained audit logging
- Sample audit-log verification
- Dashboard server and HTML interface
- CLI / demo / test suite behavior

The runtime is intended to test whether the HIR framework can be expressed as an operational structure for bounded AI/system autonomy.

---

## What This Is Not

This release should **not** be represented as:

- a finished operating system,
- a bootable hardware OS,
- production-ready infrastructure,
- a security-certified runtime,
- a replacement for formal engineering review,
- a replacement for scientific validation,
- a replacement for human stewardship or oversight.

It is a prototype governance/runtime layer for research, inspection, and further development.

---

## HIR Architecture Context

The supporting architecture specification defines the HIR Kernel as the policy/truth layer and maps:

```text
Honesty  → signal fidelity, provenance, logging, attestation
Integrity → structural consistency, invariants, state machines, transactions
Respect  → non-destructive interaction, capabilities, isolation, quotas
Resonance → system health under pressure
```

The baseline instruction set establishes that:

```text
HIR = baseline / kernel logic
OAM = diagnostic mirror / degradation lens
Purpose = knowledge alignment + life alignment
AI misuse = OAM-side degradation pattern
```

The governing threshold is **resonance**, not mere coherence.

---

## Authorship and Attribution

**Primordial Calculus / HIR / Primordial OS**  
**Created and Developed by Collin D. Weber**

This release is provided for public documentation, inspection, and research review. Attribution is included for integrity of transmission and provenance tracking.

---

## Suggested Citation

Weber, Collin D. *Primordial OS HIR Runtime Prototype v0.1*. Primordial Calculus / HIR Framework. OSF release package, 2026.

---

## Release Status

Status: **Prototype v0.1**  
Review level: **Early technical prototype / public inspection package**  
Primary use: **Documentation, review, reproducibility inspection, and further development**