history-explorer

Run the history explorer with a query and a window-days parameter to aggregate DecisionEntry logs into co-occurrence and meta-usage statistics. The script reads JSONL decision logs and prints a JSON summary to stdout.

Invoke explore.py with --include co_occurrences and --window-days set to your desired range. The aggregator counts how often skills appear together in DecisionEntry.skills_invoked and returns the top-k pairs as JSON.

It resolves the log directory in order: the --log-dir argument, the OPENSQUILLA_LOG_DIR environment variable, OPENSQUILLA_STATE_DIR/logs, or ~/.opensquilla/logs. Tilde paths are expanded at runtime.

The script returns an empty result with a placeholder string stating that no history is available and downstream consumers should rely on user intent only. It does not fail or raise an error.

Yes, it works in wheel installs because it derives the package root from its own file location. Router fixtures are returned as an empty list when the test-fixture directory is absent.