{
  "schema_version": "jp-election-public-root-ai-router.v1",
  "presentation_language": "en",
  "generated_at": "2026-04-25T01:58:27Z",
  "page_title": "AI public root router",
  "page_summary": "This clipboard is the public root router for jp-election-public-ja. Do not preload all public data; classify the question first and then read only the required public URLs.",
  "source_release_version": "2026-04-14-v046",
  "page_id": "2026-02-08_hr_smd",
  "public_base_url": "https://jp-election-public-ja-2026-hr-smd.pages.dev",
  "do_not_preload_all_data": true,
  "fetch_policy": [
    "Classify the question first into current / years / graph / file lookup / docs.",
    "Read heavy CSV / JSON / municipality indexes only when they are actually needed.",
    "Start from indexes, maps, and manifests before resolving a concrete public URL.",
    "Do not use internal paths, generated local paths, or private-viewer paths.",
    "Prefer explicit public_key and public URL values rather than guessed naming-rule paths."
  ],
  "entry_pages": [
    {
      "id": "index_html",
      "label": "Public root",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html",
      "note": "This root surface itself. Entry router for current / graph / data."
    },
    {
      "id": "current_html",
      "label": "Current page",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html",
      "note": "Current published page for the active release surface."
    },
    {
      "id": "years_html",
      "label": "Year pages",
      "href": "https://jp-election-public-ja.pages.dev/years",
      "note": "Directory of published year pages and election families."
    },
    {
      "id": "graph_html",
      "label": "Municipality / Graph Explorer",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/graph.html",
      "note": "Municipality / prefecture / national trend explorer."
    },
    {
      "id": "links_html",
      "label": "Link index",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/links.html",
      "note": "Public list of documents and election-scoped links."
    },
    {
      "id": "party_proportional_html",
      "label": "Proportional analysis",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/party-proportional.html",
      "note": "Analysis page for proportional party series."
    },
    {
      "id": "party_constituency_html",
      "label": "Constituency analysis",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/party-constituency.html",
      "note": "Analysis page for constituency series."
    }
  ],
  "public_indexes": [
    {
      "id": "root_ai_router_md",
      "label": "root-ai-router.en.md",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/root-ai-router.en.md",
      "note": "Minimal router markdown intended for clipboard use."
    },
    {
      "id": "root_ai_router_json",
      "label": "root-ai-router.en.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/root-ai-router.en.json",
      "note": "Structured JSON for question routing and public indexes."
    },
    {
      "id": "page_profile_json",
      "label": "page-profile.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-profile.json",
      "note": "Root page summary, counts, and navigation metadata."
    },
    {
      "id": "page_links_json",
      "label": "page-links.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-links.json",
      "note": "Structured list of doc groups and election link rows."
    },
    {
      "id": "file_links_tsv",
      "label": "file-links.tsv",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/file-links.tsv",
      "note": "First lookup index for public canonical / derived files."
    },
    {
      "id": "download_catalog_json",
      "label": "page/downloads/catalog.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/catalog.json",
      "note": "Group catalog for bulk download targets."
    },
    {
      "id": "download_all_json",
      "label": "page/downloads/all-files.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/all-files.json",
      "note": "Full list of public download targets with public_key, href, size, and sha256."
    },
    {
      "id": "site_config_json",
      "label": "site-config.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/site-config.json",
      "note": "Index of public docs, analysis pages, and routes."
    },
    {
      "id": "page_ai_catalog_map_json",
      "label": "page/page-ai-catalog-map.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-ai-catalog-map.json",
      "note": "Heavy municipality graph-family index map. Read only when needed."
    },
    {
      "id": "graph_page_json",
      "label": "analysis/graph-family/latest/graph-page.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/analysis/graph-family/latest/graph-page.json",
      "note": "Graph family page contract and scope status."
    },
    {
      "id": "party_proportional_graph_page_json",
      "label": "analysis/party-proportional/latest/graph-page.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/analysis/party-proportional/latest/graph-page.json",
      "note": "Page contract for the proportional analysis surface."
    },
    {
      "id": "graph_family_spec_html",
      "label": "docs/graph-family-spec.en.html",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/graph-family-spec.en.html",
      "note": "Standalone public spec describing what the graph can do."
    },
    {
      "id": "analysis_reports_index_html",
      "label": "docs/reports/index.html",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/reports/index.html",
      "note": "Shelf for uploaded analysis reports intended for AI or human readers."
    },
    {
      "id": "analysis_reports_index_json",
      "label": "docs/reports/index.json",
      "href": "https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/reports/index.json",
      "note": "JSON index of uploaded analysis reports."
    }
  ],
  "question_routes": [
    {
      "question_type": "site_navigation",
      "when": "Questions about how to navigate the site or how current / graph / data differ.",
      "read_first": [
        "root_ai_router_json",
        "page_profile_json"
      ],
      "then_optional": [
        "index_html",
        "current_html",
        "years_html",
        "graph_html",
        "links_html"
      ],
      "note": "Resolve the route first, then read only the needed entry page."
    },
    {
      "question_type": "year_or_release_lookup",
      "when": "Questions about year pages, published pages, or the current release page.",
      "read_first": [
        "years_html",
        "current_html",
        "page_links_json"
      ],
      "then_optional": [
        "file_links_tsv",
        "download_catalog_json"
      ],
      "note": "Prefer the HTML routes plus structured link rows."
    },
    {
      "question_type": "graph_or_municipality_analysis",
      "when": "Questions about municipality / prefecture / national graph analysis and related payloads.",
      "read_first": [
        "graph_html",
        "graph_page_json"
      ],
      "then_optional": [
        "page_ai_catalog_map_json",
        "graph_family_spec_html",
        "file_links_tsv"
      ],
      "note": "Read the heavy municipality map only when the question truly needs it."
    },
    {
      "question_type": "canonical_or_derived_file_lookup",
      "when": "Questions that need the public URL of a canonical / derived CSV, JSON, or document.",
      "read_first": [
        "file_links_tsv",
        "download_all_json"
      ],
      "then_optional": [
        "page_links_json",
        "download_catalog_json",
        "site_config_json"
      ],
      "note": "Do not guess paths. Use the public_key / href resolved by the indexes."
    },
    {
      "question_type": "spec_or_methodology",
      "when": "Questions about public docs, specs, graph methodology, or public-surface contracts.",
      "read_first": [
        "site_config_json"
      ],
      "then_optional": [
        "graph_family_spec_html",
        "links_html",
        "page_links_json"
      ],
      "note": "Read the docs index first, then open only the needed spec."
    },
    {
      "question_type": "analysis_reports",
      "when": "Questions that need published analysis reports, commentary, or external AI-authored reports.",
      "read_first": [
        "analysis_reports_index_json"
      ],
      "then_optional": [
        "analysis_reports_index_html",
        "site_config_json"
      ],
      "note": "List available reports from the reports index first, then read only the needed report HTML or raw source."
    }
  ],
  "rules": [
    "State which public URLs were actually read before answering.",
    "When data volume is large, fetch only the specific public artifacts needed.",
    "If the question does not require full data, stop at the catalog / map level.",
    "For graph-family joins, prefer party_id / seriesId / jis_code / election_set_key over display labels."
  ]
}
