Metadata-Version: 2.4
Name: conrrad
Version: 2.0.2
Summary: CONRRAD — Institutional runtime for persistent, economically governed AI agents.
License: Proprietary
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: qdrant-client>=1.7.0
Requires-Dist: redis>=5.0.0

# CONRRAD — Runtime Preview

**CONRRAD** instruments whether **human operational continuity** survives real work sessions: replay, timeline, Monaco lifecycle, warnings, and longitudinal reports.

*Operational continuity for long-running autonomous systems.* — observe → classify → correlate → falsify.

**$SEAL monetizes evidence; it does not invent evidence.**

This repository is in **evidence certification (A2 / P0–P1)** — observable and falsifiable, **not** a daily driver, marketplace-first product, or autonomous AI OS. *Demonstrate continuity before monetizing evidence.*

| Repo | Role |
|------|------|
| **[conrrad](https://github.com/Greco-Italico/conrrad)** (this tree) | Runtime Preview + Observatory + evidence |
| **[conrrad-sdk](https://github.com/Greco-Italico/conrrad-sdk)** | Public SDK + KAP escrow (`conrrad_sdk/`, `kap_escrow/` legacy names) |

**Auditors (solo 2 ZIP):** [`docs/CONRRAD_A2_MASTER_AUDITOR_HANDOFF.md`](docs/CONRRAD_A2_MASTER_AUDITOR_HANDOFF.md) — entrada única. Detalle: [`docs/AUDITOR_FILE_MAP_CONRRAD_SESSION.md`](docs/AUDITOR_FILE_MAP_CONRRAD_SESSION.md). Evidencia longitudinal: [`docs/walkthrough_long_session_sim.md`](docs/walkthrough_long_session_sim.md). Visión canónica: [`docs/CONRRAD_VISION_CANON.md`](docs/CONRRAD_VISION_CANON.md). Arquitectura económica: [`docs/ECONOMIC_ORCHESTRATION_ARCHITECTURE.md`](docs/ECONOMIC_ORCHESTRATION_ARCHITECTURE.md).

**Harlemm** (coordination / swarm / escrow) and **Research** (Handoff Gate) are separate planes — [`docs/ARCHITECTURE_TWO_PLANES.md`](docs/ARCHITECTURE_TWO_PLANES.md). Handoff Gate → **NO-GO F3**.

| Plane | Status |
|-------|--------|
| **Runtime Preview** | `conrrad-dashboard` + `observatory-server` — active certification |
| **Observatory** | Profiling, warnings, Gate 9h evidence |
| **SDK (modest)** | `conrrad dev` · `smoke` · `report` · `monaco-baseline` |
| **Harlemm** | Legacy in `kernell-os/` — **not** product focus |
| **Research** | Handoff Gate → **NO-GO F3** — no production claims |

> **Legacy paths:** `kernell-os/`, `KERNELL_*` during Fase A migration. [`docs/NAMING_TAXONOMY.md`](docs/NAMING_TAXONOMY.md).

---

## Current focus

CONRRAD is in **productization phase (post–Tier 2)**:

- **Baseline v2 frozen** — session cert Tier 0→2 PASS ([`docs/FREEZE_BASELINE_V2.md`](docs/FREEZE_BASELINE_V2.md))
- **IDE UX** — 8h/day survivability, continuity + economics visible ([`docs/POST_TIER2_IDE_UX_AUDIT.md`](docs/POST_TIER2_IDE_UX_AUDIT.md))
- **Human closed alpha 4h+** — **active now** · [`docs/HUMAN_ALPHA_PROTOCOL.md`](docs/HUMAN_ALPHA_PROTOCOL.md) · `./scripts/human-alpha-preflight.sh`
- Monaco **classify-only** · Handoff Gate **NO-GO F3** — unchanged

The **doctrine is closed**. Current work: **preserve baseline v2** and build **developer experience** — not marketplace, AGI framing, or `core/` changes.

| Certified / frozen | Active now | NO-GO (today) |
|--------------------|------------|---------------|
| Gate 9h · Monaco §16 · Tier 2 harness | IDE flow · trust · economics UX | F3 · marketplace · autonomy theater |
| Baseline v2 (`78c99d4d`) | Human alpha 4h+ | Tuning post-PASS without re-cert |
| Replay + session compression | Tier 2 re-run (2nd host) | Compaction / warm tier / dispose |

**See:**

- [`docs/CONRRAD_SESSION.md`](docs/CONRRAD_SESSION.md) — **único handoff** (Antigravity + Cursor) · §22 post–Tier 2
- [`docs/FREEZE_BASELINE_V2.md`](docs/FREEZE_BASELINE_V2.md) — hashes, thresholds, mutation policy
- [`docs/POST_TIER2_IDE_UX_AUDIT.md`](docs/POST_TIER2_IDE_UX_AUDIT.md) — 5 IDE gaps, alpha protocol
- [`docs/CONRRAD_IDE_PRODUCTION_MASTER.md`](docs/CONRRAD_IDE_PRODUCTION_MASTER.md) — producción IDE · doble barra UX/infra
- [`docs/OPERATIONAL_DISCIPLINE.md`](docs/OPERATIONAL_DISCIPLINE.md) — P0/P1/P2, gates, prohibitions

**Monaco today:** `classifyOnlyMode` — observe → classify → dry-run. **No** intelligent dispose, compaction, or warm tier until Gate 9h evidence.

---

## Quick start (daily dev)

```bash
# From workspace root
./scripts/conrrad dev          # Runtime Preview (:3000 + Observatory :23817)
./scripts/conrrad smoke        # Health check
./scripts/conrrad report --label=session --duration-min=45
```

Full guide: [`docs/SDK_DAILY_DEV_PLAN.md`](docs/SDK_DAILY_DEV_PLAN.md)  
Production path: [`docs/PRODUCTION_RUNTIME_ROADMAP.md`](docs/PRODUCTION_RUNTIME_ROADMAP.md)  
Gate 9h: [`docs/GATE_9H_HUMAN.md`](docs/GATE_9H_HUMAN.md)

---

## Repository layout

```
observatory-server/     CONRRAD Observatory (server)
conrrad_session/        Operational context continuity (§21 CONRRAD_SESSION.md)
conrrad-dashboard/      CONRRAD Runtime Preview (UI)
scripts/conrrad           CONRRAD SDK CLI
runtime/                  Runtime plane pointer
research/                 Research plane pointer
handoff-gate-evidence/    Frozen experiments (do not rename)
ger-benchmarks/           GER/GQI cohort (research vocabulary)
.conrrad-evidence/        A2 human / soak reports
docs/                     Doctrine + operational docs
experimental/             Map: legacy / research / labs (no code move yet)
kernell-os/               Legacy path — agents, Harlemm, kap_escrow (Fase B/C rename)
```

---

## Telemetry

Opt-in only. **Off by default.**

```bash
export CONRRAD_TELEMETRY=true
# Legacy alias still read during migration:
# export KERNELL_TELEMETRY=true
```

Aggregated operational metrics only — no prompts or user content. Details in legacy `core/telemetry_persistence.py` when using Harlemm swarm paths.

---

## What this is not (yet)

- Not a replacement for Cursor  
- Not an “AI Operating System” or autonomous swarm product  
- Not F3 / Harlemm-as-primary-IDE (Handoff Gate → **NO-GO** until new evidence)  
- Not marketing claims (heap %, “faster than Cursor”) — only longitudinal reports  

---

## Brand (Fase A — now)

Same symbol as legacy; **wordmark CONRRAD** in UI and docs. No “Kernell OS” in Runtime Preview. Full visual redesign → post Gate 9h. See [`docs/CONRRAD_SESSION.md`](docs/CONRRAD_SESSION.md) §19.

## Doctrine & session handoff

- [`docs/CONRRAD_SESSION.md`](docs/CONRRAD_SESSION.md) — **only live handoff**  
- [`docs/OPERATIONAL_DISCIPLINE.md`](docs/OPERATIONAL_DISCIPLINE.md)  
- [`docs/runtime/WARNING_BASELINES.md`](docs/runtime/WARNING_BASELINES.md)  
- [`docs/GITHUB_AUDITOR_SYNC.md`](docs/GITHUB_AUDITOR_SYNC.md)
