open/llm-ingestion-okf
1
0
Fork 0
Code Issues Releases 4 Activity

feat(okf-v0.2): D4 — door C surfaces the §10 pointers it imports [skip-docs]

Browse source 
V6, settled by the operator today: import and report, not refuse.

Door C imports the POINTER to executable code and never the code — it
writes concepts verbatim and skips every non-`.md` file. So an imported
Attested Computation can name an `executor`/`attester` resource that did
not arrive, or one that RESOLVES against a file the destination tree
already holds under that path. The second is the outcome worth
surfacing: it looks valid.

Refusing was the plan's leaning and is not what shipped. §14 forbids a
consumer to reject a bundle over a broken cross-link and does not settle
whether `executor.resource` is one; §10.5 asks a consumer to surface
rather than silently drop. Reporting honours the second without testing
the first, and leaves the door's one invariant — verbatim bytes — alone.

`ImportResult.unverified_references` is an advisory over the merged set,
not a fifth bucket: every concept it names has already merged, the
bytes are unchanged, and a refused concept is never named (there is no
imported pointer to check).

The report is at KEY level, and that is a measured limit rather than a
choice. Resolving the resource means reading `executor.resource` — the
value the line-oriented parser cannot recover in either canonical form:
a block mapping flattens and collides, a flow mapping stays one opaque
string. A resource-level report would be empty or wrong on exactly the
forms upstream writes. Precision arrives with the structured reader
(D1b); the key-level signal is robust in both forms today.

[skip-docs] is on the CLAUDE.md half only: README carries the new
public surface (`unverified_references`), and the invariant this work
put in CLAUDE.md — flow form, never block — landed with the previous
commit and needs no restatement.

584 tests, mypy --strict clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KKKMwi7e7PVHoFW6dJK5XP
This commit is contained in:
Kjell Tore Guttormsen 2026-07-31 21:44:27 +02:00
commit c6d64c3fd6
4 changed files with 188 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

2
src/llm_ingestion_okf/__init__.py
View file

@ -61,6 +61,7 @@ from .importer import (
ImportResult,
MergedConcept,
RefusedConcept,
UnverifiedReference,
import_bundle,
)
from .manifest import (
@ -102,6 +103,7 @@ __all__ = [
"RenderError",
"SourceError",
"SqlSource",
"UnverifiedReference",
"extract_text",
"import_bundle",
"load_manifest",