Implements a mergeable first milestone for issue #12 with schema + API contracts + implementation plan.\n\n@algora-pbc /claim #12

Demo video

• https://github.com/aimqwest/gyroflow/releases/download/aimqwest-pr-demos-20260512/pr42-demo-v6.mp4