diff --git a/.github/workflows/website-pages.yml b/.github/workflows/website-pages.yml
index 52908cd8b..881a66dc8 100644
--- a/.github/workflows/website-pages.yml
+++ b/.github/workflows/website-pages.yml
@@ -19,12 +19,33 @@ jobs:
contents: read
pages: read
steps:
+ - name: Require Cloudflare publishing credentials
+ env:
+ CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+ CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+ run: |
+ if [[ -z "$CLOUDFLARE_API_TOKEN" || -z "$CLOUDFLARE_ACCOUNT_ID" ]]; then
+ echo "::error::Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID in repository Actions secrets before publishing."
+ exit 1
+ fi
- name: Check out the repository
uses: actions/checkout@v4
- name: Prepare the example download
run: python3 scripts/prepare-website.py
- name: Check website links and publishing configuration
run: python3 scripts/verify-website.py
+ - name: Record the published commit
+ run: |
+ python3 - <<'PY'
+ import json
+ import os
+ from pathlib import Path
+
+ Path("website/public/deployment.json").write_text(
+ json.dumps({"commit": os.environ["GITHUB_SHA"]}) + "\n",
+ encoding="utf-8",
+ )
+ PY
- name: Configure Pages
uses: actions/configure-pages@v5
- name: Upload the website
@@ -35,14 +56,81 @@ jobs:
deploy:
needs: prepare
runs-on: ubuntu-latest
- timeout-minutes: 5
+ timeout-minutes: 15
permissions:
+ contents: read
+ actions: read
pages: write
id-token: write
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
+ - name: Check out publishing configuration
+ uses: actions/checkout@v4
+ - name: Set up Node.js for Wrangler
+ uses: actions/setup-node@v4
+ with:
+ node-version-file: .nvmrc
+ - name: Download the verified website
+ uses: actions/download-artifact@v4
+ with:
+ name: github-pages
+ path: ${{ runner.temp }}/website-archive
+ - name: Extract the shared publishing artifact
+ run: |
+ mkdir -p "$RUNNER_TEMP/rea-website-public"
+ tar -xf "$RUNNER_TEMP/website-archive/artifact.tar" -C "$RUNNER_TEMP/rea-website-public"
+ - name: Publish the website to Cloudflare
+ uses: cloudflare/wrangler-action@v4
+ with:
+ apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+ accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+ wranglerVersion: "4.149.0"
+ packageManager: npm
+ command: deploy --cwd website --env production --assets "${{ runner.temp }}/rea-website-public"
- name: Publish to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
+ - name: Verify both published revisions
+ env:
+ PAGES_URL: ${{ steps.deployment.outputs.page_url }}
+ run: |
+ python3 - <<'PY'
+ import json
+ import os
+ import sys
+ import time
+ from urllib.error import URLError
+ from urllib.parse import urljoin
+ from urllib.request import Request, urlopen
+
+ expected = os.environ["GITHUB_SHA"]
+ pages_url = os.environ["PAGES_URL"]
+ if not pages_url:
+ sys.exit("GitHub Pages returned no published URL.")
+ pending = {"Cloudflare": "https://rea.tools/", "GitHub Pages": pages_url}
+ for attempt in range(24):
+ for name, base in list(pending.items()):
+ url = urljoin(base, "deployment.json") + "?commit=" + expected
+ try:
+ request = Request(url, headers={"Cache-Control": "no-cache"})
+ with urlopen(request, timeout=10) as response:
+ actual = json.load(response).get("commit")
+ if actual == expected:
+ print(f"{name} serves {expected}: {base}")
+ del pending[name]
+ else:
+ print(f"Waiting for {name}: observed revision {actual}")
+ except (URLError, TimeoutError, ValueError) as error:
+ print(f"Waiting for {name}: {error}")
+ if not pending:
+ break
+ if attempt < 23:
+ time.sleep(5)
+ if pending:
+ sys.exit("Published revision did not match on: " + ", ".join(pending))
+ with open(os.environ["GITHUB_STEP_SUMMARY"], "a", encoding="utf-8") as summary:
+ summary.write(f"Published commit `{expected}` to [rea.tools](https://rea.tools/) "
+ f"and [GitHub Pages]({pages_url}).\n")
+ PY
diff --git a/.gitignore b/.gitignore
index f8266c11d..daca8832e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -49,6 +49,7 @@ Thumbs.db
# Generated website download
/website/public/examples/notes-example.zip
+/website/public/deployment.json
# Local Cloudflare development state
/website/.wrangler/
diff --git a/website/AGENTS.md b/website/AGENTS.md
index a4bf9b8dc..47bee247a 100644
--- a/website/AGENTS.md
+++ b/website/AGENTS.md
@@ -19,5 +19,6 @@ for asset notes and the source of case-study claims.
- Check both local root and `/rea/` paths, mobile layouts, expanded details,
copying and downloads. Run `scripts/prepare-website.py` followed by
`scripts/verify-website.py`.
-- Keep `website-pages.yml` as the sole, manual Pages publisher. Follow the
- publication procedure in the website README.
+- Keep `website-pages.yml` as the sole, manual production publisher for
+ Cloudflare and Pages. Both hosts must receive the same verified artifact and
+ pass the published-commit check. Follow the website README.
diff --git a/website/README.md b/website/README.md
index 096f12226..92b0be51d 100644
--- a/website/README.md
+++ b/website/README.md
@@ -6,7 +6,8 @@
An English static website with explanatory figures, worked guides and DX-Ball, Notion, TH04 and CTF investigations.
The public files are in `website/public/`. The site uses HTML, CSS and a small
-script for copying code and following the assembly-to-C comparison. Python
+scripts for copying code, following code comparisons and playing the dinosaur
+speed reconstruction. Python
packages the downloadable example; there is no frontend bundler or npm dependency.
[style-guide.md](style-guide.md) explains the writing, page structure, figures,
@@ -25,7 +26,9 @@ Open . Refresh the browser after editing a file.
## Pages
-- `public/index.html`: product introduction and case-study overviews.
+- `public/index.html`: compact setup, reverse-engineering definition and purpose, manual/agent comparison, dinosaur and Calculator examples, and case-study overviews.
+- `public/examples/dino-lab/index.html`: adjustable-speed mini-game, recovered rule, original-game check and browser analysis steps.
+- `public/first-investigation/index.html`: a guided Notes export investigation, from setup to a checked CSV prediction.
- `public/showcase/index.html`: the case-study index.
- `public/showcase/dx-ball/index.html`: sound-pan investigation and project status.
- `public/showcase/notion/index.html`: Notion's Electron clipboard bridge and rich clipboard format.
@@ -60,6 +63,12 @@ by Git; website checks and each manual publication regenerate it before checking
and uploading the public directory. The verifier checks that its entries match
the current source and contain no extra files.
+The first-investigation page uses this same ZIP. Its prompt lets the agent
+download and unpack the target; the download button provides a manual path.
+The reader follows the static export trace, then runs the CSV formatter with
+one changed input. This formatter check needs only Node.js. The separate
+browser Notes example has a different implementation.
+
Agent terminals show example prompts, not transcripts of previous
investigations. All cursors blink continuously with the same CSS animation,
respecting reduced-motion preferences. Both the prompt and animation work
@@ -88,7 +97,42 @@ Evidence. [evidence/dx-ball-sound-pan.md](evidence/dx-ball-sound-pan.md) records
their provenance and the scope of the validation claims. The original executable
and complete private Evidence records are not website assets.
-The homepage and DX-Ball overview diagrams are maintained as SVG source. Initial layout references were
+The homepage starts with a short installation prompt and the ordinary setup
+command, then explains what reverse engineering is and why someone would use
+it. The manual/agent comparison introduces REA’s role before the examples.
+The comparison uses the same Calculator question on both sides: three
+selectable manual steps pair original instructions with an analyst illustration
+and thought bubbles; the agent side begins with “One prompt.” and a copyable
+question. Thoughts illustrate the reasoning behind the findings. The shared
+code-step script selects the initial note on load, so all three notes remain
+readable when JavaScript is disabled.
+The original-instruction panel starts expanded on desktop. On narrow screens,
+the homepage script collapses it; a native disclosure keeps the code available
+while the thought bubble and agent prompt remain close together.
+Dinosaur is the first example; Calculator follows as the native example.
+Both name the goal and the reason to inspect the program before showing the
+demo. A labeled finding explains what REA returned, and the flow distinguishes
+REA’s inspection from the agent’s interpretation and implementation.
+Its game precedes the prompt and code on small screens. Calculator’s excerpt
+comes from an installed model DLL; Microsoft’s public implementation supplies
+names and a crosscheck. Its controls apply the percentage rule to generic inputs.
+
+The dinosaur example connects an inspected running script to a new playable
+mini-game. `public/assets/dino-speed.js` owns the recovered speed rule and replay;
+`dino-demo.js` imports it for automatic acceleration. The slider chooses a fixed
+speed instead. Drawing, jumping and collision code are newly authored for this
+teaching game. It starts on input, pauses when hidden or outside the viewport,
+and retains a static SVG when JavaScript is disabled. The lab links the speed
+module and complete game source, and replays the rule against recorded
+original-game values.
+
+[evidence/calculator-and-dino.md](evidence/calculator-and-dino.md) records both
+targets, selected findings, attribution and verification scope. Update the
+speed rule, game, check table and evidence together. The original script excerpt
+and its BSD license are credited on the pages. Prompt responses are example
+explanations based on findings.
+
+The general investigation and DX-Ball overview diagrams are maintained as SVG source. Initial layout references were
created with the built-in image generation tool; [figures.md](figures.md) retains
their prompts and the current asset notes. Figures provide an overview;
REA requests, assembly and C remain selectable HTML text. On narrow
@@ -141,7 +185,7 @@ Wrangler version without adding it to REA's package dependencies.
Cloudflare documents static-asset requests as free and unlimited, with no
additional storage cost. See [billing and limitations](https://developers.cloudflare.com/workers/static-assets/billing-and-limitations/).
-### Preview and deploy
+### Local and hosted previews
Run these commands from the repository root. `--cwd website` makes the build
paths consistent with the website configuration. Preview locally first:
@@ -186,13 +230,7 @@ See Cloudflare's [nameserver setup procedure](https://developers.cloudflare.com/
for the complete migration steps. A CNAME to the preview's `workers.dev` hostname
at the current DNS provider does not configure a Workers Custom Domain.
-Publish to the production Worker:
-
-```sh
-npx wrangler@4.149.0 deploy --cwd website --env production
-```
-
-This creates or updates `rea-website`, attaches `rea.tools`, and lets Cloudflare
+The production environment creates or updates `rea-website`, attaches `rea.tools`, and lets Cloudflare
manage its DNS record and HTTPS certificate. Deployment can succeed while the
zone is pending; verify public HTTPS after activation and certificate issuance.
An existing CNAME at `rea.tools`
@@ -206,15 +244,34 @@ Verify , ,
resolve correctly. The root README and browser guide use `https://rea.tools/`
as the public website URL.
-Deployments are manual. The existing GitHub Pages publisher remains available
-as a separate host; it does not publish to Cloudflare.
+Production publication uses the synchronized GitHub Actions workflow below.
+Local Wrangler commands above publish only the separate preview Worker.
-## GitHub Pages
+## Synchronized production publishing
-`.github/workflows/website-pages.yml` prepares and deploys only `website/public`.
-It is the sole Pages publisher, manually triggered and restricted to `main`;
+`.github/workflows/website-pages.yml` prepares `website/public` once and deploys
+the same artifact to Cloudflare (`rea.tools`) and GitHub Pages. It is the sole
+production publisher, manually triggered and restricted to `main`;
ordinary pushes and pull requests do not publish the site.
+Configure these repository **Actions secrets** before publishing:
+
+- `CLOUDFLARE_API_TOKEN`: a Cloudflare token using the **Edit Cloudflare Workers**
+ template, scoped to the website's account and zone.
+- `CLOUDFLARE_ACCOUNT_ID`: that Cloudflare account's ID.
+
+See Cloudflare's [GitHub Actions authentication instructions](https://developers.cloudflare.com/workers/ci-cd/external-cicd/github-actions/).
+The workflow checks that both secrets are present before preparing a release.
+Cloudflare deploys first; GitHub Pages deploys after that step succeeds.
+
+Preparation adds `deployment.json` with the workflow's commit SHA. Cloudflare
+receives the extracted Pages artifact through Wrangler's explicit assets path;
+the local custom-build output is not the uploaded directory. The workflow then
+checks both public version markers and reports success only when they match
+that commit. A failed publication remains failed; fix its cause and rerun the
+workflow to complete both deployments. The two hosts can update at different
+times while a run is in progress.
+
Website checks run only for pull requests that change `website/`, the verification
script or workflow definitions. They check local links, HTML fragments, SVG XML
and the single Pages publisher without installing npm dependencies. The same
@@ -233,8 +290,9 @@ the old site.
After the site is approved and merged, select **GitHub Actions** under the
repository's **Settings → Pages → Build and deployment**. Then run **Publish REA
-website** from the Actions tab on `main`. The workflow uses the `github-pages`
-environment and the official Pages actions.
+website** from the Actions tab on `main`. This publishes both production hosts.
+The workflow uses the `github-pages` environment, the official Pages actions and
+Cloudflare's Wrangler action.
The equivalent CLI command is:
diff --git a/website/evidence/calculator-and-dino.md b/website/evidence/calculator-and-dino.md
new file mode 100644
index 000000000..a7e9c093e
--- /dev/null
+++ b/website/evidence/calculator-and-dino.md
@@ -0,0 +1,145 @@
+# Calculator and dinosaur beginner examples
+
+Evidence collected on 9 October 2026 with the published REA 4.1.0 package.
+The homepage offers compact setup first, then a reverse-engineering definition,
+purpose and manual/agent comparison. Dinosaur is the first worked example;
+Calculator is the second. Each states its goal, why the program is inspected,
+what REA returned and how the agent uses it.
+Prompts and replies are examples based on the
+findings below. Selected code and generic inputs are public; raw captures stay
+outside the website.
+
+## Windows Calculator
+
+### Inspected artifacts
+
+The installed Windows Calculator package is version `11.2508.4.0`, x64.
+
+| Artifact | SHA-256 |
+| --------------------------- | ------------------------------------------------------------------ |
+| Windows `calc.exe` launcher | `9c2c8a8588fe6db09c09337e78437cb056cd557db1bcf5240112cbfb7b600efb` |
+| Package `CalcViewModel.dll` | `07a1953bbf828a3495662c4b4bde1c80c9075061e0e389eabac5f8c544710df5` |
+
+REA's function dossier for launcher `0x1400019f4` includes the call to
+`ShellExecuteW` with `ms-calculator:`. Evidence:
+`ev_e97a6a1a61bfe63476a13e6285d71dd838101066f7863c9af822861050203ea5`.
+
+The calculation is in the installed app's model DLL. REA inspected function
+`0x1801245d0`, whose body occupies two ranges, totaling 10,656 bytes:
+`0x1801245d0–0x180126f4c` and `0x180126f55–0x180126f77`.
+Evidence:
+`ev_830a710c7fb55a08ac896fb5783c14339480a57a96d6d45c57c024b6a43239d0`.
+
+REA supplied pseudocode, original instructions, calls and references. Its
+`case 0x76` checks the operator field against `0x5c` and `0x5b` and constructs
+the constant 100 in both paths. One path divides the current value by 100;
+the other combines the current value with the previous value divided by 100.
+The published assembly is selected exactly from the returned instruction list.
+
+The opening manual/agent comparison selects instructions at
+`0x180124945–0x180124992` and `0x180124a14–0x180124a34`, with explicit omissions.
+Its three highlights identify the operator comparisons, construction of 100
+and arithmetic helper calls, and the final multiplication path. The analyst
+thought bubbles illustrate the work of decoding those facts; they are not a
+recorded analyst transcript or a measured comparison of investigation times.
+The same percentage question appears in the agent prompt. Helper meanings and
+operator names are interpretations checked against the public source below.
+
+The binary is stripped. A local instruction scan located candidates using
+operator IDs and the constant 100; REA then produced the complete function
+dossier. Function selection was analyst-assisted. The illustrative agent
+prompt is not a recording of an autonomous end-to-end discovery.
+
+### Source interpretation and check
+
+Microsoft's MIT-licensed source at commit
+`d125246a4e19842ce1332e6c7839cf0e110027d8` supplies the operator meanings and
+an independently readable implementation:
+
+- [Operator IDs](https://github.com/microsoft/calculator/blob/d125246a4e19842ce1332e6c7839cf0e110027d8/src/CalcManager/Header%20Files/CCommand.h): `IDC_DIV = 91`, `IDC_MUL = 92`, `IDC_PERCENT = 118`.
+- [Percentage branch](https://github.com/microsoft/calculator/blob/d125246a4e19842ce1332e6c7839cf0e110027d8/src/CalcManager/CEngine/scifunc.cpp#L98-L111): multiply/divide uses `rat / 100`; other operators use `rat * (m_lastVal / 100)`.
+- [Standard-mode tests](https://github.com/microsoft/calculator/blob/d125246a4e19842ce1332e6c7839cf0e110027d8/src/CalculatorUnitTests/CalculatorManagerTest.cpp#L350-L370): `6 × 6 % = 0.36` and `50 + 20 % = 60`.
+
+These source branches agree with the operator checks and two paths observed
+in the installed DLL. The public source commit is a crosscheck; it is not an
+identified build commit for that installed package. No PDB symbols were loaded.
+
+The homepage's named C-like rule is an explanatory summary. Its `200 + 10%`
+and `200 × 10%` controls compute those cases from that rule using the fixed
+inputs 200 and 10. Browser checks exercise
+both percentage illustrations, their results, operator selection and reset.
+The Microsoft tests were inspected, not executed. A probe-owned Calculator
+window could be inspected, but it was no longer present at the input-check
+step; no completed Windows GUI input result is claimed.
+
+## Dinosaur speed
+
+### Running target and source
+
+REA inspected the HTTP page
+ in an owned Chrome 150.0.7871.124
+session through a loopback debugging connection. This is wayou's
+Chromium-derived browser edition. REA's HTTP(S) page inspection does not
+select `chrome://dino/`; the website identifies the HTTP edition as its target.
+
+The returned `index.js` source contains 90,241 UTF-8 bytes, SHA-256
+`e7a50d337bdbe4299068de034e4564cfe5fd45ca9257ded37b6ada9330cedf0f`.
+Evidence:
+`ev_7a09de570cf6b64907504046485cab69ad444828964106eabc05958799749905`.
+
+This digest also matches `index.js` in repository commit
+`5455bfa408ec6b707c7300ff194b7390733a766d`. Source locations:
+
+- [Settings](https://github.com/wayou/t-rex-runner/blob/5455bfa408ec6b707c7300ff194b7390733a766d/index.js#L106-L135): `ACCELERATION: 0.001`, `MAX_SPEED: 13`, `SPEED: 6`.
+- [Update branch](https://github.com/wayou/t-rex-runner/blob/5455bfa408ec6b707c7300ff194b7390733a766d/index.js#L565-L571): increment speed on a collision-free update while speed is below the threshold.
+
+The source begins with the Chromium Authors' 2014 copyright notice. Selected
+excerpts are credited on the page. The repository's BSD license and the source
+copyright are reproduced in `public/assets/licenses/dinosaur.txt`.
+
+### Controlled original-game check
+
+After the passive REA inspection, a separate Playwright controller called the
+original page's `Runner.update()` repeatedly. It disabled future update
+scheduling and obstacle generation, set the starting speed to 6, and kept the
+game in its playing state. The control is credited separately from REA's
+read-only inspection.
+
+| Update count | Observed speed | Display rounded to 3 decimals |
+| ------------ | ------------------ | ----------------------------- |
+| 0 | 6 | 6.000 |
+| 1,000 | 7.000000000000334 | 7.000 |
+| 4,000 | 9.99999999999956 | 10.000 |
+| 7,000 | 12.999999999997897 | 13.000 |
+| 10,000 | 13.000999999997896 | 13.001 |
+
+The branch compares before adding. Floating-point increments can cross the
+threshold by one increment; the reconstruction preserves this behavior rather
+than introducing a clamp.
+
+### New game and reader experiment
+
+`public/assets/dino-speed.js` contains the reconstructed rule and an update-count
+replay. Its rounded results match the original-game check above. The website's
+mini-game imports this rule. It advances its own simulation at 60 updates per
+second, avoiding a different frame rate changing its demonstration pace.
+
+The canvas drawing, dinosaur shape, jump physics, rectangle collision detection,
+spacing and controls are newly authored teaching code. The reconstruction claim
+is scoped to the speed rule. Changing the slider selects a fixed speed between
+2 and 18; selecting automatic acceleration restores the starting speed of 6.
+
+The new game starts only after user input. It supports Play/Pause, Jump, Restart,
+canvas Space/Up keys and touch. It pauses when hidden or scrolled out of view.
+Without JavaScript, a static SVG, source excerpts and recorded results remain
+available. The downloadable speed module and complete game source are linked
+from the lab.
+
+## Review checks
+
+Website checks cover root and `/rea/` hosting, 320/390/850/1440px layouts,
+expanded evidence, copying, no-JavaScript content, reduced motion, the two
+percentage rules and the game controls. Game checks include speed selection,
+automatic acceleration, a collision, restart, jump height on the rendered
+canvas, pause and the original-rule replay. Existing Notes and DX-Ball pages
+remain part of layout checks.
diff --git a/website/evidence/guide-examples.md b/website/evidence/guide-examples.md
index 476c0fbd0..7a6626447 100644
--- a/website/evidence/guide-examples.md
+++ b/website/evidence/guide-examples.md
@@ -36,6 +36,22 @@ contents. Website verification compares every ZIP entry to its source file and
rejects extra entries. Existing source digests and static findings remain valid
for the unzipped example.
+## First-investigation formatter check
+
+The first-investigation page reuses the unchanged Electron fixture and recorded
+static findings above. On 9 October 2026, its generated ZIP was unpacked and the
+page's formatter command was run with Node.js 24.18.0. The input
+`[{ id: 1, title: 'Hello, "REA"' }]` produced:
+
+```csv
+id,title
+1,"Hello, ""REA"""
+```
+
+That check executes `toCsv` from the unzipped `csv.js`. It checks formatting;
+the export destination remains a conclusion from `main.js`. No Electron app
+launch or new native analysis was needed for this website revision.
+
## Notes browser example
The three-file browser app is in `website/public/examples/notes-web/`.
diff --git a/website/figures.md b/website/figures.md
index ff8f7bba3..c0ab93d60 100644
--- a/website/figures.md
+++ b/website/figures.md
@@ -13,6 +13,7 @@ The published diagrams are SVG source assets:
- `public/assets/figures/rea-investigation-flow.svg` — 1774 × 887 viewBox.
- `public/assets/figures/dx-ball-sound-pan-investigation.svg` — 1774 × 887 viewBox.
- `public/assets/figures/th04-bullet-ring.svg` — 1000 × 520 viewBox.
+- `public/assets/figures/analyst-thinking.svg` — 160 × 120 viewBox.
Two original layout references were generated with the built-in image generation
tool and reviewed visually. Their prompts are retained below. The final SVGs
@@ -42,6 +43,36 @@ branches when changing these figures. Match progress claims to the pinned
reconstruction checkpoint. Validate the SVG as XML and inspect its browser
rendering at desktop and mobile widths.
+## Beginner homepage and dinosaur reconstruction
+
+The manual/agent comparison and Calculator percentage controls are semantic
+HTML. Calculator’s assembly comes from a real installed model DLL; the named
+calculation is a readable summary crosschecked against Microsoft’s public source. See
+[evidence/calculator-and-dino.md](evidence/calculator-and-dino.md).
+
+The introduction pairs selected Calculator instructions with three selectable
+analyst thoughts: decode operator branches, trace arithmetic calls, then name
+the percentage rule. The small analyst illustration is authored SVG; the
+thought bubbles, findings and labels are selectable HTML. The thoughts
+illustrate the analysis rather than reproduce a recorded conversation. The
+agent side asks the same question and separates REA’s evidence from the
+agent’s explanation. Keep those roles and the instruction highlights aligned
+when changing a step.
+
+The homepage explains reverse engineering before the worked examples. Each
+example opens with its goal and reason for inspecting the program. A selected
+highlight marks the intended result; the “REA returned” block identifies the
+evidence. The flows label REA’s inspection and the agent’s interpretation or
+reconstruction explicitly. Preserve this context when moving a demo.
+
+The dinosaur sequence uses an HTML flow: inspect the loaded script, rebuild the
+speed rule, then change and play. Its canvas mini-game and static SVG fallback
+are authored code, without generated images or copied game sprites. The game
+imports the recovered rule from `public/assets/dino-speed.js`; other mechanics
+are new teaching code. Check that the fallback is visible with JavaScript
+disabled and hidden when the playable canvas loads. Keep the speed settings,
+source excerpt, reconstruction and original-result table consistent.
+
## Original image generation prompts
## Prompt 1
diff --git a/website/public/assets/dino-demo.js b/website/public/assets/dino-demo.js
new file mode 100644
index 000000000..9988e9f52
--- /dev/null
+++ b/website/public/assets/dino-demo.js
@@ -0,0 +1,235 @@
+import { advanceSpeed, simulateSpeed, SPEED_RULE } from "./dino-speed.js";
+
+// A new teaching game around the recovered speed rule. Drawing, jump physics
+// and rectangle collision checks are authored for this demo.
+function initializeDinoDemo(demo) {
+ const canvas = demo.querySelector("canvas");
+ const context = canvas.getContext("2d");
+ if (context === null) return;
+ const start = demo.querySelector("[data-dino-start]");
+ const slider = demo.querySelector("[data-dino-slider]");
+ const auto = demo.querySelector("[data-dino-auto]");
+ const output = demo.querySelector("[data-dino-speed]");
+ const status = demo.querySelector("[data-dino-status]");
+ const ground = 148;
+ const dinosaurX = 52;
+ const dinosaur = new Path2D(
+ "M16 18V2H48V24H35V32H25V43H16V53H8V32H0V23H6V29H16Z M12 47V59H5V54H8V47Z M24 42V54H31V59H20V47Z M34 29H44V35H39V32H34Z",
+ );
+ let speed = SPEED_RULE.start;
+ let height = 0;
+ let velocity = 0;
+ let distance = 0;
+ let obstacles = [];
+ let running = false;
+ let crashed = false;
+ let frame = 0;
+ let lastTime = 0;
+ let elapsed = 0;
+
+ const updateSpeedDisplay = () => {
+ output.value = speed.toFixed(1);
+ slider.value = speed.toFixed(1);
+ };
+
+ const draw = () => {
+ context.clearRect(0, 0, canvas.width, canvas.height);
+ context.strokeStyle = "#b7c0c9";
+ context.beginPath();
+ context.moveTo(0, ground);
+ context.lineTo(canvas.width, ground);
+ for (let x = -(distance % 70); x < canvas.width; x += 70) {
+ context.moveTo(x, ground + 7);
+ context.lineTo(x + 12, ground + 7);
+ }
+ context.stroke();
+ context.fillStyle = "#5b6570";
+ for (const obstacle of obstacles) {
+ context.fillRect(
+ obstacle.x + 6,
+ ground - obstacle.height,
+ 8,
+ obstacle.height,
+ );
+ context.fillRect(obstacle.x, ground - obstacle.height + 12, 6, 7);
+ context.fillRect(obstacle.x, ground - obstacle.height + 3, 5, 15);
+ context.fillRect(obstacle.x + 14, ground - obstacle.height + 19, 7, 6);
+ context.fillRect(obstacle.x + 17, ground - obstacle.height + 8, 4, 17);
+ }
+ context.save();
+ context.translate(dinosaurX, ground - 59 - height);
+ context.fillStyle = crashed ? "#8c4b40" : "#294f82";
+ context.fill(dinosaur);
+ context.fillStyle = "#ffffff";
+ context.fillRect(39, 7, 4, 4);
+ context.restore();
+ context.fillStyle = "#5b6570";
+ context.font = "13px monospace";
+ context.textAlign = "right";
+ context.fillText(
+ `DISTANCE ${String(Math.floor(distance / 100)).padStart(4, "0")}`,
+ 580,
+ 28,
+ );
+ if (!running) {
+ context.textAlign = "center";
+ context.font = "15px system-ui";
+ context.fillText(
+ crashed ? "Hit a cactus. Try another speed." : "Space or Jump ↑",
+ 330,
+ 85,
+ );
+ }
+ };
+
+ const stop = (message) => {
+ running = false;
+ cancelAnimationFrame(frame);
+ start.textContent = crashed ? "Play again" : "Play";
+ if (message) status.textContent = message;
+ draw();
+ };
+
+ const reset = () => {
+ stop();
+ crashed = false;
+ height = 0;
+ velocity = 0;
+ distance = 0;
+ obstacles = [{ x: 550, height: 38 }];
+ if (auto.checked) speed = SPEED_RULE.start;
+ elapsed = 0;
+ start.textContent = "Play";
+ status.textContent = "Press Play, then jump over the cactus.";
+ updateSpeedDisplay();
+ draw();
+ };
+
+ const update = () => {
+ if (auto.checked) speed = advanceSpeed(speed);
+ distance += speed;
+ if (height > 0 || velocity > 0) {
+ height = Math.max(0, height + velocity);
+ velocity -= 0.55;
+ if (height === 0) velocity = 0;
+ }
+ obstacles.forEach((obstacle) => {
+ obstacle.x -= speed;
+ });
+ obstacles = obstacles.filter((obstacle) => obstacle.x > -25);
+ const last = obstacles[obstacles.length - 1];
+ const gap = 400 + speed * 18;
+ if (last === undefined || last.x < 600 - gap) {
+ obstacles.push({ x: 600, height: 38 });
+ }
+ const left = dinosaurX + 8;
+ const right = dinosaurX + 39;
+ const bottom = ground - height;
+ if (
+ obstacles.some(
+ (obstacle) =>
+ right > obstacle.x &&
+ left < obstacle.x + 21 &&
+ bottom > ground - obstacle.height + 4,
+ )
+ ) {
+ crashed = true;
+ stop("Hit a cactus. Press Play again, or change the speed and restart.");
+ }
+ };
+
+ const animate = (time) => {
+ if (!running) return;
+ elapsed += Math.min(time - lastTime, 100);
+ lastTime = time;
+ while (elapsed >= 1000 / 60 && running) {
+ elapsed -= 1000 / 60;
+ update();
+ }
+ updateSpeedDisplay();
+ draw();
+ if (running) frame = requestAnimationFrame(animate);
+ };
+
+ const play = () => {
+ if (crashed) reset();
+ if (running) return;
+ running = true;
+ lastTime = performance.now();
+ elapsed = 0;
+ start.textContent = "Pause";
+ status.textContent = "Running. Space or Jump clears a cactus.";
+ frame = requestAnimationFrame(animate);
+ };
+
+ const jump = () => {
+ if (crashed) reset();
+ play();
+ if (height === 0) velocity = 10.5;
+ };
+
+ start.addEventListener("click", () => {
+ if (running) stop("Paused. Press Play to continue.");
+ else play();
+ });
+ demo.querySelector("[data-dino-jump]").addEventListener("click", jump);
+ demo.querySelector("[data-dino-reset]").addEventListener("click", reset);
+ canvas.addEventListener("keydown", (event) => {
+ if (event.code === "Space" || event.code === "ArrowUp") {
+ event.preventDefault();
+ if (!event.repeat) jump();
+ }
+ });
+ canvas.addEventListener("pointerdown", () => {
+ canvas.focus();
+ jump();
+ });
+ slider.addEventListener("input", () => {
+ auto.checked = false;
+ speed = Number(slider.value);
+ updateSpeedDisplay();
+ status.textContent = running
+ ? `Fixed speed: ${speed.toFixed(1)}. Space or Jump clears a cactus.`
+ : `Fixed speed: ${speed.toFixed(1)}. Press Play to try it.`;
+ draw();
+ });
+ auto.addEventListener("change", () => {
+ if (auto.checked) speed = SPEED_RULE.start;
+ updateSpeedDisplay();
+ status.textContent = auto.checked
+ ? "Recovered rule: start at 6, then increase toward 13."
+ : `Fixed speed: ${speed.toFixed(1)}.`;
+ });
+ document.addEventListener("visibilitychange", () => {
+ if (document.hidden && running) stop("Paused. Press Play to continue.");
+ });
+ if ("IntersectionObserver" in window) {
+ new IntersectionObserver((entries) => {
+ if (!entries[0].isIntersecting && running)
+ stop("Paused. Press Play to continue.");
+ }).observe(demo);
+ }
+ demo.querySelector(".dino-fallback").setAttribute("hidden", "");
+ demo.querySelector(".dino-controls").hidden = false;
+ canvas.hidden = false;
+ reset();
+}
+
+document.querySelectorAll("[data-dino-demo]").forEach(initializeDinoDemo);
+
+const speedCheck = document.querySelector("[data-speed-check]");
+if (speedCheck !== null) speedCheck.hidden = false;
+speedCheck?.addEventListener("click", () => {
+ let matches = true;
+ document.querySelectorAll("[data-speed-updates]").forEach((cell) => {
+ const speed = simulateSpeed(
+ Number(cell.getAttribute("data-speed-updates")),
+ ).toFixed(3);
+ cell.textContent = speed;
+ matches =
+ matches && speed === cell.parentElement.children[1].textContent.trim();
+ });
+ document.querySelector("[data-speed-check-status]").textContent = matches
+ ? "Replayed the recovered rule. All four values match the controlled original-game check when rounded to three decimals."
+ : "The replay differs from the recorded original-game values. Compare the speed rule and settings above.";
+});
diff --git a/website/public/assets/dino-speed.js b/website/public/assets/dino-speed.js
new file mode 100644
index 000000000..df90fcfa4
--- /dev/null
+++ b/website/public/assets/dino-speed.js
@@ -0,0 +1,21 @@
+// Speed rule recovered from wayou's Chromium-derived browser edition.
+// Source and controlled checks: website/evidence/calculator-and-dino.md.
+export const SPEED_RULE = Object.freeze({
+ start: 6,
+ acceleration: 0.001,
+ threshold: 13,
+});
+
+/** Advance one collision-free update using the inspected speed rule. */
+export function advanceSpeed(speed) {
+ return speed < SPEED_RULE.threshold ? speed + SPEED_RULE.acceleration : speed;
+}
+
+/** Replay the recovered rule for a chosen number of updates. */
+export function simulateSpeed(updates) {
+ let speed = SPEED_RULE.start;
+ for (let update = 0; update < updates; update += 1) {
+ speed = advanceSpeed(speed);
+ }
+ return speed;
+}
diff --git a/website/public/assets/figures/analyst-thinking.svg b/website/public/assets/figures/analyst-thinking.svg
new file mode 100644
index 000000000..53a92d5d9
--- /dev/null
+++ b/website/public/assets/figures/analyst-thinking.svg
@@ -0,0 +1,15 @@
+
+ An analyst thinking at a computer
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/website/public/assets/home.js b/website/public/assets/home.js
new file mode 100644
index 000000000..27cd1b32f
--- /dev/null
+++ b/website/public/assets/home.js
@@ -0,0 +1,66 @@
+function initializePercentDemo() {
+ const demo = document.querySelector("[data-percent-demo]");
+ if (demo === null) return;
+ const display = demo.querySelector("[data-percent-display]");
+ const expression = demo.querySelector("[data-percent-expression]");
+ const status = demo.querySelector("[data-percent-status]");
+ const equals = demo.querySelector('[data-percent-key="equals"]');
+ const operations = demo.querySelectorAll("[data-percent-operation]");
+ let operation = "add";
+ let stage = "input";
+
+ const render = () => {
+ const adding = operation === "add";
+ const previous = 200;
+ const current = 10;
+ const percent = adding ? (current * previous) / 100 : current / 100;
+ const result = adding ? previous + percent : previous * percent;
+ const operator = adding ? "+" : "×";
+ expression.textContent =
+ stage === "result" ? `200 ${operator} ${percent} =` : `200 ${operator}`;
+ display.textContent = String(
+ stage === "input" ? current : stage === "percent" ? percent : result,
+ );
+ equals.disabled = stage !== "percent";
+ status.textContent =
+ stage === "input"
+ ? "Press % to see what happens to 10."
+ : stage === "percent"
+ ? adding
+ ? "10% of 200 is 20. Press = to add it."
+ : "For multiplication, 10 becomes 0.1. Press = to multiply."
+ : `200 ${operator} ${percent} = ${result}.`;
+ };
+
+ operations.forEach((button) => {
+ button.addEventListener("click", () => {
+ operation = button.getAttribute("data-percent-operation");
+ stage = "input";
+ operations.forEach((candidate) => {
+ candidate.setAttribute("aria-pressed", String(candidate === button));
+ });
+ render();
+ });
+ });
+ demo.querySelectorAll("[data-percent-key]").forEach((button) => {
+ button.addEventListener("click", () => {
+ const key = button.getAttribute("data-percent-key");
+ stage =
+ key === "reset" ? "input" : key === "percent" ? "percent" : "result";
+ render();
+ });
+ });
+ demo.querySelector(".percent-operation").hidden = false;
+ demo.querySelector(".percent-controls").hidden = false;
+ render();
+}
+
+function initializeExpertAssembly() {
+ const excerpt = document.querySelector("[data-expert-assembly]");
+ if (excerpt && window.matchMedia("(max-width: 640px)").matches) {
+ excerpt.open = false;
+ }
+}
+
+initializeExpertAssembly();
+initializePercentDemo();
diff --git a/website/public/assets/licenses/dinosaur.txt b/website/public/assets/licenses/dinosaur.txt
new file mode 100644
index 000000000..88ec041e7
--- /dev/null
+++ b/website/public/assets/licenses/dinosaur.txt
@@ -0,0 +1,34 @@
+Selected script excerpts from wayou/t-rex-runner
+Copyright (c) 2014 The Chromium Authors. All rights reserved.
+
+Repository license at commit 5455bfa408ec6b707c7300ff194b7390733a766d:
+
+BSD 3-Clause License
+
+Copyright (c) 2022, 牛さん
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/website/public/assets/main.js b/website/public/assets/main.js
index 98751f280..b927dff64 100644
--- a/website/public/assets/main.js
+++ b/website/public/assets/main.js
@@ -39,23 +39,28 @@ initializeCopyButtons();
function initializeStepComparisons() {
document.querySelectorAll("[data-step-comparison]").forEach((comparison) => {
const buttons = comparison.querySelectorAll("[data-select-step]");
- buttons.forEach((button) => {
- button.addEventListener("click", () => {
- const selected = button.getAttribute("data-select-step");
- buttons.forEach((candidate) => {
- candidate.setAttribute("aria-pressed", String(candidate === button));
- });
- comparison.querySelectorAll("[data-step]").forEach((fragment) => {
- fragment.classList.toggle(
- "is-active",
- fragment.getAttribute("data-step") === selected,
- );
- });
- comparison.querySelectorAll("[data-step-note]").forEach((note) => {
- note.hidden = note.getAttribute("data-step-note") !== selected;
- });
+ const selectStep = (button) => {
+ const selected = button.getAttribute("data-select-step");
+ buttons.forEach((candidate) => {
+ candidate.setAttribute("aria-pressed", String(candidate === button));
});
+ comparison.querySelectorAll("[data-step]").forEach((fragment) => {
+ fragment.classList.toggle(
+ "is-active",
+ fragment.getAttribute("data-step") === selected,
+ );
+ });
+ comparison.querySelectorAll("[data-step-note]").forEach((note) => {
+ note.hidden = note.getAttribute("data-step-note") !== selected;
+ });
+ };
+ buttons.forEach((button) => {
+ button.addEventListener("click", () => selectStep(button));
});
+ const initial = Array.from(buttons).find(
+ (button) => button.getAttribute("aria-pressed") === "true",
+ );
+ if (initial) selectStep(initial);
});
}
diff --git a/website/public/assets/styles.css b/website/public/assets/styles.css
index 8a21650a8..3bcc84d9e 100644
--- a/website/public/assets/styles.css
+++ b/website/public/assets/styles.css
@@ -269,6 +269,162 @@ section[id] {
max-width: 680px;
margin-top: 2.25rem;
}
+.home-hero {
+ padding-block: 4rem 3.5rem;
+}
+.home-definition {
+ display: grid;
+ grid-template-columns: 1fr 1fr;
+ gap: 3rem;
+ align-items: start;
+ margin-bottom: 2rem;
+}
+.home-definition h2,
+.home-definition p {
+ margin: 0;
+}
+.home-calculation {
+ margin: 0;
+}
+.home-code-comparison pre {
+ font-size: 0.85rem;
+ line-height: 1.9;
+}
+.code-key {
+ color: var(--accent);
+ background: #e4ecf5;
+ border-radius: 2px;
+ box-decoration-break: clone;
+ -webkit-box-decoration-break: clone;
+}
+.pan-examples {
+ display: grid;
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ gap: 2.5rem;
+ margin-top: 1.8rem;
+ padding: 1.4rem 1.6rem;
+ border: 1px solid var(--line);
+ border-radius: 5px;
+}
+.pan-example {
+ min-width: 0;
+ text-align: center;
+}
+.pan-label,
+.pan-value,
+.pan-meaning {
+ display: block;
+}
+.pan-label {
+ color: var(--ink);
+ font-size: 0.9rem;
+ font-weight: 600;
+}
+.pan-position {
+ position: relative;
+ height: 2rem;
+ margin-block: 0.6rem;
+}
+.pan-position::before {
+ content: "";
+ position: absolute;
+ top: calc(50% - 1px);
+ left: 0;
+ right: 0;
+ height: 2px;
+ background: var(--line);
+}
+.pan-position i {
+ position: absolute;
+ top: calc(50% - 5px);
+ left: calc(5px + (100% - 10px) * var(--position));
+ width: 10px;
+ height: 10px;
+ transform: translateX(-50%);
+ border-radius: 50%;
+ background: var(--accent);
+}
+.pan-value {
+ font-size: 0.9rem;
+}
+.pan-meaning {
+ margin-top: 0.25rem;
+ color: var(--muted);
+ font-size: 0.8rem;
+}
+.home-calculation figcaption {
+ margin-top: 0.8rem;
+ color: var(--muted);
+ font-size: 0.8rem;
+}
+.home-analysis-work {
+ max-width: 760px;
+ margin: 1.5rem 0 0;
+ color: var(--muted);
+}
+.home-agent-grid,
+.home-try-grid {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1.65fr);
+ gap: 3.5rem;
+ align-items: start;
+}
+.home-reassurance h2 {
+ font-size: clamp(1.75rem, 3vw, 2.2rem);
+}
+.home-no {
+ margin: 1.2rem 0;
+ font-size: clamp(4.5rem, 8vw, 6.5rem);
+ font-weight: 650;
+ letter-spacing: -0.06em;
+ line-height: 1;
+}
+.home-reassurance > :last-child,
+.home-try-grid p {
+ color: var(--muted);
+}
+.home-analysis-terminal {
+ margin: 0 0 0.9rem;
+}
+.terminal-target {
+ margin: 1rem 1.4rem 0;
+ color: #bdc8d4;
+ font-size: 0.75rem;
+}
+.agent-reply {
+ padding: 1.4rem;
+ background: var(--page);
+ color: var(--ink);
+}
+.agent-reply .reply-label {
+ color: var(--accent);
+ font-size: 0.8rem;
+ font-weight: 600;
+}
+.agent-reply > :last-child {
+ margin-bottom: 0;
+}
+.home-evidence {
+ margin-block: 2rem 1.2rem;
+}
+.home-check {
+ max-width: 800px;
+ margin: 0;
+ color: var(--muted);
+ font-size: 0.875rem;
+}
+.home-try-grid {
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1.4fr);
+}
+.home-setup .agent-terminal {
+ margin-block: 1rem;
+}
+.home-setup .code-inline {
+ margin-block: 0.5rem 0.8rem;
+}
+.home-setup > .caption {
+ margin-bottom: 0;
+}
.code-block {
margin-block: 1.3rem;
border: 1px solid var(--line);
@@ -1062,7 +1218,608 @@ pre code {
border: 0;
}
+.home-start-grid {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+ gap: 3.5rem;
+ align-items: center;
+}
+.home-start-grid h1 {
+ font-size: clamp(2.8rem, 5vw, 4.2rem);
+}
+.home-start-grid .home-setup h2 {
+ font-size: 1.3rem;
+ letter-spacing: -0.02em;
+ margin-bottom: 0.7rem;
+}
+.home-start-grid .home-setup > p {
+ font-size: 0.9rem;
+ color: var(--muted);
+}
+.home-question {
+ margin-block: 0 1.8rem;
+ color: var(--muted);
+}
+.home-question strong {
+ color: var(--ink);
+ font-weight: 500;
+}
+.home-purpose {
+ max-width: 850px;
+ margin-bottom: 2rem;
+ color: var(--muted);
+}
+.prose-highlight {
+ padding: 0.04em 0.16em;
+ border-radius: 2px;
+ background: #e4ecf5;
+ color: var(--accent);
+ font-weight: 600;
+ box-decoration-break: clone;
+ -webkit-box-decoration-break: clone;
+}
+.case-brief {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1.3fr);
+ gap: 2.5rem;
+ margin: 0 0 2rem;
+ padding-block: 1.2rem;
+ border-top: 1px solid var(--line);
+ border-bottom: 1px solid var(--line);
+}
+.case-brief dt,
+.finding-label {
+ margin-bottom: 0.45rem;
+ font-size: 0.8rem;
+ font-weight: 600;
+ color: var(--accent);
+}
+.case-brief dd {
+ margin: 0;
+ color: var(--muted);
+ font-size: 0.95rem;
+}
+.case-brief dd strong {
+ color: var(--ink);
+}
+.rea-finding {
+ margin-bottom: 1.4rem;
+ padding-left: 1rem;
+ border-left: 2px solid var(--accent);
+}
+.rea-finding > :last-child {
+ margin: 0;
+ font-size: 0.95rem;
+ color: var(--muted);
+}
+.rea-finding strong {
+ color: var(--ink);
+}
+.home-role-comparison {
+ display: grid;
+ grid-template-columns: minmax(0, 1.65fr) minmax(0, 1fr);
+ gap: 0 2rem;
+ margin: 0;
+}
+.comparison-question {
+ margin-block: 1.8rem 1.2rem;
+ font-size: 1.05rem;
+ color: var(--muted);
+}
+.comparison-question strong {
+ color: var(--ink);
+}
+.comparison-label {
+ padding-bottom: 0.8rem;
+ border-bottom: 1px solid var(--line);
+ font-size: 0.875rem;
+ font-weight: 600;
+}
+.agent-investigation > .comparison-label {
+ color: var(--accent);
+}
+.expert-step-selector {
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ margin-block: 1.2rem 1rem;
+}
+.expert-step-selector button {
+ min-height: 44px;
+ padding: 0.6rem 0.4rem;
+ font-size: 0.75rem;
+}
+.expert-step-selector button span {
+ font-size: 0.7rem;
+}
+.expert-analysis-grid {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(0, 0.52fr);
+ align-items: start;
+ gap: 0.9rem;
+}
+.expert-assembly {
+ min-width: 0;
+ margin: 0;
+}
+.expert-assembly .code-header {
+ padding: 0.7rem 0.8rem;
+ font-size: 0.7rem;
+ cursor: pointer;
+ list-style: none;
+}
+.expert-assembly summary::-webkit-details-marker {
+ display: none;
+}
+.expert-assembly summary:focus-visible {
+ outline: 2px solid var(--accent);
+ outline-offset: 3px;
+}
+.assembly-disclosure::after {
+ content: "Show +";
+ color: var(--accent);
+ white-space: nowrap;
+}
+.expert-assembly[open] .assembly-disclosure::after {
+ content: "Hide −";
+}
+.expert-assembly pre {
+ margin: 0;
+ padding: 0.8rem;
+ font-size: 0.7rem;
+ line-height: 1.6;
+}
+.assembly-omission {
+ color: var(--muted);
+}
+.expert-reasoning {
+ min-width: 0;
+ padding-top: 0.1rem;
+}
+.expert-thought {
+ position: relative;
+ padding: 1rem 0.9rem;
+ border: 1px solid var(--line);
+ border-radius: 16px;
+ background: var(--page);
+}
+.expert-thought + .expert-thought {
+ margin-top: 1rem;
+}
+.expert-thought::before,
+.expert-thought::after {
+ content: "";
+ position: absolute;
+ border: 1px solid var(--line);
+ border-radius: 50%;
+ background: var(--page);
+}
+.expert-thought::before {
+ bottom: -18px;
+ right: 38px;
+ width: 12px;
+ height: 12px;
+}
+.expert-thought::after {
+ bottom: -30px;
+ right: 47px;
+ width: 6px;
+ height: 6px;
+}
+.expert-thought > p {
+ margin: 0;
+ font-size: 0.85rem;
+ line-height: 1.65;
+}
+.expert-thought > .thought-label {
+ margin-bottom: 0.6rem;
+ color: var(--accent);
+ font-size: 0.7rem;
+ font-weight: 600;
+}
+.expert-thought > .expert-task {
+ margin-top: 0.8rem;
+ color: var(--muted);
+ font-size: 0.75rem;
+}
+.expert-facts {
+ display: grid;
+ gap: 0.45rem;
+ margin: 0.9rem 0 0;
+ padding-top: 0.8rem;
+ border-top: 1px solid var(--line);
+ font-size: 0.7rem;
+}
+.expert-facts div {
+ display: flex;
+ justify-content: space-between;
+ gap: 0.5rem;
+}
+.expert-facts dt {
+ font-family: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
+}
+.expert-facts dd {
+ margin: 0;
+ color: var(--accent);
+}
+.expert-rule {
+ display: grid;
+ gap: 0.3rem;
+ margin-top: 0.9rem;
+ padding-top: 0.8rem;
+ border-top: 1px solid var(--line);
+ font-size: 0.75rem;
+}
+.expert-rule strong {
+ color: var(--accent);
+ font-size: 1.4rem;
+}
+.expert-illustration {
+ display: block;
+ width: 120px;
+ height: 90px;
+ margin: 2rem 0 0 auto;
+}
+.expert-caption {
+ margin: 0.5rem 0 0;
+ color: var(--muted);
+ font-size: 0.65rem;
+ text-align: right;
+}
+.manual-work-summary {
+ margin: 1rem 0 0;
+ color: var(--muted);
+ font-size: 0.85rem;
+}
+.manual-work-summary strong {
+ font-weight: 500;
+}
+.agent-one-prompt {
+ margin: 1.2rem 0 0.3rem;
+ color: var(--accent);
+ font-size: clamp(1.8rem, 3vw, 2.5rem);
+ font-weight: 600;
+ letter-spacing: -0.045em;
+}
+.agent-intro {
+ margin: 0 0 1.2rem;
+ color: var(--muted);
+ font-size: 0.9rem;
+}
+.agent-percent-rule {
+ display: grid;
+ justify-items: start;
+ gap: 0.2rem;
+ margin-top: 0.9rem;
+ color: var(--accent);
+}
+.agent-percent-rule code {
+ color: var(--ink);
+}
+.agent-percent-rule > span {
+ margin-left: 0.4rem;
+ color: var(--muted);
+}
+.agent-percent-rule strong {
+ font-size: 1.2rem;
+}
+.agent-evidence-roles {
+ display: grid;
+ gap: 1rem;
+ margin: 1.2rem 0 0;
+}
+.agent-evidence-roles dt {
+ margin-bottom: 0.25rem;
+ color: var(--accent);
+ font-size: 0.75rem;
+ font-weight: 600;
+}
+.agent-evidence-roles dd {
+ margin: 0;
+ color: var(--muted);
+ font-size: 0.85rem;
+}
+.agent-investigation-note {
+ color: var(--muted);
+ font-size: 0.875rem;
+}
+.home-role-comparison figcaption {
+ grid-column: 1 / -1;
+ margin-top: 1.2rem;
+ font-size: 0.8rem;
+ color: var(--muted);
+}
+.home-example-grid {
+ display: grid;
+ grid-template-columns: minmax(0, 0.85fr) minmax(0, 1.15fr);
+ align-items: start;
+ gap: 3rem;
+}
+.percent-figure,
+.dino-demo {
+ min-width: 0;
+ margin: 0;
+ padding: 1.5rem;
+ border: 1px solid var(--line);
+ border-radius: 5px;
+}
+.percent-operation,
+.percent-controls,
+.dino-buttons {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.5rem;
+}
+.percent-operation button,
+.percent-controls button,
+.dino-buttons button {
+ min-height: 44px;
+ border: 1px solid var(--line);
+ border-radius: 4px;
+ padding: 0.5rem 0.8rem;
+ font: inherit;
+ font-size: 0.85rem;
+ color: var(--ink);
+ background: var(--page);
+ cursor: pointer;
+}
+.percent-operation button[aria-pressed="true"] {
+ color: var(--accent);
+ border-color: var(--accent);
+ background: #edf2f8;
+}
+.percent-display {
+ padding: 1.2rem;
+ margin-block: 1rem;
+ border-radius: 4px;
+ background: var(--soft);
+ text-align: right;
+ font-variant-numeric: tabular-nums;
+}
+.percent-expression {
+ display: block;
+ min-height: 1.5rem;
+ color: var(--muted);
+ font-size: 0.9rem;
+}
+.percent-display strong {
+ font-size: 3rem;
+ font-weight: 500;
+ letter-spacing: -0.04em;
+}
+.percent-controls .percent-key {
+ min-width: 68px;
+ font-size: 1.25rem;
+ color: var(--accent);
+ border-color: #bbcce0;
+}
+.percent-controls button:disabled {
+ opacity: 0.45;
+ cursor: default;
+}
+.percent-controls .percent-reset {
+ margin-left: auto;
+ border-color: transparent;
+ color: var(--muted);
+}
+.percent-status {
+ min-height: 3rem;
+ margin-top: 1rem;
+ font-size: 0.9rem;
+}
+.percent-figure figcaption,
+.dino-demo figcaption {
+ margin-top: 0.8rem;
+ color: var(--muted);
+ font-size: 0.8rem;
+}
+.percent-explanation h3 {
+ font-size: 1.2rem;
+}
+.percent-explanation > p {
+ color: var(--muted);
+}
+.percent-rules {
+ margin-bottom: 0;
+}
+.percent-rules > div {
+ padding-block: 0.55rem;
+}
+.percent-rules dt {
+ font-size: 0.8rem;
+ color: var(--muted);
+ margin-bottom: 0.25rem;
+}
+.percent-rules dd {
+ margin: 0;
+ font-size: 0.9rem;
+}
+.percent-rules dd strong,
+.percent-rules dd code {
+ display: block;
+}
+.percent-rules dd strong {
+ margin-bottom: 0.25rem;
+ font-weight: 500;
+}
+.home-evidence-details {
+ margin-top: 2rem;
+ padding-block: 1rem;
+ border-top: 1px solid var(--line);
+ border-bottom: 1px solid var(--line);
+}
+.home-evidence-details > summary {
+ cursor: pointer;
+ font-size: 0.875rem;
+ font-weight: 500;
+}
+.home-evidence-details[open] > summary {
+ margin-bottom: 1.5rem;
+}
+.calculator-trace {
+ margin-block: 1.5rem;
+}
+.dino-example-grid {
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1.15fr);
+ gap: 2.5rem;
+}
+.dino-stage {
+ overflow: hidden;
+ margin-block: 0.8rem;
+ background: var(--soft);
+ border-radius: 4px;
+ color: var(--muted);
+}
+.dino-stage canvas,
+.dino-fallback {
+ display: block;
+ width: 100%;
+ height: auto;
+}
+.dino-stage canvas {
+ touch-action: manipulation;
+}
+.dino-buttons .button {
+ background: var(--ink);
+ border-color: var(--ink);
+ color: white;
+}
+.dino-controls {
+ display: grid;
+ gap: 1.2rem;
+}
+.dino-speed-label {
+ display: grid;
+ grid-template-columns: 1fr auto;
+ gap: 0.5rem;
+ font-size: 0.875rem;
+}
+.dino-speed-label output {
+ font-family: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
+ font-variant-numeric: tabular-nums;
+ color: var(--accent);
+}
+.dino-speed-label input {
+ grid-column: 1 / -1;
+ width: 100%;
+ margin: 0;
+ min-height: 30px;
+ accent-color: var(--accent);
+}
+.dino-auto-label {
+ display: flex;
+ align-items: center;
+ gap: 0.6rem;
+ min-height: 36px;
+ font-size: 0.8rem;
+ color: var(--muted);
+}
+.dino-auto-label input {
+ width: 17px;
+ height: 17px;
+ flex-shrink: 0;
+ accent-color: var(--accent);
+}
+.dino-status {
+ min-height: 2.6rem;
+ margin: 1rem 0 0;
+ font-size: 0.8rem;
+ color: var(--muted);
+}
+.dino-rule {
+ color: var(--muted);
+ font-size: 0.95rem;
+}
+.dino-rule strong {
+ color: var(--ink);
+}
+.dino-loop {
+ margin-top: 2rem;
+}
+.dino-lab-demo {
+ margin-block: 2rem;
+}
+.dino-lab-demo .dino-stage {
+ margin-block: 1.5rem;
+}
+.speed-check-table td:last-child,
+.speed-check-table th:last-child {
+ text-align: right;
+}
+[hidden] {
+ display: none !important;
+}
@media (max-width: 850px) {
+ .home-start-grid,
+ .home-role-comparison,
+ .home-example-grid {
+ grid-template-columns: minmax(0, 1fr);
+ gap: 2rem;
+ }
+ .home-start-grid .home-setup {
+ max-width: 620px;
+ }
+ .home-start-grid h1 {
+ font-size: clamp(2.7rem, 9vw, 4.65rem);
+ }
+ .home-role-comparison figcaption {
+ margin-top: 0;
+ }
+}
+@media (max-width: 640px) {
+ .expert-analysis-grid {
+ grid-template-columns: minmax(0, 1fr);
+ }
+ .expert-reasoning {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) 88px;
+ column-gap: 0.75rem;
+ align-items: end;
+ }
+ .expert-thought::before {
+ right: -18px;
+ bottom: 42px;
+ }
+ .expert-thought::after {
+ right: -30px;
+ bottom: 36px;
+ }
+ .expert-illustration {
+ width: 88px;
+ height: 66px;
+ margin: 0;
+ }
+ .expert-caption {
+ grid-column: 1 / -1;
+ text-align: left;
+ }
+ .expert-step-selector button {
+ font-size: 0.7rem;
+ }
+ .expert-step-selector button span {
+ display: block;
+ margin: 0 0 0.2rem;
+ }
+ .case-brief {
+ grid-template-columns: minmax(0, 1fr);
+ gap: 1.2rem;
+ }
+ .home-hero {
+ padding-block: 2.8rem;
+ }
+ .percent-figure,
+ .dino-demo {
+ padding: 1.1rem;
+ }
+}
+
+@media (max-width: 850px) {
+ .home-agent-grid,
+ .home-try-grid {
+ grid-template-columns: 1fr;
+ gap: 2rem;
+ }
+ .home-reassurance {
+ max-width: 600px;
+ }
.brand-caption {
display: none;
}
@@ -1096,6 +1853,31 @@ pre code {
}
@media (max-width: 640px) {
+ .home-definition {
+ grid-template-columns: 1fr;
+ gap: 0.8rem;
+ }
+ .pan-examples {
+ grid-template-columns: 1fr;
+ gap: 1.3rem;
+ padding: 1.2rem;
+ }
+ .pan-example {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1.6fr);
+ column-gap: 1rem;
+ text-align: left;
+ }
+ .pan-position {
+ grid-column: 2;
+ grid-row: 1;
+ margin: 0;
+ height: 1.6rem;
+ }
+ .pan-value,
+ .pan-meaning {
+ grid-column: 1 / -1;
+ }
.back-to-top {
right: calc(1rem + env(safe-area-inset-right, 0px));
bottom: calc(1rem + env(safe-area-inset-bottom, 0px));
diff --git a/website/public/examples/dino-lab/index.html b/website/public/examples/dino-lab/index.html
new file mode 100644
index 000000000..38038c91d
--- /dev/null
+++ b/website/public/examples/dino-lab/index.html
@@ -0,0 +1,334 @@
+
+
+
+
+
+ Dinosaur speed lab — REA
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+ Home / Dinosaur speed lab
+
+
Inspect → rebuild → change
+
Rebuild the dinosaur’s speed rule.
+
+ To recreate the game’s acceleration, first find the rule that controls
+ its speed. REA returned the running script;
+ we used its rule to build this mini-game with
+ adjustable speed.
+
+
+
+
+ On this page
+
+
+
+
+ Play and change the speed
+
+ Press Play, then jump over the cactus. Move the speed slider to
+ try a slower or faster game; it switches to a fixed speed. Select
+ the recovered rule to start at 6 and gradually accelerate again.
+
+
+ Play the reconstruction
+
+
+
+
+ 6 → 10 → 13
+
+
+
+
+
+
+ Original rule: start at 6, then increase toward 13.
+
+
+ Move the slider to set your own speed. Space or Jump clears a
+ cactus.
+
+
+ Enable JavaScript to play the reconstruction. The code and
+ explanation above remain readable.
+
+
+
+
+ Read the script REA returned
+
+ We inspected
+ wayou’s Chromium-derived browser edition
+ with REA. It returned the loaded index.js, including
+ this branch in the game’s update function:
+
+
+
+
if (this.currentSpeed < this.config.MAX_SPEED) {
+ this.currentSpeed += this.config.ACCELERATION;
+}
+
+
+ The settings are SPEED: 6,
+ ACCELERATION: 0.001 and MAX_SPEED: 13.
+ The game runs this branch on an update without a collision.
+
+ Use the same rule in the new game
+
+
+
function advanceSpeed(speed) {
+ return speed < 13 ? speed + 0.001 : speed;
+}
+
+
+ The mini-game uses this function for automatic acceleration.
+ Moving the slider supplies a fixed speed instead. Drawing, jump
+ physics and rectangle collision checks are new code for this
+ teaching game; its simulation advances at 60 updates per second.
+
+
+ Download the speed rule
+ · Read the game code
+
+
+
+ Check the reconstruction
+
+ We called the original game’s update function with obstacles and
+ automatic scheduling disabled. Compare those recorded speeds with
+ a replay of the recovered rule.
+
+
+
+ Run the speed check
+
+
+ Values rounded to three decimals. The branch checks before adding,
+ so the final increment can take speed just above 13.
+
+
+
+ Try the analysis yourself
+
+
+ Set up REA with your coding
+ agent.
+
+
+ Follow the
+ browser connection steps , using https://wayou.github.io/t-rex-runner/ as
+ the page URL.
+
+
+ Give your agent the page URL and local debugging endpoint, then
+ copy this prompt.
+
+
+
+
+
+ › Use REA to inspect this dinosaur game. Why does it get
+ faster? Show the speed rule, then build a small version with
+ an adjustable speed.
+
+
+
+ Ask a follow-up:
+ “Where is jump height calculated? Add a jump-height control to
+ the new version.”
+
+
+ Source:
+ inspected speed code , Chromium Authors.
+ Copyright and BSD license . REA 4.1.0 inspected the running HTTP edition in Chrome 150.
+
+
+
+
+
+
+
+ ↑ Top
+
+
diff --git a/website/public/first-investigation/index.html b/website/public/first-investigation/index.html
new file mode 100644
index 000000000..3c4828cd2
--- /dev/null
+++ b/website/public/first-investigation/index.html
@@ -0,0 +1,371 @@
+
+
+
+
+
+ Your first investigation — REA
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+ Home / Your first investigation
+
+
Find out where exported notes go.
+
+ Use REA to inspect a small app, follow its Export notes button and
+ check one detail yourself.
+
+
+ A supplied example · Node.js and npm · Your coding agent
+
+
+
+
+ In this exercise
+
+
+
+
+ 1. Connect your agent to REA
+
+ Use a coding agent such as Claude Code, Codex or Cursor. You’ll
+ need Node.js and npm; the
+ setup guide lists supported versions .
+
+
+
+
+ › Install REA and connect it to this coding agent using npx
+ rea-agents@latest setup. Show me the setup plan for approval,
+ then verify the installation.
+
+
+ Or run this command in your terminal:
+
+ npx rea-agents@latest setup
+
+ Copy
+
+
+
+ Review the plan, approve the setup, then restart your agent.
+ Already connected? Continue below.
+
+
+
+ 2. Ask where the CSV is written
+
+ The example is a six-file Electron app with an
+ Export notes button. Your agent can inspect its
+ code without installing or launching Electron.
+
+
+
+
+ › Download https://rea.tools/examples/notes-example.zip into a
+ new example folder and unpack it. Use REA to find what happens
+ when I click Export notes. Show where notes.csv is written,
+ which fields it contains, and the relevant files and
+ lines.
+
+
+
+ Your agent downloads the files and gives the unpacked folder to
+ REA for inspection.
+
+
+ Download example ZIP
+
+
+ If your agent can’t download files, unzip this archive yourself.
+ Give it the path to the notes-example folder and the
+ same export question.
+
+
+
+ 3. Follow the answer back to the code
+ Look for a short explanation with file and line references:
+
+
+ The button sends a notes:export message. The main
+ process formats the notes as CSV and writes
+ notes.csv in the user’s Downloads folder. The
+ columns are id and title.
+
+
+
+ From the button to the file writer
+
+
+ Page · renderer.js Export notes Calls notes.exportCsv().
+
+
+ Bridge · preload.js notes:exportSends a named message to the main process.
+
+
+ Handler · main.js Write notes.csv Calls the formatter in csv.js and writes the
+ file.
+
+
+
+ REA’s static analysis pairs the message with its handler. The
+ destination is read from code.
+
+
+
+
+
ipcMain.handle("notes:export", () => {
+ const destination = path.join(app.getPath("downloads"), "notes.csv");
+ writeFileSync(destination, toCsv(notes), "utf8");
+ return destination;
+});
+
+
+ The file path, formatter and write call are together in this
+ handler. Ask your agent to show these lines if its answer leaves
+ them out.
+
+
+ See the full code trace and recorded REA result .
+
+
+
+ 4. Check a prediction
+
+ A comma separates CSV columns. What happens when a note title
+ itself contains a comma or quotation marks?
+
+
+
+
+ › Predict the CSV for a note with id 1 and title Hello, "REA".
+ Then run the example’s toCsv formatter with Node.js to check
+ it. Show the prediction and actual output.
+
+
+
+
+
id,title
+1,"Hello, ""REA"""
+
+
+ The title stays in one quoted field; each quotation mark is
+ doubled. This checks the formatter directly with Node.js.
+
+
+ Run the check yourself
+
+ Open a terminal in the unpacked
+ notes-example folder:
+
+
+
+
node <<'JS'
+const { toCsv } = require('./csv.js');
+process.stdout.write(toCsv([{ id: 1, title: 'Hello, "REA"' }]));
+JS
+
+
+ This command uses a shell with here-document support, such as
+ Bash or Zsh. Your agent can run the same JavaScript in your
+ platform’s shell.
+
+
+
+
+ 5. Ask another question
+ Try a follow-up in the same conversation:
+
+
+ What happens if the file can’t be written? Follow the error back
+ to the page.
+
+
+
+ Or give your agent an app of your own and ask about one button,
+ file or behavior.
+
+
+
+
+
+
+
+
+ ↑ Top
+
+
diff --git a/website/public/index.html b/website/public/index.html
index e315e63ff..26f8d2b0a 100644
--- a/website/public/index.html
+++ b/website/public/index.html
@@ -12,6 +12,8 @@
+
+
Skip to content
@@ -50,55 +52,781 @@
-
- Software analysis · CLI & MCP
- Find out how software works.
-
- Use REA with your coding agent to inspect binaries, trace application
- code and observe runtime behavior.
-
-
-