Kjell Tore Guttormsen
e03bd79876
Speiler MAF I2 fra shared/ingest-spec.md alene: manifest → CSV-konnektor → materialisert OKF-bundle, byte-identisk med den delte golden-fasiten. - ingest.py: ManifestContract (pydantic, fail-fast, file-kilde, verdict-reservasjon §3, id-grammatikk, max_rows), CSV-konnektor (boundary-checked fail-closed), materialisering (§5-frontmatter eksakt rekkefølge, markdown-tabell m/ escaping, LF-only, SHA-256 manifest-stamp), index-generering (§6), replacement §3/§5. - okf.py: _parse_index_entry — tolererer frontmatterløs index (method-spec §3: index rendres via body = summary, ikke som typet concept-fil). Golden var spec-konform; D7-okf var strengere enn standarden. Scoped: non-index concept- filer krever fortsatt type (honesty-test). - examples/ingest-golden-file/: repo-lokal golden (byte-frossen kopi av I2s fasit). - Speiltester (I2s load-bearing-sett, alle detach-bevist røde): golden byte-fasit + mutasjonskontroller · provenance/navigability/verdict-reservasjon/re-ingest-safety · kontrakt fail-fast/max_rows/boundary/kollisjon · spec-integritet §11. - docs/2026-07-04-I3-brief.md: brief + de to operatør-avgjorte beslutningene. Suite 239 passed uten nøkkel/nettverk (189 + 50 nye) · ruff + mypy --strict rene. [skip-docs] README + docs/extending.md er bevisst utsatt til I7 per sesjonsplan (programmet batcher ingest-doc der, avgrenset til det D7 faktisk har — CSV nå, SQL/HTTP senere). Endringen er dokumentert i docs/2026-07-04-I3-brief.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017MM6BWb1hWmJZuXFZ7rjxT
70 lines
2.1 KiB
Python
70 lines
2.1 KiB
Python
"""Spec-integrity seam for the ingest spec (ingest-spec §11).
|
|
|
|
The D7 analog of MAF's I1 framework-guard: this repo consumes ``shared/ingest-spec.md``
|
|
UNCHANGED from commons, and this test keeps the contract honest — it goes RED when the
|
|
spec goes missing, names a concrete agent toolkit (the framework-neutrality rule), or
|
|
stops documenting a contract field. It is the load-bearing guard the ingest layer relies
|
|
on to keep being implementable "from this spec alone".
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
|
|
import pytest
|
|
|
|
SPEC = Path(__file__).resolve().parents[1] / "shared" / "ingest-spec.md"
|
|
|
|
# Concrete agent toolkits / vendor stacks the framework-neutral spec MUST NOT name.
|
|
_FORBIDDEN_TOOLKITS = (
|
|
"claude",
|
|
"anthropic",
|
|
"openai",
|
|
"gpt",
|
|
"gemini",
|
|
"llama",
|
|
"langchain",
|
|
"autogen",
|
|
"crewai",
|
|
"semantic kernel",
|
|
"microsoft agent framework",
|
|
"agent sdk",
|
|
"bedrock",
|
|
"vertex",
|
|
"foundry",
|
|
"maf",
|
|
)
|
|
|
|
# Every field of the machine-readable contracts the D7 implementation depends on — the
|
|
# spec's §12 cross-check table must keep documenting each (spec-integrity).
|
|
_CONTRACT_FIELDS = (
|
|
"manifest_version",
|
|
"source",
|
|
"bundle_summary",
|
|
"extractions",
|
|
"source_system",
|
|
"source_query",
|
|
"ingested_at",
|
|
"ingest_manifest",
|
|
"generated",
|
|
"okf_type",
|
|
"max_rows",
|
|
"root",
|
|
)
|
|
|
|
|
|
def test_spec_is_present() -> None:
|
|
# RED if the spec goes missing (the layer stops being implementable from spec alone).
|
|
assert SPEC.is_file(), "ingest-spec.md missing — subtree pull the commons contract"
|
|
|
|
|
|
def test_spec_names_no_agent_toolkit() -> None:
|
|
text = SPEC.read_text(encoding="utf-8").lower()
|
|
present = [tok for tok in _FORBIDDEN_TOOLKITS if tok in text]
|
|
assert not present, f"framework-neutral spec names a concrete toolkit: {present}"
|
|
|
|
|
|
@pytest.mark.parametrize("field", _CONTRACT_FIELDS)
|
|
def test_spec_documents_contract_field(field: str) -> None:
|
|
text = SPEC.read_text(encoding="utf-8")
|
|
assert field in text, f"contract field {field!r} is no longer documented in the spec"
|