neuroalpha 0.0.0-stage → 0.3.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roman A. Perepelkin
+
+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/README.md

@@ -1,3 +1,168 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Рынок как язык · MOEX
+
+Исследование идеи: акции — «токены» со своими эмбеддингами (место на карте рынка по совместным движениям),
+недавнее состояние ~100 акций индекса MOEXBMI — «контекст», модель предсказывает «следующее состояние» —
+остаточное (без рынка) движение каждой акции на H часов вперёд. Над системой работает ИИ-исследователь «Стратег» (Qwen),
+который ставит эксперименты, ведёт журнал гипотез и разбирает живую проверку. Только виртуальные деньги.
+
+📖 **[Инструкция пользователя](docs/ИНСТРУКЦИЯ.md)** · 📐 **[Механика, математика и параметры системы](docs/МЕХАНИКА_И_ПАРАМЕТРЫ.md)** · 🚀 **[Инструкция по деплою и ЮKassa](docs/ДЕПЛОЙ.md)** (также доступны по кнопке «?» в программе).
+
+## Запуск
+
+```powershell
+npm.cmd install
+npm.cmd start
+```
+
+Клиент: http://localhost:3000. Нужен Node.js ≥ 22.13 (встроенный `node:sqlite`). В VS Code — **F5**, браузер откроется сам.
+В PowerShell используйте `npm.cmd` (`npm.ps1` блокируется политикой выполнения скриптов).
+Зависимости: `express`, `ws`; `@tensorflow/tfjs` и `@tensorflow/tfjs-backend-wasm` — только для трансформера (загружаются лениво).
+
+## Как устроено
+
+```
+MOEX ISS: ~100 акций MOEXBMI + IMOEX, свечи по 10 минут (будни) ──► SQLite-кэш ──► model/dataset.js (N×T, open/close, обороты)
+   dataset.js: при modelUseDividends (по умолчанию да) цены скорректированы на дивиденды — обратная корректировка по экс-датам
+   (полная доходность; экс-дата: T+1 с 31.07.2023, раньше T+2). Источник неточен (дубли, прогнозные строки, сдвиги дат), поэтому
+   дата сверяется с ночным разрывом цены (±2 дня, дивиденд ≥1%; мелкие — только в расчётный день, <0,5% не корректируются);
+   если подходящего падения нет, дивиденд пропускается. Версия обработки данных DATA_VERSION в research.js (старые прогоны не «дубликаты»). Дивиденды — data/moex.js: ISS, запасной источник — smart-lab, кэш в kv на сутки.
+   При modelUseMacro — макро-ряды: нефть Brent (склейка фьючерсов: каждый день — контракт с наибольшим оборотом,
+   стык без скачка цены), золото, юань, доллар, индекс гособлигаций (RGBI)
+   │
+   ├─ model/research.js — пошаговая проверка: окно обучения 120 дн. → прогноз месяц → сдвиг (~27 шагов за 2 года)
+   │    model/models.js:
+   │     ├─ бета к рынку и размах — по окну обучения; остаточные z-движения; признаки: цена и «денежный поток» × 3 масштаба;
+   │     │  цель — open(t+1)→open(t+1+H) без рынка (исполнение по цене открытия следующей свечи)
+   │     ├─ эмбеддинги: собственные векторы корреляций остаточных движений (Якоби), карта 2D + k-means;
+   │     │  при modelTextWeight > 0 близость смешивается с похожестью профилей компаний (model/profiles.js)
+   │     ├─ макро-головы (modelUseMacro): бета остатков акции к макро × z-движения макро × 3 масштаба
+   │     ├─ «своя инерция» (сводная регрессия по своим движениям)
+   │     ├─ «кто за кем ходит» (гребневая регрессия N×2N, λ по валидации)
+   │     └─ «внимание через карту»: 12 голов softmax(β·cos(e_i,e_j)) × признаки соседей + макро-головы
+   │    model/transformer.js — 4-я модель (modelUseTransformer или modelType = transformer): энкодер с вниманием
+   │     МЕЖДУ акциями — каждая акция «токен»; TensorFlow.js + WASM (ленивая загрузка); учится заново в каждом окне,
+   │     окна — параллельно в рабочих потоках или на видеокарте (см. «Трансформер: потоки и видеокарта»)
+   │    model/profiles.js — 20 устойчивых признаков бизнеса компании от ИИ (обновление раз в 30 дней; только факты
+   │     «вне времени» — без новостей и прогнозов, иначе ИИ «подсмотрит будущее»); «текстовая» карта: главные компоненты + k-means
+   │    портфель: modelAutoAdapt (по умолчанию вкл.) — самообучение правил торговли (авто-калибровка порога выхода под реальную
+   │    комиссию на скользящем окне + автоматический карантин систематически убыточных «акций-убийц»); modelDirection — только
+   │    покупки / покупки и продажи / нейтрально к рынку; плата за заём акций — modelShortFeePct; ручные настройки:
+   │    modelExitRatio, modelAllocMode (поровну / обратно размаху акции), modelMarketFilter; устойчивость —
+   │    быстрые сдвиги входа в каждом прогоне + startStabilityCheck (5 сдвигов периода −8…+8 дней с прогрессом и отменой)
+   │    метрики: ранговая корреляция прогноза с фактом (ликвидные), доля недель с плюсом, портфель top-K с порогом
+   │    выгоды, с комиссиями и без, рынок; период настройки / контрольный (70/30)
+   ├─ model/forecast.js — прогноз по последней свече + вклад соседей + веса «обратно размаху» для расчёта долей
+   └─ model/live.js     — виртуальные счета (до 5 параллельно): настройки замораживаются при запуске, счёт «из прогона»
+                          сверяется с коридором истории; каждую свечу оценка, раз в H свечей прогноз и пересмотр портфеля;
+                          newsFilter — не входить против важной свежей новости
+
+Брокеры (brokers/index.js): Т-Банк (T-Invest API), Финам (Trade API), Алор (OpenAPI), БКС — REST-адаптеры портфеля и заявок;
+справочник лотности и шага цены Мосбиржи (TQBR, кэш на сутки) — заявки в целых лотах с округлением лимитной цены;
+3 режима счёта: только чтение / подтверждение заявок / автомат (лимитные заявки); жёсткие предохранители: лимит суммы на
+стратегию, дневной стоп по просадке, отступ лимитки, пропуск первых/последних 10 минут сессии. Токены — только в локальной SQLite.
+
+Новости (news/index.js): RSS Интерфакса, РБК, Прайма, ТАСС + новости Мосбиржи → дешёвый фильтр по названиям компаний
+и экономическим словам → разметка ИИ (каких акций касается, тон −1…+1, важность, суть); во время торгов опрос раз в 10 минут,
+хранение 14 дней. Только для прогноза и живой проверки: истории новостей нет, и ИИ, знающий настоящее, исказил бы проверку
+на истории. Инструмент Стратега — get_news.
+
+Стратег (strategist/): цикл агента со стримингом (SSE) и вызовом функций; режимы обсуждение / с согласия / автопилот;
+журнал гипотез — память; защита от подгонки (только период настройки, контрольный — final_check ≤ 3 раз, сравнение с базой).
+```
+
+Ядро модели — чистый JavaScript без зависимостей (`model/linalg.js`: собственные векторы, Холецкий, Спирмен, k-средних).
+Единственная «тяжёлая» зависимость — трансформер: TensorFlow.js с WASM-бэкендом, загружается только когда он включён.
+
+## Трансформер: потоки и видеокарта
+
+Окна пошаговой проверки независимы, поэтому трансформер разных окон обучается одновременно (`transformerParallel`, по умолчанию
+включено): главный поток строит окна и считает базовые модели, а в рабочие потоки (`worker_threads`) уходят только нужные
+трансформеру массивы. Результат совпадает с последовательным обучением до последнего знака (те же сиды, тот же код).
+
+- **Число потоков** — автоматически: ядер − 1 (`os.availableParallelism()`), не больше числа окон и не больше, чем помещается
+  в половину свободной памяти (≈250 МБ на поток + 3 × объём данных окна). Вручную — переменная `TRANSFORMER_THREADS`.
+- **Видеокарта** (`transformerGpu`, экспериментально): без нативных сборок — TensorFlow.js с WebGL в безголовом браузере
+  на базе Chromium со своим временным профилем. Браузер ищется так: `BROWSER_PATH`, затем стандартные места Chrome / Edge /
+  Chromium / Brave (Windows: Program Files, Program Files (x86), LOCALAPPDATA; macOS: /Applications; Linux: PATH).
+  Служебная страница и WebSocket — на отдельном порту только для 127.0.0.1. Если браузера нет, WebGL недоступен
+  или отрисовка программная (SwiftShader, llvmpipe, Microsoft Basic Render…) — обучение идёт на процессоре.
+  Окна на видеокарте обучаются по очереди; браузер закрывается после исследования (для прогноза — после 10 минут простоя)
+  и при отмене; процессы завершаются по своему PID. Где шло обучение — в результатах исследования (`extra.transformer.device`).
+  На встроенной графике видеокарта обычно не быстрее процессора — выигрыш возможен на дискретной.
+- Прогноз «сейчас» и живая проверка обучают трансформер в отдельном потоке (или на видеокарте), чтобы сервер не замирал.
+- `transformerEpochs` и `transformerStride` — эпохи и шаг свечей при обучении (по умолчанию 8 и 6).
+
+## Структура
+
+| Путь | Назначение |
+|------|------------|
+| `config/strategy.json` | Настройки по умолчанию |
+| `server/model/` | Словарь, данные, модели, исследование, прогноз, живая проверка, метрики |
+| `server/model/transformer-core.js` | Трансформер: обучение и прогноз — общий код для Node и браузера (tf передаётся параметром) |
+| `server/model/transformer.js`, `tf-node.js` | Обёртка для главного потока, загрузка TensorFlow.js (WASM → процессор) |
+| `server/model/transformer-pool.js`, `transformer-worker.js` | Пул рабочих потоков: окна трансформера обучаются одновременно |
+| `server/model/transformer-gpu.js`, `gpu-worker.html/.js` | Обучение на видеокарте: WebGL в безголовом Chrome / Edge / Chromium / Brave |
+| `server/model/profiles.js` | Описания компаний: 20 устойчивых признаков от ИИ, «текстовая» карта |
+| `server/news/index.js` | Новости: сбор из RSS и с Мосбиржи, разметка ИИ, фильтр для живой проверки |
+| `server/brokers/index.js` | Брокерские счета: Т-Банк, Финам, Алор, БКС; лоты и шаг цены Мосбиржи; предохранители |
+| `server/strategist/` | Стратег: цикл агента, инструменты, аналитика |
+| `server/llm/client.js` | Потоковый клиент модели (SSE, функции, таймаут по простою, отмена) |
+| `server/llm/providers.js` | Реестр подключений и выбранная модель, GigaChat OAuth |
+| `server/params-meta.js`, `server/settings.js` | Описание и хранение настроек |
+| `server/data/moex.js` | Загрузка свечей и дивидендов MOEX ISS с кэшем (запасной источник дивидендов — smart-lab) |
+| `public/` | Интерфейс без сборки (lightweight-charts, marked) |
+
+## LLM (выбор модели для Стратега)
+
+Модель выбирается в шапке чата (список «Провайдер · модель»). Подключения настраиваются во вкладке «Настройки → Модели ИИ»:
+добавление, редактирование (включая ключ и адрес), удаление, проверка («ответь одним словом»), список моделей с сервера.
+Реестр, ключи и выбор хранятся в базе (`data/` — в git не попадают); с сервера ключи никогда не возвращаются.
+
+Протоколы:
+- **OpenAI-совместимый** — `https://…/v1/chat/completions` (потоковый ответ, размышления, инструменты).
+- **GigaChat** — формат чата как у OpenAI, но вход по OAuth: «ключ авторизации» меняется на токен (живёт ~30 минут, обновляется сам), `scope` по умолчанию `GIGACHAT_API_PERS`.
+- **Ollama** — `http://localhost:11434/v1/chat/completions`, ключ не нужен.
+- **Anthropic** — без потока и без инструментов (только беседа).
+
+Если у модели снят флажок «инструменты», Стратег только беседует (в чате доступен лишь режим «Только обсуждение»).
+
+Проект самостоятелен и не зависит от соседних папок. Единственная отправная точка — переменные `LLM_*` в `.env`
+(если заданы, при первом запуске создаётся подключение «Из .env»), дальше всё настраивается в интерфейсе.
+
+Сертификат GigaChat (НУЦ Минцифры): Node его не знает. Путь к `russian_trusted_root_ca.pem` указывается
+в поле «Сертификат» подключения или в переменной `GIGACHAT_CA_FILE` (действует только для запросов к GigaChat,
+проверка TLS не отключается). Ключ авторизации можно также задать переменной `GIGACHAT_KEY`.
+
+## API
+
+| Метод | Путь | Описание |
+|-------|------|----------|
+| GET | `/api/config` | Описание настроек, статус ИИ |
+| GET/PUT | `/api/settings`; POST `/api/settings/reset` | Настройки |
+| GET; DELETE | `/api/runs`, `/api/runs/:id`; PUT `/api/runs/:id/title` | Исследования, имена прогонов |
+| POST | `/api/model/research`, `/api/model/:id/cancel`; POST `/api/runs/:id/stability` | Исследование, отмена, проверка устойчивости |
+| GET | `/api/model/forecast` | Прогноз на ближайшие часы |
+| GET; POST | `/api/profiles`, `/api/profiles/refresh` | Описания компаний и «текстовая» карта; принудительное обновление |
+| GET | `/api/news` | Свежие размеченные новости |
+| GET/POST/DELETE | `/api/live/status`, `/api/live/start`, `/api/live/stop`, `/api/live/:id` | Виртуальные счета (несколько параллельно) |
+| GET/POST/PUT/DELETE | `/api/brokers[/:id]`; POST `…/:id/sync|prepare|execute|reject` | Брокерские счета, портфель, заявки |
+| GET/POST | `/api/journal` | Журнал гипотез |
+| GET/POST/PUT/DELETE | `/api/llm/providers[/:id]`, GET `/api/llm/providers/:id/remote-models` | Подключения к моделям ИИ |
+| POST | `/api/llm/test`, `/api/llm/select` | Проверка подключения, выбор модели |
+| GET/POST | `/api/chat`, `/chat/send`, `/chat/action`, `/chat/stop`, `/chat/mode`, `/chat/new` | Стратег |
+| WS | `/ws` | События: ответы и размышления ИИ, прогресс, виртуальные счета, брокеры, новости, описания |
+
+## Ограничения
+
+- Данные MOEX ISS без подписки приходят с задержкой; для часовых решений некритично.
+- Контрольный период использовался при разработке (выбор порога выгоды), поэтому главная проверка — живая.
+- Позиции на виртуальных счетах дробные (лоты не учитываются). В брокерских заявках лоты и шаг цены учитываются всегда.
+- Брокерские адаптеры (Т-Банк, Финам, Алор, БКС) проверены на тестовом контуре не полностью: форматы ответов брокеров
+  меняются, при первой интеграции начните с режима «Только чтение» или песочницы.
+- Исследование с трансформером медленное (~20 минут на год истории): нейросеть учится заново в каждом окне.
+- Описания компаний и разметку новостей делает ИИ — они могут ошибаться. В описания сознательно попадают только
+  устойчивые факты (без событий и прогнозов), а новости не используются в проверках на истории — иначе ИИ «подсмотрит будущее».
+
+## Лицензия
+
+Copyright (c) 2026 Roman A. Perepelkin. Распространяется по лицензии [MIT](LICENSE).

