compass show needs a full-content variant
Table of Contents
This page is a capture in the next bucket of the product backlog — a pre-sprint idea, not yet pulled into a sprint as a story.
What
compass show <id> prints title, type, tags, description, blurb, and
outgoing/incoming links — but never the document's actual body (Summary/
Detail sections, tables, prose). Add a variant (e.g. compass show <id>
--full or a separate compass cat <id>) that dumps the full rendered
content of the .org file, resolved by ID the same way show does,
so an LLM agent or CLI user doesn't need to fall back to reading the
file path directly once they already have the ID.
Why
While researching existing entities/conventions (e.g. reading
fx_convention.org, the entity evaluation checklist, or a recipe),
compass show only ever returns a summary — never enough to actually
read the content. The workaround is to separately resolve the file path
from the show output and issue a second, unrelated file-read command.
A single command that goes straight from ID to full content would
remove that extra hop and keep the compass CLI as the one tool needed
for orientation and lookup.
References
- Session where this was hit repeatedly: investigating
ores.refdata.fx_convention.org, the "Domain entity evaluation checklist", and codegen recipes for the currency pair reference-data work.