"""Mechanism geometry audits; all are descriptive and never select parameters."""
import numpy as np,torch

def course_geometry(model,faculties,target_prepared,history_rows,device='cpu'):
    model.eval();meta=target_prepared.meta[len(history_rows):];ids=target_prepared.cid[len(history_rows):];ct=target_prepared.counts[len(history_rows):];fi=target_prepared.fac[len(history_rows):]
    out=[]
    with torch.no_grad():
        for f,fac in enumerate(faculties):
            idx=np.flatnonzero(fi==f)
            if not len(idx):continue
            if len(idx)>5000:idx=np.random.default_rng(42).choice(idx,5000,replace=False)
            pars=[]
            for start in range(0,len(idx),1024):
                sl=idx[start:start+1024]
                x=torch.as_tensor(meta[sl],device=device).unsqueeze(1);v=torch.as_tensor(fi[sl],device=device).long();c=torch.as_tensor(ids[sl],device=device).long().unsqueeze(1);n=torch.as_tensor(ct[sl],device=device).float().unsqueeze(1)
                pars.append(model.course(x,v,c,n).squeeze(1).cpu().numpy())
            q=np.concatenate(pars,0)
            if model.kind=='mirt':
                value=q[:,:-1];difficulty=q[:,-1];requirement_label='positive_discrimination'
            else:value=q;difficulty=np.zeros(len(q));requirement_label='course_requirement'
            # Remove each course's common level before testing multidimensional diversity.
            centered=value-value.mean(1,keepdims=True)
            cov=np.cov(centered.T) if len(centered)>1 else np.eye(value.shape[1])*0
            eigen=np.maximum(np.linalg.eigvalsh(np.atleast_2d(cov)),0)
            p=eigen/(eigen.sum()+1e-9);rank=float(np.exp(-np.sum(p*np.log(np.maximum(p,1e-9))))) if eigen.sum()>1e-10 else 0.
            out.append({'faculty':fac,'variant':model.kind,'rows_sampled':len(q),'requirement_kind':requirement_label,
                        'known_course_rate':float(np.mean(ids[idx]>0)),'prior_course_mean':float(np.mean(ct[idx])),
                        'requirement_mean':float(value.mean()),'requirement_std':float(value.std()),
                        'within_course_dimension_std':float(centered.std()),'centered_effective_rank':rank,
                        'largest_rank_eigenvalue':float(eigen[-1]),'smallest_rank_eigenvalue':float(eigen[0]),
                        'course_difficulty_mean':float(difficulty.mean()),'course_difficulty_sd':float(difficulty.std())})
    return out

def filter_health(model):
    return {'rho_base':float(torch.sigmoid(model.rho_logit).detach().cpu()),
            'process_noise_diag':torch.nn.functional.softplus(model.process_log).detach().cpu().tolist(),
            'damping':float(model.damping),'discount':float(model.discount),'tau':float(model.tau),
            'ordinal_increment_by_faculty':torch.nn.functional.softplus(model.ord_raw).detach().cpu().tolist()}
