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

MGS8003: malformed output ref

magus query output <ref> retrieves one target execution's captured output by its reference id (magus query output out1a2b3c). This code fires when the argument is not a well-formed ref<hex> id, so it cannot name a stored output.

output is an explicit subcommand, so a bare search term is never mistaken for a ref: magus query refactor queries the knowledge graph. This code is reserved for the case where you asked for output retrieval but the id is malformed.

Resolution

Pass a valid reference id (printed on each target's result line when it runs), or drop output to run a knowledge-graph search. To open the knowledge graph in a browser instead, use magus graph open.

output-reference diagnosticsLanding page for MGS8xxx diagnostics that flag problems resolving a target-output reference id with magus query, such as a ref that aged out of the cache, an ambiguous prefix, or a malformed ref passed to a ref-only flag. The CLI in practiceThe magus subcommands you actually reach for, grouped by the question you are asking, with the quirks that are not obvious from the help text. Agent skillsEvery skill magus installs, in both curated permutations, generated from the embedded bodies. magus DocumentationThe magus documentation hub covering install, targets, spells, charms, operations, engines, remote caching, MCP, telemetry, and the interactive playground.
MGS8003output refsqueryflags
Last updated (a103255f)
Earlier changes on this page (1)

Full history ↗ · Blame source ↗

Glossary

Target

A named operation (build, test, ...) you invoke with magus run <target>; it may compose a spell's tool-native operations and depend on other targets. See targets.

CI

An ordinary magusfile-defined target you compose yourself with magus\needs - magus does not hardcode its stages. Magus.RunCI treats it specially only in that it strips the rw charm, it is the anchor magus affected ci keys off, and a selected scope with no project declaring it is a load error rather than a silent no-op. See targets.

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.