docs/README.md

# Project Notes

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
  server-side render-mode selection.
- `features/annotated-photo-fallback.md` - contained photo fallback with
  markers, leader lines, and annotation boxes.
- `features/renderer-vocabulary.md` - expanded deterministic primitive and
  motion vocabulary.
- `features/vision-prompt-roles.md` - split system/user prompt contract for
  llama.cpp analysis.

## Reviews

- `reviews/security-hardening.md` - Space and Modal security pass.
- `reviews/interaction-and-fallback-review.md` - camera controls, source-photo
  preview, and fallback strategy.
- `reviews/scene-geometry-review.md` - primitive orientation, sizing, camera
  fitting, and Y alignment.
- `reviews/motion-axis-bias.md` - prompt and renderer defaults for reducing
  Y-axis motion bias.

## Fixtures

- `fixtures/mini-fan-analysis.json` - representative model output used to verify
  deterministic scene geometry.