fix: restore app lifecycle action semantics

Author: KazuCocoa

src/tests/tools/llm-wording.test.ts

@@ -130,12 +130,13 @@ describe('LLM-facing MCP tool wording', () => {
     const tool = await registerTool('../../tools/app-management/app.js');
     const actionDescription = normalizeText(paramDescription(tool, 'action'));
 
-    expect(actionDescription).toMatch(/activate.*terminate.*is_installed.*clear.*require id or name/i);
+    expect(actionDescription).toMatch(/activate.*foreground.*terminate.*stop.*is_installed.*check installation/i);
+    expect(actionDescription).toMatch(/clear.*app data.*without uninstalling.*require id or name/i);
     expect(actionDescription).toMatch(/install.*requires path/i);
     expect(actionDescription).toMatch(/uninstall.*id\/name.*keepData/i);
     expect(actionDescription).toMatch(/list.*applicationType/i);
     expect(actionDescription).toMatch(/query_state.*0=not installed.*4=foreground.*id or name/i);
-    expect(actionDescription).toMatch(/background.*default 5/i);
+    expect(actionDescription).toMatch(/background.*foreground app.*background.*default 5/i);
     expect(actionDescription).toMatch(/deep_link.*requires url.*id\/name.*optional/i);
 
     expect(normalizeText(paramDescription(tool, 'id'))).toMatch(

src/tools/app-management/app.ts

@@ -33,11 +33,13 @@ const schema = z.object({
   action: z
     .enum(APP_ACTIONS)
     .describe(
-      'activate/terminate/is_installed/clear: require id or name. ' +
+      'activate: foreground app; terminate: stop app; is_installed: check installation; ' +
+        'clear: clear app data without uninstalling (all require id or name). ' +
         'install: requires path. uninstall: requires id/name; Android keepData is optional. ' +
         'list: optional iOS applicationType. ' +
         'query_state: get state 0=not installed,1=not running,2=background suspended,3=background,4=foreground (requires id or name). ' +
-        'background: optional seconds (default 5). deep_link: requires url; id/name is optional.',
+        'background: send foreground app to background; optional seconds (default 5). ' +
+        'deep_link: requires url; id/name is optional.',
     ),
   id: z.string().optional().describe('Android package or iOS bundle ID; takes precedence over name.'),
   name: z.string().optional().describe('Human-readable app name resolved to an ID; alternative to id.'),