Skip to content

Knowledge Sources

This document records the knowledge sources used in the bootstrap discovery pass (2026-08-05). Steady-state refresh runs re-verify each source against its recorded concept.

Source Map

Source path / URL Class(es) yielded Concepts created How to re-check
src/oscal/schema/oscal.yaml Dataset datasets/oscal-schema Re-read file header for id, version, description; confirm imports list is reflected in hasPart.
src/oscal/schema/oscal_catalog.yaml Dataset datasets/oscal-catalog-schema Re-read id, version, source, description, see_also; confirm isPartOf → oscal-schema.
src/oscal/schema/oscal_profile.yaml Dataset datasets/oscal-profile-schema Re-read id, version, source, description, see_also; confirm isPartOf.
src/oscal/schema/oscal_ssp.yaml Dataset datasets/oscal-ssp-schema Re-read id, version, source, description, see_also; confirm isPartOf.
src/oscal/schema/oscal_assessment_plan.yaml Dataset datasets/oscal-assessment-plan-schema Re-read id, version, source, description; confirm isPartOf.
src/oscal/schema/oscal_assessment_results.yaml Dataset datasets/oscal-assessment-results-schema Re-read id, version, source, description; confirm isPartOf.
src/oscal/schema/oscal_component.yaml Dataset datasets/oscal-component-schema Re-read id, version, source, description; confirm isPartOf.
src/oscal/schema/oscal_mapping.yaml Dataset datasets/oscal-mapping-schema Re-read id, version, description; confirm isPartOf.
src/oscal/schema/oscal_poam.yaml Dataset datasets/oscal-poam-schema Re-read id, version, source, description; confirm isPartOf.
https://pages.nist.gov/OSCAL/ Reference references/nist-oscal Verify NIST URL resolves; check latest OSCAL version number.
https://linkml.io/ Reference references/linkml Verify URL resolves; no version pinning needed (framework reference).
pyproject.toml (authors field) Organization org/lmodel Verify lmodel GitHub org URL; update name if org changes.
tests/data/cncf-ai-benchmarks/ + tests/data/invalid/cncf-ai-benchmarks/ Dataset datasets/cncf-ai-benchmarks Re-count fixture files (expect 31 in each dir); confirm the invalid copies still differ only by the injected last-modified fault; re-check upstream oscal-compass-lab/ai-benchmarks source URL resolves.
tests/data/luigi_carpio/component-definition.json Dataset datasets/luigi-carpio-component-definition Re-read metadata.oscal-version; re-count fedramp-high/cjis-delta props; confirm test-luigi-carpio recipe in project.justfile still targets this path.

Gaps noted

  • project/ (generated artifacts directory) contains ~20 format outputs (jsonschema, owl, shacl, rdf, typescript, golang, rust, protobuf, etc.). Each could become a Dataset concept with derivedFrom pointing to the schema. Not added in this pass - add when the generated formats themselves become objects of knowledge queries.
  • tmp/ (extended-generator showcase outputs: excel, graphql, jsonld, shacl, shex, sqlschema, etc.) and examples/ (whose output/ subfolder is git-ignored, regenerated by just test) are generated from the schema and test data - same rationale as project/, consciously left out.
  • docs/ is the MkDocs documentation site (site_url: https://lmodel.github.io/oscal), largely generated from the schema via templates. No concept warranted while its content mirrors the schema datasets already captured; revisit if hand-authored operational docs appear there.
  • tests/ (test suite code, tests/data/valid/, tests/data/invalid/*.yaml, tests/data/problem/) and scripts/ contain tooling/unit-fixture code; no concept warranted for those. The real-world data fixtures under tests/data/ (cncf-ai-benchmarks, luigi_carpio) are captured above since they carry external provenance rather than being synthetic unit fixtures.
  • No CODEOWNERS file present; ownership derived from pyproject.toml authors.