"""
inc/import_inc.py — Fireside Communications · INC (incident / fault) ingestion.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Thin entrypoint over the shared engine (`pipeline.py`) for the INC dataset:
    tickets.inc   — incidents / customer faults  (FleetOps "Tickets" INC tab)

INC reads the incremental CDC change stream automations/inc/changes/<EAT-ts>.csv
from the `isptickets` bucket, upserts on ticket_id, advances the per-dataset
watermark, archives each file to automations/inc/processed/, and — uniquely to
INC — runs tickets.capture_history() after each --apply run (closure_events +
daily backlog snapshot). Geocoding (--geocode-clusters / --geocode-locations) is
CROSS-DATASET and driven from here (the shared gazetteer covers inc + crq).

Usage (needs DATABASE_URL + RUSTFS_* + GEOCODER_* env; see .env.example):
    python -m inc.import_inc --from-bucket --apply
    python -m inc.import_inc --from-bucket --reseed --apply   # one-time bucket cutover
    python -m inc.import_inc --inc-csv 2026-06-15T17-00-00.csv --apply
    python -m inc.import_inc --geocode-clusters --apply
    python -m inc.import_inc --geocode-locations --apply

Pre-requisite: migrations applied (run_migrations.py) — tickets.inc/crq +
geo_clusters + geo_locations + reporting.fn_tickets_for_map.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
"""

from __future__ import annotations

import argparse

import pipeline

# INC captures closure/backlog history after every --apply run (CRQ does not yet).
DATASET = pipeline.make_dataset("inc", post_apply=pipeline.capture_history)


def main() -> None:
    ap = argparse.ArgumentParser(description="Ingest INC tickets from CSV (raw-first) + geocode")
    ap.add_argument("--apply", action="store_true", help="Write to DB (default: dry-run)")
    ap.add_argument("--from-bucket", action="store_true",
                    help="Drain the incremental INC change stream (automations/inc/changes/) "
                         "from the isptickets S3 bucket: every not-yet-processed file "
                         "oldest→newest, upsert on ticket_id, advance the watermark, archive")
    ap.add_argument("--reseed", action="store_true",
                    help="Ignore the stored watermark and drain every file in changes/ once "
                         "(one-time bucket cutover / reseed). Use with --from-bucket --apply")
    ap.add_argument("--inc-csv", dest="local_csv", default=None,
                    help="Local INC tickets CSV file (dev)")
    ap.add_argument("--geocode-clusters", action="store_true",
                    help="Geocode distinct clusters (inc+crq) into the gazetteer, then re-resolve")
    ap.add_argument("--geocode-locations", action="store_true",
                    help="Geocode actionable inc+crq location_names precisely (keyed provider), "
                         "then re-resolve")
    ap.add_argument("--capture-history", action="store_true",
                    help="Run tickets.capture_history() standalone "
                         "(closure_events + daily snapshot)")
    args = ap.parse_args()

    if args.geocode_clusters:
        pipeline.geocode_clusters(apply=args.apply)
        return
    if args.geocode_locations:
        pipeline.geocode_locations(apply=args.apply)
        return
    if args.capture_history:
        pipeline.capture_history()
        return
    if not (args.from_bucket or args.local_csv):
        ap.error("provide --from-bucket, --inc-csv, --geocode-clusters, "
                 "--geocode-locations, or --capture-history")
    pipeline.ingest(DATASET, args)


if __name__ == "__main__":
    main()