AI Tools for Wiki Maintenance

This page documents automated tools and suggestions for maintaining the Remixed Dungeon wiki, particularly for AI and automated systems to help with maintenance tasks.

Python-based Tools (Located in tools/py-tools/ directory):

• find_red_links.py - Identifies internal wiki links that point to non-existent pages (redlinks)
• scale_sprites_for_wiki.py - Processes game sprites for wiki use with proper scaling and borders
• check_broken_images.py - Verifies that all images referenced in wiki pages exist
• dokuwiki_linter.py - Validates DokuWiki syntax and identifies potential formatting issues

Machine-Readable Data:

• The mr: namespace contains machine-readable reference pages
• These pages contain raw data about entities extracted from source code
• Created for different entity types: mobs, items, spells, etc.

Entity Tracking:

• AI systems should track entity relationships across the codebase
• Information sources: Java classes, Lua scripts, JSON configs, string resources
• Cross-reference getEntityKind() method results with file names

• Static Analysis: Tools that scan code for entities and their properties
• Wiki Link Validation: Automated checking of internal links
• Content Freshness: Tools to identify pages that haven't been updated in a long time
• Naming Consistency: Validation that page names follow the convention {entity_name}_{type} (e.g., tengu_mob, ankh_item)

The following tools would be beneficial for wiki maintenance:

• entity_extractor.py - Automatically extract entity data from Java/Lua/JSON files and suggest wiki page content
• page_updater.py - Compare existing wiki pages with current code and suggest updates
• translation_validator.py - Verify that pages in different languages contain consistent information
• link_suggester.py - Suggest relevant pages that should be linked together
• naming_consistency_checker.py - Check for pages that don't follow the proper naming convention and suggest renames
• content_verifier.py - Automatically verify game mechanics information against source code and flag outdated content
• redlink_resolver.py - Automatically create new pages for redlinks based on available code data
• multilingual_content_sync.py - Ensure consistency of content across different language versions of the same page

When implementing AI-based wiki maintenance:

• Verify all information against the actual source code before updating
• Maintain consistency in naming conventions across all pages
• Preserve the existing formatting and structure when possible
• When creating new pages, follow the established template for that entity type
• Include references to the source code that confirms the information

Content Analysis Tools:

• string_resource_analyzer.py - Analyze string resources across different languages to ensure consistency and completeness
• image_reference_checker.py - Verify that all referenced images exist and are properly named
• tag_validator.py - Ensure all pages have appropriate tags and that tags are consistent across similar entities

Quality Assurance Tools:

• fact_checker.py - Cross-reference wiki content with codebase to detect inconsistencies
• duplicate_content_detector.py - Identify duplicated information across different pages
• content_gap_analyzer.py - Identify entities that exist in the game but don't have wiki pages

Localization Enhancement Tools:

• auto_translation_suggester.py - Suggest translations based on string resources and existing localized pages
• completeness_tracker.py - Track which pages exist in which languages and identify missing translations

• For Java code: Reference the specific classes and methods that define entity behavior
• For Lua scripts: Include the specific files that implement custom mechanics
• For JSON configs: Reference the exact files and fields that contain the configuration data
• For string resources: Include links to the string definitions in various languages

Automated Verification Tools:

• spell_check_wiki.py - Perform spell-checking and grammar validation across all wiki pages
• link_health_checker.py - Verify that all external links are still valid and accessible
• image_size_optimizer.py - Optimize image sizes and formats for better wiki performance
• consistency_checker.py - Verify consistent formatting and DokuWiki syntax across pages

AI Enhancement Tools:

• auto_content_updater.py - Automatically update wiki pages when corresponding code changes are detected
• summary_generator.py - Create automatic summaries of changes made to wiki pages
• entity_relationship_mapper.py - Create visual maps of relationships between different game entities
• template_generator.py - Automatically create template pages for new entity types based on existing patterns

Workflow Improvement Tools:

• multi_language_sync.py - Synchronize updates across language versions of wiki pages
• merge_conflict_resolver.py - Automatically handle merge conflicts in wiki content
• version_diff_analyzer.py - Highlight differences when wiki pages are updated
• validation_report_generator.py - Create reports of all verification checks and their status

Content Enhancement Tools:

• stat_extractor.py - Extract statistics from game code and automatically format them for wiki pages
• code_comment_linker.py - Link wiki explanations to relevant comments in source code
• example_generator.py - Create game scenario examples based on code mechanics
• cross_reference_builder.py - Build automatic cross-references between related wiki pages