---
title: CXDB
slug: cxdb
type: system
created: 2026-06-17
updated: 2026-06-17
status: active
tags:
  - observability
  - event-log
  - sqlite
  - diagnosis
sources:
  - dan-shapiro-you-dont-write-code-2026-02-13
  - jleechanorg-dark-factory-repo
related:
  - healer
  - agentic-pipeline-runner
  - code-review-vs-validation
confidence: medium-high
contradictions:
  - Observability can diagnose failures after the fact, but it does not by itself prove generated code is safe.
bead_refs:
  - dark-factory-rr4
---

# CXDB

CXDB is the observability/event-log layer described by Shapiro and implemented in the local dark-factory repository as a SQLite event log for pipeline runs.

## Role

- Record node visits, outcomes, errors, and run metadata.
- Support post-run diagnosis and clustering through [[healer]].
- Provide an audit trail for factory operation.

## Design Implication

`inference:` A dark factory needs run-level provenance as much as code provenance. Without event history, failed autonomous runs are hard to debug and successful runs are hard to trust.