Why
Agents repeatedly re-derive container structure by sampling. A dedicated, cheap discovery command returns inferred schema, partition key, indexing policy, and a small sample — reducing RU spend and hallucinated field names.
Proposed behavior
schema [--db --con] [--sample N] returns partition key path(s), indexing policy summary, inferred field types from a bounded sample, and item count estimate.- Exposed as a read-only MCP tool.
Acceptance criteria
- Command + MCP tool.
- Bounded/read-only.
- Structured output.
- Docs + tests.
Filed from the Agentic & Automation Roadmap (docs/agentic-roadmap.md), item M4, Wave 2. Priority P1.
Why
Agents repeatedly re-derive container structure by sampling. A dedicated, cheap discovery command returns inferred schema, partition key, indexing policy, and a small sample — reducing RU spend and hallucinated field names.
Proposed behavior
schema [--db --con] [--sample N]returns partition key path(s), indexing policy summary, inferred field types from a bounded sample, and item count estimate.Acceptance criteria
Filed from the Agentic & Automation Roadmap (
docs/agentic-roadmap.md), item M4, Wave 2. Priority P1.