Skip to content

feat(gateway): expose charter_brief through stackbilt-mcp-gateway with per-tenant repo targeting #116

@stackbilt-admin

Description

@stackbilt-admin

Context

Post-v0.1 follow-up to #113 (charter_brief MCP tool in charter serve).

charter serve is per-repo — one MCP server instance per Charter-governed repo. Multi-repo agent workflows (which is the direction autonomous agents are heading, driven by cc-taskrunner and aegis-daemon spawns across 10+ repos) need brief access without spinning up one charter serve per repo.

The stackbilt-mcp-gateway is ecosystem-wide and already brokers OAuth + tool access across Stackbilt properties. Natural home for a gateway-hosted brief-fetcher.

Open questions

  1. Invocation shape: charter_brief today takes no arguments — it's "this repo, now." Through the gateway, agents need to specify which repo. Options:
    • New tool name (e.g. stackbilt_repo_brief) with a repo: string argument — decouples from the per-repo tool entirely
    • Same charter_brief name, gateway injects the repo from tenant/session context — transparent to the agent but implicit routing
  2. Brief freshness: gateway serves a central cache vs. proxies to the per-repo charter serve instance. Cache has a consistency problem (when does it invalidate?); proxy has a cold-start cost.
  3. Auth scoping: which tenants can read which repos? Read the existing gateway OAuth model and reuse — this shouldn't invent new permissions.

Not v0.1

charter_brief ships through per-repo charter serve first (#113). Gateway exposure is a separate ecosystem integration that lands once the brief format is stable and we have real multi-repo agent workloads asking for it.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    v0.13Targeted for Charter v0.13

    Type

    No type
    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