#!/bin/sh
set -eu

DOCS_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
cd "$DOCS_DIR"

# Keep generated HTML identical to the CI and Pages deployment builds.
required_pandoc_version=3.10
if ! command -v pandoc >/dev/null 2>&1; then
  printf 'Documentation requires Pandoc %s; install the version pinned in the documentation workflows.\n' "$required_pandoc_version" >&2
  exit 1
fi
pandoc_version=$(pandoc --version | sed -n '1s/^pandoc //p')
if [ "$pandoc_version" != "$required_pandoc_version" ]; then
  printf 'Documentation requires Pandoc %s (found %s); install the version pinned in the documentation workflows.\n' "$required_pandoc_version" "$pandoc_version" >&2
  exit 1
fi

python3 build_theme_assets.py

build_page() {
  source_file=$1
  output_file=$2
  page_title=$3
  eyebrow=$4
  summary=$5
  api_page=${6:-false}
  changelog_page=${7:-false}
  terminology_page=${8:-false}

  pandoc "$source_file" \
    --from=gfm \
    --to=html5 \
    --standalone \
    --template=assets/reference-template.html \
    --lua-filter=assets/reference-links.lua \
    --toc \
    --toc-depth=2 \
    --mathml \
    --metadata title="$page_title" \
    --metadata eyebrow="$eyebrow" \
    --metadata summary="$summary" \
    --metadata source="$source_file" \
    --metadata api_page="$api_page" \
    --metadata changelog_page="$changelog_page" \
    --metadata terminology_page="$terminology_page" \
    --output="$output_file"
}

build_page api.md api.html "API Reference" "Public interfaces" \
  "Request contracts, response shapes, validation behavior, overload handling, and examples for integrating with A.T.O.M." true
build_page rf-analysis-request-budget-audit.md rf-analysis-request-budget-audit.html "RF Request Budget Audit" "Request control" \
  "Measured six-cell workflow costs, shared admission policy, retry timing correction, abuse enforcement, and scientific invariance evidence."
build_page network-optimization-deadline-audit.md network-optimization-deadline-audit.html "Network Optimization Deadline Audit" "Runtime evidence" \
  "Measured optimizer phases, repeated per-cell RF work, bounded memoization, cancellation, and unchanged scientific results."
build_page auto-resource-profile-foundation.md auto-resource-profile-foundation.html "Auto Resource Profiling Foundation" "Runtime observations" \
  "Automatic CPU and memory observations, provenance, controlled-container calibration and unchanged fixed RF policy."
build_page auto-resource-geometry-calibration.md auto-resource-geometry-calibration.html "Geometry Density Calibration" "Calibration evidence" \
  "Deterministic Ankara geometry domains, repeated workload measurements, held-out predictors and unchanged observational Auto policy."
build_page auto-resource-estimator-locked-validation.md auto-resource-estimator-locked-validation.html "Locked Estimator Validation" "Validation evidence" \
  "Frozen workload estimators, fresh Ankara domains, unseen settings, actual HTTP streaming and sustained-load decision evidence."
build_page fixed-deployment-profile-certification.md fixed-deployment-profile-certification.html "Fixed Deployment Profile Certification" "Operations evidence"   "Frozen Ankara workload envelopes, bounded reference resources, actual HTTP evidence, concurrency, background overlap and conservative operational headroom."
build_page w1-shipping-runtime-qualification.md w1-shipping-runtime-qualification.html "W1 Shipping Runtime Qualification" "Operations evidence" "Exact W1 successor on the shipping Go runtime, resource floors, actual HTTP evidence and sustained background activity."
build_page eight-cell-operational-budget-audit.md eight-cell-operational-budget-audit.html "Eight-Cell Operational and Request-Budget Re-audit" "Audit-only capacity evidence" "Paired six-to-eight W1 operational measurements and unchanged request-budget workflows on the minimum certified deployment; product cap remains six."
build_page eight-cell-operational-budget-successor.md eight-cell-operational-budget-successor.html "Eight-Cell Clean Successor Qualification" "Audit-only operations evidence" "Verified pre-measurement real E2Es, unchanged paired W1 qualification and request-budget product-fit decision; production cap remains six."
build_page eight-cell-request-budget-policy-design.md eight-cell-request-budget-policy-design.html "Eight-Cell Request-Budget Policy Design" "Design study" "Source-derived workflows, bounded abuse envelopes, candidate comparisons and a verified-follow-up recommendation; production policy and Cell cap remain unchanged."
build_page algorithms.md algorithms.html "Algorithms and RF Physics" "Model reference" \
  "The deterministic propagation, geometry, optimization, and radio-quality methods behind A.T.O.M results."
