blacktrigram 0.7.2

package/lib/systems/ai/AIPersonality.js

@@ -0,0 +1,245 @@
+import { PlayerArchetype, TrigramStance } from "../../types/common.js";
+import "../../types/index.js";
+//#region src/systems/ai/AIPersonality.ts
+/**
+* AI Personality System for Korean Martial Arts Combat
+* Defines behavioral archetypes that guide AI decision-making
+*/
+/**
+* Archetype-specific behavior profiles
+*
+* Maps each of the 5 player archetypes to their unique combat behaviors,
+* movement patterns, and tactical preferences based on Korean martial arts
+* traditions and game design philosophy.
+*
+* @korean 원형별 행동 프로필
+*/
+var ARCHETYPE_BEHAVIORS = {
+	[PlayerArchetype.MUSA]: {
+		preferredStances: [
+			TrigramStance.GEON,
+			TrigramStance.JIN,
+			TrigramStance.GAN
+		],
+		optimalRange: 1,
+		retreatThreshold: 5,
+		techniqueSelectionBias: ["joint_manipulation", "bone_strikes"],
+		movementPattern: "aggressive",
+		honorCode: true,
+		vitalTargetPriority: "balanced"
+	},
+	[PlayerArchetype.AMSALJA]: {
+		preferredStances: [TrigramStance.SON, TrigramStance.GAM],
+		optimalRange: 1,
+		retreatThreshold: 20,
+		techniqueSelectionBias: ["nerve_strikes", "silent_takedowns"],
+		movementPattern: "evasive",
+		honorCode: false,
+		vitalTargetPriority: "consciousness"
+	},
+	[PlayerArchetype.HACKER]: {
+		preferredStances: [TrigramStance.LI, TrigramStance.TAE],
+		optimalRange: 3,
+		retreatThreshold: 50,
+		techniqueSelectionBias: ["anatomical_analysis", "calculated_strikes"],
+		movementPattern: "analytical",
+		honorCode: false,
+		vitalTargetPriority: "balanced"
+	},
+	[PlayerArchetype.JEONGBO_YOWON]: {
+		preferredStances: [TrigramStance.GAN, TrigramStance.GON],
+		optimalRange: 2,
+		retreatThreshold: 40,
+		techniqueSelectionBias: ["psychological_pressure", "submission_induction"],
+		movementPattern: "analytical",
+		honorCode: false,
+		vitalTargetPriority: "pain"
+	},
+	[PlayerArchetype.JOJIK_POKRYEOKBAE]: {
+		preferredStances: [TrigramStance.JIN, TrigramStance.GAM],
+		optimalRange: 1,
+		retreatThreshold: 70,
+		techniqueSelectionBias: ["dirty_techniques", "environmental_usage"],
+		movementPattern: "unpredictable",
+		honorCode: false,
+		vitalTargetPriority: "health"
+	}
+};
+/**
+* Five AI personality archetypes inspired by Korean martial arts philosophy
+*/
+var AI_PERSONALITIES = {
+	AGGRESSIVE_STRIKER: {
+		name: "Aggressive Striker",
+		koreanName: "맹공자",
+		archetype: PlayerArchetype.MUSA,
+		aggressionLevel: .95,
+		defensePreference: .1,
+		comboTendency: .8,
+		stanceSwitchFrequency: .15,
+		feintChance: .15,
+		tacticalRetreatThreshold: .05,
+		favoredStances: [
+			TrigramStance.GEON,
+			TrigramStance.JIN,
+			TrigramStance.LI
+		],
+		description: {
+			korean: "정면 돌파를 선호하는 공격적인 전사",
+			english: "Aggressive warrior who prefers frontal assault"
+		}
+	},
+	TECHNICAL_MASTER: {
+		name: "Technical Master",
+		koreanName: "기술가",
+		archetype: PlayerArchetype.AMSALJA,
+		aggressionLevel: .95,
+		defensePreference: .2,
+		comboTendency: .7,
+		stanceSwitchFrequency: .2,
+		feintChance: .35,
+		tacticalRetreatThreshold: .15,
+		favoredStances: [
+			TrigramStance.SON,
+			TrigramStance.GAM,
+			TrigramStance.TAE
+		],
+		description: {
+			korean: "정밀한 기술로 약점을 노리는 달인",
+			english: "Master who targets weaknesses with precise techniques"
+		}
+	},
+	BALANCED_FIGHTER: {
+		name: "Balanced Fighter",
+		koreanName: "균형 잡힌 자",
+		archetype: PlayerArchetype.JEONGBO_YOWON,
+		aggressionLevel: .75,
+		defensePreference: .4,
+		comboTendency: .6,
+		stanceSwitchFrequency: .25,
+		feintChance: .3,
+		tacticalRetreatThreshold: .2,
+		favoredStances: [
+			TrigramStance.GEON,
+			TrigramStance.GAM,
+			TrigramStance.GAN,
+			TrigramStance.GON
+		],
+		description: {
+			korean: "공격과 방어의 조화를 추구하는 전략가",
+			english: "Strategist seeking harmony between offense and defense"
+		}
+	},
+	DEFENSIVE_SPECIALIST: {
+		name: "Defensive Specialist",
+		koreanName: "방어의 달인",
+		archetype: PlayerArchetype.HACKER,
+		aggressionLevel: .55,
+		defensePreference: .6,
+		comboTendency: .5,
+		stanceSwitchFrequency: .2,
+		feintChance: .45,
+		tacticalRetreatThreshold: .3,
+		favoredStances: [
+			TrigramStance.GAN,
+			TrigramStance.GON,
+			TrigramStance.GAM
+		],
+		description: {
+			korean: "방어에서 반격의 기회를 찾는 전문가",
+			english: "Expert who finds counter-attack opportunities through defense"
+		}
+	},
+	CHAOS_WARRIOR: {
+		name: "Chaos Warrior",
+		koreanName: "혼돈의 전사",
+		archetype: PlayerArchetype.JOJIK_POKRYEOKBAE,
+		aggressionLevel: .9,
+		defensePreference: .2,
+		comboTendency: .7,
+		stanceSwitchFrequency: .3,
+		feintChance: .5,
+		tacticalRetreatThreshold: .05,
+		favoredStances: [
+			TrigramStance.LI,
+			TrigramStance.SON,
+			TrigramStance.JIN,
+			TrigramStance.TAE
+		],
+		description: {
+			korean: "예측 불가능한 패턴으로 상대를 혼란시키는 전사",
+			english: "Warrior who confuses opponents with unpredictable patterns"
+		}
+	}
+};
+/**
+* Get a random AI personality
+*/
+function getRandomPersonality() {
+	const personalities = Object.values(AI_PERSONALITIES);
+	return personalities[Math.floor(Math.random() * personalities.length)];
+}
+/**
+* Get personality by archetype
+*/
+function getPersonalityByArchetype(archetype) {
+	return Object.values(AI_PERSONALITIES).find((p) => p.archetype === archetype) ?? AI_PERSONALITIES.BALANCED_FIGHTER;
+}
+/**
+* Get personality by name key
+*/
+function getPersonalityByName(name) {
+	return AI_PERSONALITIES[name] ?? AI_PERSONALITIES.BALANCED_FIGHTER;
+}
+/**
+* List all available personalities
+*/
+function getAllPersonalities() {
+	return Object.values(AI_PERSONALITIES);
+}
+/**
+* Get archetype-specific behavior profile
+*
+* Retrieves the unique combat behavior configuration for a given archetype,
+* including movement patterns, optimal ranges, and tactical preferences.
+*
+* @param archetype - Player archetype to get behavior for
+* @returns Archetype behavior profile
+*
+* @korean 원형별 행동 프로필 가져오기
+*/
+function getArchetypeBehavior(archetype) {
+	return ARCHETYPE_BEHAVIORS[archetype];
+}
+/**
+* Check if archetype follows honor code
+*
+* Honor code affects retreat behavior - honor-bound archetypes like Musa
+* will not retreat above their health threshold.
+*
+* @param archetype - Player archetype to check
+* @returns True if archetype follows honor code
+*
+* @korean 명예 규범 확인
+*/
+function followsHonorCode(archetype) {
+	return ARCHETYPE_BEHAVIORS[archetype].honorCode;
+}
+/**
+* Get optimal combat range for archetype
+*
+* Returns the preferred distance in grid cells (1 cell = ~40px) where
+* the archetype is most effective in combat.
+*
+* @param archetype - Player archetype
+* @returns Optimal range in grid cells
+*
+* @korean 최적 전투 거리 가져오기
+*/
+function getOptimalRange(archetype) {
+	return ARCHETYPE_BEHAVIORS[archetype].optimalRange;
+}
+//#endregion
+export { AI_PERSONALITIES, ARCHETYPE_BEHAVIORS, followsHonorCode, getAllPersonalities, getArchetypeBehavior, getOptimalRange, getPersonalityByArchetype, getPersonalityByName, getRandomPersonality };
+
+//# sourceMappingURL=AIPersonality.js.map

package/lib/systems/ai/AIPersonality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIPersonality.js","names":[],"sources":["../../../src/systems/ai/AIPersonality.ts"],"sourcesContent":["/**\n * AI Personality System for Korean Martial Arts Combat\n * Defines behavioral archetypes that guide AI decision-making\n */\n\nimport { PlayerArchetype, TrigramStance } from \"@/types\";\n\n/**\n * Movement pattern types for archetype behavior\n *\n * @korean 이동 패턴 타입\n */\nexport type MovementPattern =\n  | \"aggressive\"\n  | \"evasive\"\n  | \"analytical\"\n  | \"unpredictable\";\n\n/**\n * Vital target priority for archetype-specific combat strategies\n *\n * @korean 급소 우선순위\n */\nexport type VitalTargetPriority =\n  | \"health\"\n  | \"pain\"\n  | \"consciousness\"\n  | \"balanced\";\n\n/**\n * Technique category types for archetype preferences\n *\n * @korean 기술 범주\n */\nexport type TechniqueCategory =\n  | \"joint_manipulation\"\n  | \"bone_strikes\"\n  | \"nerve_strikes\"\n  | \"silent_takedowns\"\n  | \"anatomical_analysis\"\n  | \"calculated_strikes\"\n  | \"psychological_pressure\"\n  | \"submission_induction\"\n  | \"dirty_techniques\"\n  | \"environmental_usage\";\n\n/**\n * Archetype-specific behavior profile\n *\n * Defines combat preferences, movement patterns, and tactical decision-making\n * unique to each of the 5 player archetypes.\n *\n * @korean 원형별 행동 프로필\n */\nexport interface ArchetypeBehavior {\n  /** Preferred trigram stances for this archetype */\n  readonly preferredStances: readonly TrigramStance[];\n  /** Optimal combat range in grid cells (1 cell = ~40px) */\n  readonly optimalRange: number;\n  /** Health percentage threshold to trigger retreat behavior */\n  readonly retreatThreshold: number;\n  /** Technique categories this archetype favors */\n  readonly techniqueSelectionBias: readonly TechniqueCategory[];\n  /** Movement pattern characteristic of this archetype */\n  readonly movementPattern: MovementPattern;\n  /** Whether archetype follows honor code (affects retreat behavior) */\n  readonly honorCode: boolean;\n  /** Priority system for vital point targeting */\n  readonly vitalTargetPriority: VitalTargetPriority;\n}\n\n/**\n * AI personality profile defining combat behavior\n */\nexport interface AIPersonality {\n  readonly name: string;\n  readonly koreanName: string;\n  readonly archetype: PlayerArchetype;\n  readonly aggressionLevel: number; // 0.0-1.0: How often AI attacks\n  readonly defensePreference: number; // 0.0-1.0: Tendency to block/counter\n  readonly comboTendency: number; // 0.0-1.0: Likelihood to continue combos\n  readonly stanceSwitchFrequency: number; // 0.0-1.0: How often changes stance\n  readonly feintChance: number; // 0.0-1.0: Probability of fake attacks\n  readonly tacticalRetreatThreshold: number; // Health % to retreat\n  readonly favoredStances: readonly TrigramStance[];\n  readonly description: {\n    readonly korean: string;\n    readonly english: string;\n  };\n}\n\n/**\n * Archetype-specific behavior profiles\n *\n * Maps each of the 5 player archetypes to their unique combat behaviors,\n * movement patterns, and tactical preferences based on Korean martial arts\n * traditions and game design philosophy.\n *\n * @korean 원형별 행동 프로필\n */\nexport const ARCHETYPE_BEHAVIORS: Record<PlayerArchetype, ArchetypeBehavior> = {\n  [PlayerArchetype.MUSA]: {\n    preferredStances: [\n      TrigramStance.GEON,\n      TrigramStance.JIN,\n      TrigramStance.GAN,\n    ], // Heaven, Thunder, Mountain\n    optimalRange: 1, // Close quarters (1 cell = ~40px)\n    retreatThreshold: 5, // Enhanced: fights to near-death (honor code)\n    techniqueSelectionBias: [\"joint_manipulation\", \"bone_strikes\"],\n    movementPattern: \"aggressive\",\n    honorCode: true, // Never retreats above threshold\n    vitalTargetPriority: \"balanced\",\n  },\n  [PlayerArchetype.AMSALJA]: {\n    preferredStances: [TrigramStance.SON, TrigramStance.GAM], // Wind, Water\n    optimalRange: 1, // Stealth melee (1 cell)\n    retreatThreshold: 20, // Enhanced: tactical retreat, not cowardice\n    techniqueSelectionBias: [\"nerve_strikes\", \"silent_takedowns\"],\n    movementPattern: \"evasive\",\n    honorCode: false,\n    vitalTargetPriority: \"consciousness\",\n  },\n  [PlayerArchetype.HACKER]: {\n    preferredStances: [TrigramStance.LI, TrigramStance.TAE], // Fire, Lake\n    optimalRange: 3, // Mid-range analysis (3 cells = ~120px)\n    retreatThreshold: 50,\n    techniqueSelectionBias: [\"anatomical_analysis\", \"calculated_strikes\"],\n    movementPattern: \"analytical\",\n    honorCode: false,\n    vitalTargetPriority: \"balanced\",\n  },\n  [PlayerArchetype.JEONGBO_YOWON]: {\n    preferredStances: [TrigramStance.GAN, TrigramStance.GON], // Mountain, Earth\n    optimalRange: 2, // Tactical mid-range (2 cells = ~80px)\n    retreatThreshold: 40,\n    techniqueSelectionBias: [\"psychological_pressure\", \"submission_induction\"],\n    movementPattern: \"analytical\",\n    honorCode: false,\n    vitalTargetPriority: \"pain\",\n  },\n  [PlayerArchetype.JOJIK_POKRYEOKBAE]: {\n    preferredStances: [TrigramStance.JIN, TrigramStance.GAM], // Thunder, Water (adaptable)\n    optimalRange: 1, // Close brutal combat (1 cell)\n    retreatThreshold: 70, // Retreats pragmatically\n    techniqueSelectionBias: [\"dirty_techniques\", \"environmental_usage\"],\n    movementPattern: \"unpredictable\",\n    honorCode: false,\n    vitalTargetPriority: \"health\",\n  },\n};\n\n/**\n * Five AI personality archetypes inspired by Korean martial arts philosophy\n */\nexport const AI_PERSONALITIES: Record<string, AIPersonality> = {\n  /**\n   * 맹공자 (Maenggongja) - Fierce Attacker\n   * Aggressive pressure fighter using Musa archetype\n   *\n   * **Enhanced Aggression (Issue #enhance-ai-aggression)**:\n   * - Increased aggression: 0.85 → 0.95 (overwhelming force)\n   * - Reduced defense: 0.2 → 0.1 (all-in offensive)\n   * - Increased combo tendency: 0.7 → 0.8 (sustained pressure)\n   * - Reduced retreat threshold: 0.15 → 0.05 (honor code: fights to near-death)\n   *\n   * **Dynamic Stance Rotation (Issue #dynamic-ai-stance-rotation)**:\n   * - Increased stance switch frequency: 0.3 → 0.5 (more tactical flexibility)\n   */\n  AGGRESSIVE_STRIKER: {\n    name: \"Aggressive Striker\",\n    koreanName: \"맹공자\",\n    archetype: PlayerArchetype.MUSA,\n    aggressionLevel: 0.95, // Enhanced from 0.85\n    defensePreference: 0.1, // Reduced from 0.2\n    comboTendency: 0.8, // Increased from 0.7\n    stanceSwitchFrequency: 0.15, // Reduced: Musa focuses on overwhelming force, not stance dancing\n    feintChance: 0.15,\n    tacticalRetreatThreshold: 0.05, // Reduced from 0.15\n    favoredStances: [\n      TrigramStance.GEON, // Heaven - Direct force\n      TrigramStance.JIN, // Thunder - Explosive power\n      TrigramStance.LI, // Fire - Precision strikes\n    ],\n    description: {\n      korean: \"정면 돌파를 선호하는 공격적인 전사\",\n      english: \"Aggressive warrior who prefers frontal assault\",\n    },\n  },\n\n  /**\n   * 기술가 (Gisulga) - Technical Master\n   * Precision fighter using Amsalja archetype\n   *\n   * **Enhanced Aggression (Issue #enhance-ai-aggression)**:\n   * - Increased aggression: 0.5 → 0.85 (instant takedown focus)\n   * - Reduced defense: 0.6 → 0.3 (opportunistic aggression)\n   * - Increased combo tendency: 0.4 → 0.6 (lethal sequences)\n   * - Reduced retreat threshold: 0.35 → 0.20 (tactical retreat, not cowardice)\n   *\n   * **Dynamic Stance Rotation (Issue #dynamic-ai-stance-rotation)**:\n   * - Increased stance switch frequency: 0.7 → 0.85 (highly adaptive)\n   */\n  TECHNICAL_MASTER: {\n    name: \"Technical Master\",\n    koreanName: \"기술가\",\n    archetype: PlayerArchetype.AMSALJA,\n    aggressionLevel: 0.95, // Enhanced for fatal precision strikes\n    defensePreference: 0.2, // Reduced: assassins attack, don't defend\n    comboTendency: 0.7, // Increased for lethal combinations\n    stanceSwitchFrequency: 0.2, // Reduced: precision strikers commit to their stance\n    feintChance: 0.35,\n    tacticalRetreatThreshold: 0.15, // Reduced: assassins press the attack\n    favoredStances: [\n      TrigramStance.SON, // Wind - Continuous pressure\n      TrigramStance.GAM, // Water - Flow and adaptation\n      TrigramStance.TAE, // Lake - Fluid manipulation\n    ],\n    description: {\n      korean: \"정밀한 기술로 약점을 노리는 달인\",\n      english: \"Master who targets weaknesses with precise techniques\",\n    },\n  },\n\n  /**\n   * 균형 잡힌 자 (Gyunhyeong Jabin-ja) - Balanced Fighter\n   * All-around fighter using Jeongbo Yowon archetype\n   *\n   * **Dynamic Stance Rotation (Issue #dynamic-ai-stance-rotation)**:\n   * - Increased stance switch frequency: 0.5 → 0.7 (strategic switching)\n   */\n  BALANCED_FIGHTER: {\n    name: \"Balanced Fighter\",\n    koreanName: \"균형 잡힌 자\",\n    archetype: PlayerArchetype.JEONGBO_YOWON,\n    aggressionLevel: 0.75, // Enhanced: intelligence operatives are decisive\n    defensePreference: 0.4, // Slightly reduced for more aggression\n    comboTendency: 0.6, // Increased for calculated sequences\n    stanceSwitchFrequency: 0.25, // Reduced: strategic, not reactive\n    feintChance: 0.3, // Increased: psychological warfare\n    tacticalRetreatThreshold: 0.2, // Slightly reduced\n    favoredStances: [\n      TrigramStance.GEON, // Heaven\n      TrigramStance.GAM, // Water\n      TrigramStance.GAN, // Mountain\n      TrigramStance.GON, // Earth\n    ],\n    description: {\n      korean: \"공격과 방어의 조화를 추구하는 전략가\",\n      english: \"Strategist seeking harmony between offense and defense\",\n    },\n  },\n\n  /**\n   * 방어의 달인 (Bangeo-ui Dallin) - Defensive Specialist\n   * Counter-attack focused using Hacker archetype\n   *\n   * **Dynamic Stance Rotation (Issue #dynamic-ai-stance-rotation)**:\n   * - Increased stance switch frequency: 0.4 → 0.6 (analytical adaptation)\n   */\n  DEFENSIVE_SPECIALIST: {\n    name: \"Defensive Specialist\",\n    koreanName: \"방어의 달인\",\n    archetype: PlayerArchetype.HACKER,\n    aggressionLevel: 0.55, // Enhanced: hackers exploit vulnerabilities aggressively\n    defensePreference: 0.6, // Reduced: still defensive but not passive\n    comboTendency: 0.5, // Increased for analytical attack chains\n    stanceSwitchFrequency: 0.2, // Reduced: analytical fighters don't fidget\n    feintChance: 0.45, // Increased: data-driven misdirection\n    tacticalRetreatThreshold: 0.3, // Reduced: hackers are more confident\n    favoredStances: [\n      TrigramStance.GAN, // Mountain - Defensive mastery\n      TrigramStance.GON, // Earth - Grounding\n      TrigramStance.GAM, // Water - Adaptation\n    ],\n    description: {\n      korean: \"방어에서 반격의 기회를 찾는 전문가\",\n      english: \"Expert who finds counter-attack opportunities through defense\",\n    },\n  },\n\n  /**\n   * 혼돈의 전사 (Hondon-ui Jeonsa) - Chaos Warrior\n   * Unpredictable fighter using Jojik Pokryeokbae archetype\n   *\n   * **Dynamic Stance Rotation (Issue #dynamic-ai-stance-rotation)**:\n   * - Increased stance switch frequency: 0.8 → 0.95 (unpredictable chaos)\n   */\n  CHAOS_WARRIOR: {\n    name: \"Chaos Warrior\",\n    koreanName: \"혼돈의 전사\",\n    archetype: PlayerArchetype.JOJIK_POKRYEOKBAE,\n    aggressionLevel: 0.9, // Enhanced: brutal pragmatists attack relentlessly\n    defensePreference: 0.2, // Reduced: dirty fighters don't retreat\n    comboTendency: 0.7, // Increased for vicious combinations\n    stanceSwitchFrequency: 0.3, // Reduced: chaos is in attacks, not stance dancing\n    feintChance: 0.5,\n    tacticalRetreatThreshold: 0.05, // Reduced: fights to the bitter end\n    favoredStances: [\n      TrigramStance.LI, // Fire - Unpredictable\n      TrigramStance.SON, // Wind - Constant motion\n      TrigramStance.JIN, // Thunder - Explosive\n      TrigramStance.TAE, // Lake - Fluid\n    ],\n    description: {\n      korean: \"예측 불가능한 패턴으로 상대를 혼란시키는 전사\",\n      english: \"Warrior who confuses opponents with unpredictable patterns\",\n    },\n  },\n};\n\n/**\n * Get a random AI personality\n */\nexport function getRandomPersonality(): AIPersonality {\n  const personalities = Object.values(AI_PERSONALITIES);\n  return personalities[Math.floor(Math.random() * personalities.length)];\n}\n\n/**\n * Get personality by archetype\n */\nexport function getPersonalityByArchetype(\n  archetype: PlayerArchetype,\n): AIPersonality {\n  const personality = Object.values(AI_PERSONALITIES).find(\n    (p) => p.archetype === archetype,\n  );\n  return personality ?? AI_PERSONALITIES.BALANCED_FIGHTER;\n}\n\n/**\n * Get personality by name key\n */\nexport function getPersonalityByName(name: string): AIPersonality {\n  return AI_PERSONALITIES[name] ?? AI_PERSONALITIES.BALANCED_FIGHTER;\n}\n\n/**\n * List all available personalities\n */\nexport function getAllPersonalities(): readonly AIPersonality[] {\n  return Object.values(AI_PERSONALITIES);\n}\n\n/**\n * Get archetype-specific behavior profile\n *\n * Retrieves the unique combat behavior configuration for a given archetype,\n * including movement patterns, optimal ranges, and tactical preferences.\n *\n * @param archetype - Player archetype to get behavior for\n * @returns Archetype behavior profile\n *\n * @korean 원형별 행동 프로필 가져오기\n */\nexport function getArchetypeBehavior(\n  archetype: PlayerArchetype,\n): ArchetypeBehavior {\n  return ARCHETYPE_BEHAVIORS[archetype];\n}\n\n/**\n * Check if archetype follows honor code\n *\n * Honor code affects retreat behavior - honor-bound archetypes like Musa\n * will not retreat above their health threshold.\n *\n * @param archetype - Player archetype to check\n * @returns True if archetype follows honor code\n *\n * @korean 명예 규범 확인\n */\nexport function followsHonorCode(archetype: PlayerArchetype): boolean {\n  return ARCHETYPE_BEHAVIORS[archetype].honorCode;\n}\n\n/**\n * Get optimal combat range for archetype\n *\n * Returns the preferred distance in grid cells (1 cell = ~40px) where\n * the archetype is most effective in combat.\n *\n * @param archetype - Player archetype\n * @returns Optimal range in grid cells\n *\n * @korean 최적 전투 거리 가져오기\n */\nexport function getOptimalRange(archetype: PlayerArchetype): number {\n  return ARCHETYPE_BEHAVIORS[archetype].optimalRange;\n}\n"],"mappings":"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"}

