Skip to content

[Feature] get_overview: add a compact mode to trim the payload #671

Description

@RaghavChamadiya

Problem

The get_overview MCP tool always returns the full overview page (content_md) alongside key_modules and architecture.layers. For orientation, an agent rarely needs the entire essay, and these three fields overlap heavily. The result is a large payload for what is usually a one-time "where am I" call.

Proposed Solution

Add a compact parameter to get_overview (defaulting to compact) that trims content_md, returning the full essay only when the caller opts in (for example include=["content"]). Keep key_modules and architecture.layers as the lightweight orientation payload.

While there, two cheap related wins in the same tool:

  • Cap key_modules (currently up to 20) to a smaller number; it is orientation, not a directory listing.
  • Dedupe tour steps by kind so a run of near-identical re-export-hub steps collapses into one.

Alternatives Considered

Leave it as-is and rely on the agent to ignore the extra content. That still pays the token cost on every call, which is the thing worth avoiding for a tool meant for quick orientation.

Additional Context

  • packages/server/src/repowise/server/mcp_server/tool_overview.py (the content_md field is returned unconditionally around line 721).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions