#!/usr/bin/env python3
"""Offline candidate planner; it never opens or rewrites model weights.

Input is a small JSON config (usually a hand-copied config.json excerpt).  The
output is a reviewable plan for expert-retention experiments.  It deliberately
does not infer language-specialist experts or select tensor names.
"""
from __future__ import annotations

import argparse
import json
import math
from pathlib import Path


def plan(config: dict, prune_fraction: float) -> dict:
    text = config.get("text_config", config)
    experts = int(text["num_experts"])
    top_k = int(text.get("num_experts_per_tok", 0))
    layers = int(text.get("num_hidden_layers", 0))
    mtp = int(text.get("mtp_num_hidden_layers", 0))
    if not 0 <= prune_fraction < 1:
        raise ValueError("prune_fraction must be in [0, 1)")
    retained = max(top_k, int(round(experts * (1.0 - prune_fraction))))
    removed = experts - retained
    return {
        "status": "PLAN_ONLY",
        "experts_before": experts,
        "experts_after_candidate": retained,
        "experts_removed_candidate": removed,
        "actual_removed_fraction": removed / experts,
        "active_experts_per_token": top_k,
        "layers": layers,
        "mtp_layers_present": mtp,
        "constraints": [
            "do not prune shared experts",
            "verify router renormalization after structural pruning",
            "inspect MTP/vision paths before changing config",
            "run reload + forward before quantization",
            "calibrate and evaluate by domain/language; do not label experts by language",
        ],
    }


def main() -> None:
    ap = argparse.ArgumentParser()
    ap.add_argument("config", type=Path)
    ap.add_argument("--prune", type=float, action="append", required=True,
                    help="fraction of routed experts to remove; repeatable")
    ns = ap.parse_args()
    config = json.loads(ns.config.read_text())
    print(json.dumps({"source": str(ns.config), "candidates":
                      [plan(config, p) for p in ns.prune]}, indent=2))


if __name__ == "__main__":
    main()
