Finalize docs and archive prompts

Co-authored-by: OpenAI Codex <codex@openai.com>

AGENTS.md

@@ -27,10 +27,10 @@ technical cutaway animation.
   through Transformers/custom code for the vision step if GGUF endpoint quality
   is not reliable enough for the demo.
 - Local code serves a trusted `index.html` through `gradio.Server` and exposes
-  `/analyze_image` plus compatibility `/generate_scene`. The latest deployed
-  private Space was verified before the June 14, 2026 review-security pass; any
-  new code changes still need the normal GitHub-to-HF sync and deployment
-  verification.
+  `/analyze_image` plus `/generate_scene`. The final public Space is
+  `build-small-hackathon/Snap2Sim` at
+  `https://build-small-hackathon-snap2sim.hf.space`; any new code changes still
+  need the normal GitHub-to-HF sync and deployment verification.
 - Scene rendering is deterministic browser-side Three.js from the validated
   analysis JSON. Do not reintroduce model-authored HTML scene injection.
 - Endpoint naming is `generate_scene` everywhere in active code.
@@ -41,10 +41,10 @@ technical cutaway animation.
 
 ## Project Structure
 
-- `PROMPT.md` - original product, model, design, and delivery requirements.
+- `prompts/` - archived build prompts and Codex task specs.
 - `docs/` - implementation notes, review passes, and representative fixtures.
 - `README.md` - quickstart, runtime decision, and repo map.
-- `SECURITY.md` - public/private data handling rules for humans and agents.
+- `SECURITY.md` - public deployment data handling rules for humans and agents.
 - `.env.example` - public Hugging Face Space / local demo variables.
 - `.hfignore` - excludes local credentials, caches, GGUF files, and artifacts
   from Hugging Face uploads.
@@ -71,7 +71,7 @@ technical cutaway animation.
 
 ## What Has Been Done
 
-- Read `PROMPT.md` and implemented the requested initial scaffold.
+- Read `prompts/PROMPT.md` and implemented the requested initial scaffold.
 - Added a modular Gradio app with a two-pane technical cutaway / field manual
   visual direction.
 - Added loading/status language and a styled fallback visualization path so the
@@ -150,7 +150,7 @@ technical cutaway animation.
   `https://github.com/Bigstonks1/Snap2Sim/actions/runs/27487136019`.
 - Hugging Face Space `jasondo111/Snap2Sim` reports SHA
   `d70e374bea16acaa41c322942815d3cb213745f4`, matching GitHub `main`.
-- `PROMPT.md` was updated with a new critical path: `gradio.Server`,
+- `prompts/PROMPT.md` was updated with a new critical path: `gradio.Server`,
   `index.html`, A-Frame model scene generation, `generate_scene` naming, and a
   deterministic Three.js fallback in browser JS.
 - Documented GitHub as the source of truth:
@@ -414,7 +414,7 @@ technical cutaway animation.
   `main`. GitHub Actions sync run `27576590128` completed successfully, and the
   public Hugging Face Space reported SHA
   `92853cc9acf19555524a7f65b189926e9088f4fb`. The synced Space includes
-  `PRESENTATION_PROMPT.md`, `presentation/deck.html`, and
+  `prompts/PRESENTATION_PROMPT.md`, `presentation/deck.html`, and
   `presentation/assets/.gitkeep`.
 - User transferred the public Space to
   `build-small-hackathon/Snap2Sim` on June 15, 2026. Verification confirmed the
@@ -426,16 +426,17 @@ technical cutaway animation.
   HTML field for `EXAMPLE_ANALYSIS`; `/analyze_image` returned a real Modal
   analysis for a synthetic target-like image as `rotary indexing mechanism` at
   `0.85` confidence with 3 parts.
+- Final public submission links were added on June 15, 2026:
+  YouTube demo `https://youtu.be/nuisDKMyyF8` and X post
+  `https://x.com/Ryno67114241/status/2066660199558152411`.
 
-## Next Work
+## Final State / Maintenance Notes
 
-- Measure the larger llama.cpp reasoning budget with representative real photos;
-  tune token/context/timeout values down if valid JSON remains reliable with
-  lower latency. The synthetic Modal check now succeeds with the current
-  `4096` output token, `8192` context, `300s` timeout settings.
 - The Hugging Face Space is now public under
   `build-small-hackathon/Snap2Sim`. Keep README, presentation links, and
   `.github/workflows/sync_to_hf.yml` pointed at that org-owned Space.
