perf: thin command metadata paths

Author: thymikee

src/__tests__/cli-client-commands.test.ts

@@ -567,6 +567,7 @@ test('apps command defaults to user-installed and prints discovery hint', async
         help: false,
         version: false,
         platform: 'android',
+        appsFilter: 'user-installed',
       },
       client,
     });

src/__tests__/cli-grammar.test.ts

@@ -2,7 +2,7 @@ import { test } from 'vitest';
 import assert from 'node:assert/strict';
 import { DAEMON_COMMAND_GROUPS, PUBLIC_COMMANDS } from '../command-catalog.ts';
 import { readInputFromCli } from '../commands/cli-grammar.ts';
-import type { CliFlags } from '../utils/command-schema.ts';
+import type { CliFlags } from '../utils/cli-flags.ts';
 
 const BASE_FLAGS: CliFlags = {
   json: false,

src/batch-contract.ts

@@ -0,0 +1 @@
+export const DEFAULT_BATCH_MAX_STEPS = 100;

src/bin.ts

@@ -11,7 +11,7 @@ if (runFastPath(argv)) {
 }
 
 function runFastPath(argv: string[]): boolean {
-  return runVersionFastPath(argv) || runHelpFastPath(argv);
+  return runVersionFastPath(argv) || runNoCommandFastPath(argv) || runHelpFastPath(argv);
 }
 
 function runVersionFastPath(argv: string[]): boolean {
@@ -24,6 +24,17 @@ function runVersionFastPath(argv: string[]): boolean {
   return true;
 }
 
+function runNoCommandFastPath(argv: string[]): boolean {
+  if (argv.length !== 0) return false;
+  import('./utils/args.ts')
+    .then(({ usage }) => {
+      process.stdout.write(`${usage()}\n`);
+      process.exit(1);
+    })
+    .catch(handleStartupError);
+  return true;
+}
+
 function runHelpFastPath(argv: string[]): boolean {
   const helpTarget = resolveSimpleHelpTarget(argv);
   if (helpTarget === undefined) return false;

src/cli.ts

@@ -28,7 +28,7 @@ import { resolveCliOptions } from './utils/cli-options.ts';
 import { maybeRunUpgradeNotifier } from './utils/update-check.ts';
 import { resolveRemoteConnectionDefaults } from './remote-connection-state.ts';
 import { resolveRemoteAuthForCli } from './cli/auth-session.ts';
-import type { CliFlags, FlagKey } from './utils/command-schema.ts';
+import type { CliFlags, FlagKey } from './utils/cli-flags.ts';
 import type { SessionRuntimeHints } from './contracts.ts';
 
 type CliDeps = {

src/cli/auth-session.ts

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { runCmd } from '../utils/exec.ts';
 import { AppError } from '../utils/errors.ts';
-import type { CliFlags } from '../utils/command-schema.ts';
+import type { CliFlags } from '../utils/cli-flags.ts';
 
 const DEFAULT_CLOUD_BASE_URL = 'https://cloud.agent-device.dev';
 const DEVICE_AUTH_START_PATH = '/api/control-plane/device-auth/start';

src/cli/batch-steps.ts

@@ -1,7 +1,7 @@
 import type { BatchStep } from '../client-types.ts';
 import { readInputFromCli } from '../commands/cli-grammar.ts';
-import { isCommandName, type CommandName } from '../commands/command-surface.ts';
-import type { CliFlags } from '../utils/command-schema.ts';
+import { isCommandName, type CommandName } from '../commands/command-metadata.ts';
+import type { CliFlags } from '../utils/cli-flags.ts';
 import { AppError } from '../utils/errors.ts';
 
 type LegacyCliBatchStep = {

src/cli/cloud-connection-profile.ts

@@ -5,7 +5,7 @@ import { resolveRemoteConfigProfile } from '../remote-config.ts';
 import type { RemoteConfigProfile, ResolvedRemoteConfigProfile } from '../remote-config-schema.ts';
 import { profileToCliFlags } from '../utils/remote-config.ts';
 import { AppError, asAppError } from '../utils/errors.ts';
-import type { CliFlags } from '../utils/command-schema.ts';
+import type { CliFlags } from '../utils/cli-flags.ts';
 import { resolveCloudAccessForConnect } from './auth-session.ts';
 
 const CONNECTION_PROFILE_PATH = '/api/control-plane/connection-profile';

src/cli/commands/connection-runtime.ts

@@ -14,7 +14,7 @@ import { profileToCliFlags } from '../../utils/remote-config.ts';
 import type { BatchStep } from '../../client-types.ts';
 import { AppError } from '../../utils/errors.ts';
 import type { LeaseBackend, SessionRuntimeHints } from '../../contracts.ts';
-import type { CliFlags } from '../../utils/command-schema.ts';
+import type { CliFlags } from '../../utils/cli-flags.ts';
 import type { AgentDeviceClient, Lease } from '../../client.ts';
 
 const leaseDeferredCommands = new Set([

src/cli/commands/connection.ts

@@ -22,7 +22,7 @@ import {
 } from './connection-runtime.ts';
 import { writeCommandOutput } from './shared.ts';
 import type { LeaseBackend } from '../../contracts.ts';
-import type { CliFlags } from '../../utils/command-schema.ts';
+import type { CliFlags } from '../../utils/cli-flags.ts';
 import type { ClientCommandHandler } from './router-types.ts';
 
 export const connectCommand: ClientCommandHandler = async ({ flags, client }) => {