glm-quota-line 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.2.0
+
+- Added interactive TUI configuration: `glm-quota-line configure` — live preview, per-component toggle and style, global options
+- Added component-level control: each display component (plan, 5h, week, reset, context) can be individually toggled and styled
+- Added `minimalist` config to hide all labels, showing only progress bars and values
+- Added `raw-values` config to hide labels and show raw values
+- Added `--json` flag for structured JSON output in terminal mode (useful for scripting and automation)
+- Added `work-days` config (1-7) to customize weekly working days for quota pacing calculation
+- Added one-time query via `npx glm-quota-line` without global install
+- Context window now displays model ID and window size (e.g., `glm-4.7 (200K)`)
+- Context window usage is now calculated from raw tokens when model mapping is available
+- Weekly quota bar now shows theoretical budget with shade segments (▒) when pacing data is available
+- Weekly quota severity now uses pacing-based calculation: good (≤1.1x), warn (1.1-1.3x), danger (>1.3x)
+- Added GLM provider detection to disable quota for non-Zhipu API endpoints
+- Replaced `--ctx on|off` CLI flag and `config set/unset ctx` with TUI component config
+- Consolidated duplicate utility functions into shared `utils.js` module
+
+## 1.1.1
+
+- Fixed MCP quota not displaying when API returns `TIME_LIMIT` type instead of `MCP_LIMIT`
+- Updated severity colors: good `#4694AF`, warn `#FF8200`, danger `#DC3513`
+
 ## 1.1.0
 
 - Added MCP quota extraction from API response (`MCP_LIMIT` type), shown in CLI query output alongside token quotas

package/README.en.md

@@ -19,13 +19,25 @@
 
 - **Terminal quick check** — run `glm-quota-line` in any terminal to view your quota (including MCP) without launching Claude Code
 - **Claude Code status line** — auto-embeds in the status bar after install, shows quota balance, reset time, and context window usage in real time
-- **Bar visualization** — default bar style shows remaining quota at a glance
+- **Bar visualization** — default bar style shows remaining quota at a glance; weekly quota shows theoretical budget shadow
+- **Weekly pacing analysis** — calculates usage speed based on work days, auto-highlights when exceeding theoretical budget
+- **JSON output** — `--json` flag outputs structured data for scripting
+- **Interactive configuration** — `glm-quota-line configure` launches a TUI with live preview and per-component controls
+- **Component-level control** — each display component (plan, 5h, week, reset, context) can be individually toggled and styled
 - **Smart caching** — tiered refresh by session, TTL, and token usage; `SessionStart` hook pre-refreshes so new sessions never show stale data
 - **Domestic + international endpoints** — auto-detects `open.bigmodel.cn` and `api.z.ai`
 - **Zero dependencies** — no runtime deps, single-purpose CLI
 
 ## Quick Start
 
+**One-time query (no install needed):**
+
+```bash
+npx glm-quota-line
+```
+
+**Status line integration (global install required):**
+
 ```bash
 npm install -g glm-quota-line
 glm-quota-line install
@@ -34,7 +46,7 @@ glm-quota-line install
 Done. Your Claude Code status bar will now show the quota:
 
 ```
-GLM Lite █████████░ 91% | W 47% | 14:47 | ctx ███░░░ 45%
+GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% | 14:47 | ctx ███░░░ 45% (glm-4.7/200K)
 ```
 
 You can also run `glm-quota-line` directly in the terminal to check your quota without launching Claude Code.
@@ -54,7 +66,7 @@ All options are optional. Persist with `glm-quota-line config set`, or override
 
 | Value | Description | Example |
 |---|---|---|
-| `bar` (default) | Progress bar | `GLM Lite █████████░ 91% \| W 47% \| 14:47 \| ctx ███░░░ 45%` |
+| `bar` (default) | Progress bar | `GLM Lite █████████░ 91% \| W ▒▒▒▒░░░░░ 47% \| 14:47 \| ctx ███░░░ 45%` |
 | `text` | Full text | `GLM Lite \| 5h 91% \| week 47% \| reset 14:47 \| ctx 45%` |
 | `compact` | Compact mode | `GLM 5h 91% W 47% \| 14:47` |
 
@@ -91,24 +103,71 @@ Quota percentage colors change automatically based on remaining amount:
 glm-quota-line config set display used
 ```
 
