Skip to content

Commit f0406af

Browse files
author
Jonathan D.A. Jewell
committed
Auto-commit: Sync changes [2026-02-21]
1 parent fb19560 commit f0406af

6 files changed

Lines changed: 167 additions & 742 deletions

File tree

‎README.adoc‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -421,3 +421,8 @@ Contributions welcome! We're looking for:
421421
* **Documentation writers** — Improve tutorials and guides
422422

423423
See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc] for workflow details.
424+
425+
426+
== Architecture
427+
428+
See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.

‎TOPOLOGY.md‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
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+
# Anvomidav — Project Topology
6+
7+
## System Architecture
8+
9+
```
10+
┌─────────────────────────────────────────┐
11+
│ CHOREOGRAPHER │
12+
│ (.anv Source Files / CLI) │
13+
└───────────────────┬─────────────────────┘
14+
│
15+
▼
16+
┌─────────────────────────────────────────┐
17+
│ ANV-CLI (RUST) │
18+
│ (check, parse, lex, fmt, new) │
19+
└───────────────────┬─────────────────────┘
20+
│
21+
▼
22+
┌─────────────────────────────────────────┐
23+
│ COMPILER PIPELINE │
24+
│ │
25+
│ ┌───────────┐ ┌───────────────────┐ │
26+
│ │anv-syntax │ │ anv-types │ │
27+
│ │ (Logos/ │ │ (Type Checking) │ │
28+
│ │ Chumsky) │ │ │ │
29+
│ └─────┬─────┘ └────────┬──────────┘ │
30+
│ │ │ │
31+
│ └────────┬────────┘ │
32+
│ ▼ │
33+
│ ┌────────────────┐ │
34+
│ │ anv-semantics │ │
35+
│ │ (ISU Rules │ │
36+
│ │ Validation) │ │
37+
│ └────────┬────────┘ │
38+
└─────────────────│───────────────────────┘
39+
│
40+
▼
41+
┌─────────────────────────────────────────┐
42+
│ ANV-CORE │
43+
│ (Skating Types, Diagnostics) │
44+
└─────────────────────────────────────────┘
45+
46+
┌─────────────────────────────────────────┐
47+
│ REPO INFRASTRUCTURE │
48+
│ .machine_readable/ (STATE.a2ml) │
49+
│ Cargo Workspace (Monorepo) │
50+
│ Test Suite (90+ Passing) │
51+
└─────────────────────────────────────────┘
52+
```
53+
54+
## Completion Dashboard
55+
56+
```
57+
COMPONENT STATUS NOTES
58+
───────────────────────────────── ────────────────── ─────────────────────────────────
59+
COMPILER PIPELINE
60+
anv-syntax (Lexer/Parser) ██████████ 100% Logos/Chumsky stable
61+
anv-types (Type Checker) ██████████ 100% Domain types verified
62+
anv-semantics (ISU Rules) ██████████ 100% Singles/Pairs/Dance rules active
63+
anv-cli (clap 4) ██████████ 100% Full command set verified
64+
65+
CORE & DISCIPLINES
66+
anv-core ██████████ 100% Core skating types stable
67+
Singles Discipline ██████████ 100% Short & Free support
68+
Pairs Discipline ██████████ 100% Lifts, twists, spirals active
69+
Ice Dance Discipline ██████████ 100% Pattern & Rhythm dance stable
70+
71+
REPO INFRASTRUCTURE
72+
miette Diagnostics ██████████ 100% Fancy error hints verified
73+
Justfile ██████████ 100% Standard build automation
74+
.machine_readable/ ██████████ 100% STATE.a2ml tracking
75+
76+
─────────────────────────────────────────────────────────────────────────────
77+
OVERALL: ██████████ 100% Core language features complete
78+
```
79+
80+
## Key Dependencies
81+
82+
```
83+
anv-syntax ──────► anv-types ──────► anv-semantics ──────► anv-cli
84+
│ │ │
85+
└───────────────┴────────┬──────────┴───────────────┐
86+
▼
87+
anv-core
88+
```
89+
90+
## Update Protocol
91+
92+
This file is maintained by both humans and AI agents. When updating:
93+
94+
1. **After completing a component**: Change its bar and percentage
95+
2. **After adding a component**: Add a new row in the appropriate section
96+
3. **After architectural changes**: Update the ASCII diagram
97+
4. **Date**: Update the `Last updated` comment at the top of this file
98+
99+
Progress bars use: `█` (filled) and `░` (empty), 10 characters wide.
100+
Percentages: 0%, 10%, 20%, ... 100% (in 10% increments).

0 commit comments

Comments
 (0)