feat: rename AI credit input fields

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: asizikov

README.md

@@ -60,7 +60,7 @@ npm run preview
 3. The app will parse the report and compare request-based and AI Credits-based billing signals
 4. Explore the visualizations and data views to preview how future bills may look after the AI Credits transition
 
-Sample reports are available in the `examples/` directory. Older examples without `aiu_quantity` still load, but AI Credits will remain `0` for those rows.
+Sample reports are available in the `examples/` directory. Older examples without `aic_quantity` still load, but AI Credits will remain `0` for those rows.
 
 ## CSV Report Format
 
@@ -81,9 +81,10 @@ The application expects CSV files with the following primary columns:
 - `total_monthly_quota` - Monthly quota amount
 - `organization` - Organization slug
 - `cost_center_name` - Optional cost center identifier
-- `aiu_quantity` - AI Credits for the same usage row
+- `aic_quantity` - AI Credits for the same usage row
+- `aic_gross_amount` - AI Credit gross cost for the same usage row
 
-The viewer now supports both billing units. On `requests` rows, `quantity` and `applied_cost_per_quantity` drive PRU-based calculations, while `aiu_quantity` and `aiu_gross_amount` remain comparison values and stay `0` when those AI Credit fields are absent. On `ai-units` rows, Premium Requests and generic PRU gross/discount/net totals are counted as `0`; AI Credits are counted from the AI-specific credit fields (`aiu_quantity`, falling back to `quantity` only when the AI field is absent) and AI Credit gross cost comes from `aiu_gross_amount` (falling back to `gross_amount` only when the AI field is absent). Legacy token columns may still appear in older exports, but they are no longer used by the app.
+The viewer now supports both billing units. On `requests` rows, `quantity` and `applied_cost_per_quantity` drive PRU-based calculations, while `aic_quantity` and `aic_gross_amount` remain comparison values and stay `0` when those AI Credit fields are absent. On `ai-units` rows, Premium Requests and generic PRU gross/discount/net totals are counted as `0`; AI Credits are counted from the AI-specific credit fields (`aic_quantity`, falling back to `quantity` only when the AI field is absent) and AI Credit gross cost comes from `aic_gross_amount` (falling back to `gross_amount` only when the AI field is absent). Legacy `aiu_*` column names from older exports are still accepted during parsing, but they are no longer the documented format.
 
 See [docs/report-format.md](docs/report-format.md) for detailed format specifications.
 

docs/report-format.md

@@ -21,21 +21,22 @@ Source examples: files in `examples/`. Some existing sample exports still use th
 | `total_monthly_quota` | number | Monthly quota for the user or plan applicable to the row. |
 | `organization` | string | Organization slug associated with the usage. |
 | `cost_center_name` | string | Optional cost center or tagging field. |
-| `aiu_quantity` | number | Same usage converted to AI Credits. |
+| `aic_quantity` | number | Same usage converted to AI Credits. |
 
 ## Additional columns
 
 | Column | Status | Notes |
 | --- | --- | --- |
-| `aiu_gross_amount` | Present in newer previews | Used for AI Credit gross cost when present. |
+| `aic_gross_amount` | Present in newer previews | Used for AI Credit gross cost when present. |
 | `total_input_tokens` | Legacy / optional | Older token-oriented export field; ignored by the app. |
 | `total_output_tokens` | Legacy / optional | Older token-oriented export field; ignored by the app. |
 | `total_cache_creation_tokens` | Legacy / optional | Older token-oriented export field; ignored by the app. |
 | `total_cache_read_tokens` | Legacy / optional | Older token-oriented export field; ignored by the app. |
 
 ## Notes
 - Header row is single-lined; subsequent rows are usage records. Values are comma-separated, double-quoted where needed.
-- Monetary fields are decimals. `aiu_quantity` may also be fractional.
+- Monetary fields are decimals. `aic_quantity` may also be fractional.
 - The app streams the file, treats the first row as the header, and counts subsequent data rows without loading the entire file into memory.
-- Current calculations support both row types: on `requests` rows, `quantity` and `applied_cost_per_quantity` describe PRU usage while `aiu_quantity` and `aiu_gross_amount` remain reference/comparison values and stay `0` when the AI Credit fields are absent; on `ai-units` rows, Premium Requests and generic PRU gross/discount/net totals are counted as `0`, while AI Credits and AI Credit gross cost are taken from the AI-specific fields (`aiu_quantity` / `aiu_gross_amount`, with fallback to `quantity` / `gross_amount` only when those AI-specific fields are absent).
-- Reports without `aiu_quantity` still load, but AI Credit summaries will display `0`.
+- Current calculations support both row types: on `requests` rows, `quantity` and `applied_cost_per_quantity` describe PRU usage while `aic_quantity` and `aic_gross_amount` remain reference/comparison values and stay `0` when those AI Credit fields are absent; on `ai-units` rows, Premium Requests and generic PRU gross/discount/net totals are counted as `0`, while AI Credits and AI Credit gross cost are taken from the AI-specific fields (`aic_quantity` / `aic_gross_amount`, with fallback to `quantity` / `gross_amount` only when those AI-specific fields are absent).
+- Reports without `aic_quantity` still load, but AI Credit summaries will display `0`.
+- Older exports that still use legacy `aiu_quantity` / `aiu_gross_amount` headers are accepted as parser fallbacks.

src/pipeline/parser.ts

