🧪 POC stack: render, route, compose, pause, and reconstruct the XMD REPL (#838–#842)

.gitignore

@@ -26,3 +26,7 @@ packages/web/generated/
 # it. The concurrent verifier runs site:build and site:check together, so a lint
 # that walked one would report on a file nobody wrote.
 site/*.timestamp-*.mjs
+
+# The harness in scripts/repl-study writes raw ANSI beside its committed
+# captures; only the readable .txt frames are reviewed and kept.
+scripts/tests/fixtures/repl-study/*.ansi

.oxfmtrc.json

@@ -4,11 +4,14 @@
   // the exact indentation the rule tests assert on.
   // `packages/*/npm` is generated dnt output, written by a test while the
   // battery runs; format-checking it fails on a file nobody wrote by hand.
+  // The vendored snapshots are upstream's bytes: a drift verifier holds each to
+  // the manifest that records it, and reformatting one would break that.
   "ignorePatterns": [
     "**/*.md",
     "scripts/tests/fixtures/**",
     "**/npm/**",
     "packages/workflow/vendor/cloudflare-computer-dofs/**",
-    "packages/acp/vendor/acpx/**"
+    "packages/acp/vendor/acpx/**",
+    "scripts/repl-study/vendor/freedom/**"
   ]
 }

.oxlintrc.json

@@ -3,6 +3,8 @@
 
   "extends": ["./oxlint.shared.json"],
 
+  "ignorePatterns": ["scripts/repl-study/vendor/freedom/**"],
+
   "plugins": ["typescript", "unicorn", "import"],
 
   "jsPlugins": [

deno.json

@@ -46,6 +46,7 @@
     "oxlint": "npm:oxlint@1.74.0",
     "oxlint-tsgolint": "npm:oxlint-tsgolint@0.25.0",
     "semver": "npm:semver@^7.8.5",
+    "starfx": "npm:starfx@0.16.1",
     "typescript": "npm:typescript@^5.0.0",
     "unist-util-select": "npm:unist-util-select@^5",
     "zod": "npm:zod@^4.3.6",
@@ -64,6 +65,12 @@
     "gen:publish-workflow": "deno run --allow-all packages/cli/src/deno.ts run scripts/gen-publish-workflow.md",
     "bump": "deno run -A scripts/bump-version.ts",
     "weights:measure": "deno run --allow-all scripts/measure-test-weights.ts",
+    "repl:study": "deno run --allow-all --frozen scripts/repl-study/main.ts",
+    "repl:compose": "deno run --allow-all --frozen scripts/repl-compose/main.ts",
+    "repl:pause": "deno run --allow-all --frozen scripts/repl-pause/main.ts",
+    "repl:pause:seam": "deno run --allow-all --frozen scripts/repl-pause/missing-seam.ts",
+    "repl:pause:xmd": "deno run --allow-all --frozen scripts/repl-pause/measure.ts",
+    "repl:hydration": "deno run --allow-all --frozen scripts/repl-hydration/main.ts",
     "test": "deno test --allow-all --frozen",
     "verify": "deno run --allow-all --node-modules-dir=none --cached-only --frozen scripts/preflight.ts scripts/verify.ts",
     "vendor:verify": "deno run --allow-read --allow-write=/tmp --allow-env --allow-run --cached-only --frozen scripts/verify-cloudflare-dofs.ts",

package.json

@@ -50,6 +50,7 @@
     "mdast-util-to-string": "^4"
   },
   "devDependencies": {
+    "@bomb.sh/tty": "0.9.0",
     "@durable-streams/server": "^0.3.8",
     "@executablemd/acp": "workspace:*",
     "@executablemd/cli": "workspace:*",
@@ -67,6 +68,7 @@
     "expect": "^30.0.0",
     "oxfmt": "^0.41.0",
     "oxlint": "1.74.0",
+    "starfx": "0.16.1",
     "tsx": "^4.19.0",
     "typescript": "^5.0.0"
   },