1+ <!--
2+ SPDX-License-Identifier: MPL-2.0
3+ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
4+ -->
15## Machine-Readable Artefacts
26
3- The following files in ` .machine_readable/ ` contain structured project metadata:
7+ The following files in ` .machine_readable/6a2/ ` contain structured project
8+ metadata (a2ml format; the earlier ` .scm ` root-level names are retired):
49
5- - ` STATE.scm ` - Current project state and progress
6- - ` META.scm ` - Architecture decisions and development practices
7- - ` ECOSYSTEM.scm ` - Position in the ecosystem and related projects
8- - ` AGENTIC.scm ` - AI agent interaction patterns
9- - ` NEUROSYM.scm ` - Neurosymbolic integration config
10- - ` PLAYBOOK.scm ` - Operational runbook
10+ - ` 6a2/STATE.a2ml ` - Current project state and progress
11+ - ` 6a2/META.a2ml ` - Architecture decisions (ADRs) and development practices
12+ - ` 6a2/ECOSYSTEM.a2ml ` - Position in the ecosystem and related projects
13+ - ` 6a2/AGENTIC.a2ml ` - AI agent interaction patterns
14+ - ` 6a2/NEUROSYM.a2ml ` - Neurosymbolic integration config
15+ - ` 6a2/PLAYBOOK.a2ml ` - Operational runbook
16+
17+ Self-validation / service metadata lives in ` .machine_readable/svc/ `
18+ (` svc/k9/my-lang-metadata.k9.ncl ` , ` svc/README.adoc ` ). The scope-arrest anchor
19+ is the top-level ` ANCHOR.scope-arrest.2026-01-01.Jewell.scm ` .
1120
1221---
1322
@@ -19,14 +28,14 @@ The following files in `.machine_readable/` contain structured project metadata:
1928
2029| Language/Tool | Use Case | Notes |
2130| ---------------| ----------| -------|
22- | ** ReScript ** | Primary application code | Compiles to JS, type-safe |
31+ | ** AffineScript ** | Primary application code | Compiles to JS, type-safe |
2332| ** Deno** | Runtime & package management | Replaces Node/npm/bun |
2433| ** Rust** | Performance-critical, systems, WASM | Preferred for CLI tools |
2534| ** Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI |
2635| ** Dioxus** | Mobile apps (native UI) | Pure Rust, React-like |
2736| ** Gleam** | Backend services | Runs on BEAM or compiles to JS |
2837| ** Bash/POSIX Shell** | Scripts, automation | Keep minimal |
29- | ** JavaScript** | Only where ReScript cannot | MCP protocol glue, Deno APIs |
38+ | ** JavaScript** | Only where AffineScript cannot | MCP protocol glue, Deno APIs |
3039| ** Nickel** | Configuration language | For complex configs |
3140| ** Guile Scheme** | State/meta files | STATE.scm, META.scm, ECOSYSTEM.scm |
3241| ** Julia** | Batch scripts, data processing | Per RSR |
@@ -37,13 +46,13 @@ The following files in `.machine_readable/` contain structured project metadata:
3746
3847| Banned | Replacement |
3948| --------| -------------|
40- | TypeScript | ReScript |
49+ | TypeScript | AffineScript |
4150| Node.js | Deno |
4251| npm | Deno |
4352| Bun | Deno |
4453| pnpm/yarn | Deno |
4554| Go | Rust |
46- | Python | Julia/Rust/ReScript |
55+ | Python | Julia/Rust/AffineScript |
4756| Java/Kotlin | Rust/Tauri/Dioxus |
4857| Swift | Tauri/Dioxus |
4958| React Native | Tauri/Dioxus |
@@ -53,18 +62,18 @@ The following files in `.machine_readable/` contain structured project metadata:
5362
5463** No exceptions for Kotlin/Swift** - use Rust-first approach:
5564
56- 1 . ** Tauri 2.0+** - Web UI (ReScript ) + Rust backend, MIT/Apache-2.0
65+ 1 . ** Tauri 2.0+** - Web UI (AffineScript ) + Rust backend, MIT/Apache-2.0
57662 . ** Dioxus** - Pure Rust native UI, MIT/Apache-2.0
5867
5968Both are FOSS with independent governance (no Big Tech).
6069
6170### Enforcement Rules
6271
63- 1 . ** No new TypeScript files** - Convert existing TS to ReScript
64- 2 . ** No package.json for runtime deps** - Use deno.json imports
72+ 1 . ** No new TypeScript files** - Convert existing TS to AffineScript
73+ 2 . ** No package.json - use deno.json deps** - Use deno.json imports
65743 . ** No node_modules in production** - Deno caches deps automatically
66754 . ** No Go code** - Use Rust instead
67- 5 . ** No Python anywhere** - Use Julia for data/batch, Rust for systems, ReScript for apps
76+ 5 . ** No Python anywhere** - Use Julia for data/batch, Rust for systems, AffineScript for apps
68776 . ** No Kotlin/Swift for mobile** - Use Tauri 2.0+ or Dioxus
6978
7079### Package Management
0 commit comments