@ttmg/cli 0.4.6-vibe-beta.1 → 0.4.6-vibe-beta.3

package/dist/index.js

@@ -6,18 +6,13 @@ var axios = require('axios');
 var inquirer = require('inquirer');
 var chalk = require('chalk');
 var qs = require('qs');
+var crypto = require('crypto');
 var path = require('path');
 var os = require('os');
 var fs = require('fs');
 var handlebars = require('handlebars');
 var esbuild = require('esbuild');
 var worker_threads = require('worker_threads');
-var crypto = require('crypto');
-var require$$0 = require('util');
-var require$$1$2 = require('stream');
-var zlib = require('zlib');
-var require$$3 = require('assert');
-var require$$0$2 = require('buffer');
 var jsdom = require('jsdom');
 var prettier = require('prettier');
 var express = require('express');
@@ -28,8 +23,12 @@ var WebSocket = require('ws');
 var net = require('net');
 var require$$1$1 = require('tls');
 var require$$2 = require('url');
+var require$$3 = require('assert');
 var require$$1 = require('tty');
+var require$$0 = require('util');
 var require$$0$1 = require('events');
+var require$$0$2 = require('buffer');
+var require$$1$2 = require('stream');
 var http = require('http');
 var https = require('https');
 var dns = require('dns');
@@ -45,7 +44,9 @@ var ttmgWasmtool = require('@anrans001/ttmg-wasmtool');
 var crypto$1 = require('node:crypto');
 var fs$1 = require('node:fs');
 var path$1 = require('node:path');
+var zlib = require('zlib');
 var promises = require('fs/promises');
