Builder OS Runtime

Public, fixture-backed runtime slice behind Patton Build.

This repository exists as technical proof of work. It shows the agent runtime pattern Patton Build uses for source-backed workflows, approval-gated drafts, audit events, and scoped memory signals without exposing production code, customer data, credentials, or private operating history.

What It Demonstrates

• Prompt routing into explicit workflow contracts.
• Role-agent ownership for finance, operations, field, documents, risk, and executive workflows.
• Read-only mock connectors with provenance, freshness, confidence, and missing-data behavior.
• Conservative answer envelopes that separate source evidence, draft payloads, approval requirements, audit events, and recommended next actions.
• Approval recording that never performs external actions in this public slice.
• Deterministic tests for workflow contracts, safety policy, routing, envelopes, and local JSONL history.

Why It Is Fixture-Backed

The production/customer systems stay private. This repo intentionally uses local fixtures instead of live credentials or network calls so reviewers can inspect and run the runtime safely.

The safety boundary is the point:

flowchart LR
  A["Prompt"] --> B["Prompt Router"]
  B --> C["WorkflowSpec"]
  C --> D["Role Agent"]
  D --> E["Mock Connector Reads"]
  E --> F["AnswerEnvelope"]
  F --> G{"Approval Required?"}
  G -- "No" --> H["Audit Event"]
  G -- "Yes" --> I["Decision Queue Draft"]
  I --> J["Approval Action Recorded"]
  J --> H
  H --> K["Memory Signal"]

Loading

Quick Start

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

builder-os-runtime "What do I need to know this morning?" --pretty
builder-os-runtime "Draft this week's customer update." --pretty
builder-os-runtime --workflow cash-this-week --pretty

pytest -q

Reviewer Path

Start with:

• builder_os_runtime/contracts.py for the core envelope, approval, source, audit, and workflow types.
• builder_os_runtime/workflow_specs.py for the workflow catalog and approval gates.
• builder_os_runtime/runner.py for the fixture-backed runtime path.
• builder_os_runtime/policy.py for the safety classifier.
• tests/test_runtime_contracts.py for expected behavior.

What Is Intentionally Omitted

• Live accounting, email, file, permitting, payroll, or customer-system connectors.
• Production persistence and external write-back adapters.
• Private repos, customer-specific data, local machine paths, credentials, and generated runtime state.

This is the public proof slice, not the production deployment.

License

Source-available portfolio artifact. No open-source license is granted; all rights are reserved by Connor Patton / Patton AI LLC.