Skip to content

docs(claude-md): note ReScript→AffineScript migration trajectory #60

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
hyperpolymath wants to merge 1 commit into from
Closed

docs(claude-md): note ReScript→AffineScript migration trajectory #60

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions .claude/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ deno task test:coverage

## Architecture

- **TEA (The Elm Architecture)** in ReScript — Model/Msg/Update/View/Subscriptions
- **TEA (The Elm Architecture)** in ReScript (migrating to AffineScript per `hyperpolymath/standards#252`) — Model/Msg/Update/View/Subscriptions
- **Gossamer** (Zig + WebKitGTK) backend — migrated from Tauri 2.0
- **Elixir/BEAM** optional middleware (`beam/panll_beam`)
- **106 panels** across four panes: Panel-A (Ambient), Panel-L (Logic, role: Symbolic), Panel-N (Neural), Panel-W (World). Panel-L + Panel-N orbit Panel-W in the Binary Star core; Panel-A surrounds as ambient substrate.
Expand All @@ -71,14 +71,16 @@ deno task test:coverage
## Critical Rules

- **NEVER use Tauri** — project migrated to Gossamer. All backend refs use `src-gossamer/`
- **NEVER use TypeScript** — ReScript only
- **NEVER use npm/bun** — Deno only (npm used only for ReScript compiler)
- **NEVER use TypeScript** — current source is ReScript; **new modules MUST be AffineScript** per `hyperpolymath/standards#252` (ReScript→AffineScript estate umbrella). Don't introduce new `.res`/`.resi` files in new feature work.
- **NEVER use npm/bun** — Deno only (npm used only for the legacy ReScript compiler invocation; estate target is `deno run -A --allow-scripts=npm:rescript npm:rescript@^12.0.0` per `hyperpolymath/standards#253`)
- **Panels, not panes** — PanLL uses "panels" terminology
- **TEA pattern only** — no MVC, no Redux, no hooks. Model -> Msg -> Update -> View
- **All state in Model.model** — no global mutable state
- **Anti-Crash validates ALL neural tokens** — no inference bypasses the circuit breaker

## ReScript Conventions
## ReScript Conventions (legacy — apply when touching existing `.res`/`.resi`)

> New modules should be AffineScript per `hyperpolymath/standards#252`. These conventions remain authoritative for edits to the existing ReScript surface until migration completes.

- Use `list{}` for vdom children: `Tea_Html.div(list{}, list{...})`
- Use `Events.onClick` / `Events.onInput` for event handlers
Expand Down
Loading