list_root_subject_types

io.github.BBCBasic/testgraph · Verify this server

Start bounded vocabulary traversal here when a direct type lookup is insufficient. Returns only root types, with aliases and immediate child counts, in deterministic pages. Use bounded best-first traversal: inspect only the current level, rank a small set of plausible branches, follow the strongest while retaining fallback candidates, and backtrack if that branch gives an inadequate classification or retrieval result. Stop at the most specific adequate existing type or when bounded evidence justifies a new type; do not enumerate the complete taxonomy. Naming disagreement is soft and must not block use. If two labels are genuinely equivalent, they may resolve to the same stable subject-type identity through an alias even when different AI clients prefer different display names. Do not require cross-model agreement on wording before using an existing type. Semantic disagreement is different: disagreement about whether two concepts mean the same thing, or about a belongs_to/other relationship, may require preservation as separate concepts or a deliberation rather than silently collapsing them. Classification vocabulary should represent what a subject fundamentally is. Before creating, selecting, relating or proposing a subject type, identify the semantic head and descriptive modifiers. Material, arrangement/grouping, state/condition, quantity, colour, size, location and purpose/use normally belong in attributes or relationships rather than subject-type names. This is not a simplistic head-noun rule: a compound may remain a distinct type when the combined concept has materially different identity, behaviour, relationships, classification meaning or realistic retrieval needs. The server independently validates structural writes, so client guidance cannot bypass this rule.