Tools

stellarion_search_git_history [Pro]

Semantic and keyword search over git commit history

This is a Pro tool. Requires a Stellarion Pro license. A 180-day free trial starts automatically.

Searches git commit history using a combination of semantic search over mined memories and keyword search over git log. Returns commits and patterns that match your query, ranked by relevance. Requires that stellarion_mine_git_history has been run at least once to populate the semantic index.

When to Use

To find when and why a specific change was made
To locate commits related to a concept (e.g., "authentication refactor")
To understand the history behind a bug or feature
To find past solutions to problems you are encountering now

Parameters

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Natural language query describing what you are looking for
`since`	string	No	—	Time filter (e.g., `"3 months ago"`, `"2024-01-01"`)
`maxResults`	number	No	`10`	Maximum number of results to return

Examples

Search git history for commits related to "rate limiting".

Finds commits where rate limiting was added, modified, or fixed — even if the commit message does not literally say "rate limiting".

Time-bounded search

What authentication-related changes were made in the last 3 months?

Uses since: "3 months ago" to scope the search.

Find the origin of a feature

When was the payment retry logic first introduced?

Searches for the earliest commits related to payment retry.

Investigate a past bug fix

Search for commits that fixed null pointer exceptions in the parser.

Finds commits related to null/nil/None handling in parser code.

Output Format

Returns a ranked list of results, each containing:

Commit hash — the git commit SHA
Commit message — the original commit message
Author and date — who made the change and when
Files changed — which files were modified in the commit
Relevance score — how well this commit matches your query
Related memories — any mined patterns associated with this commit

Results combine semantic matches (from mined memories) and keyword matches (from git log), de-duplicated and ranked by relevance.

Tips

Run stellarion_mine_git_history first — without it, only keyword search over git log is available
Semantic search finds conceptually related commits even when the exact words do not match — "authentication" will match commits about "login", "session", "JWT", etc.
Use since to narrow results when the repository has a long history
The query is natural language — write it as you would ask a colleague: "when did we switch from MySQL to Postgres?" works better than "MySQL Postgres migration"
Combine with stellarion_mine_git_history_for_file to first build file-specific context, then search within it

stellarion_mine_git_history_for_file [Pro]

Mine git history for a specific file to learn its evolution patterns

stellarion_find_eda_calls [Pro · EDA]

Find call sites of EDA-classified commands (Quartus / Qsys / SDC) across the workspace