-### ctx — Context window usage
+### work-days — Work days per week
 
-Show the current Claude Code context window usage percentage in the status line (status line mode only).
+Set the number of work days per week (1–7) for weekly quota theoretical budget and pacing analysis. Default: 5.
 
-| Value | Description |
-|---|---|
-| `on` (default) | Show context window usage |
-| `off` | Hide context window usage |
+```bash
+glm-quota-line config set work-days 6
+```
+
+Pacing analysis calculates theoretical budget based on elapsed work days:
+- Green — usage speed ≤ 1.1x theoretical
+- Yellow — usage speed 1.1x–1.3x theoretical
+- Red — usage speed > 1.3x theoretical
+
+### --json — JSON output
+
+Output structured JSON format (terminal mode only, ignored in status line mode):
 
 ```bash
-glm-quota-line config set ctx off
+glm-quota-line --json
 ```
 
-Context usage colors change automatically based on used percentage:
+Example output:
+```json
+{
+  "level": "Lite",
+  "quotas": [
+    {
+      "label": "5h",
+      "leftPercent": 91,
+      "usedPercent": 9,
+      "nextResetTime": 1715257200000
+    },
+    {
+      "label": "week",
+      "leftPercent": 47,
+      "usedPercent": 53,
+      "nextResetTime": 1715744400000
+    }
+  ],
+  "mcp": {
+    "leftPercent": 85,
+    "usedPercent": 15
+  }
+}
+```
+
+### minimalist — Minimal mode
 
-- Green — used < 60%
-- Yellow — used 60%–79%
-- Red — used >= 80%
+Hide all labels, show only progress bars and values.
+
+```bash
+glm-quota-line config set minimalist true
+```
+
+Effect:
+- Off: `GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% | 14:47`
+- On: `█████████░ 91% | ▒▒▒▒░░░░░ 47% | 14:47`
+
+### raw-values — Raw values
+
+Hide all labels and show raw values directly.
+
+```bash
+glm-quota-line config set raw-values true
+```
 
 ### auth-token / base-url — Custom auth
 
@@ -129,6 +188,29 @@ Auth source priority (highest to lowest):
 2. Environment variables `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
 3. `env` field in `~/.claude/settings.json`
 
+### configure — Interactive TUI setup
+
+Launch a terminal UI with live preview to adjust component toggles, styles, and global options.
+
+```bash
+glm-quota-line configure
+```
+
+Key bindings:
+- `↑↓` select component, `Enter` to edit, `Tab` to cycle style, `Space` to toggle
+- `g` to enter global options (theme, display mode, minimalist, raw-values)
+- `s` to save, `q` to quit
+
+Components:
+
+| Component | Description | Styleable | Hideable |
+|---|---|---|---|
+| `level` | Plan level (e.g. GLM Lite) | — | ✓ |
+| `5h` | 5-hour quota | ✓ (bar/text) | — (required) |
+| `week` | Weekly quota | ✓ (bar/text) | ✓ |
+| `reset` | Reset time | — | ✓ |
+| `ctx` | Context window usage | ✓ (bar/text) | ✓ |
+
 ## Recommended Combinations
 
 | Use case | Config |
@@ -137,17 +219,22 @@ Auth source priority (highest to lowest):
 | Light terminal | `style=bar`, `theme=light` |
 | Minimal setup | `style=compact`, `theme=mono` |
 | Track usage | `style=bar`, `display=used` |
+| Scripting | `--json` |
+| 6-day work week | `work-days=6` |
+| Minimal values | `minimalist=true` |
+| Interactive setup | `glm-quota-line configure` |
 
 ## Command Reference
 
 ```bash
-glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--ctx on|off]
+glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--json]
 glm-quota-line install [--force]
 glm-quota-line uninstall
 glm-quota-line version
 glm-quota-line check-update
+glm-quota-line configure
 glm-quota-line config show
