usm/mcp-summary

MCP summary tool — returns a quick summary of a .usm file with id, type, version, summary, and type-specific counts.

Why this exists

Agents need a lightweight overview of a .usm file without reading the full content. Summary returns just the key metadata — id, type, version, summary, and counts (features, services, flows, contracts, tests) — for rapid triage.

How it works

Get file summary (get-summary)

Agent gets a quick summary of a .usm file

1. Get — file path
2. Parse — extract metadata and counts
3. Observe — summary result with type-specific fields

Guarantees

summary-lightweight

Summary must return only metadata — not the full file content

Acceptance criteria:

• [ ] Includes id, type, version, last_updated, summary
• [ ] System files include featureCount, serviceCount
• [ ] Feature files include flowCount, contractCount, testCount
• [ ] Service files include runtime, port, depends_on

Test specifications

summary-feature

Given:

• valid_feature_usm: true

Then:

• assertion: response includes flowCount, contractCount, testCount
• assertion: response does not include full flows/contracts data

Implementation

• Primary: src/mcp/summary.ts
• Test code status: none

See Also

• usm/mcp-read