Anime Character Loader

name: anime-character-loader type: python-package description: | Load anime character info from multiple sources and generate validated SOUL.generated.md files. Features: multi-source query, forced disambiguation, cross-source consistency scoring, idempotent merge, semantic validation. version: 2.4.2 author: Anchormind

commands:

• name: load description: Load character with multi-source validation usage: load_character.py <character_name> [options] examples:
  • "load_character.py 'Kasumigaoka Utaha'"
  • "load_character.py '霞之丘诗羽' --anime 'Saekano'"
  • "load_character.py 'Sakurajima Mai' -o ./characters"

options: --anime, -a: Anime/manga name hint for disambiguation (REQUIRED for ambiguous names) --output, -o: Output directory (default: current) --info, -i: Show character info only --force, -f: Force generation even with low confidence --select, -s: Select specific match by index (when multiple found)

output: filename: SOUL.generated.md loading_options: - "[1] REPLACE - cp SOUL.generated.md SOUL.md" - "[2] MERGE - Idempotent merge into existing SOUL.md (no duplicates)" - "[3] KEEP - Manual review"

validation: score_threshold: 80 required_sections: - Identity - Personality - Boundaries semantic_checks: - contains_name: Character name present - contains_source: Source work referenced - has_structure: All required sections present - content_length: Minimum 500 characters - no_placeholders: No TODO/FIXME/placeholder text - meaningful_background: Background has substance - specific_personality: Personality not generic - speaking_style_details: Speaking Style has bullets - name_consistency: Name variations consistent

data_sources:

• name: AniList endpoint: https://graphql.anilist.co weight: 0.5 auth: none
• name: Jikan (MyAnimeList) endpoint: https://api.jikan.moe/v4 weight: 0.3 auth: none

exit_codes: 0: Success 10: Network error (API timeout, no internet) 20: Data error (no matches, ambiguous name, low confidence) 30: Validation error (quality checks failed) 40: File error (write failure, permission denied)

features:

• Multi-source parallel query with cross-source validation
• Automatic failover and retry (3 attempts)
• 24-hour response cache (SQLite)
• Forced disambiguation (requires --anime for ambiguous names)
• Cross-source consistency scoring (AniList + Jikan comparison)
• Force manual selection when top matches are close (<0.15 gap)
• Semantic validation with 9 checks
• Idempotent merge (character+work deduplication)
• Atomic write with rollback (no partial files)

confidence_levels: high: ">= 0.8" medium: "0.5-0.8" low: "< 0.5 (reject or --force)"