Skip to content

Commit c98825b

Browse files
author
Jonathan D.A. Jewell
committed
Auto-commit: Sync changes [2026-02-22]
1 parent 6a0b075 commit c98825b

5 files changed

Lines changed: 174 additions & 3002 deletions

File tree

‎README.adoc‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -345,3 +345,8 @@ See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc] for contribution guidelines.
345345
== Security
346346

347347
See link:SECURITY.md[SECURITY.md] for security policy and vulnerability reporting.
348+
349+
350+
== Architecture
351+
352+
See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.

‎TOPOLOGY.md‎

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
2+
<!-- TOPOLOGY.md — Project architecture map and completion dashboard -->
3+
<!-- Last updated: 2026-02-19 -->
4+
5+
# VAE Dataset Normalizer (zerostep) — Project Topology
6+
7+
## System Architecture
8+
9+
```
10+
┌─────────────────────────────────────────┐
11+
│ ML RESEARCHER │
12+
│ (CLI / Julia Notebook) │
13+
└───────────────────┬─────────────────────┘
14+
│ Normalize / Train
15+
▼
16+
┌─────────────────────────────────────────┐
17+
│ VAE NORMALIZER CORE │
18+
│ ┌───────────┐ ┌───────────────────┐ │
19+
│ │ Splitter │ │ Checksum Engine │ │
20+
│ │ (Rust) │ │ (SHAKE256) │ │
21+
│ └─────┬─────┘ └────────┬──────────┘ │
22+
│ │ │ │
23+
│ ┌─────▼─────┐ ┌────────▼──────────┐ │
24+
│ │ Diff Comp │ │ Metadata Layer │ │
25+
│ │ (Storage) │ │ (CUE / Nickel) │ │
26+
│ └─────┬─────┘ └────────┬──────────┘ │
27+
└────────│─────────────────│──────────────┘
28+
│ │
29+
▼ ▼
30+
┌─────────────────────────────────────────┐
31+
│ VERIFICATION & ML │
32+
│ ┌───────────┐ ┌───────────────────┐ │
33+
│ │ Isabelle │ │ Contrastive Model│ │
34+
│ │ (Proofs) │ │ (Julia/Flux.jl) │ │
35+
│ └───────────┘ └───────────────────┘ │
36+
└───────────────────┬─────────────────────┘
37+
│
38+
▼
39+
┌─────────────────────────────────────────┐
40+
│ OUTPUT DATASET │
41+
│ (Train/Test/Val/Calib Splits) │
42+
└─────────────────────────────────────────┘
43+
44+
┌─────────────────────────────────────────┐
45+
│ REPO INFRASTRUCTURE │
46+
│ Justfile Automation .machine_readable/ │
47+
│ Nix / Wolfi 0-AI-MANIFEST.a2ml │
48+
└─────────────────────────────────────────┘
49+
```
50+
51+
## Completion Dashboard
52+
53+
```
54+
COMPONENT STATUS NOTES
55+
───────────────────────────────── ────────────────── ─────────────────────────────────
56+
CORE NORMALIZATION
57+
Dataset Splitter (Rust) ██████████ 100% Random & Stratified stable
58+
SHAKE256 Checksums ██████████ 100% FIPS 202 compliant verified
59+
Diff-based Compression ██████████ 100% ~50% storage reduction verified
60+
Stats & Manifest Gen ██████████ 100% JSON/CSV exports active
61+
62+
VERIF & LEARNING
63+
Isabelle/HOL Proofs ██████████ 100% Split properties verified
64+
Contrastive Model (Julia) ██████████ 100% Artifact detection active
65+
Flux.jl Integration ██████████ 100% Data loaders verified
66+
67+
REPO INFRASTRUCTURE
68+
Justfile Automation ██████████ 100% Standard build/train tasks
69+
.machine_readable/ ██████████ 100% STATE tracking active
70+
RSR Compliance (MAA) ██████████ 100% Accountability verified
71+
72+
─────────────────────────────────────────────────────────────────────────────
73+
OVERALL: ██████████ 100% Production-ready ML infrastructure
74+
```
75+
76+
## Key Dependencies
77+
78+
```
79+
Raw Dataset ──────► Checksum Engine ────► Diff Comp ──────► Dataset Splits
80+
│ │ │ │
81+
▼ ▼ ▼ ▼
82+
CUE Schema ───────► Nickel Config ─────► Isabelle Proof ───► Julia Model
83+
```
84+
85+
## Update Protocol
86+
87+
This file is maintained by both humans and AI agents. When updating:
88+
89+
1. **After completing a component**: Change its bar and percentage
90+
2. **After adding a component**: Add a new row in the appropriate section
91+
3. **After architectural changes**: Update the ASCII diagram
92+
4. **Date**: Update the `Last updated` comment at the top of this file
93+
94+
Progress bars use: `█` (filled) and `░` (empty), 10 characters wide.
95+
Percentages: 0%, 10%, 20%, ... 100% (in 10% increments).

0 commit comments

Comments
 (0)