| Path | Purpose |
|---|---|
README.md |
Run instructions, diagrams, quickstart |
LICENSE |
MIT license |
requirements.txt |
Runtime dependencies |
.env.example |
Environment variable template |
agent_spec.md |
Step-by-step Coding Agent specification |
docs/supported_models.md |
Provider support table + official sources |
docs/validation_checklist.md |
Validation and smoke-test checklist |
pdl/schema/pdl_v5_1.schema.yaml |
Machine-readable PDL schema (JSON Schema in YAML) |
specs/app.yaml |
Realistic example using Ollama |
specs/app.mock.yaml |
Offline mock spec for smoke tests |
pdl/__init__.py |
Package version |
pdl/__main__.py |
python -m pdl entrypoint |
pdl/cli.py |
Typer CLI: run/serve/validate/models |
pdl/server.py |
FastAPI app: run lifecycle, logs, WebSocket, preview |
pdl/core/ |
Loader, schema validator, engine, model adapters, run manager |
pdl/logging/ |
LogStore with subscribe/stream plumbing |
pdl/web/templates/preview.html |
HTML design preview + run UI |
pdl/web/static/ |
JS/CSS for preview page |
scripts/validate_spec.py |
Validates YAML against schema |
scripts/smoke_test.py |
CLI smoke test with mock model |
scripts/smoke_server.py |
Server smoke test: health, run lifecycle, logs |
scripts/make_zip.py |
Build distributable ZIP |
tests/test_engine_basic.py |
Minimal unittest coverage |