build_page features.md features.html "Capabilities" "Product reference" \
  "A structured inventory of planning modes, analyses, map evidence, reports, and supported radio technologies."
build_page project-format.md project-format.html "Portable Project Format" "Persistence contract" \
  "Lossless retained-result files, version compatibility, identity provenance, and bounded import safety."
build_page persistence-reliability-audit.md persistence-reliability-audit.html "Persistence Reliability Audit" "Measured repair" \
  "Six-Cell export/import and Scenario Undo root causes, bounded fixes, invariance evidence, and validation."
build_page visualization.md visualization.html "Reading Propagation Maps" "Visual interpretation" \
  "How to interpret sector rays, frequency-dependent attenuation, coverage evidence, and the current map layers."
build_page deployment.md deployment.html "Deployment" "Operations guide" \
  "Container, reverse-proxy, readiness, capacity, scaling, and production-hardening guidance for A.T.O.M."
build_page dataset-pack-studio.md dataset-pack-studio.html "Dataset Pack Studio" "Local data tooling" \
  "Inspect, repair, reproject, package, validate, install, and safely switch arbitrary-region A.T.O.M dataset packs."
build_page faq.md faq.html "Frequently Asked Questions" "Help and troubleshooting" \
  "Answers for setup, RF interpretation, performance, data, API access, and common operating problems."
build_page report-guide.md report-guide.html "Reading Planning Reports" "Report reader guide" \
  "Decision summaries, KPI units and populations, RF profiles, map evidence, source provenance and reference PDF print settings."
build_page planning-walkthrough.md planning-walkthrough.html "Two-Cell Planning Walkthrough" "Reproducible example" \
  "A fixed Ankara baseline, azimuth recommendation, overlap trade-off and portable project/report evidence with recorded API inputs."
build_page terminology.md terminology.html "Cell, Sector, Site, and Tower Record" "Planning glossary" \
  "Definitions that distinguish planning Cells, directional sectors, physical sites, tower dataset records, and candidate feasibility." false false true
build_page contributing.md contributing.html "Contributing" "Contributor guide" \
  "Repository structure, development setup, testing expectations, and contribution workflow for A.T.O.M."
build_page modeling-limits.md modeling-limits.html "Modeling Limits" "Confidence boundary" \
  "What the deterministic planning model includes, what it excludes, and how to interpret its outputs responsibly."
build_page concept-4e-building-entry.md concept-4e-building-entry.html "Concept 4E Building Entry" "Model reference" \
  "Deterministic facade-entry estimates, standard-derived O2I scenarios, material evidence, API behavior, and canonical audit."
build_page concept-4f1-height-aware-obstruction.md concept-4f1-height-aware-obstruction.html "Concept 4F.1 Height-Aware Obstruction" "Model reference" \
  "Deterministic centerline roof obstruction, height provenance, conservative unknown-height behavior, terrain metadata, and canonical audit."
build_page concept-4f2-diffraction-diagnostic.md concept-4f2-diffraction-diagnostic.html "Concept 4F.2 Diffraction Diagnostic" "Model reference" \
  "P.526-aligned single-edge diffraction reference math, obstruction ledgers, known-height applicability, canonical comparison, and diagnostic boundaries."
build_page concept-4f3a-spatial-evidence-foundation.md concept-4f3a-spatial-evidence-foundation.html "Concept 4F.3A Spatial Evidence Foundation" "Data evidence" \
  "DTM/DSM semantics, vertical-datum gates, windowed raster sampling, building base and roof evidence, external-height matching, provenance ledgers, Ankara readiness, and the 4F.3B promotion gate."
build_page concept-4f3a1-external-height-source.md concept-4f3a1-external-height-source.html "Concept 4F.3A.1 External Height Pilot" "Data evidence" \
  "Bounded Microsoft GlobalMLBuildingFootprints acquisition, Ankara input QA, normalized height evidence, deterministic matching, agreement metrics, and a measured 4F.3B promotion decision."
