RundownAPI v0.1 spec complete

Full documentation: spec structure, required/recommended/optional fields, security model, implementation guide. Includes Threadbaire Server as reference implementation.

Author: lliberopoulou

README.md

@@ -36,7 +36,7 @@ A RundownAPI endpoint returns JSON with these fields:
 
 | Field | What it is |
 |-------|-----------|
-| `rundown_version` | Version of the spec (currently `"0.1"`) |
+| `rundown_version` | Version of the spec (currently `"0.1"`). This refers to the spec version, not your API's version. If your API has its own versioning, add it as an optional field. |
 | `base_url` | Where the API lives |
 | `auth` | How to authenticate (method, parameter names, header format) |
 | `purpose` | What this API does, in plain language. One or two sentences. |
@@ -319,6 +319,10 @@ const base_url = `${protocol}://${host}`;
 
 **Test it with an AI.** Give Claude or ChatGPT the URL and ask it to integrate. Watch what works and what confuses it. Update your `ai_instructions` based on what you see.
 
+### Reference implementation
+
+Threadbaire Server includes a working `/api/rundown` endpoint: [github.com/threadbaire/server](https://github.com/threadbaire/server)
+
 ## License
 
 CC BY-SA 4.0 — Use it, adapt it, build on it. Keep it open and credit the source.