OpenBuildApp

OpenBuildApp is a reversible, evidence-driven software cognition platform.

The repository is organized as a filesystem-first monorepo that treats the run folder as the primary unit of work. Every meaningful execution step writes durable artifacts, emits append-only events, and preserves enough state to replay, verify, and audit the system later.

Repository Map

apps/                  frontend applications
packages/              reusable runtime libraries
services/              deployable backends and workers
workspace/             runtime workspace, templates, runs, schemas, and agents
docs/                  architecture and milestone documentation
schemas/               canonical schema catalog and registry metadata
scripts/               repo automation and validation scripts
examples/              example requests and seeded artifacts
tests/                 unit and integration tests

Core Runtime Systems

• packages/run-engine: deterministic run creation, checkpoints, artifact tracking
• services/orchestrator: orchestration state machine, dispatch, retries, stop conditions
• packages/agent-runtime: contract loading, structured outputs, agent execution wrappers
• services/observer-web: MVP observation adapter for web URLs and source folders
• packages/cognitive-graph: graph nodes, edges, confidence, invalidation, merge rules
• packages/hypothesis-engine: testable hypotheses and validation state
• packages/replay-engine: replay timeline, divergence detection, snapshot references
• packages/verification-engine: hard gates, weighted fidelity, perceptual checks
• packages/repair-engine: defect clustering, repair planning, repair validation
• packages/safety-kernel: policy evaluation, approval queue, redaction, mutation gating
• services/dashboard-backend: live run status, replay feeds, evidence read models

First Commands

• node scripts/validate-schemas.mjs
• node scripts/bootstrap-example-run.mjs
• node --test

Reference Docs

• System design
• Repository architecture
• Implementation roadmap
• Lane system