Scout Engine

File discovery, AST analysis, and priority scoring.

What it does

The Scout Engine is the first stage of the pipeline. It:

• Discovers files — walks your repo and applies ignore rules from .gitignore and .lcignore.
• Extracts symbols — parses each file's AST to find exported functions, classes, types, and variables.
• Analyses git history — measures churn rate, commit frequency, and last-modified date for each file.
• Scores files — combines import centrality, git activity, symbol density, and architectural position into a single priority score (0–100).

Score Breakdown

import_centrality   ← how many files import this one
file_identity       ← exports, classes, functions
git_activity        ← commit frequency + churn
symbol_density      ← symbols per line of code
arch_position       ← entry points, config, root files
explicit_signals    ← manually flagged importance