@intent-driven/runtime-local

Standalone Fold-runtime для локального quickstart'а. Принимает ontology.js (сгенерированный idf full-bootstrap), поднимает HTTP-сервер с эндпоинтами, которые ожидает @intent-driven/mcp-server для подключения к Claude Desktop / Cursor / Zed.

Статус: v0.1 — skeleton. Поддерживает /api/health, /api/typemap, /api/agent/:domain/schema (discovery). Полный agent/exec, approvals lifecycle, /api/state/* — в следующих релизах (см. roadmap fold-15min).

Зачем

До этого пакета чтобы поднять Fold-runtime локально нужно было git clone idf + npm install + npm run server в host-репе. Это блокер коробочности: пользователь не должен знать про host. После этого пакета:

idf serve --ontology ./ontology.js   # планируется в @intent-driven/cli
# или программно:
import { createRuntime } from '@intent-driven/runtime-local';
const runtime = createRuntime({ ontology: require('./ontology.js') });
await runtime.start();

Установка

npm install @intent-driven/runtime-local

Peer-зависимость: @intent-driven/core@>=0.49.0 (нужен для будущих релизов с validator/fold; в v0.1 не требуется в runtime, но указан как peer для forward-compat).

API

`createRuntime(opts)`

Создаёт runtime-инстанс. Не стартует сервер — для этого вызови .start().

Опция	Тип	Default	Описание
`ontology`	object	required	IDF ontology — `{ entities, intents, roles, projections, ... }`.
`port`	number	`3001`	Порт. `0` = random (для тестов).
`host`	string	`'127.0.0.1'`	Bind-адрес.

Возвращает { app, ontology, domain, start(), stop() }.

`runtime.start()` → `Promise<{url, port, host}>`

Поднимает Express-сервер. Возвращает actual URL/port (полезно при port: 0).

`runtime.stop()` → `Promise<void>`

Закрывает сервер.

Эндпоинты (v0.1)

Метод	Путь	Назначение
`GET`	`/api/health`	Liveness check для `idf doctor` и MCP-server. Возвращает `{status, domain, runtime, version}`.
`GET`	`/api/typemap`	Сводка ontology: entities/intents/roles names.
`GET`	`/api/agent/:domain/schema`	Full ontology snapshot для MCP discovery. 503 если domain не совпадает с зарегистрированным.

Roadmap (следующие PR)

v0.2: in-memory Φ-store + GET /api/state/at + GET /api/state/diff
v0.3: POST /api/agent/:domain/exec/:intentId — ingest с invariant validation, ApprovalRequest auto-injection через lifecycleAugmenter
v0.4: GET /api/approvals/pending + POST /api/approvals/:id/approve|reject + timer-driven expiry
v0.5: SSE-стрим /api/approvals/stream для idf approvals --watch

JSPM