+- The public submission is complete with the app, README, presentation deck,
+  YouTube demo, and X post linked from the repository.
 - Keep the README opening hook intact: "You find a small metal cylinder at a
   flea market. What is it? How does it work inside?" Maintain the judge-facing
   YAML tags and public pitch if future README updates are needed.

README.md

@@ -44,6 +44,8 @@ the pawl catching, the port opening.
 - Hugging Face Space: https://huggingface.co/spaces/build-small-hackathon/Snap2Sim
 - App host: https://build-small-hackathon-snap2sim.hf.space
 - Source of truth: https://github.com/Bigstonks1/Snap2Sim
+- Demo video: https://youtu.be/nuisDKMyyF8
+- X post: https://x.com/Ryno67114241/status/2066660199558152411
 
 The Space is public for submission under the Build Small Hackathon organization.
 The app is built as a Gradio Space with a custom `gradio.Server` shell; GitHub
@@ -65,7 +67,7 @@ The README metadata tags request consideration for:
 | Modal Award | GPU inference is deployed through Modal with cached model assets. |
 | OpenAI Codex | Built with Codex assistance and Codex-attributed commits in the linked GitHub repo. |
 | Off-Brand | The experience is a branded maker tool, not a generic chatbot or image demo. |
-| Best Demo / Sharing is Caring | Targeted once the public demo video and social post links are added to this README. |
+| Best Demo / Sharing is Caring | Public demo video and X post are linked in the Demo section. |
 | Off the Grid | Not claimed while inference runs on Modal. |
 
 ## How It Works
@@ -181,13 +183,14 @@ $env:PYTHONIOENCODING="utf-8"; python -m modal run modal_app.py::run_runtime_pre
 - `app.py` - Gradio Server app, same-origin APIs, image validation, rate limits.
 - `index.html` - upload flow, analysis panel, Three.js renderer, fallback UI.
 - `modal_app.py` - Modal deployment, llama.cpp runtime, diagnostics.
+- `prompts/` - archived original build prompt, GitHub sync prompt, and deck prompt.
 - `presentation/deck.html` - reveal.js judging deck for the hackathon pitch.
 - `docs/` - implementation notes, review passes, and representative fixtures.
 - `snap2sim/backend.py` - backend selection and authenticated Modal client.
 - `snap2sim/prompts.py` - vision prompt contract.
 - `snap2sim/schema.py` - mechanism JSON schema and sample payload.
 - `scripts/verify_runtime_assets.py` - Hugging Face model metadata preflight.
-- `SECURITY.md` - public/private handling rules for deployment.
+- `SECURITY.md` - public deployment handling rules.
 
 ## Acknowledgements
 

SECURITY.md

@@ -1,10 +1,7 @@
 # Security Notes
 
-This project is intended to become a public hackathon demo, but the deployed
-Hugging Face Space is private right now by user decision. Treat the repo,
-README, screenshots, and Codex-visible files as public unless explicitly told
-otherwise, and do not make the Space public until the user explicitly approves
-that change.
+This project is a public hackathon demo. Treat the repo, README, screenshots,
+and Codex-visible files as public unless explicitly told otherwise.
 
 ## Do Not Commit Or Expose
 
@@ -40,14 +37,15 @@ explicitly asks. The URLs are not credentials, but keeping them out of public
 docs reduces casual discovery, and the bearer token is the real protection
 against credit-spending spam.
 
-The Hugging Face Space at `jasondo111/Snap2Sim` is private as of the latest
-deployment. Future agents must not change the Space visibility to public unless
-the user explicitly asks for that action.
+The public Hugging Face Space is now under
+`build-small-hackathon/Snap2Sim`, served at
+`https://build-small-hackathon-snap2sim.hf.space`. Keep GitHub as the source of
+truth and do not edit files directly on the Space.
 
 The Space endpoints are same-origin browser APIs, not public credentials. Keep
 the server-side rate limits, upload-size caps, and image decompression-bomb
-guards in `app.py` active before any public launch. These controls reduce abuse
-of the Space as a trusted Modal proxy but do not replace the Modal bearer token.
+guards in `app.py` active. These controls reduce abuse of the Space as a
+trusted Modal proxy but do not replace the Modal bearer token.
 
 ## Environment Variables
 
@@ -107,5 +105,4 @@ Do not configure jobs that pull changes back from Hugging Face into GitHub.
 
 For this hackathon repo, report suspected leaks directly to the repository owner
 or workspace owner. If a token was exposed, rotate it immediately in the
-provider dashboard and remove the leaked value from git history before making
-the repository public.
+provider dashboard and remove the leaked value from git history.

docs/README.md

@@ -3,6 +3,13 @@
 This folder keeps implementation notes, review passes, and fixtures out of the
 repository root while preserving the context that led to the current demo.
 
+Archived root-level prompts now live in `../prompts/`.
+
+Final submission status, June 15, 2026: Snap2Sim is public under
+`build-small-hackathon/Snap2Sim`, the app host is
+`https://build-small-hackathon-snap2sim.hf.space`, and the README links the
+demo video plus X post.
+
 ## Features
 
 - `features/confidence-threshold.md` - confidence threshold control and

docs/features/annotated-photo-fallback.md

@@ -274,7 +274,7 @@ top-left (`index.html:1040-1047`). No change needed there.
    when present (#3). Items #4/#5 optional.
 4. Run the standard local checks per `AGENTS.md` (schema/parser + FastAPI
    `TestClient` for `/`, `/analyze_image`, `/generate_scene`), then the normal
-   PR → GitHub Actions HF sync → authenticated private-Space verification.
+   PR -> GitHub Actions HF sync -> Space verification.
 
 ## Resolved scope
 
@@ -282,3 +282,5 @@ top-left (`index.html:1040-1047`). No change needed there.
   (user decision, 2026-06-14): the CSS sizing fix, marker dots at the true
   point, offset/leader labels, and rendering `annotation.box` when the model
   provides it.
+- Final submission note, 2026-06-15: this work shipped before the public
+  `build-small-hackathon/Snap2Sim` submission.

docs/features/confidence-threshold.md

@@ -1,6 +1,7 @@
 # Confidence Threshold: Apply Only at Analysis and Generation
 
-Status: **Implemented and synced to the private Space, June 14, 2026.**
+Status: **Implemented and synced. Final public submission is under
+`build-small-hackathon/Snap2Sim` as of June 15, 2026.**
 Supersedes the prior implemented version of this file (commit `a0540e9`,
 "Add confidence threshold control").
 Author of spec: codebase review pass, June 14, 2026.
@@ -219,10 +220,10 @@ accessible (don't regress the existing `aria-live` label).
   FastAPI `TestClient`, next-run-only browser behavior, high-threshold
   downgrade, low-threshold promotion, keyboard slider operation, mobile
   no-overflow layout, and canvas pointer targeting.
-- GitHub Actions sync run `27515950105` deployed commit `a6f63e9` to the private
+- GitHub Actions sync run `27515950105` deployed commit `a6f63e9` to the then-private
   Hugging Face Space. The Space reported SHA
-  `a6f63e9a0b76315bb223a09a71f4c027a29877fb` and remained private.
-- Authenticated private-Space verification passed: the root served the updated
+  `a6f63e9a0b76315bb223a09a71f4c027a29877fb`.
+- Authenticated Space verification passed: the root served the updated
   shell, a synthetic image returned `optical sight` at `0.7` confidence with 3
   parts, high threshold returned `photo` / `annotate`, low threshold returned
   `three` / `three`, and no HTML field was present.

docs/features/renderer-vocabulary.md

@@ -301,11 +301,13 @@ confidence + annotate when unsure (already the policy — keep it).
    (`docs/reviews/interaction-and-fallback-review.md` Q3 tuning note): the richer prompt
    may change token usage; confirm `run_analysis_endpoint_check` still returns
    valid JSON within the current `4096`/`8192`/`300s` budgets before deploy.
-7. Standard PR → GitHub Actions HF sync → authenticated private-Space
-   verification. Keep the Space **private** unless the user explicitly approves
-   going public (`AGENTS.md`, `SECURITY.md`).
+7. Standard PR -> GitHub Actions HF sync -> Space verification. The final
+   public submission is under `build-small-hackathon/Snap2Sim`.
 
-## Open items to confirm with the user (only if they come up during build)
+## Archived considerations
+
+Final submission note, 2026-06-15: the renderer vocabulary pass shipped before
+the public `build-small-hackathon/Snap2Sim` submission.
 
 - Whether `cylinder` should revert to a true (untapered) cylinder once explicit
   `cone` exists (recommended yes — see §2 note).

docs/features/vision-prompt-roles.md

@@ -103,7 +103,7 @@ a budget change.
 
 ---
 
-## Next steps (for Codex to implement)
+## Implementation plan (completed)
 
 1. **`snap2sim/prompts.py`**
    - Repurpose `VISION_SYSTEM_PROMPT` to hold the full invariant contract
@@ -146,8 +146,11 @@ a budget change.
      not silently ignored) before trusting the split.
 
 5. **Then deploy** following the normal path (Modal deploy of
-   `analyze_image_llamacpp`, GitHub `main` push, GitHub->HF sync, authenticated
-   private-Space verification), per the existing workflow in `AGENTS.md`.
+   `analyze_image_llamacpp`, GitHub `main` push, GitHub->HF sync, and Space
+   verification), per the existing workflow in `AGENTS.md`.
+
+Final submission note, 2026-06-15: this prompt-role split shipped before the
+public `build-small-hackathon/Snap2Sim` submission.
 
 ---
 

