feat(ingest): adopt llm-ingestion-okf as Door A implementation (first consumer)

Replace the local 391-line ingest implementation with a thin adapter over
the shared llm-ingestion-okf library (git-pinned dae0bd1a via Forgejo,
tool.uv.sources). The materialize() signature is preserved; error types are
now the library's typed hierarchy rooted in IngestError, re-exported from
the consumer seam.

- tests/test_ingest_adoption.py: new load-bearing seam tests (delegation,
  offline invariant — allow_network is never passed, error contract),
  detach-proven red twice.
- Golden suites (file + sql) pass UNCHANGED — byte-exact behaviour proven
  against the repo-local fixtures.
- 6 test files migrated to the library error hierarchy; escaping/typed-cell
  unit tests dropped (byte-bound by the ingest-edge.md golden, unit-owned by
  the library's own 189-test suite). Provenance stamp now asserted
  independently from the §5 rule.
- mypy override follow_untyped_imports for llm_ingestion_okf (no py.typed
  upstream yet — reported as a finding).

Suite: 386 passed; ruff + format + mypy --strict clean; shared/, examples/,
runs/s10/ and run_s10.py byte-untouched.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-07-16 20:46:51 +02:00
commit 5732d13369
9 changed files with 307 additions and 495 deletions

View file

@ -6,9 +6,17 @@ readme = "README.md"
requires-python = ">=3.10"
dependencies = [
"claude-agent-sdk>=0.2.111,<0.3",
"llm-ingestion-okf",
"pydantic>=2",
]
# Distribution channel (2026-07-16 decision, mirrors the library's B2 answer):
# git pin against the public Forgejo repo — reproducible for every consumer of
# this public repo, uv.lock pins the exact commit. Bump the rev to the release
# tag once the library tags one.
[tool.uv.sources]
llm-ingestion-okf = { git = "https://git.fromaitochitta.com/open/llm-ingestion-okf.git", rev = "dae0bd1a2898b69f436a877538d67afd71e48ad8" }
[dependency-groups]
dev = [
"pytest>=8",
@ -30,5 +38,11 @@ target-version = "py310"
[tool.mypy]
strict = true
# llm-ingestion-okf ships full inline type hints but (as of 0.1.0 @ dae0bd1a)
# no py.typed marker; follow its inline types instead of degrading to Any.
[[tool.mypy.overrides]]
module = "llm_ingestion_okf.*"
follow_untyped_imports = true
[tool.pytest.ini_options]
testpaths = ["tests"]