-glm-quota-line config set <style|display|theme|ctx|auth-token|base-url> <value>
+glm-quota-line config set <style|display|theme|auth-token|base-url|work-days|minimalist|raw-values> <value>
 glm-quota-line config unset <key>
 ```
 
@@ -155,11 +242,15 @@ Run `glm-quota-line --help` for full descriptions.
 
 ## Notes
 
-- Shows `TOKENS_LIMIT` and `MCP_LIMIT` quotas; `TIME_LIMIT` is ignored
-- Context window usage is shown by default; disable with `--ctx off` or `config set ctx off`
+- Shows `TOKENS_LIMIT` and `MCP_LIMIT` / `TIME_LIMIT` quotas
+- Weekly quota progress bar shadow (▒) is a daily pacing baseline: the theoretical budget based on elapsed work days — the more the filled bar (█) extends past the shadow, the faster you're consuming
+- Context window usage is shown by default; toggle via `glm-quota-line configure`
+- Context window usage is calculated from raw tokens when model mapping is available, falls back to API-provided percentages
+- Each component can be individually toggled and styled via `glm-quota-line configure`
 - Missing auth returns `GLM | auth expired`; API failures return `GLM | quota unavailable`
 - `install` does not replace an unmanaged status line unless `--force` is used
 - `install --force` backs up the previous entry; `uninstall` restores it when possible
+- Set `GLM_QUOTA_DEBUG=1` to output context window debug info to stderr
 
 ## License
 

package/README.md

@@ -19,13 +19,25 @@
 
 - **终端快速查询** — 直接运行 `glm-quota-line` 即可在终端查看配额（含 MCP），无需启动 Claude Code
 - **Claude Code 状态栏** — 安装后自动嵌入状态栏，实时显示配额余额、重置时间和上下文窗口用量
-- **进度条可视化** — 默认 bar 风格，一眼看清剩余比例
+- **进度条可视化** — 默认 bar 风格，一眼看清剩余比例；周配额显示理论预算阴影
+- **智能配速分析** — 根据工作日和已过时间计算配额使用速度，超速时自动变色警示
+- **JSON 输出** — 支持 `--json` 参数输出结构化数据，便于脚本调用
+- **交互式配置** — `glm-quota-line configure` 启动 TUI 界面，实时预览、逐项调整组件开关与样式
+- **组件级控制** — 每个显示组件（套餐、5h、周、重置、上下文）可单独开关和设置样式
 - **智能缓存** — 按会话、TTL 和 token 用量分级刷新；`SessionStart` hook 预刷新，新会话不显示旧数据
 - **国内 + 国际端点** — 自动识别 `open.bigmodel.cn` 和 `api.z.ai`
 - **零依赖** — 无运行时依赖，单一用途
 
 ## 快速开始
 
+**一次性查询（无需安装）：**
+
+```bash
+npx glm-quota-line
+```
+
+**状态栏集成（需要全局安装）：**
+
 ```bash
 npm install -g glm-quota-line
 glm-quota-line install
@@ -34,7 +46,7 @@ glm-quota-line install
 安装完成。Claude Code 底部状态栏会自动显示配额：
 
 ```
-GLM Lite █████████░ 91% | W 47% | 14:47 | ctx ███░░░ 45%
+GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% | 14:47 | ctx ███░░░ 45% (glm-4.7/200K)
 ```
 
 也可以直接在终端运行 `glm-quota-line` 快速查看用量，无需启动 Claude Code。
@@ -54,7 +66,7 @@ glm-quota-line check-update
 
 | 值 | 说明 | 示例 |
 |---|---|---|
-| `bar`（默认） | 进度条可视化 | `GLM Lite █████████░ 91% \| W 47% \| 14:47 \| ctx ███░░░ 45%` |
+| `bar`（默认） | 进度条可视化 | `GLM Lite █████████░ 91% \| W ▒▒▒▒░░░░░ 47% \| 14:47 \| ctx ███░░░ 45%` |
 | `text` | 完整文本 | `GLM Lite \| 5h 91% \| week 47% \| reset 14:47 \| ctx 45%` |
 | `compact` | 紧凑模式 | `GLM 5h 91% W 47% \| 14:47` |
 
