orstrum_get_summary

Returns a file's LLM-generated Purpose summary plus a small neighborhood — its top callers and top imports.

Input

path required

string

File path. Absolute, cwd-relative, repo/relPath shorthand, or repo/relPath.md note form.

Output


  note:        "api-service/src/api/auth",
  purpose:     "Validates incoming JWTs and exposes middleware for route protection.",
  hasSummary:  true,
  topCallers:  ["api-service/src/pages/login", "api-service/src/middleware/guard"],
  topImports:  ["api-service/src/lib/jwt"],
  callerCount: 2

When no summary has been generated yet, purpose is an empty string ("") and hasSummary is false — use hasSummary as the signal and fall back to Read in that case. Generate summaries with orstrum summarize.

topCallers and topImports are capped neighborhoods (top 5 each) so you can chain into orstrum_get_callers or orstrum_get_imports without an extra call. callerCount is the total (may exceed topCallers.length).

Use this tool first when you need to understand a file before editing it. The caller list shows blast radius at a glance and the imports show what the file depends on.