kodu 1.1.2 → 1.1.4

package/docs/plan.md

@@ -0,0 +1,92 @@
+### 1. Выбор "Fresh & Modern" стека (Библиотеки)
+
+Вместо старых монстров берем инструменты экосистемы UnJS, Sindre Sorhus и современные стандарты:
+
+*   **File System:** `node:fs/promises` (нативный, мощный) + **`tinyglobby`** (вместо тяжелого `globby` или `fast-glob`, супер-быстрый паттерн-матчинг).
+*   **CLI UI:** **`@inquirer/prompts`** (новый модульный инквайрер, тянет меньше зависимостей) + **`picocolors`** (в 10 раз быстрее и меньше `chalk`).
+*   **Spinners:** **`yocto-spinner`** (современная, легкая замена `ora`).
+*   **Process Execution:** **`execa`** (лучшая обертка над child_process для работы с Git).
+*   **Validation:** **`zod`** (стандарт де-факто).
+*   **Clipboard:** **`clipboardy`** (надежный кроссплатформ, альтернатив мало).
+*   **AI/HTTP:** **`mastra`** (как договорились) + нативный `fetch`.
+
+---
+
+### 2. Архитектура NestJS (Module Map)
+
+Разбиваем монолит на функциональные домены.
+
+```text
+src/
+├── app.module.ts            # Корневой модуль (оркестратор)
+│
+├── core/                    # Global Modules (инфраструктура)
+│   ├── config/              # ConfigModule (Zod + cosmiconfig)
+│   ├── file-system/         # FsModule (tinyglobby, node:fs обертки)
+│   └── ui/                  # UiModule (Спиннеры, цвета, промпты)
+│
+├── shared/                  # Общая бизнес-логика
+│   ├── tokenizer/           # TokenizerModule (js-tiktoken)
+│   ├── git/                 # GitModule (execa обертки над git)
+│   └── ai/                  # AiModule (Mastra client setup)
+│
+└── commands/                # Feature Modules (команды)
+    ├── init/                # InitModule (kodu init)
+    ├── pack/                # PackModule (kodu pack)
+    ├── clean/               # CleanModule (kodu clean /w ts-morph)
+    ├── review/              # ReviewModule (kodu review)
+    └── commit/              # CommitModule (kodu commit)
+```
+
+---
+
+### 3. План разработки (Roadmap)
+
+Разбиваем на 4 спринта (фазы).
+
+#### Фаза 1: The Foundation (Фундамент)
+*Цель: Приложение запускается, читает конфиг и умеет работать с файлами.*
+
+1.  **Core Setup:**
+    *   Настройка `ConfigModule`: чтение `kodu.json`, валидация через `Zod`.
+    *   Настройка `UiModule`: сделать красивые хелперы для вывода (success, error, warning).
+2.  **Command: Init:**
+    *   Реализация `InitCommand`.
+    *   Интерактивный опросник через `@inquirer/prompts`.
+    *   Генерация дефолтного конфига.
+
+#### Фаза 2: The Packer & Tokenizer (Локальная магия)
+*Цель: Утилита полезна даже без интернета.*
+
+1.  **File System Logic:**
+    *   Интеграция `tinyglobby` для умного поиска файлов (учет `.gitignore` + `kodu.json`).
+2.  **Tokenizer:**
+    *   Сервис подсчета токенов на базе `js-tiktoken`.
+3.  **Command: Pack:**
+    *   Сборка контента.
+    *   Реализация флага `--copy` (буфер обмена).
+    *   Реализация Template Engine (простая подстановка шаблонов промптов).
+
+#### Фаза 3: The Cleaner (AST Engineering)
+*Цель: Умная очистка кода.*
+
+1.  **Clean Logic:**
+    *   Подключение `ts-morph`.
+    *   Реализация алгоритма обхода AST.
+    *   Реализация whitelist (System + Biome + User).
+    *   Особое внимание удалению JSX-комментариев `{/* ... */}`.
+2.  **Command: Clean:**
+    *   Интеграция логики в команду.
+    *   Добавление флага `--dry-run` (чтобы показать, что удалится, не удаляя).
+
+#### Фаза 4: AI Integration (Мозги)
+*Цель: Подключение Mastra и Git.*
+
+1.  **Git Integration:**
+    *   Сервис на `execa` для получения `git diff --staged`.
+2.  **Mastra Agent:**
+    *   Настройка агента в `AiModule`.
+3.  **Command: Review:**
+    *   Пайплайн: Git Diff -> Tokenizer Check -> Mastra -> Report.
+4.  **Command: Commit:**
+    *   Пайплайн: Git Diff -> Mastra -> Generate Msg -> Inquirer Confirm -> Git Commit.

