feat(cli): lift config-file headers/timeouts/OAuth into serverSettings (#1482) (#1500)

* feat(cli): lift config-file headers/timeouts/OAuth into serverSettings (#1482)

The CLI resolved file-sourced servers via resolveServerConfigs(), which
returns bare MCPServerConfig and dropped disk-level headers, timeouts, and
OAuth — CLI connections from a --catalog/--config file silently ignored
them. The TUI already lifted these via mcpConfigToServerEntries().

Extract the TUI's catalog/config -> per-server-settings resolution into a
shared core module (core/mcp/node/servers.ts: loadServerEntries +
selectServerEntry) and route both CLI and TUI through it, so the two share
one file->settings path. --header still overrides the file's headers for
the run while preserving the file's timeouts/OAuth.

- core: add loadServerEntries/selectServerEntry/headersToServerSettings
- tui: tui-servers.ts re-exports the shared core helpers (no logic dup)
- cli: resolve via loadServerEntries + selectServerEntry; drop the
  CLI-only conflict check and bare-config path
- tests: core servers.test.ts (settings lifting, header merge/override,
  stdio overrides, seed/error/conflict, selection); CLI integration tests
  asserting a config header is sent over HTTP and --header overrides it
- docs: CLI README note on file settings being applied

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* refactor(core): address #1500 review — dedup overrides, drop dead wrapper, clearer error, spec refresh

- Remove the now-unused resolveLaunchServerConfigs() wrapper (both CLI and
  TUI route through loadServerEntries now); migrate its default-catalog
  launch tests to compose withDefaultCatalogPath + resolveServerConfigs.
- Deduplicate applyStdioOverrides against config.ts applyOverrides: export
  the latter (now trims cwd) and reuse it in servers.ts.
- selectServerEntry's unknown-name error is source-agnostic ("not found"
  not "not found in config file") since entries may be a single ad-hoc
  default, where "config file" would mislead.
- Refresh specification/ docs (v2_cli_tui_launcher.md,
  v2_catalog_launch_config.md): CLI/TUI resolution now via
  loadServerEntries/selectServerEntry; mark gap G1 resolved (#1482);
  withDefaultConfigPath → withDefaultCatalogPath.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* test(cli): extend smoke:cli to cover #1482 lift→serverSettings

Adds end-to-end smoke coverage for the config-file headers/timeouts/OAuth
lift introduced in #1482:

- unknown --server now errors source-agnostically ("not found")
- multi-server catalog selection via --server (and the omit-it error)
- --header merge does not break the stdio connect path
- HTTP transport: a config-file `headers` object is lifted onto the wire,
  and a CLI --header overrides it (verified against an in-process test
  server's recorded requests via a non-blocking spawn)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

core/mcp/node/config.ts

@@ -235,7 +235,7 @@ function buildConfigFromOptions(options: ServerConfigOptions): MCPServerConfig {
  * carry no overridable per-request fields here — custom headers live in
  * `InspectorServerSettings.headers` (the persisted per-server settings node),
  * not on `MCPServerConfig`. */
-function applyOverrides(
+export function applyOverrides(
   config: MCPServerConfig,
   overrides: {
     env?: Record<string, string>;
@@ -247,7 +247,7 @@ function applyOverrides(
     if (overrides.env && Object.keys(overrides.env).length > 0) {
       c.env = { ...(c.env ?? {}), ...overrides.env };
     }
-    if (overrides.cwd) c.cwd = overrides.cwd;
+    if (overrides.cwd?.trim()) c.cwd = overrides.cwd.trim();
     return c;
   }
   return config;
@@ -415,18 +415,6 @@ export function resolveServerConfigs(
   return [];
 }
 
-/**
- * Launch-time resolver for CLI/TUI: applies the default writable catalog path
- * when no `--catalog`, `--config`, or ad-hoc target is given, then delegates to
- * `resolveServerConfigs`.
- */
-export function resolveLaunchServerConfigs(
-  options: ServerConfigOptions,
-  mode: ResolveServerConfigsMode,
-): MCPServerConfig[] {
-  return resolveServerConfigs(withDefaultCatalogPath(options), mode);
-}
-
 /**
  * Returns named server configs from a catalog/config file (multi-server). Use
  * when the caller needs server names. Resolves the active source via