fix(handlers): route read intents (α=read) → GET /world (D3 rehearsal block)

[DubovskiyIM]

Что

Real-world block найденный в D3 rehearsal 2026-05-09. mcp-server диспетчил все intents (включая α=read) через POST /api/agent/:domain/exec. runtime-local v0.6 для read-intent'ов возвращает 400 (read_intent_not_executable, by design A1.2).

Claude Desktop получал tool error → ответил пользователю «инструменты read не работают, я не могу показать продукты».

User: «Покажи список продуктов»
Claude → tool list_products → POST /exec/list_products → 400
Claude: «Запрос на список товаров вернул ошибку»

Решение

makeToolCallHandler теперь маршрутит по intent.alpha:

α=read           → GET /api/agent/:domain/world + filter rows (этот PR)
α=add/replace/   → POST /api/agent/:domain/exec/:intentId (как было)
  remove/batch
intent unknown   → fallback POST /exec (backward compat)

Архитектурное обоснование

runtime-local намеренно отделяет:

• POST /exec — mutation pipeline через engine.submit (invariants + lifecycle.requiresApproval + Φ ingest)
• GET /world — read-only snapshot из engine.foldWorld()

В MCP-spec'е read intents должны быть resources, не tools. Но Claude Desktop часто спонтанно дёргает tools по имени (когда видит list_products в наборе). Поэтому tool-call handler сам routes по alpha — для UX, без потери arch-purity (resources всё равно работают через idf://domain/collection URI).

После этого PR Claude может равноценно использовать как tool name (list_products), так и resource URI (idf://custom-culture/products) — зависит от его модели и контекста.

Demo flow после fix'а

User: «Покажи список продуктов»
Claude → list_products tool → mcp-server: alpha=read → GET /api/agent/custom-culture/world
runtime-local: { world: { products: [...] } }
mcp-server filter: collection="products" → 3 rows
Claude: «В магазине 3 продукта: Худи 4990₽, Футболка 1990₽, Кепка 1490₽ (нет в наличии)»

Тесты

5 новых + 41 existing = 46/46 passing:

• read intent → GET /world + filter → {status:'confirmed', collection:'products', count:3, rows:[...]}
• mutation intent → POST /exec → standard payload
• intent не в map → fallback POST (backward compat для старых call sites)
• read с target='Entity.field' → base entity for collection name
• read когда /world 500 → isError: true + world_fetch_failed

Что НЕ в этом PR (отложено)

• Per-row filtering by role.visibleFields — пока возвращаем full rows, а runtime-local v0.6 не делает role-based filter в /world. Future runtime-local v0.7 + mcp-server v1.1 add field-level filter.
• Pagination — read intents возвращают весь collection. Большие collections (Order > 10k) — batch'и через resources URI с query параметром.

Bump

@intent-driven/mcp-server: 1.0.3 → 1.0.4

После merge для D3 rehearsal

После npm publish:

• npx -y @intent-driven/mcp-server подтянет 1.0.4
• Claude Desktop переподключит MCP
• Покажи продукты → работает
• Cancel order ORD-... → 202 ApprovalRequest (mutation flow as before)

Refs: D3 rehearsal log 2026-05-09 19:04 UTC.