/**
 * ナレッジ連携型定義
 *
 * TSK-008: ナレッジ連携型定義
 * REQ-KM-003: 関連プロジェクトの自動検出
 * DES-KM-003: ナレッジ連携システム設計
 */

/**
 * プロジェクトメタデータ
 */
export interface ProjectMeta {
  /** プロジェクト名 */
  name: string;
  /** プロジェクトパス */
  path: string;
  /** キーワード */
  keywords: string[];
  /** 作成日時 */
  createdAt: Date;
  /** 更新日時 */
  updatedAt: Date;
  /** ステータス */
  status: 'active' | 'completed' | 'archived';
  /** 説明 */
  description?: string;
  /** カスタムタグ */
  tags?: string[];
}

/**
 * プロジェクトインデックス
 */
export interface ProjectIndex {
  /** インデックスバージョン */
  version: string;
  /** 最終更新日時 */
  lastUpdated: Date;
  /** プロジェクト一覧 */
  projects: ProjectMeta[];
}

/**
 * 関連プロジェクト
 */
export interface RelatedProject {
  /** プロジェクトメタデータ */
  project: ProjectMeta;
  /** 類似度スコア（0-1） */
  similarityScore: number;
  /** マッチしたキーワード */
  matchedKeywords: string[];
  /** 鮮度状態 */
  freshness: 'fresh' | 'warning' | 'stale';
  /** 鮮度警告メッセージ（warning/stale時） */
  freshnessMessage?: string;
}

/**
 * 類似度計算結果
 */
export interface SimilarityResult {
  /** Jaccard係数 */
  jaccardIndex: number;
  /** マッチキーワード数 */
  matchCount: number;
  /** 全キーワード数 */
  totalKeywords: number;
  /** 最終スコア（重み付け後） */
  finalScore: number;
}

/**
 * 鮮度チェック結果
 */
export interface FreshnessResult {
  /** 状態 */
  status: 'fresh' | 'warning' | 'stale';
  /** 経過日数 */
  daysSinceUpdate: number;
  /** メッセージ */
  message?: string;
}

/**
 * 検索オプション
 */
export interface DiscoveryOptions {
  /** 検索キーワード */
  keywords?: string[];
  /** 類似度閾値 */
  threshold?: number;
  /** 最大結果数 */
  maxResults?: number;
  /** 鮮度警告日数 */
  freshnessWarningDays?: number;
}