+var child_process = require('child_process');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -7199,14 +7200,51 @@ const messages = {
         'cli.option.dev.client': 'Debug TikTok Mini Games for Client',
         'cli.option.dev.h5': 'Debug TikTok Mini Games for Web',
         'cli.command.login.desc': 'Login with developer account',
+        'cli.command.login.implicit': 'Login non-interactively and return one JSON result',
+        'cli.command.login.email': 'Developer account email (implicit mode)',
+        'cli.command.login.password': 'Developer account password (implicit mode)',
         'cli.command.logout.desc': 'Logout and clear local user data',
+        'cli.command.auth.desc': 'Inspect local authentication state',
+        'cli.command.auth.status.desc': 'Return whether the local developer session is reusable',
+        'cli.command.auth.status.format': 'Output format: text | json',
+        'cli.command.auth.status.requireAuth': 'Exit non-zero when no reusable local session exists',
+        'cli.command.capabilities.desc': 'Describe the CLI features available to developers and Agents',
+        'cli.command.capabilities.format': 'Output format: text | json',
         'cli.command.setup.desc': 'Initialize ttmg environment',
         'cli.command.setup.lang': 'Language (only supports): en-US | zh-CN',
         'cli.command.reset.desc': 'Reset local CLI state',
         'cli.command.init.desc': 'Initialize project',
         'cli.command.dev.desc': 'Open browser dev environment',
         'cli.command.dev.clientKey': 'Client Key of the Mini Game',
+        'cli.command.dev.format': 'Session output format: text | json',
+        'cli.command.dev.events': 'Lifecycle event stream: none | ndjson',
+        'cli.command.dev.noOpen': 'Do not open the DevTool page automatically',
+        'cli.command.dev.evidenceDir': 'Session evidence output directory',
+        'cli.command.dev.timeout': 'Stop a structured session after this many seconds',
+        'cli.command.dev.outputConflict': 'Dev output modes cannot be combined. Use either --format json for one manifest or --events ndjson for a lifecycle event stream.',
+        'cli.command.dev.session.desc': 'Inspect and stop local DevTool sessions',
+        'cli.command.dev.session.inspect': 'Inspect one local DevTool session',
+        'cli.command.dev.session.list': 'List local DevTool sessions',
+        'cli.command.dev.session.events': 'Read new events from a DevTool session',
+        'cli.command.dev.session.stop': 'Safely stop one local DevTool session',
+        'cli.command.dev.session.dir': 'Session root directory (default: .ttmg/sessions)',
+        'cli.command.dev.session.format': 'Output format: text | json',
+        'cli.command.dev.session.after': 'Return events with seq greater than this',
+        'cli.command.dev.session.limit': 'Maximum events to return (1-1000)',
+        'cli.command.check.desc': 'Check the Mini Game project and return actionable diagnostics',
+        'cli.command.check.dir': 'Mini Game project directory (default: current directory)',
+        'cli.command.check.format': 'Output format: text | json',
+        'cli.command.check.includePassed': 'Include passed checks in structured diagnostics',
+        'cli.command.check.failOn': 'Non-zero exit threshold: error | warning',
+        'cli.command.check.ai': 'Add static Agent-debug readiness checks',
+        'cli.command.doctor.desc': 'Diagnose local CLI, project, auth, and network readiness',
+        'cli.command.doctor.dir': 'Mini Game project directory (default: current directory)',
+        'cli.command.doctor.format': 'Output format: text | json',
+        'cli.command.doctor.failOn': 'Non-zero exit threshold: error | warning',
         'cli.command.build.desc': 'Bundle project',
+        'cli.command.build.dir': 'Mini Game project directory (structured build only)',
+        'cli.command.build.format': 'Output format: text | json',
+        'cli.command.build.includePassed': 'Include passed checks in the structured build result',
         'cli.command.config.desc': 'Manage configuration',
         'cli.command.config.set.desc': 'Set a configuration value',
         'cli.command.config.get.desc': 'Get a configuration value',
@@ -7216,7 +7254,7 @@ const messages = {
         'cli.command.upload.note': 'Note for the upload',
         'cli.command.upload.dir': 'Game project directory (default: current directory)',
         'cli.command.upload.preview': 'Wait for platform processing and output the preview payload',
-        'cli.command.upload.format': 'Output format: text | ndjson',
+        'cli.command.upload.format': 'Output format: text | json | ndjson',
         'cli.command.testAccount.desc': 'Manage Mini Game test-account access',
         'cli.command.testAccount.add.desc': 'Generate the authorization entry for adding a TikTok test account',
         'cli.command.testAccount.clientKey': 'Client Key of the Mini Game',
@@ -7263,8 +7301,13 @@ const messages = {
         'login.error.withCode': 'Login failed: {message}, error_code: {code}',
         'login.error.withMessage': 'Login failed: {message}',
         'login.error.noUserId': 'Login failed. No user_id in response.',
+        'login.error.noSessionCookie': 'Login failed. No reusable session cookie was returned.',
+        'login.error.implicitCredentialsRequired': 'Implicit login requires --email and --password, or TTMG_LOGIN_EMAIL and TTMG_LOGIN_PASSWORD.',
         'login.warning.proxyIssue': 'Login failed. Please refer to the proxy setup doc:\nhttps://bytedance.larkoffice.com/wiki/PeIawT4M4ia9R8kYyLMcjwHknOg',
         'login.error.connectService': 'Failed to connect to login service',
+        'auth.status.authenticated': 'Authenticated as {account}.',
+        'auth.status.notAuthenticated': 'No reusable local session. Run `ttmg login` first.',
+        'auth.error.invalidFormat': 'Unsupported auth status output format: {format}. Use text or json.',
         'login.error.networkBlocked': 'Network connection failed. Please refer to the proxy setup doc:\nhttps://bytedance.larkoffice.com/wiki/PeIawT4M4ia9R8kYyLMcjwHknOg',
         'logout.spinner.loggingOut': 'Logging out...',
         'logout.success': 'Logged out successfully!',
@@ -7292,6 +7335,21 @@ const messages = {
         'native.server.failedAfterRetries': 'Failed to start server after trying {retries} ports.',
         'native.check.notWorkspace': 'Current directory is not a Mini Game project entry directory, please enter the game project root directory for debugging',
         'native.check.subpackagesCaseError': "Error: 'subPackages' (camelCase) is found in {file}. Please use 'subpackages' (all lowercase) instead.",
+        'check.summary': 'Check {status}: {passed} passed, {warnings} warnings, {errors} errors',
+        'check.error.invalidFormat': 'Unsupported check output format: {format}. Use text or json.',
+        'check.error.invalidFailOn': 'Unsupported check failure threshold: {failOn}. Use error or warning.',
+        'check.error.dirNotExist': 'The specified project directory does not exist: {dir}',
+        'check.ai.gameReady.found': 'Detected reportScene({ sceneId: 9999 }) as a static GAME_READY checkpoint.',
+        'check.ai.gameReady.missing': 'No statically detectable reportScene({ sceneId: 9999 }) GAME_READY checkpoint was found.',
+        'check.ai.gameReady.help': 'Call reportScene({ sceneId: 9999 }) when the game becomes interactive, then verify it on a real device. Static detection does not prove runtime reachability.',
+        'build.error.invalidFormat': 'Unsupported build output format: {format}. Use text or json.',
+        'build.error.dirNotExist': 'The specified build directory does not exist: {dir}',
+        'build.error.failed': 'Mini Game build failed.',
+        'dev.session.error.invalidId': 'Invalid DevTool session ID: {sessionId}',
+        'dev.session.error.notFound': 'DevTool session not found: {sessionId}',
+        'dev.session.error.manifestMismatch': 'The session manifest ID does not match the requested session.',
+        'dev.session.error.unverifiedProcess': 'Refusing to stop an unverified process. The recorded PID is not a ttmg dev process.',
+        'dev.session.error.invalidCursor': 'Invalid event cursor. after must be >= 0 and limit must be between 1 and 1000.',
         'native.compile.watching': '🔔 Watching game assets for local debugging...',
         'native.compile.compiling': '🚀 Compiling game assets for local debugging...',
         'native.compile.success': '✔ Game resources compiled successfully!',
@@ -7342,6 +7400,7 @@ const messages = {
         'upload.error.assetFailed': 'The uploaded asset failed platform processing (status: {status}).',
         'upload.error.assetTimeout': 'Timed out waiting for platform asset processing.',
         'upload.error.previewTimeout': 'Timed out waiting for the preview URL.',
+        'upload.error.previewQueryFailed': 'Failed to query the preview URL from the platform.',
         'testAccount.success': 'Test-account authorization entry generated.',
         'testAccount.project': 'Project: {name} ({clientKey})',
         'testAccount.authorizationUrl': 'Authorization URL: {url}',
@@ -7353,6 +7412,7 @@ const messages = {
         'testAccount.error.notLoggedIn': 'Not logged in. Please run `ttmg login` first.',
         'testAccount.error.gameInfoFailed': 'Failed to fetch Mini Game project information.',
         'testAccount.error.noAppId': 'The platform response did not include a Mini Game ID.',
+        'testAccount.error.qrWriteFailed': 'Failed to write the QR code file.',
     },
     'zh-CN': {
         'cli.description': 'TikTok 小游戏命令行工具',
@@ -7361,14 +7421,51 @@ const messages = {
         'cli.option.dev.client': '客户端调试 TikTok 小游戏',
         'cli.option.dev.h5': 'Web 调试 TikTok 小游戏',
         'cli.command.login.desc': '使用开发者账号登录',
+        'cli.command.login.implicit': '非交互登录并返回一个 JSON 结果',
+        'cli.command.login.email': '开发者账号邮箱（implicit 模式）',
+        'cli.command.login.password': '开发者账号密码（implicit 模式）',
         'cli.command.logout.desc': '退出登录并清除本地用户信息',
+        'cli.command.auth.desc': '查看本地登录状态',
+        'cli.command.auth.status.desc': '返回本地开发者会话是否可复用',
+        'cli.command.auth.status.format': '输出格式：text | json',
+        'cli.command.auth.status.requireAuth': '没有可复用本地会话时以非零状态退出',
+        'cli.command.capabilities.desc': '返回开发者和 Agent 可使用的 CLI 能力',
+        'cli.command.capabilities.format': '输出格式：text | json',
         'cli.command.setup.desc': '初始化 ttmg 环境',
         'cli.command.setup.lang': '语言（仅支持）：en-US | zh-CN',
         'cli.command.reset.desc': '重置本地 CLI 状态',
         'cli.command.init.desc': '初始化项目',
         'cli.command.dev.desc': '打开浏览器调试环境',
         'cli.command.dev.clientKey': '小游戏的 Client Key',
+        'cli.command.dev.format': '会话输出格式：text | json',
+        'cli.command.dev.events': '生命周期事件流：none | ndjson',
+        'cli.command.dev.noOpen': '不自动打开 DevTool 页面',
+        'cli.command.dev.evidenceDir': '会话证据输出目录',
+        'cli.command.dev.timeout': '在指定秒数后停止结构化调试会话',
+        'cli.command.dev.outputConflict': 'Dev 输出模式不能同时使用：请用 --format json 输出一份 manifest，或用 --events ndjson 输出生命周期事件流。',
+        'cli.command.dev.session.desc': '查询和停止本地 DevTool 会话',
+        'cli.command.dev.session.inspect': '查询一个本地 DevTool 会话',
+        'cli.command.dev.session.list': '列出本地 DevTool 会话',
+        'cli.command.dev.session.events': '增量读取 DevTool 会话事件',
+        'cli.command.dev.session.stop': '安全停止一个本地 DevTool 会话',
+        'cli.command.dev.session.dir': '会话根目录（默认：.ttmg/sessions）',
+        'cli.command.dev.session.format': '输出格式：text | json',
+        'cli.command.dev.session.after': '只返回 seq 大于该值的事件',
+        'cli.command.dev.session.limit': '最多返回的事件数（1-1000）',
+        'cli.command.check.desc': '检查小游戏项目并返回可执行的诊断结果',
+        'cli.command.check.dir': '小游戏项目目录（默认为当前目录）',
+        'cli.command.check.format': '输出格式：text | json',
+        'cli.command.check.includePassed': '在结构化诊断中包含已通过的检查项',
+        'cli.command.check.failOn': '非零退出阈值：error | warning',
+        'cli.command.check.ai': '增加 Agent 调试准备度静态检查',
+        'cli.command.doctor.desc': '诊断本地 CLI、工程、登录和网络准备状态',
+        'cli.command.doctor.dir': '小游戏项目目录（默认为当前目录）',
+        'cli.command.doctor.format': '输出格式：text | json',
+        'cli.command.doctor.failOn': '非零退出阈值：error | warning',
         'cli.command.build.desc': '打包项目',
+        'cli.command.build.dir': '小游戏项目目录（仅结构化构建使用）',
+        'cli.command.build.format': '输出格式：text | json',
+        'cli.command.build.includePassed': '在结构化构建结果中包含已通过的检查项',
         'cli.command.config.desc': '管理配置',
         'cli.command.config.set.desc': '设置配置项',
         'cli.command.config.get.desc': '获取配置项',
@@ -7378,7 +7475,7 @@ const messages = {
         'cli.command.upload.note': '上传备注',
         'cli.command.upload.dir': '小游戏项目根目录（默认为当前目录）',
         'cli.command.upload.preview': '等待平台处理并输出预览二维码原始内容',
-        'cli.command.upload.format': '输出格式：text | ndjson',
+        'cli.command.upload.format': '输出格式：text | json | ndjson',
         'cli.command.testAccount.desc': '管理小游戏测试账号访问',
         'cli.command.testAccount.add.desc': '生成添加 TikTok 测试账号的授权入口',
         'cli.command.testAccount.clientKey': '小游戏的 Client Key',
@@ -7425,8 +7522,13 @@ const messages = {
         'login.error.withCode': '登录失败：{message}，错误码：{code}',
         'login.error.withMessage': '登录失败：{message}',
         'login.error.noUserId': '登录失败，响应中未返回 user_id。',
+        'login.error.noSessionCookie': '登录失败，响应中没有可复用的会话 Cookie。',
+        'login.error.implicitCredentialsRequired': '隐式登录需要提供 --email 和 --password，或设置 TTMG_LOGIN_EMAIL 和 TTMG_LOGIN_PASSWORD。',
         'login.warning.proxyIssue': '登录失败，请参考代理设置文档：\nhttps://bytedance.larkoffice.com/wiki/PeIawT4M4ia9R8kYyLMcjwHknOg',
         'login.error.connectService': '连接登录服务失败',
+        'auth.status.authenticated': '当前登录账号：{account}。',
+        'auth.status.notAuthenticated': '没有可复用本地会话，请先执行 `ttmg login`。',
+        'auth.error.invalidFormat': '不支持的登录状态输出格式：{format}，请使用 text 或 json。',
         'login.error.networkBlocked': '网络连接失败，请参考代理设置文档：\nhttps://bytedance.larkoffice.com/wiki/PeIawT4M4ia9R8kYyLMcjwHknOg',
         'logout.spinner.loggingOut': '正在退出登录...',
         'logout.success': '退出登录成功！',
@@ -7454,6 +7556,21 @@ const messages = {
         'native.server.failedAfterRetries': '连续尝试 {retries} 个端口后，服务启动失败。',
         'native.check.notWorkspace': '当前目录不是小游戏工程入口目录，请进入游戏项目根目录后再进行调试',
         'native.check.subpackagesCaseError': "错误：在 {file} 中发现 'subPackages'（驼峰），请改为全小写 'subpackages'。",
+        'check.summary': '检查状态 {status}：{passed} 项通过，{warnings} 项警告，{errors} 项错误',
+        'check.error.invalidFormat': '不支持的检查输出格式：{format}，请使用 text 或 json。',
+        'check.error.invalidFailOn': '不支持的失败阈值：{failOn}，请使用 error 或 warning。',
+        'check.error.dirNotExist': '指定的项目目录不存在：{dir}',
+        'check.ai.gameReady.found': '已静态检出 reportScene({ sceneId: 9999 }) GAME_READY 检查点。',
+        'check.ai.gameReady.missing': '未静态检出 reportScene({ sceneId: 9999 }) GAME_READY 检查点。',
+        'check.ai.gameReady.help': '请在游戏真正可交互时调用 reportScene({ sceneId: 9999 })，并继续完成真机验证；静态检出不代表运行时一定能够到达。',
+        'build.error.invalidFormat': '不支持的构建输出格式：{format}，请使用 text 或 json。',
+        'build.error.dirNotExist': '指定的构建目录不存在：{dir}',
+        'build.error.failed': '小游戏构建失败。',
+        'dev.session.error.invalidId': '无效的 DevTool 会话 ID：{sessionId}',
+        'dev.session.error.notFound': '未找到 DevTool 会话：{sessionId}',
+        'dev.session.error.manifestMismatch': '会话 manifest ID 与请求的会话不一致。',
+        'dev.session.error.unverifiedProcess': '拒绝停止未验证进程：记录的 PID 不是 ttmg dev 进程。',
+        'dev.session.error.invalidCursor': '无效的事件游标：after 必须大于等于 0，limit 必须在 1 到 1000 之间。',
         'native.compile.watching': '🔔 正在监听游戏资源变更（本地调试）...',
         'native.compile.compiling': '🚀 正在编译游戏资源（本地调试）...',
         'native.compile.success': '✔ 游戏资源编译成功！',
@@ -7504,6 +7621,7 @@ const messages = {
         'upload.error.assetFailed': '上传版本处理失败（状态：{status}）。',
         'upload.error.assetTimeout': '等待平台处理上传版本超时。',
         'upload.error.previewTimeout': '等待平台生成预览地址超时。',
+        'upload.error.previewQueryFailed': '查询平台预览地址失败。',
         'testAccount.success': '测试账号授权入口已生成。',
         'testAccount.project': '项目：{name}（{clientKey}）',
         'testAccount.authorizationUrl': '授权地址：{url}',
@@ -7515,6 +7633,7 @@ const messages = {
         'testAccount.error.notLoggedIn': '未登录，请先执行 `ttmg login`。',
         'testAccount.error.gameInfoFailed': '读取小游戏项目信息失败。',
         'testAccount.error.noAppId': '平台响应中没有小游戏 ID。',
+        'testAccount.error.qrWriteFailed': '写入二维码文件失败。',
     },
 };
 
@@ -7659,155 +7778,226 @@ function ensureDirSync(dirPath) {
     }
 }
 
-function printMessage(type, message) {
-    const prefix = type === 'Error'
-        ? chalk.red(t('login.error.prefix'))
-        : chalk.yellow(t('login.warning.prefix'));
-    const log = type === 'Error' ? console.error : console.warn;
-    log(prefix + message);
-}
-let spinner$1;
+const defaultDependencies$7 = {
+    post: axios.post,
+    getProxyConfig: getAxiosProxyConfig,
+    setTTMGRC,
+    now: () => Date.now(),
+    operationId: () => `login_${crypto.randomUUID()}`,
+};
 const LOGIN_TT4D = 'https://developers.tiktok.com/passport/web/email/login';
 const params = {
     aid: '2471',
     account_sdk_source: 'web',
     sdk_version: '2.1.6-tiktok',
 };
-const prompt = inquirer.createPromptModule();
-async function login(options) {
-    const verbose = options?.verbose === true;
-    const log = (msg, data) => {
-        if (!verbose)
-            return;
-        console.log(chalk.gray('[ttmg login]'), msg, data !== undefined ? data : '');
+class LoginCommandError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'LoginCommandError';
+    }
+}
+function maskEmail(email) {
+    return email.replace(/(.{2}).*(@.*)/, '$1***$2');
+}
+function createFailedResult({ operationId, email, errorCode, error, now, }) {
+    return {
+        schemaVersion: '1',
+        operationId,
+        ts: now(),
+        operation: 'login',
+        status: 'failed',
+        authMethod: 'email_password',
+        email,
+        userId: '',
+        credentialStore: 'ttmgrc',
+        cookieStored: false,
+        errorCode,
+        error,
     };
-    if (verbose)
-        log(t('login.verbose.enabled'));
-    console.log(chalk.yellowBright(t('login.note')));
-    const { email, password } = await prompt([
-        {
-            type: 'input',
-            name: 'email',
-            message: t('login.email.prompt'),
-            validate: input => {
-                if (!input) {
-                    return t('login.email.required');
-                }
-                else {
-                    if (!/^[a-zA-Z0-9_.-]+@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*\.[a-zA-Z0-9]{2,6}$/.test(input)) {
-                        return t('login.email.invalid');
-                    }
-                }
-                return true;
-            },
-        },
-        {
-            type: 'password',
-            name: 'password',
-            message: t('login.password.prompt'),
-            mask: '*',
-            validate: input => {
-                if (!input) {
-                    return t('login.password.required');
-                }
-                return true;
-            },
-        },
-    ]);
+}
+async function authenticateWithPassword(credentials, dependencies = {}) {
+    const deps = { ...defaultDependencies$7, ...dependencies };
+    const operationId = deps.operationId();
     const url = LOGIN_TT4D + '?' + new URLSearchParams(params);
-    log('Request URL', url);
-    log('Request params', { ...params, email: email.replace(/(.{2}).*(@.*)/, '$1***$2') });
     const headers = {
         'Content-Type': 'application/x-www-form-urlencoded',
         Accept: '*/*',
         'Accept-Encoding': 'gzip, deflate, br',
         Origin: 'https://developers.tiktok.com',
-        Referer: 'https://developers.tiktok.com/passport/web/email/login',
+        Referer: LOGIN_TT4D,
         'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0 Safari/537.36',
     };
-    const ora = await import('ora');
-    spinner$1 = ora.default({
-        text: chalk.bold.cyan(t('login.spinner.loggingIn')),
-        spinner: 'dots',
-    });
-    spinner$1.start();
-    const data = qs.stringify({
-        email,
-        password,
-        mix_mode: '1',
-        fixed_mix_mode: '1',
-    });
+    let response;
     try {
-        log('Sending POST request...');
-        const response = await axios.post(url, data, {
+        response = await deps.post(url, qs.stringify({
+            email: credentials.email,
+            password: credentials.password,
+            mix_mode: '1',
+            fixed_mix_mode: '1',
+        }), {
             headers,
             maxRedirects: 20,
             timeout: 30000,
-            ...getAxiosProxyConfig(),
+            ...deps.getProxyConfig(),
         });
-        log('Response status', response.status);
-        log('Response data', response?.data);
-        if (!response?.data?.data?.user_id) {
-            const errCode = response.data?.data?.error_code;
-            const errMsg = response.data?.data?.description;
-            const statusText = response?.statusText ?? '';
-            spinner$1.fail(chalk.red(t('login.failed')));
-            if (verbose) {
-                console.log(chalk.gray('Response status:'), response?.status);
-                console.log(chalk.gray('Response statusText:'), statusText || '(empty)');
-                console.log(chalk.gray('Response data:'), response?.data ?? '(empty)');
-                console.log('');
-            }
-            if (errCode || errMsg) {
-                log('Login failed (api)', { errCode, errMsg, fullData: response?.data });
-                printMessage('Error', errCode
-                    ? t('login.error.withCode', {
-                        message: String(errMsg ?? ''),
-                        code: String(errCode),
-                    })
-                    : errMsg
-                        ? t('login.error.withMessage', { message: String(errMsg) })
-                        : t('login.error.noUserId'));
-            }
-            else {
-                log('Login failed (no user_id)', { responseBody: response?.data });
-                if (verbose)
-                    log('Full response (for debugging)', response);
-                const looksLikeProxyResponse = statusText === 'Connection established' ||
-                    (response?.status === 200 &&
-                        (response?.data == null ||
-                            typeof response.data !== 'object' ||
-                            !('data' in response.data)));
-                if (looksLikeProxyResponse) {
-                    printMessage('Warning', t('login.warning.proxyIssue'));
-                }
-                else {
-                    printMessage('Error', t('login.error.noUserId'));
-                }
+    }
+    catch {
+        throw new LoginCommandError('NETWORK_ERROR', t('login.error.networkBlocked'));
+    }
+    const userId = response?.data?.data?.user_id;
+    if (!userId) {
+        const errCode = response?.data?.data?.error_code;
+        const errMsg = response?.data?.data?.description;
+        const statusText = response?.statusText ?? '';
+        const looksLikeProxyResponse = statusText === 'Connection established' ||
+            (response?.status === 200 &&
+                (response?.data == null ||
+                    typeof response.data !== 'object' ||
+                    !('data' in response.data)));
+        if (looksLikeProxyResponse) {
+            throw new LoginCommandError('PROXY_RESPONSE', t('login.warning.proxyIssue'));
+        }
+        if (errCode) {
+            throw new LoginCommandError(`PLATFORM_${String(errCode)}`, t('login.error.withCode', {
+                message: String(errMsg ?? ''),
+                code: String(errCode),
+            }));
+        }
+        if (errMsg) {
+            throw new LoginCommandError('PLATFORM_REJECTED', t('login.error.withMessage', { message: String(errMsg) }));
+        }
+        throw new LoginCommandError('INVALID_RESPONSE', t('login.error.noUserId'));
+    }
+    const setCookies = response?.headers['set-cookie'];
+    const cookie = buildCookieHeaderFromSetCookies(setCookies);
+    if (!cookie) {
+        throw new LoginCommandError('COOKIE_MISSING', t('login.error.noSessionCookie'));
+    }
+    deps.setTTMGRC({
+        email: credentials.email,
+        user_id: String(userId),
+        cookie,
+    });
+    return {
+        schemaVersion: '1',
+        operationId,
+        ts: deps.now(),
+        operation: 'login',
+        status: 'authenticated',
+        authMethod: 'email_password',
+        email: credentials.email,
+        userId: String(userId),
+        credentialStore: 'ttmgrc',
+        cookieStored: true,
+        errorCode: null,
+        error: null,
+    };
+}
+async function login(options = {}, dependencies = {}) {
+    const deps = { ...defaultDependencies$7, ...dependencies };
+    const format = options.implicit ? 'json' : 'text';
+    let email = '';
+    const operationId = deps.operationId();
+    const verbose = options.verbose === true;
+    const debug = (message, data) => {
+        if (!verbose)
+            return;
+        const args = [chalk.gray('[ttmg login]'), message];
+        if (data !== undefined)
+            args.push(data);
+        if (format === 'json')
+            console.error(...args);
+        else
+            console.log(...args);
+    };
+    try {
+        if (verbose)
+            debug(t('login.verbose.enabled'));
+        if (format === 'text')
+            console.log(chalk.yellowBright(t('login.note')));
+        let password = '';
+        if (options.implicit) {
+            email = (options.email || process.env.TTMG_LOGIN_EMAIL || '').trim();
+            password = options.password || process.env.TTMG_LOGIN_PASSWORD || '';
+            if (!email || !password) {
+                throw new LoginCommandError('CREDENTIALS_REQUIRED', t('login.error.implicitCredentialsRequired'));
             }
-            spinner$1.stop();
-            process.exit(1);
         }
         else {
-            const setCookies = response?.headers['set-cookie'];
-            const cookie = buildCookieHeaderFromSetCookies(setCookies);
-            log('Parsed cookies', { rawCount: setCookies?.length ?? 0, kept: cookie ? cookie.split('; ').length : 0 });
-            const loginData = {
-                email,
-                user_id: response?.data?.data?.user_id,
-                cookie,
-            };
-            log('Login success', { user_id: loginData.user_id, email: loginData.email });
-            setTTMGRC(loginData);
-            spinner$1.succeed(chalk.bold.green(t('login.success')));
-            process.exit(0);
+            const prompt = inquirer.createPromptModule();
+            const answers = await prompt([
+                {
+                    type: 'input',
+                    name: 'email',
+                    message: t('login.email.prompt'),
+                    validate: input => {
+                        if (!input)
+                            return t('login.email.required');
+                        if (!/^[a-zA-Z0-9_.-]+@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*\.[a-zA-Z0-9]{2,}$/.test(input)) {
+                            return t('login.email.invalid');
+                        }
+                        return true;
+                    },
+                },
+                {
+                    type: 'password',
+                    name: 'password',
+                    message: t('login.password.prompt'),
+                    mask: '*',
+                    validate: input => (input ? true : t('login.password.required')),
+                },
+            ]);
+            email = answers.email;
+            password = answers.password;
+        }
+        debug('Request', { email: maskEmail(email) });
+        const ora = await import('ora');
+        const spinner = format === 'text'
+            ? ora
+                .default({
+                text: chalk.bold.cyan(t('login.spinner.loggingIn')),
+                spinner: 'dots',
+            })
+                .start()
+            : null;
+        try {
+            const result = await authenticateWithPassword({ email, password }, { ...dependencies, operationId: () => operationId });
+            if (format === 'json')
+                console.log(JSON.stringify(result));
+            else
+                spinner?.succeed(chalk.bold.green(t('login.success')));
+            return result;
+        }
+        catch (error) {
+            spinner?.fail(chalk.red(t('login.failed')));
+            throw error;
         }
     }
     catch (error) {
-        log('Request error', error instanceof Error ? { message: error.message, name: error.name, stack: error.stack } : error);
-        spinner$1.fail(chalk.red.bold(t('login.error.connectService')));
-        printMessage('Error', t('login.error.networkBlocked'));
-        process.exit(1);
+        const commandError = error instanceof LoginCommandError
+            ? error
+            : new LoginCommandError('UNKNOWN_ERROR', error?.message || String(error));
+        const failedResult = createFailedResult({
+            operationId,
+            email,
+            errorCode: commandError.code,
+            error: commandError.message,
+            now: deps.now,
+        });
+        if (format === 'json') {
+            console.log(JSON.stringify(failedResult));
+        }
+        else {
+            const print = commandError.code === 'PROXY_RESPONSE' ? console.warn : console.error;
+            const prefix = commandError.code === 'PROXY_RESPONSE'
+                ? chalk.yellow(t('login.warning.prefix'))
+                : chalk.red(t('login.error.prefix'));
+            print(prefix + commandError.message);
+        }
+        process.exitCode = 1;
+        return failedResult;
     }
 }
 
@@ -8038,6 +8228,9 @@ const zipCwdToBuffer = (customIgnores = [], targetDir = process.cwd()) => {
         const defaultIgnores = [
             'node_modules/**',
             '.git/**',
+            '.agent/**',
+            '.claude/**',
+            '.trae/**',
             '.DS_Store',
             ttmgPack.TTMG_TEMP_DIR,
             `${ttmgPack.TTMG_TEMP_DIR}/**`,
@@ -8059,7 +8252,7 @@ const zipCwdToBuffer = (customIgnores = [], targetDir = process.cwd()) => {
 
 const DEFAULT_POLL_INTERVAL_MS = 3000;
 const DEFAULT_POLL_TIMEOUT_MS = 10 * 60 * 1000;
-const defaultDependencies$1 = {
+const defaultDependencies$6 = {
     getCurrentUser,
     fetchGameInfo,
     zipDirectory: targetDir => zipCwdToBuffer([], targetDir),
@@ -8080,26 +8273,55 @@ function normalizeOutputFormat(format) {
     }
     return normalized;
 }
-function getAssetStatusValue$1(asset) {
-    if (!asset) {
-        return '';
+function getAssetStatusRaw(asset) {
+    return asset?.cdn_deploy_status ?? asset?.status ?? null;
+}
+function normalizeUploadPlatformStatus(rawStatus) {
+    if (rawStatus === null || rawStatus === undefined || rawStatus === '') {
+        return 'waiting_for_asset';
+    }
+    const numericStatus = Number(rawStatus);
+    if (Number.isInteger(numericStatus)) {
+        if (numericStatus === 0)
+            return 'unknown';
+        if (numericStatus === 1)
+            return 'pending';
+        if (numericStatus === 2)
+            return 'success';
+        if (numericStatus === 3)
+            return 'failed';
+        if (numericStatus === 4)
+            return 'processing';
+        return 'unknown';
     }
-    return String(asset.status ?? asset.cdn_deploy_status ?? asset.live_status ?? '').toLowerCase();
-}
-function getAssetState(asset) {
-    if (!asset) {
-        return 'pending';
+    const normalized = String(rawStatus).trim().toLowerCase();
+    const statusName = normalized.replace(/^deploy_status_/, '');
+    if (['ready', 'success', 'succeeded', 'available'].includes(statusName)) {
+        return 'success';
     }
-    if (Number(asset.cdn_deploy_status) === 2) {
-        return 'ready';
+    if (statusName.includes('fail') ||
+        statusName.includes('error') ||
+        statusName.includes('reject')) {
+        return 'failed';
+    }
+    if (statusName.includes('process') ||
+        statusName.includes('upload') ||
+        statusName.includes('deploy')) {
+        return 'processing';
+    }
+    if (statusName.includes('pending') ||
+        statusName.includes('queue') ||
+        statusName.includes('wait')) {
+        return 'pending';
     }
-    const rawStatus = getAssetStatusValue$1(asset);
-    if (['ready', 'success', 'succeeded', 'available'].includes(rawStatus)) {
+    return 'unknown';
+}
+function getAssetState(asset) {
+    const platformStatus = normalizeUploadPlatformStatus(getAssetStatusRaw(asset));
+    if (platformStatus === 'success') {
         return 'ready';
     }
-    if (rawStatus.includes('fail') ||
-        rawStatus.includes('error') ||
-        rawStatus.includes('reject')) {
+    if (platformStatus === 'failed') {
         return 'failed';
     }
     return 'pending';
@@ -8131,11 +8353,14 @@ function createEvent(base, status, progress, overrides = {}) {
         qrPayload: '',
         platformUrl: '',
         error: null,
+        errorCode: null,
+        platformWrite: false,
         ...overrides,
     };
 }
 async function waitForAssetReady({ assetId, miniGameId, deadline, eventBase, onEvent, deps, }) {
-    let lastPlatformStatus = '';
+    let lastPlatformStatusRaw = null;
+    let hasEmittedPlatformStatus = false;
     while (deps.now() < deadline) {
         const response = await deps.fetchGameAssets({ miniGameId });
         if (response.error) {
@@ -8144,12 +8369,17 @@ async function waitForAssetReady({ assetId, miniGameId, deadline, eventBase, onE
                 t('upload.error.assetQueryFailed'));
         }
         const asset = extractAssets(response.data).find(item => String(item.asset_id || '') === assetId) || null;
-        const platformStatus = getAssetStatusValue$1(asset) || 'pending';
-        if (platformStatus !== lastPlatformStatus) {
-            lastPlatformStatus = platformStatus;
+        const platformStatusRaw = getAssetStatusRaw(asset);
+        const platformStatus = normalizeUploadPlatformStatus(platformStatusRaw);
+        if (!hasEmittedPlatformStatus ||
+            platformStatusRaw !== lastPlatformStatusRaw) {
+            hasEmittedPlatformStatus = true;
+            lastPlatformStatusRaw = platformStatusRaw;
             onEvent(createEvent(eventBase, 'processing', 0.7, {
                 versionId: assetId,
                 platformStatus,
+                ...(platformStatusRaw === null ? {} : { platformStatusRaw }),
+                platformWrite: true,
             }));
         }
         const assetState = getAssetState(asset);
@@ -8166,6 +8396,11 @@ async function waitForAssetReady({ assetId, miniGameId, deadline, eventBase, onE
 async function waitForPreviewUrl({ assetId, deadline, deps, }) {
     while (deps.now() < deadline) {
         const response = await deps.fetchGameAssetPreviewUrl({ assetId });
+        if (response.error) {
+            throw new Error(response.error?.StatusMessage ||
+                response.error?.message ||
+                t('upload.error.previewQueryFailed'));
+        }
         const previewUrl = extractPreviewUrl(response.data);
         if (previewUrl) {
             return previewUrl;
@@ -8175,7 +8410,7 @@ async function waitForPreviewUrl({ assetId, deadline, deps, }) {
     throw new Error(t('upload.error.previewTimeout'));
 }
 async function executeUpload(options, dependencies = {}) {
-    const deps = { ...defaultDependencies$1, ...dependencies };
+    const deps = { ...defaultDependencies$6, ...dependencies };
     const clientKey = options.clientKey?.trim();
     const note = options.note || '--';
     const eventBase = { operationId: options.operationId, clientKey };
@@ -8233,6 +8468,7 @@ async function executeUpload(options, dependencies = {}) {
             packageSizeBytes,
             versionId: assetId,
             platformUrl,
+            platformWrite: true,
         });
         emit(event);
         return event;
@@ -8253,6 +8489,7 @@ async function executeUpload(options, dependencies = {}) {
         versionId: assetId,
         platformStatus: 'resolving_preview',
         platformUrl,
+        platformWrite: true,
     }));
     const previewUrl = await waitForPreviewUrl({ assetId, deadline, deps });
     const event = createEvent(eventBase, 'ready', 1, {
@@ -8264,6 +8501,7 @@ async function executeUpload(options, dependencies = {}) {
         qrPayload: previewUrl,
         platformUrl,
         platformStatus: 'ready',
+        platformWrite: true,
     });
     emit(event);
     return event;
@@ -8326,8 +8564,15 @@ async function upload(options) {
     catch (error) {
         const message = error?.message || String(error);
         const failedEvent = createEvent({ operationId, clientKey: options.clientKey || '' }, 'failed', lastEvent?.progress || 0, {
+            appId: lastEvent?.appId,
+            projectName: lastEvent?.projectName,
+            packageSizeBytes: lastEvent?.packageSizeBytes,
             versionId: lastEvent?.versionId || '',
             platformUrl: lastEvent?.platformUrl || '',
+            platformStatus: lastEvent?.platformStatus,
+            platformStatusRaw: lastEvent?.platformStatusRaw,
+            platformWrite: lastEvent?.platformWrite || false,
+            errorCode: 'UPLOAD_FAILED',
             error: message,
         });
         if (format === 'json' || format === 'ndjson') {
@@ -14649,7 +14894,7 @@ function requireLib () {
 var libExports = requireLib();
 var QRCode = /*@__PURE__*/getDefaultExportFromCjs(libExports);
 
-const defaultDependencies = {
+const defaultDependencies$5 = {
     getCurrentUser,
     fetchGameInfo,
     writeQrFile: async (outputPath, payload) => {
@@ -14660,11 +14905,20 @@ const defaultDependencies = {
             type: 'png',
         });
     },
+    now: () => Date.now(),
+    operationId: () => `test_account_${crypto.randomUUID()}`,
 };
-function normalizeFormat(format) {
+class TestAccountCommandError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'TestAccountCommandError';
+    }
+}
+function normalizeFormat$3(format) {
     const normalized = (format || 'text').toLowerCase();
     if (normalized !== 'text' && normalized !== 'json') {
-        throw new Error(t('testAccount.error.invalidFormat', { format: normalized }));
+        throw new TestAccountCommandError('INVALID_FORMAT', t('testAccount.error.invalidFormat', { format: normalized }));
     }
     return normalized;
 }
@@ -14672,31 +14926,39 @@ function buildTestAccountAuthorizationUrl(clientKey) {
     return `https://www.tiktok.com/ttmg/dev/${encodeURIComponent(clientKey)}`;
 }
 async function generateTestAccountAuthorization(options, dependencies = {}) {
-    const deps = { ...defaultDependencies, ...dependencies };
+    const deps = { ...defaultDependencies$5, ...dependencies };
     const clientKey = options.clientKey?.trim();
+    const operationId = deps.operationId();
     if (!clientKey) {
-        throw new Error(t('testAccount.error.noClientKey'));
+        throw new TestAccountCommandError('INVALID_ARGUMENT', t('testAccount.error.noClientKey'));
     }
     const user = deps.getCurrentUser();
     if (!user || !user.cookie) {
-        throw new Error(t('testAccount.error.notLoggedIn'));
+        throw new TestAccountCommandError('NOT_AUTHENTICATED', t('testAccount.error.notLoggedIn'));
     }
     const infoResponse = await deps.fetchGameInfo(clientKey);
     if (infoResponse.error) {
-        throw new Error(infoResponse.error.errorMsg || t('testAccount.error.gameInfoFailed'));
+        throw new TestAccountCommandError('PROJECT_LOOKUP_FAILED', infoResponse.error.errorMsg || t('testAccount.error.gameInfoFailed'));
     }
     const appId = infoResponse.data?.app_id || '';
     if (!appId) {
-        throw new Error(t('testAccount.error.noAppId'));
+        throw new TestAccountCommandError('PROJECT_RESPONSE_INVALID', t('testAccount.error.noAppId'));
     }
     const projectName = infoResponse.data?.name || 'game';
     const authorizationUrl = buildTestAccountAuthorizationUrl(clientKey);
     const safeClientKey = clientKey.replace(/[^a-zA-Z0-9_-]/g, '_');
     const qrFile = path.resolve(process.cwd(), options.qrOutput || path.join('.ttmg', `test-account-${safeClientKey}.png`));
-    fs.mkdirSync(path.dirname(qrFile), { recursive: true });
-    await deps.writeQrFile(qrFile, authorizationUrl);
+    try {
+        fs.mkdirSync(path.dirname(qrFile), { recursive: true });
+        await deps.writeQrFile(qrFile, authorizationUrl);
+    }
+    catch (error) {
+        throw new TestAccountCommandError('QR_WRITE_FAILED', error?.message || t('testAccount.error.qrWriteFailed'));
+    }
     return {
         schemaVersion: '1',
+        operationId,
+        ts: deps.now(),
         operation: 'test-account.add',
         status: 'authorization_required',
         clientKey,
@@ -14708,14 +14970,20 @@ async function generateTestAccountAuthorization(options, dependencies = {}) {
         portalUrl: `https://developers.tiktok.com/portal/game/${appId}`,
         platformWrite: false,
         verification: 'developer_portal',
+        errorCode: null,
         error: null,
     };
 }
-async function testAccountAdd(options) {
+async function testAccountAdd(options, dependencies = {}) {
+    const deps = { ...defaultDependencies$5, ...dependencies };
     let format = 'text';
+    const operationId = deps.operationId();
     try {
-        format = normalizeFormat(options.format);
-        const result = await generateTestAccountAuthorization(options);
+        format = normalizeFormat$3(options.format);
+        const result = await generateTestAccountAuthorization(options, {
+            ...dependencies,
+            operationId: () => operationId,
+        });
         if (format === 'json') {
             console.log(JSON.stringify(result));
         }
@@ -14733,8 +15001,11 @@ async function testAccountAdd(options) {
     }
     catch (error) {
         const message = error?.message || String(error);
+        const errorCode = error instanceof TestAccountCommandError ? error.code : 'UNKNOWN_ERROR';
         const failedResult = {
             schemaVersion: '1',
+            operationId,
+            ts: deps.now(),
             operation: 'test-account.add',
             status: 'failed',
             clientKey: options.clientKey || '',
@@ -14746,6 +15017,7 @@ async function testAccountAdd(options) {
             portalUrl: '',
             platformWrite: false,
             verification: 'developer_portal',
+            errorCode,
             error: message,
         };
         if (format === 'json') {
@@ -14759,6 +15031,196 @@ async function testAccountAdd(options) {
     }
 }
 
+const defaultDependencies$4 = {
+    getCurrentUser,
+    operationId: () => `auth_${crypto.randomUUID()}`,
+};
+function maskAccountValue(value) {
+    if (!value)
+        return '';
+    const emailMatch = value.match(/^(.{1,2})(.*)(@.+)$/);
+    if (emailMatch) {
+        return `${emailMatch[1]}***${emailMatch[3]}`;
+    }
+    if (value.length <= 4)
+        return `${value[0]}***`;
+    return `${value.slice(0, 2)}***${value.slice(-2)}`;
+}
+function normalizeFormat$2(format) {
+    const value = (format || 'text').toLowerCase();
+    if (value !== 'text' && value !== 'json') {
+        throw new Error(t('auth.error.invalidFormat', { format: value }));
+    }
+    return value;
+}
+function getAuthStatus(dependencies = {}) {
+    const deps = { ...defaultDependencies$4, ...dependencies };
+    const user = deps.getCurrentUser();
+    const authenticated = Boolean(user?.cookie);
+    return {
+        schemaVersion: '1',
+        operationId: deps.operationId(),
+        command: 'auth.status',
+        status: authenticated ? 'authenticated' : 'not_authenticated',
+        authenticated,
+        account: {
+            email: maskAccountValue(user?.email || ''),
+            userId: maskAccountValue(user?.user_id || ''),
+        },
+        session: {
+            source: 'local_config',
+            reusable: authenticated,
+            remotelyVerified: false,
+        },
+        errorCode: null,
+        error: null,
+    };
+}
+async function authStatus(options = {}) {
+    let format = 'text';
+    let result;
+    try {
+        format = normalizeFormat$2(options.format);
+        result = getAuthStatus();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result = {
+            schemaVersion: '1',
+            operationId: `auth_${crypto.randomUUID()}`,
+            command: 'auth.status',
+            status: 'failed',
+            authenticated: false,
+            account: { email: '', userId: '' },
+            session: {
+                source: 'local_config',
+                reusable: false,
+                remotelyVerified: false,
+            },
+            errorCode: 'AUTH_STATUS_FAILED',
+            error: message,
+        };
+    }
+    if (format === 'json') {
+        console.log(JSON.stringify(result));
+    }
+    else if (result.status === 'authenticated') {
+        console.log(chalk.green(t('auth.status.authenticated', {
+            account: result.account.email || result.account.userId,
+        })));
+    }
+    else if (result.status === 'not_authenticated') {
+        console.log(chalk.yellow(t('auth.status.notAuthenticated')));
+    }
+    else {
+        console.error(chalk.red(result.error || t('common.unknownError')));
+    }
+    if (result.status === 'failed' ||
+        (options.requireAuth && !result.authenticated)) {
+        process.exitCode = 1;
+    }
+    return result;
+}
+
+var version = "0.4.6-vibe-beta.3";
+var engines = {
+	node: ">=20.19.1 <21 || >=22"
+};
+var pkg = {
+	version: version,
+	engines: engines
+};
+
+function getCapabilities() {
+    return {
+        schemaVersion: '1',
+        command: 'capabilities',
+        cliVersion: pkg.version,
+        structuredOutput: {
+            json: true,
+            ndjson: true,
+            stdoutProtocolOnly: true,
+        },
+        commands: {
+            authStatus: {
+                command: 'ttmg auth status --format json',
+                available: true,
+                platformWrite: false,
+            },
+            loginImplicit: {
+                command: 'ttmg login --implicit',
+                available: true,
+                interactive: false,
+                persistsLocalSession: true,
+                platformWrite: false,
+            },
+            testAccountAdd: {
+                command: 'ttmg test-account add --format json',
+                available: true,
+                platformWrite: false,
+                humanAuthorizationRequired: true,
+            },
+            check: {
+                command: 'ttmg check --format json',
+                available: true,
+                platformWrite: false,
+                ai: {
+                    option: '--ai',
+                    command: 'ttmg check --ai --format json',
+                    available: true,
+                    platformWrite: false,
+                    confidence: 'static',
+                },
+            },
+            build: {
+                command: 'ttmg build --format json',
+                available: true,
+                platformWrite: false,
+            },
+            dev: {
+                command: 'ttmg dev --format json --no-open',
+                eventsCommand: 'ttmg dev --events ndjson --no-open',
+                outputModesMutuallyExclusive: true,
+                available: true,
+                platformWrite: false,
+                timeout: true,
+                sessionList: true,
+                sessionInspect: true,
+                sessionStop: true,
+            },
+            uploadPreview: {
+                command: 'ttmg upload --preview --format ndjson',
+                available: true,
+                platformWrite: true,
+            },
+        },
+        dev: {
+            sessionManifest: true,
+            lifecycleEvents: true,
+            compileDiagnostics: true,
+            rawLaunchUrl: true,
+            qrCode: true,
+            manualScan: true,
+            gameReadyProtocol: true,
+            gameReady: false,
+            runtimeLogs: false,
+            deviceLaunch: false,
+            screenshot: false,
+            actions: false,
+        },
+    };
+}
+async function capabilities(options = {}) {
+    const result = getCapabilities();
+    if ((options.format || 'text').toLowerCase() === 'json') {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    return result;
+}
+
 const CONFIG_FILE_NAME = 'minigame.config.json';
 const SDK_URL = 'https://connect.tiktok-minis.com/game/sdk.js';
 const VCONSOLE_URL = 'https://connect.tiktok-minis.com/libs/vConsole.js';
@@ -15153,15 +15615,18 @@ function getDesktopPath() {
     return defaultPath;
 }
 
-var version = "0.4.6-vibe-beta.1";
-var pkg = {
-	version: version};
-
 const program = new commander.Command();
 const withVerboseOption = (command) => command.option('--verbose', t('cli.option.verbose'));
 const structuredFormatIndex = process.argv.indexOf('--format');
-const structuredFormat = structuredFormatIndex >= 0 ? process.argv[structuredFormatIndex + 1] : '';
-if (structuredFormat !== 'json' && structuredFormat !== 'ndjson') {
+const inlineStructuredFormat = process.argv.find(arg => arg.startsWith('--format='));
+const structuredFormat = inlineStructuredFormat
+    ? inlineStructuredFormat.slice('--format='.length)
+    : structuredFormatIndex >= 0
+        ? process.argv[structuredFormatIndex + 1]
+        : '';
+if (structuredFormat !== 'json' &&
+    structuredFormat !== 'ndjson' &&
+    !process.argv.includes('--implicit')) {
     maybeShowPostInstallNotice(pkg.version);
 }
 withVerboseOption(program)
@@ -15170,12 +15635,39 @@ withVerboseOption(program)
     .version(pkg.version, '-v, --version', t('cli.version.desc'))
     .option('dev', t('cli.option.dev.client'))
     .option('dev --h5', t('cli.option.dev.h5'));
-withVerboseOption(program.command('login').description(t('cli.command.login.desc'))).action(async (cmd) => {
-    await login({ verbose: cmd.verbose });
+withVerboseOption(program
+    .command('login')
+    .description(t('cli.command.login.desc'))
+    .option('--implicit', t('cli.command.login.implicit'))
+    .option('--email <email>', t('cli.command.login.email'))
+    .option('--password <password>', t('cli.command.login.password'))).action(async (cmd) => {
+    await login({
+        verbose: cmd.verbose,
+        implicit: cmd.implicit,
+        email: cmd.email,
+        password: cmd.password,
+    });
 });
 withVerboseOption(program.command('logout').description(t('cli.command.logout.desc'))).action(async () => {
     await logout();
 });
+const authCmd = program.command('auth').description(t('cli.command.auth.desc'));
+withVerboseOption(authCmd
+    .command('status')
+    .description(t('cli.command.auth.status.desc'))
+    .option('--format <format>', t('cli.command.auth.status.format'), 'text')
+    .option('--require-auth', t('cli.command.auth.status.requireAuth'))).action(async (cmd) => {
+    await authStatus({
+        format: cmd.format,
+        requireAuth: cmd.requireAuth,
+    });
+});
+withVerboseOption(program
+    .command('capabilities')
+    .description(t('cli.command.capabilities.desc'))
+    .option('--format <format>', t('cli.command.capabilities.format'), 'text')).action(async (cmd) => {
+    await capabilities({ format: cmd.format });
+});
 withVerboseOption(program
     .command('upload')
     .description(t('cli.command.upload.desc'))
@@ -15247,20 +15739,132 @@ withVerboseOption(program
 /**
  * ttmg dev 命令
  */
-withVerboseOption(program
+const devCmd = program
     .option('--h5', t('cli.option.h5'))
     .command('dev')
     .description(t('cli.command.dev.desc'))
-    .option('-ck, --client-key <clientKey>', t('cli.command.dev.clientKey'))).action(async (cmd) => {
+    .option('-ck, --client-key <clientKey>', t('cli.command.dev.clientKey'))
+    .option('--format <format>', t('cli.command.dev.format'), 'text')
+    .option('--events <events>', t('cli.command.dev.events'), 'none')
+    .option('--no-open', t('cli.command.dev.noOpen'))
+    .option('--evidence-dir <path>', t('cli.command.dev.evidenceDir'))
+    .option('--timeout <seconds>', t('cli.command.dev.timeout'));
+withVerboseOption(devCmd).action(async (cmd) => {
     const options = program.opts();
+    const format = String(cmd.format || 'text').toLowerCase();
+    const events = String(cmd.events || 'none').toLowerCase();
+    if (format === 'json' && events === 'ndjson') {
+        console.error(t('cli.command.dev.outputConflict'));
+        process.exitCode = 1;
+        return;
+    }
     if (options.h5) {
         await dev$1();
     }
     else {
         const Native = await Promise.resolve().then(function () { return index; });
-        await Native.dev({ clientKey: cmd.clientKey });
+        await Native.dev({
+            clientKey: cmd.clientKey,
+            format: cmd.format,
+            events: cmd.events,
+            noOpen: cmd.noOpen,
+            evidenceDir: cmd.evidenceDir,
+            timeout: cmd.timeout,
+        });
+    }
+    if (cmd.format === 'text' && cmd.events === 'none')
+        checkUpdate();
+});
+const devSessionCmd = devCmd
+    .command('session')
+    .description(t('cli.command.dev.session.desc'));
+devSessionCmd
+    .command('inspect <sessionId>')
+    .description(t('cli.command.dev.session.inspect'))
+    .option('--sessions-dir <path>', t('cli.command.dev.session.dir'))
+    .option('--format <format>', t('cli.command.dev.session.format'))
+    .action(async (sessionId, sessionOptions) => {
+    const Native = await Promise.resolve().then(function () { return index; });
+    await Native.devSessionInspectCommand(sessionId, {
+        sessionsDir: sessionOptions.sessionsDir,
+        format: sessionOptions.format || devCmd.opts().format,
+    });
+});
+devSessionCmd
+    .command('list')
+    .description(t('cli.command.dev.session.list'))
+    .option('--sessions-dir <path>', t('cli.command.dev.session.dir'))
+    .option('--format <format>', t('cli.command.dev.session.format'))
+    .action(async (sessionOptions) => {
+    const Native = await Promise.resolve().then(function () { return index; });
+    await Native.devSessionListCommand({
+        sessionsDir: sessionOptions.sessionsDir,
+        format: sessionOptions.format || devCmd.opts().format,
+    });
+});
+devSessionCmd
+    .command('events <sessionId>')
+    .description(t('cli.command.dev.session.events'))
+    .option('--sessions-dir <path>', t('cli.command.dev.session.dir'))
+    .option('--after <seq>', t('cli.command.dev.session.after'), '0')
+    .option('--limit <count>', t('cli.command.dev.session.limit'), '100')
+    .option('--format <format>', t('cli.command.dev.session.format'))
+    .action(async (sessionId, sessionOptions) => {
+    const Native = await Promise.resolve().then(function () { return index; });
+    await Native.devSessionEventsCommand(sessionId, {
+        sessionsDir: sessionOptions.sessionsDir,
+        after: sessionOptions.after,
+        limit: sessionOptions.limit,
+        format: sessionOptions.format || devCmd.opts().format,
+    });
+});
+devSessionCmd
+    .command('stop <sessionId>')
+    .description(t('cli.command.dev.session.stop'))
+    .option('--sessions-dir <path>', t('cli.command.dev.session.dir'))
+    .option('--format <format>', t('cli.command.dev.session.format'))
+    .action(async (sessionId, sessionOptions) => {
+    const Native = await Promise.resolve().then(function () { return index; });
+    await Native.devSessionStopCommand(sessionId, {
+        sessionsDir: sessionOptions.sessionsDir,
+        format: sessionOptions.format || devCmd.opts().format,
+    });
+});
+const checkCmd = program
+    .command('check')
+    .description(t('cli.command.check.desc'))
+    .allowExcessArguments(false)
+    .option('-d, --dir <dir>', t('cli.command.check.dir'))
+    .option('--format <format>', t('cli.command.check.format'), 'text')
+    .option('--include-passed', t('cli.command.check.includePassed'))
+    .option('--fail-on <level>', t('cli.command.check.failOn'), 'error')
+    .option('--ai', t('cli.command.check.ai'));
+withVerboseOption(checkCmd).action(async (cmd) => {
+    const Native = await Promise.resolve().then(function () { return index; });
+    const options = {
+        dir: cmd.dir,
+        format: cmd.format,
+        includePassed: cmd.includePassed,
+        failOn: cmd.failOn,
+    };
+    if (cmd.ai) {
+        await Native.checkAi(options);
+        return;
     }
-    checkUpdate();
+    await Native.check(options);
+});
+withVerboseOption(program
+    .command('doctor')
+    .description(t('cli.command.doctor.desc'))
+    .option('-d, --dir <dir>', t('cli.command.doctor.dir'))
+    .option('--format <format>', t('cli.command.doctor.format'), 'text')
+    .option('--fail-on <level>', t('cli.command.doctor.failOn'), 'error')).action(async (cmd) => {
+    const Native = await Promise.resolve().then(function () { return index; });
+    await Native.doctor({
+        dir: cmd.dir,
+        format: cmd.format,
+        failOn: cmd.failOn,
+    });
 });
 /**
  * ttmg build 命令
@@ -15268,11 +15872,22 @@ withVerboseOption(program
 withVerboseOption(program
     .option('--h5', t('cli.option.h5'))
     .command('build')
-    .description(t('cli.command.build.desc'))).action(() => {
+    .description(t('cli.command.build.desc'))
+    .option('-d, --dir <dir>', t('cli.command.build.dir'))
+    .option('--format <format>', t('cli.command.build.format'), 'text')
+    .option('--include-passed', t('cli.command.build.includePassed'))).action(async (cmd) => {
     const options = program.opts(); // 获取 options
     if (options.h5) {
         build();
     }
+    else if (cmd.format !== 'text') {
+        const Native = await Promise.resolve().then(function () { return index; });
+        await Native.build({
+            dir: cmd.dir,
+            format: cmd.format,
+            includePassed: cmd.includePassed,
+        });
+    }
     else {
         console.log(t('cli.native.build.placeholder'));
     }
@@ -15430,20 +16045,51 @@ const store = Store.getInstance({
     checkResults: [],
 });
 
+function getGameReadyPayload(message) {
+    if (!message || typeof message !== 'object')
+        return null;
+    const runtimeEvent = message;
+    if (runtimeEvent.method !== 'reportScene' ||
+        runtimeEvent.payload?.sceneId !== 9999) {
+        return null;
+    }
+    return {
+        sceneId: 9999,
+        signal: 'reportScene',
+    };
+}
+function emitRuntimeSessionEvent(message) {
+    const gameReady = getGameReadyPayload(message);
+    if (!gameReady)
+        return false;
+    eventEmitter.emit('devSession', {
+        type: 'game_ready',
+        payload: gameReady,
+    });
+    return true;
+}
 class WsServer {
     constructor() {
         this.started = false;
+        this.quiet = false;
     }
-    start() {
+    start(options = {}) {
         if (this.started) {
             return;
         }
+        this.quiet = options.quiet === true;
         this.started = true;
         this.startWsServer(store.getState().nodeWsPort);
     }
     startWsServer(port) {
         this.ws = new WebSocket.Server({ port });
         this.ws.on('connection', ws => {
+            ws.on('close', () => {
+                eventEmitter.emit('devSession', {
+                    type: 'client_disconnected',
+                    payload: {},
+                });
+            });
             const { clientHttpPort, clientHost, clientWsPort } = store.getState();
             if (clientHost) {
                 this.send({
@@ -15476,8 +16122,13 @@ class WsServer {
                         case 'startUpload':
                             eventEmitter.emit('startUpload', {});
                             break;
+                        case 'runtimeEvent': {
+                            emitRuntimeSessionEvent(clientMessage.payload);
+                            break;
+                        }
                         case 'closeLocalDebug':
-                            console.log('closeLocalDebug');
+                            if (!this.quiet)
+                                console.log('closeLocalDebug');
                             /**
                              * 关闭调试服务
                              */
@@ -15491,7 +16142,8 @@ class WsServer {
                         case 'scanQRCodeResult': {
                             const payload = clientMessage.payload || {};
                             const { host, port, wsPort, errMsg, isSuccess } = payload;
-                            console.log('scanQRCodeResult', payload);
+                            if (!this.quiet)
+                                console.log('scanQRCodeResult', payload);
                             if (isSuccess) {
                                 store.setState({
                                     clientHttpPort: port,
@@ -15506,9 +16158,18 @@ class WsServer {
                                         clientWsPort: wsPort,
                                     },
                                 });
-                                console.log('scanQRcodeSuccess');
+                                eventEmitter.emit('devSession', {
+                                    type: 'client_connected',
+                                    payload: { host, port, wsPort },
+                                });
+                                if (!this.quiet)
+                                    console.log('scanQRcodeSuccess');
                             }
                             else {
+                                eventEmitter.emit('devSession', {
+                                    type: 'client_connection_failed',
+                                    payload: { error: errMsg || '' },
+                                });
                                 this.send({
                                     method: 'scanQRCodeFailed',
                                     payload: {
@@ -15550,7 +16211,8 @@ class WsServer {
                 this.startWsServer(store.getState().nodeWsPort);
             }
             else {
-                console.log(chalk.red.bold(err.message));
+                if (!this.quiet)
+                    console.log(chalk.red.bold(err.message));
                 process.exit(1);
             }
         });
@@ -15621,21 +16283,35 @@ async function compile(context) {
     const { clientKey, msg } = getClientKey();
     if (!clientKey) {
         if (context?.mode !== 'watch') {
-            console.log(chalk.red.bold(msg));
+            if (!context?.quiet)
+                console.log(chalk.red.bold(msg));
+            if (context?.throwOnError) {
+                throw new Error(msg);
+            }
             process.exit(1);
         }
-        console.log(chalk.red.bold(msg));
+        if (!context?.quiet)
+            console.log(chalk.red.bold(msg));
     }
     const startTip = context?.mode === 'watch'
         ? t('native.compile.watching')
         : t('native.compile.compiling');
-    console.log(chalk.bold.cyan(startTip));
+    if (!context?.quiet)
+        console.log(chalk.bold.cyan(startTip));
+    context?.onEvent?.('started');
     wsServer.sendCompilationStatus('start');
     store.setState({
         isUnderCompiling: true,
     });
     return new Promise((resolve, reject) => {
-        const worker = new worker_threads.Worker(path.resolve(__dirname, './scripts/worker.js'));
+        const worker = new worker_threads.Worker(path.resolve(__dirname, './scripts/worker.js'), {
+            stdout: context?.quiet,
+            stderr: context?.quiet,
+        });
+        if (context?.quiet) {
+            worker.stdout?.on('data', chunk => process.stderr.write(chunk));
+            worker.stderr?.on('data', chunk => process.stderr.write(chunk));
+        }
         worker.on('message', msg => {
             if (msg.type === 'status' && msg.status === 'end') {
                 const { isSuccess, errorMsg, packages } = msg;
@@ -15647,10 +16323,20 @@ async function compile(context) {
                         errorMsg,
                         isSuccess: false,
                     });
-                    console.log(chalk.red.bold(errorMsg));
+                    if (!context?.quiet)
+                        console.log(chalk.red.bold(errorMsg));
+                    context?.onEvent?.('failed', errorMsg, msg.checkResults || []);
                     // 非 watch 模式下，校验失败直接退出进程
                     if (context?.mode !== 'watch') {
-                        process.exit(1);
+                        if (context?.throwOnError) {
+                            reject(new Error(errorMsg));
+                        }
+                        else {
+                            process.exit(1);
+                        }
+                    }
+                    else {
+                        resolve(msg);
                     }
                 }
                 else {
@@ -15665,7 +16351,10 @@ async function compile(context) {
                     wsServer.sendCompilationStatus('end', {
                         isSuccess: true,
                     });
-                    console.log(chalk.green.bold(t('native.compile.success')));
+                    context?.onEvent?.('succeeded', undefined, msg.checkResults || []);
+                    if (!context?.quiet) {
+                        console.log(chalk.green.bold(t('native.compile.success')));
+                    }
                     resolve(msg); // 编译结束，返回结果
                 }
                 worker.terminate();
@@ -15676,7 +16365,9 @@ async function compile(context) {
             }
         });
         worker.on('error', err => {
-            console.log(chalk.red.bold(err.message));
+            if (!context?.quiet)
+                console.log(chalk.red.bold(err.message));
+            context?.onEvent?.('failed', err.message);
             reject(err);
             worker.terminate();
         });
@@ -15755,10 +16446,14 @@ async function withWatchSuspended(fn, options = {}) {
         resumeWatch({ emit: options.emitOnFinish ?? true });
     }
 }
-async function watch() {
+async function watch(options = {}) {
     let debounceTimer = null;
     const runUpdate = async () => {
-        await compile({ mode: 'watch' });
+        await compile({
+            mode: 'watch',
+            quiet: options.quiet,
+            onEvent: options.onCompileEvent,
+        });
         wsServer.sendResourceChange();
     };
     triggerUpdate = () => {
@@ -15801,6 +16496,7 @@ async function watch() {
     watcher.on('error', error => {
         // console.error(chalk.red('[watch] 监听发生错误:'), error);
     });
+    return watcher;
 }
 
 let spinner;
@@ -16231,7 +16927,7 @@ function isWorkspace() {
     }
 }
 
-async function check() {
+async function check(options = {}) {
     const boxenFn = boxen.default ??
         boxen;
     const printBox = (type, message) => {
@@ -16251,9 +16947,14 @@ async function check() {
     //         `You are not logged in, please login first, run ttmg login to login with your TikTok Dev Portal account, then try again`,
     //     );
     //     process.exit(1);
-    // } 
+    // }
     if (!isWorkspace()) {
-        printBox('Error', t('native.check.notWorkspace'));
+        if (options.throwOnError) {
+            throw new Error(t('native.check.notWorkspace'));
+        }
+        if (!options.quiet) {
+            printBox('Error', t('native.check.notWorkspace'));
+        }
         process.exit(1);
     }
     // const checkResult = await checkPkgs({
@@ -16309,19 +17010,26 @@ async function listen(app, options) {
     const version = devToolVersion$1;
     const server = http.createServer(app);
     function tryListen(port) {
-        return new Promise(resolve => {
+        return new Promise((resolve, reject) => {
             const onError = err => {
                 server.removeListener('listening', onListening);
                 if (err.code === 'EADDRINUSE') {
-                    console.log(chalk(t('native.server.portInUse', {
-                        port,
-                        next: port + 1,
-                    })));
+                    if (!options?.quiet) {
+                        console.log(chalk(t('native.server.portInUse', {
+                            port,
+                            next: port + 1,
+                        })));
+                    }
                     resolve(false);
                 }
                 else {
-                    console.log(chalk.red.bold(err.message));
-                    process.exit(1);
+                    if (options?.quiet) {
+                        reject(err);
+                    }
+                    else {
+                        console.log(chalk.red.bold(err.message));
+                        process.exit(1);
+                    }
                 }
             };
             const onListening = () => {
@@ -16343,6 +17051,9 @@ async function listen(app, options) {
         store.setState({ nodeServerPort: currentPort + 1 });
     }
     if (!isListening) {
+        if (options?.quiet) {
+            throw new Error(t('native.server.failedAfterRetries', { retries: maxRetries }));
+        }
         console.log(chalk.red.bold(t('native.server.failedAfterRetries', { retries: maxRetries })));
         process.exit(1);
     }
@@ -20790,37 +21501,1349 @@ function registerRoutes(app, options) {
 
 const outputDir = getOutputDir();
 const publicPath = path.join(__dirname, 'public');
-async function start() {
+async function start(options = {}) {
     const startTime = Date.now();
     const app = express();
     setupMiddlewares(app, { publicPath, outputDir });
     registerRoutes(app, { publicPath });
-    const { url, version } = await listen(app, { maxRetries: 20 });
-    console.log(chalk.green.bold(`TTMG`), chalk.green(`v${version}`), chalk.gray(t('native.server.readyIn')), chalk.bold(`${Date.now() - startTime}ms`));
-    showTips({ server: url });
+    const result = await listen(app, {
+        maxRetries: 20,
+        quiet: options.quiet,
+    });
+    const { url, version } = result;
+    if (!options.quiet) {
+        console.log(chalk.green.bold(`TTMG`), chalk.green(`v${version}`), chalk.gray(t('native.server.readyIn')), chalk.bold(`${Date.now() - startTime}ms`));
+        showTips({ server: url });
+    }
     // 联调场景下（root `dev:debug` 脚本）我们用 vite dev server 提供 IDE，
     // 不需要 CLI 自己再开浏览器到 dist/public 里那份打包后的旧 IDE。设置
     // `TTMG_DEV_NO_OPEN=1` 抑制 openUrl，由调度脚本统一负责开 5173。
     // 普通用户场景（npm 安装 ttmg）不会设置这个 env var，行为不变。
-    if (process.env.TTMG_DEV_NO_OPEN === '1') {
-        console.log(chalk.gray(`[dev-debug] TTMG_DEV_NO_OPEN=1 detected, skipping browser auto-open. Use vite dev server (likely http://localhost:5173) instead.`));
-        return;
+    if (options.openBrowser === false || process.env.TTMG_DEV_NO_OPEN === '1') {
+        if (!options.quiet && process.env.TTMG_DEV_NO_OPEN === '1') {
+            console.log(chalk.gray(`[dev-debug] TTMG_DEV_NO_OPEN=1 detected, skipping browser auto-open. Use vite dev server (likely http://localhost:5173) instead.`));
+        }
+        return result;
     }
     openUrl(url);
+    return result;
 }
 
+function buildDevLaunchUrl({ clientKey, host, hosts, wsPort, }) {
+    return `https://www.tiktok.com/ttmg/dev/${encodeURIComponent(clientKey)}?host=${encodeURIComponent(host)}&port=${wsPort}&host_list=${encodeURIComponent(JSON.stringify(hosts))}`;
+}
+class DevSessionReporter {
+    constructor(options) {
+        this.options = options;
+        this.seq = 0;
+        this.sessionId = (options.id || (() => `dev_${crypto.randomUUID()}`))();
+        this.startedAt = (this.options.now || Date.now)();
+        this.directory = path.resolve(options.rootDir || path.join('.ttmg', 'sessions', this.sessionId));
+        this.manifestFile = path.join(this.directory, 'manifest.json');
+        this.eventsFile = path.join(this.directory, 'events.ndjson');
+        this.actionsFile = path.join(this.directory, 'actions.ndjson');
+        this.screenshotsDirectory = path.join(this.directory, 'screenshots');
+        this.summaryFile = path.join(this.directory, 'summary.json');
+        this.qrFile = path.join(this.directory, 'launch.png');
+        fs.mkdirSync(this.directory, { recursive: true });
+        fs.mkdirSync(this.screenshotsDirectory, { recursive: true });
+        fs.writeFileSync(this.actionsFile, '', { flag: 'a' });
+    }
+    emit(type, payload, source = 'cli') {
+        const event = {
+            schemaVersion: '1',
+            sessionId: this.sessionId,
+            seq: ++this.seq,
+            ts: (this.options.now || Date.now)(),
+            source,
+            type,
+            payload,
+        };
+        const line = JSON.stringify(event);
+        fs.appendFileSync(this.eventsFile, `${line}\n`, 'utf8');
+        if (this.options.events === 'ndjson') {
+            (this.options.stdout || console.log)(line);
+        }
+        return event;
+    }
+    async writeReadyManifest({ pageUrl, version, hosts, httpPort, wsPort, }) {
+        const advertisedHost = hosts[0] || '127.0.0.1';
+        const rawUrl = buildDevLaunchUrl({
+            clientKey: this.options.clientKey,
+            host: advertisedHost,
+            hosts,
+            wsPort,
+        });
+        await QRCode.toFile(this.qrFile, rawUrl, { width: 320, margin: 2 });
+        const manifest = {
+            schemaVersion: '1',
+            cliVersion: version,
+            sessionId: this.sessionId,
+            status: 'ready',
+            project: {
+                clientKey: this.options.clientKey,
+                directory: process.cwd(),
+            },
+            process: {
+                pid: process.pid,
+                startedAt: this.startedAt,
+                command: 'ttmg dev',
+            },
+            endpoints: {
+                page: pageUrl,
+                runtimeWs: `ws://${advertisedHost}:${wsPort}`,
+            },
+            launch: {
+                rawUrl,
+                qrPayload: rawUrl,
+                qrPngPath: this.qrFile,
+            },
+            network: {
+                mode: hosts.length > 0 ? 'lan' : 'loopback',
+                advertisedHost,
+                hosts,
+                httpPort,
+                wsPort,
+            },
+            evidence: {
+                directory: this.directory,
+                manifest: this.manifestFile,
+                events: this.eventsFile,
+                actions: this.actionsFile,
+                screenshots: this.screenshotsDirectory,
+                summary: this.summaryFile,
+            },
+            capabilities: {
+                structuredEvents: true,
+                manualScan: true,
+                gameReadyProtocol: true,
+                gameReady: false,
+                deviceLaunch: false,
+                runtimeLogs: false,
+                screenshot: false,
+                actions: false,
+            },
+            errorCode: null,
+            error: null,
+        };
+        fs.writeFileSync(this.manifestFile, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+        return manifest;
+    }
+    writeFailedManifest(errorCode, error) {
+        const result = {
+            schemaVersion: '1',
+            sessionId: this.sessionId,
+            status: 'failed',
+            project: {
+                clientKey: this.options.clientKey,
+                directory: process.cwd(),
+            },
+            evidence: {
+                directory: this.directory,
+                manifest: this.manifestFile,
+                events: this.eventsFile,
+                actions: this.actionsFile,
+                screenshots: this.screenshotsDirectory,
+                summary: this.summaryFile,
+            },
+            errorCode,
+            error,
+        };
+        fs.writeFileSync(this.manifestFile, `${JSON.stringify(result, null, 2)}\n`, 'utf8');
+        return result;
+    }
+    writeSummary(status, reason, errorCode = null) {
+        const summary = {
+            schemaVersion: '1',
+            sessionId: this.sessionId,
+            status,
+            reason,
+            errorCode,
+            completedAt: (this.options.now || Date.now)(),
+        };
+        fs.writeFileSync(this.summaryFile, `${JSON.stringify(summary, null, 2)}\n`, 'utf8');
+        return summary;
+    }
+}
+function resolveDevSessionCompletion({ signal, timeoutSeconds, clientConnectedObserved, gameReadyObserved, }) {
+    if (gameReadyObserved) {
+        return {
+            status: 'passed',
+            reason: 'GAME_READY was observed from reportScene({ sceneId: 9999 }).',
+            errorCode: null,
+            exitCode: 0,
+        };
+    }
+    if (signal === 'TIMEOUT') {
+        const errorCode = clientConnectedObserved
+            ? 'GAME_READY_TIMEOUT'
+            : 'CLIENT_CONNECT_TIMEOUT';
+        return {
+            status: 'blocked',
+            reason: clientConnectedObserved
+                ? `The local DevTool session timed out after ${timeoutSeconds} seconds before GAME_READY.`
+                : `The local DevTool session timed out after ${timeoutSeconds} seconds before a client connected.`,
+            errorCode,
+            exitCode: 2,
+        };
+    }
+    return {
+        status: 'blocked',
+        reason: 'The local DevTool session stopped without GAME_READY evidence; device launch and runtime log capture are not enabled in this beta.',
+        errorCode: null,
+        exitCode: 0,
+    };
+}
+
+const defaultDependencies$3 = {
+    checkPackages: ttmgPack.checkPkgs,
+    operationId: () => `check_${crypto.randomUUID()}`,
+};
+function normalizeFormat$1(format) {
+    const value = (format || 'text').toLowerCase();
+    if (value !== 'text' && value !== 'json') {
+        throw new Error(t('check.error.invalidFormat', { format: value }));
+    }
+    return value;
+}
+function normalizeFailOn(failOn) {
+    const value = (failOn || 'error').toLowerCase();
+    if (value !== 'error' && value !== 'warning') {
+        throw new Error(t('check.error.invalidFailOn', { failOn: value }));
+    }
+    return value;
+}
+function codePart(value) {
+    return value
+        .replace(/[^a-zA-Z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .toUpperCase();
+}
+function toCheckDiagnostic(result) {
+    const type = result.type || 'unknown';
+    const name = result.name || result.dimension || 'project';
+    return {
+        code: `TTMG_CHECK_${codePart(type)}_${codePart(name)}`,
+        severity: result.level || (result.passed ? 'info' : 'error'),
+        passed: result.passed,
+        type,
+        dimension: result.dimension || 'project',
+        name,
+        required: result.required === true,
+        message: result.msg,
+        location: {
+            file: result.file || null,
+            files: Array.isArray(result.files) ? result.files : [],
+        },
+        metrics: {
+            sizeBytes: typeof result.size === 'number' ? result.size : null,
+        },
+        help: {
+            url: result.detail?.link || null,
+            text: result.detail?.text || null,
+        },
+    };
+}
+function createFailedReport({ operationId, directory, code, message, }) {
+    const diagnostic = {
+        code,
+        severity: 'error',
+        passed: false,
+        type: 'project',
+        dimension: 'project',
+        name: 'project',
+        required: true,
+        message,
+        location: { file: null, files: [] },
+        metrics: { sizeBytes: null },
+        help: { url: null, text: null },
+    };
+    return {
+        schemaVersion: '1',
+        operationId,
+        command: 'check',
+        status: 'failed',
+        project: { directory },
+        summary: { total: 1, passed: 0, warnings: 0, errors: 1 },
+        diagnostics: [diagnostic],
+        errorCode: code,
+        error: message,
+    };
+}
+async function executeCheck(options, dependencies = {}) {
+    const deps = { ...defaultDependencies$3, ...dependencies };
+    const operationId = deps.operationId();
+    const directory = path.resolve(process.cwd(), options.dir || '.');
+    if (!fs.existsSync(directory) || !fs.statSync(directory).isDirectory()) {
+        return createFailedReport({
+            operationId,
+            directory,
+            code: 'CHECK_DIRECTORY_NOT_FOUND',
+            message: t('check.error.dirNotExist', { dir: directory }),
+        });
+    }
+    const hasEntry = NATIVE_GAME_ENTRY_FILES.some(file => fs.existsSync(path.join(directory, file)));
+    if (!hasEntry) {
+        return createFailedReport({
+            operationId,
+            directory,
+            code: 'CHECK_INVALID_PROJECT',
+            message: t('native.check.notWorkspace'),
+        });
+    }
+    try {
+        const results = await deps.checkPackages({
+            entry: directory,
+            output: directory,
+            dev: {
+                enable: true,
+                enableSourcemap: false,
+                enableLog: false,
+            },
+            build: {
+                enableOdr: false,
+                enableAPICheck: true,
+                ...PKG_SIZE_LIMIT,
+            },
+        }, { lang: getCurrentLanguage() });
+        const allDiagnostics = results.map(toCheckDiagnostic);
+        const errors = allDiagnostics.filter(item => !item.passed && item.severity === 'error').length;
+        const warnings = allDiagnostics.filter(item => !item.passed && item.severity === 'warning').length;
+        const passed = allDiagnostics.filter(item => item.passed).length;
+        return {
+            schemaVersion: '1',
+            operationId,
+            command: 'check',
+            status: errors > 0 ? 'failed' : warnings > 0 ? 'warning' : 'passed',
+            project: { directory },
+            summary: {
+                total: allDiagnostics.length,
+                passed,
+                warnings,
+                errors,
+            },
+            diagnostics: options.includePassed
+                ? allDiagnostics
+                : allDiagnostics.filter(item => !item.passed),
+            errorCode: errors > 0 ? 'CHECK_FAILED' : null,
+            error: null,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return createFailedReport({
+            operationId,
+            directory,
+            code: 'CHECK_EXECUTION_FAILED',
+            message,
+        });
+    }
+}
+function printText(report) {
+    const color = report.status === 'failed'
+        ? chalk.red
+        : report.status === 'warning'
+            ? chalk.yellow
+            : chalk.green;
+    console.log(color.bold(t('check.summary', {
+        status: report.status,
+        passed: report.summary.passed,
+        warnings: report.summary.warnings,
+        errors: report.summary.errors,
+    })));
+    for (const diagnostic of report.diagnostics) {
+        const location = diagnostic.location.file
+            ? ` (${diagnostic.location.file})`
+            : '';
+        console.log(`${diagnostic.severity.toUpperCase()} ${diagnostic.code}: ${diagnostic.message}${location}`);
+        if (diagnostic.help.url)
+            console.log(`  ${diagnostic.help.url}`);
+    }
+}
+async function checkCommand(options = {}) {
+    let format = 'text';
+    let failOn = 'error';
+    try {
+        format = normalizeFormat$1(options.format);
+        failOn = normalizeFailOn(options.failOn);
+    }
+    catch (error) {
+        const report = createFailedReport({
+            operationId: `check_${crypto.randomUUID()}`,
+            directory: path.resolve(process.cwd(), options.dir || '.'),
+            code: 'CHECK_INVALID_ARGUMENT',
+            message: error instanceof Error ? error.message : String(error),
+        });
+        if (options.format === 'json')
+            console.log(JSON.stringify(report));
+        else
+            printText(report);
+        process.exitCode = 1;
+        return report;
+    }
+    const report = await executeCheck(options);
+    if (format === 'json')
+        console.log(JSON.stringify(report));
+    else
+        printText(report);
+    if (report.status === 'failed' ||
+        (failOn === 'warning' && report.status === 'warning')) {
+        process.exitCode = 1;
+    }
+    return report;
+}
+
+function normalizeFormat(format) {
+    const value = (format || 'text').toLowerCase();
+    if (value !== 'text' && value !== 'json') {
+        throw new Error(`Unsupported dev output format: ${value}. Use text or json.`);
+    }
+    return value;
+}
+function normalizeEvents(events) {
+    const value = (events || 'none').toLowerCase();
+    if (value !== 'none' && value !== 'ndjson') {
+        throw new Error(`Unsupported dev events format: ${value}. Use none or ndjson.`);
+    }
+    return value;
+}
+function normalizeTimeout(timeout) {
+    if (timeout === undefined || timeout === '')
+        return 0;
+    const seconds = Number(timeout);
+    if (!Number.isFinite(seconds) || seconds <= 0 || seconds > 86400) {
+        throw new Error('Unsupported dev timeout. Use a number of seconds between 1 and 86400.');
+    }
+    return Math.round(seconds * 1000);
+}
 async function dev(options = {}) {
-    await check();
-    await init({ clientKey: options.clientKey });
-    wsServer.start();
-    await start();
-    await compile();
-    listen$1();
-    watch();
+    const format = normalizeFormat(options.format);
+    const events = normalizeEvents(options.events);
+    if (format === 'json' && events === 'ndjson') {
+        throw new Error('Dev output modes cannot be combined. Use either --format json or --events ndjson.');
+    }
+    const structured = format === 'json' || events === 'ndjson';
+    const timeoutMs = normalizeTimeout(options.timeout);
+    if (timeoutMs > 0 && !structured) {
+        throw new Error('Dev timeout requires --format json or --events ndjson.');
+    }
+    const clientKey = options.clientKey?.trim() || '';
+    const reporter = structured
+        ? new DevSessionReporter({
+            clientKey,
+            rootDir: options.evidenceDir,
+            events,
+        })
+        : null;
+    let gameReadyObserved = false;
+    let clientConnectedObserved = false;
+    const unsubscribeClientEvents = reporter
+        ? eventEmitter.on('devSession', event => {
+            if (event.type === 'game_ready') {
+                gameReadyObserved = true;
+                reporter.emit('lifecycle', {
+                    state: 'GAME_READY',
+                    ...event.payload,
+                }, 'runtime');
+                return;
+            }
+            if (event.type === 'client_connected') {
+                clientConnectedObserved = true;
+            }
+            reporter.emit('client', {
+                state: event.type,
+                ...event.payload,
+            }, 'node');
+        })
+        : null;
+    try {
+        reporter?.emit('lifecycle', { state: 'CREATED' });
+        if (structured && !clientKey) {
+            throw new Error('Agent-friendly dev requires --client-key to avoid an interactive prompt.');
+        }
+        reporter?.emit('lifecycle', { state: 'CHECKING' });
+        await check({ throwOnError: structured, quiet: structured });
+        await init({ clientKey: options.clientKey });
+        wsServer.start({ quiet: structured });
+        const serverResult = await start({
+            openBrowser: options.noOpen !== true,
+            quiet: structured,
+        });
+        reporter?.emit('lifecycle', {
+            state: 'SERVER_READY',
+            page: serverResult.url,
+            httpPort: serverResult.port,
+            wsPort: store.getState().nodeWsPort,
+        }, 'node');
+        await compile({
+            mode: 'start',
+            quiet: structured,
+            throwOnError: structured,
+            onEvent: (state, error, checkResults) => reporter?.emit('compile', {
+                state,
+                error: error || null,
+                diagnostics: (checkResults || []).map(result => toCheckDiagnostic(result)),
+            }),
+        });
+        listen$1();
+        const watcher = await watch({
+            quiet: structured,
+            onCompileEvent: (state, error, checkResults) => reporter?.emit('compile', {
+                state,
+                error: error || null,
+                diagnostics: (checkResults || []).map(result => toCheckDiagnostic(result)),
+            }),
+        });
+        if (reporter) {
+            const manifest = await reporter.writeReadyManifest({
+                pageUrl: serverResult.url,
+                version: serverResult.version,
+                hosts: getLocalIPs(),
+                httpPort: serverResult.port,
+                wsPort: store.getState().nodeWsPort,
+            });
+            reporter.emit('lifecycle', {
+                state: 'READY',
+                manifest: reporter.manifestFile,
+            });
+            if (format === 'json')
+                console.log(JSON.stringify(manifest));
+            let stopping = false;
+            let timeoutTimer = null;
+            const stop = async (signal) => {
+                if (stopping)
+                    return;
+                stopping = true;
+                reporter.emit('lifecycle', { state: 'STOPPING', signal });
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                await watcher.close();
+                unsubscribeClientEvents?.();
+                wsServer.close();
+                await new Promise(resolve => serverResult.server.close(() => resolve()));
+                const completion = resolveDevSessionCompletion({
+                    signal,
+                    timeoutSeconds: timeoutMs / 1000,
+                    clientConnectedObserved,
+                    gameReadyObserved,
+                });
+                reporter.emit('lifecycle', {
+                    state: 'COMPLETED',
+                    signal,
+                    gameReadyObserved,
+                    errorCode: completion.errorCode,
+                });
+                reporter.writeSummary(completion.status, completion.reason, completion.errorCode);
+                process.exit(completion.exitCode);
+            };
+            if (timeoutMs > 0) {
+                timeoutTimer = setTimeout(() => void stop('TIMEOUT'), timeoutMs);
+            }
+            process.once('SIGINT', () => void stop('SIGINT'));
+            process.once('SIGTERM', () => void stop('SIGTERM'));
+        }
+    }
+    catch (error) {
+        if (!reporter)
+            throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        unsubscribeClientEvents?.();
+        wsServer.close();
+        const errorCode = !clientKey
+            ? 'CLIENT_KEY_REQUIRED'
+            : message.includes('project entry') || message.includes('工程入口')
+                ? 'INVALID_PROJECT'
+                : 'DEV_START_FAILED';
+        reporter.emit('lifecycle', {
+            state: 'FAILED',
+            errorCode,
+            error: message,
+        });
+        const failed = reporter.writeFailedManifest(errorCode, message);
+        reporter.writeSummary('failed', message, errorCode);
+        if (format === 'json')
+            console.log(JSON.stringify(failed));
+        process.exitCode = 1;
+        return failed;
+    }
+}
+
+const sourceExtensions = new Set(['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs']);
+const ignoredDirectories = new Set([
+    '.git',
+    '.ttmg',
+    'node_modules',
+    '__TTMG__',
+]);
+const maxFileBytes = 5 * 1024 * 1024;
+const maxScannedBytes = 100 * 1024 * 1024;
+const maxScannedFiles = 5000;
+const gameReadyPattern = /\breportScene\s*\(\s*\{[\s\S]{0,300}?(?:\bsceneId\b|['"]sceneId['"])\s*:\s*9999\b/;
+function scanGameReadySignal(directory) {
+    const pending = [directory];
+    let scannedFiles = 0;
+    let skippedFiles = 0;
+    let scannedBytes = 0;
+    let matchedFile = null;
+    let truncated = false;
+    while (pending.length > 0 && !matchedFile) {
+        const current = pending.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            skippedFiles += 1;
+            continue;
+        }
+        for (const entry of entries) {
+            if (matchedFile)
+                break;
+            const absolute = path.join(current, entry.name);
+            if (entry.isSymbolicLink()) {
+                skippedFiles += 1;
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (!ignoredDirectories.has(entry.name))
+                    pending.push(absolute);
+                continue;
+            }
+            if (!entry.isFile() || !sourceExtensions.has(path.extname(entry.name))) {
+                continue;
+            }
+            if (scannedFiles >= maxScannedFiles ||
+                scannedBytes >= maxScannedBytes) {
+                truncated = true;
+                break;
+            }
+            let stat;
+            try {
+                stat = fs.statSync(absolute);
+            }
+            catch {
+                skippedFiles += 1;
+                continue;
+            }
+            if (stat.size > maxFileBytes ||
+                scannedBytes + stat.size > maxScannedBytes) {
+                skippedFiles += 1;
+                continue;
+            }
+            try {
+                const source = fs.readFileSync(absolute, 'utf8');
+                scannedFiles += 1;
+                scannedBytes += stat.size;
+                if (gameReadyPattern.test(source)) {
+                    matchedFile = path.relative(directory, absolute) || entry.name;
+                }
+            }
+            catch {
+                skippedFiles += 1;
+            }
+        }
+    }
+    return {
+        confidence: 'static',
+        gameReadySignal: {
+            detected: matchedFile !== null,
+            file: matchedFile,
+            signal: 'reportScene({ sceneId: 9999 })',
+        },
+        scan: { scannedFiles, skippedFiles, scannedBytes, truncated },
+    };
+}
+function readinessDiagnostic(evidence) {
+    const detected = evidence.gameReadySignal.detected;
+    return {
+        code: 'TTMG_CHECK_AI_GAME_READY_SIGNAL',
+        severity: detected ? 'info' : 'warning',
+        passed: detected,
+        type: 'ai',
+        dimension: 'agent_debug',
+        name: 'game_ready_signal',
+        required: true,
+        message: detected
+            ? t('check.ai.gameReady.found')
+            : t('check.ai.gameReady.missing'),
+        location: {
+            file: evidence.gameReadySignal.file,
+            files: evidence.gameReadySignal.file
+                ? [evidence.gameReadySignal.file]
+                : [],
+        },
+        metrics: { sizeBytes: null },
+        help: { url: null, text: t('check.ai.gameReady.help') },
+    };
+}
+function emptyEvidence() {
+    return {
+        confidence: 'static',
+        gameReadySignal: {
+            detected: false,
+            file: null,
+            signal: 'reportScene({ sceneId: 9999 })',
+        },
+        scan: {
+            scannedFiles: 0,
+            skippedFiles: 0,
+            scannedBytes: 0,
+            truncated: false,
+        },
+    };
+}
+async function executeAiCheck(options, dependencies = {}) {
+    const directory = path.resolve(process.cwd(), options.dir || '.');
+    const base = await executeCheck({ ...options, includePassed: true }, {
+        ...dependencies,
+        operationId: dependencies.operationId || (() => `check_ai_${crypto.randomUUID()}`),
+    });
+    const canScan = base.errorCode !== 'CHECK_DIRECTORY_NOT_FOUND' &&
+        base.errorCode !== 'CHECK_INVALID_PROJECT';
+    const aiReadiness = canScan ? scanGameReadySignal(directory) : emptyEvidence();
+    const allDiagnostics = canScan
+        ? [...base.diagnostics, readinessDiagnostic(aiReadiness)]
+        : base.diagnostics;
+    const errors = allDiagnostics.filter(item => !item.passed && item.severity === 'error').length;
+    const warnings = allDiagnostics.filter(item => !item.passed && item.severity === 'warning').length;
+    const passed = allDiagnostics.filter(item => item.passed).length;
+    return {
+        schemaVersion: '1',
+        operationId: base.operationId,
+        command: 'check',
+        mode: 'ai',
+        status: errors > 0 ? 'failed' : warnings > 0 ? 'warning' : 'passed',
+        project: { directory },
+        summary: {
+            total: allDiagnostics.length,
+            passed,
+            warnings,
+            errors,
+        },
+        diagnostics: options.includePassed
+            ? allDiagnostics
+            : allDiagnostics.filter(item => !item.passed),
+        aiReadiness,
+        platformWrite: false,
+        errorCode: errors > 0 ? base.errorCode || 'CHECK_AI_FAILED' : null,
+        error: base.error,
+    };
+}
+function printAiText(report) {
+    const color = report.status === 'failed'
+        ? chalk.red
+        : report.status === 'warning'
+            ? chalk.yellow
+            : chalk.green;
+    console.log(color.bold(t('check.summary', {
+        status: report.status,
+        passed: report.summary.passed,
+        warnings: report.summary.warnings,
+        errors: report.summary.errors,
+    })));
+    for (const diagnostic of report.diagnostics) {
+        const location = diagnostic.location.file
+            ? ` (${diagnostic.location.file})`
+            : '';
+        console.log(`${diagnostic.severity.toUpperCase()} ${diagnostic.code}: ${diagnostic.message}${location}`);
+        if (diagnostic.help.text)
+            console.log(`  ${diagnostic.help.text}`);
+    }
+}
+async function aiCheckCommand(options = {}) {
+    let format = 'text';
+    let failOn = 'error';
+    try {
+        format = normalizeFormat$1(options.format);
+        failOn = normalizeFailOn(options.failOn);
+    }
+    catch (error) {
+        const report = {
+            schemaVersion: '1',
+            operationId: `check_ai_${crypto.randomUUID()}`,
+            command: 'check',
+            mode: 'ai',
+            status: 'failed',
+            project: { directory: path.resolve(process.cwd(), options.dir || '.') },
+            summary: { total: 1, passed: 0, warnings: 0, errors: 1 },
+            diagnostics: [],
+            aiReadiness: emptyEvidence(),
+            platformWrite: false,
+            errorCode: 'CHECK_INVALID_ARGUMENT',
+            error: error instanceof Error ? error.message : String(error),
+        };
+        if (options.format === 'json')
+            console.log(JSON.stringify(report));
+        else
+            printAiText(report);
+        process.exitCode = 1;
+        return report;
+    }
+    const report = await executeAiCheck(options);
+    if (format === 'json')
+        console.log(JSON.stringify(report));
+    else
+        printAiText(report);
+    if (report.status === 'failed' ||
+        (failOn === 'warning' && report.status === 'warning')) {
+        process.exitCode = 1;
+    }
+    return report;
+}
+
+const defaultDependencies$2 = {
+    buildPackages: ttmgPack.debugPkgs,
+    getPackages: ttmgPack.getPkgs,
+    now: () => Date.now(),
+    operationId: () => `build_${crypto.randomUUID()}`,
+};
+function failedReport({ operationId, directory, outputDirectory, durationMs, errorCode, error, diagnostics = [], }) {
+    return {
+        schemaVersion: '1',
+        operationId,
+        command: 'build',
+        status: 'failed',
+        project: { directory },
+        artifact: {
+            outputDirectory,
+            engine: 'unknown',
+            sourceSizeBytes: 0,
+            packageSummaries: [],
+            packages: {},
+            packageConfig: null,
+        },
+        summary: {
+            durationMs,
+            checks: diagnostics.length,
+            warnings: diagnostics.filter(item => !item.passed && item.severity === 'warning').length,
+            errors: Math.max(1, diagnostics.filter(item => !item.passed && item.severity === 'error')
+                .length),
+        },
+        diagnostics,
+        platformWrite: false,
+        errorCode,
+        error,
+    };
+}
+async function executeStructuredBuild(options, dependencies = {}) {
+    const deps = { ...defaultDependencies$2, ...dependencies };
+    const operationId = deps.operationId();
+    const startedAt = deps.now();
+    const directory = path.resolve(process.cwd(), options.dir || '.');
+    const outputDirectory = path.join(os.homedir(), '__TTMG__', 'build', operationId);
+    if (!fs.existsSync(directory) || !fs.statSync(directory).isDirectory()) {
+        return failedReport({
+            operationId,
+            directory,
+            outputDirectory,
+            durationMs: deps.now() - startedAt,
+            errorCode: 'BUILD_DIRECTORY_NOT_FOUND',
+            error: t('build.error.dirNotExist', { dir: directory }),
+        });
+    }
+    if (!NATIVE_GAME_ENTRY_FILES.some(file => fs.existsSync(path.join(directory, file)))) {
+        return failedReport({
+            operationId,
+            directory,
+            outputDirectory,
+            durationMs: deps.now() - startedAt,
+            errorCode: 'BUILD_INVALID_PROJECT',
+            error: t('native.check.notWorkspace'),
+        });
+    }
+    fs.mkdirSync(outputDirectory, { recursive: true });
+    try {
+        const result = await deps.buildPackages({
+            entry: directory,
+            output: outputDirectory,
+            dev: {
+                enable: true,
+                port: 0,
+                host: 'localhost',
+                enableSourcemap: false,
+                enableLog: false,
+            },
+            build: {
+                enableAPICheck: true,
+                enableOdr: false,
+                ...PKG_SIZE_LIMIT,
+            },
+        }, { lang: getCurrentLanguage() });
+        const allDiagnostics = (result.checkResults || []).map(toCheckDiagnostic);
+        const diagnostics = options.includePassed
+            ? allDiagnostics
+            : allDiagnostics.filter(item => !item.passed);
+        const errors = allDiagnostics.filter(item => !item.passed && item.severity === 'error').length;
+        const warnings = allDiagnostics.filter(item => !item.passed && item.severity === 'warning').length;
+        if (!result.isSuccess) {
+            return failedReport({
+                operationId,
+                directory,
+                outputDirectory,
+                durationMs: deps.now() - startedAt,
+                errorCode: 'BUILD_FAILED',
+                error: result.errorMsg || t('build.error.failed'),
+                diagnostics,
+            });
+        }
+        const packageSummary = await deps.getPackages({ entryDir: directory });
+        return {
+            schemaVersion: '1',
+            operationId,
+            command: 'build',
+            status: 'succeeded',
+            project: { directory },
+            artifact: {
+                outputDirectory,
+                engine: packageSummary.engine || 'unknown',
+                sourceSizeBytes: packageSummary.size || 0,
+                packageSummaries: packageSummary.packages || [],
+                packages: result.packages || {},
+                packageConfig: result.packageConfig || null,
+            },
+            summary: {
+                durationMs: deps.now() - startedAt,
+                checks: allDiagnostics.length,
+                warnings,
+                errors,
+            },
+            diagnostics,
+            platformWrite: false,
+            errorCode: null,
+            error: null,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return failedReport({
+            operationId,
+            directory,
+            outputDirectory,
+            durationMs: deps.now() - startedAt,
+            errorCode: 'BUILD_EXECUTION_FAILED',
+            error: message,
+        });
+    }
+}
+async function structuredBuildCommand(options = {}) {
+    if ((options.format || '').toLowerCase() !== 'json') {
+        console.error(t('build.error.invalidFormat', { format: options.format || '' }));
+        process.exitCode = 1;
+        return null;
+    }
+    const report = await executeStructuredBuild(options);
+    console.log(JSON.stringify(report));
+    if (report.status === 'failed')
+        process.exitCode = 1;
+    return report;
+}
+
+const defaultDependencies$1 = {
+    isProcessRunning: pid => {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (error) {
+            return error?.code === 'EPERM';
+        }
+    },
+    getProcessCommand: pid => {
+        try {
+            return child_process.execFileSync('ps', ['-p', String(pid), '-o', 'command='], {
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+        }
+        catch {
+            return '';
+        }
+    },
+    killProcess: pid => process.kill(pid, 'SIGTERM'),
+    sleep: ms => new Promise(resolve => setTimeout(resolve, ms)),
+};
+function parseJsonFile(file) {
+    if (!fs.existsSync(file))
+        return null;
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+function resolveSessionDirectory(sessionId, sessionsDir) {
+    if (!/^[a-zA-Z0-9._-]+$/.test(sessionId)) {
+        throw new Error(t('dev.session.error.invalidId', { sessionId }));
+    }
+    return path.resolve(sessionsDir || '.ttmg/sessions', sessionId);
+}
+function inspectDevSession(sessionId, options = {}, dependencies = {}) {
+    const deps = { ...defaultDependencies$1, ...dependencies };
+    let directory = '';
+    try {
+        directory = resolveSessionDirectory(sessionId, options.sessionsDir);
+        const manifest = parseJsonFile(path.join(directory, 'manifest.json'));
+        if (!manifest) {
+            return {
+                schemaVersion: '1',
+                command: 'dev.session.inspect',
+                status: 'not_found',
+                sessionId,
+                directory,
+                manifest: null,
+                summary: null,
+                eventCount: 0,
+                lastEvent: null,
+                process: { pid: null, running: false },
+                platformWrite: false,
+                errorCode: 'DEV_SESSION_NOT_FOUND',
+                error: t('dev.session.error.notFound', { sessionId }),
+            };
+        }
+        if (manifest.sessionId !== sessionId) {
+            throw new Error(t('dev.session.error.manifestMismatch'));
+        }
+        const summary = parseJsonFile(path.join(directory, 'summary.json'));
+        const eventsFile = path.join(directory, 'events.ndjson');
+        const eventLines = fs.existsSync(eventsFile)
+            ? fs.readFileSync(eventsFile, 'utf8').split('\n').filter(Boolean)
+            : [];
+        const lastEvent = eventLines.length
+            ? JSON.parse(eventLines[eventLines.length - 1])
+            : null;
+        const pid = Number(manifest.process?.pid) || null;
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.inspect',
+            status: 'found',
+            sessionId,
+            directory,
+            manifest,
+            summary,
+            eventCount: eventLines.length,
+            lastEvent,
+            process: {
+                pid,
+                running: pid ? deps.isProcessRunning(pid) : false,
+            },
+            platformWrite: false,
+            errorCode: null,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.inspect',
+            status: 'failed',
+            sessionId,
+            directory,
+            manifest: null,
+            summary: null,
+            eventCount: 0,
+            lastEvent: null,
+            process: { pid: null, running: false },
+            platformWrite: false,
+            errorCode: 'DEV_SESSION_READ_FAILED',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function listDevSessions(options = {}, dependencies = {}) {
+    const sessionsDirectory = path.resolve(options.sessionsDir || '.ttmg/sessions');
+    const sessionIds = fs.existsSync(sessionsDirectory)
+        ? fs
+            .readdirSync(sessionsDirectory, { withFileTypes: true })
+            .filter(entry => entry.isDirectory())
+            .map(entry => entry.name)
+            .sort()
+        : [];
+    const sessions = sessionIds
+        .map(sessionId => inspectDevSession(sessionId, options, dependencies))
+        .filter(result => result.status === 'found')
+        .map(result => ({
+        sessionId: result.sessionId,
+        directory: result.directory,
+        status: result.summary?.status || result.manifest?.status || 'unknown',
+        clientKey: result.manifest?.project?.clientKey || '',
+        running: result.process.running,
+        eventCount: result.eventCount,
+    }));
+    return {
+        schemaVersion: '1',
+        command: 'dev.session.list',
+        status: 'succeeded',
+        sessionsDirectory,
+        count: sessions.length,
+        sessions,
+        platformWrite: false,
+        errorCode: null,
+        error: null,
+    };
+}
+function readDevSessionEvents(sessionId, options = {}) {
+    const inspected = inspectDevSession(sessionId, options);
+    if (inspected.status !== 'found') {
+        return { ...inspected, command: 'dev.session.events' };
+    }
+    const after = Number(options.after || 0);
+    const limit = Number(options.limit || 100);
+    if (!Number.isInteger(after) ||
+        after < 0 ||
+        !Number.isInteger(limit) ||
+        limit < 1 ||
+        limit > 1000) {
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.events',
+            status: 'failed',
+            sessionId,
+            events: [],
+            cursor: { after, next: after, hasMore: false },
+            platformWrite: false,
+            errorCode: 'DEV_SESSION_INVALID_CURSOR',
+            error: t('dev.session.error.invalidCursor'),
+        };
+    }
+    try {
+        const eventsFile = path.join(inspected.directory, 'events.ndjson');
+        const allEvents = fs.existsSync(eventsFile)
+            ? fs
+                .readFileSync(eventsFile, 'utf8')
+                .split('\n')
+                .filter(Boolean)
+                .map(line => JSON.parse(line))
+                .filter(event => Number(event.seq) > after)
+            : [];
+        const events = allEvents.slice(0, limit);
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.events',
+            status: 'succeeded',
+            sessionId,
+            events,
+            cursor: {
+                after,
+                next: events.length ? Number(events[events.length - 1].seq) : after,
+                hasMore: allEvents.length > events.length,
+            },
+            platformWrite: false,
+            errorCode: null,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.events',
+            status: 'failed',
+            sessionId,
+            events: [],
+            cursor: { after, next: after, hasMore: false },
+            platformWrite: false,
+            errorCode: 'DEV_SESSION_EVENTS_READ_FAILED',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+async function stopDevSession(sessionId, options = {}, dependencies = {}) {
+    const deps = { ...defaultDependencies$1, ...dependencies };
+    const inspected = inspectDevSession(sessionId, options, deps);
+    if (inspected.status !== 'found') {
+        return { ...inspected, command: 'dev.session.stop' };
+    }
+    const pid = inspected.process.pid;
+    if (!pid || !inspected.process.running) {
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.stop',
+            status: 'not_running',
+            sessionId,
+            pid,
+            platformWrite: false,
+            errorCode: null,
+            error: null,
+        };
+    }
+    const processCommand = deps.getProcessCommand(pid);
+    if (!/(^|\s|\/)ttmg(\s|$).*\bdev\b|dist\/index\.js\s+dev\b/.test(processCommand)) {
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.stop',
+            status: 'failed',
+            sessionId,
+            pid,
+            platformWrite: false,
+            errorCode: 'DEV_SESSION_PROCESS_UNVERIFIED',
+            error: t('dev.session.error.unverifiedProcess'),
+        };
+    }
+    try {
+        deps.killProcess(pid);
+        for (let attempt = 0; attempt < 25; attempt += 1) {
+            if (!deps.isProcessRunning(pid)) {
+                return {
+                    schemaVersion: '1',
+                    command: 'dev.session.stop',
+                    status: 'stopped',
+                    sessionId,
+                    pid,
+                    platformWrite: false,
+                    errorCode: null,
+                    error: null,
+                };
+            }
+            await deps.sleep(100);
+        }
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.stop',
+            status: 'stopping',
+            sessionId,
+            pid,
+            platformWrite: false,
+            errorCode: null,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            schemaVersion: '1',
+            command: 'dev.session.stop',
+            status: 'failed',
+            sessionId,
+            pid,
+            platformWrite: false,
+            errorCode: 'DEV_SESSION_STOP_FAILED',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function printResult(result, format) {
+    if ((format || 'text').toLowerCase() === 'json') {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    if (result.status === 'failed' || result.status === 'not_found') {
+        process.exitCode = 1;
+    }
+    return result;
+}
+async function devSessionInspectCommand(sessionId, options = {}) {
+    return printResult(inspectDevSession(sessionId, options), options.format);
+}
+async function devSessionListCommand(options = {}) {
+    return printResult(listDevSessions(options), options.format);
+}
+async function devSessionEventsCommand(sessionId, options = {}) {
+    return printResult(readDevSessionEvents(sessionId, options), options.format);
+}
+async function devSessionStopCommand(sessionId, options = {}) {
+    return printResult(await stopDevSession(sessionId, options), options.format);
+}
+
+const defaultDependencies = {
+    nodeVersion: process.version,
+    getLocalIPs,
+    authenticated: () => Boolean(getCurrentUser()?.cookie),
+    proxyEnvironment: () => ({
+        http: Boolean(process.env.HTTP_PROXY || process.env.http_proxy),
+        https: Boolean(process.env.HTTPS_PROXY || process.env.https_proxy),
+        noProxy: Boolean(process.env.NO_PROXY || process.env.no_proxy),
+    }),
+};
+function getDoctorReport(options = {}, dependencies = {}) {
+    const deps = { ...defaultDependencies, ...dependencies };
+    const directory = path.resolve(process.cwd(), options.dir || '.');
+    const directoryExists = fs.existsSync(directory) && fs.statSync(directory).isDirectory();
+    const projectDetected = directoryExists &&
+        NATIVE_GAME_ENTRY_FILES.some(file => fs.existsSync(path.join(directory, file)));
+    const hosts = deps.getLocalIPs();
+    const nodeSupported = semver.satisfies(semver.coerce(deps.nodeVersion) || '0.0.0', pkg.engines.node);
+    const authenticated = deps.authenticated();
+    const diagnostics = [];
+    if (!nodeSupported) {
+        diagnostics.push({
+            code: 'DOCTOR_NODE_VERSION_UNSUPPORTED',
+            severity: 'error',
+            message: `Node.js ${deps.nodeVersion} does not satisfy ${pkg.engines.node}.`,
+        });
+    }
+    if (!projectDetected) {
+        diagnostics.push({
+            code: directoryExists
+                ? 'DOCTOR_PROJECT_NOT_FOUND'
+                : 'DOCTOR_DIRECTORY_NOT_FOUND',
+            severity: 'warning',
+            message: directoryExists
+                ? 'No Mini Game project entry file was found in the target directory.'
+                : 'The target directory does not exist.',
+        });
+    }
+    if (hosts.length === 0) {
+        diagnostics.push({
+            code: 'DOCTOR_LAN_ADDRESS_NOT_FOUND',
+            severity: 'warning',
+            message: 'No physical LAN IPv4 address was found; device debugging will fall back to loopback and require a manual network solution.',
+        });
+    }
+    if (!authenticated) {
+        diagnostics.push({
+            code: 'DOCTOR_AUTH_NOT_AVAILABLE',
+            severity: 'warning',
+            message: 'No reusable local developer session was found.',
+        });
+    }
+    const errors = diagnostics.filter(item => item.severity === 'error').length;
+    const warnings = diagnostics.filter(item => item.severity === 'warning').length;
+    return {
+        schemaVersion: '1',
+        command: 'doctor',
+        status: errors > 0 ? 'failed' : warnings > 0 ? 'warning' : 'passed',
+        cliVersion: pkg.version,
+        environment: {
+            nodeVersion: deps.nodeVersion,
+            requiredNodeRange: pkg.engines.node,
+            nodeSupported,
+            proxyConfigured: deps.proxyEnvironment(),
+        },
+        project: { directory, directoryExists, detected: projectDetected },
+        auth: { authenticated, remotelyVerified: false },
+        network: {
+            mode: hosts.length > 0 ? 'lan' : 'loopback',
+            selectedHost: hosts[0] || '127.0.0.1',
+            hosts,
+        },
+        summary: { errors, warnings },
+        diagnostics,
+        platformWrite: false,
+        errorCode: errors > 0 ? 'DOCTOR_FAILED' : null,
+        error: null,
+    };
+}
+async function doctor(options = {}) {
+    const report = getDoctorReport(options);
+    const format = (options.format || 'text').toLowerCase();
+    if (format === 'json')
+        console.log(JSON.stringify(report));
+    else
+        console.log(JSON.stringify(report, null, 2));
+    const failOnWarning = (options.failOn || 'error').toLowerCase() === 'warning';
+    if (report.status === 'failed' ||
+        (failOnWarning && report.status === 'warning')) {
+        process.exitCode = 1;
+    }
+    return report;
 }
 
 var index = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    dev: dev
+    build: structuredBuildCommand,
+    check: checkCommand,
+    checkAi: aiCheckCommand,
+    dev: dev,
+    devSessionEventsCommand: devSessionEventsCommand,
+    devSessionInspectCommand: devSessionInspectCommand,
+    devSessionListCommand: devSessionListCommand,
+    devSessionStopCommand: devSessionStopCommand,
+    doctor: doctor
 });
 //# sourceMappingURL=index.js.map