package/docs/project_charter.md

@@ -0,0 +1,92 @@
+# 🚀 Project Charter: Kodu
+
+**Дата:** 24.01.2026
+**Тип проекта:** CLI Utility / Developer Tooling
+**Рабочее название:** Kodu
+
+## 1. Резюме проекта (Executive Summary)
+**Kodu** — это консольная утилита (CLI), предназначенная для оптимизации взаимодействия разработчиков с большими языковыми моделями (LLM).
+Утилита решает проблему ручной подготовки контекста (копирования кода), очистки файлов от мусора и выполнения рутинных операций (ревью, написание коммитов) с помощью AI.
+**Ключевая философия:** Высокий Developer Experience (DX), скорость работы и детерминированность критических операций.
+
+## 2. Цели и Метрики успеха
+1.  **Ускорение работы с AI:** Сократить время подготовки промпта с кодом с 2–5 минут до 5 секунд.
+2.  **Качество контекста:** Обеспечить передачу в AI только чистого, полезного кода без лишних комментариев, но с сохранением важной семантики.
+3.  **Интеграция:** Бесшовная работа в пайплайнах (CI/CD, Git Hooks).
+4.  **Расширяемость:** Архитектура, готовая к добавлению новых языков и команд.
+
+## 3. Технический стек (Technology Stack)
+Мы выбираем стек, обеспечивающий надежность, модульность и типизацию.
+
+*   **Runtime:** Node.js
+*   **Framework:** NestJS + **Nest Commander** (модульность, DI, удобство поддержки).
+*   **AI Orchestration:** **Mastra** (абстракция над провайдерами LLM, агенты).
+*   **Validation:** **Zod** (валидация конфигов и входных данных).
+*   **Code Analysis (AST):** **ts-morph** (безопасный парсинг и модификация TypeScript/JSX/TSX).
+*   **Token Counting:** **js-tiktoken** (точный подсчет токенов OpenAI).
+*   **Utils:** `globby` (файловая система), `inquirer` (интерактив), `chalk`/`ora` (UI).
+
+## 4. Функциональные требования (Scope)
+
+### 4.1. Core: Initialization & Config
+*   **Команда:** `kodu init`
+*   Генерация файла `kodu.json`.
+*   Настройка `.gitignore` и `.kodu/`.
+*   Валидация конфигурации через Zod при каждом запуске.
+
+### 4.2. The Packer (Сборщик контекста)
+*   **Команда:** `kodu pack [options]`
+*   Сборка файлов проекта в один текстовый файл или буфер обмена (`--copy`).
+*   Учет `.gitignore` и `ignorePatterns` из конфига.
+*   **Token Budgeting:** Всегда выводить количество токенов и примерную стоимость.
+*   **Prompt Templates:** Поддержка флага `--template <name>`, подстановка шаблонов из `.kodu/prompts/`.
+*   *Ограничение:* Отказ от "Smart Context" (разрешения импортов) ради универсальности.
+
+### 4.3. The Cleaner (Очистка кода)
+*   **Команда:** `kodu clean`
+*   Удаление комментариев из кода.
+*   **Алгоритм:** Строго детерминированный (без AI), на базе AST (`ts-morph`).
+*   **Поддержка:** `.ts`, `.js`, `.tsx`, `.jsx`.
+*   **Whitelist (Исключения):**
+    *   *System:* `@ts-ignore`, `eslint-disable`, `prettier-ignore`, `TODO`, `FIXME`.
+    *   *Biome:* Специальная поддержка `// biome-ignore ...`.
+    *   *User:* Настраиваемый список в `kodu.json` (например, `//!`).
+
+### 4.4. AI Features (Mastra Integration)
+*   **Команда:** `kodu review`
+    *   Анализ `git diff` через AI с режимами Security, Style, Bug hunting.
+    *   Поддержка CI/CD: `--ci` отключает спиннеры/буфер, `--output` сохраняет JSON/text, `--json` снимает структурированный отчет.
+    *   Команда выходит с `1`, когда AI находит проблемы в структурированном режиме.
+*   **Команда:** `kodu commit`
+    *   Генерация сообщения коммита на основе `staged` изменений с методикой Conventional Commits.
+    *   Выводит результат в `stdout`, поддерживает `--output` и `--ci`, сама не выполняет `git commit`.
+
+### Быстрый старт AI
+*   Установите ключ: `export OPENAI_API_KEY=<ключ>` (имя переменной настраивается через `llm.apiKeyEnv`).
+*   Ревью: `kodu review --mode bug|style|security [--json] [--ci] [--output review.json]`.
+*   Коммит: `kodu commit [--ci] [--output commit-message.txt]` (просто выводит сообщение).
+*   В git diff автоматически исключаются файлы из `packer.ignore` (например, lock-файлы и `dist/`).
+
+## 5. Границы проекта (Out of Scope for MVP)
+*   Поддержка языков, отличных от JS/TS (для команды `clean`). `pack` будет работать со всем текстом.
+*   AI-based удаление комментариев (слишком рискованно и медленно).
+*   Обфускация кода (секреты должны быть в `.env`).
+*   GUI версия.
+
+## 6. Конфигурация (`kodu.json`)
+Пример структуры, к которой мы стремимся:
+```json
+{
+  "$schema": "./node_modules/kodu/schema.json",
+  "llm": {
+    "provider": "openai",
+    "model": "gpt-4o"
+  },
+  "cleaner": {
+    "whitelist": ["//!"]
+  },
+  "packer": {
+    "ignore": ["*.lock", "coverage"]
+  }
+}
+```

