/**
 * Core types for the codewalker code index.
 *
 * These types are shared across all layers (extraction, cards, DB, query).
 */

/** Library symbol kind — extends SymbolKind with reexport + namespace. */
export type LibSymbolKind =
  | "function"
  | "const"
  | "class"
  | "interface"
  | "type"
  | "enum"
  | "namespace"
  | "reexport"
  | "module";

/** The kind of a code symbol. */
export type SymbolKind =
  | "function"
  | "const"
  | "class"
  | "type"
  | "method"
  | "enum"
  | "variable"
  | "interface"
  | "namespace"
  | "module";

/** A single symbol extracted from a library's .d.ts file. */
export interface LibSymbol {
  lib: string;
  version: string;
  name: string;
  kind: LibSymbolKind;
  signature: string;
  doc: string;
  summary: string;
  card_path: string;
}

/** A single symbol extracted from source code. */
export interface Symbol {
  name: string;
  kind: SymbolKind;
  file_path: string;
  line_start: number;
  line_end: number;
  signature: string;
  doc: string;
  summary: string; // reserved for v1.3; empty in v1.1
  card_path: string;
}

/** The frontmatter head of a markdown card — what `query` returns (compact, token-cheap). */
export interface CardHead {
  name: string;
  kind: string;
  signature: string;
  location: string; // "file.ts:10-42"
  tags: string[];
  summary: string;
}

/** Note kind discriminator for bridge cards. */
export type NoteKind = "glossary" | "decision" | "convention";

/** A glossary/decision note (bridge card) for conceptual knowledge. */
export interface Note {
  note_kind: NoteKind;
  title: string;
  body: string;
  tags: string;
  related: string;
  card_path: string;
}

/** Analysis finding kind discriminator. */
export type FindingKind = "coverage" | "debt" | "practice";

/** A single analysis finding (coverage gap, technical debt, or best-practice finding). */
export interface Finding {
  finding_kind: FindingKind;
  title: string;
  severity?: "info" | "warn" | "high";
  file_path?: string;
  line_start?: number;
  line_end?: number;
  metric?: string;
  body?: string;
  related?: string;
  card_path?: string;
}

/** Per-file coverage data from lcov or coverage-final.json. */
export interface FileCoverage {
  file: string;
  lines_total: number;
  lines_covered: number;
  pct: number;
}

/** A single row returned from a query. */
export interface QueryResultRow {
  name: string;
  kind: string;
  file_path: string;
  line_start: number;
  line_end: number;
  signature: string;
  summary: string;
  score: number;
  id: number;
  /** Origin fields — code rows omit these; lib / note / analysis rows set them. */
  source?: "code" | "lib" | "note" | "analysis";
  finding_kind?: FindingKind;
  severity?: string;
  metric?: string;
  lib?: string;
  version?: string;
  /** Note-specific fields — only for source === "note" rows. */
  note_kind?: NoteKind;
  tags?: string;
}

/** The full result of a query, including staleness info. */
export interface QueryResult {
  rows: QueryResultRow[];
  staleness: StalenessInfo | null;
}

/** Git-anchored staleness signal attached to every query result. */
export interface StalenessInfo {
  indexedCommit: string;
  headCommit: string;
  changedFiles: number;
  message: string;
}

/** Metadata about the index stored in meta.json. */
export interface IndexMeta {
  schemaVersion: number;
  lastIndexedCommit: string;
  lastFullScan: string; // ISO date
}

/** Configuration for the codebase indexer. */
export interface IndexerConfig {
  language: "ts" | "js" | "py" | "go" | "rs";
  extensions: string[];
}

/** Map of language → file extension list. */
export const SUPPORTED_LANGUAGES: Record<string, string[]> = {
  ts: [".ts", ".tsx"],
  js: [".js", ".jsx", ".mjs", ".cjs"],
  py: [".py"],
  go: [".go"],
};