@genee/omp-opsx-addon 0.3.0 → 0.5.0

package/lib/usage-render.ts

@@ -1,20 +1,27 @@
-import { visibleWidth, truncateToWidth } from "@oh-my-pi/pi-tui";
-import { resolveUsedFraction, getProviderDefinition, type UsageLimit, type UsageReport } from "@oh-my-pi/pi-ai";
-import { summarizeReport, quotaPolicyFor } from "./usage-resolver.js";
+import { visibleWidth, truncateToWidth } from '@oh-my-pi/pi-tui';
+import { resolveUsedFraction, getProviderDefinition, type UsageLimit, type UsageReport } from '@oh-my-pi/pi-ai';
+import { summarizeReport, quotaPolicyFor } from './usage-resolver.js';
 
 // Hardcoded ANSI retained for `ansiPainter` — the RPC/print fallback path and
 // the legacy `render.test.ts` baseline. The interactive component-factory path
 // swaps them for the host theme via `themePainter(theme)`.
-const R = "\x1b[0m", G = "\x1b[32m", Y = "\x1b[33m", X = "\x1b[31m", D = "\x1b[2m";
-const BLUE = "\x1b[34m", PURPLE = "\x1b[35m", CYAN = "\x1b[36m", WHITE = "\x1b[37m";
-const BOLD = "\x1b[1m";
+const R = '\x1b[0m',
+    G = '\x1b[32m',
+    Y = '\x1b[33m',
+    X = '\x1b[31m',
+    D = '\x1b[2m';
+const BLUE = '\x1b[34m',
+    PURPLE = '\x1b[35m',
+    CYAN = '\x1b[36m',
+    WHITE = '\x1b[37m';
+const BOLD = '\x1b[1m';
 const c = (s: string, t: string): string => `${s}${t}${R}`;
 
 // The subset of the host `ThemeColor` union the widget actually paints with.
 // Keeping it narrow lets widget tests inject a mock theme that only implements
 // `fg` instead of the full `Theme` surface (the host passes a real `Theme`,
 // which is structurally assignable thanks to `PainterColor ⊆ ThemeColor`).