package/docs/todo.md

@@ -0,0 +1,5 @@
+# ToDo
+
+- [ ] Сделать чтобы AI ключ был не обязательным при инициализации. Наш проект должен работать и без него (просто
+  функционал будет урезан)
+- [ ] Добавить JSON schema для конфига

package/knip.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://unpkg.com/knip@5/schema.json",
+  "entry": ["src/main.ts!"],
+  "project": ["src/**/*.ts!"],
+  "ignore": [],
+  "ignoreDependencies": ["source-map-support"],
+  "paths": {
+    "@/*": ["src/*"]
+  }
+}

package/kodu.json

@@ -0,0 +1,22 @@
+{
+  "llm": {
+    "provider": "openai",
+    "model": "gpt-4o"
+  },
+  "cleaner": {
+    "whitelist": ["//!"],
+    "keepJSDoc": true
+  },
+  "packer": {
+    "ignore": [
+      "package-lock.json",
+      "yarn.lock",
+      "pnpm-lock.yaml",
+      ".git",
+      ".kodu",
+      "node_modules",
+      "dist",
+      "coverage"
+    ]
+  }
+}

package/nest-cli.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/package.json

@@ -1,57 +1,57 @@
 {
   "name": "kodu",
-  "version": "1.1.2",
-  "description": "kodu — A lightning-fast CLI tool to bundle your codebase into a single context file for LLMs (ChatGPT, Claude, DeepSeek). Features smart prioritization, interactive history, and gitignore support.",
-  "type": "module",
+  "version": "1.1.4",
+  "private": false,
+  "license": "UNLICENSED",
   "bin": {
-    "kodu": "./dist/index.js"
+    "kodu": "dist/main.js"
   },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
   "scripts": {
     "________________ BUILD AND RUN ________________": "",
-    "dev": "bun run src/index.ts",
-    "build": "bun build ./src/index.ts --outfile=./dist/index.js --target=node --minify",
-    "prepublishOnly": "bun run build",
+    "build": "nest build && chmod +x dist/main.js",
+    "start:prod": "node dist/main.js",
+    "new:command": "nest g -c nest-commander-schematics command",
+    "new:question": "nest g -c nest-commander-schematics question",
     "________________ FORMAT AND LINT ________________": "",
     "lint": "biome check",
     "lint:fix": "biome check --write",
     "lint:fix:unsafe": "biome check --write --unsafe",
     "ts:check": "tsc --noEmit",
-    "check": "run-p ts:check lint"
+    "knip": "knip --production",
+    "check": "run-p ts:check lint:fix knip"
   },
-  "keywords": [
-    "cli",
-    "context",
-    "llm",
-    "ai",
-    "bundler"
-  ],
-  "author": "uxname",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/uxname/pp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/uxname/pp/issues"
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "@mastra/core": "^1.0.4",
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/core": "^11.0.1",
+    "clipboardy": "^5.0.2",
+    "execa": "^9.6.1",
+    "js-tiktoken": "^1.0.21",
+    "lilconfig": "^3.1.3",
+    "mastra": "^1.0.1",
+    "nest-commander": "^3.20.1",
+    "picocolors": "^1.1.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "source-map-support": "^0.5.21",
+    "tinyglobby": "^0.2.15",
+    "ts-morph": "^24.0.0",
+    "yocto-spinner": "^1.0.0",
+    "zod": "^4.3.6"
   },