@@ -24,11 +24,11 @@ export type TokenUsageRecord = {
   total_monthly_quota: number
   organization: string
   cost_center_name: string | null
-  aiu_quantity: number
-  aiu_gross_amount: number
+  aic_quantity: number
+  aic_gross_amount: number
   aic_net_amount: number
-  has_aiu_quantity: boolean
-  has_aiu_gross_amount: boolean
+  has_aic_quantity: boolean
+  has_aic_gross_amount: boolean
 }
 
 export type TokenUsageHeader = {
@@ -57,14 +57,14 @@ export type UsageMetrics = {
 export function getAicUsageMetrics(record: TokenUsageRecord): Pick<UsageMetrics, 'aiuQuantity' | 'aiuGrossAmount'> {
   if (isAiUnitUsageRecord(record.unit_type)) {
     return {
-      aiuQuantity: record.has_aiu_quantity ? record.aiu_quantity : record.quantity,
-      aiuGrossAmount: record.has_aiu_gross_amount ? record.aiu_gross_amount : record.gross_amount,
+      aiuQuantity: record.has_aic_quantity ? record.aic_quantity : record.quantity,
+      aiuGrossAmount: record.has_aic_gross_amount ? record.aic_gross_amount : record.gross_amount,
     }
   }
 
   return {
-    aiuQuantity: record.aiu_quantity,
-    aiuGrossAmount: record.aiu_gross_amount,
+    aiuQuantity: record.aic_quantity,
+    aiuGrossAmount: record.aic_gross_amount,
   }
 }
 
@@ -173,10 +173,16 @@ function getNullableString(row: string[], i: number | undefined): string | null
   return raw ? raw : null
 }
 
+function getOptionalHeaderIndex(header: TokenUsageHeader, ...names: string[]): number | undefined {
+  return names.map((name) => header.index[name]).find((index) => index !== undefined)
+}
+
 export function parseTokenUsageRecord(line: string, header: TokenUsageHeader): TokenUsageRecord {
   const row = parseCsvRow(line)
-  const aiuQuantityRaw = getString(row, header.index['aiu_quantity']).trim()
-  const aiuGrossAmountRaw = getString(row, header.index['aiu_gross_amount']).trim()
+  const aicQuantityIndex = getOptionalHeaderIndex(header, 'aic_quantity', 'aiu_quantity')
+  const aicGrossAmountIndex = getOptionalHeaderIndex(header, 'aic_gross_amount', 'aiu_gross_amount')
+  const aicQuantityRaw = getString(row, aicQuantityIndex).trim()
+  const aicGrossAmountRaw = getString(row, aicGrossAmountIndex).trim()
 
   const record: TokenUsageRecord = {
     date: getString(row, header.index['date']).trim(),
@@ -194,11 +200,11 @@ export function parseTokenUsageRecord(line: string, header: TokenUsageHeader): T
     total_monthly_quota: getNumber(row, header.index['total_monthly_quota']),
     organization: getString(row, header.index['organization']).trim(),
     cost_center_name: getNullableString(row, header.index['cost_center_name']),
-    aiu_quantity: getNumber(row, header.index['aiu_quantity']),
-    aiu_gross_amount: getNumber(row, header.index['aiu_gross_amount']),
+    aic_quantity: getNumber(row, aicQuantityIndex),
+    aic_gross_amount: getNumber(row, aicGrossAmountIndex),
     aic_net_amount: 0,
-    has_aiu_quantity: aiuQuantityRaw !== '',
-    has_aiu_gross_amount: aiuGrossAmountRaw !== '',
+    has_aic_quantity: aicQuantityRaw !== '',
+    has_aic_gross_amount: aicGrossAmountRaw !== '',
   }
 
   record.aic_net_amount = getAicUsageMetrics(record).aiuGrossAmount

src/views/ReportGuideView.tsx

@@ -14,8 +14,8 @@ const HEADER = [
   'total_monthly_quota',
   'organization',
   'cost_center_name',
-  'aiu_quantity',
-  'aiu_gross_amount',
+  'aic_quantity',
+  'aic_gross_amount',
 ]
 
 const SAMPLE_ROW_1 = [
@@ -87,12 +87,12 @@ const SAMPLE_ROW_2_ANNOTATIONS: { index: number; label: string; note: string }[]
   },
   {
     index: 15,
-    label: 'aiu_quantity',
+    label: 'aic_quantity',
     note: '≈ 24.9 AICs consumed. Under token-based billing, even Base Models consume AI Credits proportional to actual token usage.',
   },
   {
     index: 16,
-    label: 'aiu_gross_amount',
+    label: 'aic_gross_amount',
     note: '≈ $0.249 (24.9 AICs × $0.01). This is what the same usage would cost under token-based billing.',
   },
 ]
@@ -135,12 +135,12 @@ const SAMPLE_ROW_1_ANNOTATIONS: { index: number; label: string; note: string }[]
   { index: 14, label: 'cost_center_name', note: '"Octocats" — the cost center this user is assigned to.' },
   {
     index: 15,
-    label: 'aiu_quantity',
+    label: 'aic_quantity',
     note: '≈ 3.107 AICs — the token-based billing equivalent of this request. AICs represent the actual tokens consumed.',
   },
   {
     index: 16,
-    label: 'aiu_gross_amount',
+    label: 'aic_gross_amount',
     note: '≈ $0.031 (3.107 AICs × $0.01). Under token-based billing this request would cost roughly $0.03.',
   },
 ]