@@ -91,24 +103,71 @@ glm-quota-line config set theme light
 glm-quota-line config set display used
 ```
 
-### ctx — 上下文窗口用量
+### work-days — 每周工作日
 
-在状态栏显示当前 Claude Code 上下文窗口的使用百分比（仅状态栏模式）。
+设置每周工作日数量（1-7），用于计算周配额的理论预算和配速分析。默认 5 天。
 
-| 值 | 说明 |
-|---|---|
-| `on`（默认） | 显示上下文窗口用量 |
-| `off` | 隐藏上下文窗口用量 |
+```bash
+glm-quota-line config set work-days 6
+```
+
+配速分析会根据已过工作日计算理论预算，并判断使用速度：
+- 绿色 — 使用速度 ≤ 1.1x 理论值
+- 黄色 — 使用速度 1.1x–1.3x 理论值
+- 红色 — 使用速度 > 1.3x 理论值
+
+### minimalist — 极简模式
+
+隐藏所有标签文字，只保留进度条和数值。
 
 ```bash
-glm-quota-line config set ctx off
+glm-quota-line config set minimalist true
 ```
 
-上下文用量会根据已用比例自动变色：
+效果对比：
+- 关闭：`GLM Lite █████████░ 91% | W ▒▒▒▒░░░░░ 47% | 14:47`
+- 开启：`█████████░ 91% | ▒▒▒▒░░░░░ 47% | 14:47`
 
-- 绿色 — 已用 < 60%
-- 黄色 — 已用 60%–79%
-- 红色 — 已用 >= 80%
+### raw-values — 原始数值
+
+隐藏所有标签文字，直接显示原始数值。
+
+```bash
+glm-quota-line config set raw-values true
+```
+
+### --json — JSON 输出
+
+输出结构化 JSON 格式（仅终端模式，状态栏模式忽略）：
+
+```bash
+glm-quota-line --json
+```
+
+输出示例：
+```json
+{
+  "level": "Lite",
+  "quotas": [
+    {
+      "label": "5h",
+      "leftPercent": 91,
+      "usedPercent": 9,
+      "nextResetTime": 1715257200000
+    },
+    {
+      "label": "week",
+      "leftPercent": 47,
+      "usedPercent": 53,
+      "nextResetTime": 1715744400000
+    }
+  ],
+  "mcp": {
+    "leftPercent": 85,
+    "usedPercent": 15
+  }
+}
+```
 
 ### auth-token / base-url — 自定义鉴权
 
@@ -129,6 +188,29 @@ glm-quota-line config set base-url https://api.z.ai/api/anthropic
 2. 环境变量 `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`
 3. `~/.claude/settings.json` 中的 `env` 字段
 
+### configure — 交互式 TUI 配置
+
+启动终端交互界面，实时预览状态栏效果，逐项调整组件开关、样式和全局选项。
+
+```bash
+glm-quota-line configure
+```
+
+操作方式：
+- `↑↓` 选择组件，`Enter` 进入编辑，`Tab` 切换样式，`Space` 开关显示
+- `g` 进入全局选项（主题、显示模式、极简模式、原始数值）
+- `s` 保存，`q` 退出
+
+组件列表：
+
+| 组件 | 说明 | 可设置样式 | 可隐藏 |
+|---|---|---|---|
+| `level` | 套餐级别（如 GLM Lite） | — | ✓ |
+| `5h` | 5 小时配额 | ✓ (bar/text) | —（必需） |
+| `week` | 周配额 | ✓ (bar/text) | ✓ |
+| `reset` | 重置时间 | — | ✓ |
+| `ctx` | 上下文窗口用量 | ✓ (bar/text) | ✓ |
+
 ## 推荐搭配
 
 | 使用场景 | 配置 |
@@ -137,17 +219,22 @@ glm-quota-line config set base-url https://api.z.ai/api/anthropic
 | 浅色终端 | `style=bar`, `theme=light` |
 | 极简工作流 | `style=compact`, `theme=mono` |
 | 关注已用量 | `style=bar`, `display=used` |
+| 脚本调用 | `--json` |
+| 6 天工作制 | `work-days=6` |
+| 极简数值 | `minimalist=true` |
+| 交互式配置 | `glm-quota-line configure` |
 
 ## 命令参考
 
 ```bash
-glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--ctx on|off]
+glm-quota-line [--style text|compact|bar] [--display left|used] [--theme dark|light|mono] [--json]
 glm-quota-line install [--force]
 glm-quota-line uninstall
 glm-quota-line version
 glm-quota-line check-update
+glm-quota-line configure
 glm-quota-line config show
-glm-quota-line config set <style|display|theme|ctx|auth-token|base-url> <value>
+glm-quota-line config set <style|display|theme|auth-token|base-url|work-days|minimalist|raw-values> <value>
 glm-quota-line config unset <key>
 ```
 
@@ -155,11 +242,16 @@ glm-quota-line config unset <key>
 
 ## 说明
 
-- 展示 `TOKENS_LIMIT` 配额和 `MCP_LIMIT` 配额，忽略 `TIME_LIMIT`
-- 状态栏默认显示上下文窗口用量，可通过 `--ctx off` 或 `config set ctx off` 关闭
+- 展示 `TOKENS_LIMIT` 配额和 `MCP_LIMIT` / `TIME_LIMIT` 配额
+- 周配额进度条中的阴影（▒）是每日应耗基准线：根据已过工作日计算的理论预算，已用部分（█）超过阴影越多，说明消耗越快
+- 状态栏默认显示上下文窗口用量和模型信息，可通过 `glm-quota-line configure` 交互式关闭
+- 每个组件可单独控制开关和样式，通过 `glm-quota-line configure` 交互式调整
+- 上下文窗口使用率优先从原始 token 数计算，当模型映射不可用时回退到 API 提供的百分比
 - 鉴权缺失返回 `GLM | auth expired`；接口异常返回 `GLM | quota unavailable`
+- 非 GLM 提供商（非智谱 AI 端点）会自动禁用配额查询
 - `install` 默认不会覆盖非本工具管理的状态栏，除非使用 `--force`
 - `install --force` 会备份旧配置，`uninstall` 会在可能时恢复
+- 设置 `GLM_QUOTA_DEBUG=1` 可输出上下文窗口调试信息到 stderr
 
 ## 许可证
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glm-quota-line",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Zhipu GLM Coding Plan quota monitor for Claude Code status line.",
   "type": "module",
   "license": "MIT",
@@ -13,7 +13,8 @@
     "z.ai",
     "coding-plan",
     "quota",
-    "statusline"
+    "statusline",
+    "tui"
   ],
   "repository": {
     "type": "git",

package/src/claude/sessionStart.js

@@ -1,9 +1,10 @@
 import { loadConfig } from "../shared/config.js";
+import { clearCtxCache } from "../core/quota/cache.js";
 import { resolveQuotaStatus } from "../core/quota/service.js";
 import { readStatusLineInput } from "./input.js";
 import { readToolConfig } from "./settings.js";
 
-export const SESSION_START_MATCHERS = ["startup", "resume", "clear"];
+export const SESSION_START_MATCHERS = ["startup", "resume", "clear", "compact"];
 
 export async function refreshQuotaOnSessionStart(options = {}) {
   const hookInput = await readStatusLineInput(options.stdin ?? process.stdin);
@@ -15,6 +16,10 @@ export async function refreshQuotaOnSessionStart(options = {}) {
     sessionId: hookInput?.session_id || ""
   };
 
+  if (hookInput?.source === "compact" || hookInput?.source === "clear" || hookInput?.source === "startup") {
+    await clearCtxCache(config.cacheFilePath).catch(() => {});
+  }
+
   return resolveQuotaStatusFn(config, {
     now: options.now,
     fetchImpl: options.fetchImpl,

package/src/claude/settings.js

@@ -6,10 +6,12 @@ import {
   TOOL_CONFIG_SCHEMA_VERSION,
   isValidDisplayMode,
   isValidStatusStyle,
-  isValidTheme
+  isValidTheme,
+  isValidWorkDays
 } from "../shared/constants.js";
+import { migrateOldConfig, needsMigration } from "../shared/migration.js";
+import { normalizeOptionalString } from "../shared/utils.js";
 import { readJsonFile, writeJsonFile } from "../shared/jsonFile.js";
-import { normalizeOptionalString } from "../shared/config.js";
 
 function getClaudeDir() {
   return path.join(os.homedir(), ".claude");
@@ -55,8 +57,16 @@ function normalizeToolConfig(config) {
     normalized.theme = base.theme;
   }
 
-  if (typeof base.ctxEnabled === "boolean") {
-    normalized.ctxEnabled = base.ctxEnabled;
+  if (isValidWorkDays(base.workDays)) {
+    normalized.workDays = base.workDays;
+  }
+
+  if (typeof base.minimalist === "boolean") {
+    normalized.minimalist = base.minimalist;
+  }
+
+  if (typeof base.rawValues === "boolean") {
+    normalized.rawValues = base.rawValues;
   }
 
   const authToken = normalizeOptionalString(base.authToken);
@@ -69,12 +79,31 @@ function normalizeToolConfig(config) {
     normalized.baseUrl = baseUrl;
   }
 
+  // Preserve lines (component-level config) as-is
+  if (base.lines && Array.isArray(base.lines)) {
+    normalized.lines = base.lines;
+  }
+
   return normalized;
 }
 
 export async function readToolConfig(configPath = getToolConfigPath()) {
   const parsed = await readJsonFile(configPath, {});
-  return normalizeToolConfig(parsed);
+  const normalized = normalizeToolConfig(parsed);
+
+  // Migrate legacy ctxEnabled to lines-based format
+  if (needsMigration(parsed)) {
+    const migrated = migrateOldConfig({
+      ctxEnabled: parsed.ctxEnabled,
+      theme: parsed.theme,
+      displayMode: parsed.displayMode,
+      style: parsed.style
+    });
+    normalized.lines = migrated.lines;
+    await writeJsonFile(configPath, normalizeToolConfig({ ...parsed, lines: migrated.lines }));
+  }
+
+  return normalized;
 }
 
 export async function writeToolConfig(config, configPath = getToolConfigPath()) {

package/src/cli/args.js

@@ -9,6 +9,16 @@ function takeValue(args, index) {
   return next ?? "";
 }
 
+const FLAGS = [
+  { names: ["--style"], dest: "style" },
+  { names: ["--display"], dest: "displayMode" },
+  { names: ["--theme"], dest: "theme" },
+  { names: ["--force"], dest: "force", boolean: true },
+  { names: ["--json"], dest: "json", boolean: true },
+  { names: ["--help", "-h"], dest: "help", boolean: true },
+  { names: ["--version", "-v"], dest: "version", boolean: true }
+];
+
 export function parseArgs(argv = process.argv.slice(2)) {
   const options = {};
   const positionals = [];
@@ -21,57 +31,44 @@ export function parseArgs(argv = process.argv.slice(2)) {
       continue;
     }
 
-    if (arg === "--help" || arg === "-h") {
-      options.help = true;
-      continue;
-    }
-
-    if (arg === "--version" || arg === "-v") {
-      options.version = true;
-      continue;
-    }
+    let matched = false;
+    for (const flag of FLAGS) {
+      const isMatch = flag.names.some(
+        (name) => arg === name || arg.startsWith(`${name}=`)
+      );
+      if (!isMatch) {
+        continue;
+      }
 
-    if (arg === "--force") {
-      options.force = true;
-      continue;
-    }
+      matched = true;
 
-    if (arg === "--style" || arg.startsWith("--style=")) {
-      options.style = takeValue(argv, index);
-      if (!arg.includes("=")) {
-        index += 1;
+      if (flag.boolean) {
+        options[flag.dest] = true;
+        break;
       }
-      continue;
-    }
 
-    if (arg === "--display" || arg.startsWith("--display=")) {
-      options.displayMode = takeValue(argv, index);
+      const rawValue = takeValue(argv, index);
       if (!arg.includes("=")) {
         index += 1;
       }
-      continue;
-    }
 
-    if (arg === "--theme" || arg.startsWith("--theme=")) {
-      options.theme = takeValue(argv, index);
-      if (!arg.includes("=")) {
-        index += 1;
+      if (flag.parse) {
+        const result = flag.parse(rawValue);
+        if (result.error) {
+          process.stderr.write(result.error);
+          process.exitCode = 1;
+          options.positionals = positionals;
+          return options;
+        }
+        options[flag.dest] = result.value;
+      } else {
+        options[flag.dest] = rawValue;
       }
-      continue;
+      break;
     }
 
-    if (arg === "--ctx" || arg.startsWith("--ctx=")) {
-      const val = takeValue(argv, index);
-      if (val !== "on" && val !== "off") {
-        process.stderr.write("Error: --ctx requires on or off\n");
-        process.exitCode = 1;
-        return options;
-      }
-      options.ctxEnabled = val === "on";
-      if (!arg.includes("=")) {
-        index += 1;
-      }
-      continue;
+    if (!matched) {
+      // Unknown flags are ignored to allow forward-compatibility
     }
   }