blockmine 1.23.4 → 1.24.0

package/.claude/settings.json

@@ -2,7 +2,7 @@
   "enableAllProjectMcpServers": true,
   "env": {
     "ANTHROPIC_BASE_URL": "https://api.ohmygpt.com",
-    "ANTHROPIC_API_KEY": "sk-jRZ13QXX878713eA8a38T3BlBKFJ1F0D2fb26fF64f529464"
+    "ANTHROPIC_API_KEY": "sk-BZXJyM206bc971cdCb06T3BLbKFJ8B3CDEbcdD964Fd7Bcdb"
   },
   "enabledMcpjsonServers": [
     "mysql",

package/.claude/settings.local.json

@@ -39,7 +39,27 @@
       "Bash(\"D:\\webstormproject\\blockmine\\frontend\\src\\components\\ide\\AIAssistant\\components\\ChatMessages.jsx\")",
       "Bash(\"D:\\webstormproject\\blockmine\\frontend\\src\\components\\ide\\AIAssistant\\components\\DiffViewer.jsx\")",
       "Skill(frontend-design)",
-      "WebSearch"
+      "WebSearch",
+      "Bash(ls:*)",
+      "Bash(dir:*)",
+      "Bash(gh issue create --title \"Создание стартового бота при первом запуске\" --body \"$(cat <<''EOF''\n## Описание\nКогда пользователь первый раз запускает blockmine и у него нет ботов, должен автоматически создаться стартовый бот с рандомным именем (например, \"maseda\") на сервере.\n\n## Задача\n- Проверять при первом запуске наличие ботов у пользователя\n- Если ботов нет, создать дефолтного бота с рандомным именем\n- Обеспечить корректную инициализацию нового бота\nEOF\n)\")",
+      "Bash(gh issue create:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:cursor.com)",
+      "Bash(gh label create:*)",
+      "Bash(gh label list:*)",
+      "Bash(gh issue list:*)",
+      "Bash(gh issue edit:*)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh api:*)",
+      "Bash(gh pr edit:*)",
+      "Bash(pr60_comments.txt)",
+      "Bash(gh issue view:*)",
+      "Bash(xcopy:*)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "WebFetch(domain:mcasset.cloud)",
+      "WebFetch(domain:api.github.com)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/node-development/SKILL.md

@@ -0,0 +1,317 @@
+---
+name: node-development
+description: Создание нод для визуального редактора BlockMine. Используй при создании новых нод, исправлении ошибок в нодах, работе с executor/evaluator, helpers, регистрацией нод на backend и frontend.
+---
+
+# Node Development - Визуальный редактор BlockMine
+
+## Архитектура нод
+
+Ноды состоят из двух частей:
+- **Backend** - логика выполнения (executor/evaluator)
+- **Frontend** - визуальное представление (NodeDefinition)
+
+## Типы нод
+
+### 1. Action Node (с exec пинами)
+- Имеет входной `exec` пин и выходные `exec`/`exec_failed` пины
+- Использует **executor** для выполнения действий
+- Может иметь **evaluator** для data-выходов
+
+### 2. Data Node (без exec пинов)
+- Только data-пины (Number, String, Boolean, Object, Array)
+- Использует только **evaluator**
+- Вычисляет значения по запросу
+
+---
+
+## Backend: Структура файлов
+
+```
+backend/src/core/
+├── nodes/{category}/{node_name}.js      # Логика ноды
+├── node-registries/{category}.js        # Регистрация нод категории
+└── constants/graphTypes.js              # Типы графов
+```
+
+---
+
+## Backend: Executor (Action ноды)
+
+```javascript
+async function execute(node, context, helpers) {
+  const { resolvePinValue, traverse, memo } = helpers;
+  const bot = context.bot;
+
+  // Получить значение входного пина (с fallback на node.data)
+  const value = await resolvePinValue(node, 'pinName', node.data?.pinName);
+
+  try {
+    // Выполнить действие...
+    const result = await bot.someAction();
+
+    // Сохранить результаты для data-выходов
+    memo.set(`${node.id}:outputPin`, result);
+    memo.set(`${node.id}:success`, true);
+
+    // Перейти к следующей ноде (успех)
+    await traverse(node, 'exec');
+  } catch (error) {
+    memo.set(`${node.id}:success`, false);
+    // Перейти к exec_failed
+    await traverse(node, 'exec_failed');
+  }
+}
+
+module.exports = { execute };
+```
+
+---
+
+## Backend: Evaluator (Data ноды и data-выходы)
+
+```javascript
+async function evaluate(node, pinId, context, helpers) {
+  const { resolvePinValue, memo } = helpers;
+  const bot = context.bot;
+
+  // Получить входные значения
+  const inputValue = await resolvePinValue(node, 'inputPin');
+
+  // Вернуть значение для запрошенного пина
+  if (pinId === 'outputPin') {
+    return computedValue;
+  }
+
+  // Для action нод - читать из memo
+  if (pinId === 'success') {
+    return memo.get(`${node.id}:success`) ?? false;
+  }
+
+  return null;
+}
+
+module.exports = { evaluate };
+```
+
+---
+
+## ВАЖНО: Правильные helpers
+
+```javascript
+// ПРАВИЛЬНО:
+await helpers.resolvePinValue(node, 'pinName');
+await helpers.resolvePinValue(node, 'pinName', defaultValue);
+
+// НЕПРАВИЛЬНО (не существует!):
+await helpers.resolveInput(node.id, 'pinName');  // НЕ РАБОТАЕТ!
+```
+
+### Helpers в Executor:
+- `resolvePinValue(node, pinId, defaultValue?)` - получить значение пина
+- `traverse(node, execPinId)` - перейти к следующей ноде
+- `memo` - Map для хранения результатов
+- `clearLoopBodyMemo(loopNodeId)` - очистить memo тела цикла
+
+### Helpers в Evaluator:
+- `resolvePinValue(node, pinId, defaultValue?)` - получить значение пина
+- `memo` - Map для чтения результатов
+
+---
+
+## Backend: Регистрация ноды
+
+```javascript
+// backend/src/core/node-registries/{category}.js
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+function registerNodes(registry) {
+  // Action нода (с exec)
+  registry.registerNodeType({
+    type: 'category:node_name',
+    label: '🔥 Название',
+    category: 'Категория',
+    description: 'Описание ноды',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/category/node_name').execute,
+    evaluator: require('../nodes/category/node_name').evaluate, // опционально
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'inputPin', name: 'Вход', type: 'String', required: true },
+      ],
+      outputs: [
+        { id: 'exec', name: 'Готово', type: 'Exec' },
+        { id: 'exec_failed', name: 'Ошибка', type: 'Exec' },
+        { id: 'result', name: 'Результат', type: 'Object' },
+        { id: 'success', name: 'Успех?', type: 'Boolean' },
+      ]
+    }
+  });
+
+  // Data нода (без exec)
+  registry.registerNodeType({
+    type: 'category:data_node',
+    label: '📊 Название',
+    category: 'Категория',
+    description: 'Описание',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/category/data_node').evaluate,
+    pins: {
+      inputs: [
+        { id: 'input', name: 'Вход', type: 'String', required: true },
+      ],
+      outputs: [
+        { id: 'output', name: 'Выход', type: 'String' },
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };
+```
+
+---
+
+## Frontend: Структура файлов
+
+```
+frontend/src/components/visual-editor/nodes/
+├── {category}/
+│   ├── {nodeName}.js           # NodeDefinition
+│   ├── {NodeName}Settings.jsx  # Компонент настроек (опционально)
+│   └── index.js                # Экспорты категории
+└── index.js                    # Регистрация всех нод
+```
+
+---
+
+## Frontend: NodeDefinition
+
+```javascript
+// frontend/src/components/visual-editor/nodes/{category}/{nodeName}.js
+import { NodeDefinition } from '../../core/registry';
+import NodeNameSettings from './NodeNameSettings'; // опционально
+
+export const nodeNameDefinition = new NodeDefinition({
+  type: 'category:node_name',  // Должен совпадать с backend!
+  category: 'category',
+  label: '🔥 Название',
+  description: 'Описание ноды',
+
+  computeInputs: (data) => [
+    { id: 'exec', name: 'Выполнить', type: 'Exec' },
+    {
+      id: 'inputPin',
+      name: 'Вход',
+      type: 'String',
+      required: true,
+      inlineField: true,        // Поле ввода прямо в ноде
+      placeholder: 'значение',
+      description: 'Подсказка при наведении'
+    },
+  ],
+
+  computeOutputs: (data) => [
+    { id: 'exec', name: 'Готово', type: 'Exec' },
+    { id: 'exec_failed', name: 'Ошибка', type: 'Exec' },
+    { id: 'result', name: 'Результат', type: 'Object' },
+  ],
+
+  SettingsComponent: NodeNameSettings, // опционально
+
+  defaultData: {
+    inputPin: '',
+  },
+
+  theme: {
+    headerColor: '#d97706',  // Цвет заголовка
+    accentColor: '#f59e0b',  // Акцентный цвет
+  },
+});
+```
+
+---
+
+## Frontend: Settings компонент (опционально)
+
+```jsx
+// frontend/src/components/visual-editor/nodes/{category}/{NodeName}Settings.jsx
+import React, { useState } from 'react';
+import { Button } from '@/components/ui/button';
+import CoordinatePickerDialog from '@/components/minecraft/CoordinatePickerDialog';
+
+const NodeNameSettings = ({ nodeId, data, updateNodeData }) => {
+  const [pickerOpen, setPickerOpen] = useState(false);
+
+  const handleSelect = (coords) => {
+    updateNodeData(nodeId, {
+      x: coords.x,
+      y: coords.y,
+      z: coords.z,
+    });
+  };
+
+  return (
+    <div className="p-2 border-t border-slate-700">
+      <Button onClick={() => setPickerOpen(true)}>
+        Выбрать координаты
+      </Button>
+      <CoordinatePickerDialog
+        open={pickerOpen}
+        onClose={() => setPickerOpen(false)}
+        onSelect={handleSelect}
+        currentCoords={data}
+        targetBlock={true}
+      />
+    </div>
+  );
+};
+
+export default NodeNameSettings;
+```
+
+---
+
+## Frontend: Регистрация
+
+```javascript
+// frontend/src/components/visual-editor/nodes/{category}/index.js
+export { nodeNameDefinition } from './nodeName';
+export { otherNodeDefinition } from './otherNode';
+
+// frontend/src/components/visual-editor/nodes/index.js
+import { nodeNameDefinition } from './category';
+
+export function registerAllNodes() {
+  NodeRegistry.register(nodeNameDefinition);
+  // ...
+}
+```
+
+---
+
+## Типы пинов
+
+| Тип | Цвет | Описание |
+|-----|------|----------|
+| `Exec` | Белый | Поток выполнения |
+| `String` | Розовый | Строка |
+| `Number` | Синий | Число |
+| `Boolean` | Красный | true/false |
+| `Object` | Фиолетовый | Объект |
+| `Array` | Оранжевый | Массив |
+| `Wildcard` | Серый | Любой тип |
+
+---
+
+## Чеклист создания ноды
+
+- [ ] Backend: создать `nodes/{category}/{name}.js` с execute/evaluate
+- [ ] Backend: добавить в `node-registries/{category}.js`
+- [ ] Frontend: создать `nodes/{category}/{name}.js` с NodeDefinition
+- [ ] Frontend: создать Settings компонент (если нужен)
+- [ ] Frontend: экспортировать в `nodes/{category}/index.js`
+- [ ] Frontend: зарегистрировать в `nodes/index.js`
+- [ ] Проверить что `type` совпадает на backend и frontend
+- [ ] Использовать `resolvePinValue(node, 'pin')` НЕ `resolveInput`

package/.claude/skills/skill-rules.json

@@ -25,6 +25,55 @@
         ]
       }
     },
