focuslisted

# Focus Get oriented on a project before diving in. Pulls recent activity from the event logs — no git calls, no compilation, just what the hooks already captured. Before running commands, resolve `ROOT` to the Session Cartographer plugin root. Prefer `CARTOGRAPHER_ROOT`, then `CLAUDE_PLUGIN_ROOT` or `PLUGIN_ROOT`. Otherwise derive it from this skill's reported base directory (`../..` from `skills/focus`), with the conventional checkout as a legacy fallback. ## What it shows - Recent session milestones (with git branch, dirty state from when they were logged) - Recent commits (with type classification) - Research activity - Last session end events (what was happening when you left off) - **Related project threads + recurring technical maneuvers** (from the co-occurrence graph, `scripts/cooccurrence-graph.js`) ## How to use it Run the search script with `--project` and a broad recency query: ```bash CARTOGRAPHER_PURPOSE=focus bash "$ROOT/scripts/cartographer-search.sh" "recent activity" --project <PROJECT> --limit 20 ``` The `<PROJECT>` argument supports: - **Direct project names**: `session-cartographer`, `scrutinizer2025` - **Registry aliases**: `devtools`, `scrutinizer`, `psychodeli` — expanded via `project-registry.json` to match all repos in the family ## Step 1: Resolve the project If the user gives a vague name, check `project-registry.json` for aliases: ```bash jq -r '.aliases | keys[]' "$ROOT/project-registry.json" ``` ## Step 2: Search recent activity ``