orientlisted

# orient — the ranked symbol skeleton ## Run it ```bash nord-repomap [ROOT] --map-tokens N ``` - `ROOT` — repo root, default cwd. Uses `git ls-files` where available, so `.gitignore` is respected; otherwise walks the tree with sane excludes. - `--map-tokens N` — budget for the map. Default `1024`, `2048`–`4096` for a large repo, `~300` for just the top. ```bash nord-repomap # cwd, ~1024 tok nord-repomap ~/00_projects/foo --map-tokens 2048 nord-repomap . --map-tokens 300 # top symbols only ``` Output is `file: line: signature`, grouped by file, ordered by PageRank over a tree-sitter def/reference graph (vendored from Aider's `get_ranked_tags`, Apache-2.0), capped at the budget: ``` # repo-map: <root> (<N> top symbols / <M> files, ~<budget> tok budget) path/to/file.py: 41: class JLCPCBClient: 82: def _request(self, method, path, body=None): ``` Then read the named files, or run lsp on a symbol from the list, to go deeper. **Reading files in order to orient is what this replaces** — one call beats a dozen Reads at a fraction of the tokens. ## What it is not Reach for something else when the question is one of these: | the question | the tool | why not orient | |---|---|---| | what depends on what, what breaks if X changes | the `graphify` skill | both extract with tree-sitter; **orient ranks, graphify relates**. graphify needs a built `graphify-out/graph.json`, orient needs nothing | | the structure of ONE file | `smart_o