HP OS

HP OS is a strict, local-first agentic operating system designed to safely bridge the gap between AI capabilities and deterministic control-plane architecture. It implements an uncompromising architecture that isolates AI reasoning from execution authority.

Vision and Local-First Design

The vision for HP OS is to create a secure operating system for AI agents where human-in-the-loop control is mathematically guaranteed by the architecture, not just by prompts or model alignment. By relying on a local-first design, HP OS ensures privacy, data locality, and deterministic boundary checking. All memory and state are strictly controlled by Python dataclasses and SQLite, never by the LLM itself.

Architecture Layers

The HP OS project is developed through a rigorous 41-milestone progression, categorized into 5 distinct architectural layers:

• Foundation Layer (M01-M09): Establishes the deterministic state envelopes, synchronous pipelines, and memory stewardship rules.
• AI Pipeline Layer (M10-M22): Integrates local LLM reasoning (via Ollama) purely as a text generator, establishing strict schemas and adversarial boundaries.
• Safety / Governance Layer (M23-M29): Implements state tracking, policy engines, and capability registries without introducing active execution.
• Execution Boundary Layer (M30-M39): Constructs the Executor interfaces, sandbox simulations, and final execution readiness checks.
• Agent Runtime Layer (M40-M41): Creates the Agent Orchestration boundary where agent proposals are deterministically validated before entering the control plane.

Current Execution Mode

IMPORTANT: Currently, HP OS operates in a strictly non-executing mode.

All execution capability is routed through a SandboxExecutor which simulates outputs for bounded verification. Real-world side effects (shell commands, file modifications, network requests) are structurally prohibited. An AgentProposal has zero execution authority and cannot execute without a valid, policy-checked, and manually approved ExecutionRequest.

Milestone Phases (M01 - M41)

The complete history, documentation, build instructions, and completion summaries of all 41 milestones are preserved in the milestones/ directory and synthesized in docs/HP_OS_MASTER_MILESTONE_REGISTRY.md.

How to Run

1. Clone this repository.
2. Ensure you have Python 3.9+ installed.
3. Install dependencies: pip install -r requirements.txt (if applicable) or rely on pytest.
4. Run the bounded test suites to verify mechanical isolation:

   python -m pytest tests/ -v

5. Do NOT attempt to enable real execution; the executor boundary is purposefully restricted to the SandboxExecutor.