qwen-alpha 1.0.0

package/.eslintrc.js

@@ -0,0 +1,21 @@
+module.exports = {
+  env: {
+    node: true,
+    es2021: true,
+  },
+  extends: ['eslint:recommended'],
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  rules: {
+    'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+    'semi': ['error', 'always'],
+    'quotes': ['warn', 'single'],
+    'no-console': 'off',
+    'no-eval': 'error',
+    'eqeqeq': ['error', 'always'],
+    'curly': ['error', 'all'],
+  },
+  ignorePatterns: ['node_modules/', 'logs/', '*.log'],
+};

package/.nvmrc

@@ -0,0 +1 @@
+18

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "always"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JeBance
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PUBLISH.md

@@ -0,0 +1,252 @@
+# 🚀 Инструкция по публикации и запуску Qwen Alpha
+
+## ✅ Чек-лист перед публикацией
+
+- [ ] Все зависимости установлены (`npm install`)
+- [ ] Тесты проходят (`npm test`)
+- [ ] Линтинг проходит (`npm run lint`)
+- [ ] README.md актуален
+- [ ] Version в package.json обновлён
+
+---
+
+## 📦 Публикация на npm
+
+### 1. Логин в npm
+
+```bash
+npm login
+```
+
+Введите ваш логин, пароль и email.
+
+### 2. Проверка пакета перед публикацией
+
+```bash
+# Проверка package.json
+npm pkg get
+
+# Проверка файлов которые будут опубликованы
+npm pack --dry-run
+
+# Просмотр содержимого .tgz
+tar -tzf qwen-alpha-1.0.0.tgz
+```
+
+### 3. Публикация
+
+```bash
+# Публикация стабильной версии
+npm publish
+
+# Публикация beta версии (не затронет latest)
+npm publish --tag beta
+```
+
+### 4. Проверка публикации
+
+```bash
+# Проверка на npmjs.com
+npm view qwen-alpha
+
+# Или откройте https://www.npmjs.com/package/qwen-alpha
+```
+
+---
+
+## 🧪 Тестирование после публикации
+
+### 1. Глобальная установка
+
+```bash
+npm install -g qwen-alpha
+```
+
+### 2. Проверка CLI
+
+```bash
+qwen-alpha --version
+qwen-alpha --help
+```
+
+### 3. Инициализация хранилищ
+
+```bash
+qwen-alpha --init-only
+```
+
+Проверьте что создалась папка `~/.qwen-alpha/`.
+
+### 4. Запуск бота
+
+```bash
+qwen-alpha --token <YOUR_BOT_TOKEN>
+```
+
+---
+
+## 🔄 Обновление версии
+
+### SemVer (Semantic Versioning)
+
+```
+MAJOR.MINOR.PATCH
+  │     │     │
+  │     │     └─ обратно совместимые исправления
+  │     └─────── обратно совместимые новые функции
+  └───────────── ломающие изменения
+```
+
+### Команды для обновления версии
+
+```bash
+# Исправление багов (1.0.0 → 1.0.1)
+npm version patch
+
+# Новые функции (1.0.0 → 1.1.0)
+npm version minor
+
+# Ломающие изменения (1.0.0 → 2.0.0)
+npm version major
+
+# Pre-release версии (1.0.0 → 1.0.1-beta.0)
+npm version prerelease --preid=beta
+```
+
+После `npm version` автоматически обновится package.json и создастся git tag.
+
+### Публикация новой версии
+
+```bash
+# Push коммита и тега
+git push && git push --tags
+
+# Публикация на npm
+npm publish
+```
+
+---
+
+## 🐛 Устранение проблем
+
+### Ошибка "You cannot publish over the previously published versions"
+
+Обновите версию:
+
+```bash
+npm version patch
+npm publish
+```
+
+### Ошибка "npm ERR! 403 Forbidden"
+
+Проверьте что вы залогинены и являетесь владельцем пакета:
+
+```bash
+npm whoami
+npm owner ls qwen-alpha
+```
+
+### Ошибка "package.json name уже занят"
+
+Измените name в package.json на уникальное название.
+
+---
+
+## 📊 Статистика npm
+
+```bash
+# Просмотр информации о пакете
+npm view qwen-alpha
+
+# Все версии
+npm view qwen-alpha versions
+
+# Зависимости
+npm view qwen-alpha dependencies
+
+# Количество загрузок
+npm install -g npm-views
+npm-views qwen-alpha
+```
+
+---
+
+## 🔐 Безопасность
+
+### Перед публикацией проверьте:
+
+1. **Нет ли .env файлов в репозитории**
+   ```bash
+   git ls-files | grep .env
+   ```
+
+2. **Токен бота не в коде**
+   - Токен передаётся только через CLI `--token`
+   - Или через переменную окружения `BOT_TOKEN`
+
+3. **npm audit**
+   ```bash
+   npm audit
+   npm audit fix
+   ```
+
+---
+
+## 📝 Примеры использования
+
+### Базовый запуск
+
+```bash
+qwen-alpha --token 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
+```
+
+### С логированием
+
+```bash
+qwen-alpha --token <TOKEN> --log-level debug
+```
+
+### С whitelist пользователей
+
+```bash
+qwen-alpha --token <TOKEN> --allowed-users 123456789,987654321
+```
+
+### Через Docker (пример)
+
+```dockerfile
+FROM node:18-alpine
+RUN npm install -g qwen-alpha @qwen-code/qwen-code
+CMD ["qwen-alpha", "--token", "$BOT_TOKEN"]
+```
+
+---
+
+## 🎯 Следующие шаги после публикации
+
+1. **Добавить бота в Telegram**
+   - Откройте https://t.me/BotFather
+   - Создайте нового бота если ещё не создан
+   - Получите токен
+
+2. **Настроить бота**
+   - Установите аватар (логотип)
+   - Настройте description и about
+
+3. **Протестировать функционал**
+   - `/start` — приветствие
+   - `/help` — справка
+   - Отправить код на анализ
+
+4. **Добавить в группы** (опционально)
+   - Добавьте бота в группу
+   - Проверьте работу `/qwen` команд
+
+5. **Мониторинг**
+   - Следите за логами в `~/.qwen-alpha/logs/`
+   - Проверяйте `/admin stats`
+
+---
+
+**Удачи с публикацией! 🚀**