docs/reviews/interaction-and-fallback-review.md

@@ -316,7 +316,7 @@ Cause in `index.html`:
 8. Local verification with FastAPI `TestClient` (per `AGENTS.md`), then the
    standard PR → GitHub Actions HF sync → authenticated Space verification.
 
-## Open items to confirm with the user
+## Archived considerations
 
 - Local-demo behavior (real Modal model vs. clearly-labeled placeholder).
 - Whether the annotated-photo fallback should also offer a manual toggle to the

docs/reviews/motion-axis-bias.md

@@ -83,7 +83,7 @@ default and generic fallback also resolve to Y. Address the prompt *and* make
 motion axis follow the geometry's inferred primitive axis when the model is
 silent or low-signal.
 
-## Next steps (for Codex to implement)
+## Implementation plan (completed)
 
 1. **De-anchor the prompt** (`snap2sim/prompts.py`):
    - In the motions section, show axis examples across all three world axes,
@@ -137,13 +137,15 @@ Completed locally on 2026-06-15:
 - Stable Modal deployment completed after the prompt/renderer update, and an
   unauthenticated deployed `runtime_probe` request returned `401 Unauthorized`.
 - GitHub-to-Hugging Face sync run `27544185461` deployed commit `e7369eb` to the
-  private Space after shortening the README `short_description` metadata to meet
+  then-private Space after shortening the README `short_description` metadata to meet
   Hugging Face's 60-character limit.
-- Authenticated private Space verification passed: the root served the trusted
+- Authenticated Space verification passed: the root served the trusted
   shell, a synthetic target image returned `rotating shaft assembly` at `0.65`
   confidence with an emitted `[1.0, 0.0, 0.0]` motion axis, `/generate_scene`
   returned `renderer: three` and `render_mode: three`, and no HTML field was
   present.
+- Final submission note, 2026-06-15: this pass shipped before the public
+  `build-small-hackathon/Snap2Sim` submission.
 
 ## Files referenced
 

docs/reviews/security-hardening.md

@@ -2,6 +2,9 @@
 
 Review date: 2026-06-14. Reviewer: Claude (Opus 4.8), for OpenAI Codex to implement.
 
+Final submission note, 2026-06-15: this review was implemented before the Space
+became public under `build-small-hackathon/Snap2Sim`.
+
 This review answers three questions:
 
 1. Are the endpoints secure?
@@ -10,8 +13,8 @@ This review answers three questions:
 
 Two product decisions were confirmed with the owner and shape the priorities below:
 
-- **The Space is going public soon.** Findings that are only mitigated by the
-  Space being private are therefore treated as blockers, not nice-to-haves.
+- **The Space is public now.** Findings that were only mitigated by private
+  visibility were treated as blockers and were resolved before publication.
 - **Screen-only viewing; no VR/AR goal.** WebXR is not required, which removes
   A-Frame's main structural advantage.
 
@@ -35,9 +38,9 @@ The Modal layer is in good shape. The Space layer is the exposure.
 
 ### HIGH — The Space's own `/analyze_image` and `/generate_scene` are unauthenticated (`app.py:64`, `app.py:74`)
 
