/**
 * Config-get and resolve-model query handlers.
 *
 * Ported from get-shit-done/bin/lib/config.cjs and commands.cjs.
 * Provides raw config.json traversal and model profile resolution.
 *
 * @example
 * ```typescript
 * import { configGet, resolveModel } from './config-query.js';
 *
 * const result = await configGet(['workflow.auto_advance'], '/project');
 * // { data: true }
 *
 * const model = await resolveModel(['gsd-planner'], '/project');
 * // { data: { model: 'opus', profile: 'balanced', binding_kind: 'profile' } }
 * ```
 */

import { readFile } from 'node:fs/promises';
import { GSDError, ErrorClassification } from '../errors.js';
import { loadConfig } from '../config.js';
import { planningPaths } from './helpers.js';
import {
  ACCEPTED_MODEL_PROFILES,
  MODEL_PROFILES,
  VALID_PROFILES,
  getAgentToModelMapForProfile,
  resolveAgentBinding,
  serializeRuntimeModelResolution,
  toLegacyResolveModelResult,
} from './runtime-model-contract.js';
import { maskIfSecret } from './secrets.js';
import type { QueryHandler } from './utils.js';
export {
  ACCEPTED_MODEL_PROFILES,
  MODEL_PROFILES,
  VALID_PROFILES,
  getAgentToModelMapForProfile,
} from './runtime-model-contract.js';
export {
  assertAgentBindingsSupported,
  formatBindingValidationError,
  validateAgentBinding,
  validateAgentBindings,
  validateResolvedAgentBinding,
} from './runtime-model-validation.js';

/**
 * Schema-level defaults for well-known config keys.
 *
 * Mirrors the CJS table at get-shit-done/bin/lib/config.cjs so SDK config-get
 * returns documented defaults before throwing CONFIG_KEY_NOT_FOUND.
 */
const SCHEMA_DEFAULTS: Readonly<Record<string, string | number | boolean>> = Object.freeze({
  context_window: 200000,
  'executor.stall_detect_interval_minutes': 5,
  'executor.stall_threshold_minutes': 10,
  'git.create_tag': true,
});

// ─── configGet ──────────────────────────────────────────────────────────────

/**
 * Query handler for config-get command.
 *
 * Reads raw .planning/config.json and traverses dot-notation key paths.
 * Does NOT merge with defaults (matches gsd-tools.cjs behavior).
 *
 * @param args - args[0] is the dot-notation key path (e.g., 'workflow.auto_advance')
 * @param projectDir - Project root directory
 * @returns QueryResult with the config value at the given path
 * @throws GSDError with Validation classification if key missing or not found
 */
