@subvalue/cli 0.1.3 → 0.1.5

package/dist/packages/core/src/summary.js

@@ -1,64 +1,415 @@
-                                                                           
-import {priceRecord,catalog,            } from './pricing/index.js';
-import {fullCalendarMonths,shiftCalendarDays} from './calendar.js';
-export {fullCalendarMonths} from './calendar.js';
-const dayFormatter=new Intl.DateTimeFormat('en-CA',{year:'numeric',month:'2-digit',day:'2-digit'});
-function localDay(timestamp       )       {const parts=dayFormatter.formatToParts(new Date(timestamp));return ['year','month','day'].map(type=>parts.find(part=>part.type===type) .value).join('-');}
-                                                                                                                                                 
-export function dateRange(preset       ,now=new Date(),from        ,to        ,month        ,anchor        )      {
-  const today=localDay(now.toISOString());
-  if(anchor!==undefined){if((preset!=='7d'&&preset!=='30d')||!/^(?:19|20|21)\d{2}-\d{2}-\d{2}$/.test(anchor)||shiftCalendarDays(anchor,0)===null)throw new Error('Choose a valid period');now=new Date(anchor+'T12:00:00');}
-  const end=new Date(now.getFullYear(),now.getMonth(),now.getDate()+1);let start=new Date(now.getFullYear(),now.getMonth(),now.getDate()-29);let label='Last 30 days';
-  if(preset==='7d'){start=new Date(now.getFullYear(),now.getMonth(),now.getDate()-6);label='Last 7 days';}
-  else if(preset==='month'){
-    if(month!==undefined&&!/^(?:19|20|21)\d{2}-(?:0[1-9]|1[0-2])$/.test(month))throw new Error('Choose a valid month');
-    const year=month?Number(month.slice(0,4)):now.getFullYear(),index=month?Number(month.slice(5,7))-1:now.getMonth();
-    start=new Date(year,index,1);end.setTime(+new Date(year,index+1,1));label=start.toLocaleDateString('en-US',{month:'long',year:'numeric'});
+                                                                                
+import { priceRecord, catalog,              } from './pricing/index.js';
+import { fullCalendarMonths, shiftCalendarDays } from './calendar.js';
+export { fullCalendarMonths } from './calendar.js';
+const dayFormatter = new Intl.DateTimeFormat('en-CA', {
+  year: 'numeric',
+  month: '2-digit',
+  day: '2-digit',
+});
+function localDay(timestamp        )         {
+  const parts = dayFormatter.formatToParts(new Date(timestamp));
+  return ['year', 'month', 'day']
+    .map((type) => parts.find((part) => part.type === type) .value)
+    .join('-');
+}
+                        
+               
+                
+                
+                  
+                                 
+                        
+                      
+ 
+export function dateRange(
+  preset        ,
+  now = new Date(),
+  from         ,
+  to         ,
+  month         ,
+  anchor         ,
+)        {
+  const today = localDay(now.toISOString());
+  if (anchor !== undefined) {
+    if (
+      (preset !== '7d' && preset !== '30d') ||
+      !/^(?:19|20|21)\d{2}-\d{2}-\d{2}$/.test(anchor) ||
+      shiftCalendarDays(anchor, 0) === null
+    )
+      throw new Error('Choose a valid period');
+    now = new Date(anchor + 'T12:00:00');
   }
-  else if(preset==='custom'){
-    if(!from||!to||!/^\d{4}-\d{2}-\d{2}$/.test(from)||!/^\d{4}-\d{2}-\d{2}$/.test(to))throw new Error('Choose a valid date range');
-    start=new Date(from+'T00:00:00');const last=new Date(to+'T00:00:00');const matches=(date     ,text       )=>Number.isFinite(+date)&&date.getFullYear()===Number(text.slice(0,4))&&date.getMonth()+1===Number(text.slice(5,7))&&date.getDate()===Number(text.slice(8,10));if(!matches(start,from)||!matches(last,to)||start>last||+last-+start>36600*864e5)throw new Error('Choose a valid date range');end.setTime(+new Date(last.getFullYear(),last.getMonth(),last.getDate()+1));label=`${from} — ${to}`;
-  }else if(preset!=='30d')throw new Error('Invalid period');
-  const calendarFrom=localDay(start.toISOString()),calendarTo=localDay(new Date(+end-1).toISOString());
-  if(anchor!==undefined&&anchor!==today)label=`${calendarFrom} — ${calendarTo}`;
-  const range={from:start.toISOString(),until:end.toISOString(),label,preset,calendarFrom,calendarTo};
-  return {...range,calendarMonths:fullCalendarMonths(range)};
+  const end = new Date(now.getFullYear(), now.getMonth(), now.getDate() + 1);
+  let start = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 29);
+  let label = 'Last 30 days';
+  if (preset === '7d') {
+    start = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 6);
+    label = 'Last 7 days';
+  } else if (preset === 'month') {
+    if (month !== undefined && !/^(?:19|20|21)\d{2}-(?:0[1-9]|1[0-2])$/.test(month))
+      throw new Error('Choose a valid month');
+    const year = month ? Number(month.slice(0, 4)) : now.getFullYear(),
+      index = month ? Number(month.slice(5, 7)) - 1 : now.getMonth();
+    start = new Date(year, index, 1);
+    end.setTime(+new Date(year, index + 1, 1));
+    label = start.toLocaleDateString('en-US', { month: 'long', year: 'numeric' });
+  } else if (preset === 'custom') {
+    if (!from || !to || !/^\d{4}-\d{2}-\d{2}$/.test(from) || !/^\d{4}-\d{2}-\d{2}$/.test(to))
+      throw new Error('Choose a valid date range');
+    start = new Date(from + 'T00:00:00');
+    const last = new Date(to + 'T00:00:00');
+    const matches = (date      , text        ) =>
+      Number.isFinite(+date) &&
+      date.getFullYear() === Number(text.slice(0, 4)) &&
+      date.getMonth() + 1 === Number(text.slice(5, 7)) &&
+      date.getDate() === Number(text.slice(8, 10));
+    if (
+      !matches(start, from) ||
+      !matches(last, to) ||
+      start > last ||
+      +last - +start > 36600 * 864e5
+    )
+      throw new Error('Choose a valid date range');
+    end.setTime(+new Date(last.getFullYear(), last.getMonth(), last.getDate() + 1));
+    label = `${from} — ${to}`;
+  } else if (preset !== '30d') throw new Error('Invalid period');
+  const calendarFrom = localDay(start.toISOString()),
+    calendarTo = localDay(new Date(+end - 1).toISOString());
+  if (anchor !== undefined && anchor !== today) label = `${calendarFrom} — ${calendarTo}`;
+  const range = {
+    from: start.toISOString(),
+    until: end.toISOString(),
+    label,
+    preset,
+    calendarFrom,
+    calendarTo,
+  };
+  return { ...range, calendarMonths: fullCalendarMonths(range) };
+}
+                             
+                              
+                       
+                     
+                           
+                                               
+                        
+ 
+export function subscriptionForRange(monthly        , range       )                {
+  const months = fullCalendarMonths(range);
+  return months === null ? null : monthly * months;
 }
