Skip to content

Commit 16ae1e9

Browse files
Add manifest documenting languages and setup (#18)
Provides a quick reference for all languages in the ecosystem including: - Summary table with status, domain, and run commands - Detailed sections for each of the 8 core languages - Additional languages (betlang, julia-the-viper, etc.) - Status indicators (synced, diverged, not synced) - Quick start instructions for submodule setup Co-authored-by: Claude <noreply@anthropic.com>
1 parent 7616bab commit 16ae1e9

1 file changed

Lines changed: 336 additions & 0 deletions

File tree

MANIFEST.md

Lines changed: 336 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,336 @@
1+
# Language Manifest
2+
3+
> Quick reference for all languages in the NextGen Languages ecosystem.
4+
5+
## Summary
6+
7+
| Language | Status | Domain | Implementation | Run Command |
8+
|----------|--------|--------|----------------|-------------|
9+
| [Solo](#solo) | 🟡 TO VERIFY | Systems Programming | Rust | `cargo run` |
10+
| [Duet](#duet) | 🟡 TO VERIFY | AI-Assisted Dev | Rust | `cargo run` |
11+
| [Ensemble](#ensemble) | 🟡 TO VERIFY | AI-Native Apps | Rust | `cargo run` |
12+
| [Phronesis](#phronesis) | 🔴 DIVERGED | AI Ethics/Safety | Elixir | `mix run` |
13+
| [Eclexia](#eclexia) | 🔴 NOT SYNCED | Sustainable Computing | Rust | `cargo run` |
14+
| [Oblíbený](#oblíbený) | 🔴 DIVERGED | Security-Critical | Rust | `cargo run` |
15+
| [Anvomidav](#anvomidav) | ⚠️ NAMING ISSUE | Real-Time Systems | LLVM/Rust | `cargo run` |
16+
| [WokeLang](#wokelang) | 🔴 DIVERGED | Human-Centric | Rust | `cargo run` |
17+
| [betlang](#betlang) | 🟡 TO VERIFY | Probabilistic | Racket | `racket main.rkt` |
18+
| [julia-the-viper](#julia-the-viper) | 🟡 TO VERIFY | Systems (Harvard Arch) | Rust | `cargo run` |
19+
| [AffineScript](#affinescript) | 🟡 TO VERIFY | Type-Safe WASM | OCaml | `dune exec` |
20+
| [Ephapax](#ephapax) | 🟡 TO VERIFY | Linear Semantics | Scheme-like | TBD |
21+
22+
### Status Legend
23+
- 🟢 **SYNCED** - GitHub is up-to-date, ready to use
24+
- 🟡 **TO VERIFY** - Needs sync verification
25+
- 🔴 **DIVERGED** - GitLab and GitHub have different implementations
26+
- 🔴 **NOT SYNCED** - Only exists on GitLab
27+
- ⚠️ **NAMING ISSUE** - Naming conflict between forges
28+
29+
---
30+
31+
## Core Languages (The Eight)
32+
33+
### Solo
34+
**Dependable foundation for systems programming**
35+
36+
| Property | Value |
37+
|----------|-------|
38+
| Status | 🟡 TO VERIFY |
39+
| Paradigm | Imperative, Concurrent, Contract-Based |
40+
| Implementation | Rust |
41+
| Submodule | `my-lang/` (part of family) |
42+
43+
**Key Features:**
44+
- `effect { ... }` - Explicit effect tracking
45+
- `go { ... }` - Structured concurrency
46+
- `where { pre: ..., post: ... }` - Design-by-contract
47+
48+
**Run:**
49+
```bash
50+
cd my-lang && git submodule update --init
51+
cargo run
52+
```
53+
54+
---
55+
56+
### Duet
57+
**AI-assisted development for verifiable software**
58+
59+
| Property | Value |
60+
|----------|-------|
61+
| Status | 🟡 TO VERIFY |
62+
| Paradigm | Imperative, Contract-Based, Neuro-Symbolic |
63+
| Implementation | Rust |
64+
| Submodule | `my-lang/` (part of family) |
65+
66+
**Key Features:**
67+
- `@synth` - AI-powered code synthesis
68+
- `@verify` - Formal verification
69+
- `intent("...")` - Natural language intent
70+
71+
**Run:**
72+
```bash
73+
cd my-lang && git submodule update --init
74+
cargo run --bin duet
75+
```
76+
77+
---
78+
79+
### Ensemble
80+
**AI as a first-class, native component**
81+
82+
| Property | Value |
83+
|----------|-------|
84+
| Status | 🟡 TO VERIFY |
85+
| Paradigm | Imperative, AI-as-Effect |
86+
| Implementation | Rust |
87+
| Submodule | `my-lang/` (part of family) |
88+
89+
**Key Features:**
90+
- `ai_model { ... }` - First-class AI models
91+
- `prompt { ... }` - Type-safe prompts
92+
- `AI<T>` - AI operations as typed effects
93+
94+
**Run:**
95+
```bash
96+
cd my-lang && git submodule update --init
97+
cargo run --bin ensemble
98+
```
99+
100+
---
101+
102+
### Phronesis
103+
**Formal specification of ethical AI frameworks**
104+
105+
| Property | Value |
106+
|----------|-------|
107+
| Status | 🔴 DIVERGED |
108+
| Paradigm | Declarative, Logic-Based, Agent-Oriented |
109+
| Implementation | Elixir (GitHub), Original design (GitLab) |
110+
| Submodule | `phronesis/` |
111+
112+
**Key Features:**
113+
- `Agent.` - Formal agent specification
114+
- `Values:` - Explicit value hierarchy
115+
- `EVALUATE(...)` - Ethical decision evaluation
116+
117+
**Run:**
118+
```bash
119+
cd phronesis && git submodule update --init
120+
mix deps.get && mix run
121+
```
122+
123+
---
124+
125+
### Eclexia
126+
**Sustainable Software Engineering through resource-first constraints**
127+
128+
| Property | Value |
129+
|----------|-------|
130+
| Status | 🔴 NOT SYNCED (Priority 1) |
131+
| Paradigm | Declarative, Constraint-Driven |
132+
| Implementation | Rust (on GitLab only) |
133+
| Submodule | `eclexia/` |
134+
| Notes | Has 70-page white paper on GitLab |
135+
136+
**Key Features:**
137+
- `(energy budget ...)` - Energy consumption constraints
138+
- `(resource ...)` - Resource requirement specs
139+
140+
**Run:**
141+
```bash
142+
# First sync from GitLab!
143+
cd eclexia && git submodule update --init
144+
cargo run
145+
```
146+
147+
---
148+
149+
### Oblíbený
150+
**Provably secure code for hostile environments**
151+
152+
| Property | Value |
153+
|----------|-------|
154+
| Status | 🔴 DIVERGED |
155+
| Paradigm | Turing-Incomplete-Deploy, Metaprogramming |
156+
| Implementation | Rust |
157+
| Submodule | `oblibeny/` |
158+
159+
**Key Features:**
160+
- `(forbid recursion)` - Guaranteed termination
161+
- `(bounded-for ...)` - Bounded iteration only
162+
163+
**Run:**
164+
```bash
165+
cd oblibeny && git submodule update --init
166+
cargo run
167+
```
168+
169+
---
170+
171+
### Anvomidav
172+
**Maximalist formal verification for hard real-time systems**
173+
174+
| Property | Value |
175+
|----------|-------|
176+
| Status | ⚠️ NAMING ISSUE (GitLab calls it "betlang") |
177+
| Paradigm | Functional, Concurrent, Formal-Linear-Session-Types |
178+
| Implementation | LLVM/Rust |
179+
| Submodule | TBD |
180+
181+
**Key Features:**
182+
- `task @sched(EDF)` - Real-time scheduling
183+
- `Linear<T>` - Linear resource tracking
184+
- `Π (...) . T` - Dependent types
185+
186+
**Run:**
187+
```bash
188+
# Resolve naming issue first
189+
cargo run
190+
```
191+
192+
---
193+
194+
### WokeLang
195+
**Human-centric programming focused on consent and well-being**
196+
197+
| Property | Value |
198+
|----------|-------|
199+
| Status | 🔴 DIVERGED |
200+
| Paradigm | Imperative, Natural-Language |
201+
| Implementation | Rust (GitHub), Original design (GitLab) |
202+
| Submodule | `wokelang/` |
203+
204+
**Key Features:**
205+
- `only if okay "..."` - Explicit consent
206+
- `attempt ... or reassure` - Supportive error handling
207+
208+
**Run:**
209+
```bash
210+
cd wokelang && git submodule update --init
211+
cargo run
212+
```
213+
214+
---
215+
216+
## Additional Languages
217+
218+
### betlang
219+
**Probabilistic programming language**
220+
221+
| Property | Value |
222+
|----------|-------|
223+
| Status | 🟡 TO VERIFY |
224+
| Paradigm | Probabilistic |
225+
| Implementation | Racket |
226+
| Submodule | `betlang/` |
227+
228+
**Run:**
229+
```bash
230+
cd betlang && git submodule update --init
231+
racket main.rkt
232+
```
233+
234+
---
235+
236+
### julia-the-viper
237+
**Systems programming with Harvard Architecture**
238+
239+
| Property | Value |
240+
|----------|-------|
241+
| Status | 🟡 TO VERIFY |
242+
| Paradigm | Systems, Provably Halting |
243+
| Implementation | Rust |
244+
| Submodule | `julia-the-viper/` |
245+
246+
**Run:**
247+
```bash
248+
cd julia-the-viper && git submodule update --init
249+
cargo run
250+
```
251+
252+
---
253+
254+
### AffineScript
255+
**Affine types and dependent types for WASM**
256+
257+
| Property | Value |
258+
|----------|-------|
259+
| Status | 🟡 TO VERIFY |
260+
| Paradigm | Functional, Type-Safe |
261+
| Implementation | OCaml |
262+
| Submodule | `affinescript/` |
263+
264+
**Run:**
265+
```bash
266+
cd affinescript && git submodule update --init
267+
dune build && dune exec affinescript
268+
```
269+
270+
---
271+
272+
### Ephapax
273+
**Once-only evaluation with linear semantics**
274+
275+
| Property | Value |
276+
|----------|-------|
277+
| Status | 🟡 TO VERIFY |
278+
| Paradigm | Linear, Security-Focused |
279+
| Implementation | Scheme-like |
280+
| Submodule | `ephapax/` |
281+
282+
**Run:**
283+
```bash
284+
cd ephapax && git submodule update --init
285+
# Implementation-specific command TBD
286+
```
287+
288+
---
289+
290+
## Tooling
291+
292+
### 7-tentacles
293+
**Orchestration and satellite coordination tool**
294+
295+
| Property | Value |
296+
|----------|-------|
297+
| Status | Active |
298+
| Submodule | `7-tentacles/` |
299+
300+
---
301+
302+
## Quick Start
303+
304+
```bash
305+
# Clone with all submodules
306+
git clone --recursive https://github.com/hyperpolymath/nextgen-languages.git
307+
308+
# Or initialize submodules after clone
309+
git submodule update --init --recursive
310+
311+
# Check a specific language
312+
cd <language-dir>
313+
# Follow language-specific run instructions above
314+
```
315+
316+
## Language Family Progression
317+
318+
The **my-lang** family provides an educational progression:
319+
320+
```
321+
Me (ages 6-8) → Visual/block-based programming
322+
323+
Solo (ages 8-10) → First text-based, simple syntax
324+
325+
Duet (ages 11-14) → AI-assisted, collaborative features
326+
327+
Ensemble (ages 15-18) → Full-featured, AI-native, professional
328+
```
329+
330+
---
331+
332+
## See Also
333+
334+
- `LANGUAGES.scm` - Detailed language specifications (Guile Scheme)
335+
- `MIGRATION-STATUS.md` - Sync status between GitLab and GitHub
336+
- `wiki/` - Full documentation

0 commit comments

Comments
 (0)