orstrum_search

Keyword search across stored Purpose summaries — returns ranked hits with an excerpt and each hit's top callers.

Input

query required

string

Substring to search for; case-insensitive.

repo

string

Restrict the search to one repo (matches repo.name).

maxResults

number

Cap the number of hits (1–100). Default: 20.

Output


  query: "authentication",
  results: [
    
      notePath:    "api-service/src/api/auth",
      repo:        "api-service",
      excerpt:     "Validates incoming JWTs and exposes middleware for route protection.",
      callerCount: 2,
      topCallers:  ["api-service/src/pages/login", "api-service/src/middleware/guard"]
    
  ]

Each hit carries a caller neighborhood (callerCount and up to three topCallers) so you can prioritize which hit to open next without a follow-up call.

Results match against Purpose summaries when they exist. When no summaries match — common on the free, no-API-key flow where orstrum summarize was skipped — the search falls back to structural matching over file paths and export names, so an indexed-but-unsummarized file is still findable. Generate summaries with orstrum summarize to improve quality.