@intent-driven/cli

@intent-driven/cli

CLI для bootstrap новых доменов в парадигме Intent-Driven Frontend через интерактивный LLM-диалог.

Установка и запуск

Без установки, через npx:

ANTHROPIC_API_KEY=sk-ant-... npx @intent-driven/cli init my-domain

Или глобально:

npm install -g @intent-driven/cli
export ANTHROPIC_API_KEY=sk-ant-...
idf init my-domain

API-ключ Claude получить: https://console.anthropic.com/

Что делает idf init <name>

Ведёт короткий диалог из 5 шагов:

• Описание домена — 1-2 предложения от тебя.
• Сущности — Claude предлагает 3-7 ключевых entity на основе описания.
• Роли — Claude предлагает 1-3 роли с base (owner / viewer / agent / observer).
• Намерения — Claude выводит 8-15 атомарных интентов; ты multiselect-ом оставляешь нужные.
• Генерация — пишет файлы и валидирует через crystallizeV2.

На выходе — каталог <name>/ с готовой стартовой структурой:

<name>/
  domain.js                  ─ ontology + intents + projections
  seed.js                    ─ начальный мир для smoke-тестов
  test/crystallize.test.js   ─ vitest-проверки
  package.json               ─ зависимости (@intent-driven/core, vitest)
  README.md                  ─ описание домена

После cd <name> && npm install && npm test — всё должно зеленеть.

Опции

idf init <name> [options]

  -m, --model     LLM-модель: haiku | sonnet | opus  (default: sonnet)
  -o, --out       Каталог для генерации               (default: ./<name>)
  -h, --help
  -v, --version

Модели:

• haiku (Claude Haiku 4.5) — самая быстрая и дешёвая, для простых доменов
• sonnet (Claude Sonnet 4.6) — баланс качества и скорости (default)
• opus (Claude Opus 4.6) — лучшее качество для сложных domain'ов

Подключение сгенерированного домена к прототипу

В клонированном DubovskiyIM/idf:

• Скопируй каталог <name>/ в src/domains/<name>/.
• Зарегистрируй в src/prototype.jsx как новый пункт переключателя:

  import myDomainDef from "./domains/my-domain/domain.js";
  import myDomainSeed from "./domains/my-domain/seed.js";
  // … добавить в DOMAINS / SEEDS map
  

• npm run dev — твой домен станет доступен через переключатель в шапке.

Что считается «сгенерированным»

CLI не угадывает бизнес-логику. То, что он генерирует — каркас, который:

• Проходит crystallizeV2 без ошибок.
• Имеет corretные типы полей (money, datetime, boolean, entityRef выводятся из имён).
• Имеет правильную структуру particles в каждом intent'е.
• Генерирует базовый набор catalog+detail проекций для каждой non-reference entity.

Что не генерируется автоматически:

• Условия (conditions) — нужно добавить вручную, Claude их не выводит без знания бизнес-правил.
• Кастомные projections — dashboard, wizard, canvas (только catalog/detail из коробки).
• Многосущностные effects (например, batch-изменения) — простые add/replace/remove.

После генерации домен — стартовая точка для итеративной правки.

idf import

Импорт схемы из внешних источников в IDF-ontology.

idf import prisma

idf import prisma --file schema.prisma --out src/domains/api/ontology.js

idf import openapi

idf import openapi --file openapi.yaml --out src/domains/api/ontology.js

idf import postgres

idf import postgres --url postgresql://user:pass@localhost/mydb --out src/domains/api/ontology.js

idf import nestjs-typeorm

Сканирует NestJS+TypeORM проект (*.entity.ts + *.controller.ts) и генерирует ontology.

idf import nestjs-typeorm --src ./src --out src/domains/api/ontology.js
idf import nestjs-typeorm --src ./apps/backend/src --no-guards

Флаги:

• --src <dir> (required) — root user-проекта для рекурсивного скана
• --out <file> (default src/domains/default/ontology.js)
• --name <name> — domain name (default default)
• --no-guards — отключить Guards → roles mapping
• --tsconfig <path> (optional) — путь к tsconfig.json (default: auto-detect в src/)

v0.2: extracts @Param/@Body/@Query параметры из Nest handler'ов в intent.parameters. Резолвит DTO-классы и enum-references по relative imports + tsconfig compilerOptions.paths.

Скоп v1.0

В этой версии — только команда init. В планах для следующих минорных:

• idf add intent <name> — добавить намерение к существующему домену
• idf validate <path> — прогон conformance-тестов из spec
• Поддержка не-Anthropic LLM (OpenAI, локальные)

Issues / feature requests: https://github.com/DubovskiyIM/idf-sdk/issues

Лицензия

MIT.