Skip to content

MIGRATION.adoc

Latest commit

 

History

History
155 lines (121 loc) · 7.34 KB

MIGRATION.adoc

File metadata and controls

155 lines (121 loc) · 7.34 KB
Raw

rescript-ecosystem — Consolidation Migration Record

Table of Contents

Status

Estate language policy: RS/TS/JS → AffineScript → typed-wasm. This monorepo is the structural consolidation target for scattered hyperpolymath ReScript (estate handover Item #12). It is distinct from:

  • The CI-text guidance sweep (handover Item 9 — complete 2026-05-17).

  • The ReScript→AffineScript port (Epic #7 / Item #8) — blocked on affinescript#61–64. Do not hand-port ReScript ahead of the compiler.

Mechanism (authoritative, ruled 2026-05-17)

In-tree, history-preserving relocation. NOT git submodules.

A prior session left a half-finished submodule approach: five rescript-ecosystem/ stanzas in the parent developer-ecosystem .gitmodules that did *not correspond to gitlinks (the directories were already tracked in-tree, git mode 100644, with empty git submodule status). Those orphan stanzas have been removed; the directories remain in-tree content. This is the canonical mechanism going forward, mirroring the v-ecosystem precedent.

Per policy reference-rescript-ecosystem-policy:

  • Per-repo move; delete from source only after the add here is merged/verified (reversible until merge).

  • Preserve FFI / proven adapters outside the aggregate as connectors/ (see connectors/README.adoc).

  • Footgun: never bare-delete a source tree without moving it.

Physical state (2026-05-17)

Consolidation is partial. ~6,361 real .res files present.

Location .res Note

rescript/ (top-level)

2985

Largest; not yet grouped

idaptik-rescript13-staging/

176

Top-level staging

cadre-router/

54

Top-level

rescript-tea/ (top-level)

27

Duplicated vs packages/web/tea (14) — reconcile

rescript-evangeliser/ + packages/tooling/evangeliser/

14+14

Duplicated — reconcile

packages/core/poly-core

7

Populated

packages/web/full-stack, packages/bindings/postgres, ppx-proven-record/, rescript-deno-starter/, rescript-vite-config/

0

Empty scaffolds awaiting source

Open structural debt: dedupe top-level packages into packages/<group>/; populate or remove the empty scaffolds; resolve the README target-vs-actual gap (README now flagged as target layout, not completed state).

Package: rescript-tea (origin → target)

Origin: https://github.com/hyperpolymath/rescript-tea (standalone repo, clean, on main, fully pushed). Target: rescript-ecosystem/rescript-tea/ (in-tree, committed).

This package is left to this monorepo as the canonical ReScript TEA home. Ongoing ReScript TEA work happens here, not in the standalone repo.

Two-way divergence — RECONCILIATION REQUIRED (not done)

The source repo and this copy diverged in both directions; neither is a superset. The standalone source repo has therefore NOT been retired (would be irreversible loss). No ReScript toolchain was available in the consolidating session to validate a semantic merge.

Per-module divergence (lines, source ↔ here):

Module source here Disposition

src/Tea_Sub.{res,resi}

405/99

201/51

source far ahead — needs merge review

src/Tea_Http.{res,resi}

388

268 (src/tea/)

diverged — merge review

src/Tea_Json.{res,resi}

354

362

here ahead — keep here, port source deltas

src/Tea_Html, Tea_App, Tea_Cmd, Tea, Tea_Test

larger

smaller

diverged — per-module merge review

src/Tea_Layout.{res,resi}

present

ABSENT

brought forward (lossless, additive)

test/Tea_Cmd_test.res, test/Tea_Json_test.res

present

ABSENT

brought forward (validate vs canonical modules)

examples/02_http/, examples/03_swot_dashboard/

present

ABSENT

brought forward

This copy additionally carries ~18 Tea modules under src/tea/ (Animationframe, Debug, Keyboard, Mouse, Render, Ssr, Svg, Time, Vdom, Window, …) that do not exist in the standalone source — i.e. this copy is the richer base for those.

Source-only governance/metadata forms (.machines_readable/6scm/*.scm, old .adoc duplicates) are intentionally not carried forward — the canonical RSR/a2ml scaffold here supersedes them (SCM→a2ml policy).

Build validation (2026-05-17, ReScript 12.2.0 + @rescript/core 1.6.1)

Toolchain installed at ~/dev/tools/languages/rescript/current (PATH-per-use). Two committed git merge-conflict markers were found and fixed (botched merge 992e4b4): rescript.json and package.json each had <<<<<<< HEAD … ======= … >>>>>>> blocks (HEAD = canonical src/tea / @rescript/core; other = old flat src / @rescript/react). Resolved to the canonical side. No .res/.resi carried conflict markers.

Canonical package now builds green: rescript build → Parsed 75 source files / Compiled 75 modules, exit 0, sources [{"dir":"src/tea"}].

Brought-forward source-only content does not compile against the canonical API and is preserved losslessly in rescript-tea/reconcile/ (NOT in sources), each with a concrete port task — see rescript-tea/reconcile/README.adoc:

  • Tea_Layout.{res,resi} (~750 LOC) — ReactDOM-coupled; canonical package dropped @rescript/react. Port off ReactDOM.

  • test/Tea_{Cmd,Json}_test.res, examples/{02_http,03_swot_dashboard} — written against the standalone repo’s diverged API (Tea_Json.decodeValue absent here; Tea_Cmd.batch list-vs-array).

Exit criteria for retiring the standalone rescript-tea repo

  1. ✅ Canonical src/tea builds green (toolchain-validated).

  2. ✅ Config integrity defects (conflict markers) resolved.

  3. Port reconcile/ items to the canonical API; empty that directory.

  4. Per-module semantic merge of the diverged src/* (e.g. Tea_Sub 405↔201) against the standalone source — needs side-by-side review.

  5. Resolve the rescript-tea ↔ packages/web/tea duplication.

  6. Then, and only then: per-repo retirement of https://github.com/hyperpolymath/rescript-tea (reversible until that PR merges, and only after developer-ecosystem#69 merges).

Go-forward: affinescript-tea

Per estate policy, the successor to rescript-tea is affinescript-tea (an AffineScript TEA implementation), not continued ReScript TEA feature work. affinescript-tea does not yet exist and must not be hand-ported now — it is blocked on the same primitives as gitbot-fleet#148: affinescript#61 (Http.fetch), #62 (Promise), #63 (Json), #64 (Dict). rescript-tea here is the consolidated legacy base and the reference for the eventual mechanical port. See rescript-tea/SUCCESSOR.adoc.

Next steps

  1. Per-module reconcile + retire standalone rescript-tea (above).

  2. Dedupe top-level packages into packages/<group>/; populate/remove empty scaffolds.

  3. Continue per-repo consolidation of remaining scattered ReScript (estate: repos ~1838, hyperpolymath-archive 208, reposystem 78 .res — gitbot-fleet is blocked by gitbot-fleet#148, do not move).

  4. Note: parent developer-ecosystem/.gitmodules still carries v-ecosystem/* stanzas with the same orphan pattern — out of scope here, flagged for the v-ecosystem owner.