docs: resolve Ontos unknown-concept warnings#129
Merged
Conversation
- expand .ontos-internal/reference/Common_Concepts.md with 45 durable
project terms across six new sections (Ontos CLI, Ontos Internals,
Project Lifecycle, Surface & Output, Integrations, Building Blocks)
- retag 4 historical docs to use vocabulary-compatible terms:
- v3.0.0.md: drop `v3.0` (release already in list)
- v3.3.0.md: replace `v3.3` with `release`
- 2026-05-11 log: `agentic_activation` -> `agentic-activation`,
`frontmatter_diagnostics` -> `frontmatter` (underscore form
violates concept regex)
- 2026-01-31 log: `maintenance` -> `maintain` (synonym)
- regenerate Ontos_Context_Map.md and sync AGENTS.md
Unknown-concept warnings: 71 -> 0.
Out of scope (deferred to follow-up passes):
- 128 orphan warnings (orphan policy unchanged)
- 66 missing `concepts` + 26 missing schema-field warnings
(resolved by PR #128 metadata hygiene once it merges)
- 3 pre-existing ARCHITECTURE errors (skip ontos-validate hook;
CI already tolerates them)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
After rebasing onto main (post #128 metadata hygiene merge), rerun ontos map --sync-agents to absorb the resolved missing-field warnings. Net warning state: 128 orphan only (was 220 pre-rebase: 66 curation + 26 schema + 128 orphan; missing-field warnings now resolved upstream). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ced04fb to
fa22cf8
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
[a-z][a-z0-9-]*) or are synonyms of canonical terms:v3.0(releasealready in list).v3.3withrelease.agentic_activation→agentic-activation,frontmatter_diagnostics→frontmatter.maintenance→maintain.ontos map --sync-agents.Result: unknown-concept warnings 71 → 0.
Out of scope (intentionally)
Document has no incoming dependencieswarnings) — deferred to the next pass.ontos-validate --stricthook is skipped for this commit (SKIP=ontos-validate).concepts, 26 missing schema fields) — already resolved by #128; they'll disappear once that lands and this branch rebases.Rationale for retags vs. additions
[a-z][a-z0-9-]*— soagentic_activation,frontmatter_diagnostics,v3.0, andv3.3cannot be added as-is. Their docs were retagged to vocabulary-compatible terms.maintenancewas retagged tomaintainsince both refer to the sameontos maintaincommand; keeping both would fragment the graph.Follow-ups recommended
ontos-validate --strictpasses locally again.Stacking note
This branch is independent of #128 (also off
main). Expect Ontos_Context_Map.md and AGENTS.md to conflict or drift when the other PR lands; resolve by rebasing onto updatedmainand rerunningontos map --sync-agents.Verification
git diff --check(staged)scripts/llm-dev doctor.venv/bin/python -m pytest -qontos activate --jsonvalidationontos mapwarning breakdown🤖 Generated with Claude Code