fix(quota): show "not in plan" instead of misleading 100%, map code 2056 (#173)

A Token Plan that does not bundle a model (e.g. video) makes the server
return that model's row as 0/0 with remaining_percent=100, marked
current_*_status=3. The table trusted the percent and rendered a
misleading "100%", while `video generate` was rejected by the server with
code 2056 — a contradiction reported in #173.

- quota-table: when current_interval_status / current_weekly_status is 3,
  render "not in plan" / "不在当前套餐中" instead of the bar+percent.
  Status is the only reliable signal: in-plan time-based rows are also
  0/0 but report status=1.
- errors/api: fold code 2056 into the existing quota branch so the user
  gets a QUOTA exit code with a check-usage / upgrade hint.

Builds on #168, which already added the current_*_status fields to
QuotaModelRemain; this change consumes them.

Author: kapelame

src/errors/api.ts

@@ -69,8 +69,8 @@ export function mapApiError(status: number, body: ApiErrorBody, url?: string): C
     );
   }
 
-  // MiniMax insufficient quota
-  if (apiCode === 1028 || apiCode === 1030) {
+  // MiniMax insufficient quota / weekly usage limit (2056)
+  if (apiCode === 1028 || apiCode === 1030 || apiCode === 2056) {
     const hint = planHintForUrl(url);
     return new CLIError(
       `Quota exhausted. ${apiMsg}`,

src/output/quota-table.ts

@@ -30,10 +30,11 @@ interface Labels {
   resetsIn: string;
   noData: string;
   now: string;
+  notInPlan: string;
 }
 
-const LABELS_EN: Labels = { dashboard: 'TokenPlan Quota', week: 'Week', current: 'Left', weekly: 'Wk left', resetsIn: 'Reset', noData: 'No quota data available.', now: 'now' };
-const LABELS_CN: Labels = { dashboard: 'TokenPlan 配额面板', week: '周期', current: '剩余', weekly: '周剩余', resetsIn: '重置', noData: '暂无配额数据', now: '即将' };
+const LABELS_EN: Labels = { dashboard: 'TokenPlan Quota', week: 'Week', current: 'Left', weekly: 'Wk left', resetsIn: 'Reset', noData: 'No quota data available.', now: 'now', notInPlan: 'not in plan' };
+const LABELS_CN: Labels = { dashboard: 'TokenPlan 配额面板', week: '周期', current: '剩余', weekly: '周剩余', resetsIn: '重置', noData: '暂无配额数据', now: '即将', notInPlan: '不在当前套餐中' };
 
 const MODEL_NAME_CN: Record<string, string> = {
   'general': '通用',
@@ -98,13 +99,22 @@ function renderBar(remainingPct: number, color: boolean, barWidth: number = BAR_
   return showPct ? `${bar} ${fg}${B}${pctStr}${R}` : bar;
 }
 
+// Server status for a model not bundled in the plan: counts read 0/0 with
+// percent 100, so only status distinguishes it from an in-plan 0/0 row (=1).
+const STATUS_NOT_IN_PLAN = 3;
+
 function renderMetric(
   label: string,
   remaining: number,
   total: number,
   percent: number | undefined | null,
   color: boolean,
+  status: number | undefined | null,
+  notInPlanLabel: string,
 ): string {
+  if (status === STATUS_NOT_IN_PLAN) {
+    return color ? `${D}${label}${R} ${FG_RED}${notInPlanLabel}${R}` : `${label} ${notInPlanLabel}`;
+  }
   const pct = remainingPct(percent, remaining, total);
   const bar = renderBar(pct, color, COMPACT_BAR_WIDTH, total <= 0);
   if (total > 0) {
@@ -138,13 +148,17 @@ export function renderQuotaTable(models: QuotaModelRemain[], config: Config): vo
       m.current_interval_total_count,
       m.current_interval_remaining_percent,
       useColor,
+      m.current_interval_status,
+      L.notInPlan,
     );
     const weekly = renderMetric(
       L.weekly,
       m.current_weekly_usage_count,
       m.current_weekly_total_count,
       m.current_weekly_remaining_percent,
       useColor,
+      m.current_weekly_status,
+      L.notInPlan,
     );
     const reset = `${L.resetsIn} ${formatDuration(m.remains_time, L.now)}`;
     return { displayName, current, weekly, reset };

test/errors/api.test.ts

@@ -43,4 +43,17 @@ describe('mapApiError', () => {
     const err = mapApiError(500, { base_resp: { status_code: 0, status_msg: 'something broke' } });
     expect(err.message).toContain('something broke');
   });
+
+  it('maps MiniMax usage-limit code 2056 to QUOTA with upgrade hint', () => {
+    // issue #173: mmx video generate rejected with 2056 / (0/0 used)
+    const err = mapApiError(
+      400,
+      { base_resp: { status_code: 2056, status_msg: 'weekly usage limit reached (0/0 used)' } },
+      'https://api.minimaxi.com/v1/video_generation',
+    );
+    expect(err.exitCode).toBe(ExitCode.QUOTA);
+    expect(err.message).toContain('0/0 used');
+    expect(err.hint).toContain('quota show');
+    expect(err.hint).toContain('Upgrade plan');
+  });
 });

test/output/quota-table.test.ts

@@ -200,4 +200,35 @@ describe('renderQuotaTable', () => {
     expect(output).toContain('通用');
     expect(output).not.toContain('×2');
   });
+
+  it('renders "not in plan" for status=3 rows instead of a misleading 100%', () => {
+    // issue #173: a plan without video. The server marks the unavailable row
+    // status=3 (counts 0/0, percent 100); the in-plan general row stays status=1.
+    const base = createCodingPlanModels();
+    const models: QuotaModelRemain[] = [
+      { ...base[0]!, current_interval_status: 1, current_weekly_status: 1 },
+      { ...base[1]!, current_interval_status: 3, current_weekly_status: 3 },
+    ];
+
+    const lines: string[] = [];
+    const originalLog = console.log;
+    console.log = (message?: unknown) => {
+      lines.push(String(message ?? ''));
+    };
+    try {
+      renderQuotaTable(models, { ...createConfig(), region: 'cn', noColor: true });
+    } finally {
+      console.log = originalLog;
+    }
+
+    // video (status=3) says "not in plan"; its percent/bar must not leak through
+    const videoLine = lines.find((l) => l.includes('视频')) ?? '';
+    expect(videoLine).toContain('不在当前套餐中');
+    expect(videoLine).not.toContain('100%');
+    expect(videoLine).not.toContain('[');
+    // the in-plan general row (status=1) still renders its bar
+    const generalLine = lines.find((l) => l.includes('通用')) ?? '';
+    expect(generalLine).not.toContain('不在当前套餐中');
+    expect(generalLine).toContain('[');
+  });
 });