@vira-ui/cli 1.1.1 → 1.2.0

package/README.md

@@ -1,965 +1,454 @@
-# @vira-ui/cli
-
-<div align="center">
-
-**Vira CLI - Генератор проектов и кода для Vira Framework**
-
-[![Version](https://img.shields.io/npm/v/@vira-ui/cli.svg)](https://www.npmjs.com/package/@vira-ui/cli)
-[![License](https://img.shields.io/npm/l/@vira-ui/cli.svg)](LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)
-
-**Создавайте проекты, генерируйте компоненты, сервисы и backend-код одной командой.**
-
-[📖 Quickstart: Создаём CRM за 10 минут](QUICKSTART.md) • [🚀 Production-Ready](PRODUCTION.md) • [Установка](#-установка) • [Быстрый старт](#-быстрый-старт) • [Команды](#-команды) • [Примеры](#-примеры)
-
-</div>
-
----
-
-## 🎯 Что это?
-
-**Vira CLI** — это мощный инструмент командной строки для быстрого создания проектов и генерации кода в экосистеме Vira Framework. Он автоматизирует рутинные задачи и помогает начать разработку за секунды.
-
-### Основные возможности
-
-- ✅ **Создание проектов** — Frontend, Fullstack, Kanban reference app
-- ✅ **Генерация компонентов** — React компоненты, сервисы, страницы, модели
-- ✅ **Backend scaffolding** — Go handlers, models, migrations, event handlers
-- ✅ **Синхронизация типов** — Автоматическая синхронизация TypeScript типов из Go структур
-- ✅ **VRP Protocol** — Валидация и генерация документации протокола
-- ✅ **Docker & DevOps** — Готовая инфраструктура для разработки и продакшена
-
-> **Примечание:** Некоторые функции находятся в экспериментальной стадии в альфа-версиях.
-
----
-
-## 📦 Установка
-
-### Глобальная установка
-
-```bash
-# Глобальная установка
-npm install -g @vira-ui/cli
-```
-
-### Использование через npx (рекомендуется)
-
-```bash
-npx @vira-ui/cli create my-app
-```
-
----
-
-## 🚀 Быстрый старт
-
-> 💡 **Новый?** Начните с [📖 Quickstart гайда](QUICKSTART.md) — создайте полноценную CRM страницу за 10 минут!
-
-### 1. Создание проекта
-
-```bash
-# Интерактивный выбор шаблона
-npx vira create my-app
-
-# Или с указанием шаблона
-npx vira create my-app --template frontend
-npx vira create my-app --template fullstack
-npx vira create my-app --template kanban
-```
-
-### 2. Генерация компонента
-
-```bash
-cd my-app
-npx vira generate component Button
-npx vira generate service User
-npx vira generate page Dashboard
-```
-
-### 3. Запуск проекта
-
-```bash
-cd my-app
-npm install
-npm run dev
-```
-
-**Готово!** Ваш проект запущен и готов к разработке.
-
----
-
-## 📚 Команды
-
-### `vira create <name>` — Создание проекта
-
-Создаёт новый проект Vira с выбранным шаблоном.
-
-**Опции:**
-- `-t, --template <template>` — Тип шаблона: `frontend`, `fullstack`, `kanban`
-
-**Примеры:**
-```bash
-# Интерактивный выбор
-vira create my-app
-
-# Frontend проект (React + Vite + Vira UI)
-vira create my-app --template frontend
-
-# Fullstack проект (Frontend + Go Backend + Docker)
-vira create my-app --template fullstack
-
-# Kanban reference app (демонстрация VRP)
-vira create my-app --template kanban
-```
-
-### `vira init` — Инициализация проекта
-
-Инициализирует проект Vira в текущей директории. Полезно для инициализации существующего проекта.
-
-**Опции:**
-- `-t, --template <template>` — Тип шаблона: `frontend`, `fullstack`, `kanban`
-
-**Примеры:**
-```bash
-# Интерактивный выбор шаблона
-cd my-existing-project
-vira init
-
-# С указанием шаблона
-vira init --template frontend
-```
-
-**Что создаётся:**
-
-#### Frontend Template
-```
-my-app/
-├── src/
-│   ├── components/     # React компоненты
-│   ├── services/        # Сервисы (DI)
-│   ├── pages/          # Страницы
-│   ├── models/         # Модели с валидацией
-│   ├── hooks/          # Custom hooks
-│   ├── utils/          # Утилиты
-│   ├── App.tsx         # Главный компонент
-│   └── main.tsx        # Точка входа
-├── package.json        # Зависимости
-├── tsconfig.json       # TypeScript конфигурация
-├── vite.config.ts     # Vite конфигурация
-└── index.html          # HTML шаблон
-```
-
-#### Fullstack Template
-```
-my-app/
-├── frontend/           # React приложение
-├── ui/                 # Vira UI пакет/шоукейсы
-├── backend/            # Go API
-│   ├── cmd/api/        # Точка входа
-│   ├── internal/
-│   │   ├── handlers/   # HTTP handlers
-│   │   ├── models/     # Go модели
-│   │   ├── events/     # Event handlers
-│   │   ├── db/         # Database
-│   │   ├── cache/      # Redis
-│   │   └── config/     # Конфигурация
-│   ├── migrations/     # SQL миграции
-│   └── queries/        # SQLC queries
-├── deploy/             # Docker & DevOps
-│   ├── docker-compose.dev.yml
-│   └── docker-compose.prod.yml
-└── migrations/         # Общие миграции
-```
-
-#### Kanban Template
-```
-my-app/
-├── src/
-│   ├── components/
-│   │   ├── KanbanBoard.tsx
-│   │   ├── KanbanColumn.tsx
-│   │   └── KanbanCard.tsx
-│   ├── services/
-│   │   └── kanban.ts   # VRP сервис
-│   └── models/
-│       └── kanban.ts   # Типы
-└── ...
-```
-
----
-
-### `vira generate <type> <name>` — Генерация кода
-
-Генерирует файлы для компонентов, сервисов, страниц, моделей и роутов.
-
-**Алиас:** `vira g`
-
-**Типы:**
-- `component` / `comp` — React компонент
-- `service` — Сервис (DI)
-- `page` — Страница
-- `model` — Модель с валидацией
-- `route` — Роут
-- `test` — Тест для компонента, сервиса или страницы
-
-**Опции:**
-- `-d, --dir <directory>` — Директория для вывода (по умолчанию: `src`)
-- `-i, --interactive` — Интерактивный режим (для компонентов и сервисов - выбор props, VRP, UI)
-- `--vrp` — Явно использовать Vira Reactive Protocol (VRP)
-- `--no-vrp` — Явно не использовать VRP
-
-**Примеры:**
-```bash
-vira generate component Button
-vira g comp UserCard
-
-# Интерактивная генерация компонента с выбором props
-vira generate component Button --interactive
-
-# Явное использование VRP (без интерактивного режима)
-vira generate component Button --vrp
-
-# Явное указание не использовать VRP
-vira generate component Button --no-vrp
-
-# Комбинация: интерактивный режим с принудительным VRP
-vira generate component Button --interactive --vrp
-
-# Генерация сервиса
-vira generate service User
-vira g service Product
-
-# Генерация страницы
-vira generate page Dashboard
-vira g page Profile
-
-# Генерация модели
-vira generate model User
-vira g model Product
-
-# Генерация роута
-vira generate route users
-vira g route products
-
-# Генерация теста
-vira generate test Button
-vira g test UserService
-
-# С указанием директории
-vira generate component Button --dir src/components
-```
-
-**Сгенерированные файлы:**
-
-#### Component
-```tsx
-// src/components/Button.tsx
-import { createElement } from '@vira-ui/core';
-import type { ViraComponentProps } from '@vira-ui/core';
-
-export interface ButtonProps extends ViraComponentProps {
-  // Add your props here
-  // При использовании --interactive здесь будут автоматически добавлены props
-}
-
-export function Button(props: ButtonProps) {
-  return createElement('div', { className: 'button' },
-    // Add your content here
-  );
-}
-```
-
-**Интерактивная генерация компонента:**
-```bash
-vira generate component Button --interactive
-```
-
-Интерактивный режим позволяет:
-- ✅ Выбрать использование **Vira Reactive Protocol (VRP)** для state management
-- ✅ Настроить VRP channel и state type
-- ✅ Интерактивно добавить props с выбором типов
-- ✅ Выбрать использование **Vira UI** компонентов (@vira-ui/ui)
-- ✅ Автоматически сгенерировать правильную структуру компонента
-
-**Пример интерактивной генерации с VRP:**
-```bash
-vira generate component TaskCard --interactive
-# → Использовать VRP? Yes
-# → Channel: task:123
-# → State type: TaskState
-# → Использовать Vira UI? Yes
-```
-
-Результат будет включать:
-- `useViraState` hook для синхронизации состояния
-- Интерфейс состояния (`TaskState`)
-- Интеграцию с Vira UI компонентами
-- Готовую структуру для работы с VRP
-
-> **Примечание:** `createElement` и некоторые экспериментальные функции могут изменяться в будущих версиях.
-
-#### Service
-```tsx
-// src/services/UserService.ts
-import { createViraService, signal } from '@vira-ui/core';
-
-export const UserService = createViraService('user', () => {
-  const data = signal([]);
-  const loading = signal(false);
-  const error = signal<string | null>(null);
-
-  const fetch = async () => {
-    loading.set(true);
-    try {
-      // Add your logic here
-      // const result = await api.get('/user');
-      // data.set(result);
-    } catch (e) {
-      error.set(e instanceof Error ? e.message : 'Unknown error');
-    } finally {
-      loading.set(false);
-    }
-  };
-
-  return {
-    data,
-    loading,
-    error,
-    fetch,
-  };
-});
-```
-
-**VRP-based Service (при интерактивной генерации с выбором VRP):**
-```tsx
-// src/services/UserService.ts
-import { createService, useService } from '@vira-ui/core';
-import { useViraState } from '@vira-ui/react';
-
-export interface UserState {
-  id?: string;
-  // Add your state fields here
-}
-
-// Business logic service
-createService('user', () => ({
-  processData(data: UserState | null): any {
-    // Add processing logic
-    return data;
-  },
-}));
-
-// VRP hook
-export function useUser(id?: string) {
-  const channel = id ? `user:${id}` : 'user';
-  const { data, sendEvent, sendUpdate, sendDiff } = useViraState<UserState>(channel, null);
-  const userService = useService('user');
-
-  return {
-    data,
-    update(updates: Partial<UserState>) {
-      sendDiff(updates);
-    },
-    sendEvent(eventName: string, payload: any) {
-      sendEvent(eventName, payload);
-    },
-  };
-}
-```
-
-#### Page
-```tsx
-// src/pages/DashboardPage.tsx
-import { createElement } from '@vira-ui/core';
-
-export function DashboardPage() {
-  return createElement('div', { className: 'dashboard-page' },
-    createElement('h1', null, 'Dashboard'),
-    // Add your content here
-  );
-}
-```
-
-#### Model
-```tsx
-// src/models/User.ts
-import { defineModel } from '@vira-ui/core';
-
-export const UserModel = defineModel({
-  // Add your fields here
-  id: {
-    type: 'string',
-    required: true,
-  },
-});
-```
-
-#### Route
-```tsx
-// src/routes/users.ts
-import { reactiveRoute } from '@vira-ui/core';
-import { UsersPage } from '../pages/UsersPage';
-
-export const usersRoute = reactiveRoute({
-  path: '/users',
-  component: UsersPage,
-});
-```
-
-#### Test
-```tsx
-// src/components/Button.test.tsx
-import React from 'react';
-import { render } from '@testing-library/react';
-import { Button } from './Button';
-import type { ButtonProps } from './Button';
-
-describe('Button', () => {
-  it('renders correctly', () => {
-    const props: ButtonProps = {
-      // Add test props here
-    };
-    const { container } = render(React.createElement(Button, props));
-    expect(container).toBeTruthy();
-  });
-});
-```
-
----
-
-### `vira make <type> <name>` — Backend scaffolding (Go)
-
-Генерирует Go-код для backend разработки.
-
-**Типы:**
-- `handler` — HTTP handler
-- `model` — Go модель (struct)
-- `migration` — SQL миграция (up/down)
-- `event` — Event handler
-- `crud` — CRUD handlers (List, Get, Create, Update, Delete)
-
-**Опции:**
-- `-d, --dir <directory>` — Целевая директория
-- `-m, --model <model>` — Имя модели (для crud)
-
-**Примеры:**
-
-```bash
-# Генерация HTTP handler
-vira make handler user
-# Создаёт: backend/internal/handlers/user.go
-
-# Генерация модели
-vira make model User
-# Создаёт: backend/internal/models/User.go
-
-# Генерация миграции
-vira make migration create-users
-# Создаёт: migrations/20240101120000_create-users.up.sql
-#          migrations/20240101120000_create-users.down.sql
-
-# Генерация event handler
-vira make event user.created
-# Создаёт: backend/internal/events/user_created.go
-#          backend/internal/events/registry_user_created.go
-
-# Генерация CRUD handlers
-vira make crud user
-# Создаёт: backend/internal/handlers/user_crud.go
-#          (ListUser, GetUser, CreateUser, UpdateUser, DeleteUser)
-
-vira make crud product --model Product
-# Создаёт CRUD handlers с указанной моделью
-```
-
-**Сгенерированные файлы:**
-
-#### Handler
-```go
-// backend/internal/handlers/user.go
-package handlers
-
-import (
-  "encoding/json"
-  "net/http"
-)
-
-type UserResponse struct {
-  Message string `json:"message"`
-}
-
-// User handles GET /user
-func User(w http.ResponseWriter, r *http.Request) {
-  w.Header().Set("Content-Type", "application/json")
-  _ = json.NewEncoder(w).Encode(UserResponse{
-    Message: "User handler ok",
-  })
-}
-```
-
-#### Model
-```go
-// backend/internal/models/User.go
-package models
-
-import "time"
-
-type User struct {
-  ID        string    `db:"id"`
-  CreatedAt time.Time `db:"created_at"`
-  UpdatedAt time.Time `db:"updated_at"`
-}
-```
-
-#### Migration
-```sql
--- migrations/20240101120000_create-users.up.sql
--- +goose Up
--- TODO: add migration SQL here
-
--- migrations/20240101120000_create-users.down.sql
--- +goose Down
--- TODO: rollback SQL here
-```
-
-#### Event Handler
-```go
-// backend/internal/events/user_created.go
-package events
-
-import (
-  "context"
-  "encoding/json"
-  "github.com/gorilla/websocket"
-)
-
-// UserCreated handles event: user.created
-func UserCreated(ctx context.Context, hub EventEmitter, conn *websocket.Conn, msg WSMessage) {
-  var payload map[string]any
-  if len(msg.Data) > 0 {
-    _ = json.Unmarshal(msg.Data, &payload)
-  }
-
-  // TODO: implement domain logic here
-  // Example: hub.Emit(ChannelCustom("demo", "echo"), payload)
-}
-
-func init() {
-  Register("user.created", UserCreated)
-}
-
-// backend/internal/events/registry_user_created.go
-package events
-
-func init() {
-  Register("user.created", UserCreated)
-}
-```
-
-#### CRUD Handler
-```go
-// backend/internal/handlers/user_crud.go
-package handlers
-
-import (
-  "encoding/json"
-  "net/http"
-  "github.com/gorilla/mux"
-)
-
-// ListUser handles GET /user
-func ListUser(w http.ResponseWriter, r *http.Request) {
-  // Implementation
-}
-
-// GetUser handles GET /user/{id}
-func GetUser(w http.ResponseWriter, r *http.Request) {
-  // Implementation
-}
-
-// CreateUser handles POST /user
-func CreateUser(w http.ResponseWriter, r *http.Request) {
-  // Implementation
-}
-
-// UpdateUser handles PUT /user/{id}
-func UpdateUser(w http.ResponseWriter, r *http.Request) {
-  // Implementation
-}
-
-// DeleteUser handles DELETE /user/{id}
-func DeleteUser(w http.ResponseWriter, r *http.Request) {
-  // Implementation
-}
-```
-
----
-
-### `vira sync` — Синхронизация типов
-
-Синхронизирует TypeScript типы из Go структур.
-
-**Опции:**
-- `--types` — Синхронизировать TypeScript типы (по умолчанию: `true`)
-- `--backend <path>` — Путь к Go файлу (по умолчанию: `backend/internal/types/types.go`)
-- `--frontend <path>` — Путь для TypeScript типов (по умолчанию: `frontend/src/vira-types.ts`)
-- `--ui <path>` — Путь для TypeScript типов UI (по умолчанию: `ui/src/vira-types.ts`)
-- `-w, --watch` — Watch mode: автоматическая синхронизация при изменениях (в разработке)
-
-**Пример:**
-```bash
-vira sync --types
-
-# С указанием путей
-vira sync --backend backend/internal/types/types.go \
-         --frontend frontend/src/types/vira.ts \
-         --ui ui/src/types/vira.ts
-```
-
-**Что делает:**
-1. Парсит Go структуры
-2. Конвертирует Go типы в TypeScript
-3. Генерирует TypeScript файлы с типами
-4. Создаёт helper функции для каналов VRP
-
-**Пример Go структуры:**
-
-```go
-// backend/internal/types/types.go
-package types
-
-type User struct {
-  ID    string `json:"id"`
-  Name  string `json:"name"`
-  Email string `json:"email"`
-}
-
-type Task struct {
-  ID        string `json:"id"`
-  Title     string `json:"title"`
-  Completed bool   `json:"completed"`
-}
-```
-
-**Сгенерированный TypeScript:**
-
-```typescript
-// frontend/src/vira-types.ts
-// Auto-generated by vira sync --types. Do not edit manually.
-
-export type ViraMessageType =
-  | 'handshake' | 'ack' | 'sub' | 'sub_ack' | 'unsub' | 'unsub_ack'
-  | 'update' | 'event' | 'diff' | 'ping' | 'pong' | 'error';
-
-export enum ViraChannelEnum {
-  User = 'user',
-  Task = 'task',
-  Notifications = 'notifications',
-  Demo = 'demo',
-}
-
-export type ViraChannel =
-  | `${ViraChannelEnum.User}:${string}`
-  | `${ViraChannelEnum.Task}:${string}`
-  | `${ViraChannelEnum.Notifications}:${string}`
-  | ViraChannelEnum.Demo
-  | string;
-
-export interface ViraDataMap {
-  User: User;
-  Task: Task;
-}
-
-export type ViraAnyData = ViraDataMap[keyof ViraDataMap];
-
-export interface User {
-  id: string;
-  name: string;
-  email: string;
-}
-
-export interface Task {
-  id: string;
-  title: string;
-  completed: boolean;
-}
-
-// ... helper functions для каналов
-```
-
----
-
-### `vira proto` — VRP Protocol утилиты
-
-Работа с Vira Reactive Protocol (VRP).
-
-> **Примечание:** Некоторые функции VRP находятся в экспериментальной стадии в альфа-версиях.
-
-**Подкоманды:**
-
-#### `vira proto validate`
-
-Валидирует схему VRP протокола и проверяет типы.
-
-**Опции:**
-- `--file <path>` — Путь к Go файлу с типами (по умолчанию: `backend/internal/types/types.go`)
-
-**Примеры:**
-```bash
-# Валидация с файлом по умолчанию
-vira proto validate
-
-# Валидация с указанным файлом
-vira proto validate --file backend/internal/types/models.go
-```
-
-**Что проверяется:**
-- Наличие и корректность Go структур
-- Соответствие структур требованиям VRP
-- Наличие необходимых полей для каналов
-
-#### `vira proto generate`
-
-Генерирует документацию по каналам VRP и схемы протокола.
-
-**Опции:**
-- `--file <path>` — Путь к Go файлу с типами (по умолчанию: `backend/internal/types/types.go`)
-- `--output <path>` — Директория для вывода (по умолчанию: `docs`)
-
-**Примеры:**
-```bash
-# Генерация документации
-vira proto generate
-
-# С указанием путей
-vira proto generate --file backend/internal/types/types.go --output docs/vrp
-```
-
-**Что генерируется:**
-- `VRP_CHANNELS.md` — Документация по всем доступным каналам
-- Описание типов данных для каждого канала
-- Примеры использования с `useViraState`
-
----
-
-### `vira doc` — Генерация документации
-
-Генерирует документацию CLI команд в `docs/cli.md`.
-
-```bash
-vira doc
-```
-
-### `vira validate` — Валидация проекта
-
-Проверяет структуру проекта и наличие необходимых файлов.
-
-```bash
-vira validate
-```
-
-**Что проверяется:**
-- Наличие обязательных файлов (`package.json`, `vite.config.ts`, и т.д.)
-- Структура директорий
-- Конфигурационные файлы
-
----
-
-## 🎨 Примеры
-
-### Создание Fullstack проекта
-
-```bash
-# Создание проекта
-vira create my-crm --template fullstack
-
-cd my-crm
-
-# Frontend: генерация компонентов
-cd frontend
-vira generate component ClientCard
-vira generate service Client
-vira generate page Clients
-
-# Backend: генерация handlers
-cd ../backend
-vira make handler client
-vira make model Client
-vira make migration create-clients
-
-# Синхронизация типов
-cd ..
-vira sync --types
-
-# Запуск
-cd frontend && npm install && npm run dev
-cd ../backend && go mod tidy && go run ./cmd/api
-```
-
-### Синхронизация типов
-
-```bash
-# Создание Kanban reference app
-vira create kanban-app --template kanban
-
-cd kanban-app
-
-# Генерация дополнительных компонентов
-vira generate component TaskCard
-vira generate service Task
-
-# Backend: генерация event handlers
-cd ../backend
-vira make event kanban.card.create
-vira make event kanban.card.move
-vira make event kanban.card.delete
-
-# Запуск
-cd .. && npm install && npm run dev
-```
-
-### Пример 3: Работа с миграциями
-
-```bash
-# Создание миграции
-vira make migration create-users
-
-# Редактирование миграции
-# migrations/20240101120000_create-users.up.sql
-CREATE TABLE users (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  name VARCHAR(255) NOT NULL,
-  email VARCHAR(255) UNIQUE NOT NULL,
-  created_at TIMESTAMP DEFAULT NOW()
-);
-
-# migrations/20240101120000_create-users.down.sql
-DROP TABLE IF EXISTS users;
-```
-
-### Пример 4: Синхронизация типов
-
-```bash
-# 1. Определяем Go структуры
-# backend/internal/types/types.go
-type Product struct {
-  ID    string `json:"id"`
-  Name  string `json:"name"`
-  Price int64  `json:"price"`
-}
-```
-
-# 2. Синхронизируем типы
-vira sync --types
-```
-
-# 3. Используем в TypeScript
-# frontend/src/components/ProductCard.tsx
-import type { Product } from '../vira-types';
-
-export function ProductCard({ product }: { product: Product }) {
-  return <div>{product.name} - ${product.price}</div>;
-}
-```
-
----
-
-## ❓ FAQ
-
-**Q: Можно ли использовать CLI без глобальной установки?**  
-A: Да! Используйте `npx @vira-ui/cli`.
-
-**Q: Можно ли использовать CLI в существующем проекте?**  
-A: Да! Команды `generate` и `make` работают в любом проекте.
-
-**Q: Как синхронизировать типы из нескольких Go файлов?**  
-A: Объедините структуры в один файл или используйте несколько вызовов `vira sync` с разными путями.
-
-**Q: Как работает синхронизация типов?**  
-A: CLI парсит Go структуры, конвертирует типы в TypeScript и генерирует файлы с типами и helper функциями.
-
-**Q: Поддерживаются ли другие языки backend?**  
-A: Сейчас поддерживается только Go. Поддержка других языков планируется в будущих версиях.
-
----
-
-## 🔧 Разработка CLI
-
-```bash
-# Клонирование и установка
-git clone https://github.com/skrolikov/vira-cli.git
-cd vira-cli
-npm install
-
-# Сборка
-npm run build
-
-# Локальное использование
-npm link
-vira create test-app
-```
-
-## ✨ Что нового в v1.0.1
-
-### Улучшенная генерация компонентов
-- ✅ **Интерактивный режим** с опцией использования VRP
-- ✅ **Интеграция с Vira UI** компонентами
-- ✅ **Автоматическая генерация** VRP-enabled компонентов
-- ✅ **Умный выбор props** с интерактивным добавлением типов
-
-### Улучшенная генерация сервисов
-- ✅ **Поддержка VRP** для сервисов
-- ✅ **Генерация hooks** с `useViraState`
-- ✅ **Интеграция с DI container**
-
-### VRP Protocol утилиты
-- ✅ **Реальная валидация** Go структур
-- ✅ **Генерация документации** по каналам
-- ✅ **Автоматическое определение** доступных каналов
-
-### Новые команды
-- ✅ `vira init` — инициализация проекта в существующей директории
-- ✅ `vira generate test` — генерация тестов
-- ✅ `vira make crud` — генерация CRUD handlers
-- ✅ `vira validate` — валидация структуры проекта
-
-## 🛣️ Roadmap
-
-### v1.1 (В разработке)
-- [ ] Watch mode для `vira sync`
-- [ ] Поддержка других шаблонов (Vue, Svelte)
-- [ ] Генерация Storybook историй
-- [ ] Плагины для расширения функциональности
-
-### v1.2 (Планируется)
-- [ ] Шаблоны для микросервисов
-- [ ] Интеграция с CI/CD
-- [ ] Генерация OpenAPI спецификаций
-- [ ] Автоматическая генерация событий из схем
----
-
-## 📄 License
-
-MIT
-
----
-
-## 🤝 Contributing
-
-Мы приветствуем вклад! Пожалуйста, прочитайте [CONTRIBUTING.md](../../CONTRIBUTING.md) для деталей.
-
----
-
-## 📞 Support
-
-- **GitHub Issues**: [Создать issue](https://github.com/skrolikov/vira-cli/issues)
-- **Discussions**: [Обсуждения](https://github.com/skrolikov/vira-cli/discussions)
-
----
-
-<div align="center">
-
-**Сделано с ❤️ командой Vira**
-
-[GitHub](https://github.com/skrolikov/vira-cli) • [Документация](https://vira.dev/cli) • [Примеры](https://vira.dev/examples)
-
-</div>
+# @vira-ui/cli
+
+CLI инструмент для генерации проектов и кода на основе Vira Framework.
+
+## 📦 Установка
+
+```bash
+npm install -g @vira-ui/cli
+```
+
+Или используйте через `npx`:
+
+```bash
+npx @vira-ui/cli create my-project
+```
+
+## 🚀 Быстрый старт
+
+### Создание нового проекта
+
+```bash
+# Интерактивный режим
+vira create my-project
+
+# С указанием шаблона
+vira create my-project --template frontend
+vira create my-project --template fullstack
+vira create my-project --template kanban
+```
+
+### Инициализация в текущей директории
+
+```bash
+vira init
+vira init --template frontend
+```
+
+## 📚 Команды
+
+### Создание проектов
+
+#### `vira create <name>`
+
+Создает новый проект в указанной директории.
+
+**Опции:**
+- `-t, --template <template>` - Шаблон проекта (`frontend`, `fullstack`, `kanban`)
+
+**Примеры:**
+```bash
+vira create my-app
+vira create my-app --template fullstack
+```
+
+#### `vira init`
+
+Инициализирует проект в текущей директории.
+
+**Опции:**
+- `-t, --template <template>` - Шаблон проекта
+
+**Примеры:**
+```bash
+vira init
+vira init --template frontend
+```
+
+### Генерация кода
+
+#### `vira generate <type> <name>`
+
+Генерирует компоненты, сервисы, страницы и другие артефакты.
+
+**Типы:**
+- `component` / `comp` - React компонент
+- `service` - Сервис с DI
+- `page` - Страница
+- `model` - Модель данных
+- `route` - Роут
+- `test` - Тест
+
+**Опции:**
+- `-d, --dir <directory>` - Директория для вывода (по умолчанию: `src`)
+- `-i, --interactive` - Интерактивный режим
+- `--vrp` - Использовать Vira Reactive Protocol
+- `--no-vrp` - Не использовать VRP
+
+**Примеры:**
+```bash
+# Компонент
+vira generate component Button
+vira generate component UserCard --interactive
+vira generate component TaskList --vrp
+
+# Сервис
+vira generate service user
+vira generate service task --vrp --interactive
+
+# Страница
+vira generate page Dashboard
+vira generate page Users --dir src/pages
+
+# Модель
+vira generate model User
+vira generate model Product --dir src/models
+
+# Роут
+vira generate route users
+vira generate route dashboard --dir src/routes
+
+# Тест
+vira generate test Button
+vira generate test UserService
+```
+
+### Backend scaffolding (Go)
+
+#### `vira make handler <name>`
+
+Создает Go HTTP handler.
+
+**Опции:**
+- `-d, --dir <directory>` - Целевая директория
+
+**Пример:**
+```bash
+vira make handler user
+vira make handler product --dir backend/internal/handlers
+```
+
+#### `vira make migration <name>`
+
+Создает SQL миграцию (up/down).
+
+**Опции:**
+- `-d, --dir <directory>` - Директория миграций (по умолчанию: `migrations`)
+
+**Пример:**
+```bash
+vira make migration create-users
+vira make migration add-email-to-users --dir backend/migrations
+```
+
+#### `vira make event <name>`
+
+Создает Go event handler stub.
+
+**Опции:**
+- `-d, --dir <directory>` - Целевая директория
+
+**Пример:**
+```bash
+vira make event user.created
+vira make event task.updated --dir backend/internal/events
+```
+
+#### `vira make model <name>`
+
+Создает Go model struct.
+
+**Опции:**
+- `-d, --dir <directory>` - Целевая директория
+- `-f, --fields <fields>` - Поля через запятую (например: `name:string,email:string`)
+
+**Примеры:**
+```bash
+vira make model User
+vira make model Product --fields "name:string,price:number,description:string"
+vira make model Client --dir backend/internal/models
+```
+
+#### `vira make crud <name>`
+
+Создает CRUD handlers для ресурса.
+
+**Опции:**
+- `-d, --dir <directory>` - Целевая директория
+- `-m, --model <model>` - Имя модели (по умолчанию: капитализированное имя ресурса)
+
+**Пример:**
+```bash
+vira make crud user
+vira make crud product --model Product
+```
+
+### Работа с базой данных
+
+#### `vira db migrate`
+
+Выполняет миграции базы данных.
+
+**Опции:**
+- `-d, --dir <directory>` - Директория миграций
+- `--db-url <url>` - URL подключения к БД
+- `--driver <driver>` - Драйвер БД (`postgres`, `mysql`, `sqlite3`)
+
+**Пример:**
+```bash
+vira db migrate
+vira db migrate --db-url postgres://user:pass@localhost/dbname
+vira db migrate --driver mysql
+```
+
+#### `vira db rollback`
+
+Откатывает последнюю миграцию.
+
+**Пример:**
+```bash
+vira db rollback
+vira db rollback --db-url postgres://user:pass@localhost/dbname
+```
+
+#### `vira db status`
+
+Показывает статус миграций.
+
+**Пример:**
+```bash
+vira db status
+```
+
+### VRP (Vira Reactive Protocol)
+
+#### `vira proto validate`
+
+Валидирует схему VRP протокола.
+
+**Опции:**
+- `--file <path>` - Путь к файлу типов
+
+**Пример:**
+```bash
+vira proto validate
+vira proto validate --file backend/internal/types/types.go
+```
+
+#### `vira proto generate`
+
+Генерирует документацию по VRP каналам.
+
+**Опции:**
+- `--file <path>` - Путь к файлу типов
+- `--output <path>` - Директория для вывода
+
+**Пример:**
+```bash
+vira proto generate
+vira proto generate --output docs
+```
+
+### Синхронизация типов
+
+#### `vira sync`
+
+Синхронизирует TypeScript типы из Go structs.
+
+**Опции:**
+- `--types` - Синхронизировать типы (по умолчанию: true)
+- `--backend <path>` - Путь к Go файлу типов
+- `--from-models` - Генерировать из директории моделей
+- `--models <path>` - Путь к директории моделей
+- `--frontend <path>` - Путь для вывода TS типов (frontend)
+- `--ui <path>` - Путь для вывода TS типов (ui)
+- `-w, --watch` - Watch режим (автоматическая синхронизация)
+
+**Примеры:**
+```bash
+# Синхронизация из types.go
+vira sync --types
+
+# Синхронизация из директории моделей
+vira sync --types --from-models
+
+# Watch режим
+vira sync --types --watch
+```
+
+### Валидация проекта
+
+#### `vira validate`
+
+Валидирует структуру проекта и конфигурацию.
+
+**Пример:**
+```bash
+vira validate
+```
+
+### Генерация документации
+
+#### `vira doc`
+
+Генерирует документацию CLI команд.
+
+**Пример:**
+```bash
+vira doc
+```
+
+## 📋 Шаблоны проектов
+
+### Frontend
+
+React + Vite + Vira UI проект:
+
+```bash
+vira create my-app --template frontend
+```
+
+**Структура:**
+```
+my-app/
+├── src/
+│   ├── components/
+│   ├── services/
+│   ├── pages/
+│   ├── models/
+│   └── main.tsx
+├── package.json
+├── vite.config.ts
+└── tsconfig.json
+```
+
+### Fullstack
+
+Frontend + Go Backend + Docker:
+
+```bash
+vira create my-app --template fullstack
+```
+
+**Структура:**
+```
+my-app/
+├── frontend/        # React приложение
+├── backend/         # Go backend
+├── ui/              # UI пакет
+├── migrations/      # SQL миграции
+└── deploy/          # Docker compose файлы
+```
+
+### Kanban
+
+Reference приложение с VRP:
+
+```bash
+vira create kanban-app --template kanban
+```
+
+Демонстрирует использование Vira Reactive Protocol для real-time синхронизации.
+
+## 🎯 Примеры использования
+
+### Создание компонента с VRP
+
+```bash
+vira generate component TaskCard --vrp --interactive
+```
+
+Интерактивно создаст компонент с интеграцией VRP.
+
+### Создание сервиса
+
+```bash
+vira generate service user --vrp
+```
+
+Создаст сервис с поддержкой VRP для синхронизации состояния.
+
+### Создание CRUD API
+
+```bash
+# Backend: Go handlers
+vira make crud user
+
+# Frontend: Service
+vira generate service user --vrp
+
+# Frontend: Page
+vira generate page Users
+```
+
+### Синхронизация типов
+
+```bash
+# После изменения Go моделей
+vira sync --types --from-models
+
+# TypeScript типы автоматически обновятся в frontend/src/vira-types.ts
+```
+
+## 🔧 Конфигурация
+
+CLI автоматически определяет структуру проекта. Для кастомизации можно использовать:
+
+- `.vira.json` - Конфигурационный файл (планируется)
+- Переменные окружения для путей
+- Опции командной строки
+
+## 📖 Примеры генерации
+
+### Компонент с props
+
+```bash
+vira generate component Button --interactive
+```
+
+Интерактивно спросит:
+- Нужны ли props?
+- Какие props?
+- Использовать VRP?
+- Использовать Vira UI?
+
+### Сервис с VRP
+
+```bash
+vira generate service task --vrp
+```
+
+Создаст сервис с:
+- VRP интеграцией
+- CRUD методами
+- Bulk операциями
+- Автоматической синхронизацией
+
+## 🐛 Troubleshooting
+
+### Проблемы с миграциями
+
+Если миграции не выполняются:
+
+1. Проверьте `DATABASE_URL` в `.env`
+2. Убедитесь, что `goose` установлен: `go install github.com/pressly/goose/v3/cmd/goose@latest`
+3. Проверьте права доступа к БД
+
+### Проблемы с синхронизацией типов
+
+Если типы не синхронизируются:
+
+1. Проверьте путь к Go файлам: `vira sync --backend backend/internal/types/types.go`
+2. Используйте `--from-models` для генерации из директории моделей
+3. Проверьте формат Go structs
+
+## 📄 License
+
+MIT
+
+## 🔗 Связанные пакеты
+
+- [`@vira-ui/core`](../core/README.md) - Базовый фреймворк
+- [`@vira-ui/ui`](../ui/README.md) - UI компоненты
+- [`@vira-ui/react`](../react/README.md) - React хуки для VRP
+