Skip to content

Commit 2e207c1

Browse files
GiniGini
authored andcommitted
docs: freeze ONEVibe backend contracts
1 parent 293e550 commit 2e207c1

2 files changed

Lines changed: 5 additions & 0 deletions

File tree

docs/IMPLEMENTATION-LOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,3 +84,4 @@
8484
- Added an agent-callable, schema-constrained slide renderer. For Slide mode, Claude must supply exactly eight bounded title/summary pairs to a local MCP tool; the server renders genuine PPTX and PDF exports, HTML review view, outline, and speaker notes without granting Bash. A live LiteLLM-routed run produced both binary formats and passed evidence verification.
8585
- Created the dedicated Linear project **ONEVibe — Backend E2E & Manus Parity** and made `ONE-215` the sole active product epic. Its child backlog encodes the backend-first dependency chain from transactional conversations through one-microVM-per-conversation orchestration, in-microVM Claude/LiteLLM, durable streaming, sandbox PPTX/PDF, real-provider failure-injected E2E, and isolation hardening. UX and OpenVTC approval integration are explicitly downstream.
8686
- Completed a second engineering pass over `ONE-215` through `ONE-224`: every ticket now names current code seams, target contracts, dependencies, failure modes, observability, test layers, estimates, and evidence-based DoD. Added six project-linked Linear documents covering management architecture, backend/data contracts, the one-conversation/one-microVM ADR, release gates, risks/open decisions, and the specialist-agent delegation model.
87+
- Consolidated three independent read-only specialist audits for persistence (`ONE-216`), runtime leases (`ONE-217`), and durable event projection (`ONE-219`) into **Backend Contract Freeze v1**. Accepted `better-sqlite3` behind a PostgreSQL-compatible repository/Unit-of-Work boundary because the current Node 22 core SQLite API remains experimental; froze generation-fenced conversation leases, durable provider operations, versioned native-event projection, message projection, quarantine, and `Last-Event-ID` SSE semantics before parallel implementation.

docs/LINEAR-BOARD.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ Linear also serves as the management and architecture review hub:
1212
- [Release Gates and Evidence Matrix](https://linear.app/onecomputer/document/onevibe-release-gates-and-evidence-matrix-57f4789dc493)
1313
- [Risks, Decisions, and Open Questions](https://linear.app/onecomputer/document/onevibe-risks-decisions-and-open-questions-528b7de05f59)
1414
- [Engineering Workstreams and Agent Delegation Model](https://linear.app/onecomputer/document/onevibe-engineering-workstreams-and-agent-delegation-model-2b0ec99f18c5)
15+
- [ADR-002 — Local Transactional Persistence Driver](https://linear.app/onecomputer/document/adr-002-local-transactional-persistence-driver-ec63c2a70f6c)
16+
- [Backend Contract Freeze v1](https://linear.app/onecomputer/document/onevibe-backend-contract-freeze-v1-ef85a800f29d)
1517

1618
The current release gate is [ONE-215](https://linear.app/onecomputer/issue/ONE-215):
1719

@@ -46,3 +48,5 @@ Read the credential at `../handover/onecomputer-handover-secrets-lean/mac/linear
4648
The main agent remains product manager, architecture owner, integration reviewer, and release-evidence owner. Specialist agents receive bounded tickets only after shared interfaces are approved. Persistence (`ONE-216`) lands its repository/schema contract before runtime lifecycle (`ONE-217`) and event ingestion (`ONE-219`) implement against it. At most two mutating workstreams run concurrently until those foundations stabilize; read-only research and design audits may run wider.
4749

4850
A specialist cannot change another workstream's public contract, introduce frontend-authoritative state, downgrade a real-provider acceptance test to a fixture, or mark an issue Done. Each handoff must identify its issue, changed files/interfaces, migrations/configuration, focused tests, failure/security analysis, limitations, and reproduction commands. The main agent runs the full gate, integrates, commits, and updates Linear.
51+
52+
Contract Freeze v1 establishes the initial implementation order and ownership. `ONE-216` owns the database driver, migrations, Unit of Work, conversation/turn/message authority, and JSON importer. `ONE-217` adds runtime leases and provider operations through the same transaction boundary. `ONE-218` produces fenced Claude/LiteLLM native envelopes. `ONE-219` owns native ingestion, versioned projection, message deltas, quarantine, and cursor-based SSE. `ONE-220` owns the in-microVM renderer and artifact manifest. Shared identifiers or transaction semantics change only through main-agent review and an ADR when cross-cutting.

0 commit comments

Comments
 (0)