build_page concept-4f3a2-gba-height-source.md concept-4f3a2-gba-height-source.html "Concept 4F.3A.2 GBA.Height Ankara Pilot" "Data evidence" \
  "Official GlobalBuildingAtlas GBA.Height acquisition, license and semantic audit, windowed footprint sampling, agreement metrics, precedence comparison, readiness impact, and a measured 4F.3B NO-GO decision."
build_page concept-4g1-antenna-link-budget.md concept-4g1-antenna-link-budget.html "Concept 4G.1 Antenna and Link Budget" "Model reference" \
  "Conducted-power and EIRP semantics, shared antenna evaluation, explicit link-budget terms, reference-pattern behavior, diagnostics, and compatibility evidence."
build_page concept-4g2-receiver-noise-sensitivity.md concept-4g2-receiver-noise-sensitivity.html "Concept 4G.2 Receiver Noise and Sensitivity" "Model reference" \
  "Deterministic thermal-noise-derived receiver thresholds, strict link usability, per-cell metadata, bandwidth semantics, integration boundaries, and canonical comparison evidence."
build_page concept-4h1-interference-radio-quality.md concept-4h1-interference-radio-quality.html "Concept 4H.1 Interference and Radio Quality" "Model reference" \
  "Inspectable received-carrier power, serving-cell selection, co-channel eligibility, resource normalization, thermal noise, planning radio-quality metrics, diagnostics, and deterministic fingerprints."
build_page concept-4h2-radio-quality-optimization.md concept-4h2-radio-quality-optimization.html "Concept 4H.2 Interference-Aware Optimization" "Model reference" \
  "An optional fixed-domain radio-quality objective for deterministic multi-cell optimization, with explicit denominator, horizon, policy, Pareto, compatibility, and performance semantics."
build_page concept-5b-multistart-search.md concept-5b-multistart-search.html "Concept 5B Deterministic Multi-Start Search" "Optimization audit" \
  "An opt-in deterministic multi-start coordinate search with until-stable termination, request-scoped memoization, archive-based Pareto discovery, explicit budgets, and canonical audit evidence."
build_page concept-5c-pareto-search.md concept-5c-pareto-search.html "Concept 5C Priority-Independent Pareto Archive Search" "Optimization audit" \
  "An opt-in bounded multi-objective archive search that discovers candidates without using user priority weights, then reranks the evaluated Pareto trade-offs."
build_page concept-5d-search-policy-selection.md concept-5d-search-policy-selection.html "Concept 5D Search Policy Selection" "Optimization decision audit" \
  "A decision-only comparison of the frozen legacy, Concept 5B, and Concept 5C search policies across exhaustive quality, cost, sensitivity, Ankara, and product use cases."
build_page concept-4i1-140ghz-audit.md concept-4i1-140ghz-audit.html "Concept 4I.1 140 GHz Applicability Audit" "Scientific audit" \
  "A read-only audit of the 140 GHz research planning profile, authoritative reference applicability, independent atmospheric and material terms, transferability, and the future roadmap."
build_page concept-4i2a-atmospheric-reference.md concept-4i2a-atmospheric-reference.html "Concept 4I.2A Atmospheric Reference" "Scientific reference" \
  "An opt-in, non-canonical Sub-THz atmospheric component ledger using P.525-5, P.676-13, P.838-3, and local-fog P.840-9 terms."
build_page concept-4i2b-p1411-reference.md concept-4i2b-p1411-reference.html "Concept 4I.2B P.1411 Candidate Reference" "Scientific reference" \
  "Applicability-gated ITU-R P.1411-13 Table 4 candidate rows, 140 GHz envelopes, provenance, median-only statistics, isolated comparisons, and Ankara readiness."
build_page concept-4i3-measurement-validation.md concept-4i3-measurement-validation.html "Concept 4I.3 Measurement Validation" "Scientific validation" \
  "Versioned measurement campaigns, quantity semantics, reference-model adapters, deterministic calibration and spatial holdouts, evidence readiness, and the Ankara measurement gap."
build_page concept-6a-canonical-rf-validation.md concept-6a-canonical-rf-validation.html "Concept 6A Canonical RF Validation" "Scientific validation" \
  "Source-independent 2.6/28 GHz RF observation semantics, canonical primitive reuse, deterministic matching, applicability gates, residual diagnostics, spatial holdouts, and conservative readiness."
build_page concept-6a1-campaign-tooling.md concept-6a1-campaign-tooling.html "Concept 6A.1 Campaign Tooling" "Measurement acquisition" \
  "Ankara receive-side campaign tooling, Signal Collector V6 raw preservation, transmitter truth mapping, quantity-specific readiness, dry-run validation, and the Concept 6B gate."
