Document the .thf YAML schema formally in a docs/file-format.md file. Include:

• Complete schema definition with all fields
• Example file with annotations
• Version compatibility notes

This helps third-party tool authors and community members understand the format.