-  "homepage": "https://github.com/uxname/pp#readme",
   "devDependencies": {
-    "@biomejs/biome": "^2.3.10",
-    "@types/bun": "latest",
-    "@types/strip-comments": "^2.0.4",
-    "npm-run-all": "^4.1.5"
-  },
-  "dependencies": {
-    "@types/prompts": "^2.4.9",
-    "commander": "^14.0.2",
-    "ignore": "^7.0.5",
-    "ora": "^9.0.0",
-    "prompts": "^2.4.2",
-    "strip-comments": "^2.0.1"
+    "@biomejs/biome": "^2.3.12",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/node": "^22.10.7",
+    "knip": "^5.82.1",
+    "nest-commander-schematics": "^3.2.0",
+    "npm-run-all": "^4.1.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3"
   }
 }

package/src/app.module.ts

@@ -0,0 +1,29 @@
+import { Module } from '@nestjs/common';
+import { CleanModule } from './commands/clean/clean.module';
+import { CommitModule } from './commands/commit/commit.module';
+import { InitModule } from './commands/init/init.module';
+import { PackModule } from './commands/pack/pack.module';
+import { ReviewModule } from './commands/review/review.module';
+import { ConfigModule } from './core/config/config.module';
+import { FsModule } from './core/file-system/fs.module';
+import { UiModule } from './core/ui/ui.module';
+import { AiModule } from './shared/ai/ai.module';
+import { GitModule } from './shared/git/git.module';
+import { TokenizerModule } from './shared/tokenizer/tokenizer.module';
+
+@Module({
+  imports: [
+    ConfigModule,
+    UiModule,
+    FsModule,
+    GitModule,
+    AiModule,
+    TokenizerModule,
+    InitModule,
+    PackModule,
+    CleanModule,
+    ReviewModule,
+    CommitModule,
+  ],
+})
+export class AppModule {}

package/src/commands/clean/clean.command.ts

@@ -0,0 +1,83 @@
+import { Command, CommandRunner, Option } from 'nest-commander';
+import { FsService } from '../../core/file-system/fs.service';
+import { UiService } from '../../core/ui/ui.service';
+import { CleanerService } from '../../shared/cleaner/cleaner.service';
+
+type CleanOptions = {
+  dryRun?: boolean;
+};
+
+@Command({ name: 'clean', description: 'Удалить комментарии из кода' })
+export class CleanCommand extends CommandRunner {
+  constructor(
+    private readonly ui: UiService,
+    private readonly fsService: FsService,
+    private readonly cleaner: CleanerService,
+  ) {
+    super();
+  }
+
+  @Option({
+    flags: '-d, --dry-run',
+    description: 'Показать, что будет удалено',
+  })
+  parseDryRun(): boolean {
+    return true;
+  }
+
+  async run(_inputs: string[], options: CleanOptions = {}): Promise<void> {
+    const spinner = this.ui
+      .createSpinner({
+        text: options.dryRun
+          ? 'Анализ комментариев...'
+          : 'Очистка комментариев...',
+      })
+      .start();
+
+    try {
+      const allFiles = await this.fsService.findProjectFiles();
+      const targets = allFiles.filter((file) =>
+        /\.(ts|tsx|js|jsx)$/i.test(file),
+      );
+
+      if (targets.length === 0) {
+        spinner.stop('Нет файлов для очистки.');
+        this.ui.log.warn('Нет файлов для очистки.');
+        return;
+      }
+
+      const summary = await this.cleaner.cleanFiles(targets, {
+        dryRun: options.dryRun,
+      });
+
+      spinner.success(options.dryRun ? 'Анализ завершен' : 'Очистка завершена');
+
+      if (options.dryRun) {
+        this.ui.log.info(
+          `Будет затронуто файлов: ${summary.filesChanged}, комментариев: ${summary.commentsRemoved}`,
+        );
+        summary.reports
+          .filter((report) => report.removed > 0)
+          .forEach((report) => {
+            const previews = report.previews
+              .map((item) => `"${item}"`)
+              .join(', ');
+            this.ui.log.info(
+              `- ${report.file} (${report.removed}): ${previews}`,
+            );
+          });
+        return;
+      }
+
+      this.ui.log.success(
+        `Очищено файлов: ${summary.filesChanged}, удалено комментариев: ${summary.commentsRemoved}`,
+      );
+    } catch (error) {
+      spinner.error('Ошибка при очистке');
+      const message =
+        error instanceof Error ? error.message : 'Неизвестная ошибка';
+      this.ui.log.error(message);
+      process.exitCode = 1;
+    }
+  }
+}

