Knowledge sources map

Knowledge sources

Bootstrap discovery ran 2026-09-29. Steady-state refresh runs re-verify these sources instead of discovering them again. Update this map whenever a knowledge source is added to the repository, moved or removed.

Each concept derived from a file or folder of this repository names it by its path from the repository root, in resource and in sources. knowledge-report.sh worklist compares each such path’s last commit with the commit that recorded the concept’s stamp, and lists the concepts whose source moved. It never fetches a URL, so re-read the external sources this table names on every refresh.

Source	Yields	Re-check by
pyproject.toml, README.md, docs/about.md, .copier-answers.yml	bundle metadata, references/gist-ontology	diff manifest name, description and authors
upstream/gist14.1.0_webDownload/	datasets/gist-upstream-turtle, references/gist-ontology, org/semantic-arts	re-list ontologies/turtle/; a new release folder means a new upstream version
src/gist/schema/*.yaml, .linkmllint.yaml, docs/about.md	datasets/gist-linkml-schema	reload each module and recount classes, slots, types and enum values; re-read gist.yaml imports, the lint rules and the about page’s list of where the schema is stricter than gist
src/gist/mappings/*.sssom.tsv	the three datasets/gist-*-mappings, the three object-side references/, glossary/sssom	re-list the folder; recount rows, predicates and justifications per file; re-read each metadata header
scripts/gist_to_linkml.py, scripts/apply_sssom_overlay.py, scripts/verify_mappings.py, scripts/verify_mapping_targets.py	the four services/ CLIs	re-read each docstring and argparse block; run uv run python scripts/verify_mappings.py
project.justfile, justfile	playbooks/regenerate-schema, recipe facts in the services	re-read the gen-linkml, apply-sssom-overlay, verify-mappings, gen-project and test recipe chains
project/, src/gist/datamodel/, .linkml/generators.yaml	datasets/generated-artefacts	re-list project/*/; re-read the excludes in .linkml/generators.yaml
tests/data/, tests/test_*.py	datasets/test-data, test counts in the concepts	re-list tests/data/; uv run pytest --collect-only -q per file
tests/vendor/semanticarts/	datasets/semantic-arts-shapes	re-list; compare LICENSE.txt with the upstream copy
website/README.md, website/site.config.mjs, .github/workflows/knowledge-website.yaml, https://lmodel.github.io/gist	services/documentation-site	re-read the README’s page list, the config’s DOCS and REDIRECTS, and the workflow’s triggers and deploy condition; fetch the site and the w3id redirect
.github/workflows/lokf-copy-release.yaml, the lokf variable and gen-lokf-copy recipe in project.justfile, the lokf floor in .lokf/pyproject.toml, https://lokf.nolan-nichols.com/toolkit/adapt/	datasets/gist-lokf-copy	re-read the recipe’s lokf adapt flags, its rule for the top classes, the floor and both jobs; run just gen-lokf-copy and read adapt’s report; list the latest release’s assets with gh release view --json assets
.github/workflows/semantic-release.yml, .releaserc.json, .github/scripts/changelog-release.mjs, .github/workflows/pypi-publish.yaml, pyproject.toml, CONTRIBUTING.md (Releasing), https://pypi.org/pypi/gist-linkml/json	playbooks/release	re-read the release guards, the dispatches, the triggers, environments and distribution name; check whether the PyPI name is taken or published
README.md (License and attribution), https://github.com/semanticarts/gist/blob/v14.1.0/README.md, .linkml/generators.yaml, config.public.mk, TestGistNamespace and TestGistIrisInArtifacts	policies/gist-namespace-policy	re-read Semantic Arts’ license paragraph at the release tag in use; grep LINKML_GENERATORS_OWL_ARGS and the owl/shacl generator args; run the two test classes
.github/workflows/main.yaml, scripts/check_generated_current.py	CI facts in services/verify-mappings, services/verify-mapping-targets, playbooks/regenerate-schema and datasets/gist-lokf-copy	confirm it still runs the src/gist/schema/ drift check, just verify-mapping-targets, just verify-generated, just gen-lokf-copy, the lint step and just test
.github/workflows/upstream-watch.yaml, scripts/check_upstream_release.py, .github/scripts/report-issue.sh	services/upstream-watch	re-read the schedule, both jobs and the issue step
https://www.semanticarts.com/gist/, https://w3id.org/lmodel/{common-domain-model,dpv,iso22989}, https://mapping-commons.github.io/sssom/, https://pypi.org/project/sssom-schema/	the references/ concepts, glossary/sssom	external authorities: cite on change

These are not knowledge sources, and are left out on purpose:

• docs/elements/ and examples/output/ (git-ignored build output);
• docs/templates-linkml/ (site theming);
• the rest of website/ (the site’s own code, which website/README.md maps);
• docs/index.md, examples/README.md and src/README.md (short pages from the project template);
• CODE_OF_CONDUCT.md, AI_COVENANT.md, SECURITY.md, NOTICE, LICENSE, .github/ISSUE_TEMPLATE/, .github/pull_request_template.md and the rest of CONTRIBUTING.md (governance text the README links to);
• CHANGELOG.md (release history);
• uv.lock, .gitignore, .pre-commit-config.yaml, .yamllint.yaml, .editorconfig, .markdownlint-cli2.jsonc, lychee.toml and .github/workflows/lint-and-docs.yaml (tooling and its static checks);
• src/gist/__init__.py, src/gist/_version.py, tests/__init__.py and tests/conftest.py (package and test plumbing);
• .github/dependabot.yml;
• llms.txt (the pointer that sends agents to this bundle);
• the .lokf/ sidecar itself, including the knowledge_bundle link, .github/workflows/knowledge-*.yaml other than the website’s, and .github/PULL_REQUEST_TEMPLATE/knowledge-sync.md.