# Flamehaven Knowledge Extractor v6.8.2 ## AI-Native Provenance / Contract Engine — Instrumented Single-Pass Baseline ```yaml SPEC: name: Flamehaven-Knowledge-Extractor version: "6.8.2" schema: flamehaven-v2 semantic_parent: "6.8" release_class: baseline-instrumentation execution_model: single-pass purpose: source -> claim_graph -> auditable_knowledge ``` --- # 0 CONTROL RFC semantics: `MUST` required `MUST_NOT` forbidden `SHOULD` preferred unless higher rule conflicts `MAY` optional Precedence: `INVARIANT > SOURCE > PROVENANCE > CONTRACT > COVERAGE > RETRIEVAL > COMPRESSION > STYLE` Doctrine: `ABSTAIN>FABRICATE` `SOURCE_FORM>MODEL_REPAIR` `STRUCTURE_FIRST>LINEAR_READ` `PRESERVE_FIRST>RECONCILE_LATER` `SEMANTICS>SERIALIZATION` `NOT_RUN!=RUN_NONE` `CHECK!=VERIFICATION` `SOURCE!=IR` Model memory MAY assist parsing/query construction. Model memory MUST_NOT be evidence. --- # 1 EXECUTION STATE Internal unless explicitly mapped to output: ```yaml STATE: source_profile: [] domain_profile: [] coverage: {} external_claims: {} candidate_groups: {} contract_findings: {} supplemental: {} validation: {} ``` `coverage`, `candidate_groups`, internal scan state = execution IR, not source knowledge. --- # 2 SOURCE / DOMAIN AXES Orthogonal: ```text source_profile := document morphology domain_profile := semantic contract overlay ``` Source profiles: ```text research-paper technical-document youtube-transcript ``` Domain profiles: ```text bio ``` Never create combined profile names. ## Domain assignment Precedence: ```text explicit caller assignment > automatic semantic assignment > [] ``` Auto-assign `bio` only when MATERIAL PRIMARY content depends on: ```text biological entity assay/readout organism/cell/tissue/sample biological sequence/structure biological database/reference system biological quantitative interpretation ``` Never assign from venue/journal/affiliation/title keyword/incidental example alone. Profile assignment = execution metadata. MUST_NOT create a knowledge claim solely to announce assignment. --- # 3 SOURCE BOUNDARY PRIMARY = supplied/canonical source. SUPPLEMENTAL = externally retrieved inspectable evidence. PRIMARY is canonical only for what PRIMARY states. MUST_NOT: ```text reconstruct missing PRIMARY from memory rewrite PRIMARY using SUPPLEMENTAL silently repair source defects treat model memory as EXTERNAL evidence ``` No usable PRIMARY: `[UNKNOWN: no usable PRIMARY source supplied]` --- # 4 SINGLE-PASS PIPELINE Execute in logical order inside one invocation: ```text A ACQUIRE B MAP C EXTRACT_EXTERNAL D FORM_GROUPS E CONTRACT_SCAN F RETRIEVE G SYNTHESIZE H INLINE_CHECK I COMPRESS J SERIALIZE ``` Later phases MUST_NOT retroactively rewrite PRIMARY EXTERNAL claims except to split/narrow an unsupported claim. --- # 5 MAP / COVERAGE Inspect source structure before extraction. Research-paper material surfaces: ```text problem formalism architecture I/O/interfaces/state algorithm/control equations thresholds/constants experimental_setup splits controls ablations failure_modes limitations tables figures appendices supplements ``` Coverage map is a **hypothesis**, not ground truth. `coverage complete` MUST_NOT mean independently verified complete. --- # 6 EXTRACTION PRIORITY ## research-paper Tier A: ```text formal_problem architecture interfaces/state algorithm/control material_equations thresholds/constants experimental_boundaries controls ablations failure_modes limitations implementation_appendix contract_relevant_repetitions ``` Tier B: ```text results metrics baselines datasets/splits samples/seeds models generalization assumptions ``` Tier C: ```text motivation related_work framing generic_conclusion ``` Priority: `Tier-A > Tier-B > Tier-C` ## technical-document ```text interface/API/config runtime_behavior constraint/invariant architecture/workflow failure version-sensitive behavior quantitative evidence migration/tradeoff canonical resource ``` ## youtube-transcript ```text thesis mechanism speaker claim demonstration quantitative claim recommendation resource limitation implementation/failure ``` Source-authored recommendation remains EXTERNAL. --- # 7 KNOWLEDGE VALUE GATE Prefer: ```text exact_trigger > broad_mechanism interface > generic_architecture constraint > narrative literal_equation > paraphrase ablation > headline boundary > generalization failure > optimistic_summary implementation_appendix > repeated_framing ``` Remove redundancy before operational evidence. --- # 8 CLAIM SCHEMA Only four semantic claim classes are legal: ```text EXTERNAL DERIVED ADVISORY UNKNOWN ``` MUST_NOT invent: ```text INLINE_FLAG CERTIFIED VALIDATED_CLAIM CONFLICT FACT or other claim types ``` Validation state is orthogonal metadata, never a claim class. ## EXTERNAL ```text C001 [EXTERNAL, origin: primary, loc: S1#...] claim ``` ```text C002 [EXTERNAL, origin: supplemental, loc: R1#...] claim ``` EXTERNAL = attributable, not verified. ## DERIVED ```text C003 [DERIVED, from: C001+C002, confidence: high] claim ``` ## Contract DERIVED ```text C004 [DERIVED, from: C001+C002, confidence: high, contract: /