-These endpoints have no auth of their own. Today they are gated only by the
-Space being private. **Once the Space is public, anyone on the internet can POST
-to them.**
+These endpoints have no auth of their own. At review time, they were gated only
+by the Space being private. **Because the Space is now public, anyone on the
+internet can POST to them unless the implemented abuse controls remain active.**
 
 - With `INFERENCE_BACKEND=local` (current default), they return placeholder data
   — low impact but a free compute/bandwidth sink (base64 decode + PIL decode +
@@ -50,7 +53,7 @@ to them.**
   in `SECURITY.md` that the token is "the real protection against
   credit-spending spam."
 
-**Recommendation (before going public):**
+**Recommendation (implemented before publication):**
 
 - Add abuse controls at the Space layer that do not require leaking a secret to
   the browser. Options, roughly in order of preference:
@@ -271,7 +274,7 @@ no dual A-Frame/Three.js maintenance.
 
 ## Suggested Implementation Order (for Codex)
 
-Blockers before the Space goes public:
+Blockers resolved before the Space went public:
 
 1. Add server-side rate limiting / quota + max upload size to `app.py`
    endpoints (§1 HIGH).

PRESENTATION_PROMPT.md → prompts/PRESENTATION_PROMPT.md

@@ -1,5 +1,12 @@
 # PRESENTATION_PROMPT.md
 
+Final status, 2026-06-15: the deck has been built at `presentation/deck.html`,
+the project is public under `build-small-hackathon/Snap2Sim`, and the final
+public links are:
+
+- Demo video: https://youtu.be/nuisDKMyyF8
+- X post: https://x.com/Ryno67114241/status/2066660199558152411
+
 > Build instructions for Codex. Goal: produce a **self-contained HTML slide deck**
 > that markets Snap2Sim — "Inside the Machine" to **Build Small Hackathon judges**.
 > Tone: interesting, intuitive, fun, concise, beautifully formatted. This file is
@@ -120,7 +127,7 @@ Two columns.
 - GPU: Modal, weights cached in a Modal Volume, bearer-token protected.
 - Contract: JSON schema validation before anything renders.
 
-**Badges we're claiming** (render as themed chips — confirmed ones in amber, pending in muted):
+**Badges we're claiming** (render as themed chips; confirmed ones in amber):
 | Badge | Status |
 |---|---|
 | Backyard AI (track) | core fit |
@@ -129,7 +136,7 @@ Two columns.
 | Modal Award | confirmed |
 | Off-Brand | confirmed |
 | OpenAI Codex | confirmed |
-| Best Demo / Sharing is Caring | pending demo video + social post |
+| Best Demo / Sharing is Caring | confirmed with public demo video + X post |
 | Off the Grid | not claimed (inference runs on Modal) |
 
 ### Slide 7 — Closing / Call to Action
@@ -145,7 +152,7 @@ Two columns.
 Use these as the factual backbone. Do **not** invent metrics or claims beyond these.
 
 - **Product**: Snap2Sim / "Inside the Machine" — photo of a hardware component → identified mechanism → animated 3D technical cutaway with named internal parts, trigger, and motion sequence. (`README.md`, `AGENTS.md`)
-- **The hook** (keep verbatim, per AGENTS.md "Next Work" — do not alter): *"You find a small metal cylinder at a flea market. What is it? How does it work inside?"*
+- **The hook** (keep verbatim, per AGENTS.md final-state notes — do not alter): *"You find a small metal cylinder at a flea market. What is it? How does it work inside?"*
 - **Audience**: garage tinkerers, repair hobbyists, thrift-store scavengers, robotics students — "people who learn by taking things apart." (`README.md` Hackathon Fit)
 - **Pipeline** (`README.md` How It Works): browser → same-origin `/analyze_image` on the HF Space → secured Modal endpoint → Nemotron via llama.cpp/`llama-mtmd-cli` → structured mechanism JSON → `/generate_scene` validates + picks render mode → browser renders deterministic Three.js, or annotated-photo fallback.
 - **Key safety/architecture decision**: "The model describes the mechanism. The browser owns the rendering." No model-authored HTML/JS injection. Schema validation in `snap2sim/schema.py` gates rendering. (`README.md`, `AGENTS.md`)
@@ -154,7 +161,7 @@ Use these as the factual backbone. Do **not** invent metrics or claims beyond th
 - **Model**: `unsloth/NVIDIA-Nemotron-3-Nano-Omni-30B-A3B-Reasoning-GGUF`, quant `UD-Q4_K_M` + `mmproj-F16.gguf`. ~30B total / ~3B active per MoE token → under the hackathon's 32B budget. (`README.md` Tech Stack)
 - **Infra**: HF Space on `cpu-basic`; GPU inference on Modal with Modal Volume asset caching; bearer-token auth between Space and Modal (secret `snap2sim-api-auth` / `SNAP2SIM_API_TOKEN`); unauthenticated requests return `401`. Space is public for submission. (`AGENTS.md`, `SECURITY.md`)
 - **Security posture** (`docs/reviews/security-hardening.md`): rate limiting on both endpoints, upload-size caps, PIL decompression-bomb handling, temp-file cleanup, no model-authored scene HTML.
-- **Badges** confirmed per AGENTS.md: Llama Champion, NVIDIA Nemotron Quest, Modal Award, Off-Brand, OpenAI Codex. Off the Grid is explicitly **not** claimed (Modal inference). Best Demo / Sharing is Caring pending public demo video + social post.
+- **Badges** confirmed per AGENTS.md: Llama Champion, NVIDIA Nemotron Quest, Modal Award, Off-Brand, OpenAI Codex, Best Demo, and Sharing is Caring. Off the Grid is explicitly **not** claimed (Modal inference).
 - **Visual identity tokens**: see Section 1 (sourced from `index.html`).
 - **Credit**: Built by Jason Do with implementation assistance from OpenAI Codex. Commit trailer convention: `Co-authored-by: OpenAI Codex <codex@openai.com>`.
 
@@ -165,7 +172,10 @@ Use these as the factual backbone. Do **not** invent metrics or claims beyond th
 
 ---
 
-## 4. Next steps for Codex (in build order)
+## 4. Completed build order
+
+The requested deck was built and synced with the public Space. The original
+build order is retained below for traceability.
 
 1. Scaffold `presentation/deck.html` with reveal.js CDN, the theme tokens from Section 1, Chakra Petch + Fira Code fonts, grid/scan-line/vignette texture, and the per-slide kicker + watermark chrome.
 2. Build slides 1–3 exactly as specified (Problem → Solution → inline-SVG architecture diagram). These are the required core.
@@ -173,9 +183,13 @@ Use these as the factual backbone. Do **not** invent metrics or claims beyond th
 4. Add slides 4–7.
 5. Keep the in-theme demo mockup on slide 4 unless real product screenshots are intentionally captured and added later.
 6. Verify: open in a browser, arrow through all slides, confirm the diagram renders inline with no broken images, confirm `?print-pdf` exports cleanly, confirm no horizontal overflow at 1280×720 and 1920×1080.
-7. Keep all private endpoint URLs and tokens **out** of the deck — only the public GitHub + HF Space links from Section 3.
-8. Do not claim Off the Grid. Do not mark Best Demo / Sharing is Caring as confirmed.
+7. Keep all private endpoint URLs and tokens **out** of the deck; only public
+   GitHub, Hugging Face Space, demo video, and social links belong in public
+   presentation materials.
+8. Do not claim Off the Grid while inference runs on Modal. Best Demo and
+   Sharing is Caring now have public demo and X post links.
 
-### Open items / placeholders to flag in the deck
-- Public demo video + social post link (needed before Best Demo / Sharing is Caring can be claimed).
+### Final public links
 - Space is public under `build-small-hackathon/Snap2Sim`.
+- Demo video: https://youtu.be/nuisDKMyyF8
+- X post: https://x.com/Ryno67114241/status/2066660199558152411

PROMPT.md → prompts/PROMPT.md

@@ -3,6 +3,21 @@
 
 ---
 
+## Final Status (June 15, 2026)
+
+This file is the original build prompt and contains historical implementation
+directions, including early A-Frame and private-Space assumptions that were
+superseded during development. The finished public submission uses deterministic
+browser-side Three.js from validated JSON, is hosted under
+`build-small-hackathon/Snap2Sim`, and is linked from the README.
+
+- Public Space: https://huggingface.co/spaces/build-small-hackathon/Snap2Sim
+- App host: https://build-small-hackathon-snap2sim.hf.space
+- Demo video: https://youtu.be/nuisDKMyyF8
+- X post: https://x.com/Ryno67114241/status/2066660199558152411
+
+---
+
 ## Goal
 
 Build a Gradio app deployed as a Hugging Face Space that takes a photo of a hardware component (gear, valve, pump, lock, engine part, etc.) and produces an animated 3D visualization showing how that component works internally — "open it up and show me the moving parts and the mechanism."
@@ -26,9 +41,9 @@ Someone who pulls apart old electronics, finds a mystery component at a thrift s
 
 ---
 
-## Current State (June 13, 2026)
+## Archived Current State (June 13, 2026)
 
-Scaffold exists at [github.com/Bigstonks1/Snap2Sim](https://github.com/Bigstonks1/Snap2Sim), synced to HF Space `jasondo111/Snap2Sim` (private, keep private until user approves).
+Scaffold existed at [github.com/Bigstonks1/Snap2Sim](https://github.com/Bigstonks1/Snap2Sim), initially synced to HF Space `jasondo111/Snap2Sim`. The finished project was later transferred to the public Build Small Hackathon Space listed above.
 
 **Confirmed working:**
 - Modal deployment: `snap2sim-inside-the-machine` (bigstonks1 workspace)
@@ -37,12 +52,15 @@ Scaffold exists at [github.com/Bigstonks1/Snap2Sim](https://github.com/Bigstonks
 - GitHub → HF Space sync workflow live and passing
 - Local app code now uses `gradio.Server` plus a trusted `index.html`
 
-**Primary remaining tasks:**
+**Archived primary tasks (completed):**
 1. Deploy the current branch through GitHub → HF sync
-2. Confirm the private Space loads the trusted `index.html`
+2. Confirm the deployed Space loads the trusted `index.html`
 3. Confirm `/analyze_image` and `/generate_scene` respond through the secured
    Modal bearer-token flow
 
+Final result: deployed through GitHub-to-Hugging Face sync, verified on the
+public org-owned Space, and completed with public demo video and X post links.
+
 ---
 
 ## Model Stack
@@ -321,13 +339,13 @@ Implement in this sub-order:
 
 ---
 
-## Start Order
+## Original Start Order (completed)
 
 > Follow this exactly. Do not skip ahead.
 
 ### Step 1 — Critical Path
 Deploy the current `gradio.Server` + `index.html` implementation through
-GitHub → HF sync. Confirm the private Space loads and both `/analyze_image`
+GitHub -> HF sync. Confirm the deployed Space loads and both `/analyze_image`
 and `/generate_scene` respond.
 
 ### Step 2 — Make It Functional
@@ -337,7 +355,7 @@ Build `buildDeterministicScene(json)` in JS — Three.js scene from geometric pr
 Add CSS variable system, Chakra Petch + Fira Code from Bunny Fonts, two-pane asymmetric layout, blueprint grid, loading states with progress bar, upload drop zone, panel separator. App should match the design direction above — minus `[POLISH]` items.
 
 ### Step 4 — Harden
-Error handling, 3-second blank-scene timeout before fallback triggers, Modal cold-start messaging, A-Frame `<a-sky color="#0F1318">` matching page background, play/pause toggle wired to A-Frame animation playback. Verify GitHub → HF Space sync pushes cleanly and the private Space runs correctly.
+Error handling, 3-second blank-scene timeout before fallback triggers, Modal cold-start messaging, A-Frame `<a-sky color="#0F1318">` matching page background, play/pause toggle wired to A-Frame animation playback. Verify GitHub -> HF Space sync pushes cleanly and the deployed Space runs correctly.
 
 ### Step 5 — [POLISH] Only if Time Remains
 Component name watermark → noise texture → vignette → scan-line reveal. In that order.

prompts/README.md

@@ -0,0 +1,8 @@
+# Prompt Archive
+
+This folder contains the project prompt and Codex task specs that were used
+during the Snap2Sim build.
+
+- `PROMPT.md` - original product, model, design, and delivery requirements.
+- `GITHUB_PROMPT.md` - GitHub Actions to Hugging Face Space sync prompt.
+- `PRESENTATION_PROMPT.md` - hackathon presentation deck build prompt.