+    "node-development": {
+      "type": "domain",
+      "enforcement": "suggest",
+      "priority": "high",
+      "description": "Создание нод для визуального редактора BlockMine - executor, evaluator, helpers, регистрация",
+      "promptTriggers": {
+        "keywords": [
+          "создать ноду",
+          "новая нода",
+          "node",
+          "нода",
+          "ноды",
+          "executor",
+          "evaluator",
+          "resolvePinValue",
+          "traverse",
+          "memo",
+          "NodeDefinition",
+          "registerNodeType",
+          "visual editor",
+          "визуальный редактор",
+          "node-registries",
+          "pins",
+          "exec pin",
+          "data pin"
+        ],
+        "intentPatterns": [
+          "(создать|добавить|сделать).*?(ноду|node)",
+          "(fix|исправить|ошибка).*?(нод|node|executor|evaluator)",
+          "(helpers|resolvePinValue|traverse).*?(использовать|вызвать|ошибка)"
+        ]
+      },
+      "fileTriggers": {
+        "pathPatterns": [
+          "backend/src/core/nodes/**/*.js",
+          "backend/src/core/node-registries/**/*.js",
+          "frontend/src/components/visual-editor/nodes/**/*.js",
+          "frontend/src/components/visual-editor/nodes/**/*.jsx"
+        ],
+        "contentPatterns": [
+          "async function execute\\(",
+          "async function evaluate\\(",
+          "NodeDefinition",
+          "registerNodeType",
+          "resolvePinValue",
+          "traverse\\(node"
+        ]
+      }
+    },
     "backend-dev-guidelines": {
       "type": "domain",
       "enforcement": "suggest",

package/CHANGELOG.md

@@ -1,35 +1,53 @@
-# История версий
-
-
-### [1.23.4](https://github.com/blockmineJS/blockmine/compare/v1.23.3...v1.23.4) (2025-11-29)
-
-
-### 🐛 Исправления
-
-* фикс для npx ([596ff69](https://github.com/blockmineJS/blockmine/commit/596ff69a1c989cf2df079189226ed27f8e2e5e35))
-
-### [1.23.3](https://github.com/blockmineJS/blockmine/compare/v1.23.2...v1.23.3) (2025-11-29)
-
-
-### 🐛 Исправления
-
-* фикс запуска через npx №2 ([ae02238](https://github.com/blockmineJS/blockmine/commit/ae02238f7289dec25d18e9a8ff928b12023cc19b))
-
-### [1.23.2](https://github.com/blockmineJS/blockmine/compare/v1.23.0...v1.23.2) (2025-11-29)
-
-
-### 🐛 Исправления
-
-* визуальный редактор. фикс удаления связей ([bf9e5f7](https://github.com/blockmineJS/blockmine/commit/bf9e5f7eef56aa4986e15e5421e46d4c3bfff1b2))
-* фикс запуска для npx ([f8bc79f](https://github.com/blockmineJS/blockmine/commit/f8bc79f98310ed6a53f65845d652f74c30039129))
-
-### [1.23.1](https://github.com/blockmineJS/blockmine/compare/v1.23.0...v1.23.1) (2025-11-29)
-
-
-### 🐛 Исправления
-
-* визуальный редактор. фикс удаления связей ([bf9e5f7](https://github.com/blockmineJS/blockmine/commit/bf9e5f7eef56aa4986e15e5421e46d4c3bfff1b2))
-
+# История версий
+
+
+## [1.24.0](https://github.com/blockmineJS/blockmine/compare/v1.23.4...v1.24.0) (2025-12-07)
+
+
+### 🐛 Исправления
+
+* во вкладке пользователи пофикшено изменение ролей ([925b4c8](https://github.com/blockmineJS/blockmine/commit/925b4c8427b0982d2360ff289d68c4e17723ced6))
+* ограничения доступа для массовых действий и настроек плагинов. by @artemploxoy ([a433177](https://github.com/blockmineJS/blockmine/commit/a43317730d1dacb0dc8aceb1711f64384bc9d650))
+* попытка фикса рекурсии при setup ([f2c05a8](https://github.com/blockmineJS/blockmine/commit/f2c05a88959d67b02486f446370f3e7ae50ea2af))
+* сохранение настроек прокси при перезагрузке плагинов. by @artemploxoy ([22c8f7d](https://github.com/blockmineJS/blockmine/commit/22c8f7d762b0aecda655ebbf6696253e6aa3c313))
+* управленя - пользователи теперь корректно делает сортировку ([13676bf](https://github.com/blockmineJS/blockmine/commit/13676bf25c72e908240f9c387c07576be3349520))
+
+
+### ✨ Новые возможности
+
+* в 3d viewer добавлен хот бар ([76649cd](https://github.com/blockmineJS/blockmine/commit/76649cdd46f68930acd69991b124aa84dc2dbb99))
+* новые ноды. ходьба, печка, контейнер. фиксы и выбор координат в 3d ([5c89398](https://github.com/blockmineJS/blockmine/commit/5c89398f1d7459077375887833852506d0e8f591))
+* ai assistant update ([5827c26](https://github.com/blockmineJS/blockmine/commit/5827c261ce59d265698a94d17b965e0c233794b5))
+
+### [1.23.4](https://github.com/blockmineJS/blockmine/compare/v1.23.3...v1.23.4) (2025-11-29)
+
+
+### 🐛 Исправления
+
+* фикс для npx ([596ff69](https://github.com/blockmineJS/blockmine/commit/596ff69a1c989cf2df079189226ed27f8e2e5e35))
+
+### [1.23.3](https://github.com/blockmineJS/blockmine/compare/v1.23.2...v1.23.3) (2025-11-29)
+
+
+### 🐛 Исправления
+
+* фикс запуска через npx №2 ([ae02238](https://github.com/blockmineJS/blockmine/commit/ae02238f7289dec25d18e9a8ff928b12023cc19b))
+
+### [1.23.2](https://github.com/blockmineJS/blockmine/compare/v1.23.0...v1.23.2) (2025-11-29)
+
+
+### 🐛 Исправления
+
+* визуальный редактор. фикс удаления связей ([bf9e5f7](https://github.com/blockmineJS/blockmine/commit/bf9e5f7eef56aa4986e15e5421e46d4c3bfff1b2))
+* фикс запуска для npx ([f8bc79f](https://github.com/blockmineJS/blockmine/commit/f8bc79f98310ed6a53f65845d652f74c30039129))
+
+### [1.23.1](https://github.com/blockmineJS/blockmine/compare/v1.23.0...v1.23.1) (2025-11-29)
+
+
+### 🐛 Исправления
+
+* визуальный редактор. фикс удаления связей ([bf9e5f7](https://github.com/blockmineJS/blockmine/commit/bf9e5f7eef56aa4986e15e5421e46d4c3bfff1b2))
+
 ## [1.23.0](https://github.com/blockmineJS/blockmine/compare/v1.22.0...v1.23.0) (2025-11-25)
 
 

package/backend/src/ai/plugin-assistant-system-prompt.md

@@ -44,7 +44,11 @@ Readmi.
 **Параметры**:
 - `filePath` - относительный путь к файлу
 - `content` - новое полное содержимое файла
-**ВАЖНО**: Всегда предоставляй ПОЛНЫЙ код файла, а не только изменения!
+**ВАЖНО**:
+- Всегда предоставляй ПОЛНЫЙ код файла, а не только изменения!
+- **Пиши русский текст НОРМАЛЬНО, а НЕ через \\uXXXX escape-последовательности!**
+- Пример ПРАВИЛЬНО: `"description": "Плагин для генерации случайного числа"`
+- Пример НЕПРАВИЛЬНО: `"description": "\\u041f\\u043b\\u0430\\u0433\\u0438\\u043d..."` ❌
 
 ## Рабочий процесс
 
@@ -132,6 +136,62 @@ async function onUnload({ botId, prisma }) {
 module.exports = { onLoad, onUnload };
 ```
 
+### Дополнительные хуки жизненного цикла
+
+#### onEnable / onDisable
+
+Вызываются когда плагин включают/выключают через UI (без удаления):
+
+```javascript
+async function onEnable({ botId, settings, store, prisma }) {
+    console.log(`[MyPlugin] Плагин включён для бота ${botId}`);
+    // Можно запустить фоновые задачи, подписаться на события и т.д.
+}
+
+async function onDisable({ botId, settings, store, prisma }) {
+    console.log(`[MyPlugin] Плагин выключен для бота ${botId}`);
+    // Можно остановить фоновые задачи, отписаться от событий и т.д.
+}
+
+module.exports = { onLoad, onUnload, onEnable, onDisable };
+```
+
+#### onUpdate
+
+Вызывается при обновлении плагина — для миграции данных:
+
+```javascript
+async function onUpdate({ botId, oldVersion, newVersion, settings, store, prisma }) {
+    console.log(`[MyPlugin] Обновление ${oldVersion} → ${newVersion}`);
+
+    // Миграция данных при смене версии
+    if (oldVersion === '1.0.0' && newVersion.startsWith('2.')) {
+        // Миграция данных с v1 на v2
+        const oldData = await store.get('config');
+        if (oldData && oldData.legacyField) {
+            await store.set('config', {
+                ...oldData,
+                newField: oldData.legacyField,
+                legacyField: undefined
+            });
+            console.log('[MyPlugin] Миграция данных успешна');
+        }
+    }
+}
+
+module.exports = { onLoad, onUnload, onEnable, onDisable, onUpdate };
+```
+
+### Таблица хуков
+
+| Хук | Когда вызывается | Параметры |
+|-----|------------------|-----------|
+| `onLoad` | При загрузке плагина (старт бота) | `(bot, { settings, store, console })` |
+| `onUnload` | При удалении плагина | `({ botId, prisma })` |
+| `onEnable` | При включении плагина через UI | `({ botId, settings, store, prisma })` |
+| `onDisable` | При выключении плагина через UI | `({ botId, settings, store, prisma })` |
+| `onUpdate` | После обновления плагина | `({ botId, oldVersion, newVersion, settings, store, prisma })` |
+
 ## 3. КОНСТАНТЫ (constants.js)
 
 ```javascript