/**
 * CLI 引数の解釈。process.argv を読むのは CLI entry（src/index.ts）だけに閉じ、
 * ここは配列を受け取る純関数に留める（loader が argv を無条件走査すると、
 * テストランナーや埋め込み先ホストの同名オプションを誤採用しうるため）。
 */
export declare const MELTA_ROOT_FLAG = "--melta-root";
/** CLI 設定の誤りを実行前に落とすためのエラー。fallback で握り潰さない */
export declare class CliArgError extends Error {
}
/**
 * `--melta-root=<path>` / `--melta-root <path>` を取り出す。
 * 指定が無ければ null。
 *
 * fail-fast の対象（黙って env / パッケージ相対に落ちると、差し替えたつもりの root で
 * 動かない = BYO-DS のつもりで別の DS が「合格」を返す最悪の事故になる）:
 *   - フラグはあるのに値が無い
 *   - `--melta-` 名前空間内の未知オプション（`--melta-config` 等）
 *   - 予約 typo（`--melat-root` 等）
 *   - `--melta-root` の重複指定で値が異なる
 *
 * 全 argv を走査してから返す（正しい指定を見つけた時点で return すると、後ろの
 * 未知オプションを見逃して検査が引数順依存になる）。
 * melta 名前空間の外（`--root` / `--verbose` / `--meta-root` 等）は MCP ホストの
 * 独自引数でありうるため無視する。
 */
export declare function parseMeltaRootArg(argv: readonly string[]): string | null;