package/lib/systems/ai/AdaptiveDifficulty.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Adaptive Difficulty System for Korean Martial Arts Combat
+ * Tracks player skill metrics and adjusts AI difficulty dynamically
+ */
+import { AIPersonality } from "./AIPersonality";
+/**
+ * Player skill metrics tracked for adaptive difficulty
+ */
+export interface PlayerSkillMetrics {
+    averageAccuracy: number;
+    comboCount: number;
+    perfectBlocks: number;
+    reactionTime: number;
+    vitalPointHits: number;
+    stanceTransitions: number;
+    damageEfficiency: number;
+    matchesPlayed: number;
+}
+/**
+ * Difficulty tier levels (5 tiers for adaptive system)
+ */
+export declare enum DifficultyTier {
+    BEGINNER = 1,
+    NOVICE = 2,
+    INTERMEDIATE = 3,
+    ADVANCED = 4,
+    EXPERT = 5
+}
+/**
+ * Difficulty parameters that control AI behavior
+ * Applied dynamically based on player skill level
+ *
+ * @korean 난이도 매개변수 - 플레이어 실력에 따라 AI 행동 제어
+ */
+export interface DifficultyParameters {
+    /** AI reaction time range in milliseconds */
+    readonly reactionTimeMs: {
+        readonly min: number;
+        readonly max: number;
+    };
+    /** Accuracy for vital point strikes (0.0-1.0) */
+    readonly vitalPointAccuracy: number;
+    /** Accuracy for basic attacks (0.0-1.0) */
+    readonly basicAttackAccuracy: number;
+    /** Block timing window in milliseconds (smaller = harder to block) */
+    readonly blockTimingWindow: number;
+    /** Decision quality affects technique selection optimality (0.0-1.0) */
+    readonly decisionQuality: number;
+    /** Aggression modifier multiplier (0.5-2.0) */
+    readonly aggressionModifier: number;
+    /** Chance to attempt combo sequences (0.0-1.0) */
+    readonly comboChance: number;
+}
+/**
+ * Difficulty parameter sets for each skill tier
+ * Defines AI behavior characteristics at each difficulty level
+ *
+ * @korean 각 난이도 단계별 매개변수 설정
+ */
+export declare const DIFFICULTY_PARAMETERS: Record<DifficultyTier, DifficultyParameters>;
+/**
+ * Map skill score (0.0-1.0) to difficulty tier
+ * Uses fixed thresholds for consistent tier assignment
+ *
+ * @korean 실력 점수를 난이도 단계로 변환
+ *
+ * @param score - Player skill score (0.0-1.0)
+ * @returns Corresponding difficulty tier
+ */
+export declare function skillScoreToTier(score: number): DifficultyTier;
+/**
+ * Interpolate between two difficulty parameter sets
+ * Used for smooth difficulty transitions over time
+ *
+ * @korean 난이도 매개변수 간 부드러운 전환
+ *
+ * @param from - Starting difficulty parameters
+ * @param to - Target difficulty parameters
+ * @param progress - Interpolation progress (0.0-1.0)
+ * @returns Interpolated difficulty parameters
+ */
+export declare function interpolateDifficultyParameters(from: DifficultyParameters, to: DifficultyParameters, progress: number): DifficultyParameters;
+/**
+ * Adaptive Difficulty System
+ */
+export declare class AdaptiveDifficulty {
+    private playerSkillMetrics;
+    private readonly skillDecay;
+    private readonly learningRate;
+    constructor();
+    /**
+     * Update player skill metrics based on match performance
+     */
+    updateSkillMetrics(matchData: {
+        hitsLanded: number;
+        totalAttacks: number;
+        combosExecuted: number;
+        perfectBlockCount: number;
+        avgReactionTimeMs: number;
+        vitalPointsHit: number;
+        effectiveStanceChanges: number;
+        damageDealt: number;
+        damageTaken: number;
+    }): void;
+    /**
+     * Apply gradual skill decay to prevent over-adjustment
+     */
+    private applySkillDecay;
+    /**
+     * Calculate overall player skill level (0.0 - 1.0)
+     */
+    calculatePlayerSkill(): number;
+    /**
+     * Get current difficulty tier based on skill level
+     */
+    getDifficultyTier(): DifficultyTier;
+    /**
+     * Get difficulty parameters for current skill tier
+     * Returns the appropriate DifficultyParameters based on player skill
+     *
+     * @korean 현재 실력 단계에 맞는 난이도 매개변수 반환
+     */
+    getDifficultyParameters(): DifficultyParameters;
+    /**
+     * Adjust AI personality based on player skill
+     */
+    adjustAIPersonality(personality: AIPersonality): AIPersonality;
+    /**
+     * Get skill metrics
+     */
+    getMetrics(): Readonly<PlayerSkillMetrics>;
+    /**
+     * Reset skill metrics
+     */
+    reset(): void;
+    /**
+     * Get difficulty adjustment recommendation
+     */
+    getDifficultyRecommendation(): {
+        tier: DifficultyTier;
+        tierName: string;
+        skillLevel: number;
+        shouldIncrease: boolean;
+        message: string;
+    };
+    /**
+     * Export metrics for persistence
+     */
+    exportMetrics(): string;
+    /**
+     * Import metrics from persistence
+     */
+    importMetrics(data: string): boolean;
+    /**
+     * Get reference to metrics (for internal use)
+     */
+    private get metrics();
+}
+//# sourceMappingURL=AdaptiveDifficulty.d.ts.map

package/lib/systems/ai/AdaptiveDifficulty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveDifficulty.d.ts","sourceRoot":"","sources":["../../../src/systems/ai/AdaptiveDifficulty.ts"],"names":[],"mappings":"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"}