CAPSTONE SUPPORT

The starter repository.

One supported project, deliberately small, containing exactly the pieces the capstone needs and nothing decorative.

What it contains

• App bootstrap — a single entry point that starts an HTTP server and nothing else.
• Environment example — every variable the project reads, documented, with no real secret committed.
• Validation layer — one schema module used by both the webhook and the model response, so the two cannot drift.
• Webhook endpoint — signature check, size cap, schema validation and an idempotency key.
• Model adapter — one interface in front of the provider, so the provider can change without touching the rest.
• One controlled tool — a single action with an explicit permission boundary.
• Tests — the four failure cases below, not only the happy path.
• README — setup on a clean machine in under ten minutes.

The four tests that matter

1. The same event delivered twice produces one stored record and one action.
2. An invalid payload is rejected with a clear error and stores nothing.
3. A non-conforming model response is retried once, then fails without a partial write.
4. A tool failure leaves the record stored and flagged, never silently dropped.

Availability

The repository is being prepared alongside the lessons. This page is the specification it is built against — if you want to start now, build to this structure and the capstone will fit it.