/**
 * Phase 1 — ArgvParser
 * Parses raw process.argv into a structured format before Commander swallows it.
 * We still use Commander for subcommand dispatch, but this layer extracts
 * input-source metadata (stdin hints, file paths, positional args) early.
 */
import type { InputSource } from "../runtime/types.js";
export interface ParsedArgv {
    readonly raw: readonly string[];
    readonly command?: string;
    readonly positionalArgs: readonly string[];
    readonly flags: Record<string, string | boolean | undefined>;
    readonly hasStdinPipe: boolean;
}
export declare function parseArgv(argv: readonly string[]): ParsedArgv;
export declare function inferInputSource(parsed: ParsedArgv): InputSource;
