Function parseRawArgs

src/cli/parser/args.ts:43–109

(argv: string[])

}

export function parseRawArgs(argv: string[]): RawParsedArgs {
  const flags: CliFlags = { json: false, help: false, version: false };
  let command: string | null = null;
  const positionals: string[] = [];
  const warnings: string[] = [];
  const providedFlags: ParsedFlagRecord[] = [];
  let parseFlags = true;

  for (let i = 0; i < argv.length; i += 1) {
    const arg = argv[i]!;
    if (parseFlags && arg === '--') {
      parseFlags = false;
      continue;
    }
    if (!parseFlags) {
      if (!command) command = normalizeCommandAlias(arg);
      else positionals.push(arg);
      continue;
    }
    if (shouldPreservePostCommandArgs(command)) {
      positionals.push(arg);
      continue;
    }
    const isLongFlag = arg.startsWith('--');
    const isShortFlag = arg.startsWith('-') && arg.length > 1;
    if (!isLongFlag && !isShortFlag) {
      if (!command) command = normalizeCommandAlias(arg);
      else positionals.push(arg);
      continue;
    }

    const [token, inlineValue] = isLongFlag ? splitLongFlag(arg) : [arg, undefined];
    if (isLegacyIgnoredSnapshotShortFlag(command, token)) {
      continue;
    }
    const definition = resolveFlagDefinition(token, command);
    if (shouldPassThroughLocalToolFlag(command, definition)) {
      positionals.push(arg);
      continue;
    }
    if (!definition) {
      if (shouldTreatUnknownDashTokenAsPositional(command, positionals, arg)) {
        if (!command) command = arg;
        else positionals.push(arg);
        continue;
      }
      throw new AppError('INVALID_ARGS', `Unknown flag: ${token}`);
    }

    const parsed = parseFlagValue(definition, token, inlineValue, argv[i + 1]);
    if (parsed.consumeNext) i += 1;
    const existingValue = (flags as Record<string, unknown>)[definition.key];
    if (definition.multiple) {
      const values = Array.isArray(existingValue)
        ? [...existingValue, parsed.value]
        : existingValue === undefined
          ? [parsed.value]
          : [existingValue, parsed.value];