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

docs(plan): correct Door C guard call — v0.2 has no allow_reserved kwarg

Browse source 
Stage 0 guard-readiness check (this session) verified the real
`llm-ingestion-guard` v0.2.0 surface against ground truth: the Door C plan
assumed `okf.import_bundle(bundle, origin=…, channel=…, allow_reserved=False)`,
but the shipped signature is `import_bundle(bundle, *, origin, channel)` — no
`allow_reserved` parameter. Reserved-name rejection of `index.md`/`log.md` is
unconditional in the guard (OKFPathError, no toggle), so the intended default
semantics are unchanged; only the documented call was wrong and would have
raised TypeError if written verbatim. Correct the plan line before Phase 2
code is written against it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HBbjgS5A55RVavoyjJC4FX
This commit is contained in:
Kjell Tore Guttormsen 2026-07-24 20:10:57 +02:00
commit 99c899f4ed
1 changed files with 4 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/plan/phase-2-doors-b-c.md
View file

@ -52,8 +52,10 @@ No scanning, sanitizing, or quarantine logic is implemented here.
1. **Import flow** — explicit operator command:
`import_bundle(source_dir, bundle_dir, ingested_at, *, origin, channel) -> ImportResult`.
Reads the external bundle as `{relative path -> text}`, hands it to the
guard's `okf.import_bundle(bundle, origin=…, channel=…, allow_reserved=False)`,
and merges ONLY concepts whose per-concept result carries no error.
guard's `okf.import_bundle(bundle, origin=…, channel=…)` (the guard v0.2
signature — reserved-name rejection of `index.md`/`log.md` is unconditional,
there is no `allow_reserved` toggle), and merges ONLY concepts whose
per-concept result carries no error.
2. **Merge + index:** accepted concepts go through the Phase 1 staging/collision
gate and index primitives (idempotent linking, curated content preserved).
Rejected concepts are reported per concept with the guard's reason — never