neuroalpha 0.2.0 → 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

@@ -5,7 +5,7 @@
 остаточное (без рынка) движение каждой акции на H часов вперёд. Над системой работает ИИ-исследователь «Стратег» (Qwen),
 который ставит эксперименты, ведёт журнал гипотез и разбирает живую проверку. Только виртуальные деньги.
 
-📖 **[Инструкция пользователя](docs/ИНСТРУКЦИЯ.md)** (она же — кнопка «?» в программе).
+📖 **[Инструкция пользователя](docs/ИНСТРУКЦИЯ.md)** · 📐 **[Механика, математика и параметры системы](docs/МЕХАНИКА_И_ПАРАМЕТРЫ.md)** · 🚀 **[Инструкция по деплою и ЮKassa](docs/ДЕПЛОЙ.md)** (также доступны по кнопке «?» в программе).
 
 ## Запуск
 
@@ -46,8 +46,8 @@ MOEX ISS: ~100 акций MOEXBMI + IMOEX, свечи по 10 минут (буд
    │     «вне времени» — без новостей и прогнозов, иначе ИИ «подсмотрит будущее»); «текстовая» карта: главные компоненты + k-means
    │    портфель: modelAutoAdapt (по умолчанию вкл.) — самообучение правил торговли (авто-калибровка порога выхода под реальную
    │    комиссию на скользящем окне + автоматический карантин систематически убыточных «акций-убийц»); modelDirection — только
-   │    покупки / покупки и продажи / нейтрально к рынку; плата за заём акций — modelShortFeePct; ручные настройки в Дополнительно:
-   │    modelExitRatio, modelMinHoldHours, modelAllocMode (поровну / обратно размаху акции), modelMarketFilter; устойчивость —
+   │    покупки / покупки и продажи / нейтрально к рынку; плата за заём акций — modelShortFeePct; ручные настройки:
+   │    modelExitRatio, modelAllocMode (поровну / обратно размаху акции), modelMarketFilter; устойчивость —
    │    быстрые сдвиги входа в каждом прогоне + startStabilityCheck (5 сдвигов периода −8…+8 дней с прогрессом и отменой)
    │    метрики: ранговая корреляция прогноза с фактом (ликвидные), доля недель с плюсом, портфель top-K с порогом
    │    выгоды, с комиссиями и без, рынок; период настройки / контрольный (70/30)
@@ -162,3 +162,7 @@ MOEX ISS: ~100 акций MOEXBMI + IMOEX, свечи по 10 минут (буд
 - Исследование с трансформером медленное (~20 минут на год истории): нейросеть учится заново в каждом окне.
 - Описания компаний и разметку новостей делает ИИ — они могут ошибаться. В описания сознательно попадают только
   устойчивые факты (без событий и прогнозов), а новости не используются в проверках на истории — иначе ИИ «подсмотрит будущее».
+
+## Лицензия
+
+Copyright (c) 2026 Roman A. Perepelkin. Распространяется по лицензии [MIT](LICENSE).

package/bin/cli.js

@@ -1,69 +1,69 @@
-#!/usr/bin/env node
-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 || '';
-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-ключ подписки с сайта
-  --port, -p <число>        Порт локального сервера (по умолчанию 3000)
-  --data, -d <путь>         Папка для локальной базы данных и ключей
-  --cloud <url>             Адрес облачного сервера лицензий
-  --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));
+#!/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));