generated from coulomb/repo-seed
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>
1.7 KiB
1.7 KiB
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.mdand/contracts/core/exist and describe the current Core surface- pytest passes with coverage of Core and factory
- ruff + mypy clean
- CI green on push