[PR #1077] [MERGED] docs(website): add a CTF showcase and FAQ #2625

Closed
opened 2026-10-17 21:08:22 +00:00 by bsakaguchi · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/1077
Author: @N0zoM1z0
Created: 10/8/2026
Status: ✅ Merged
Merged: 10/8/2026
Merged by: @N0zoM1z0

Base: main ← Head: feat/website-ctf-faq


📝 Commits (2)

  • ef9d09e docs(website): add a worked CTF reverse-engineering showcase
  • 31ba8c4 docs(website): add a dedicated FAQ page

📊 Changes

19 files changed (+1399 additions, -27 deletions)

View changed files

📝 website/README.md (+24 -1)
➕ website/evidence/ctf-masked-squares.md (+110 -0)
📝 website/figures.md (+14 -0)
➕ website/public/assets/figures/ctf-mask-equation.svg (+23 -0)
📝 website/public/assets/main.js (+22 -0)
📝 website/public/assets/styles.css (+30 -13)
➕ website/public/faq/index.html (+413 -0)
📝 website/public/get-started/index.html (+6 -2)
📝 website/public/guides/browser/index.html (+2 -2)
📝 website/public/guides/index.html (+2 -2)
📝 website/public/guides/javascript/index.html (+2 -2)
📝 website/public/guides/native/index.html (+2 -2)
📝 website/public/index.html (+32 -0)
➕ website/public/showcase/ctf/index.html (+620 -0)
➕ website/public/showcase/ctf/solve.py (+72 -0)
📝 website/public/showcase/dx-ball/index.html (+1 -0)
📝 website/public/showcase/index.html (+22 -3)
📝 website/public/showcase/notion/index.html (+1 -0)
📝 website/public/showcase/th04/index.html (+1 -0)

📄 Description

Adds a worked DownUnderCTF flag-checker showcase and a dedicated FAQ page. The showcase follows REA results from prompt references to checking functions, compressed masks and equations, then verifies the recovered flag in the original program. It includes an equation figure, selectable assembly-to-C steps, an example agent prompt and a downloadable Python/Z3 solver. The home and showcase index link to the new case.

The FAQ answers 14 questions about setup, updates, analysis, troubleshooting and sharing examples. Answers use native disclosures, copyable commands and on-site guide links. Answer fragments open the relevant disclosure, and the shared navigation includes FAQ on every reading page. Mobile navigation fits its five links at 320px. The website README documents FAQ maintenance.

Validation:

  • python3 scripts/prepare-website.py and python3 scripts/verify-website.py: 14 HTML pages, 261 local references, SVG XML, the example ZIP and the sole manual Pages publisher.
  • Formatting, JavaScript syntax and Git whitespace checks passed.
  • Browser checks at both / and /rea/: answer links, clipboard, showcase steps, downloads, keyboard controls, no-JavaScript disclosures and reduced motion; all pages checked at eight widths from 320px to 1440px.
  • Real REA 4.1.0 / Ghidra 12.1.4 inspection on Linux x64 established the CTF functions and extracted constants. REA process captures observed the recovered flag accepted with exit 0 and a one-character mutation rejected with exit 255. Provenance and verification scope are recorded in website/evidence/ctf-masked-squares.md.

The existing manual Pages publication workflow is unchanged.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/1077 **Author:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Created:** 10/8/2026 **Status:** ✅ Merged **Merged:** 10/8/2026 **Merged by:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Base:** `main` ← **Head:** `feat/website-ctf-faq` --- ### 📝 Commits (2) - [`ef9d09e`](https://github.com/morluto/rea/commit/ef9d09e3beac5e8a5adf4cca5b30c9fa2bb03525) docs(website): add a worked CTF reverse-engineering showcase - [`31ba8c4`](https://github.com/morluto/rea/commit/31ba8c453b190e0cfdb7107e75642d7184671f29) docs(website): add a dedicated FAQ page ### 📊 Changes **19 files changed** (+1399 additions, -27 deletions) <details> <summary>View changed files</summary> 📝 `website/README.md` (+24 -1) ➕ `website/evidence/ctf-masked-squares.md` (+110 -0) 📝 `website/figures.md` (+14 -0) ➕ `website/public/assets/figures/ctf-mask-equation.svg` (+23 -0) 📝 `website/public/assets/main.js` (+22 -0) 📝 `website/public/assets/styles.css` (+30 -13) ➕ `website/public/faq/index.html` (+413 -0) 📝 `website/public/get-started/index.html` (+6 -2) 📝 `website/public/guides/browser/index.html` (+2 -2) 📝 `website/public/guides/index.html` (+2 -2) 📝 `website/public/guides/javascript/index.html` (+2 -2) 📝 `website/public/guides/native/index.html` (+2 -2) 📝 `website/public/index.html` (+32 -0) ➕ `website/public/showcase/ctf/index.html` (+620 -0) ➕ `website/public/showcase/ctf/solve.py` (+72 -0) 📝 `website/public/showcase/dx-ball/index.html` (+1 -0) 📝 `website/public/showcase/index.html` (+22 -3) 📝 `website/public/showcase/notion/index.html` (+1 -0) 📝 `website/public/showcase/th04/index.html` (+1 -0) </details> ### 📄 Description Adds a worked DownUnderCTF flag-checker showcase and a dedicated FAQ page. The showcase follows REA results from prompt references to checking functions, compressed masks and equations, then verifies the recovered flag in the original program. It includes an equation figure, selectable assembly-to-C steps, an example agent prompt and a downloadable Python/Z3 solver. The home and showcase index link to the new case. The FAQ answers 14 questions about setup, updates, analysis, troubleshooting and sharing examples. Answers use native disclosures, copyable commands and on-site guide links. Answer fragments open the relevant disclosure, and the shared navigation includes FAQ on every reading page. Mobile navigation fits its five links at 320px. The website README documents FAQ maintenance. Validation: - `python3 scripts/prepare-website.py` and `python3 scripts/verify-website.py`: 14 HTML pages, 261 local references, SVG XML, the example ZIP and the sole manual Pages publisher. - Formatting, JavaScript syntax and Git whitespace checks passed. - Browser checks at both `/` and `/rea/`: answer links, clipboard, showcase steps, downloads, keyboard controls, no-JavaScript disclosures and reduced motion; all pages checked at eight widths from 320px to 1440px. - Real REA 4.1.0 / Ghidra 12.1.4 inspection on Linux x64 established the CTF functions and extracted constants. REA process captures observed the recovered flag accepted with exit 0 and a one-character mutation rejected with exit 255. Provenance and verification scope are recorded in `website/evidence/ctf-masked-squares.md`. The existing manual Pages publication workflow is unchanged. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
bsakaguchi 2026-10-17 21:08:22 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
morluto/rea#2625
No description provided.