Skip to content

Commit 180be39

Browse files
author
Jonathan D.A. Jewell
committed
Auto-commit: Sync changes [2026-02-21]
1 parent 9c7ac77 commit 180be39

2 files changed

Lines changed: 107 additions & 0 deletions

File tree

‎README.adoc‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,3 +109,8 @@ Deployment is handled via Podman to ensure cross-platform compatibility across e
109109
----
110110
just deploy-nerctl
111111
----
112+
113+
114+
== Architecture
115+
116+
See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.

‎TOPOLOGY.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
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+
# empty-linter — Project Topology
6+
7+
## System Architecture
8+
9+
```
10+
┌─────────────────────────────────────────┐
11+
│ OPERATOR / AGENT │
12+
│ (just audit / correct / shell) │
13+
└───────────────────┬─────────────────────┘
14+
│
15+
▼
16+
┌─────────────────────────────────────────┐
17+
│ ORCHESTRATION LAYER │
18+
│ ┌───────────┐ ┌───────────────────┐ │
19+
│ │ Nickel │ │ Justfile │ │
20+
│ │ (config) │ │ (Task Runner) │ │
21+
│ └─────┬─────┘ └────────┬──────────┘ │
22+
└────────│─────────────────│──────────────┘
23+
│ │
24+
▼ ▼
25+
┌─────────────────────────────────────────┐
26+
│ LOGIC LAYER (RESCRIPT) │
27+
│ (Negative-Space Diagnostics, Fixes) │
28+
│ ┌───────────┐ ┌───────────────────┐ │
29+
│ │ Audit │ │ Correction │ │
30+
│ │ Engine │ │ (Sanitization) │ │
31+
│ └─────┬─────┘ └────────┬──────────┘ │
32+
└────────│─────────────────│──────────────┘
33+
│ │
34+
▼ ▼
35+
┌─────────────────────────────────────────┐
36+
│ RUNTIME (DENO) │
37+
│ (Secure FS access, JS execution) │
38+
└──────────┬───────────────────┬──────────┘
39+
│ │
40+
▼ ▼
41+
┌───────────────────────┐ ┌────────────────────────────────┐
42+
│ IDRIS INSIDE (PROVEN) │ │ TARGET FILESYSTEM │
43+
│ - SafeWhitespace │ │ (Purging NBSP, ZWSP, │
44+
│ - SafePath, SafeHex │ │ Null Bytes) │
45+
└───────────────────────┘ └────────────────────────────────┘
46+
47+
┌─────────────────────────────────────────┐
48+
│ REPO INFRASTRUCTURE │
49+
│ Multi-Shell Shims .machine_readable/ │
50+
│ VS Code Extension Userscripts │
51+
└─────────────────────────────────────────┘
52+
```
53+
54+
## Completion Dashboard
55+
56+
```
57+
COMPONENT STATUS NOTES
58+
───────────────────────────────── ────────────────── ─────────────────────────────────
59+
DIAGNOSTIC CORE
60+
Audit Engine (ReScript) ██████████ 100% NBSP/ZWSP detection stable
61+
Correction Logic ██████████ 100% 0xA0 -> 0x20 auto-fix active
62+
Magenta Crap-Overlay ████████░░ 80% Offset reporting verified
63+
64+
LOGIC & VERIFICATION
65+
Idris Inside (proven) ██████████ 100% SafeWhitespace modules active
66+
SafePath / SafeHex ██████████ 100% FS access verified
67+
Nickel config.ncl ██████████ 100% Structural intent defined
68+
69+
INTERFACES & DEPLOY
70+
Justfile Automation ██████████ 100% Audit/Correct/Deploy recipes
71+
Multi-Shell Registry ████████░░ 80% 18+ shell shims expanding
72+
VS Code Extension ██████░░░░ 60% Real-time linting in progress
73+
74+
REPO INFRASTRUCTURE
75+
Deno Tooling ██████████ 100% Secure-by-default execution
76+
.machine_readable/ ██████████ 100% STATE.adoc tracking
77+
Podman / nerdctl build ██████████ 100% Deterministic containers
78+
79+
─────────────────────────────────────────────────────────────────────────────
80+
OVERALL: █████████░ ~90% Alpha release production-ready
81+
```
82+
83+
## Key Dependencies
84+
85+
```
86+
Nickel Config ───► Just Runner ───► Deno Exec ───► ReScript Logic
87+
│ │
88+
▼ ▼
89+
Target FS ◄──── Proven Proofs
90+
```
91+
92+
## Update Protocol
93+
94+
This file is maintained by both humans and AI agents. When updating:
95+
96+
1. **After completing a component**: Change its bar and percentage
97+
2. **After adding a component**: Add a new row in the appropriate section
98+
3. **After architectural changes**: Update the ASCII diagram
99+
4. **Date**: Update the `Last updated` comment at the top of this file
100+
101+
Progress bars use: `█` (filled) and `░` (empty), 10 characters wide.
102+
Percentages: 0%, 10%, 20%, ... 100% (in 10% increments).

0 commit comments

Comments
 (0)