How do I see where we are?

Table of Contents

The Locate pillar of the compass tool. It reads the agile tree (doc/agile/versions/) directly, so it needs no org-roam.db and no org-roam-db-sync.

Question

Where are we in time — which version and sprint are current, and which stories / tasks are in flight right now?

Answer

Run compass.sh where (or its alias status):

./projects/ores.compass/compass.sh where

It prints the current version and sprint (title, :ID:, path) and every story/task under the current sprint whose State is STARTED. "Current" is the lexicographically-highest version/sprint folder.

For tooling, -f json emits a structured version / sprint / in_flight document:

./projects/ores.compass/compass.sh status -f json

Script

projects/ores.compass/compass.sh wheresrc/compass.py (cmd_where), which uses the bundled doc_index to discover docs and reads the State row from each doc's * Status table.

Tested by

Manual smoke test. Read-only over the working tree.

See also

Emacs 29.1 (Org mode 9.6.6)