package/README.md

@@ -0,0 +1,282 @@
+# Qwen Alpha
+
+[![CI](https://github.com/JeBance/QwenAlpha/actions/workflows/ci.yml/badge.svg)](https://github.com/JeBance/QwenAlpha/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/qwen-alpha.svg)](https://www.npmjs.com/package/qwen-alpha)
+[![license](https://img.shields.io/npm/l/qwen-alpha.svg)](https://github.com/JeBance/QwenAlpha/blob/main/LICENSE)
+
+**Telegram бот для работы с Qwen Code** — AI-powered code review, генерация кода и анализ прямо в Telegram.
+
+---
+
+## 🚀 Быстрый старт
+
+### Установка
+
+```bash
+npm install -g qwen-alpha
+```
+
+### Требования
+
+- **Node.js** >= 18.0.0
+- **Qwen Code** (глобально): `npm install -g @qwen-code/qwen-code`
+- **Telegram Bot Token** (получите у [@BotFather](https://t.me/BotFather))
+
+### Запуск
+
+```bash
+qwen-alpha --token <YOUR_BOT_TOKEN>
+```
+
+Или через переменную окружения:
+
+```bash
+export BOT_TOKEN=<YOUR_BOT_TOKEN>
+qwen-alpha --token $BOT_TOKEN
+```
+
+---
+
+## 📋 Возможности
+
+### Для пользователей
+
+| Функция | Описание |
+|---------|----------|
+| **Code Review** | Анализ кода, поиск багов и уязвимостей |
+| **Генерация кода** | Создание кода по описанию |
+| **Объяснение кода** | Подробное объяснение сложных участков |
+| **Рефакторинг** | Улучшение читаемости и производительности |
+| **Работа с файлами** | Анализ файлов с кодом (до 2MB) |
+| **Контекст диалога** | Бот помнит историю обсуждения |
+
+### Команды бота
+
+| Команда | Описание |
+|---------|----------|
+| `/start` | Запуск бота и приветствие |
+| `/help` | Список команд и информация |
+| `/reset` | Сброс текущей сессии |
+| `/stats` | Статистика пользователя |
+| `/settings` | Настройки бота |
+| `/admin` | Панель администратора |
+
+### Для групповых чатов
+
+- **Начало сессии**: `/qwen <запрос>` или `@QwenAlphaRobot <запрос>`
+- **Продолжение**: ответ (reply) на сообщение из сессии
+- **Контекст**: бот помнит всю цепочку обсуждения
+- **Изоляция**: каждая тема — отдельная сессия
+
+---
+
+## ⚙️ Конфигурация
+
+### CLI опции
+
+```bash
+qwen-alpha --token <TOKEN> [опции]
+```
+
+| Опция | Описание | По умолчанию |
+|-------|----------|--------------|
+| `--token <TOKEN>` | Telegram Bot API токен | **Обязательно** |
+| `--log-level <LEVEL>` | Уровень логирования | `info` |
+| `--allowed-users <IDS>` | Whitelist user_id | все |
+| `--init-only` | Только инициализация хранилищ | `false` |
+
+### Переменные окружения
+
+```bash
+# .env файл (опционально)
+BOT_TOKEN=your_bot_token_here
+LOG_LEVEL=info
+ALLOWED_USERS=123456789,987654321
+QWEN_TIMEOUT=60000
+RATE_LIMIT_WINDOW=60000
+RATE_LIMIT_MAX=10
+```
+
+---
+
+## 📁 Хранение данных
+
+Данные хранятся в `~/.qwen-alpha/`:
+
+```
+~/.qwen-alpha/
+├── db/
+│   ├── users.json       # Пользователи
+│   ├── sessions.json    # Сессии (24ч)
+│   ├── admins.json      # Администраторы
+│   └── stats.json       # Статистика
+├── logs/
+│   └── qwen-alpha-YYYY-MM-DD.log
+└── config/
+    └── settings.json    # Настройки бота
+```
+
+**Важно**: Данные не хранятся в node_modules и не затираются при обновлении.
+
+---
+
+## 🛡 Администрирование
+
+### Первый запуск
+
+Первый пользователь, запустивший `/start`, становится **супер-админом**.
+
+### Админ команды
+
+```bash
+# Управление админами
+/admin add <user_id>       # Добавить админа
+/admin remove <user_id>    # Удалить админа
+
+# Управление пользователями
+/admin ban <user_id>       # Забанить
+/admin unban <user_id>     # Разбанить
+
+# Сессии
+/admin sessions list       # Список сессий
+/admin sessions clear <chat_id>  # Очистить чат
+
+# Настройки
+/admin set <key> <value>   # Изменить настройку
+/admin settings            # Показать настройки
+
+# Статистика
+/admin stats               # Подробная статистика
+```
+
+### Настройки бота
+
+| Настройка | По умолчанию | Описание |
+|-----------|--------------|----------|
+| `session_timeout_hours` | 24 | Срок жизни сессии (часы) |
+| `max_file_size_mb` | 2 | Макс. размер файла (MB) |
+| `requests_per_user_per_hour` | 60 | Лимит запросов/час |
+| `group_mode` | mention | Режим в группах |
+
+---
+
+## 🔧 Разработка
+
+### Установка зависимостей
+
+```bash
+git clone https://github.com/JeBance/QwenAlpha.git
+cd QwenAlpha
+npm install
+```
+
+### Запуск в режиме разработки
+
+```bash
+npm start -- --token <YOUR_BOT_TOKEN>
+```
+
+### Тесты
+
+```bash
+npm test
+```
+
+### Линтинг и форматирование
+
+```bash
+npm run lint
+npm run format
+npm run format:check
+```
+
+---
+
+## 📊 Структура проекта
+
+```
+QwenAlpha/
+├── bin/
+│   └── qwen-alpha.js      # CLI entry point
+├── src/
+│   ├── index.js           # Основной экспорт
+│   ├── bot/
+│   │   ├── bot.js         # Telegraf инициализация
+│   │   ├── handlers/      # Обработчики команд
+│   │   └── middleware/    # Middleware
+│   ├── services/
+│   │   ├── db/            # JSON хранилище
+│   │   └── qwenService.js # Qwen Code интеграция
+│   ├── config/            # Конфигурация
+│   └── utils/             # Утилиты
+├── tests/                 # Тесты
+├── .github/workflows/     # CI/CD
+└── package.json
+```
+
+---
+
+## 🐛 Решение проблем
+
+### Qwen Code не установлен
+
+```bash
+npm install -g @qwen-code/qwen-code
+```
+
+### Ошибка "Bot token not specified"
+
+Используйте `--token` или установите `BOT_TOKEN`:
+
+```bash
+export BOT_TOKEN=123456789:ABCdef...
+qwen-alpha --token $BOT_TOKEN
+```
+
+### Ошибка доступа к хранилищу
+
+Проверьте права на запись в `~/.qwen-alpha/`:
+
+```bash
+chmod -R 755 ~/.qwen-alpha/
+```
+
+### Бот не отвечает в группах
+
+Проверьте, что бот добавлен в группу и имеет права на чтение сообщений.
+
+---
+
+## 📝 Лицензия
+
+[MIT License](LICENSE)
+
+---
+
+## 🔗 Ссылки
+
+- **Репозиторий**: https://github.com/JeBance/QwenAlpha
+- **NPM**: https://www.npmjs.com/package/qwen-alpha
+- **Qwen Code**: https://github.com/QwenLM/qwen-code
+- **Telegraf**: https://telegraf.js.org/
+
+---
+
+## 🤝 Вклад в проект
+
+1. Fork репозитория
+2. Создайте ветку (`git checkout -b feature/amazing-feature`)
+3. Закоммитьте изменения (`git commit -m 'Add amazing feature'`)
+4. Отправьте в remote (`git push origin feature/amazing-feature`)
+5. Откройте Pull Request
+
+---
+
+## 📞 Контакты
+
+- **Telegram**: @QwenAlphaRobot (бот)
+- **GitHub**: https://github.com/JeBance/QwenAlpha/issues
+
+---
+
+**Qwen Alpha** — ваш AI ассистент для работы с кодом в Telegram! 🚀

package/bin/qwen-alpha.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const packageJson = require('../package.json');
+const { startBot } = require('../src');
+const { logger } = require('../src/utils/logger');
+
+/**
+ * Парсинг списка пользователей из строки
+ * @param {string} value - Строка вида "123456789,987654321"
+ * @returns {number[]} Массив user_id
+ */
+function parseUserList(value) {
+  if (!value) return [];
+  return value
+    .split(',')
+    .map(id => parseInt(id.trim(), 10))
+    .filter(id => !isNaN(id));
+}
+
+const program = new Command();
+
+program
+  .name('qwen-alpha')
+  .description('Telegram бот для работы с Qwen Code — AI-powered code review и генерация кода')
+  .version(packageJson.version);
+
+program
+  .requiredOption('--token <TOKEN>', 'Telegram Bot API токен (получите у @BotFather)')
+  .option('--log-level <LEVEL>', 'Уровень логирования (debug, info, warn, error)', 'info')
+  .option('--allowed-users <USERS>', 'Whitelist user_id через запятую (опционально)', '')
+  .option('--init-only', 'Только инициализация хранилищ и выход', false)
+  .addHelpText('after', `
+Примеры использования:
+  $ qwen-alpha --token 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
+  $ qwen-alpha --token <TOKEN> --log-level debug
+  $ qwen-alpha --token <TOKEN> --allowed-users 123456789,987654321
+
+Документация: https://github.com/JeBance/QwenAlpha
+`);
+
+program.parse(process.argv);
+
+const options = program.opts();
+
+async function main() {
+  try {
+    // Инициализация хранилищ
+    const { initDirectories } = require('../src/utils/paths');
+    const { storeManager } = require('../src/services/db');
+    
+    initDirectories();
+    storeManager.init();
+    
+    // Если только инициализация
+    if (options.initOnly) {
+      console.log('✅ Qwen Alpha хранилища инициализированы');
+      console.log(`📁 Данные хранятся в: ~/.qwen-alpha/`);
+      process.exit(0);
+    }
+    
+    // Валидация токена
+    if (!options.token || options.token === '<TOKEN>') {
+      console.error('❌ Ошибка: Telegram Bot API токен не указан');
+      console.error('');
+      console.error('Получите токен у @BotFather и запустите:');
+      console.error('  qwen-alpha --token <YOUR_BOT_TOKEN>');
+      console.error('');
+      console.error('Или установите переменную окружения:');
+      console.error('  export BOT_TOKEN=<YOUR_BOT_TOKEN>');
+      console.error('  qwen-alpha --token $BOT_TOKEN');
+      process.exit(1);
+    }
+    
+    // Подготовка опций для startBot
+    const botOptions = {
+      token: options.token,
+      logLevel: options.logLevel,
+      allowedUsers: parseUserList(options.allowedUsers),
+    };
+    
+    // Запуск бота
+    await startBot(botOptions);
+    
+    console.log('✅ Qwen Alpha запущен');
+    console.log('   Нажмите Ctrl+C для остановки');
+    
+  } catch (error) {
+    logger.error({ error }, 'Failed to start Qwen Alpha');
+    console.error('❌ Ошибка при запуске:', error.message);
+    process.exit(1);
+  }
+}
+
+main();