package/src/commands/clean/clean.module.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '../../core/config/config.module';
+import { FsModule } from '../../core/file-system/fs.module';
+import { UiModule } from '../../core/ui/ui.module';
+import { CleanerService } from '../../shared/cleaner/cleaner.service';
+import { CleanCommand } from './clean.command';
+
+@Module({
+  imports: [FsModule, UiModule, ConfigModule],
+  providers: [CleanCommand, CleanerService],
+})
+export class CleanModule {}

package/src/commands/commit/commit.command.ts

@@ -0,0 +1,120 @@
+import { writeFile } from 'node:fs/promises';
+import { Command, CommandRunner, Option } from 'nest-commander';
+import { UiService } from '../../core/ui/ui.service';
+import { AiService } from '../../shared/ai/ai.service';
+import { GitService } from '../../shared/git/git.service';
+
+type CommitOptions = {
+  ci?: boolean;
+  output?: string;
+};
+
+@Command({
+  name: 'commit',
+  description: 'Сгенерировать и применить сообщение коммита',
+})
+export class CommitCommand extends CommandRunner {
+  constructor(
+    private readonly ui: UiService,
+    private readonly git: GitService,
+    private readonly ai: AiService,
+  ) {
+    super();
+  }
+
+  @Option({ flags: '--ci', description: 'CI-режим: без спиннеров и диалогов' })
+  parseCi(): boolean {
+    return true;
+  }
+
+  @Option({
+    flags: '-o, --output <path>',
+    description: 'Сохранить сообщение в файл',
+  })
+  parseOutput(value: string): string {
+    return value;
+  }
+
+  async run(_inputs: string[], options: CommitOptions = {}): Promise<void> {
+    const ciMode = Boolean(options.ci);
+    const spinner = ciMode
+      ? undefined
+      : this.ui.createSpinner({ text: 'Собираю diff...' }).start();
+
+    const logProgress = (text: string): void => {
+      if (ciMode) {
+        return;
+      }
+      if (spinner) {
+        spinner.text = text;
+        return;
+      }
+      this.ui.log.info(text);
+    };
+
+    const finishProgress = (text: string): void => {
+      if (ciMode) {
+        return;
+      }
+      if (spinner) {
+        spinner.success(text);
+        return;
+      }
+      this.ui.log.success(text);
+    };
+
+    try {
+      await this.git.ensureRepo();
+
+      const hasStaged = await this.git.hasStagedChanges();
+      if (!hasStaged) {
+        if (spinner) {
+          spinner.stop('Нет застейдженных изменений');
+        } else {
+          this.ui.log.info('Нет застейдженных изменений');
+        }
+        this.ui.log.warn('Сначала выполните git add для нужных файлов.');
+        return;
+      }
+
+      const diff = await this.git.getStagedDiff();
+      if (!diff.trim()) {
+        if (spinner) {
+          spinner.stop('Diff пуст — возможно, всё исключено packer.ignore');
+        } else {
+          this.ui.log.info('Diff пуст — возможно, всё исключено packer.ignore');
+        }
+        this.ui.log.warn(
+          'Diff пустой: все изменения попали в исключения packer.ignore.',
+        );
+        return;
+      }
+
+      logProgress('Генерирую сообщение коммита...');
+      const commitMessage = await this.ai.generateCommitMessage(diff);
+
+      finishProgress('Сообщение готово');
+      if (!ciMode) {
+        this.ui.log.info(`Предложение: ${commitMessage}`);
+      }
+
+      console.log(commitMessage);
+      if (options.output) {
+        await writeFile(options.output, commitMessage, { encoding: 'utf8' });
+        if (!ciMode) {
+          this.ui.log.success(`Сообщение сохранено в ${options.output}`);
+        }
+      }
+    } catch (error) {
+      if (spinner) {
+        spinner.error('Ошибка при создании коммита');
+      } else {
+        this.ui.log.error('Ошибка при создании коммита');
+      }
+      const message =
+        error instanceof Error ? error.message : 'Неизвестная ошибка';
+      this.ui.log.error(message);
+      process.exitCode = 1;
+    }
+  }
+}

package/src/commands/commit/commit.module.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '../../core/config/config.module';
+import { UiModule } from '../../core/ui/ui.module';
+import { AiModule } from '../../shared/ai/ai.module';
+import { GitModule } from '../../shared/git/git.module';
+import { CommitCommand } from './commit.command';
+
+@Module({
+  imports: [ConfigModule, UiModule, GitModule, AiModule],
+  providers: [CommitCommand],
+})
+export class CommitModule {}