"""Standalone daily-score functions; venue gates and deduplication are documented separately."""
import math
import statistics as st
DAY=86400

def clip(x):return max(0,min(1,x))

def calculate(candles,btc,cutoff):
    by={int(k[0])//1000:k for k in candles if int(k[0])//1000<cutoff and int(k[6])/1000<=cutoff}
    # Exclude the announcement/first trading day from the comparable daily window.
    series=sorted(by)
    if len(series)<9:return None,'fewer_than_8_completed_post_listing_days'
    series=series[1:][-30:]
    if series[-1]!=cutoff-DAY or any(b-a!=DAY for a,b in zip(series,series[1:])):return None,'missing_or_stale_daily_window'
    bars=[]
    for t in series:
        k=by[t];o,h,l,c,q=map(float,(k[1],k[2],k[3],k[4],k[7]))
        if not all(math.isfinite(v) for v in (o,h,l,c,q)) or not 0<l<=min(o,c)<=max(o,c)<=h or q<=0:return None,'invalid_ohlcv'
        bars.append(dict(opened=t,o=o,h=h,l=l,c=c,qv=q))
    med=st.median(r['qv'] for r in bars[-7:])
    if med<50000:return None,'7d_median_turnover_below_50k'
    closes=[r['c'] for r in bars[-8:]];p=closes[-1];sma=st.mean(closes[-7:]);sma_all=st.mean(closes)
    r7=p/closes[-8]-1;btcret=btc[series[-1]]/btc[series[-8]]-1
    peak=closes[0];dd=0
    for x in closes:peak=max(peak,x);dd=max(dd,1-x/peak)
    vol=st.stdev(math.log(b/a) for a,b in zip(closes,closes[1:]))*math.sqrt(365)
    active=sum(r['qv']>=50000 for r in bars[-7:])/7
    parts=dict(turnover=10*clip(math.log10(med/50000)/2),drawdown=10*clip(1-dd/.7),trend=10*(.5*(p>sma)+.5*(sma>sma_all)),relative_btc=10*clip(.5+(r7-btcret)/.6),participation=10*active)
    penalty=min(1,max(0,p/sma-1-.2)/.5)
    weights=dict(turnover=.30,drawdown=.25,trend=.20,relative_btc=.15,participation=.10)
    score=max(0,sum(parts[k]*v for k,v in weights.items())-penalty)
    return dict(raw_score=score,components=parts,weights=weights,extension_penalty=penalty,close=p,sma7=sma,sma_window=sma_all,return7=r7,btc_return7=btcret,excess_btc7=r7-btcret,drawdown=dd,annualized_volatility=vol,median_quote7=med,active_day_share=active,window_days=len(bars),score_window_days=7,first_candle=series[0],bars=bars,stance='Trend supported; monitor entry conditions' if p>sma and r7>0 else 'Recovery watch; wait for trend repair'),None