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

package/README.md

@@ -87,13 +87,15 @@ ttmg dev
 ```
 
 For Agent usage, pass the Client Key explicitly, suppress the browser, and
-request the session manifest plus NDJSON lifecycle events. The existing
-interactive `ttmg dev` flow is unchanged.
-Agent 调用时需显式传入 Client Key、禁止自动打开浏览器，并读取会话描述和 NDJSON 生命周期事件；原有交互式 `ttmg dev` 流程保持不变。
+choose either one JSON session manifest or an NDJSON lifecycle event stream.
+The two stdout modes are mutually exclusive. The existing interactive `ttmg
+dev` flow is unchanged.
+Agent 调用时需显式传入 Client Key、禁止自动打开浏览器，并在单份 JSON 会话描述和 NDJSON 生命周期事件流中二选一；两种 stdout 模式不能同时使用。原有交互式 `ttmg dev` 流程保持不变。
 
 ```
-ttmg dev --client-key <client-key> --format json --events ndjson --no-open
-ttmg dev --client-key <client-key> --format json --events ndjson --no-open --timeout 120
+ttmg dev --client-key <client-key> --format json --no-open
+ttmg dev --client-key <client-key> --events ndjson --no-open
+ttmg dev --client-key <client-key> --events ndjson --no-open --timeout 120
 ```
 
 The command writes `manifest.json`, `events.ndjson`, `actions.ndjson`,
@@ -191,6 +193,8 @@ The upload command packages the project and creates a new Developer Platform
 version. With `--preview`, it also waits for platform processing and returns the
 preview payload.
 上传命令会打包项目并在 Developer Platform 创建新版本；增加 `--preview` 后还会等待平台处理完成并返回预览地址。
+The upload ZIP excludes the root `.agent`, `.claude`, and `.trae` directories.
+上传 ZIP 不包含项目根目录下的 `.agent`、`.claude` 和 `.trae`。
 
 ```
 ttmg upload --preview --client-key <client-key> --dir <game-dir> --format ndjson

package/dist/index.js

@@ -7221,6 +7221,7 @@ const messages = {
         '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',
@@ -7441,6 +7442,7 @@ const messages = {
         '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 会话',
@@ -8226,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}/**`,
@@ -15117,7 +15122,7 @@ async function authStatus(options = {}) {
     return result;
 }
 
-var version = "0.4.6-vibe-beta.2";
+var version = "0.4.6-vibe-beta.3";
 var engines = {
 	node: ">=20.19.1 <21 || >=22"
 };
@@ -15173,7 +15178,9 @@ function getCapabilities() {
                 platformWrite: false,
             },
             dev: {
-                command: 'ttmg dev --format json --events ndjson --no-open',
+                command: 'ttmg dev --format json --no-open',
+                eventsCommand: 'ttmg dev --events ndjson --no-open',
+                outputModesMutuallyExclusive: true,
                 available: true,
                 platformWrite: false,
                 timeout: true,
@@ -15744,6 +15751,13 @@ const devCmd = program
     .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();
     }
@@ -21905,6 +21919,9 @@ function normalizeTimeout(timeout) {
 async function dev(options = {}) {
     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) {