{
  "purpose": "Token-efficient machine-readable routing for tarinai_. Use scripts/ai_inventory.py for exact current file expansion.",
  "version": "39.16.74",
  "entrypoints": {
    "app": "index.html",
    "runtime": "js/main.js",
    "update_order": "js/system_order.js",
    "manifest": "app_manifest.json",
    "service_worker": "service-worker.js"
  },
  "read_strategy": {
    "default": [
      "README.md"
    ],
    "architecture": [
      "README.md",
      "AI_MAP.md"
    ],
    "exact_inventory": [
      "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/ai_inventory.ps1 -All",
      "python scripts/ai_inventory.py --all"
    ],
    "machine_routing": [
      "FILES.json"
    ]
  },
  "groups": [
    {
      "id": "root",
      "patterns": [
        ".gitignore",
        ".htaccess",
        "app_manifest.json",
        "favicon.ico",
        "index.html",
        "README.md",
        "AI_MAP.md",
        "GAME_FEATURES.md",
        "FILES.json",
        "service-worker.js",
        "achievement_api.php",
        ".achievement_data/.htaccess"
      ],
      "meaning": "Repo/app shell metadata, server/static cache config, docs, manifest, entrypoint."
    },
    {
      "id": "css",
      "patterns": [
        "css/*.css"
      ],
      "meaning": "Base, layout, panel, component, and mobile responsive styling."
    },
    {
      "id": "scripts",
      "patterns": [
        "scripts/*.js",
        "scripts/*.py",
        "scripts/*.ps1"
      ],
      "meaning": "Generators, regression checks, version-specific audits, and token-aware AI inventory tooling."
    },
    {
      "id": "core",
      "patterns": [
        "js/version.js",
        "js/event_bus.js",
        "js/domain_ids.js",
        "js/registry_base.js",
        "js/disease_registry.js",
        "js/sound_pack.js",
        "js/deterministic_helpers.js",
        "js/item_tool_metadata.js",
        "js/item_tool_definitions.js",
        "js/item_visual_definitions.js",
        "js/item_food_definitions.js",
        "js/item_effect_definitions.js",
        "js/item_registry.js",
        "js/data.js",
        "js/ground_types.js",
        "js/health.js",
        "js/input_mode_manager.js",
        "js/main.js",
        "js/math.js",
        "js/perf_profiler.js",
        "js/debug_tools.js",
        "js/update_step_pipeline_runner.js",
        "js/burn_motion_util.js"
      ],
      "meaning": "Bootstrap, shared constants/helpers, registries, config, profiling/debug."
    },
    {
      "id": "assets_runtime",
      "patterns": [
        "js/assets.js",
        "js/audio.js",
        "js/render.js",
        "js/tarinai_render.js",
        "js/item_render_runtime.js"
      ],
      "meaning": "Image/audio loading and canvas rendering."
    },
    {
      "id": "simulation",
      "patterns": [
        "js/sim_core.js",
        "js/simulation*.js",
        "js/system_order.js"
      ],
      "meaning": "Simulation primitives, concrete systems, phase ordering."
    },
    {
      "id": "world",
      "patterns": [
        "js/world*.js",
        "js/weather_system.js"
      ],
      "meaning": "World state/view/update/tools/environment/combat/family/social/ants."
    },
    {
      "id": "physics",
      "patterns": [
        "js/physics*.js",
        "js/mechanical_system.js",
        "js/constraint_system.js",
        "js/collision_footprint_system.js"
      ],
      "meaning": "Geometry, collisions, constraints, mechanical item behavior."
    },
    {
      "id": "items",
      "patterns": [
        "js/item*.js",
        "js/items.js",
        "js/structures.js",
        "js/structure_lifecycle.js",
        "js/circuit_board_system.js"
      ],
      "meaning": "Item/structure registry, lifecycle, dynamic behavior, rendering."
    },
    {
      "id": "tarinai",
      "patterns": [
        "js/tarinai*.js",
        "js/ants.js",
        "js/seesaw_system.js"
      ],
      "meaning": "Creature state/actions/needs/social life/item effects/disease/rendering plus ant actor model."
    },
    {
      "id": "save",
      "patterns": [
        "js/save*.js",
        "js/snapshot_system.js",
        "js/restore_coordinator.js",
        "js/history_system.js"
      ],
      "meaning": "Snapshot schema/codec/storage/restore/history."
    },
    {
      "id": "ui",
      "patterns": [
        "js/ui*.js",
        "js/text_catalog.js",
        "js/command_dispatcher.js",
        "js/family_graph.js",
        "js/achievements.js"
      ],
      "meaning": "DOM UI, input, tools, selected panel, logs, charts, family tree, text labels, command routing."
    },
    {
      "id": "assets",
      "patterns": [
        "assets/sprites/tarinai_*.webp",
        "assets/ui/tool_*",
        "assets/ui/favicon*",
        "assets/ui/apple-touch-icon.png",
        "assets/ui/ecology_*.webp",
        "assets/objects/*",
        "assets/sounds/*"
      ],
      "meaning": "Creature sprites, UI/tool icons, field object images, voice/SFX samples."
    }
  ],
  "conventions": {
    "*_pipeline.js": "ordered runner/facade",
    "*_step_*.js": "pipeline stage wrapper",
    "*_system.js": "domain service or compatibility facade",
    "*_runtime.js": "stable runtime-facing facade",
    "*_registry.js": "definition lookup/normalization"
  }
}