MGS1006: unknown target

A target was referenced by a name that no project in scope declares. This happens two ways:

• A CLI call such as magus run <name> (or magus x <name>) where <name> matches no target anywhere in the selected scope.
• A dependency handle in a magusfile, such as ctx.needs(<name>), that names a target that does not exist.

[MGS1006] magusfile: unknown target "build" (registered: build, lint, test)
  see: .../MGS1006.md

Why

A target is an exported function in a magusfile (normalized to a kebab-case name). Magus resolves a referenced target by that name; when nothing declares it, there is nothing to run. The message lists the targets that ARE registered in scope so a typo is obvious at a glance.

During a normal fan-out run (magus run build, magus affected ci), a project that does not declare the requested target is silently skipped, not reported as unknown; that is expected in a multi-project workspace. MGS1006 is the terminal case: the name resolves to no target at all in the selected scope.

Resolution

• Typo? Compare against the registered: list in the message, or run magus describe targets to see every target and the project that declares it.

• Wrong scope? The target may live in a project outside the current selection. Run from the workspace root, or widen the scope.

• Not defined yet? Declare it as an exported function in the project's magusfile:

  import "magus";
  
  export fun build(ctx: magus\Context, _a: [str]) > void { go["go-build"](ctx); }
  

• Dependency handle. ctx.needs(x) takes a target FUNCTION handle in the same magusfile; a cross-project dependency uses the imported project's handle (import "project/api"; ... ctx.needs(api.build);). A bare unresolved name raises this diagnostic.

What this is not

• Not a missing spell. A spell provides ops, not targets. If the name you meant is a spell op, invoke it through a target, not directly.
• Not the empty-affected-set no-op. magus affected ci with no changed projects runs nothing and does not raise MGS1006.

See also

• targets: the anatomy of a magus target.
• magus describe targets: every target and where it is declared.