build_page concept-6a1-1-real-pilot-ingestion.md concept-6a1-1-real-pilot-ingestion.html "Concept 6A.1.1 Real Ankara Pilot Ingestion" "Scientific evidence" \
  "Sanitized real Signal Collector ingestion, GNSS and LTE quality, B7 evidence, transmitter reconciliation, and the conservative validation readiness decision."
build_page concept-6a1-2-serving-state-semantics.md concept-6a1-2-serving-state-semantics.html "Concept 6A.1.2 Serving-State Semantics" "Scientific evidence" \
  "A privacy-preserving reconciliation of Android CellInfo, Signal Collector serving transitions, LTE ServiceState identities, subscription context, and the unresolved source-semantics decision."
build_page concept-7c-run-history.md concept-7c-run-history.html "Concept 7C Durable Local Run History" "Local persistence" \
  "Separate browser-local run history for exact draft execution snapshots, compact results, lifecycle recovery, lineage, deletion, and safe historical inspection."
build_page concept-7d-report-artifacts.md concept-7d-report-artifacts.html "Concept 7D Local Report and Artifact Delivery" "Local evidence" \
  "Traceable local report definitions, immutable report artifacts, historical Run generation, content verification, retention, and delivery behavior."
build_page concept-7e-scenario-ux.md concept-7e-scenario-ux.html "Concept 7E Scenario, Version, and Branch UX" "Scenario productization" \
  "Local-first Scenario switching, explicit immutable Versions, input diffs, branch and duplicate lineage, optimization application, Run/Report navigation, and safe Version comparison."
build_page concept-7g-results-lineage.md concept-7g-results-lineage.html "Concept 7G Results, Lineage, and Stale-State UX" "Result identity" \
  "Shared current, stale, historical, unavailable, and unsupported states; persistent workspace lineage; safe Run, Report, Apply, and rerun sources; responsive result context."
build_page concept-7h-rf-progressive-disclosure.md concept-7h-rf-progressive-disclosure.html "Concept 7H RF Configuration Progressive Disclosure" "Workspace UX" \
  "Three-tier RF configuration, collapsed specialist tools, control inventory and classification, profile boundaries, measured drawer density, responsive behavior, and compatibility evidence."
build_page concept-4i4-material-facade-reference.md concept-4i4-material-facade-reference.html "Concept 4I.4 Material and Facade Reference" "Scientific reference" \
  "An isolated ITU-R P.2040-4 homogeneous slab ledger with explicit electrical properties, TE/TM coefficients, applicability, numerical stability, controlled fixtures, and non-combined heuristic comparison."
build_page concept-4i5a-reflection-audit.md concept-4i5a-reflection-audit.html "Concept 4I.5A Specular Reflection Audit" "Scientific audit" \
  "A read-only 140 GHz single-bounce specular reflection audit covering image geometry, path spreading, P.2040 coefficient composition, facade evidence, roughness, visibility, Ankara readiness, and a gated 4I.5B contract."
build_page concept-4i5b-specular-reflection-reference.md concept-4i5b-specular-reflection-reference.html "Concept 4I.5B Specular Reflection Reference" "Scientific reference" \
  "An isolated single-bounce image-source reference with explicit finite-facade geometry, P.2040 TE/TM interface or slab coefficients, visibility, Fresnel and far-field evidence, and a non-combined reflected-path link budget."
build_page bug-fixes.md bug-fixes.html "Bug-Fix Register" "Quality history" \
  "Prioritized confirmed defects, user impact, root causes, corrections, and regression evidence for A.T.O.M releases."
build_page ../CHANGELOG.md changelog.html "Changelog" "Release history" \
  "User-visible additions, changes, fixes, and release milestones generated from the canonical project changelog." false true


build_page bounded-followup-policy-implementation.md bounded-followup-policy-implementation.html "Bounded Verified Follow-up Policy Implementation" "Operational policy" \
  "Verified child prebooking, one-time capabilities, bounded state, six-Cell production invariance and eight-Cell audit validation."

build_page eight-cell-product-cap-promotion.md eight-cell-product-cap-promotion.html "Eight-Cell Product Cap Promotion" "Product promotion" \
  "Normal selected-network cap8, independent limits, frozen W1/Profile A scope and0.12.0 readiness."

python3 build_search_index.py