-export type PainterColor = "success" | "warning" | "error" | "dim" | "accent" | "text";
+export type PainterColor = 'success' | 'warning' | 'error' | 'dim' | 'accent' | 'text';
 
 /** Minimal theme surface the rendering painter consumes (`host Theme.fg`). */
 export interface PainterTheme {
@@ -46,29 +53,43 @@ export interface Painter {
 }
 
 const pctValue = (p: number): string => `${Math.round(p * 100)}%`;
-const pctColor = (p: number): PainterColor => (p >= 0.85 ? "error" : p >= 0.6 ? "warning" : "success");
+const pctColor = (p: number): PainterColor => (p >= 0.85 ? 'error' : p >= 0.6 ? 'warning' : 'success');
 
 /** Pre-refactor hardcoded ANSI — the RPC/print fallback and the test baseline. */
 export const ansiPainter: Painter = {
     pct: (p) => {
         const col = pctColor(p);
-        return c(col === "error" ? X : col === "warning" ? Y : G, pctValue(p));
+        return c(col === 'error' ? X : col === 'warning' ? Y : G, pctValue(p));
     },
     exhausted: (text) => c(X, text),
     sep: ` ${D}│${R} `,
     header: (label, brandAnsi) => c(brandAnsi ? BOLD + brandAnsi : BOLD, label),
     balance: (text) => c(WHITE, text),
-    fg: (color, text) => c(color === "error" ? X : color === "warning" ? Y : color === "success" ? G : color === "dim" ? D : color === "accent" ? CYAN : WHITE, text),
+    fg: (color, text) =>
+        c(
+            color === 'error'
+                ? X
+                : color === 'warning'
+                  ? Y
+                  : color === 'success'
+                    ? G
+                    : color === 'dim'
+                      ? D
+                      : color === 'accent'
+                        ? CYAN
+                        : WHITE,
+            text,
+        ),
 };
 
 /** Status colors via the active host theme; brand headers keep raw ANSI. */
 export function themePainter(theme: PainterTheme): Painter {
     return {
         pct: (p) => theme.fg(pctColor(p), pctValue(p)),
-        exhausted: (text) => theme.fg("error", text),
-        sep: ` ${theme.fg("dim", "│")} `,
-        header: (label, brandAnsi) => (brandAnsi ? c(brandAnsi, label) : theme.fg("accent", label)),
-        balance: (text) => theme.fg("text", text),
+        exhausted: (text) => theme.fg('error', text),
+        sep: ` ${theme.fg('dim', '│')} `,
+        header: (label, brandAnsi) => (brandAnsi ? c(brandAnsi, label) : theme.fg('accent', label)),
+        balance: (text) => theme.fg('text', text),
         fg: (color, text) => theme.fg(color, text),
     };
 }
@@ -77,34 +98,43 @@ export function themePainter(theme: PainterTheme): Painter {
 // verbose for a compact status widget (e.g. "Z.AI (GLM Coding Plan · Sign in)").
 // Unknown providers fall back to the omp registry display name, then the raw id.
 const PROVIDER: Record<string, { label: string; color: string }> = {
-    "zhipu-coding-plan": { label: "智谱",    color: PURPLE },
-    zai:                 { label: "智谱",    color: PURPLE },
-    "kimi-code":         { label: "Kimi",    color: CYAN },
-    "minimax-code-cn":   { label: "MiniMax", color: X },
-    deepseek:            { label: "DeepSeek",color: BLUE },
-    cursor:              { label: "Cursor",  color: CYAN },
-    "opencode-go":       { label: "OpenCode",color: G },
-    moonshot:            { label: "Moonshot",color: G },
+    'zhipu-coding-plan': { label: '智谱', color: PURPLE },
+    zai: { label: '智谱', color: PURPLE },
+    'kimi-code': { label: 'Kimi', color: CYAN },
+    'minimax-code-cn': { label: 'MiniMax', color: X },
+    'ark-coding-plan': { label: '火山方舟', color: CYAN },
+    deepseek: { label: 'DeepSeek', color: BLUE },
+    cursor: { label: 'Cursor', color: CYAN },
+    'opencode-go': { label: 'OpenCode', color: G },
+    moonshot: { label: 'Moonshot', color: G },
 };
 
 const providerLabel = (id: string): { label: string; color: string } => {
     const known = PROVIDER[id];
     if (known) return known;
     const reg = getProviderDefinition(id);
-    if (reg?.name) return { label: reg.name, color: "" };
-    return { label: id, color: "" };
+    if (reg?.name) return { label: reg.name, color: '' };
+    return { label: id, color: '' };
 };
 
-const WL: Record<string, string> = { "5h": "5h", "rolling-5h": "5h", "1d": "日", "1w": "周", weekly: "周", "1mo": "月", monthly: "月" };
+const WL: Record<string, string> = {
+    '5h': '5h',
+    'rolling-5h': '5h',
+    '1d': '日',
+    '1w': '周',
+    weekly: '周',
+    '1mo': '月',
+    monthly: '月',
+};
 
 // ── helpers ──────────────────────────────────────────────────────────
 
-const pad2 = (n: number): string => String(n).padStart(2, "0");
+const pad2 = (n: number): string => String(n).padStart(2, '0');
 
 /** Fixed-width reset countdown, e.g. "00d03h12m05s"; "即将重置" once elapsed. */
 const resetIn = (resetsAt: number): string => {
     const diffMs = resetsAt - Date.now();
-    if (diffMs <= 0) return "即将重置";
+    if (diffMs <= 0) return '即将重置';
     const totalSec = Math.floor(diffMs / 1_000);
     const d = Math.floor(totalSec / 86_400);
     const h = Math.floor((totalSec % 86_400) / 3_600);
@@ -114,9 +144,9 @@ const resetIn = (resetsAt: number): string => {
 };
 
 function isQuotaFull(l: UsageLimit): boolean {
-    if (l.status === "exhausted") return true;
+    if (l.status === 'exhausted') return true;
     const pct = resolveUsedFraction(l);
-    return typeof pct === "number" && pct >= 1;
+    return typeof pct === 'number' && pct >= 1;
 }
 
 function resetAtOf(l: UsageLimit, report?: UsageReport): number | undefined {
@@ -127,7 +157,7 @@ function resetAtOf(l: UsageLimit, report?: UsageReport): number | undefined {
 /** Exhausted / 100% text (uncolored); the painter wraps it in the error color. */
 const exhaustedText = (l: UsageLimit, report?: UsageReport): string => {
     const at = resetAtOf(l, report);
-    return at !== undefined ? resetIn(at) : "耗尽";
+    return at !== undefined ? resetIn(at) : '耗尽';
 };
 
 /** Recovery countdown when the provider is unusable.
@@ -137,7 +167,7 @@ const exhaustedText = (l: UsageLimit, report?: UsageReport): string => {
  *  Falls back to any sibling resetsAt / `耗尽` when no exhausted window has one.
  */
 const providerExhaustedText = (report: UsageReport): string => {
-    const preferLatest = quotaPolicyFor(report.provider) !== "bucket";
+    const preferLatest = quotaPolicyFor(report.provider) !== 'bucket';
     const pick = (a: number, b: number): number => (preferLatest ? Math.max(a, b) : Math.min(a, b));
 
     let chosen: number | undefined;
@@ -146,24 +176,33 @@ const providerExhaustedText = (report: UsageReport): string => {
     for (const l of report.limits) {
         if (!isQuotaFull(l)) continue;
         const at = l.window?.resetsAt;
-        if (typeof at !== "number") continue;
+        if (typeof at !== 'number') continue;
         chosen = chosen === undefined ? at : pick(chosen, at);
     }
     if (chosen === undefined) {
         for (const l of report.limits) {
             const at = l.window?.resetsAt;
-            if (typeof at !== "number") continue;
+            if (typeof at !== 'number') continue;
             chosen = chosen === undefined ? at : pick(chosen, at);
         }
     }
-    return chosen !== undefined ? resetIn(chosen) : "耗尽";
+    return chosen !== undefined ? resetIn(chosen) : '耗尽';
 };
 
 const cursorWinLabel = (l: UsageLimit): string | undefined => {
-    const hay = `${l.id ?? ""} ${l.label ?? ""} ${l.window?.id ?? ""}`.toLowerCase();
-    if (hay.includes("ondemand") || hay.includes("on-demand") || hay.includes("spendlimit") || hay.includes("按需")) return "按需";
-    if (hay.includes("builtin") || hay.includes("cursor models") || hay.includes("planusage") || hay.includes("autopercent") || hay.includes("内置")) return "内置";
-    if (hay.includes("other") || hay.includes("named") || hay.includes("apipercent") || hay.includes("其他")) return "其他";
+    const hay = `${l.id ?? ''} ${l.label ?? ''} ${l.window?.id ?? ''}`.toLowerCase();
+    if (hay.includes('ondemand') || hay.includes('on-demand') || hay.includes('spendlimit') || hay.includes('按需'))
+        return '按需';
+    if (
+        hay.includes('builtin') ||
+        hay.includes('cursor models') ||
+        hay.includes('planusage') ||
+        hay.includes('autopercent') ||
+        hay.includes('内置')
+    )
+        return '内置';
+    if (hay.includes('other') || hay.includes('named') || hay.includes('apipercent') || hay.includes('其他'))
+        return '其他';
     return undefined;
 };
 
@@ -171,36 +210,36 @@ const winLabel = (l: UsageLimit): string => {
     const cursor = cursorWinLabel(l);
     if (cursor) return cursor;
     const w = l.window;
-    if (!w) return l.label || "?";
+    if (!w) return l.label || '?';
     if (WL[w.id]) return WL[w.id];
-    if (w.durationMs === 18_000_000) return "5h";
-    if (w.durationMs === 86_400_000) return "日";
-    if (w.durationMs === 604_800_000) return "周";
-    if (w.durationMs === 2_592_000_000) return "月";
-    if (w.id === "default") return l.label === "Total quota" ? "总" : l.label;
+    if (w.durationMs === 18_000_000) return '5h';
+    if (w.durationMs === 86_400_000) return '日';
+    if (w.durationMs === 604_800_000) return '周';
+    if (w.durationMs === 2_592_000_000) return '月';
+    if (w.id === 'default') return l.label === 'Total quota' ? '总' : l.label;
     return w.label || w.id;
 };
 
 const windowSortKey = (l: UsageLimit): number => {
     const cursor = cursorWinLabel(l);
-    if (cursor === "内置") return 4;
-    if (cursor === "其他") return 5;
-    if (cursor === "按需") return 7;
+    if (cursor === '内置') return 4;
+    if (cursor === '其他') return 5;
+    if (cursor === '按需') return 7;
     const w = l.window;
     if (!w) return 50;
-    if (w.id === "5h") return 0;
-    if (w.id === "1d") return 1;
-    if (w.id === "1w") return 2;
-    if (w.id === "1mo") return 3;
+    if (w.id === '5h') return 0;
+    if (w.id === '1d') return 1;
+    if (w.id === '1w') return 2;
+    if (w.id === '1mo') return 3;
     // Cursor dashboard order: Cursor Models（内置）→ Other Models（其他）→ On-demand（按需）.
-    if (w.id === "builtin" || w.id === "auto") return 4;
-    if (w.id === "other" || w.id === "api") return 5;
-    if (w.id === "ondemand") return 7;
+    if (w.id === 'builtin' || w.id === 'auto') return 4;
+    if (w.id === 'other' || w.id === 'api') return 5;
+    if (w.id === 'ondemand') return 7;
     if (w.durationMs === 18_000_000) return 0;
     if (w.durationMs === 86_400_000) return 1;
     if (w.durationMs === 604_800_000) return 2;
     if (w.durationMs === 2_592_000_000) return 3;
-    if (w.id === "default" || l.label === "Total quota") return 100;
+    if (w.id === 'default' || l.label === 'Total quota') return 100;
     return 50;
 };
 
@@ -208,7 +247,7 @@ const windowSortKey = (l: UsageLimit): number => {
 const padRight = (s: string, width: number): string => {
     const v = visibleWidth(s);
     if (v >= width) return s;
-    return s + " ".repeat(width - v);
+    return s + ' '.repeat(width - v);
 };
 
 // ── column builder ───────────────────────────────────────────────────
@@ -243,13 +282,13 @@ export const buildColumn = (r: UsageReport, painter: Painter = ansiPainter, load
         let val: string;
         if (health.exhausted || isQuotaFull(l)) {
             val = painter.exhausted(exhaustedText(l, r));
-        } else if (typeof l.amount.remaining === "number") {
-            const sym = (l.amount.unit as string) === "CNY" ? "¥" : "$";
-            const text = r.provider === "deepseek" ? `余额 ${sym}${l.amount.remaining}` : `${sym}${l.amount.remaining}`;
+        } else if (typeof l.amount.remaining === 'number') {
+            const sym = (l.amount.unit as string) === 'CNY' ? '¥' : '$';
+            const text = r.provider === 'deepseek' ? `余额 ${sym}${l.amount.remaining}` : `${sym}${l.amount.remaining}`;
             val = painter.balance(text);
         } else {
             const pct = resolveUsedFraction(l);
-            val = typeof pct === "number" ? painter.pct(pct) : "?";
+            val = typeof pct === 'number' ? painter.pct(pct) : '?';
         }
         return [header, val];
     }
@@ -266,26 +305,26 @@ export const buildColumn = (r: UsageReport, painter: Painter = ansiPainter, load
     // are noise and are hidden.
     const sorted = [...r.limits].sort((a, b) => windowSortKey(a) - windowSortKey(b));
     const parts: string[] = [];
-    const isCursor = r.provider === "cursor";
+    const isCursor = r.provider === 'cursor';
     for (const l of sorted) {
         if (isCursor && !cursorWinLabel(l)) continue;
         const wl = winLabel(l);
         let val: string;
         if (isQuotaFull(l)) {
             const pct = resolveUsedFraction(l);
-            val = typeof pct === "number" ? painter.pct(Math.min(pct, 1)) : painter.exhausted("耗尽");
+            val = typeof pct === 'number' ? painter.pct(Math.min(pct, 1)) : painter.exhausted('耗尽');
         } else {
             const pct = resolveUsedFraction(l);
-            val = typeof pct === "number" ? painter.pct(pct) : "?";
+            val = typeof pct === 'number' ? painter.pct(pct) : '?';
         }
         parts.push(`${wl} ${val}`);
     }
     if (parts.length === 0) {
         // e.g. Cursor only returned unclassified monthly leftovers — keep the
         // column visible rather than dropping a logged-in provider.
-        return isCursor ? [header, painter.balance("—")] : undefined;
+        return isCursor ? [header, painter.balance('—')] : undefined;
     }
-    return [header, parts.join(" · ")];
+    return [header, parts.join(' · ')];
 };
 
 /**
@@ -296,8 +335,8 @@ export const buildColumn = (r: UsageReport, painter: Painter = ansiPainter, load
  */
 export const buildEmptyReportColumn = (provider: string, painter: Painter = ansiPainter, loading = false): string[] => {
     const { label, color } = providerLabel(provider);
-    return [painter.header(loading ? `${label}⟳` : label, color), painter.balance(loading ? "⟳" : "—")];
-}
+    return [painter.header(loading ? `${label}⟳` : label, color), painter.balance(loading ? '⟳' : '—')];
+};
 
 /**
  * Render a logged-in provider that has no report yet as a header + a single
@@ -307,20 +346,24 @@ export const buildEmptyReportColumn = (provider: string, painter: Painter = ansi
  * windows is not mistaken for a logged-in-but-unfetched provider. `exhausted`
  * reflects the process-local 429/403 signal (see `lib/provider-status.ts`).
  */
-export const buildPlaceholderColumn = (provider: string, painter: Painter = ansiPainter, loading = false, exhausted = false): string[] => {
+export const buildPlaceholderColumn = (
+    provider: string,
+    painter: Painter = ansiPainter,
+    loading = false,
+    exhausted = false,
+): string[] => {
     const { label, color } = providerLabel(provider);
-    const body = loading ? "⟳" : exhausted ? "耗尽" : "可用";
+    const body = loading ? '⟳' : exhausted ? '耗尽' : '可用';
     return [
         painter.header(loading ? `${label}⟳` : label, color),
         exhausted ? painter.exhausted(body) : painter.balance(body),
     ];
-}
+};
 
 // ── flex-wrap table layout ───────────────────────────────────────────
 
 const SEP_VISUAL = 3;
 
-
 export function renderUsageReports(
     reports: UsageReport[],
     maxWidth = 120,
@@ -342,11 +385,15 @@ export function renderUsageReports(
     // Build each provider column (header + usage / placeholder). Waveforms are
     // appended AFTER the uniform block width is known so every provider's
     // mini chart is the same width.
-    interface ProviderColumn { provider: string; col: string[] }
+    interface ProviderColumn {
+        provider: string;
+        col: string[];
+    }
     const cols: ProviderColumn[] = (reports ?? []).map((r) => {
-        const col = r.limits.length === 0
-            ? buildEmptyReportColumn(r.provider, painter, loading.has(r.provider))
-            : buildColumn(r, painter, loading.has(r.provider));
+        const col =
+            r.limits.length === 0
+                ? buildEmptyReportColumn(r.provider, painter, loading.has(r.provider))
+                : buildColumn(r, painter, loading.has(r.provider));
         if (!col) return { provider: r.provider, col: [] };
         // Second-level estimate override replaces the usage line (balance style).
         const est = usageEstimates?.get(r.provider);
@@ -354,7 +401,10 @@ export function renderUsageReports(
         return { provider: r.provider, col };
     });
     for (const id of placeholders) {
-        cols.push({ provider: id, col: buildPlaceholderColumn(id, painter, loading.has(id), exhaustedProviders?.has(id)) });
+        cols.push({
+            provider: id,
+            col: buildPlaceholderColumn(id, painter, loading.has(id), exhaustedProviders?.has(id)),
+        });
     }
     const valid = cols.filter((c) => c.col.length > 0);
     if (valid.length === 0) return [];
@@ -386,7 +436,7 @@ export function renderUsageReports(
     const out: string[] = [];
     for (let line = 0; line < n; line++) {
         const cells = valid.map((c) => {
-            const t = line < c.col.length ? c.col[line] : "";
+            const t = line < c.col.length ? c.col[line] : '';
             return pad ? padRight(t, blockWidth) : t;
         });
         out.push(cells.join(painter.sep));
@@ -406,24 +456,24 @@ export function braillePixelHeight(consumption: number): number {
 
 /** Single-column dot bitmask for `rows` pixels lit from the bottom (0..4). */
 const LEFT_DOTS = [0x00, 0x40, 0x44, 0x46, 0x47];
-const RIGHT_DOTS = [0x00, 0x80, 0xA0, 0xB0, 0xB8];
+const RIGHT_DOTS = [0x00, 0x80, 0xa0, 0xb0, 0xb8];
 
-export function sideDots(rows: number, side: "left" | "right"): number {
+export function sideDots(rows: number, side: 'left' | 'right'): number {
     const r = Math.max(0, Math.min(4, rows));
-    return side === "left" ? LEFT_DOTS[r] : RIGHT_DOTS[r];
+    return side === 'left' ? LEFT_DOTS[r] : RIGHT_DOTS[r];
 }
 
 /** Compose a Braille cell (U+2800 | left | right) from two column heights. */
 export function composeChar(leftRows: number, rightRows: number): string {
-    const code = 0x2800 | sideDots(leftRows, "left") | sideDots(rightRows, "right");
+    const code = 0x2800 | sideDots(leftRows, 'left') | sideDots(rightRows, 'right');
     return String.fromCharCode(code);
 }
 
 /** Named-color band for a stock consumption level (`1 - remaining`): remaining ≥ 50% → success, ≥ 20% → warning, else error. */
 export function consumptionColor(c: number): PainterColor {
-    if (c <= 0.5) return "success";
-    if (c <= 0.8) return "warning";
-    return "error";
+    if (c <= 0.5) return 'success';
+    if (c <= 0.8) return 'warning';
+    return 'error';
 }
 
 /** One provider's consumption track feeding its embedded mini chart. */
@@ -482,15 +532,16 @@ export function renderConsumptionLines(
     // through the line. Skipped while the window is still filling or too
     // short (≥8 samples) — the live right edge keeps its exact per-second
     // shape during warm-up.
-    const plot = m >= totalPx && m >= 8
-        ? (() => {
-            const s = new Array<number>(m);
-            s[0] = (win[0] + win[1]) / 2;
-            for (let i = 1; i < m - 1; i++) s[i] = (win[i - 1] + 2 * win[i] + win[i + 1]) / 4;
-            s[m - 1] = (win[m - 2] + win[m - 1]) / 2;
-            return s;
-        })()
-        : [...win];
+    const plot =
+        m >= totalPx && m >= 8
+            ? (() => {
+                  const s = new Array<number>(m);
+                  s[0] = (win[0] + win[1]) / 2;
+                  for (let i = 1; i < m - 1; i++) s[i] = (win[i - 1] + 2 * win[i] + win[i + 1]) / 4;
+                  s[m - 1] = (win[m - 2] + win[m - 1]) / 2;
+                  return s;
+              })()
+            : [...win];
     // Dynamic scale over the SMOOTHED window keeps "largest increment = full
     // bar" after averaging trims the raw peak.
     const max = Math.max(...plot);
@@ -522,7 +573,7 @@ export function renderConsumptionLines(
     // half-column keeps its OWN interpolated height; only COLOR is blended
     // (terminals can't half-tint a char, so the char takes the mean intensity).
     const rows = 2;
-    const lines = new Array<string>(rows).fill("");
+    const lines = new Array<string>(rows).fill('');
     for (let c = 0; c < cols; c++) {
         const l = intensityAt(2 * c);
         const r = intensityAt(2 * c + 1);
@@ -531,9 +582,12 @@ export function renderConsumptionLines(
             for (let li = 0; li < rows; li++) lines[li] += blank;
             continue;
         }
-        const hL = Math.round(8 * l);
-        const hR = Math.round(8 * r);
-        const color = c === accentChar ? "accent" : consumptionColor((l + r) / 2);
+        // Minimum visible dot: any non-zero consumption keeps ≥1px no matter
+        // how small its ratio to the window max — a low-rate second must
+        // never vanish under the dynamic scale.
+        const hL = l > 0 ? Math.max(1, Math.round(8 * l)) : 0;
+        const hR = r > 0 ? Math.max(1, Math.round(8 * r)) : 0;
+        const color = c === accentChar ? 'accent' : consumptionColor((l + r) / 2);
         // Row 0 = top (px 4..8), row 1 = bottom (px 0..4) of each column.
         lines[0] += painter.fg(color, composeChar(Math.max(0, hL - 4), Math.max(0, hR - 4)));
         lines[1] += painter.fg(color, composeChar(Math.min(4, hL), Math.min(4, hR)));

package/lib/usage-resolver.ts

@@ -35,11 +35,17 @@ export interface DirectFetcher {
 }
 
 /**
- * Provider id aliases (currently empty). All fetchers and reports use the same
- * provider id as the auth/model registry (e.g. `zhipu-coding-plan`,
- * `minimax-code-cn`), so no canonicalization is needed.
+ * Provider id aliases — a PERMANENT legacy migration mapping (not a temporary
+ * patch): the old `omp-ark-coding-plan` npm package wrote `arkcodingplan`
+ * (lowercase form of the mixed-case `ArkCodingPlan`), while the runtime
+ * canonical id is `ark-coding-plan`. Kept indefinitely so any historical
+ * on-disk data — and anything the old package writes again — normalizes onto
+ * the canonical id. `canonicalizeProvider` lowercases first, so all three
+ * spellings land on `arkcodingplan` before the alias applies.
  */
-const PROVIDER_ALIAS: Record<string, string> = {};
+const PROVIDER_ALIAS: Record<string, string> = {
+    arkcodingplan: 'ark-coding-plan',
+};
 
 /**
  * Normalize a provider id to its canonical form: lowercase first, then alias

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genee/omp-opsx-addon",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Pi Extension: OpenSpec workflow orchestration - coder/reviewer/planner agents, session title & progress",
   "main": "./index.ts",