rivox 1.0.0

Universal polyglot build coordination layer for Python, Rust, and Node monorepos
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# Rivox Architecture Specification

Rivox V1 is structured as a modular Rust workspace in `c:\Users\Aaryan Rawat\Documents\Rivox`.

```
+-------------------------------------------------------------------------------+
|                             rivox CLI Coordinator                             |
|  ┌─────────────┐   ┌─────────────┐   ┌─────────────┐   ┌───────────────────┐  |
|  │   Adapter   │   │   Adapter   │   │   Adapter   │   │   Unified Graph   │  |
|  │    (uv)     │   │   (cargo)   │   │   (pnpm)    │   │      Builder      │  |
|  └──────┬──────┘   └──────┬──────┘   └──────┬──────┘   └─────────┬─────────┘  |
|         └─────────────────┴─────────────────┴───────────────────┘             |
|                                     │                                         |
|                            ┌────────┴────────┐                                |
|                            │ Sandbox Engine  │                                |
|                            └────────┬────────┘                                |
|                                     │                                         |
|                            ┌────────┴────────┐                                |
|                            │   Provenance    │                                |
|                            └────────┬────────┘                                |
+----------------─────────────────────┼────────────────────────────────---------+
                                      │ REAPI (gRPC) / Local CAS
                            ┌─────────┴──────────┐
                            │ Content Addressed  │
                            │   Storage (CAS)    │
                            └────────────────────┘
```

## Module Breakdown

1. **Ingestion Adapters (`src/adapters/`)**: Wraps `uv`, `cargo`, and `pnpm`. Resolves dependencies via native tools and parses lockfiles into `GraphNode` records.
2. **Unified Graph Builder (`src/graph/`)**: Merges ecosystem subgraphs with `rivox.toml` cross-refs into a `petgraph::DiGraph`.
3. **Content-Addressed Cache (`src/cache/`)**: Computes Merkle subtree cache keys (`sha256(...)`) and stores file blobs and directory manifest trees in `~/.rivox/cache/cas`.
4. **Sandbox Execution Engine (`src/sandbox/`)**: Isolates compilation steps using Linux unprivileged namespaces and macOS Seatbelt sandbox profiles.
5. **Provenance Emitter (`src/provenance/`)**: Formats in-toto, SLSA Level 2, SPDX 2.3 JSON SBOMs, and performs Sigstore Rekor registration.
6. **Conformance Suite (`src/conformance/`)**: Verifies 100% equivalence between Rivox graph representation and native tool resolution outputs.