Skip to content

Commit 20b46f9

Browse files
hyperpolymathclaude
andcommitted
fix: EXPLAINME.adoc — quote README claims, brief format, evidence table
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 215b756 commit 20b46f9

1 file changed

Lines changed: 26 additions & 15 deletions

File tree

EXPLAINME.adoc

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,38 @@
1-
= Julia The Viper — EXPLAINME
2-
:toc: preamble
1+
// SPDX-License-Identifier: PMPL-1.0-or-later
2+
= Julia the Viper — EXPLAINME
33

4-
This document backs up the claims made in README with evidence and rationale.
4+
== "Harvard Architecture Language for Security-Critical Applications"
55

6-
== What Is This?
6+
[quote, README]
7+
____
8+
Julia the Viper is a Harvard Architecture programming language designed to make code injection grammatically impossible. Named after mathematician Julia Robinson (Hilbert's 10th problem) with a playful nod to "adder" (snake + addition), JtV separates computation into two grammatically distinct channels: Control Language (Turing-complete, imperative) and Data Language (Total/provably halting, addition-only).
9+
____
710

8-
Julia The Viper is a hyperpolymath project. See README.adoc for usage.
11+
The core idea is that user-supplied data can never contain control flow because the grammar physically forbids it — not through runtime validation but through separate parse grammars for Control and Data contexts. See link:docs/GRAMMAR_EVOLUTION.md[GRAMMAR_EVOLUTION.md] for the v1/v2 separation rationale and link:docs/QUANTUM_VISION.md[QUANTUM_VISION.md] for the reversible computing extension.
912

10-
== Why These Choices?
13+
**Caveat:** v1 alpha is partially implemented (parser and interpreter stubs exist); the full Rust `jtv-lang` crate referenced in the README is not yet present. v2 (reversible computing) is specification-only.
1114

12-
=== Language
15+
=== Evidence
1316

14-
The language(s) used in this project were chosen per the hyperpolymath
15-
language policy (see CLAUDE.md for the full list of allowed/banned languages).
17+
[cols="1,2", options="header"]
18+
|===
19+
| Path | Proves
1620

17-
=== Architecture
21+
| `examples/basic/`, `examples/advanced/`, `examples/contracts/`
22+
| 17+ example programs demonstrating Control/Data separation exist
1823

19-
Architecture decisions are documented in `.machine_readable/` checkpoint files.
24+
| `packages/jtv-analyzer/`
25+
| Code analyzer component is present (Deno-based)
2026

21-
== Alternatives Considered
27+
| `fuzz/fuzz_targets/fuzz_parser.rs`
28+
| Parser fuzzing exists, confirming grammar-level enforcement approach
2229

23-
(To be filled in as the project matures.)
30+
| `docs/GRAMMAR_EVOLUTION.md`
31+
| v1 vs v2 grammar separation is formally documented
2432

25-
== Proof of Claims
33+
| `docs/QUANTUM_VISION.md`
34+
| Reversible computing / quantum simulation design is documented
2635

27-
(Link formal verification results from the `proven` repo where applicable.)
36+
| `packages/jtv-analyzer/abi/`
37+
| ABI definitions exist for the analyzer layer
38+
|===

0 commit comments

Comments
 (0)