@darkclaw921/umgt 0.0.0-stage → 0.2.0

package/docs/yandex-games.md

@@ -0,0 +1,45 @@
+# Яндекс Игры
+
+Яндекс Игры — платформа публикации браузерных игр. Hub поддерживает создание проектов Godot/GDScript и HTML5/TypeScript для этой платформы. HTML5 использует Phaser для 2D и Three.js для 3D; Godot использует Web-экспорт с Compatibility renderer и без потоков. Мобильное управление относится к создаваемым играм; сам Hub рассчитан на настольный интерфейс.
+
+## Создание проекта
+
+Выберите папку системной кнопкой, движок и платформу «Яндекс Игры». Web включается вместе с этой платформой. Настройки проекта определяют устройства, ориентацию, языки, рекламу, сохранения, авторизацию, продукты и технические имена лидербордов. Начальные настройки: компьютер и телефон, RU/EN, облачные сохранения; реклама, покупки и предложение входа выключены.
+
+Пройдите интерактивное интервью, проверьте план и подтвердите ассеты. Задачи должны включать выбранные возможности SDK и их проверку. В проект устанавливаются собственные навыки интеграции, инструкции для выбранного движка и подготовки релиза. Источники ассетов, лицензии и исходные байты ресурсов сохраняются существующим механизмом импорта.
+
+## SDK и сборки
+
+SDK загружается через `/sdk.js` до `YaGames.init()`. Готовность объявляется после инициализации, загрузки состояния и отображения пригодного для игры экрана. Язык определяется через SDK. Игровые паузы, рекламные паузы и скрытая вкладка учитываются независимо; восстановление одной причины не отменяет остальные и не включает звук, выключенный игроком.
+
+Рекламная награда выдаётся только после `onRewarded`. Для покупок требуется облачное сохранение: выдача и обработанный токен сохраняются до `consumePurchase`, а незавершённые покупки восстанавливаются без повторной выдачи. В релизе используются актуальные `ysdk.leaderboards`. Недоступность опциональной возможности или отказ игрока от входа не должны блокировать основной игровой цикл.
+
+Архив публикации содержит корневой `index.html`, ресурсы игры и необходимые лицензии. Проверки исключают состояние Hub, секреты, исходники разработки и тестовые инструменты; распакованное содержимое ограничено текущими требованиями Яндекса. Локальные проверки и успешная сборка не являются гарантией модерации.
+
+## Chrome и консоль
+
+Помощник публикации использует **отдельный** [Chrome MCP](https://github.com/hangwin/mcp-chrome). Расширение ChatGPT, доступное в диалоге, не является подключением локальных агентов Hub. Установите совместимое расширение и зарегистрируйте `mcp-chrome-bridge` по инструкции разработчика, затем подключите его в настройках Hub. По умолчанию endpoint — `http://127.0.0.1:12306/mcp`; доступен только loopback endpoint.
+
+Диагностика проверяет bridge, ответ расширения и инструменты с явным адресованием вкладки и фоновым режимом. Если версия расширения не поддерживает эти возможности, помощник показывает недоступность; локальная разработка и сборка продолжают работать.
+
+Агент получает ограниченные инструменты для собственных вкладок консоли и одобренного превью. Доступа к истории, паролям, произвольным вкладкам и произвольным файлам нет. Для загрузки используются проверенные ID сборки и материалов, а не введённые моделью пути.
+
+Помощник работает с черновиком, заполняет согласованные данные, загружает архив и собирает доказательства проверки. Вход, CAPTCHA и юридические действия выполняет пользователь. Пауза, остановка и возобновление сохраняют этапы; перезапуск процесса не должен создавать второй черновик автоматически. Отправка на модерацию выполняется отдельной явной кнопкой после просмотра результата и не следует из автоматического одобрения обычных инструментов.
+
+## Различия окружений проверки
+
+- Тестовый SDK — явно включённая инфраструктура автоматических тестов; он исключается из релиза.
+- Официальный dev-SDK позволяет проверять локальную интеграцию; он не доказывает работу покупок или загрузку в настоящий черновик.
+- Проверка черновика на платформе использует реальный ID приложения, авторизованную консоль и подготовленную сборку. Непроверенные этапы отмечаются отдельно.
+
+На 9 октября 2026 года официальный `@yandex-games/sdk-dev-proxy@0.0.2` автоматически открывает браузер при `--app-id` или `--dev-mode` и не предоставляет `--no-open`. Его ручной запуск приведён в официальной документации; Hub не должен запускать этот режим незаметно с перехватом фокуса или обходить предупреждения о сертификате.
+
+## Официальные источники
+
+Проверены 9 октября 2026 года. Перед релизом следует сверять актуальную редакцию требований.
+
+- [Подключение SDK](https://yandex.ru/dev/games/doc/ru/sdk/sdk-about).
+- [Готовность и разметка геймплея](https://yandex.ru/dev/games/doc/ru/sdk/sdk-game-events).
+- [Реклама](https://yandex.ru/dev/games/doc/ru/sdk/sdk-adv), [сохранения и авторизация](https://yandex.ru/dev/games/doc/ru/sdk/sdk-player).
+- [Покупки](https://yandex.ru/dev/games/doc/ru/sdk/sdk-purchases), [лидерборды](https://yandex.ru/dev/games/doc/ru/sdk/sdk-leaderboard).
+- [Требования](https://yandex.ru/dev/games/doc/ru/concepts/requirements.html), [загрузка игры](https://yandex.ru/dev/games/doc/ru/console/add-new-game), [локальная разработка](https://yandex.ru/dev/games/doc/ru/concepts/local-launch).

package/package.json

@@ -1,6 +1,97 @@
 {
   "name": "@darkclaw921/umgt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Local AI game development workspace",
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "bin": {
+    "umgt": "bin/lm-game-hub.js",
+    "lm-game-hub": "bin/lm-game-hub.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "architecture.md",
+    "docs/*.md",
+    "scripts/open-hub-chrome.mjs",
+    "scripts/smoke-agent.mjs",
+    "scripts/create-roblox-demo.mjs",
+    "scripts/diagnose-roblox-mcp.mjs"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/server/cli.ts --no-open",
+    "dev:web": "vite --host 127.0.0.1",
+    "build": "tsc -p tsconfig.server.json && vite build",
+    "typecheck": "tsc --noEmit",
+    "start": "node bin/lm-game-hub.js",
+    "open:chrome": "node scripts/open-hub-chrome.mjs",
+    "doctor": "tsx src/server/cli.ts doctor",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "prepack": "npm run build",
+    "smoke:agent": "node scripts/smoke-agent.mjs",
+    "test:package": "node scripts/check-package.mjs",
+    "demo:roblox": "node scripts/create-roblox-demo.mjs",
+    "dev:core": "node scripts/local-core-stack.mjs start",
+    "dev:core:status": "node scripts/local-core-stack.mjs status",
+    "dev:core:stop": "node scripts/local-core-stack.mjs stop",
+    "test:core:live": "node scripts/check-local-core.mjs",
+    "test:meshy:live": "node scripts/check-local-meshy.mjs",
+    "test:billing:live": "node scripts/check-local-billing.mjs",
+    "test:core:isolation": "node scripts/check-core-isolation.mjs"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.291",
+    "@fastify/multipart": "^10.1.2",
+    "@fastify/static": "^10.1.5",
+    "@fontsource-variable/manrope": "^5.3.0",
+    "@fontsource-variable/unbounded": "^5.3.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@phosphor-icons/react": "^2.1.10",
+    "@radix-ui/react-dialog": "^1.2.0",
+    "@radix-ui/react-tabs": "^1.1.22",
+    "@tailwindcss/vite": "^4.3.3",
+    "fastify": "^5.12.5",
+    "motion": "^14.0.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
+    "sharp": "^0.35.5",
+    "tailwindcss": "^4.3.3",
+    "web-push": "^3.6.7",
+    "yauzl": "^3.4.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^26.6.4",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@types/web-push": "^3.6.4",
+    "@types/yauzl": "^3.4.0",
+    "@vitejs/plugin-react": "^6.1.2",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.3",
+    "vitest": "^5.0.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "umgtReleaseNotes": {
+    "title": "Репорты, переписка с командой и обновления студии",
+    "changes": [
+      "Сообщайте об ошибках и отправляйте пожелания через жучок в правом нижнем углу.",
+      "Прикрепляйте до трёх скриншотов, читайте ответы команды и дополняйте обращения прямо в студии.",
+      "В ядре появились просмотр аккаунта отправителя, переписка и статусы обращений.",
+      "API позволяет получать обращения, отвечать пользователям и автоматически закрывать репорты.",
+      "Студия сообщает о новых версиях, показывает список изменений и команду обновления."
+    ]
+  }
+}

package/scripts/create-roblox-demo.mjs

@@ -0,0 +1,31 @@
+import { parseArgs } from 'node:util';
+import { resolve, join } from 'node:path';
+import { readFile, realpath, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { createGameProject } from '../dist/server/engine.js';
+import { createCoinRunSources, buildRoblox } from '../dist/server/roblox.js';
+import { Store } from '../dist/server/store.js';
+
+const {values}=parseArgs({options:{'project-dir':{type:'string',default:'examples/roblox-coin-run'},'data-dir':{type:'string',default:'.artifacts/roblox/demo-hub'},rebuild:{type:'boolean',default:false}}});
+const projectPath=resolve(values['project-dir']),dataDir=resolve(values['data-dir']);
+let project;
+if(values.rebuild){
+  project=JSON.parse(await readFile(join(projectPath,'.lm-game-hub/project.json'),'utf8'));
+  if(project.engine!=='roblox')throw new Error('This is not a Roblox demo project');
+  project.path=await realpath(projectPath);
+  const result=await buildRoblox(project);if(!result.ok)throw new Error(result.output);
+}else{
+  const timestamp=new Date().toISOString();
+  project={id:randomUUID(),name:'Coin Run',path:projectPath,engine:'roblox',dimension:'3d',platforms:['roblox'],agent:'codex',description:'Персонаж бегает, прыгает по платформам и собирает 20 монет. Checkpoint и финиш.',createdAt:timestamp,updatedAt:timestamp};
+  await createGameProject(project);
+  project.path=await realpath(project.path);
+  await createCoinRunSources(project);
+  await writeFile(join(project.path,'.lm-game-hub/project.json'),JSON.stringify(project,null,2));
+}
+const store=new Store(dataDir);
+try{
+  store.put('projects',project);
+  const lock=JSON.parse(await readFile(join(project.path,'.lm-game-hub/extensions-lock.json'),'utf8'));
+  for(const pack of lock.packs)store.project(project.id).put('extensions',pack);
+}finally{store.close();}
+console.log(`Local Roblox demo: ${join(project.path,'builds/game.rbxlx')}\nWASD / arrows: run. Space: jump. Collect 20 coins, then reach the golden finish.\nOpen the file in Roblox Studio and press Play. Studio playtesting has not been performed by this script.\nHub: npm start -- --data-dir ${JSON.stringify(dataDir)}\nRebuild preserving source edits: npm run demo:roblox -- --rebuild`);

package/scripts/diagnose-roblox-mcp.mjs

@@ -0,0 +1,45 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { setTimeout as delay } from 'node:timers/promises';
+
+// Read-only protocol probe. Does not read Hub settings, credentials, Studio
+// content, or run Luau. Prints only tool schema shapes and connected counts.
+const command = process.argv[2] ?? '/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP';
+const transport = new StdioClientTransport({ command, args: [], stderr: 'pipe' });
+let denied = false;
+transport.stderr?.on('data', chunk => {
+  if (/operation not permitted|permission denied|os error (?:1|13)/i.test(String(chunk))) denied = true;
+});
+const client = new Client({ name: 'lm-game-hub-readonly-diagnostic', version: '0.1.0' });
+let changes = 0;
+client.setNotificationHandler((await import('@modelcontextprotocol/sdk/types.js')).ToolListChangedNotificationSchema, () => { changes++; });
+try {
+  await client.connect(transport, { timeout: 5000 });
+  for (let sample = 0; sample < 4; sample++) {
+    const tools = [];
+    let cursor;
+    do {
+      const page = await client.listTools(cursor ? { cursor } : {}, { timeout: 5000 });
+      tools.push(...page.tools); cursor = page.nextCursor;
+      if (tools.length > 300) throw new Error('Too many tools');
+    } while (cursor);
+    console.log(JSON.stringify({ sample, changes, tools: tools.map(tool => ({
+      name: tool.name, required: tool.inputSchema.required ?? [],
+      properties: Object.fromEntries(Object.entries(tool.inputSchema.properties ?? {}).map(([key, schema]) => [key, {
+        type: schema.type, ...(key === 'datamodel_type' ? { enum: schema.enum } : {}),
+      }])),
+    })) }));
+    if (tools.some(tool => tool.name === 'list_roblox_studios')) {
+      const result = await client.callTool({ name: 'list_roblox_studios', arguments: {} }, undefined, { timeout: 5000 });
+      const { parseStudios } = await import('../dist/server/roblox-connection.js');
+      console.log(JSON.stringify({ sample, connectedStudios: parseStudios(result).length, isError: result.isError === true }));
+    }
+    if (sample < 3) await delay(1500);
+  }
+} catch {
+  console.log(JSON.stringify({ error: denied ? 'permission_denied' : 'connection_failed' }));
+  process.exitCode = 1;
+} finally {
+  await client.close().catch(() => {});
+  await transport.close().catch(() => {});
+}

package/scripts/open-hub-chrome.mjs

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs, promisify } from 'node:util';
+import { execFile } from 'node:child_process';
+
+const root = fileURLToPath(new URL('../', import.meta.url));
+
+async function main() {
+  const { values } = parseArgs({ options: {
+    log: { type: 'string' }, help: { type: 'boolean', short: 'h' },
+  } });
+  if (values.help) {
+    console.log('npm run open:chrome -- [--log <server-log>]\nOpens the running Hub in Chrome on macOS. Without --log, uses the latest .artifacts/local-stack*.log.');
+    return;
+  }
+  if (process.platform !== 'darwin') throw new Error('Этот скрипт открытия Chrome предназначен для macOS.');
+
+  let logfile = values.log && resolve(values.log);
+  if (!logfile) {
+    const directory = resolve(root, '.artifacts');
+    const names = await readdir(directory).catch(error => {
+      if (error.code === 'ENOENT') return [];
+      throw error;
+    });
+    const logs = await Promise.all(names.filter(name => /^local-stack.*\.log$/.test(name)).map(async name => {
+      const path = resolve(directory, name);
+      return { path, modified: (await stat(path)).mtimeMs };
+    }));
+    logfile = logs.sort((a, b) => b.modified - a.modified)[0]?.path;
+  }
+  if (!logfile) throw new Error('Не найден лог сервера. Укажите --log <файл с выводом npm start>.');
+
+  const content = await readFile(logfile, 'utf8');
+  const matches = [...content.matchAll(/http:\/\/(?:127\.0\.0\.1|localhost):\d+\/#token=([a-f0-9]{64})\b/g)];
+  const match = matches.at(-1);
+  if (!match) throw new Error('В логе нет ссылки подключения Game Hub. Укажите лог текущего запуска.');
+  const url = new URL(match[0]);
+  // Use the same local origin the user opens manually. Never print the session secret.
+  url.hostname = 'localhost';
+  let response;
+  try {
+    response = await fetch(new URL('/api/v1/health', url), {
+      headers: { Authorization: `Bearer ${match[1]}` },
+      redirect: 'error', signal: AbortSignal.timeout(5000),
+    });
+  } catch {
+    throw new Error('Game Hub не отвечает. Запустите сервер и укажите его текущий лог.');
+  }
+  if (!response.ok) throw new Error('Ссылка в логе устарела или сервер не готов. Укажите лог текущего запуска.');
+  const health = await response.json();
+  if (health.status !== 'ok') throw new Error('Сервер Game Hub не готов.');
+
+  await promisify(execFile)('open', ['-g', '-a', 'Google Chrome', url.href]);
+  console.log(`Game Hub открыт в Chrome: ${url.origin}/`);
+  console.log('Подключите агента к уже открытой вкладке. Не вызывайте goto/reload: они могут снова вызвать ERR_BLOCKED_BY_CLIENT.');
+}
+
+main().catch(error => { console.error(error.message); process.exitCode = 1; });

package/scripts/smoke-agent.mjs

@@ -0,0 +1,91 @@
+import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { Store } from '../dist/server/store.js';
+import { EventBus } from '../dist/server/events.js';
+import { Workflow } from '../dist/server/workflow.js';
+import { createGameProject, detectGodot } from '../dist/server/engine.js';
+import { adapters } from '../dist/server/agents/index.js';
+
+const agent = process.argv[2] ?? 'codex';
+if (!['codex', 'kimi', 'claude'].includes(agent)) throw new Error('Usage: node scripts/smoke-agent.mjs [codex|kimi|claude]');
+const root = process.env.LMGH_SMOKE_ROOT ?? await mkdtemp(join(tmpdir(), 'lmgh-real-game-'));
+if (!root.startsWith(join(tmpdir(), 'lmgh-real-game-'))) throw new Error('Smoke resume directory must be a generated temporary fixture');
+const dataDir = join(root, 'state');
+const store = new Store(dataDir);
+const events = new EventBus(store);
+const transcript = [];
+const wrapped = Object.fromEntries(Object.entries(adapters).map(([id, adapter]) => [id, {
+  id,
+  async run(options) {
+    const result = await adapter.run(options);
+    transcript.push({ readOnly: options.readOnly, text: result.text });
+    return result;
+  },
+}]));
+const workflow = new Workflow({ store, events, dataDir, token: randomUUID() }, { adapters: wrapped });
+const engine = await detectGodot();
+if (!engine.available) { store.close(); await rm(root, { recursive: true, force: true }); throw new Error('Install Godot 4 or set GODOT_PATH before running this smoke test.'); }
+const existing = store.list('projects')[0];
+const project = existing ?? {
+  id: randomUUID(), name: 'Проверка счётчика', path: join(root, 'game'),
+  engine: 'godot', dimension: '2d', platforms: ['desktop'], agent,
+  description: 'Один экран с кнопкой и счётчиком.', createdAt: new Date().toISOString(), updatedAt: new Date().toISOString(),
+};
+const captured = [];
+events.subscribe(event => {
+  captured.push(event);
+  if (event.type === 'run.updated') console.log(JSON.stringify({ run: event.payload.kind, status: event.payload.status, error: event.payload.error }));
+  if (event.type === 'task.updated') console.log(JSON.stringify({ task: event.payload.title, status: event.payload.status, attempts: event.payload.attempts, error: event.payload.error }));
+  if (event.type === 'permission.requested') {
+    const command = typeof event.payload.details?.command === 'string' ? event.payload.details.command : '';
+    // This optional smoke test permits only the installed headless engine.
+    // Other requests are denied and recorded rather than bypassing approvals.
+    const wrapper = command.match(/^\/bin\/(?:zsh|bash|sh)\s+-lc\s+(['"])([\s\S]*)\1$/);
+    const unquoted = (wrapper?.[2] ?? command).replace(/^["']/, '');
+    const allow = unquoted.startsWith(engine.executable) && command.includes('--headless') && !/[;|&`$\n]/.test(command);
+    console.log(JSON.stringify({ permission: event.payload.method, allow, command }));
+    workflow.answer(project.id, event.payload.id, { allow });
+  }
+});
+let successful = false;
+const timer = setTimeout(() => workflow.control(project.id, 'stop'), 6 * 60_000);
+const stop = () => workflow.control(project.id, 'stop');
+process.once('SIGINT', stop); process.once('SIGTERM', stop);
+try {
+  if (existing) {
+    workflow.recover();
+    for (const task of workflow.snapshot(project.id).tasks) {
+      if (task.status === 'failed') workflow.retryTask(project.id, task.id);
+      else if (task.status === 'open') store.project(project.id).put('tasks', { ...task, attempts: 0 });
+    }
+    workflow.execute(project.id);
+  } else {
+    await createGameProject(project);
+    store.put('projects', project);
+    const plan = await workflow.savePlan(project.id, '# Проверочный счётчик\n\nСоздать один экран Godot 2D: Label с числом 0 и Button «Нажать». Сигнал pressed увеличивает счёт на 1. Строго один эпик и одна задача, без внешних ассетов, плагинов и экспортных сборок. Только три автоматизируемых критерия: сцена содержит Label со счётом и Button; программное испускание pressed три раза обновляет Label до 3; headless-импорт и запуск не содержат ошибок. Проверка кликов выполняется SceneTree-скриптом без ручной проверки и без GUI. Не добавлять субъективные критерии.');
+    workflow.approve(project.id, plan.id);
+  }
+  await workflow.settle(project.id);
+  const selection = workflow.snapshot(project.id).assetSelection;
+  if (selection && selection.status !== 'confirmed') {
+    if (selection.status !== 'choosing' || selection.needs.length) throw new Error('The no-external-assets smoke plan unexpectedly requires asset selection; inspect the real response.');
+    workflow.confirmSelection(project.id, selection.id, selection.revision);
+    await workflow.settle(project.id);
+  }
+  const snapshot = workflow.snapshot(project.id);
+  successful = snapshot.run?.status === 'completed' && snapshot.tasks.length > 0 && snapshot.tasks.every(task => task.status === 'done');
+  await mkdir('.artifacts/live-smoke', { recursive: true });
+  await writeFile('.artifacts/live-smoke/real-game.json', JSON.stringify({ agent, successful, run: snapshot.run, tasks: snapshot.tasks }, null, 2));
+  await writeFile(join(root, 'transcript.json'), JSON.stringify(transcript, null, 2));
+  await writeFile(join(root, 'events.json'), JSON.stringify(captured, null, 2));
+  console.log(JSON.stringify({ successful, evidenceDirectory: root }));
+  if (!successful) process.exitCode = 1;
+} finally {
+  clearTimeout(timer);
+  process.removeListener('SIGINT', stop); process.removeListener('SIGTERM', stop);
+  await workflow.close();
+  store.close();
+  if (successful && !process.env.LMGH_KEEP_SMOKE) await rm(root, { recursive: true, force: true });
+}