generated from coulomb/repo-seed
Bernd Worsch
d71f4114d1
WP-0001 — Foundation & GAAF Baseline - SCOPE.md, ARCHITECTURE-LAYERS.md, contracts/ tree - .claude/rules/ stubs filled (architecture, stack, boundary) - 57 tests (pytest), pyproject.toml with ruff+mypy, CI workflow WP-0002 — Core Extensions (FR-4 + FR-3) - FR-4: BudgetTracker (thread-safe) + LLMBudgetExceededError + optional RunConfig.budget_tracker + enforcement in all adapters - FR-3: async_execute_prompt on LLMAdapter ABC (asyncio.to_thread fallback) + native asyncio.create_subprocess_exec in ClaudeCodeAdapter 81 tests passing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# LLM-WP-0001 — Foundation & GAAF Baseline
|
|
|
|
**status:** active
|
|
**owner:** llm-connect
|
|
**repo:** llm-connect
|
|
**created:** 2026-04-01
|
|
|
|
## Purpose
|
|
|
|
Establish the structural foundation required before any Core modifications.
|
|
Covers repo orientation files, GAAF-2026 compliance artifacts, test suite, CI,
|
|
and state-hub housekeeping.
|
|
|
|
## Tasks
|
|
|
|
| ID | Title | Priority | Status |
|
|
|-----|-------|----------|--------|
|
|
| T01 | Create `SCOPE.md` | high | done |
|
|
| T02 | Fill `.claude/rules/` stubs: `architecture.md`, `stack-and-commands.md`, `repo-boundary.md` | high | done |
|
|
| T03 | Create `ARCHITECTURE-LAYERS.md` with layer map, scorecard stub, next-review date | high | done |
|
|
| T04 | Create `/contracts/` tree (`core/`, `functional/`, `config/`) | high | done |
|
|
| T05 | Core contract doc: `LLMAdapter` interface invariants, `RunConfig`/`LLMResponse` field contracts | high | done |
|
|
| T06 | Functional contract stubs for all 4 adapters + embedding adapters (maturity: Beta) | medium | done |
|
|
| T07 | Create `tests/` with `conftest.py`, wire pytest in `pyproject.toml` | high | done |
|
|
| T08 | Unit tests: `RunConfig`, `LLMResponse`, `MockLLMAdapter`, full exception hierarchy | high | done |
|
|
| T09 | Unit tests: `create_adapter` (all providers + unknown provider error), `create_embedding_adapter` | high | done |
|
|
| T10 | Add `ruff`, `mypy` to dev deps in `pyproject.toml` | medium | done |
|
|
| T11 | CI workflow: pytest + ruff + mypy | medium | done |
|
|
| T12 | State hub: register this host path, SBOM refresh | low | done |
|
|
|
|
## Exit criteria
|
|
|
|
- `ARCHITECTURE-LAYERS.md` and `/contracts/core/` exist and describe the current Core surface
|
|
- pytest passes with coverage of Core and factory
|
|
- ruff + mypy clean
|
|
- CI green on push
|