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 + + + + + + + + + + +
+
+ +

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. +

+
+
+ +
+
+

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. +
+ +
+
+
+

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: +

+
+
+ REA · selected script source +
+
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

+
+
+ Reconstruction · dino-speed.js +
+
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. +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
UpdatesOriginal gameReconstructed rule
06.0006.000
1,0007.0007.000
4,00010.00010.000
10,00013.00113.001
+
+ +

+ Values rounded to three decimals. The branch checks before adding, + so the final increment can take speed just above 13. +

+
+
+

Try the analysis yourself

+
    +
  1. + Set up REA with your coding + agent. +
  2. +
  3. + Follow the + browser connection steps, using https://wayou.github.io/t-rex-runner/ as + the page URL. +
  4. +
  5. + Give your agent the page URL and local debugging endpoint, then + copy this prompt. +
  6. +
+
+
+ Your coding agent +
+

+ 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 + + + + + + + + + +
+
+ +

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 +

+
+
+ +
+
+

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. +

+
+
+ Your coding agent + +
+

+ 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 + +
+

+ 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. +

+
+
+ Your coding agent + +
+

+ 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

+
    +
  1. + Page · renderer.jsExport notesCalls notes.exportCsv(). +
  2. +
  3. + Bridge · preload.jsnotes:exportSends a named message to the main process. +
  4. +
  5. + Handler · main.jsWrite notes.csvCalls the formatter in csv.js and writes the + file. +
  6. +
+
+ REA’s static analysis pairs the message with its handler. The + destination is read from code. +
+
+
+
+ main.js · lines 8–12Source +
+
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? +

+
+
+ Your coding agent + +
+

+ 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. +

+
+
+
+ Expected formatter 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 · CSV formatter +
+
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 @@ + + @@ -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. -

- -
-
-
- Your coding agent +
+
+
+

Reverse engineering, with your coding agent

+

Find out how
software works.

+

+ REA gives your agent the tools to inspect a program and explain + what it does. +

+ +
+
+

Set up REA

+

Copy this into your coding agent:

+
+
+ Your coding agent + +
+

+ 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 in your terminal:

+
+ npx rea-agents@latest setup
-

- 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. +

+ Approve the setup plan, then restart your agent.

-

Or run this command in your terminal:

-
- npx rea-agents@latest setup - +
+
+ +
+
+
+

What is reverse engineering?

+

+ Finding out how software works by + examining the program itself. +

+

+ The goal: understand a feature well enough to + explain it, + change it or + rebuild it. +

+

+ One question: + why does Calculator give 220 for 200 + 10%? +

+
+
+

Before REA · You investigate

+
+ + + +
+
+
+ + Original x64 · selected instructions + + +
0x180124945: MOV EAX, dword ptr [R13 + 0x18]
+0x180124949: CMP EAX, 0x5c
+0x18012494c: JZ 0x180124aba
+0x180124952: CMP EAX, 0x5b
+0x180124955: JZ 0x180124aba
+0x18012495b: MOV EDX, 0x64
+0x180124960: LEA RCX, [RSP + 0x160]
+0x180124968: CALL 0x180122650
+0x18012496e: LEA RDX, [R13 + 0x160]
+0x180124975: LEA RCX, [RSP + 0x78]
+0x18012497a: CALL 0x180109720
+0x18012497f: MOV RSI, RAX
+0x180124982: MOV qword ptr [RSP + 0x28], RAX
+0x180124987: LEA RDX, [RSP + 0x160]
+0x18012498f: MOV RCX, RAX
+0x180124992: CALL 0x180123190
+; … value-copy instructions omitted …
+0x180124a14: MOV RDX, RDI
+0x180124a17: LEA RCX, [RSP + 0xf8]
+0x180124a1f: CALL 0x180109720
+0x180124a24: LEA R8, [RSP + 0x30]
+0x180124a29: MOV RDX, RAX
+0x180124a2c: LEA RCX, [RSP + 0xb8]
+0x180124a34: CALL 0x180123c10
+
+ +
+

+ You decode the instructions, follow the calls and reconstruct + the calculation. +

+
+
+

With REA · You ask your agent

+

One prompt.

+

+ Ask your agent in plain English. +

+
+
+ Example prompt · Calculator + +
+

+ Use REA to inspect Windows Calculator. Why does 200 + 10% + give 220? +

+
+

+ Example answer · based on the findings +

+

+ After +, the % button takes + a percentage of the first number. +

+
+ 10% of 200 = 20200 + 20 = 220 +
+
+
+
+
+
REA supplies
+
+ The handler’s instructions, decompiled code and calls. +
+
+
+
Your agent explains
+
+ Which branch applies, what it calculates and how to rebuild + it. +
+
+
+
+
+ Selected assembly from the installed Calculator DLL. The thoughts + and reply illustrate the findings. + See the calculation and sources ↓ +
+
+
+
+ +
+
+
+

Example 01 · Chrome’s dinosaur game

+

Why does the dinosaur get faster?

+
+
+
+
Goal
+
+ Rebuild the game with + adjustable speed. +
+
+
+
Why reverse engineer it?
+
+ To reproduce its acceleration, we need + the rule in the running game: how fast it + starts, how much it increases and when it stops. +
+
+
+
+
+

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. +
+ +
+
+
+

REA returned

+

+ The script actually running in the page. The + agent reads its update function and speed settings, then uses + that rule in a new game. +

+
+
+
+ Example prompt · Dinosaur game + +
+

+ 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. +

