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.

See also

Emacs 29.3 (Org mode 9.6.15)