# Paddock Proposition Matching v2 — Implementation Package

This package contains a self-contained technical specification and machine-readable examples for a redesign of the drill matcher.

## Files

- `01-technical-spec.md` — normative implementation specification
- `interfaces/types.ts` — TypeScript interfaces
- `schemas/concept-library.schema.json` — concept library JSON Schema
- `schemas/drill-authoring.schema.json` — drill authoring JSON Schema
- `schemas/compiled-drill.schema.json` — compiled drill JSON Schema
- `schemas/analysis-request.schema.json` — request payload JSON Schema
- `schemas/analysis-response.schema.json` — response payload JSON Schema
- `examples/concept-library.claim-preclusion.json` — concept library example
- `examples/drill-authoring.claim-preclusion.json` — authored drill example
- `examples/compiled-drill.claim-preclusion.json` — compiled runtime example
- `examples/analyze-request.json` — sample analyze request
- `examples/analyze-response.json` — sample analyze response
- `examples/benchmark.claim-preclusion.json` — sample benchmark bundle
- `examples/llm-adjudication-request.json` — sample LLM adjudication prompt payload
- `examples/llm-adjudication-response.json` — sample LLM adjudication output
- `openapi/drill-analysis.openapi.yaml` — API contract

## Recommended implementation order

1. Commit the TypeScript interfaces and JSON Schemas.
2. Implement the compiler and validation gate.
3. Implement server-side segmentation, retrieval, slot scoring, and hysteresis.
4. Add the local client hint engine.
5. Add structured LLM adjudication for unresolved propositions.
6. Add benchmark execution and publication gating.
7. Migrate drills doctrine by doctrine.

## Normative source

Use `01-technical-spec.md` as the source of truth.