+
+

+ Inspected target: + wayou’s Chromium-derived browser edition. +

+
+
+ REA · loaded index.js · selected lines +
+
if (this.currentSpeed < this.config.MAX_SPEED) {
+  this.currentSpeed += this.config.ACCELERATION;
+}
+
+

+ Start at 6. Add 0.001 each + update without a collision, while speed is below + 13. +

+ Open the speed lab → +
+
+
+

What each part does

+
    +
  1. + 01 · REARead the running game’s scriptReturn its actual code and settings to the agent. +
  2. +
  3. + 02 · Your agentRebuild the rule, add a controlUse the recovered acceleration in a small game with a speed + slider. +
  4. +
  5. + 03 · YouChange the speed and playTry the original acceleration, then choose your own + pace. +
  6. +
+
+
+ + See the script, checks and how to try the analysis + +

+ REA inspected the HTTP browser edition through a local debugging + connection and returned the loaded index.js, + including its source and digest. +

+
+
+ Selected settings from the inspected script +
+
ACCELERATION: 0.001,
+MAX_SPEED: 13,
+SPEED: 6
+
+

+ We called the original game’s update function in a controlled + browser check, with obstacles and automatic scheduling disabled. + After 4,000 updates, speed was 10.0; after 10,000, it was 13.0, + rounded to one decimal. +

+

+ The new mini-game keeps that speed rule. Its drawing, jumping and + collision code are a small teaching implementation. + Open the lab to see the new code + and run the same speed check. +

+

+ To inspect the target yourself, follow the + browser connection steps + using + the dinosaur page. Give your agent that page URL and your local debugging + endpoint, then copy the prompt above. +

+

+ Inspected speed code + · + Chromium Authors · BSD license +

+
+
+
+ +
+
+
+

Example 02 · Windows Calculator

+

Why does 200 + 10% give 220?

+
+
+
+
Goal
+
+ Explain the result and + recreate Calculator’s % rule. +
+
+
+
Why reverse engineer it?
+
+ The same button uses + different rules after + and ×. We inspect the + installed app to find which number the percentage is applied to. +
+
+
+
+
+

Try the calculation

+ +
+ 200 + + 20 +
+ +

+ 10% of 200 = 20. Then 200 + 20 = 220. +

+
+ Interactive illustration of the inspected percentage rule. +
+
+
+
+

REA returned

+

+ The % handler’s original instructions and decompiled + code. + The agent reads the two branches and explains which rule each + operator uses. +

+
+

+ For this example, previous = 200 and + current = 10. +

+
+
+ Example prompt · Calculator + +
+

+ Use REA to inspect Windows Calculator. Why does 200 + 10% + give 220? Show the code behind the % button. +

+
+
+
+ Readable summary of the % handler +
+
if (operation == multiply || operation == divide) {
+  percent = current / 100;
+} else {
+  percent = current * previous / 100;
+}
+
+
+
+
With +
+
+ Take 10% of the first number.10% of 200 = 20 → 200 + 20 = 220 +
+
+
+
With ×
+
+ Turn 10% into 0.1.200 × 0.1 = 20 +
+
+
+
+
+
+

From the installed app to an explanation

+
    +
  1. + 01 · REA reads calc.exeIt launches the Calculator appThe code opens ms-calculator:. The agent then + selects the installed app’s library. +
  2. +
  3. + 02 · REA reads the libraryReturn the % handler’s codeThe function checks the operator and uses the constant + 100. +
  4. +
  5. + 03 · Your agent interprets itExplain and reproduce the rulesCrosscheck the branch with Microsoft’s source, then try + and + × above. +
  6. +
+
+
+ See the real code and how the answer was checked + +
+
+
+ REA · selected original instructions +
+
0x180124945: MOV EAX, dword ptr [R13 + 0x18]
+0x180124949: CMP EAX, 0x5c
+0x18012494c: JZ 0x180124aba
+0x180124952: CMP EAX, 0x5b
+0x180124955: JZ 0x180124aba
+0x18012495b: MOV EDX, 0x64
+
+
+
+ Operator IDs · Microsoft’s source +
+
#define IDC_MUL 92      // 0x5c
+#define IDC_DIV 91      // 0x5b
+#define IDC_PERCENT 118 // 0x76
+
+0x64 = 100
+
+
+ +

+ Inspected with REA 4.1.0: Windows Calculator 11.2508.4.0, x64. The + readable summary uses names from Microsoft’s public source to + explain the recovered branch. +

+

+ Percentage implementation + · + Microsoft’s test cases + · Native setup guide +

+
+
+
+ +
+
+
+

Your first investigation

+

Try REA on a small app.

+

+ Download our Notes example, trace its CSV export, and check one + changed input. +

+
+ Try the guided example
@@ -139,34 +867,6 @@
-
-
-
-
- Ask a question about a local app, binary or browser. Your agent uses REA through CLI or MCP to inspect and trace with analysis tools. REA returns code, references and unknowns. Your agent uses the evidence to explain, implement and test, and can ask follow-up questions. -
-
- REA connects your agent to analysis tools. The findings guide the - next question, explanation or implementation. - Open figure -
-
-
-
-
@@ -177,12 +877,6 @@ in C, using REA to inspect the executable and independent tests to check the recovered behavior.

-

- To recover a sound-pan calculation, the agent used REA to inspect - the instructions, follow a caller and read the constants. Those - findings led to a C function checked against the original behavior - and all 63 compiled bytes. -

Follow the investigation