-                                                                                                                                                                         
-export function subscriptionForRange(monthly       ,range      )            {
-  const months=fullCalendarMonths(range);return months===null?null:monthly*months;
+                                  
+                     
+                    
+                   
+                                                 
+                  
+                          
+                        
+                         
+                                                                                             
+                               
+                               
+                        
+                               
+                     
+                          
+                         
+               
+                         
+                       
+                      
+               
+                                 
+ 
+                        
+               
+                       
+                        
+                    
+ 
+                                
+                     
+              
+                           
+                  
+                        
+                        
+                              
+                               
+                                   
+                               
+                                 
+ 
+                          
+               
+                               
+          
+                                 
+                                 
+                    
+                          
+                                 
+                           
+    
+                 
+                     
+                          
+                             
+                          
+                         
+                
+ 
+function neutral(reason        , subscription                = null)             {
+  return { subscription, value: null, roi: null, breakEven: null, outcome: 'neutral', reason };
 }
-                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         
-                                                                                          
-                                                                                                                                                                                                                                                                                  
-                                                                                                                                                                                                                                                                                                                                                             
-function neutral(reason       ,subscription            =null)           {return {subscription,value:null,roi:null,breakEven:null,outcome:'neutral',reason};}
-export function summarize(records              ,statuses               ,settings         ,range      ,c        =catalog,demo=false)        {
-  const selected=records.filter(r=>r.timestamp&&r.timestamp>=range.from&&r.timestamp<range.until);const prices=new Map(selected.map(r=>[r.id,priceRecord(r,c)]));const dailyMap=new Map              ();
-  for(const r of selected){const date=localDay(r.timestamp );const d=dailyMap.get(date)??{date,codex:null,claude:null,hasUsage:true};const cost=prices.get(r.id) .usd;if(cost!==null)d[r.provider]=(d[r.provider]??0)+cost;dailyMap.set(date,d);}
-  const daily=[...dailyMap.values()].sort((a,b)=>a.date.localeCompare(b.date));
-  const providers=(['codex','claude']              ).map(provider=>{
-    const rows=selected.filter(r=>r.provider===provider),all=records.filter(r=>r.provider===provider),source=statuses.find(s=>s.provider===provider);const issues                      ={};
-    const costs=rows.map(r=>prices.get(r.id) );for(const p of costs)if(p.reason)issues[p.reason]=(issues[p.reason]??0)+1;
-    const undated=all.filter(r=>!r.timestamp).length;if(undated)issues['undated-events']=undated;
-    const priced=costs.filter(p=>p.usd!==null),subtotal=priced.length?priced.reduce((n,p)=>n+p.usd ,0):null;
-    const historyPartial=!demo; // Local transcripts cannot prove that all historical requests were retained.
-    const completePricing=rows.length>0&&priced.length===rows.length;const apiEquivalent=completePricing?subtotal:null;
-    const billing=settings.billing[provider];const subscription=billing.mode==='SUBSCRIPTION'&&billing.monthly!==null?subscriptionForRange(billing.monthly,range):null;
-    let comparison=neutral(billing.mode==='API'?'API usage':billing.mode==='MIXED'?'Mixed billing':billing.mode==='UNKNOWN'?'Billing not set':fullCalendarMonths(range)===null?'Choose a full month':subscription===null?'Subscription price not set':!completePricing?'Pricing unavailable':'Partial history',subscription);
-    if(completePricing&&subscription!==null){const value=apiEquivalent -subscription;let accumulated=0;let breakEven            =null;for(const d of daily){accumulated+=d[provider]??0;if(accumulated>=subscription){breakEven=d.date;break;}}comparison={subscription,value,roi:subscription>0?apiEquivalent /subscription:null,breakEven:historyPartial?null:breakEven,outcome:historyPartial?'neutral':value>0?'positive':value<0?'negative':'neutral',reason:historyPartial?'Observed usage · Partial history':null};}
-    const sumTokens=(key                                                     )            =>rows.length&&rows.every(r=>r[key]!==null)?rows.reduce((total,r)=>total+r[key] ,0):null;
-    const tokenBreakdown={input:sumTokens('input_tokens'),output:sumTokens('output_tokens'),cacheRead:sumTokens('cached_input_tokens')};
-    const tokensKnown=rows.filter(r=>r.total_tokens!==null);const timestamps=all.map(r=>r.timestamp).filter((t)            =>!!t).sort();
-    const hasUsage=rows.some(r=>r.total_tokens!==0);const sourceIncomplete=source?.errors||source?.missingFiles||source?.diagnostics.malformed||source?.diagnostics.partialTail||source?.diagnostics.oversize||source?.diagnostics.unsupported;
-    return {provider,detected:source?.detected??false,visible:hasUsage||settings.include[provider],status:rows.length?(hasUsage?'USAGE_FOUND':'NO_USAGE'):'NO_DATA',records:rows.length,importedRecords:all.length,tokens:tokensKnown.length?tokensKnown.reduce((n,r)=>n+r.total_tokens ,0):null,tokensPartial:tokensKnown.length!==rows.length,tokenBreakdown,apiEquivalent,knownSubtotal:subtotal,pricedRecords:priced.length,priceCoverage:rows.length?priced.length/rows.length:null,confidence:!rows.length?'NO DATA':rows.some(r=>r.quality==='INCOMPLETE')?'INCOMPLETE':sourceIncomplete||undated||rows.some(r=>r.quality==='LOW')?'LOW':rows.some(r=>r.quality==='MEDIUM')?'MEDIUM':'HIGH',historyPartial,comparison,mode:billing.mode,monthly:billing.monthly,first:timestamps[0]??null,last:timestamps.at(-1)??null,days:new Set(timestamps.map(t=>t.slice(0,10))).size,issues}                          ;
+export function summarize(
+  records               ,
+  statuses                ,
+  settings          ,
+  range       ,
+  c          = catalog,
+  demo = false,
+)          {
+  const selected = records.filter(
+    (r) => r.timestamp && r.timestamp >= range.from && r.timestamp < range.until,
+  );
+  const prices = new Map(selected.map((r) => [r.id, priceRecord(r, c)]));
+  const dailyMap = new Map               ();
+  for (const r of selected) {
+    const date = localDay(r.timestamp );
+    const d = dailyMap.get(date) ?? { date, codex: null, claude: null, hasUsage: true };
+    const cost = prices.get(r.id) .usd;
+    if (cost !== null) d[r.provider] = (d[r.provider] ?? 0) + cost;
+    dailyMap.set(date, d);
+  }
+  const daily = [...dailyMap.values()].sort((a, b) => a.date.localeCompare(b.date));
+  const providers = (['codex', 'claude']              ).map((provider) => {
+    const rows = selected.filter((r) => r.provider === provider),
+      all = records.filter((r) => r.provider === provider),
+      source = statuses.find((s) => s.provider === provider);
+    const issues                         = {};
+    const costs = rows.map((r) => prices.get(r.id) );
+    for (const p of costs) if (p.reason) issues[p.reason] = (issues[p.reason] ?? 0) + 1;
+    const undated = all.filter((r) => !r.timestamp).length;
+    if (undated) issues['undated-events'] = undated;
+    const priced = costs.filter((p) => p.usd !== null),
+      subtotal = priced.length ? priced.reduce((n, p) => n + p.usd , 0) : null;
+    const historyPartial = !demo; // Local transcripts cannot prove that all historical requests were retained.
+    const completePricing = rows.length > 0 && priced.length === rows.length;
+    const apiEquivalent = completePricing ? subtotal : null;
+    const billing = settings.billing[provider];
+    const subscription =
+      billing.mode === 'SUBSCRIPTION' && billing.monthly !== null
+        ? subscriptionForRange(billing.monthly, range)
+        : null;
+    let comparison = neutral(
+      billing.mode === 'NO_SUBSCRIPTION'
+        ? 'No subscription'
+        : billing.mode === 'API'
+          ? 'API usage'
+          : billing.mode === 'MIXED'
+            ? 'Mixed billing'
+            : billing.mode === 'UNKNOWN'
+              ? 'Billing not set'
+              : fullCalendarMonths(range) === null
+                ? 'Choose a full month'
+                : subscription === null
+                  ? 'Subscription price not set'
+                  : !completePricing
+                    ? 'Pricing unavailable'
+                    : 'Partial history',
+      subscription,
+    );
+    if (completePricing && subscription !== null) {
+      const value = apiEquivalent  - subscription;
+      let accumulated = 0;
+      let breakEven                = null;
+      for (const d of daily) {
+        accumulated += d[provider] ?? 0;
+        if (accumulated >= subscription) {
+          breakEven = d.date;
+          break;
+        }
+      }
+      comparison = {
+        subscription,
+        value,
+        roi: subscription > 0 ? apiEquivalent  / subscription : null,
+        breakEven: historyPartial ? null : breakEven,
+        outcome: historyPartial
+          ? 'neutral'
+          : value > 0
+            ? 'positive'
+            : value < 0
+              ? 'negative'
+              : 'neutral',
+        reason: historyPartial ? 'Observed usage · Partial history' : null,
+      };
+    }
+    const sumTokens = (
+      key                                                          ,
+    )                =>
+      rows.length && rows.every((r) => r[key] !== null)
+        ? rows.reduce((total, r) => total + r[key] , 0)
+        : null;
+    const tokenBreakdown = {
+      input: sumTokens('input_tokens'),
+      output: sumTokens('output_tokens'),
+      cacheRead: sumTokens('cached_input_tokens'),
+    };
+    const tokensKnown = rows.filter((r) => r.total_tokens !== null);
+    const timestamps = all
+      .map((r) => r.timestamp)
+      .filter((t)              => !!t)
+      .sort();
+    const hasUsage = rows.some((r) => r.total_tokens !== 0);
+    const sourceIncomplete =
+      source?.errors ||
+      source?.missingFiles ||
+      source?.diagnostics.malformed ||
+      source?.diagnostics.partialTail ||
+      source?.diagnostics.oversize ||
+      source?.diagnostics.unsupported;
+    return {
+      provider,
+      detected: source?.detected ?? false,
+      visible: hasUsage || settings.include[provider],
+      status: rows.length ? (hasUsage ? 'USAGE_FOUND' : 'NO_USAGE') : 'NO_DATA',
+      records: rows.length,
+      importedRecords: all.length,
+      tokens: tokensKnown.length ? tokensKnown.reduce((n, r) => n + r.total_tokens , 0) : null,
+      tokensPartial: tokensKnown.length !== rows.length,
+      tokenBreakdown,
+      apiEquivalent,
+      knownSubtotal: subtotal,
+      pricedRecords: priced.length,
+      priceCoverage: rows.length ? priced.length / rows.length : null,
+      confidence: !rows.length
+        ? 'NO DATA'
+        : rows.some((r) => r.quality === 'INCOMPLETE')
+          ? 'INCOMPLETE'
+          : sourceIncomplete || undated || rows.some((r) => r.quality === 'LOW')
+            ? 'LOW'
+            : rows.some((r) => r.quality === 'MEDIUM')
+              ? 'MEDIUM'
+              : 'HIGH',
+      historyPartial,
+      comparison,
+      mode: billing.mode,
+      monthly: billing.monthly,
+      first: timestamps[0] ?? null,
+      last: timestamps.at(-1) ?? null,
+      days: new Set(timestamps.map((t) => t.slice(0, 10))).size,
+      issues,
+    }                          ;
+  });
+  const active = providers.filter((p) => p.records > 0),
+    pricedRecords = active.reduce((n, p) => n + p.pricedRecords, 0),
+    count = selected.length;
+  const known = active.filter((p) => p.knownSubtotal !== null);
+  const knownSubtotal = known.length ? known.reduce((n, p) => n + p.knownSubtotal , 0) : null;
+  const apiEquivalent = count > 0 && pricedRecords === count ? knownSubtotal : null;
+  const subs = active.filter((p) => p.mode === 'SUBSCRIPTION');
+  let comparison = neutral(
+    active.some((p) => p.mode !== 'SUBSCRIPTION')
+      ? 'Subscription comparison unavailable'
+      : 'Partial history',
+  );
+  if (
+    subs.length &&
+    subs.length === active.length &&
+    subs.every((p) => p.comparison.value !== null)
+  ) {
+    const subscription = subs.reduce((n, p) => n + p.comparison.subscription , 0);
+    const value = apiEquivalent  - subscription;
+    let accumulated = 0,
+      breakEven                = null;
+    if (demo)
+      for (const d of daily) {
+        accumulated += (d.codex ?? 0) + (d.claude ?? 0);
+        if (accumulated >= subscription) {
+          breakEven = d.date;
+          break;
+        }
+      }
+    comparison = {
+      subscription,
+      value,
+      roi: subscription > 0 ? apiEquivalent  / subscription : null,
+      breakEven,
+      outcome: demo ? (value > 0 ? 'positive' : value < 0 ? 'negative' : 'neutral') : 'neutral',
+      reason: demo ? null : 'Observed usage · Partial history',
+    };
+  } else if (
+    subs.length &&
+    subs.length === active.length &&
+    subs.every((p) => p.comparison.subscription !== null)
+  )
+    comparison.subscription = subs.reduce((n, p) => n + p.comparison.subscription , 0);
+  const confidence = active.length
+    ? ['INCOMPLETE', 'LOW', 'MEDIUM', 'HIGH'].find((q) => active.some((p) => p.confidence === q)) 
+    : 'NO DATA';
+  const groups = new Map                       ();
+  for (const r of selected) {
+    const key = r.provider + ':' + (r.model_raw ?? 'Unknown model');
+    let rows = groups.get(key);
+    if (!rows) {
+      rows = [];
+      groups.set(key, rows);
+    }
+    rows.push(r);
+  }
+  const models = [...groups.values()].map((rows) => {
+    const first = rows[0],
+      p = prices.get(first.id) ;
+    const priced = rows.filter((r) => prices.get(r.id) .usd !== null),
+      known = rows.filter((r) => r.total_tokens !== null);
+    const issues                         = {};
+    for (const r of rows) {
+      const reason = prices.get(r.id) .reason;
+      if (reason) issues[reason] = (issues[reason] ?? 0) + 1;
+    }
+    return {
+      provider: first.provider,
+      raw: first.model_raw ?? 'Unknown model',
+      canonical: p.canonical,
+      records: rows.length,
+      pricedRecords: priced.length,
+      tokens: known.length ? known.reduce((n, r) => n + r.total_tokens , 0) : null,
+      pricedTokens: priced.some((r) => r.total_tokens !== null)
+        ? priced.reduce((n, r) => n + (r.total_tokens ?? 0), 0)
+        : null,
+      knownSubtotal: priced.length ? priced.reduce((n, r) => n + prices.get(r.id) .usd , 0) : null,
+      mappingConfidence: p.mapping?.confidence ?? null,
+      mappingSource: p.mapping?.source ?? null,
+      issues,
+    };
   });
-  const active=providers.filter(p=>p.records>0),pricedRecords=active.reduce((n,p)=>n+p.pricedRecords,0),count=selected.length;const known=active.filter(p=>p.knownSubtotal!==null);const knownSubtotal=known.length?known.reduce((n,p)=>n+p.knownSubtotal ,0):null;const apiEquivalent=count>0&&pricedRecords===count?knownSubtotal:null;
-  const subs=active.filter(p=>p.mode==='SUBSCRIPTION');let comparison=neutral(active.some(p=>p.mode==='API'||p.mode==='MIXED'||p.mode==='UNKNOWN')?'Subscription comparison unavailable':'Partial history');
-  if(subs.length&&subs.length===active.length&&subs.every(p=>p.comparison.value!==null)){const subscription=subs.reduce((n,p)=>n+p.comparison.subscription ,0);const value=apiEquivalent -subscription;let accumulated=0,breakEven            =null;if(demo)for(const d of daily){accumulated+=(d.codex??0)+(d.claude??0);if(accumulated>=subscription){breakEven=d.date;break;}}comparison={subscription,value,roi:subscription>0?apiEquivalent /subscription:null,breakEven,outcome:demo?(value>0?'positive':value<0?'negative':'neutral'):'neutral',reason:demo?null:'Observed usage · Partial history'};}
-  else if(subs.length&&subs.length===active.length&&subs.every(p=>p.comparison.subscription!==null))comparison.subscription=subs.reduce((n,p)=>n+p.comparison.subscription ,0);
-  const confidence=active.length?['INCOMPLETE','LOW','MEDIUM','HIGH'].find(q=>active.some(p=>p.confidence===q)) :'NO DATA';
-  const groups=new Map                      ();for(const r of selected){const key=r.provider+':'+(r.model_raw??'Unknown model');let rows=groups.get(key);if(!rows){rows=[];groups.set(key,rows);}rows.push(r);}
-  const models=[...groups.values()].map(rows=>{const first=rows[0],p=prices.get(first.id) ;const priced=rows.filter(r=>prices.get(r.id) .usd!==null),known=rows.filter(r=>r.total_tokens!==null);const issues                      ={};for(const r of rows){const reason=prices.get(r.id) .reason;if(reason)issues[reason]=(issues[reason]??0)+1;}return {provider:first.provider,raw:first.model_raw??'Unknown model',canonical:p.canonical,records:rows.length,pricedRecords:priced.length,tokens:known.length?known.reduce((n,r)=>n+r.total_tokens ,0):null,pricedTokens:priced.some(r=>r.total_tokens!==null)?priced.reduce((n,r)=>n+(r.total_tokens??0),0):null,knownSubtotal:priced.length?priced.reduce((n,r)=>n+prices.get(r.id) .usd ,0):null,mappingConfidence:p.mapping?.confidence??null,mappingSource:p.mapping?.source??null,issues};});
-  return {range,providers,total:{apiEquivalent,knownSubtotal,records:count,pricedRecords,priceCoverage:count?pricedRecords/count:null,comparison},daily,confidence,historyPartial:!demo,unresolvedModels:[...new Set(selected.filter(r=>!prices.get(r.id) .canonical).map(r=>r.model_raw??'Unknown model'))],models,pricingVersion:c.version,demo};
+  return {
+    range,
+    providers,
+    total: {
+      apiEquivalent,
+      knownSubtotal,
+      records: count,
+      pricedRecords,
+      priceCoverage: count ? pricedRecords / count : null,
+      comparison,
+    },
+    daily,
+    confidence,
+    historyPartial: !demo,
+    unresolvedModels: [
+      ...new Set(
+        selected
+          .filter((r) => !prices.get(r.id) .canonical)
+          .map((r) => r.model_raw ?? 'Unknown model'),
+      ),
+    ],
+    models,
+    pricingVersion: c.version,
+    demo,
+  };
 }

package/dist/packages/core/src/types.js

@@ -1,30 +1,85 @@
                                           
                                                                
-                                                                       
+// API and MIXED remain readable for existing local settings.
+                                                                                           
+                              
+             
+                           
+                     
+                          
+                            
+                            
+                           
+                           
+                                 
+                          
+                              
+                                     
+                                       
+                                          
+                                          
+                               
+                                  
+                                          
                               
-                                                                                    
-                                                                                 
-                                                                                    
-                                                                                                        
-                                                                                   
-                                                                                                         
-                                                                                        
-                                                                        
-                                                                                        
+                                         
+                   
+                        
+                                
+                  
+                              
+                       
+                                     
                                     
  
                               
-                                                                                           
-                                                                                                        
+                    
+                    
+                   
+                 
+                   
+                      
+                       
+                       
+                      
+                  
  
                                
-                                                                                        
-                                                                                       
+                     
+                    
+                
+                  
+                 
+                 
+                       
+                       
+                           
  
                            
-                                                                          
+                     
+                  
+                                     
                                   
-                                                                                             
+                                                                                                   
  
-export const defaultSettings = ()           => ({onboarded:false,currency:'USD',include:{codex:false,claude:false},billing:{codex:{mode:'UNKNOWN',monthly:null},claude:{mode:'UNKNOWN',monthly:null}}});
-export const emptyDiagnostics = ()              => ({malformed:0,inherited:0,repeated:0,resets:0,oversize:0,unsupported:0,partialTail:false,first:null,last:null,records:0});
+export const defaultSettings = ()           => ({
+  onboarded: false,
+  currency: 'USD',
+  include: { codex: false, claude: false },
+  billing: {
+    codex: { mode: 'UNKNOWN', monthly: null },
+    claude: { mode: 'UNKNOWN', monthly: null },
+  },
+});
+export const emptyDiagnostics = ()              => ({
+  malformed: 0,
+  inherited: 0,
+  repeated: 0,
+  resets: 0,
+  oversize: 0,
+  unsupported: 0,
+  partialTail: false,
+  first: null,
+  last: null,
+  records: 0,
+});