Skip to content

Normalize MCP tool names — single grammar + alias policy #33

@Narrator

Description

@Narrator

Sprint 2371 — task T2 (Batch A)

Closes #18. Implements RFC 0001 workstream 2.

Background

README.md advertises dotted names (domscribe.query.bySource) while TECHNICAL_SPEC.md §3.4 lists dashed names (annotation-get). #18 reports Windsurf rejecting dotted names entirely (^[a-zA-Z0-9_-]{1,64}$). Before stamping RCP v1.0.0 we must canonicalize on one grammar.

Scope

  • Staff engineer decides between dotted and underscore form, applying the constraints in RFC 0001 + team memory note on MCP SEP-986
  • Document the canonical form + grammar in @domscribe/protocol package README
  • Implement alias layer in @domscribe/relay's MCP server: legacy names continue to resolve for ≥1 minor cycle, emit a deprecation warning
  • Update every reference: README tool table, TECHNICAL_SPEC §3.4, skills/ content, gemini-extension.json, npx domscribe init MCP config emission, every fixture in domscribe-test-fixtures

Acceptance

Depends on

T1 (@domscribe/protocol package exists before names are stamped into it).

Risk

Tool-name rename will break every user's existing .mcp.json if the alias layer is missing or buggy. Test fixtures must include both old and new names resolving correctly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestpriority:P0Urgent — security, data loss, or critical regressionrcpRuntime Context Protocol — public spec workstreams

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions