@moneysiren/cli 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/packages/view-model/src/hud-model.js

@@ -0,0 +1,295 @@
+import { summarizeAggregateSync, syncViewFromFreshness, } from "./sync-state.js";
+import { usageProgressFromTokens, usageProgressFromUsedPercent, usageProgressSeverity, } from "./usage-progress.js";
+export const CODEX_APP_PROVIDER_KEY = "codex-app";
+export const CODEX_CLI_PROVIDER_KEY = "codex-cli";
+const CODEX_PROVIDER_KEYS = [CODEX_APP_PROVIDER_KEY, CODEX_CLI_PROVIDER_KEY];
+const CREDIT_WARNING_MS = 7 * 24 * 60 * 60 * 1000;
+const CREDIT_CRITICAL_MS = 24 * 60 * 60 * 1000;
+export function buildHudViewModel(todayLive) {
+    const items = todayLive.providers.flatMap((provider) => hudItemsForProvider(provider, todayLive.generatedAt));
+    const sync = summarizeAggregateSync(items.map((item) => item.sync));
+    const warningCount = items.filter((item) => item.riskSeverity === "warning").length;
+    const criticalCount = items.filter((item) => item.riskSeverity === "critical").length;
+    return {
+        generatedAt: todayLive.generatedAt,
+        localOnly: true,
+        secretsReturned: false,
+        dataRevision: dataRevisionFor(todayLive),
+        sync,
+        risk: {
+            severity: criticalCount > 0 ? "critical" : warningCount > 0 ? "warning" : "info",
+            warningCount,
+            criticalCount,
+        },
+        items,
+    };
+}
+export function filterHudViewModelByWidgets(model, selectedWidgets) {
+    const itemsByWidget = new Map();
+    for (const item of model.items) {
+        for (const widgetKey of hudWidgetKeysForItem(item)) {
+            itemsByWidget.set(widgetKey, [...(itemsByWidget.get(widgetKey) ?? []), item]);
+        }
+    }
+    const items = selectedWidgets.flatMap((widgetKey) => itemsByWidget.get(widgetKey) ?? []);
+    const sync = summarizeAggregateSync(items.map((item) => item.sync));
+    const warningCount = items.filter((item) => item.riskSeverity === "warning").length;
+    const criticalCount = items.filter((item) => item.riskSeverity === "critical").length;
+    return {
+        ...model,
+        dataRevision: `${model.dataRevision}#widgets:${selectedWidgets.join(",")}`,
+        sync,
+        risk: {
+            severity: criticalCount > 0 ? "critical" : warningCount > 0 ? "warning" : "info",
+            warningCount,
+            criticalCount,
+        },
+        items,
+    };
+}
+export function buildCreditPoolFromProvider(provider, generatedAt) {
+    return buildCreditPoolsFromProvider(provider, generatedAt)[0] ?? null;
+}
+export function buildCreditPoolsFromProvider(provider, generatedAt) {
+    if (!isCodexProviderKey(provider.providerKey)) {
+        return [];
+    }
+    const metrics = provider.metrics;
+    const explicitCount = firstMetric(metrics, "usage_reset_credits")?.value ?? null;
+    const exactMetrics = metrics.filter((metric) => metric.key === "usage_reset_credit");
+    const estimatedMetrics = metrics.filter((metric) => metric.key === "usage_reset_credit_estimate");
+    const selectedMetrics = exactMetrics.length > 0 ? exactMetrics : estimatedMetrics;
+    const credits = selectedMetrics
+        .map((metric, index) => creditItemFromMetric(metric, index, generatedAt))
+        .sort(compareCreditItems);
+    const activeCreditCount = credits.filter((credit) => credit.status !== "expired").length;
+    const availableCount = normalizeCount(explicitCount) ?? activeCreditCount;
+    const unresolvedCount = Math.max(0, availableCount - credits.length);
+    if (availableCount === 0 && credits.length === 0) {
+        return [];
+    }
+    const nearestExpiryAt = credits
+        .map((credit) => credit.expiresAt ?? credit.estimatedEarliestAt)
+        .filter((value) => value !== null)
+        .sort((left, right) => Date.parse(left) - Date.parse(right))[0] ?? null;
+    const accuracy = summarizeCreditAccuracy(credits, selectedMetrics.length > 0 ? selectedMetrics : metrics);
+    const sync = syncViewForProvider(provider, generatedAt);
+    const invalidKnownCount = explicitCount !== null && activeCreditCount > explicitCount;
+    const basePool = {
+        kind: "credit_pool",
+        providerKey: provider.providerKey,
+        availableCount,
+        totalEarnedCount: firstMetric(metrics, "usage_reset_credit_total_earned")?.value ?? null,
+        credits,
+        unresolvedCount,
+        nearestExpiryAt,
+        accuracy,
+        sync: invalidKnownCount
+            ? {
+                ...sync,
+                state: "error",
+                error: {
+                    code: "invalid_data",
+                    retryable: false,
+                    userActionRequired: false,
+                    message: "Reset credit count is lower than the known active credit list.",
+                },
+                lastRefreshFailed: true,
+            }
+            : sync,
+        riskSeverity: riskFromNearestExpiry(nearestExpiryAt, generatedAt),
+        target: {
+            type: "service",
+            providerKey: provider.providerKey,
+        },
+    };
+    return [
+        {
+            ...basePool,
+            id: `${provider.providerKey}:credit-pool:count`,
+            variant: "count",
+        },
+        {
+            ...basePool,
+            id: `${provider.providerKey}:credit-pool:expiry`,
+            variant: "expiry",
+        },
+    ];
+}
+function hudItemsForProvider(provider, generatedAt) {
+    const quotaItems = [
+        quotaItemForProvider(provider, generatedAt, "five_hour", "five_hour_limit_percent", "five_hour_tokens", "five_hour_remaining_tokens"),
+        quotaItemForProvider(provider, generatedAt, "weekly", "weekly_limit_percent", "weekly_tokens", "weekly_remaining_tokens"),
+        quotaItemForProvider(provider, generatedAt, "context", "context_percent", "context_tokens", null),
+    ].filter((item) => item !== null);
+    const creditPools = buildCreditPoolsFromProvider(provider, generatedAt);
+    return [...quotaItems, ...creditPools];
+}
+function quotaItemForProvider(provider, generatedAt, window, percentMetricKey, usedTokensMetricKey, remainingTokensMetricKey) {
+    const usedPercentMetric = firstMetric(provider.metrics, percentMetricKey);
+    const usedTokensMetric = firstMetric(provider.metrics, usedTokensMetricKey);
+    const remainingTokensMetric = remainingTokensMetricKey === null ? undefined : firstMetric(provider.metrics, remainingTokensMetricKey);
+    const progress = usedPercentMetric === undefined
+        ? remainingTokensMetric === undefined
+            ? null
+            : usageProgressFromTokens(usedTokensMetric?.value ?? null, remainingTokensMetric.value)
+        : usageProgressFromUsedPercent(usedPercentMetric.value);
+    if (progress === null || progress.usedPercent === null) {
+        return null;
+    }
+    const resetAt = remainingTokensMetric?.resetAt ?? usedPercentMetric?.resetAt ?? null;
+    const riskSeverity = usageProgressSeverity(progress);
+    return {
+        kind: "quota",
+        id: `${provider.providerKey}:${window}`,
+        providerKey: provider.providerKey,
+        window,
+        progress,
+        resetAt,
+        sync: syncViewForProvider(provider, generatedAt),
+        riskSeverity,
+        target: {
+            type: "service",
+            providerKey: provider.providerKey,
+        },
+    };
+}
+function hudWidgetKeysForItem(item) {
+    if (item.kind === "credit_pool") {
+        return item.variant === "count"
+            ? ["codex_reset_credit_count"]
+            : ["codex_reset_credit_expiry"];
+    }
+    if (item.window === "five_hour") {
+        if (item.providerKey.startsWith("codex-")) {
+            return ["codex_five_hour_percent"];
+        }
+        if (item.providerKey.startsWith("claude-")) {
+            return ["claude_five_hour_percent"];
+        }
+    }
+    if (item.window === "weekly") {
+        if (item.providerKey.startsWith("codex-")) {
+            return ["codex_weekly_percent"];
+        }
+        if (item.providerKey.startsWith("claude-")) {
+            return ["claude_weekly_percent"];
+        }
+    }
+    return [];
+}
+function creditItemFromMetric(metric, index, generatedAt) {
+    const accuracy = normalizeCreditAccuracy(metric.accuracy, metric.key);
+    const expiresAt = metric.key === "usage_reset_credit" ? metric.resetAt ?? null : null;
+    const estimatedEarliestAt = metric.key === "usage_reset_credit_estimate" ? metric.resetAt ?? null : null;
+    const estimatedLatestAt = metric.resetAtLatest ?? null;
+    const riskTime = expiresAt ?? estimatedEarliestAt;
+    return {
+        itemKey: metric.itemKey ?? `${metric.key}:${index + 1}`,
+        expiresAt,
+        estimatedEarliestAt,
+        estimatedLatestAt,
+        accuracy,
+        status: creditStatus(riskTime, generatedAt),
+    };
+}
+function syncViewForProvider(provider, generatedAt) {
+    return syncViewFromFreshness({
+        freshness: provider.freshness,
+        checkedAt: provider.checkedAt,
+        generatedAt,
+        source: provider.providerKey,
+        ...(provider.ttlSeconds === undefined ? {} : { ttlSeconds: provider.ttlSeconds }),
+        ...(provider.message === undefined ? {} : { message: provider.message }),
+        ...(provider.lastAttemptAt === undefined ? {} : { lastAttemptAt: provider.lastAttemptAt }),
+        ...(provider.lastSuccessAt === undefined ? {} : { lastSuccessAt: provider.lastSuccessAt }),
+        ...(provider.freshUntil === undefined ? {} : { freshUntil: provider.freshUntil }),
+        ...(provider.staleUntil === undefined ? {} : { staleUntil: provider.staleUntil }),
+        ...(provider.lastRefreshFailed === undefined ? {} : { lastRefreshFailed: provider.lastRefreshFailed }),
+    });
+}
+function riskFromNearestExpiry(value, generatedAt) {
+    if (value === null) {
+        return "info";
+    }
+    const remainingMs = Date.parse(value) - Date.parse(generatedAt);
+    if (!Number.isFinite(remainingMs) || remainingMs <= CREDIT_CRITICAL_MS) {
+        return "critical";
+    }
+    return remainingMs <= CREDIT_WARNING_MS ? "warning" : "info";
+}
+function creditStatus(expiresAt, generatedAt) {
+    if (expiresAt === null) {
+        return "unknown";
+    }
+    const remainingMs = Date.parse(expiresAt) - Date.parse(generatedAt);
+    if (!Number.isFinite(remainingMs)) {
+        return "unknown";
+    }
+    if (remainingMs <= 0) {
+        return "expired";
+    }
+    return remainingMs <= CREDIT_WARNING_MS ? "expiring_soon" : "active";
+}
+function firstMetric(metrics, key) {
+    return metrics.find((metric) => metric.key === key);
+}
+function normalizeCount(value) {
+    return value === null || !Number.isFinite(value) || value < 0 ? null : Math.floor(value);
+}
+function summarizeCreditAccuracy(credits, metrics) {
+    if (credits.length === 0 && metrics.length === 0) {
+        return "unknown";
+    }
+    if (credits.length > 0 && credits.every((credit) => credit.accuracy === "exact")) {
+        return "exact";
+    }
+    if (credits.some((credit) => credit.accuracy === "bounded")) {
+        return "bounded";
+    }
+    if (credits.some((credit) => credit.accuracy === "estimated")) {
+        return "estimated";
+    }
+    return "unknown";
+}
+function normalizeCreditAccuracy(value, key) {
+    if (value === "exact" || value === "estimated" || value === "bounded" || value === "unknown") {
+        return value;
+    }
+    return key === "usage_reset_credit"
+        ? "exact"
+        : key === "usage_reset_credit_estimate"
+            ? "bounded"
+            : "unknown";
+}
+function compareCreditItems(left, right) {
+    return compareNullableIso(left.expiresAt ?? left.estimatedEarliestAt, right.expiresAt ?? right.estimatedEarliestAt) ||
+        left.itemKey.localeCompare(right.itemKey);
+}
+function compareNullableIso(left, right) {
+    if (left === null && right === null) {
+        return 0;
+    }
+    if (left === null) {
+        return 1;
+    }
+    if (right === null) {
+        return -1;
+    }
+    return Date.parse(left) - Date.parse(right);
+}
+function dataRevisionFor(todayLive) {
+    return [
+        todayLive.generatedAt,
+        todayLive.providers.map((provider) => [
+            provider.providerKey,
+            provider.checkedAt ?? "",
+            provider.lastSuccessAt ?? "",
+            provider.revision ?? "",
+        ].join(":")).join("|"),
+    ].join("#");
+}
+function isCodexProviderKey(value) {
+    return CODEX_PROVIDER_KEYS.includes(value);
+}
+//# sourceMappingURL=hud-model.js.map

package/dist/packages/view-model/src/index.d.ts

@@ -1,3 +1,6 @@
-export { buildNotificationDigest, buildOperationsOverview, buildTodayLiveView, buildTrayMenuModel, readNotificationDigest, readOperationsOverview, readTodayLiveView, readTrayMenuModel, type LocalSafeEnvelope, type NotificationDigest, type NotificationDigestItem, type OperationsOverview, type OperationsOverviewAlert, type OperationsOverviewProvider, type ReadNotificationDigestOptions, type ReadOperationsOverviewOptions, type ReadTodayLiveViewOptions, type ReadTrayMenuModelOptions, type TodayLiveProviderInput, type TodayLiveProviderView, type TodayLiveView, type TrayMenuItem, type TrayMenuModel, type ViewModelAlertRecord, type ViewModelBillingSnapshotRecord, type ViewModelCostEstimateRecord, type ViewModelHealthStatus, type ViewModelProviderRecord, type ViewModelReadStore, type ViewModelRiskSeverity, type ViewModelServiceHealthSnapshotRecord, type ViewModelStore, type ViewModelUsageSnapshotRecord, } from "./view-model.js";
-export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, type DashboardDisplayPreferences, type DigestInterval, type LocalCliDashboardMetricKey, type NotificationPreferenceFileOptions, type NotificationPreferences, type NotificationThresholdRule, type NotificationWidgetKey, type ThresholdOperator, } from "./notification-preferences.js";
+export { buildNotificationDigest, buildOperationsOverview, buildTodayLiveView, buildTrayMenuModel, readNotificationDigest, readOperationsOverview, readTodayLiveView, readTrayMenuModel, type LocalSafeEnvelope, type NotificationDigest, type NotificationDigestItem, type OperationsOverview, type OperationsOverviewAlert, type OperationsOverviewProvider, type ReadNotificationDigestOptions, type ReadOperationsOverviewOptions, type ReadTodayLiveViewOptions, type ReadTrayMenuModelOptions, type TodayLiveProviderInput, type TodayLiveProviderView, type TodayLiveMetric, type TodayLiveView, type TrayMenuItem, type TrayMenuModel, type ViewModelAlertRecord, type ViewModelBillingSnapshotRecord, type ViewModelCostEstimateRecord, type ViewModelHealthStatus, type ViewModelProviderRecord, type ViewModelReadStore, type ViewModelRiskSeverity, type ViewModelServiceHealthSnapshotRecord, type ViewModelStore, type ViewModelUsageSnapshotRecord, } from "./view-model.js";
+export { CODEX_APP_PROVIDER_KEY, CODEX_CLI_PROVIDER_KEY, buildCreditPoolFromProvider, buildCreditPoolsFromProvider, buildHudViewModel, filterHudViewModelByWidgets, type CreditAccuracy, type CreditItemView, type CreditPoolView, type HudItemView, type HudViewModel, type QuotaItemView, } from "./hud-model.js";
+export { createSyncError, isNeutralSyncState, summarizeAggregateSync, syncStateFromFreshness, syncViewFromFreshness, type AggregateSyncStatus, type ItemSyncView, type RiskSeverity, type SyncErrorCode, type SyncErrorView, type SyncStateValue, } from "./sync-state.js";
+export { normalizePercent, usageProgressFromRemainingPercent, usageProgressFromTokens, usageProgressFromUsedPercent, usageProgressSeverity, type UsageProgressSeverity, type UsageProgressView, } from "./usage-progress.js";
+export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_DASHBOARD_WIDGET_LAYOUTS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, DASHBOARD_VIEW_KEYS, DASHBOARD_WIDGET_KEYS_BY_VIEW, DASHBOARD_WIDGET_SIZES, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, type DashboardBudgetPreferences, type DashboardDisplayPreferences, type DashboardViewKey, type DashboardWidgetKey, type DashboardWidgetLayoutItem, type DashboardWidgetLayoutPreferences, type DashboardWidgetSize, type DigestInterval, type LocalCliDashboardMetricKey, type NotificationPreferenceFileOptions, type NotificationPreferences, type NotificationThresholdRule, type NotificationWidgetKey, type ThresholdOperator, } from "./notification-preferences.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/view-model/src/index.js

@@ -1,3 +1,6 @@
 export { buildNotificationDigest, buildOperationsOverview, buildTodayLiveView, buildTrayMenuModel, readNotificationDigest, readOperationsOverview, readTodayLiveView, readTrayMenuModel, } from "./view-model.js";
-export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, } from "./notification-preferences.js";
+export { CODEX_APP_PROVIDER_KEY, CODEX_CLI_PROVIDER_KEY, buildCreditPoolFromProvider, buildCreditPoolsFromProvider, buildHudViewModel, filterHudViewModelByWidgets, } from "./hud-model.js";
+export { createSyncError, isNeutralSyncState, summarizeAggregateSync, syncStateFromFreshness, syncViewFromFreshness, } from "./sync-state.js";
+export { normalizePercent, usageProgressFromRemainingPercent, usageProgressFromTokens, usageProgressFromUsedPercent, usageProgressSeverity, } from "./usage-progress.js";
+export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_DASHBOARD_WIDGET_LAYOUTS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, DASHBOARD_VIEW_KEYS, DASHBOARD_WIDGET_KEYS_BY_VIEW, DASHBOARD_WIDGET_SIZES, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, } from "./notification-preferences.js";
 //# sourceMappingURL=index.js.map

package/dist/packages/view-model/src/notification-preferences-model.d.ts

@@ -1,7 +1,18 @@
-export declare const NOTIFICATION_WIDGET_KEYS: readonly ["month_forecast", "today_live_cost", "risk_high_count", "stale_connection_count", "aws_month_forecast", "openai_today_cost", "openai_today_tokens", "claude_five_hour_percent", "claude_weekly_percent", "codex_five_hour_percent", "codex_weekly_percent", "supabase_usage_health", "cloudflare_month_to_date"];
-export declare const LOCAL_CLI_DASHBOARD_METRIC_KEYS: readonly ["context_percent", "last_request_tokens", "total_tokens", "five_hour_limit_percent", "weekly_limit_percent", "five_hour_remaining_tokens", "weekly_remaining_tokens", "context_tokens", "input_tokens", "output_tokens", "cache_tokens", "reasoning_tokens", "sessions", "turns", "tool_calls", "log_files"];
+export declare const NOTIFICATION_WIDGET_KEYS: readonly ["month_forecast", "today_live_cost", "risk_high_count", "stale_connection_count", "aws_month_forecast", "openai_today_cost", "openai_today_tokens", "claude_five_hour_percent", "claude_weekly_percent", "codex_five_hour_percent", "codex_weekly_percent", "codex_reset_credit_count", "codex_reset_credit_expiry", "supabase_usage_health", "cloudflare_month_to_date"];
+export declare const LOCAL_CLI_DASHBOARD_METRIC_KEYS: readonly ["context_percent", "last_request_tokens", "total_tokens", "five_hour_limit_percent", "weekly_limit_percent", "five_hour_remaining_tokens", "weekly_remaining_tokens", "usage_reset_credits", "usage_reset_credit_estimate", "context_tokens", "input_tokens", "output_tokens", "cache_tokens", "reasoning_tokens", "sessions", "turns", "tool_calls", "log_files"];
+export declare const DASHBOARD_VIEW_KEYS: readonly ["overview", "today", "forecast", "risks"];
+export declare const DASHBOARD_WIDGET_SIZES: readonly ["compact", "normal", "wide", "full"];
+export declare const DASHBOARD_WIDGET_KEYS_BY_VIEW: {
+    readonly overview: readonly ["overview_meta", "overview_metrics", "overview_trend", "overview_grouping", "overview_services", "overview_insights"];
+    readonly today: readonly ["today_main", "today_rail"];
+    readonly forecast: readonly ["forecast_metrics", "forecast_table", "forecast_breakdown"];
+    readonly risks: readonly ["risks_summary", "risks_table"];
+};
 export type NotificationWidgetKey = (typeof NOTIFICATION_WIDGET_KEYS)[number];
 export type LocalCliDashboardMetricKey = (typeof LOCAL_CLI_DASHBOARD_METRIC_KEYS)[number];
+export type DashboardViewKey = (typeof DASHBOARD_VIEW_KEYS)[number];
+export type DashboardWidgetSize = (typeof DASHBOARD_WIDGET_SIZES)[number];
+export type DashboardWidgetKey = (typeof DASHBOARD_WIDGET_KEYS_BY_VIEW)[DashboardViewKey][number];
 export type ThresholdOperator = "gte" | "lte" | "eq";
 export type DigestInterval = "six-hours" | "daily" | "weekly";
 export interface NotificationThresholdRule {
@@ -24,8 +35,24 @@ export interface NotificationPreferences {
     dashboard: DashboardDisplayPreferences;
     hud: HudPreferences;
 }
+export interface DashboardBudgetPreferences {
+    monthlyBudgetMinor: number | null;
+    currency: string;
+    warningPercent: number;
+    criticalPercent: number;
+}
 export interface DashboardDisplayPreferences {
     localCliMetricKeys: readonly LocalCliDashboardMetricKey[];
+    budget: DashboardBudgetPreferences;
+    widgetLayouts: DashboardWidgetLayoutPreferences;
+}
+export type DashboardWidgetLayoutPreferences = {
+    readonly [ViewKey in DashboardViewKey]: readonly DashboardWidgetLayoutItem[];
+};
+export interface DashboardWidgetLayoutItem {
+    widgetKey: DashboardWidgetKey;
+    visible: boolean;
+    size: DashboardWidgetSize;
 }
 export interface HudPreferences {
     alwaysOnTop: boolean;
@@ -40,6 +67,7 @@ export interface NotificationPreferenceFileOptions {
 }
 export declare const DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS: readonly NotificationWidgetKey[];
 export declare const DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS: readonly LocalCliDashboardMetricKey[];
+export declare const DEFAULT_DASHBOARD_WIDGET_LAYOUTS: DashboardWidgetLayoutPreferences;
 export declare const DEFAULT_NOTIFICATION_THRESHOLD_RULES: readonly NotificationThresholdRule[];
 export declare const DEFAULT_NOTIFICATION_PREFERENCES: NotificationPreferences;
 export declare function parseNotificationPreferences(value: unknown): NotificationPreferences;

package/dist/packages/view-model/src/notification-preferences-model.js

@@ -10,6 +10,8 @@ export const NOTIFICATION_WIDGET_KEYS = [
     "claude_weekly_percent",
     "codex_five_hour_percent",
     "codex_weekly_percent",
+    "codex_reset_credit_count",
+    "codex_reset_credit_expiry",
     "supabase_usage_health",
     "cloudflare_month_to_date",
 ];
@@ -21,6 +23,8 @@ export const LOCAL_CLI_DASHBOARD_METRIC_KEYS = [
     "weekly_limit_percent",
     "five_hour_remaining_tokens",
     "weekly_remaining_tokens",
+    "usage_reset_credits",
+    "usage_reset_credit_estimate",
     "context_tokens",
     "input_tokens",
     "output_tokens",
@@ -31,6 +35,31 @@ export const LOCAL_CLI_DASHBOARD_METRIC_KEYS = [
     "tool_calls",
     "log_files",
 ];
+export const DASHBOARD_VIEW_KEYS = ["overview", "today", "forecast", "risks"];
+export const DASHBOARD_WIDGET_SIZES = ["compact", "normal", "wide", "full"];
+export const DASHBOARD_WIDGET_KEYS_BY_VIEW = {
+    overview: [
+        "overview_meta",
+        "overview_metrics",
+        "overview_trend",
+        "overview_grouping",
+        "overview_services",
+        "overview_insights",
+    ],
+    today: [
+        "today_main",
+        "today_rail",
+    ],
+    forecast: [
+        "forecast_metrics",
+        "forecast_table",
+        "forecast_breakdown",
+    ],
+    risks: [
+        "risks_summary",
+        "risks_table",
+    ],
+};
 export const DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS = [
     "month_forecast",
     "today_live_cost",
@@ -38,12 +67,40 @@ export const DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS = [
     "stale_connection_count",
     "openai_today_tokens",
     "codex_five_hour_percent",
+    "codex_reset_credit_count",
+    "codex_reset_credit_expiry",
+];
+const LEGACY_SELECTED_NOTIFICATION_WIDGET_KEY_SETS = [
+    [
+        "month_forecast",
+        "today_live_cost",
+        "risk_high_count",
+        "stale_connection_count",
+        "openai_today_tokens",
+        "codex_five_hour_percent",
+    ],
+    [
+        "month_forecast",
+        "today_live_cost",
+        "risk_high_count",
+        "stale_connection_count",
+        "openai_today_tokens",
+        "codex_five_hour_percent",
+        "codex_reset_credit_expiry",
+    ],
 ];
 export const DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS = [
     "context_percent",
     "last_request_tokens",
     "total_tokens",
+    "usage_reset_credits",
 ];
+export const DEFAULT_DASHBOARD_WIDGET_LAYOUTS = {
+    overview: defaultDashboardWidgetLayout("overview"),
+    today: defaultDashboardWidgetLayout("today"),
+    forecast: defaultDashboardWidgetLayout("forecast"),
+    risks: defaultDashboardWidgetLayout("risks"),
+};
 export const DEFAULT_NOTIFICATION_THRESHOLD_RULES = [
     {
         widgetKey: "risk_high_count",
@@ -77,6 +134,13 @@ export const DEFAULT_NOTIFICATION_PREFERENCES = {
     desktopEnabled: false,
     dashboard: {
         localCliMetricKeys: DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS,
+        widgetLayouts: DEFAULT_DASHBOARD_WIDGET_LAYOUTS,
+        budget: {
+            monthlyBudgetMinor: null,
+            currency: "USD",
+            warningPercent: 80,
+            criticalPercent: 100,
+        },
     },
     hud: {
         alwaysOnTop: true,
@@ -125,6 +189,84 @@ function parseDashboardDisplayPreferences(value) {
     const record = isRecord(value) ? value : {};
     return {
         localCliMetricKeys: parseLocalCliDashboardMetricKeys(record.localCliMetricKeys),
+        budget: parseDashboardBudgetPreferences(record.budget),
+        widgetLayouts: parseDashboardWidgetLayouts(record.widgetLayouts),
+    };
+}
+function parseDashboardWidgetLayouts(value) {
+    const record = isRecord(value) ? value : {};
+    return {
+        overview: parseDashboardWidgetLayout("overview", record.overview),
+        today: parseDashboardWidgetLayout("today", record.today),
+        forecast: parseDashboardWidgetLayout("forecast", record.forecast),
+        risks: parseDashboardWidgetLayout("risks", record.risks),
+    };
+}
+function parseDashboardWidgetLayout(viewKey, value) {
+    const validWidgetKeys = new Set(DASHBOARD_WIDGET_KEYS_BY_VIEW[viewKey]);
+    const defaults = defaultDashboardWidgetLayout(viewKey);
+    const defaultByKey = new Map(defaults.map((item) => [item.widgetKey, item]));
+    const parsed = Array.isArray(value)
+        ? value
+            .map((item) => {
+            if (!isRecord(item) || typeof item.widgetKey !== "string" || !validWidgetKeys.has(item.widgetKey)) {
+                return null;
+            }
+            const widgetKey = item.widgetKey;
+            const fallback = defaultByKey.get(widgetKey);
+            return {
+                widgetKey,
+                visible: typeof item.visible === "boolean" ? item.visible : fallback?.visible ?? true,
+                size: parseDashboardWidgetSize(item.size, fallback?.size ?? "normal"),
+            };
+        })
+            .filter((item) => item !== null)
+        : [];
+    const seen = new Set();
+    const normalized = parsed.filter((item) => {
+        if (seen.has(item.widgetKey)) {
+            return false;
+        }
+        seen.add(item.widgetKey);
+        return true;
+    });
+    const missing = defaults.filter((item) => !seen.has(item.widgetKey));
+    return [...normalized, ...missing];
+}
+function defaultDashboardWidgetLayout(viewKey) {
+    return DASHBOARD_WIDGET_KEYS_BY_VIEW[viewKey].map((widgetKey) => ({
+        widgetKey,
+        visible: true,
+        size: defaultDashboardWidgetSize(widgetKey),
+    }));
+}
+function defaultDashboardWidgetSize(widgetKey) {
+    if (widgetKey === "overview_metrics" || widgetKey === "overview_services" || widgetKey === "risks_table") {
+        return "full";
+    }
+    if (widgetKey === "today_main" || widgetKey === "forecast_table") {
+        return "wide";
+    }
+    if (widgetKey === "forecast_breakdown" || widgetKey === "today_rail") {
+        return "compact";
+    }
+    return "normal";
+}
+function parseDashboardWidgetSize(value, fallback) {
+    return typeof value === "string" && DASHBOARD_WIDGET_SIZES.includes(value)
+        ? value
+        : fallback;
+}
+function parseDashboardBudgetPreferences(value) {
+    const record = isRecord(value) ? value : {};
+    const monthlyBudgetMinor = parseOptionalPositiveInteger(record.monthlyBudgetMinor);
+    const warningPercent = clampNumber(record.warningPercent, 1, 999, DEFAULT_NOTIFICATION_PREFERENCES.dashboard.budget.warningPercent);
+    const criticalPercent = clampNumber(record.criticalPercent, warningPercent, 999, DEFAULT_NOTIFICATION_PREFERENCES.dashboard.budget.criticalPercent);
+    return {
+        monthlyBudgetMinor,
+        currency: parseCurrency(record.currency, DEFAULT_NOTIFICATION_PREFERENCES.dashboard.budget.currency),
+        warningPercent,
+        criticalPercent,
     };
 }
 function parseHudPreferences(value, fallbackSelectedWidgets = DEFAULT_NOTIFICATION_PREFERENCES.hud.selectedWidgets) {
@@ -162,7 +304,31 @@ function parseSelectedWidgets(value, fallbackSelectedWidgets = DEFAULT_SELECTED_
     const selected = Array.isArray(value)
         ? value.filter((item) => typeof item === "string" && widgetKeys.has(item))
         : [...fallbackSelectedWidgets];
-    return selected.length === 0 ? [...fallbackSelectedWidgets] : [...new Set(selected)];
+    if (selected.length === 0) {
+        return [...fallbackSelectedWidgets];
+    }
+    const uniqueSelected = [...new Set(selected)];
+    return isLegacySelectedWidgetDefault(uniqueSelected)
+        ? [...DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS]
+        : migrateSelectedWidgets(uniqueSelected);
+}
+function migrateSelectedWidgets(selectedWidgets) {
+    if (!selectedWidgets.includes("codex_reset_credit_expiry") ||
+        selectedWidgets.includes("codex_reset_credit_count")) {
+        return [...selectedWidgets];
+    }
+    const migrated = [];
+    for (const widgetKey of selectedWidgets) {
+        if (widgetKey === "codex_reset_credit_expiry") {
+            migrated.push("codex_reset_credit_count");
+        }
+        migrated.push(widgetKey);
+    }
+    return migrated;
+}
+function isLegacySelectedWidgetDefault(selectedWidgets) {
+    return LEGACY_SELECTED_NOTIFICATION_WIDGET_KEY_SETS.some((legacySet) => legacySet.length === selectedWidgets.length &&
+        legacySet.every((widgetKey, index) => selectedWidgets[index] === widgetKey));
 }
 function parseThresholdRules(value) {
     if (!Array.isArray(value)) {
@@ -203,6 +369,22 @@ function parseNonNegativeNumber(value) {
     }
     return Math.max(0, value);
 }
+function parseOptionalPositiveInteger(value) {
+    if (value === null || value === undefined || value === "") {
+        return null;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return null;
+    }
+    return Math.round(value);
+}
+function parseCurrency(value, fallback) {
+    if (typeof value !== "string") {
+        return fallback;
+    }
+    const normalized = value.trim().toUpperCase();
+    return /^[A-Z]{3}$/.test(normalized) ? normalized : fallback;
+}
 function clampNumber(value, min, max, fallback) {
     if (typeof value !== "number" || !Number.isFinite(value)) {
         return fallback;

package/dist/packages/view-model/src/notification-preferences.d.ts

@@ -1,5 +1,5 @@
 import { type NotificationPreferenceFileOptions, type NotificationPreferences } from "./notification-preferences-model.js";
-export { cloneNotificationPreferences, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, type DigestInterval, type DashboardDisplayPreferences, type LocalCliDashboardMetricKey, type NotificationPreferenceFileOptions, type NotificationPreferences, type NotificationThresholdRule, type NotificationWidgetKey, type ThresholdOperator, } from "./notification-preferences-model.js";
+export { cloneNotificationPreferences, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_DASHBOARD_WIDGET_LAYOUTS, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, DASHBOARD_VIEW_KEYS, DASHBOARD_WIDGET_KEYS_BY_VIEW, DASHBOARD_WIDGET_SIZES, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, type DashboardBudgetPreferences, type DashboardDisplayPreferences, type DashboardViewKey, type DashboardWidgetKey, type DashboardWidgetLayoutItem, type DashboardWidgetLayoutPreferences, type DashboardWidgetSize, type DigestInterval, type LocalCliDashboardMetricKey, type NotificationPreferenceFileOptions, type NotificationPreferences, type NotificationThresholdRule, type NotificationWidgetKey, type ThresholdOperator, } from "./notification-preferences-model.js";
 export declare function readNotificationPreferencesFile(options?: NotificationPreferenceFileOptions): Promise<NotificationPreferences>;
 export declare function writeNotificationPreferencesFile(preferences: NotificationPreferences, options?: NotificationPreferenceFileOptions): Promise<NotificationPreferences>;
 export declare function resolveNotificationPreferencesPath(options?: NotificationPreferenceFileOptions): string;

package/dist/packages/view-model/src/notification-preferences.js

@@ -1,7 +1,7 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join } from "node:path";
 import { cloneNotificationPreferences, DEFAULT_NOTIFICATION_PREFERENCES, parseNotificationPreferences, } from "./notification-preferences-model.js";
-export { cloneNotificationPreferences, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, } from "./notification-preferences-model.js";
+export { cloneNotificationPreferences, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_DASHBOARD_WIDGET_LAYOUTS, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, DASHBOARD_VIEW_KEYS, DASHBOARD_WIDGET_KEYS_BY_VIEW, DASHBOARD_WIDGET_SIZES, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, } from "./notification-preferences-model.js";
 const PREFERENCES_PATH_ENV = "MONEYSIREN_NOTIFICATION_PREFS_PATH";
 const DEFAULT_PREFERENCES_PATH = ".moneysiren/notification-preferences.json";
 export async function readNotificationPreferencesFile(options = {}) {