Find a specific article in Japanese law (ULTRA SMART & FAST)

Supports 16+ major laws with direct mapping for instant access.
Handles complex patterns like 条の2, 項, 号 automatically.

Args:
    law_name: Law name (e.g., "民法", "会社法", "憲法")
    article_number: Article number (e.g., "192", "325条の3", "第9条第2項")
    ctx: FastMCP context for logging and progress reporting

Returns:
    Dict with found article content and legal analysis metadata

Search Japanese laws with smart filtering

Args:
    law_title: Law title (partial match)
    law_type: Law type (Act, CabinetOrder, etc.)
    law_num: Law number (partial match)
    limit: Maximum results (1-500)
    offset: Starting position
    ctx: FastMCP context for logging

Returns:
    Dict with search results

Full-text keyword search in Japanese laws

Args:
    keyword: Search keyword (required)
    law_type: Law type filter (optional)
    limit: Maximum results (1-20)
    ctx: FastMCP context for logging

Returns:
    Dict with search results

Get law content (optimized per API spec with size limits)

Args:
    law_id: Law ID
    law_num: Law number
    response_format: "json" or "xml"
    elm: Element to retrieve (currently disabled due to API 400 errors)
    ctx: FastMCP context for logging

Returns:
    Dict with law content. For large laws (>800KB), returns summary with recommendation to use find_law_article for specific articles.

Note:
    - elm parameter is currently disabled due to e-Gov API 400 errors
    - Large laws like Company Law (会社法) will return a summary instead of full text
    - Use find_law_article tool for specific article searches in large laws

Batch find multiple law articles efficiently

Args:
    law_article_pairs: JSON string with law-article pairs, e.g. '[{"law":"民法","article":"192"},{"law":"憲法","article":"9"}]'
    ctx: FastMCP context for logging

Returns:
    Dict with batch results and performance stats

Prefetch commonly accessed laws for better performance

Args:
    ctx: FastMCP context for logging
    
Returns:
    Dict with prefetch results and cache status

Get current cache statistics and performance metrics

Args:
    ctx: FastMCP context for logging
    
Returns:
    Dict with detailed cache statistics

Clear specified cache or all caches

Args:
    cache_type: Cache type to clear ("all", "law_lookup", "law_content", "article")
    ctx: FastMCP context for logging

Returns:
    Dict with clear operation results