package/bin/cli.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Roman A. Perepelkin. Licensed under the MIT License.
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const args = process.argv.slice(2);
+
+let port = process.env.PORT || '3000';
+let apiKey = process.env.NEUROALPHA_API_KEY || '';
+let cloudUrl = process.env.CLOUD_URL || 'https://neuroalpha.odant.org';
+let dataDir = process.env.NEUROALPHA_DATA_DIR || '';
+let noBrowser = false;
+
+for (let i = 0; i < args.length; i++) {
+  const a = args[i];
+  if (a === '--help' || a === '-h') {
+    console.log(`
+◈ НейроАльфа — ИИ-автопилот для рынка акций (Мосбиржа)
+
+Запуск:
+  npx neuroalpha [опции]
+
+Опции:
+  --key, -k <na_live_...>   Активировать API-ключ подписки с https://neuroalpha.odant.org
+  --port, -p <число>        Порт локального сервера (по умолчанию 3000)
+  --data, -d <путь>         Папка для локальной базы данных и ключей (~/.neuroalpha)
+  --no-browser              Не открывать браузер автоматически
+  --help, -h                Показать эту справку
+`);
+    process.exit(0);
+  }
+  if ((a === '--key' || a === '-k') && args[i + 1]) { apiKey = args[++i]; continue; }
+  if (a.startsWith('--key=')) { apiKey = a.slice(6); continue; }
+  if ((a === '--port' || a === '-p') && args[i + 1]) { port = args[++i]; continue; }
+  if (a.startsWith('--port=')) { port = a.slice(7); continue; }
+  if ((a === '--data' || a === '-d') && args[i + 1]) { dataDir = args[++i]; continue; }
+  if (a.startsWith('--data=')) { dataDir = a.slice(7); continue; }
+  if (a === '--cloud' && args[i + 1]) { cloudUrl = args[++i]; continue; }
+  if (a.startsWith('--cloud=')) { cloudUrl = a.slice(8); continue; }
+  if (a === '--no-browser') { noBrowser = true; continue; }
+}
+
+// Если запуск идёт вне исходной папки разработки (например через npx), храним БД в ~/.neuroalpha
+const localData = path.join(ROOT, 'data');
+if (!dataDir) {
+  const isDevRepo = fs.existsSync(path.join(ROOT, '.git')) || fs.existsSync(path.join(localData, 'trading.db'));
+  dataDir = isDevRepo ? localData : path.join(os.homedir(), '.neuroalpha');
+}
+
+const env = {
+  ...process.env,
+  PORT: String(port),
+  NEUROALPHA_DATA_DIR: path.resolve(dataDir),
+  OPEN_BROWSER: noBrowser ? '0' : '1',
+  ...(apiKey ? { NEUROALPHA_API_KEY: apiKey } : {}),
+  ...(cloudUrl ? { CLOUD_URL: cloudUrl } : {}),
+};
+
+const child = spawn(
+  process.execPath,
+  ['--disable-warning=ExperimentalWarning', path.join(ROOT, 'server', 'index.js')],
+  { stdio: 'inherit', env }
+);
+
+child.on('exit', (code) => process.exit(code ?? 0));