magus v0.4.3 is out. See what's new
¶ View markdown source · ✎ Suggest an edit

MGS7004: unknown marker family

A marker is a declaration a person writes in source: magus:<family> followed by its arguments, in whatever comment syntax the file uses. The knowledge graph records each one as a marker node with declared confidence. The families are diagram (a source file pointing at a figure), calls (a declared call to another package), skills (the managed AGENTS.md block) and observed (a generated figure block).

This code fires when magus graph build meets a family outside that list.

Why

A marker nothing reads is a declaration nothing honors. Skipping it would let a typo such as magus:cals pass as a declared edge that the graph never holds.

Resolution

The message names the file, the line and the known families.

  • A typo. Correct the family name.
  • Not a marker. Text that happens to contain magus: followed by a word, such as a URL scheme in prose, needs rewording so the token does not start a marker.
Knowledge-graph diagnosticsLanding page for MGS7xxx diagnostics that flag ambiguities the knowledge-graph extractor hits while building the deterministic graph, such as a buzz import that resolves to no file or a doc that cites an unregistered diagnostic code. MGS7001: unresolvable buzz importFires when the knowledge-graph extractor cannot resolve a workspace-relative buzz import to a scanned file, so the import becomes an inferred edge to the literal path instead of a resolved file-to-file edge. MGS7002: dangling doc referenceFires when a documentation page mentions an MGS#### diagnostic code that is not registered, so the knowledge-graph extractor cannot link the mention to a real diagnostic node. MGS7003: symbol index not currentFires when magus diff cannot bring the symbol index up to date for a project the change touched, so the conformance checks did not run and their silence means nothing was checked.
MGS7004knowledge graphmarkersgraph build
Last updated (479ce5c7)
Glossary

Knowledge graph

The queryable graph of a workspace's spells, targets, docs, and code relationships; query it with magus query/explain/path. See knowledge.

Conventions

Placeholders

Angle brackets mark a value you replace with your own; never type the brackets:

magus run <target>
magus completion <shell>    # e.g. bash, zsh, fish

<target>, <path>, <shell>, <name> and the like are stand-ins, not literal text.