@ttmg/cli 0.4.6-vibe-beta.11 → 0.4.6-vibe-beta.14

package/dist/index.js

@@ -7233,6 +7233,28 @@ const messages = {
         'cli.command.auth.desc': 'Inspect local authentication state',
         'cli.command.auth.open.desc': 'Open an existing Vibe task authorization page in the system browser',
         'cli.command.upload.vibeWeb': 'Authorize in the browser, then upload to PPE (--vibe; no Mock or --no-open)',
+        'cli.command.game.desc': 'Inspect game metadata supported by the platform',
+        'cli.command.game.categories.desc': 'List game categories and subcategories with gameplay descriptions (offline, read-only)',
+        'cli.command.game.categories.category': 'Filter by an exact category value, e.g. Puzzle',
+        'cli.command.game.categories.unknown': 'Unknown category. Run ttmg game categories --format json for valid values.',
+        'cli.command.game.categories.invalidFormat': 'Use text, json, or ndjson output.',
+        'cli.command.upload.vibeCategory': 'Optional game category; provide with --subcategory (--vibe). Query ttmg game categories --format json',
+        'cli.command.upload.vibeSubcategory': 'Optional subcategory belonging to --category; omit both to keep Other/Other (--vibe)',
+        'cli.command.upload.vibeWebGuide': `
+Vibe web upload (real PPE trial):
+  ttmg upload --vibe --web --dir ./game --title "My game" --icon ./avatar.png --format ndjson
+  Use --package ./game.zip instead of --dir for an existing ZIP.
+  Collect only title and icon; the CLI fills other app_info fields with PPE trial defaults.
+  Skill may query ttmg game categories --format json and pass --category Puzzle --subcategory Physics together.
+  Omit both to keep Other/Other (or the legacy metadata-file classification). Invalid pairs fail before task creation.
+  prepared and terminal events expose the submitted classification and its source.
+  Keep this process running. At waiting_authorization, complete authorization in the system browser on the CLI computer.
+  pageUrl is the local binding/progress page. To reopen authorization, execute the returned authorizationOpenCommand.
+  The CLI polls and uploads avatar, app_info and package automatically after authorization. Do not start a second upload.
+  Real success: terminal=true, status=uploaded, uploaded=true, simulation=false. On failure, read errorCode and nextAction.
+  --web opens the browser for every output format. --mock is a separate simulation mode.
+  Upload completion is not review approval or production release. See bundled vibe-upload.md and ttmg capabilities --format json.
+`,
         'cli.command.auth.open.pageUrl': 'Local pageUrl returned by the running Vibe upload command',
         'cli.command.auth.open.requested': 'Browser open requested. Complete authorization there; the existing upload process continues polling.',
         'cli.command.auth.open.invalidPage': 'Pass the local pageUrl from the running Vibe upload command, not the platform URL.',
@@ -7646,6 +7668,28 @@ const messages = {
         'cli.command.auth.desc': '查看本地登录状态',
         'cli.command.auth.open.desc': '在系统浏览器打开已有 Vibe 任务的授权页',
         'cli.command.upload.vibeWeb': '网页授权就绪后自动上传到 PPE（--vibe；不能与 Mock 或 --no-open 同用）',
+        'cli.command.game.desc': '查询平台支持的游戏资料',
+        'cli.command.game.categories.desc': '查询游戏类型、子类型及玩法说明（离线、只读）',
+        'cli.command.game.categories.category': '按类型的精确值筛选，例如 Puzzle',
+        'cli.command.game.categories.unknown': '类型不存在。使用 ttmg game categories --format json 查询有效值。',
+        'cli.command.game.categories.invalidFormat': '输出格式请使用 text、json 或 ndjson。',
+        'cli.command.upload.vibeCategory': '可选游戏类型，须与 --subcategory 同传（--vibe）；用 ttmg game categories --format json 查询',
+        'cli.command.upload.vibeSubcategory': '所属类型的可选子类型；两者均不传保留 Other/Other（--vibe）',
+        'cli.command.upload.vibeWebGuide': `
+Vibe 网页上传（真实 PPE 试用）：
+  ttmg upload --vibe --web --dir ./game --title "游戏名称" --icon ./avatar.png --format ndjson
+  已有 ZIP 时，用 --package ./game.zip 替换 --dir。
+  只收集标题和头像；其他 app_info 字段由 CLI 使用 PPE 试用默认值补齐。
+  Skill 可先查 ttmg game categories --format json，再成对传入 --category Puzzle --subcategory Physics。
+  两者均不传保留 Other/Other（旧资料文件调用保留文件分类）；无效组合在创建任务前报错。
+  prepared 和终态事件返回最终 classification 及其来源。
+  保持原进程运行。在 waiting_authorization 阶段，在 CLI 所在电脑的系统浏览器完成授权。
+  pageUrl 是本机绑定／进度页；重新打开授权页时，执行返回的 authorizationOpenCommand。
+  CLI 负责轮询，授权后自动上传 avatar、app_info、package，不再启动第二次上传。
+  真实成功：terminal=true、status=uploaded、uploaded=true、simulation=false。失败时读取 errorCode 和 nextAction。
+  --web 在所有输出格式下都会打开浏览器；--mock 是独立的模拟模式。
+  上传完成不代表审核通过或正式上线。详见包内 vibe-upload.md 和 ttmg capabilities --format json。
+`,
         'cli.command.auth.open.pageUrl': '正在运行的 Vibe 上传命令返回的本地 pageUrl',
         'cli.command.auth.open.requested': '已请求浏览器打开授权页。请在页面完成授权，原上传进程继续轮询。',
         'cli.command.auth.open.invalidPage': '请传入正在运行的 Vibe 上传命令返回的本地 pageUrl，不是平台授权链接。',
@@ -16308,7 +16352,7 @@ async function authStatus(options = {}) {
     return result;
 }
 
-var version = "0.4.6-vibe-beta.11";
+var version = "0.4.6-vibe-beta.14";
 var engines = {
 	node: ">=20.19.1 <21 || >=22"
 };
@@ -16324,6 +16368,10 @@ const VIBE_INPUT_REQUIREMENTS = {
     additionalMetadataSource: 'cli-defaults',
     defaultMetadataProfile: 'ppe-trial',
     requestAdditionalMetadata: false,
+    optionalSkillInputs: ['category', 'subcategory'],
+    categoryQuery: 'ttmg game categories --format json',
+    categoryPairRequiredWhenProvided: true,
+    defaultCategory: { category: 'Other', subcategory: 'Other' },
 };
 class VibeError extends Error {
     constructor(code) {
@@ -16332,6 +16380,703 @@ class VibeError extends Error {
     }
 }
 
+var catalogVersion = "sha256:f1d67b08cfbfb9396cba1ec246a84a4c1b6b2c9f077e236498c42e9c154b6900";
+var source = "bundled";
+var categories$1 = [
+	{
+		value: "Action",
+		subcategories: [
+			{
+				value: "Artillery Shooter",
+				description: "Turn based tactics game in which players aim and shoot other players"
+			},
+			{
+				value: "Asymmetric Battle",
+				description: "Game in which different players have different roles and capabilities as well as win condition (e.g. Identity 5)"
+			},
+			{
+				value: "Brawl",
+				description: "Multiplayer battle where player controls a character in team deathmatch battle without aiming a gun"
+			},
+			{
+				value: "Fighting",
+				description: "A game where the player controls a character to fight against other characters"
+			},
+			{
+				value: "MOBA",
+				description: "Multiplayer battle arena where the player controls a character on a team to destroy an enemy base"
+			},
+			{
+				value: "Music & Rhythm",
+				description: "Games that feature music as the primary gameplay driver"
+			},
+			{
+				value: "Open World",
+				description: "Action game in which players can explore the world and attempt objectives freely"
+			},
+			{
+				value: "Platformer",
+				description: "A game where players complete stages by avoiding obstacles and jumping between platforms"
+			},
+			{
+				value: "Royale Battle",
+				description: "Battle royale game (many players compete but with a single winner) that is action based and not a shooter"
+			},
+			{
+				value: "Run & Gun Platformer",
+				description: "Action games similar to side-scrolling platformers, but players are typically battling an onslaught of enemies appearing in front or behind them"
+			},
+			{
+				value: "Runner",
+				description: "A game where the player automatically progresses and must avoid obstacles to continue"
+			},
+			{
+				value: "Shark",
+				description: "Game in which the player eats other objects in the game to grow or stay alive"
+			},
+			{
+				value: "Shoot'em Up",
+				description: "A game where a lone unit (usually a spaceship) shoots projectiles against a large number of other enemies. Generally in a 2D movement space"
+			},
+			{
+				value: "Slicing (Slasher)",
+				description: "Game in which the main objective is to cut objects into pieces using a swiping motion"
+			},
+			{
+				value: "Stealth",
+				description: "Game where the player attempts to sneak around a game world and achieve objectives or escape"
+			},
+			{
+				value: "Adventure",
+				description: "Focuses on the actions themselves (shooting, twitch combat, etc.) or exploration of the world instead (finding non-gameplay collectables, solving puzzles, etc.) - Super Mario"
+			},
+			{
+				value: "Beat 'em up",
+				description: "Featuring hand-to-hand combat between the protagonist and an improbably large number of opponents."
+			},
+			{
+				value: "Other Action",
+				description: "Other general action gameplay or games that feature arcade-style gameplay"
+			}
+		]
+	},
+	{
+		value: "Match",
+		subcategories: [
+			{
+				value: "Blast-Meta",
+				description: "Blast-style game with a heavy emphasis on an investable meta game system"
+			},
+			{
+				value: "Blast-Saga",
+				description: "Game where primary mechanic involves blasting/removing adjacent like items with saga based progression"
+			},
+			{
+				value: "Bubble Shooter",
+				description: "Game where bubbles are shot at different angles clearing groups of bubbles arranged on top of screen"
+			},
+			{
+				value: "Connect Tiles",
+				description: "Game in which two like tiles are linked via a pathway on a board and removed from the board"
+			},
+			{
+				value: "Line-Saga",
+				description: "Game where a line is created between like items to remove them from the board with saga based progression"
+			},
+			{
+				value: "M3-Meta",
+				description: "Match 3 swapping game with a focus on some form of building in its meta game"
+			},
+			{
+				value: "M3-Saga",
+				description: "Primary gameplay mechanism is matching 3 items on screen and swapping matched items"
+			},
+			{
+				value: "Merge-Saga",
+				description: "Game with focus on merging like items to create more powerful units or items and utilizing saga based progression"
+			},
+			{
+				value: "Other-Meta",
+				description: "Other match style game with a heavy emphasis on an investable meta game system"
+			},
+			{
+				value: "Other Match",
+				description: "Other kind of matching game"
+			}
+		]
+	},
+	{
+		value: "Puzzle",
+		subcategories: [
+			{
+				value: "Block Puzzle",
+				description: "Game in which players need to fit different shaped block pieces to fit onto a game board efficiently"
+			},
+			{
+				value: "Brain Puzzle",
+				description: "Knowledge or intelligence-based puzzle games"
+			},
+			{
+				value: "Brick-crusher",
+				description: "A bubble shooter game featuring many balls shot, high action, and real time (not turn based) gameplay"
+			},
+			{
+				value: "Detective",
+				description: "Game in which players must solve puzzles based on various clues and involves solving a narrative arc"
+			},
+			{
+				value: "Hidden Object",
+				description: "Games where the primary objective is identifying visual elements"
+			},
+			{
+				value: "Hybrid Puzzle",
+				description: "Puzzle game involving multiple types of puzzles instead of focusing on just one"
+			},
+			{
+				value: "Jigsaw",
+				description: "Jigsaw puzzle game"
+			},
+			{
+				value: "Klotski",
+				description: "A sliding block puzzle game"
+			},
+			{
+				value: "Maze",
+				description: "Game in which players must determine paths out of a maze"
+			},
+			{
+				value: "Minesweeper",
+				description: "Games similar to the classic Minesweeper game"
+			},
+			{
+				value: "Nonogram",
+				description: "Game in which cells in a grid are colored or left blank according to numbers on the side of a grid to reveal a hidden picture"
+			},
+			{
+				value: "Physics",
+				description: "Games that utilize a physics engine-based primary gameplay mechanism"
+			},
+			{
+				value: "Room Escape",
+				description: "Puzzles focused on progressing a player to escape from a room or building"
+			},
+			{
+				value: "Spot the Difference",
+				description: "Matching images and determining the difference between the images"
+			},
+			{
+				value: "Sudoku",
+				description: "Sudoku based game"
+			},
+			{
+				value: "Tile-Matching",
+				description: "Game in which tiles are matched to remove them from the game board (like Tetris)"
+			},
+			{
+				value: "Word",
+				description: "Word Games"
+			},
+			{
+				value: "Other Puzzle",
+				description: "Puzzle-based games that do not fall into the above categories"
+			}
+		]
+	},
+	{
+		value: "Racing",
+		subcategories: [
+			{
+				value: "Arcade Racing",
+				description: "Casual and fun racing arcade type of game"
+			},
+			{
+				value: "Competitive Racing",
+				description: "PVP Racing that can use a variety of control schemes"
+			},
+			{
+				value: "Simulation Racing",
+				description: "Simulated game of realistic racing"
+			}
+		]
+	},
+	{
+		value: "RPG",
+		subcategories: [
+			{
+				value: "Empire Simulation RPG",
+				description: "RPG game in which the player rules an empire or kingdom of some kind"
+			},
+			{
+				value: "Idle RPG",
+				description: "Squad based RPG that includes idle progression mechanics"
+			},
+			{
+				value: "Location RPG",
+				description: "Game where location plays a critical component in the core gameplay"
+			},
+			{
+				value: "MMORPG",
+				description: "Massively multiplayer online role-playing game typically featuring worlds or servers with hundreds or thousands of players online simultaneously"
+			},
+			{
+				value: "Open World RPG",
+				description: "RPG game where players traverse an open world relatively freely"
+			},
+			{
+				value: "Puzzle RPG",
+				description: "RPG games that utilize a puzzle system as the primary combat mechanism"
+			},
+			{
+				value: "Roguelike ARPG",
+				description: "ARPG with roguelike (sub-genre of role-playing games characterized by the exploration of randomly-generated dungeons and permanent death) gameplay elements (e.g. Hades)"
+			},
+			{
+				value: "Survival",
+				description: "RPG based game with a strong focus on crafting mechanics"
+			},
+			{
+				value: "Tactics",
+				description: "RPG game involving turn based movement of different characters on a tile-based map"
+			},
+			{
+				value: "Team Battle",
+				description: "RPG where you control multiple characters to advance the gameplay and story"
+			},
+			{
+				value: "Tower Defense RPG",
+				description: "Tower defense game with a strong emphasis on character collection and stateful upgrading"
+			},
+			{
+				value: "Other RPG",
+				description: "Other RPG Game"
+			}
+		]
+	},
+	{
+		value: "Shooting",
+		subcategories: [
+			{
+				value: "Battle Royale",
+				description: "Shooter game in which battle royale is the primary game mode"
+			},
+			{
+				value: "Cover-fire",
+				description: "Shooting game where the player takes cover and shoots out of cover"
+			},
+			{
+				value: "PvE Shooting",
+				description: "Shooter game in which players primarily battle against computer generated, player-vs-environment enemies"
+			},
+			{
+				value: "Sniper",
+				description: "Shooting game focused on small number of accurate shots through a scope"
+			},
+			{
+				value: "Team Deathmatch",
+				description: "Shooter game in which team deathmatch is the primary gameplay mode"
+			}
+		]
+	},
+	{
+		value: "Simulation",
+		subcategories: [
+			{
+				value: "Animal Avatar",
+				description: "Game in which players take the form and play as an animal in a virtual world"
+			},
+			{
+				value: "Avatar Life",
+				description: "Simulated life based on avatars in an alternate reality world"
+			},
+			{
+				value: "Build Breed",
+				description: "Games in which the player grows a city used to breed creatures for combat"
+			},
+			{
+				value: "Building",
+				description: "Games focused on building up a city with limited/no focus on combat"
+			},
+			{
+				value: "Creative Sandbox",
+				description: "Players have tools to create user generated levels or games shared with the overall game community"
+			},
+			{
+				value: "Dress Up & Lifestyle",
+				description: "Games built around dressing up avatars and simulated life-like experiences with emphasis on lifestyle"
+			},
+			{
+				value: "Driving",
+				description: "Games where the primary gameplay loop is centered around simulating driving or parking (non-competitive)."
+			},
+			{
+				value: "Farming",
+				description: "Farming-based simulation titles"
+			},
+			{
+				value: "Home Design",
+				description: "Games involving decorating homes"
+			},
+			{
+				value: "Idle",
+				description: "Games where game progression continues even when a player leaves the game session"
+			},
+			{
+				value: "Idol Training Sim",
+				description: "Game in which players train and level up Japanese style idols against different types of activities or professions"
+			},
+			{
+				value: "Life Simulator",
+				description: "Simulation of a virtual character from birth to death in which the player makes different life choices"
+			},
+			{
+				value: "Manager",
+				description: "Games simulating the management of a team or business"
+			},
+			{
+				value: "Pet",
+				description: "Games where the primary gameplay loop is centered around raising a pet (non-combat)"
+			},
+			{
+				value: "Time Management",
+				description: "Simulation games where players are challenged to complete tasks or quests within a specific (usually short) time frame"
+			},
+			{
+				value: "Weapon Simulator",
+				description: "Video game that focuses on simulating the experience of using various weapons. These games aim to provide players with a realistic or immersive representation of different types of firearms, melee weapons, or other tools used in combat"
+			},
+			{
+				value: "Other Sim",
+				description: "Other Sim/Management games"
+			}
+		]
+	},
+	{
+		value: "Sports",
+		subcategories: [
+			{
+				value: "Arcade Sports",
+				description: "Sports games where gameplay focuses on non-realistic simulation of gameplay"
+			},
+			{
+				value: "Simulation Sports",
+				description: "Sports games where the gameplay focuses on realistic simulation of gameplay"
+			},
+			{
+				value: "Team Manager",
+				description: "Sports games where the player focuses on manage a team"
+			},
+			{
+				value: "Other Sports",
+				description: "Other Sports Games"
+			}
+		]
+	},
+	{
+		value: "Strategy",
+		subcategories: [
+			{
+				value: "4X March-Battle",
+				description: "Games where player grows a city, builds an army that attacks through timed marches on a map"
+			},
+			{
+				value: "Auto Chess",
+				description: "Tactical strategy game with drafting and in which play is conducted PVP in multiple rounds"
+			},
+			{
+				value: "Build-Battle",
+				description: "Games focused on building troops that attack enemies and can be lost. City building is usually used to upgrade troops."
+			},
+			{
+				value: "CCG-Battle",
+				description: "Strategy game based on card decks typically associated with mana costs to play"
+			},
+			{
+				value: "Lane-Battle",
+				description: "Strategy game involving multiple lanes where units are sent down a specific lane to battle"
+			},
+			{
+				value: "Legion Battle",
+				description: "Game with a focus on building different types of army units and battling other players' armies"
+			},
+			{
+				value: "Summon-Battle",
+				description: "Games where units are summoned via some means (e.g., cards or mana) and then auto-battle"
+			},
+			{
+				value: "Tower Defense Strategy",
+				description: "Games where players establish defenses against NPC enemies that attack the player at regular intervals"
+			},
+			{
+				value: "RTS",
+				description: "Real-time Strategy is a strategy game that allow all users to play simultaneously instead of processing incrementally in turns"
+			},
+			{
+				value: "Other Strategy",
+				description: "Other strategy games"
+			}
+		]
+	},
+	{
+		value: "Party",
+		subcategories: [
+			{
+				value: "Guess Something",
+				description: "Social game in which players must guess what another player has in mind from different kinds of hints or drawings"
+			},
+			{
+				value: "Karaoke",
+				description: "A Karaoke game is a type of video or computer game that simulates the experience of karaoke singing"
+			},
+			{
+				value: "Dancing",
+				description: "Video game that involves gameplay elements centered around dance and rhythm. These games often require players to mimic dance moves or follow on-screen prompts in synchronization with music."
+			},
+			{
+				value: "Mafia/Betrayal",
+				description: "Mafia based game"
+			},
+			{
+				value: "Mini Games Collection",
+				description: "Multiplayer social game in which players can choose to play from a collection of multiple minigames"
+			},
+			{
+				value: "Party Royale",
+				description: "Party based battle royale game"
+			},
+			{
+				value: "Quiz",
+				description: "Game involving trivia or quizzes"
+			},
+			{
+				value: "Other Party",
+				description: "Other party game"
+			}
+		]
+	},
+	{
+		value: "Tabletop",
+		subcategories: [
+			{
+				value: "Board Game",
+				description: "Board game is a game that involves the movement of counters or other objects round a board."
+			},
+			{
+				value: "Card Games",
+				description: "[Non gambling] A card game is any game using playing cards as the primary device with which the game is played, be they traditional or game-specific"
+			},
+			{
+				value: "Chess",
+				description: "Chess is a board game for two players, called White and Black. It is sometimes called international chess or Western chess"
+			},
+			{
+				value: "Dice",
+				description: "Dice games are games that use or incorporate one or more dice as their sole or central component, usually as a random device"
+			},
+			{
+				value: "Ludo",
+				description: "Ludo is a strategy board game for two to four players, in which the players race their four tokens from start to finish according to the rolls of a single die"
+			},
+			{
+				value: "Othello",
+				description: "Game based on the classic Othello game"
+			},
+			{
+				value: "Solitaire",
+				description: "Solitaire games are card based games that can be played by a single player."
+			},
+			{
+				value: "Other Tabletop",
+				description: "Other tabletop game"
+			}
+		]
+	},
+	{
+		value: "Other",
+		subcategories: [
+			{
+				value: "Other",
+				description: "Game that doesn't fit in any of the other categories"
+			}
+		]
+	}
+];
+var catalog = {
+	catalogVersion: catalogVersion,
+	source: source,
+	categories: categories$1
+};
+
+const GAME_CATEGORY_CATALOG_VERSION = catalog.catalogVersion;
+const GAME_CATEGORIES = catalog.categories;
+function isGameCategoryPair(category, subcategory) {
+    return GAME_CATEGORIES.some(item => item.value === category &&
+        item.subcategories.some(child => child.value === subcategory));
+}
+function getGameCategories(options = {}) {
+    const errorCode = !['text', 'json', 'ndjson'].includes(options.format || 'text')
+        ? 'GAME_CATEGORIES_INVALID_FORMAT'
+        : options.category !== undefined && !GAME_CATEGORIES.some(item => item.value === options.category)
+            ? 'GAME_CATEGORY_UNKNOWN' : null;
+    const categories = errorCode ? [] : GAME_CATEGORIES.filter(item => options.category === undefined || item.value === options.category);
+    return {
+        schemaVersion: '1',
+        command: 'game categories',
+        operationId: `game_categories_${crypto.randomUUID()}`,
+        status: errorCode ? 'failed' : 'ready',
+        terminal: true,
+        platformWrite: false,
+        catalogVersion: GAME_CATEGORY_CATALOG_VERSION,
+        source: catalog.source,
+        descriptionLanguage: 'en',
+        categoryCount: categories.length,
+        subcategoryCount: categories.reduce((count, item) => count + item.subcategories.length, 0),
+        categories,
+        errorCode,
+        error: errorCode ? t(errorCode === 'GAME_CATEGORY_UNKNOWN'
+            ? 'cli.command.game.categories.unknown' : 'cli.command.game.categories.invalidFormat') : null,
+    };
+}
+function gameCategories(options) {
+    const result = getGameCategories(options);
+    if (options.format && options.format !== 'text')
+        console.log(JSON.stringify(result));
+    else if (result.error)
+        console.error(result.error);
+    else
+        for (const category of result.categories) {
+            console.log(category.value);
+            for (const item of category.subcategories)
+                console.log(`  ${item.value}: ${item.description}`);
+        }
+    if (result.errorCode)
+        process.exitCode = 1;
+}
+
+var categories = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    GAME_CATEGORIES: GAME_CATEGORIES,
+    GAME_CATEGORY_CATALOG_VERSION: GAME_CATEGORY_CATALOG_VERSION,
+    gameCategories: gameCategories,
+    getGameCategories: getGameCategories,
+    isGameCategoryPair: isGameCategoryPair
+});
+
+// Current PPE trial defaults: the owner-approved metadata used by the successful
+// real upload fixture on 2026-09-14, with owner-specified legal URLs updated on
+// 2026-09-15. This is not a production metadata profile.
+const VIBE_PPE_DEFAULT_APP_INFO = Object.freeze({
+    description: 'DevTool PPE integration test fixture. Not a production game.',
+    category: 'Other',
+    subcategory: 'Other',
+    terms_of_service: 'https://www.tiktok.com',
+    privacy_policy: 'https://www.tiktok.com',
+    copyright_confirmation: true,
+    contact_email: 'devtool-test@example.invalid',
+});
+// BFF IDL + Import Service ValidateAppInfo, feat-minis-import (2026-09-14).
+// Keep credentials, app_name and icon_uri out of this file: CLI owns those fields.
+const requiredStrings = [
+    'description', 'category', 'subcategory', 'terms_of_service', 'privacy_policy',
+];
+const optionalStrings = ['apple_team_id', 'contact_email', 'region', 'min_sdk_version'];
+function applyVibeCategory(options, appInfo) {
+    if (options.category === undefined && options.subcategory === undefined)
+        return appInfo;
+    if (options.category === undefined || options.subcategory === undefined)
+        throw new VibeError('VIBE_CATEGORY_PAIR_REQUIRED');
+    if (!isGameCategoryPair(options.category, options.subcategory))
+        throw new VibeError('VIBE_INVALID_CATEGORY');
+    return { ...(appInfo || VIBE_PPE_DEFAULT_APP_INFO), category: options.category, subcategory: options.subcategory };
+}
+function readVibeAppInfo(file) {
+    if (file === undefined)
+        return undefined;
+    try {
+        const stat = fs.statSync(file);
+        if (!stat.isFile() || stat.size > 64 * 1024)
+            throw new Error();
+        const value = JSON.parse(fs.readFileSync(file, 'utf8'));
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw new Error();
+        const allowed = new Set([...requiredStrings, ...optionalStrings, 'copyright_confirmation']);
+        if (Object.keys(value).some(key => !allowed.has(key)))
+            throw new Error();
+        // JSON can encode lone surrogates that Go rejects as invalid UTF-8 input.
+        for (const item of Object.values(value)) {
+            if (typeof item === 'string' && [...item].some(char => /^[\uD800-\uDFFF]$/.test(char)))
+                throw new Error();
+        }
+        for (const key of requiredStrings) {
+            if (typeof value[key] !== 'string' || !value[key].trim())
+                throw new Error();
+        }
+        for (const key of optionalStrings) {
+            if (value[key] !== undefined && (typeof value[key] !== 'string' || !value[key].trim()))
+                throw new Error();
+        }
+        // An explicit declaration is required; never infer consent or supply a default.
+        if (value.copyright_confirmation !== true)
+            throw new Error();
+        for (const key of ['terms_of_service', 'privacy_policy']) {
+            if (/\s/.test(value[key]))
+                throw new Error();
+            const url = new URL(value[key]);
+            if (!['http:', 'https:'].includes(url.protocol) || !url.hostname || url.username || url.password)
+                throw new Error();
+        }
+        if (value.contact_email !== undefined && !/^[^\s<>@]+@[^\s<>@]+$/.test(value.contact_email))
+            throw new Error();
+        return value;
+    }
+    catch {
+        // Do not expose paths, file contents or parser errors in structured output.
+        throw new VibeError('VIBE_INVALID_APP_INFO');
+    }
+}
+const VIBE_PLATFORM_ICON_LIMIT = 5 * 1024 * 1024;
+// Header preflight only. The BFF remains responsible for decoding the image.
+function validateVibeUploadInput(input) {
+    if ([...input.title].length > 30)
+        throw new VibeError('VIBE_TITLE_TOO_LONG');
+    const image = input.icon.bytes;
+    if (image.length > VIBE_PLATFORM_ICON_LIMIT)
+        throw new VibeError('VIBE_PLATFORM_ICON_INVALID');
+    let width = 0, height = 0;
+    if (image.length >= 33 && image.subarray(0, 8).equals(Buffer.from('89504e470d0a1a0a', 'hex')) &&
+        image.readUInt32BE(8) === 13 && image.toString('ascii', 12, 16) === 'IHDR') {
+        width = image.readUInt32BE(16);
+        height = image.readUInt32BE(20);
+    }
+    else if (image[0] === 0xff && image[1] === 0xd8) {
+        let offset = 2;
+        while (offset + 4 <= image.length) {
+            if (image[offset++] !== 0xff)
+                break;
+            while (image[offset] === 0xff)
+                offset++;
+            const marker = image[offset++];
+            if (marker === 0xda || marker === 0xd9)
+                break;
+            if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
+                continue;
+            if (offset + 2 > image.length)
+                break;
+            const length = image.readUInt16BE(offset);
+            if (length < 2 || offset + length > image.length)
+                break;
+            // Go image/jpeg accepts baseline, extended sequential and progressive SOF.
+            if ([0xc0, 0xc1, 0xc2].includes(marker) && length >= 8) {
+                height = image.readUInt16BE(offset + 3);
+                width = image.readUInt16BE(offset + 5);
+                break;
+            }
+            offset += length;
+        }
+    }
+    if (width !== 1024 || height !== 1024)
+        throw new VibeError('VIBE_PLATFORM_ICON_INVALID');
+}
+
 function getCapabilities() {
     return {
         schemaVersion: '1',
@@ -16343,8 +17088,22 @@ function getCapabilities() {
             stdoutProtocolOnly: true,
         },
         commands: {
+            gameCategories: {
+                command: 'ttmg game categories --format json',
+                available: true,
+                schemaVersion: '1',
+                platformWrite: false,
+                source: 'bundled',
+                catalogVersion: GAME_CATEGORY_CATALOG_VERSION,
+                filterOption: '--category',
+                includesGameplayDescriptions: true,
+                requiresLogin: false,
+                networkRequired: false,
+            },
             vibeUpload: {
-                command: 'ttmg upload --vibe --mock --format ndjson',
+                command: 'ttmg upload --vibe --web --dir <gameDir> --title <title> --icon <iconPath> --format ndjson',
+                mockCommand: 'ttmg upload --vibe --mock --dir <gameDir> --title <title> --icon <iconPath> --format ndjson',
+                guide: 'vibe-upload.md',
                 option: '--vibe',
                 available: true,
                 platformWrite: true,
@@ -16374,12 +17133,42 @@ function getCapabilities() {
                 sourceProjectIdentity: '.ttmg/vibe-project.json',
                 metadataInputs: ['title', 'icon', 'dir|package'],
                 inputRequirements: VIBE_INPUT_REQUIREMENTS,
+                classification: {
+                    queryCommand: 'ttmg game categories --format json',
+                    options: ['--category', '--subcategory'],
+                    suppliedTogether: true,
+                    default: { category: 'Other', subcategory: 'Other' },
+                    invalidPair: 'reject-before-task-creation',
+                    legacyAppInfo: 'preserved-when-options-omitted; explicit-pair-overrides-category-fields',
+                    resultField: 'classification',
+                },
                 webAuthorization: { option: '--web', backend: 'ppe', defaultLane: 'ppe_op_vc', simulation: false, opensSystemBrowser: true, continuesPolling: true, formatIndependent: true, conflictsWith: ['--mock', '--mock-scenario', '--vibe-api', '--no-open'], mockBehaviorUnchanged: true, materialUploadEnabled: true },
+                skillWorkflow: {
+                    preferredFormat: 'ndjson',
+                    packageAlternative: '--package <zipPath> replaces --dir <gameDir>',
+                    keepUploadProcessRunning: true,
+                    pollingOwner: 'cli',
+                    uploadOwner: 'cli',
+                    waitingAuthorization: {
+                        status: 'waiting_authorization',
+                        userAction: 'complete authorization in the system browser on the CLI computer',
+                        pageUrlField: 'pageUrl',
+                        pageUrlPurpose: 'local binding and upload progress page',
+                        reopenCommandField: 'authorizationOpenCommand',
+                        browserOpenRequestedProvesAuthorization: false,
+                        createAnotherUploadTask: false,
+                    },
+                    realUploadSuccess: { terminal: true, status: 'uploaded', uploaded: true, simulation: false },
+                    failure: 'Read errorCode and nextAction; do not automatically create another task or reupload',
+                    completionMeaning: 'materials uploaded to PPE; review and production release are separate',
+                    sameHostRequired: true,
+                },
                 optionalMetadataFile: '--app-info',
                 appInfoFields: {
                     required: [],
                     optional: [],
                     suppliedByCli: ['app_name', 'icon_uri'],
+                    defaultedByCli: Object.keys(VIBE_PPE_DEFAULT_APP_INFO),
                     additionalMetadataSource: 'cli-defaults',
                     defaultMetadataProfile: 'ppe-trial',
                     requestFromUser: false,
@@ -16410,8 +17199,9 @@ function getCapabilities() {
                 httpContract: 'minis-import-task',
                 authorizationQr: true,
                 previewQr: false,
-                realAuthorizationVerified: false,
-                realUploadVerified: false,
+                realAuthorizationVerified: true,
+                realUploadVerified: true,
+                verificationScope: { backend: 'ppe', assets: 'test-fixtures', date: '2026-09-15', production: false },
                 autoUploadAfterAuthorization: true,
                 boundedPolling: true,
                 cancellation: true,
@@ -17109,6 +17899,14 @@ withVerboseOption(program.command('logout').description(t('cli.command.logout.de
     await logout();
 });
 const authCmd = program.command('auth').description(t('cli.command.auth.desc'));
+const gameCmd = program.command('game').description(t('cli.command.game.desc'));
+withVerboseOption(gameCmd.command('categories')
+    .description(t('cli.command.game.categories.desc'))
+    .option('--category <category>', t('cli.command.game.categories.category'))
+    .option('--format <format>', t('cli.command.capabilities.format'), 'text')).action(async (cmd) => {
+    const { gameCategories } = await Promise.resolve().then(function () { return categories; });
+    gameCategories(cmd);
+});
 withVerboseOption(authCmd.command('open')
     .description(t('cli.command.auth.open.desc'))
     .option('--page-url <url>', t('cli.command.auth.open.pageUrl'))
@@ -17146,6 +17944,8 @@ withVerboseOption(program
     // Vibe v2 backend selection (including opt-in ppe-mock) stays outside the Skill workflow.
     .option('--title <title>', t('cli.command.upload.vibeTitle'))
     .option('--icon <path>', t('cli.command.upload.vibeIcon'))
+    .option('--category <category>', t('cli.command.upload.vibeCategory'))
+    .option('--subcategory <subcategory>', t('cli.command.upload.vibeSubcategory'))
     .addOption(new commander.Option('--app-info <path>', t('cli.command.upload.vibeAppInfo')).hideHelp())
     .option('--package <path>', t('cli.command.upload.vibePackage'))
     .option('--dry-run', t('cli.command.upload.vibeDryRun'))
@@ -17155,7 +17955,8 @@ withVerboseOption(program
     .option('--vibe-authorize-url <url>', t('cli.command.upload.vibeAuthorizeUrl'))
     .option('--poll-interval <seconds>', t('cli.command.upload.vibePollInterval'))
     .option('--timeout <seconds>', t('cli.command.upload.vibeTimeout'))
-    .option('--format <format>', t('cli.command.upload.format'), 'text')).action(async (cmd) => {
+    .option('--format <format>', t('cli.command.upload.format'), 'text')
+    .addHelpText('after', t('cli.command.upload.vibeWebGuide'))).action(async (cmd) => {
     if (cmd.vibe) {
         const { vibeUpload } = await Promise.resolve().then(function () { return index$1; });
         await vibeUpload(cmd);
@@ -17165,6 +17966,8 @@ withVerboseOption(program
         cmd.title,
         cmd.icon,
         cmd.appInfo,
+        cmd.category,
+        cmd.subcategory,
         cmd.web,
         cmd.package,
         cmd.dryRun,
@@ -17707,112 +18510,6 @@ var authOpen = /*#__PURE__*/Object.freeze({
     vibeAuthOpen: vibeAuthOpen
 });
 
-// Current PPE trial defaults: the owner-approved metadata used by the successful
-// real upload fixture on 2026-09-14. This is not a production metadata profile.
-const VIBE_PPE_DEFAULT_APP_INFO = Object.freeze({
-    description: 'DevTool PPE integration test fixture. Not a production game.',
-    category: 'Other',
-    subcategory: 'Other',
-    terms_of_service: 'https://example.invalid/devtool-ppe-test/terms',
-    privacy_policy: 'https://example.invalid/devtool-ppe-test/privacy',
-    copyright_confirmation: true,
-    contact_email: 'devtool-test@example.invalid',
-});
-// BFF IDL + Import Service ValidateAppInfo, feat-minis-import (2026-09-14).
-// Keep credentials, app_name and icon_uri out of this file: CLI owns those fields.
-const requiredStrings = [
-    'description', 'category', 'subcategory', 'terms_of_service', 'privacy_policy',
-];
-const optionalStrings = ['apple_team_id', 'contact_email', 'region', 'min_sdk_version'];
-function readVibeAppInfo(file) {
-    if (file === undefined)
-        return undefined;
-    try {
-        const stat = fs.statSync(file);
-        if (!stat.isFile() || stat.size > 64 * 1024)
-            throw new Error();
-        const value = JSON.parse(fs.readFileSync(file, 'utf8'));
-        if (!value || typeof value !== 'object' || Array.isArray(value))
-            throw new Error();
-        const allowed = new Set([...requiredStrings, ...optionalStrings, 'copyright_confirmation']);
-        if (Object.keys(value).some(key => !allowed.has(key)))
-            throw new Error();
-        // JSON can encode lone surrogates that Go rejects as invalid UTF-8 input.
-        for (const item of Object.values(value)) {
-            if (typeof item === 'string' && [...item].some(char => /^[\uD800-\uDFFF]$/.test(char)))
-                throw new Error();
-        }
-        for (const key of requiredStrings) {
-            if (typeof value[key] !== 'string' || !value[key].trim())
-                throw new Error();
-        }
-        for (const key of optionalStrings) {
-            if (value[key] !== undefined && (typeof value[key] !== 'string' || !value[key].trim()))
-                throw new Error();
-        }
-        // An explicit declaration is required; never infer consent or supply a default.
-        if (value.copyright_confirmation !== true)
-            throw new Error();
-        for (const key of ['terms_of_service', 'privacy_policy']) {
-            if (/\s/.test(value[key]))
-                throw new Error();
-            const url = new URL(value[key]);
-            if (!['http:', 'https:'].includes(url.protocol) || !url.hostname || url.username || url.password)
-                throw new Error();
-        }
-        if (value.contact_email !== undefined && !/^[^\s<>@]+@[^\s<>@]+$/.test(value.contact_email))
-            throw new Error();
-        return value;
-    }
-    catch {
-        // Do not expose paths, file contents or parser errors in structured output.
-        throw new VibeError('VIBE_INVALID_APP_INFO');
-    }
-}
-const VIBE_PLATFORM_ICON_LIMIT = 5 * 1024 * 1024;
-// Header preflight only. The BFF remains responsible for decoding the image.
-function validateVibeUploadInput(input) {
-    if ([...input.title].length > 30)
-        throw new VibeError('VIBE_TITLE_TOO_LONG');
-    const image = input.icon.bytes;
-    if (image.length > VIBE_PLATFORM_ICON_LIMIT)
-        throw new VibeError('VIBE_PLATFORM_ICON_INVALID');
-    let width = 0, height = 0;
-    if (image.length >= 33 && image.subarray(0, 8).equals(Buffer.from('89504e470d0a1a0a', 'hex')) &&
-        image.readUInt32BE(8) === 13 && image.toString('ascii', 12, 16) === 'IHDR') {
-        width = image.readUInt32BE(16);
-        height = image.readUInt32BE(20);
-    }
-    else if (image[0] === 0xff && image[1] === 0xd8) {
-        let offset = 2;
-        while (offset + 4 <= image.length) {
-            if (image[offset++] !== 0xff)
-                break;
-            while (image[offset] === 0xff)
-                offset++;
-            const marker = image[offset++];
-            if (marker === 0xda || marker === 0xd9)
-                break;
-            if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
-                continue;
-            if (offset + 2 > image.length)
-                break;
-            const length = image.readUInt16BE(offset);
-            if (length < 2 || offset + length > image.length)
-                break;
-            // Go image/jpeg accepts baseline, extended sequential and progressive SOF.
-            if ([0xc0, 0xc1, 0xc2].includes(marker) && length >= 8) {
-                height = image.readUInt16BE(offset + 3);
-                width = image.readUInt16BE(offset + 5);
-                break;
-            }
-            offset += length;
-        }
-    }
-    if (width !== 1024 || height !== 1024)
-        throw new VibeError('VIBE_PLATFORM_ICON_INVALID');
-}
-
 // BFF IDL: feat-minis-import. PPE import flow; no production adapter.
 const prefix = '/bff/app_info/minis_import/';
 const MINIS_IMPORT_PATHS = {
@@ -18429,7 +19126,7 @@ async function prepareVibeInput(options, onPackaging, signal, deps = { check: ex
     const title = options.title?.trim();
     if (!title)
         throw new VibeError('VIBE_TITLE_REQUIRED');
-    const appInfo = readVibeAppInfo(options.appInfo);
+    const appInfo = applyVibeCategory(options, readVibeAppInfo(options.appInfo));
     if (options.package && options.dir)
         throw new VibeError('VIBE_INPUT_CONFLICT');
     const image = readFile(options.icon, VIBE_ICON_LIMIT, 'VIBE_INVALID_ICON');
@@ -18472,7 +19169,7 @@ async function prepareVibeInput(options, onPackaging, signal, deps = { check: ex
         },
         code: { bytes: code, name: 'game.zip', contentType: 'application/zip' },
     };
-    if (appInfo)
+    if (options.appInfo !== undefined)
         validateVibeUploadInput(input);
     return input;
 }
@@ -18984,6 +19681,12 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
             terminal: !!options.dryRun,
             nextAction: options.dryRun ? 'none' : 'wait',
             title: input.title,
+            classification: {
+                category: (input.appInfo || VIBE_PPE_DEFAULT_APP_INFO).category,
+                subcategory: (input.appInfo || VIBE_PPE_DEFAULT_APP_INFO).subcategory,
+                source: options.category !== undefined ? 'arguments' : input.appInfo ? 'app-info' : 'defaults',
+                catalogVersion: GAME_CATEGORY_CATALOG_VERSION,
+            },
             iconSizeBytes: input.icon.bytes.length,
             packageSizeBytes: input.code.bytes.length,
             packageSha256: crypto.createHash('sha256')
@@ -19175,6 +19878,8 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
                 ? 'cancelled'
                 : 'failed';
         const messages = {
+            VIBE_CATEGORY_PAIR_REQUIRED: ['--category 和 --subcategory 必须同时提供；均不传时保留默认分类。使用 ttmg game categories --format json 查询。', 'Provide --category and --subcategory together, or omit both to keep the default. Query ttmg game categories --format json.'],
+            VIBE_INVALID_CATEGORY: ['类型或子类型无效，或两者不匹配。使用 ttmg game categories --format json 查询有效组合。', 'Invalid category/subcategory pair. Query valid values with ttmg game categories --format json.'],
             VIBE_WEB_OPTION_CONFLICT: ['--web 使用真实网页授权，不能与 --mock、--mock-scenario、--vibe-api 或 --no-open 同时使用。', '--web uses real browser authorization and cannot be combined with --mock, --mock-scenario, --vibe-api or --no-open.'],
             VIBE_AUTH_DENIED: [
                 '已取消授权，本次未上传。',