export const configGet: QueryHandler = async (args, projectDir, workstream) => {
  // Support --default <value> flag (#2803): return this value (exit 0) when the
  // key is absent, mirroring gsd-tools.cjs config-get behavior from #1893.
  const defaultIdx = args.indexOf('--default');
  let defaultValue: string | undefined;
  let filteredArgs = args;
  if (defaultIdx !== -1) {
    if (defaultIdx + 1 >= args.length) {
      throw new GSDError('Usage: config-get <key.path> [--default <value>]', ErrorClassification.Validation);
    }
    defaultValue = String(args[defaultIdx + 1]);
    filteredArgs = [...args.slice(0, defaultIdx), ...args.slice(defaultIdx + 2)];
  }

  const keyPath = filteredArgs[0];
  if (!keyPath) {
    throw new GSDError('Usage: config-get <key.path> [--default <value>]', ErrorClassification.Validation);
  }

  const paths = planningPaths(projectDir, workstream);
  let raw: string;
  try {
    raw = await readFile(paths.config, 'utf-8');
  } catch {
    // config.json missing — CJS parity (config.cjs:524-533):
    //   1. --default beats everything
    //   2. else SCHEMA_DEFAULTS supply a documented value (#2943)
    //   3. else CONFIG_NO_FILE error
    if (defaultValue !== undefined) return { data: defaultValue };
    if (Object.prototype.hasOwnProperty.call(SCHEMA_DEFAULTS, keyPath)) {
      return { data: SCHEMA_DEFAULTS[keyPath] };
    }
    const err = new GSDError(`No config.json found at ${paths.config}`, ErrorClassification.Validation);
    (err as GSDError & { reason?: string }).reason = 'config_no_file';
    throw err;
  }

  let config: Record<string, unknown>;
  try {
    config = JSON.parse(raw) as Record<string, unknown>;
  } catch {
    // Lead the message with "Failed to read config.json" — matches the CJS
    // `cmdConfigGet` / `setConfigValue` error vocabulary so tests written
    // against the legacy contract keep matching.
    const err = new GSDError(`Failed to read config.json: malformed JSON at ${paths.config}`, ErrorClassification.Validation);
    (err as GSDError & { reason?: string }).reason = 'config_parse_failed';
    throw err;
  }

  const keys = keyPath.split('.');
  let current: unknown = config;
  for (const key of keys) {
    if (current === undefined || current === null || typeof current !== 'object') {
      // UNIX convention (cf. `git config --get`): missing key exits 1, not 10.
      // See issue #2544 — callers use `if ! gsd-sdk query config-get k; then` patterns.
      // CJS parity ordering (config.cjs:543-551): --default first, then
      // SCHEMA_DEFAULTS, then CONFIG_KEY_NOT_FOUND.
      if (defaultValue !== undefined) return { data: defaultValue };
      if (Object.prototype.hasOwnProperty.call(SCHEMA_DEFAULTS, keyPath)) {
        return { data: SCHEMA_DEFAULTS[keyPath] };
      }
      const err = new GSDError(`Key not found: ${keyPath}`, ErrorClassification.Execution);
      (err as GSDError & { reason?: string }).reason = 'config_key_not_found';
      throw err;
    }
    current = (current as Record<string, unknown>)[key];
  }
  if (current === undefined) {
    if (defaultValue !== undefined) return { data: defaultValue };
    if (Object.prototype.hasOwnProperty.call(SCHEMA_DEFAULTS, keyPath)) {
      return { data: SCHEMA_DEFAULTS[keyPath] };
    }
    const err = new GSDError(`Key not found: ${keyPath}`, ErrorClassification.Execution);
    (err as GSDError & { reason?: string }).reason = 'config_key_not_found';
    throw err;
  }

  // Mask plaintext for keys in SECRET_CONFIG_KEYS to match CJS behavior at
  // config.cjs:440-441 — without this, `gsd-sdk query config-get brave_search`
  // would echo the plaintext credential into machine-readable output. (#2997)
  return { data: maskIfSecret(keyPath, current) };
};

// ─── configPath ─────────────────────────────────────────────────────────────

/**
 * Query handler for config-path — resolved `.planning/config.json` path (workstream-aware via cwd).
 *
 * Port of `cmdConfigPath` from `config.cjs`. The JSON query API returns `{ path }`; the CJS CLI
 * emits the path as plain text for shell substitution.
 *
 * @param _args - Unused
 * @param projectDir - Project root directory
 * @returns QueryResult with `{ path: string }` absolute or project-relative resolution via planningPaths
 */
export const configPath: QueryHandler = async (_args, projectDir, workstream) => {
  const paths = planningPaths(projectDir, workstream);
  return { data: { path: paths.config } };
};

// ─── resolveModel ───────────────────────────────────────────────────────────

/**
 * Query handler for resolve-model command.
 *
 * Resolves a structured runtime-model binding for the requested agent, then
 * adapts it to the legacy query payload shape while preserving explicit,
 * inherit, runtime-default, and unsupported outcomes in metadata.
 *
 * @param args - args[0] is the agent type (e.g., 'gsd-planner')
 * @param projectDir - Project root directory
 * @param workstream - Optional workstream name; forwarded to loadConfig so per-workstream
 *   model_profile settings are respected (mirrors configGet/configPath behavior)
 * @returns QueryResult with a legacy-compatible model payload plus structured metadata
 * @throws GSDError with Validation classification if agent type not provided
 */
export const resolveModel: QueryHandler = async (args, projectDir, workstream) => {
  const agentType = args[0];
  if (!agentType) {
    throw new GSDError('agent-type required', ErrorClassification.Validation);
  }

  const config = await loadConfig(projectDir, workstream);
  const resolution = resolveAgentBinding(config, agentType);
  const legacy = toLegacyResolveModelResult(resolution);
  const workflow = (config.workflow ?? {}) as unknown as Record<string, unknown>;

  return {
    data: {
      ...legacy,
      runtime_model: {
        runtime: resolution.runtime,
        model_profile: resolution.profile,
        resolve_model_ids: resolution.resolveModelIds ?? null,
        cross_ai: {
          execution_configured: workflow.cross_ai_execution === true,
          command_configured: typeof workflow.cross_ai_command === 'string' && workflow.cross_ai_command.trim() !== '',
          timeout_seconds: typeof workflow.cross_ai_timeout === 'number' ? workflow.cross_ai_timeout : null,
        },
        binding: serializeRuntimeModelResolution(resolution),
      },
    },
  };
};