ctx_cli 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2e8622dd69aeb8ad48fb4e9b5d0212345698f81b78f042d4dfa761bdf0c3890
-  data.tar.gz: b579bf0a5ad0a3d795249f4e8d0048366120f5a8f857f95a29901c78266b28f2
+  metadata.gz: 993414ac12bd17c37f136bb85d871efc2f217c7ca81fb7c9c57faca557030686
+  data.tar.gz: d1cfd1282ef0e9ddf5cd23243bf09076d0ffc8fed4c00186f5471e5e96bbcb94
 SHA512:
-  metadata.gz: 2e18324d1c852f300873ea0bf02fadd159fd70bf4637f716590e1e0435d92d5dc1a1580e5eed4f552cc607cf2aeef5549df544a8f07f1340faff5cc87724ecc3
-  data.tar.gz: b61f9d0812d4bde92d8b5bf86d804bc9d9f2b8991b7f3b7c308909c74696c4ecfec333dd1ef9b14ae9da57c043cf91a35b9ee74d62eaeea6bd17398e015222c6
+  metadata.gz: 6a72826b05f4e540be4999b61acbf9e89517c41949ccefd475e2e67ea039e39a49754f4ddcf179de83f164954032c0d250463db0b0ac6925d51e11665d98b6d2
+  data.tar.gz: aa88dbda8a415b0f3db1a52a9283a6711951e35c5003814f75724e1ace72ae35472d7f09beda808597c04f746d6dabe7fbd6946f4a55f241cd104c05e831c5a5

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.3.0 (2026-10-24)
+
+- Use JSON Pointer keys in configuration field provenance, separating literal dots, slashes, tildes, empty keys and nested mappings.
+- Remove only actual descendant sources when a mapping is replaced; preserve array replacement and empty-mapping merge behavior.
+- Breaking change: sources.fields and host --show-config output no longer expose dotted-path aliases; migrate field lookups to JSON Pointer.
+
+## 0.2.1 (2026-10-23)
+
+- Use English command help, prompts and collection/review diagnostics.
+- Allow compatible dotenv versions without an upper version bound.
+
 ## 0.2.0 (2026-10-23)
 
 - Rename Initialization to Initializer and Application to Router; remove the old constants and require paths in the 0.2.0 candidate.

data/README.md

@@ -53,6 +53,8 @@ files.environment # .env 加原进程环境；不修改 ENV
 files.sources     # 路径与字段来源，不包含环境值
 ```
 
+`sources["fields"]` 使用 JSON Pointer 作为字段键，例如 `/parallel`、`/ssh/known_hosts`。字面键 `a.b` 对应 `/a.b`，嵌套 `a → b` 对应 `/a/b`；键内 `/` 编为 `~1`、`~` 编为 `~0`。数组作为整体字段记录来源。宿主的 `path_fields` 声明语法不变，来源索引不保留点分键别名。
+
 默认依次搜索 `/etc/<namespace>`、`/usr/local/etc/<namespace>`、`$XDG_CONFIG_HOME/<namespace>`（否则 `~/.config/<namespace>`）、入口目录和启动目录。每层读取 `<namespace>.yml` 与 `<name>.yml`，显式文件最后。共享文件按 `common` 和工具名称分区；name 与 namespace 相同时使用普通独立文件。`directories:` 可以完整替换搜索范围。
 
 宿主把各层公共环境值转换成领域字段后，通过 `Configuration.merge(defaults, dotenv_values, yaml, process_values, cli)` 实现 CLI > 进程环境 > YAML > .env > 默认值。数组整层替换，false/nil 保留。相对路径按来源目录解释；支持 `path_literals:`（如 `system`）和 URI。`load` 重复调用不重新读文件。
@@ -73,7 +75,7 @@ Options 协作者沿用现有入口协议：`informational?`、`validate_interac
 bundle install
 bundle exec rake
 bundle exec rake build
-ruby script/verify_package.rb pkg/ctx_cli-0.2.0.gem
+ruby script/verify_package.rb pkg/ctx_cli-0.3.0.gem
 ```
 
 默认任务包括 RSpec、RuboCop 和离线示例。安装验证在独立 GEM_HOME/GEM_PATH 下运行普通与最小 Bundler 应用，检查实际加载来源。CI 参照 ctx_parser 的固定 action 提交和候选制品校验；发布需另行明确授权。

data/docs/migration.md

@@ -17,4 +17,10 @@ ctx_cli 初始版本为 0.1.0。首次发布依赖顺序先 ctx_cli，再 net-co
 - `CtxCli::Initialization` / `ctx_cli/initialization` 改为 `CtxCli::Initializer` / `ctx_cli/initializer`，仅负责模板安全发布。
 - `CtxCli::Application` / `ctx_cli/application` 改为 `CtxCli::Router` / `ctx_cli/router`，仅负责全局信息和子命令分发。
 
-旧常量和 require 路径不保留别名。宿主需同步修改引用，并将 ctx_cli 依赖更新为 `~> 0.2.0`。`create`、`existing?`、`run` 的结果约定不变；初始化参数询问和厂商语义不迁入这两个对象。0.2.0 当前为本地候选，尚未发布。
+旧常量和 require 路径不保留别名。宿主需同步修改引用，并在应用锁文件中选择包含新接口的 ctx_cli 版本。`create`、`existing?`、`run` 的结果约定不变；初始化参数询问和厂商语义不迁入这两个对象。这些名称从 0.2.0 起使用。
+
+## 0.3.0 配置来源字段
+
+`Configuration#sources["fields"]` 的键统一使用 [JSON Pointer](https://www.rfc-editor.org/rfc/rfc6901)：`parallel` 改为 `/parallel`，`ssh.port` 的嵌套路径改为 `/ssh/port`。字面键 `ssh.port` 则为 `/ssh.port`，两者拥有独立来源。空键为 `/`；每段中的 `~` 编为 `~0`，`/` 编为 `~1`，不作 Unicode 归一化。
+
+来源值仍是 YAML 文件路径；数组整体替换，来源记在数组字段上。空映射合并不覆盖既有非空映射的来源。宿主透传的 `--show-config` 同步采用此结构；外部来源索引调用方须迁移键查找，不提供点分键回退或格式开关。`path_fields` 仍是宿主声明哪些字段要解析为文件路径的独立语法。

data/docs/superpowers/plans/2026-10-24-configuration-source-paths.md

@@ -0,0 +1,46 @@
+# Configuration Source Paths Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Give every merged configuration field an unambiguous source identity.
+
+**Architecture:** Configuration emits JSON Pointer keys in sources.fields. Existing hosts forward the source map unchanged; their tests and documentation migrate together. No new abstraction or alternate format.
+
+**Tech Stack:** Ruby, YAML, RSpec/Minitest, Bundler.
+
+**Spec:** `docs/superpowers/specs/2026-10-24-configuration-source-paths.md`
+
+## Global Constraints
+
+- Ruby >= 3.4; no dependency or version-policy change.
+- lib method comments Chinese; business literals English.
+- Preserve WIP, no commit/push/release.
+- Preserve merge semantics, source-relative paths and domain ownership.
+- JSON Pointer applies to sources.fields only; no dot-path aliases.
+
+## Review Focus
+
+- Literal dots/slashes cannot collide with nesting.
+- Tilde escape order preserves literal ~1 and ~0.
+- Empty keys and Unicode keys retain exact identity without normalization.
+- Replacing a parent removes only its actual descendant sources.
+- Arrays and empty mappings keep their existing merge/source semantics.
+
+### Task 1: Replace ambiguous source keys and migrate consumers
+
+**Files:**
+- Modify ctx_cli: `lib/ctx_cli/configuration.rb`, `spec/configuration_spec.rb`, `README.md`, `docs/migration.md`, `CHANGELOG.md`.
+- Create ctx_cli: this plan and its spec.
+- Modify VXLAN: `spec/cli/configuration_sources_spec.rb`.
+- Modify Wireless: `spec/cli/options_spec.rb`.
+- Modify net-connector: `test/config_test.rb`, `test/cli_setup_test.rb`.
+
+**Interfaces:**
+- Consumes: validated string-keyed YAML mappings and previous merged mapping.
+- Produces: `Configuration#sources["fields"]` mapping from JSON Pointer to file path, deeply frozen; examples `/parallel`, `/ssh/port`, `/a.b`, `/a~1b`, `/m~0n`, `/`.
+
+- [x] **Step 1:** Add real layered-YAML regressions for colliding literal and nested keys, parent replacement, escaped tokens, empty/Unicode keys, arrays and nil/false. Migrate existing source expectations to pointer keys.
+- [x] **Step 2:** Run `bundle exec rspec spec/configuration_spec.rb`; expect RED from dot-path collisions or missing pointer keys.
+- [x] **Step 3:** Change `record_fields` prefix construction to escaped slash tokens and descendant removal to slash-separated prefixes. Keep all merge and ownership logic. Update consumer source-key assertions and docs; no compatibility branch.
+- [x] **Step 4:** Run ctx_cli default rake, consumer targeted tests and complete gates in isolated worktrees. Run the existing three-size benchmark before/after; verify same configuration/source counts. Expect green gates and no return to quadratic leaf scans.
+- [x] **Step 5:** One independent final review. Guard-copy only listed files into actual checkouts, validate ordinary consumer gates using exact installed CLI candidate, and run plain/Bundler installed source/preview probes. Compare all package metadata/source bytes. Keep uncommitted work and evidence; mark all steps only with passing receipts.

data/docs/superpowers/specs/2026-10-24-configuration-source-paths.md

@@ -0,0 +1,27 @@
+# Configuration 来源身份
+
+## 问题与选择
+
+Configuration 合并结果允许任意字符串键，但来源索引把层级拼为点分字符串。字面键 `a.b` 和嵌套 `a → b` 共享索引；用标量替换映射 `a` 时，前缀删除还会误删字面键的来源。这使 `--show-config` 的来源与实际配置不一致。
+
+使用 [RFC 6901](https://www.rfc-editor.org/rfc/rfc6901) JSON Pointer 表达 `sources["fields"]` 的键。每层以 `/` 分隔；token 内 `~` 编为 `~0`，`/` 编为 `~1`。字面点不转义，空键使用 `/`。只生成指针，不增加求值器或依赖。来源值仍为文件路径，不含配置值。
+
+拒绝含点的合法键会人为限制宿主数据；自定义点转义会新增不必要的语法。采用标准指针统一迁移，不保留点分别名或旧格式选择。
+
+## 不变量与职责
+
+- 合并、来源相对路径、数组替换、false/nil/缺失、空映射合并语义保持不变。
+- 来源索引的叶子/祖先替换必须与实际合并一致；兄弟字面键不能被前缀删除。
+- 数组是整体替换值，在数组字段指针上记录来源，不逐元素建表；空映射作为值时也记录其字段。
+- `path_fields` 是宿主声明路径字段的既有语法，和来源输出不同，不在此阶段改变。
+- 库保持 Ruby >= 3.4，不依赖 Runner/Parser/connector；lib 方法说明中文、业务字面量英文。
+- VXLAN/Wireless/connector 仍透传来源结构；其领域校验、命令、状态与资源所有权不迁移。
+- 保留所有既有 WIP 和当前依赖政策，不提交、推送或发布。
+
+## 范围
+
+11 个文件：ctx_cli 的 configuration.rb、configuration_spec.rb、README、migration、Changelog、本规格及计划；VXLAN/Wireless 各一个参数来源测试；connector 的 config_test 和 cli_setup_test。没有新增配置项或生产适配器。
+
+## 验收
+
+回归从真实 YAML 层证明字面点与层级不同、slash/tilde/空键/Unicode 不碰撞、替换映射只删除真正后代、数组整体替换、冻结及不含秘密值。先观察旧实现失败，再修改来源键构造与后代前缀。迁移消费端断言后运行四模块 gates、实际入口和精确候选普通/Bundler 安装。使用既有 500/1000/3000 字段基准检查规模趋势，不为共享主机设硬性能阈值。一次独立审查，无双格式接口。

data/lib/ctx_cli/collection.rb

@@ -33,13 +33,13 @@ module CtxCli
       return 0 if @options.missing?(input: @input, error: @error)
       @options.load
       @progress = @progress_factory.call(@options)
-      @progress.notice("配置：#{@options.config}")
+      @progress.notice("Configuration: #{@options.config}")
       return output(@options.public_values.merge("sources" => @options.sources)) if @options.flags[:show_config]
       @devices, @inventory_total = @adapter.inventory(@options, progress: @progress)
       devices = @devices
       return output(devices) if @options.flags[:inventory_only]
       if devices.empty?
-        @progress.notice("没有匹配设备，未建立连接")
+        @progress.notice("No devices matched; no connections opened")
         @output.json({ status: :no_devices, total: 0 }, pretty: false) if @options.flags[:json]
         return 1
       end
@@ -47,7 +47,7 @@ module CtxCli
       @store = @adapter.report(@options)
       @batch = @batch_class.new(report: @store, progress: @progress, requested: devices)
       outcome = @batch.run(present: ->(summary) { @output.json(summary) if @options.flags[:json] }) do
-        @progress.plan(devices: devices, total: @inventory_total, parallel: @options.values.fetch("parallel"), label: "#{@label} 只读采集")
+        @progress.plan(devices: devices, total: @inventory_total, parallel: @options.values.fetch("parallel"), label: "#{@label} read-only collection")
         @progress.with_updates do
           @adapter.execute(devices, @options) do |device|
             @batch.collect(device) { @adapter.collect(device, @options, context: context, progress: @progress) }
@@ -57,19 +57,19 @@ module CtxCli
       end
       completion(outcome)
     rescue Interrupt
-      diagnostic "采集已取消，已保存的设备报告保留；未保存结果见报告状态"
+      diagnostic "Collection cancelled; saved device reports retained; check report status for unsaved results"
       130
     rescue SystemCallError, IOError => error
-      diagnostic "#{@label} 参数或报告错误：#{report_diagnostic(error)}"
+      diagnostic "#{@label} argument or report error: #{report_diagnostic(error)}"
       2
     rescue Error, Configuration::Error => error
-      diagnostic "#{@label} 参数、依赖或报告错误：#{error.message}；使用 --help 查看参数"
+      diagnostic "#{@label} argument, dependency or report error: #{error.message}; use --help for options"
       2
     rescue OptionParser::ParseError, ArgumentError, LoadError => error
-      diagnostic "#{@label} 参数、依赖或报告错误：#{error.class.name}；使用 --help 查看参数"
+      diagnostic "#{@label} argument, dependency or report error: #{error.class.name}; use --help for options"
       2
     rescue StandardError => error
-      diagnostic "#{@label} 清单或执行失败：#{@failure_code.call(error)}（#{error.class.name}）"
+      diagnostic "#{@label} inventory or execution failed: #{@failure_code.call(error)} (#{error.class.name})"
       2
     end
 
@@ -82,18 +82,18 @@ module CtxCli
     # Runner 决定批次结论；CLI 仅呈现安全诊断并映射退出码。
     def completion(outcome)
       if outcome.finalization_error
-        diagnostic "#{@label} 摘要报告错误：#{outcome.finalization_error}"
+        diagnostic "#{@label} summary report error: #{outcome.finalization_error}"
       end
       if outcome.recovery_failed
-        diagnostic "摘要恢复未确认；请依据退出码及报告目录检查，不能将旧摘要视为本次成功。"
+        diagnostic "Summary recovery is unconfirmed; check the exit code and report directory. An earlier summary does not confirm this run succeeded."
       end
       if outcome.status == :interrupted
-        diagnostic "采集已取消，已保存的设备报告保留；未保存结果见报告状态"
+        diagnostic "Collection cancelled; saved device reports retained; check report status for unsaved results"
       elsif (failure = outcome.failure)
         if failure[:kind] == :report
-          diagnostic "#{@label} 参数或报告错误：#{failure[:detail]}"
+          diagnostic "#{@label} argument or report error: #{failure[:detail]}"
         else
-          diagnostic "#{@label} 清单或执行失败：#{failure[:error_type]}；已采集结果见批次报告"
+          diagnostic "#{@label} inventory or execution failed: #{failure[:error_type]}; see the batch report for collected results"
         end
       end
       { complete: 0, incomplete: 1, failed: 2, interrupted: 130 }.fetch(outcome.status)
@@ -115,7 +115,7 @@ module CtxCli
         @output.json(value)
       else
         value.each { |device| @out.puts "#{device.fetch('host')}\t#{device.fetch('name')}\t#{device['model']}" }
-        @out.puts "设备：#{value.size} 台；未建立设备连接"
+        @out.puts "Devices: #{value.size}; no device connections opened"
       end
       value.is_a?(Array) && value.empty? ? 1 : 0
     end

data/lib/ctx_cli/command.rb

@@ -18,7 +18,7 @@ module CtxCli
       @parser.banner = @banner
       @configure&.call(@parser, @values)
       rest = @parser.parse(argv.dup)
-      raise ArgumentError, "不接受位置参数" unless rest.empty?
+      raise ArgumentError, "Positional arguments are not accepted" unless rest.empty?
       @values
     end
 

data/lib/ctx_cli/configuration.rb

@@ -341,9 +341,10 @@ module CtxCli
       self.class.merge(previous, resolved)
     end
 
-    def record_fields(document, source, fields, prefix = nil, previous: {})
+    # 用 JSON Pointer 区分字面键与层级，只移除被替换映射的真正后代来源。
+    def record_fields(document, source, fields, prefix = "", previous: {})
       document.each do |key, value|
-        name = [ prefix, key ].compact.join(".")
+        name = "#{prefix}/#{key.gsub("~", "~0").gsub("/", "~1")}"
         before = previous.is_a?(Hash) ? previous[key] : nil
         next if value.is_a?(Hash) && value.empty? && before.is_a?(Hash) && !before.empty?
 
@@ -353,7 +354,7 @@ module CtxCli
         else
           # 只有旧映射被整体替换才需要删除后代；新增/覆盖叶子直接赋值。
           if before.is_a?(Hash) && !before.empty?
-            descendant_prefix = "#{name}."
+            descendant_prefix = "#{name}/"
             fields.delete_if { |field, _| field.start_with?(descendant_prefix) }
           end
           fields[name] = source

data/lib/ctx_cli/options.rb

@@ -4,34 +4,34 @@ module CtxCli
   # 普通参数分组只登记语法；不加载配置、不执行操作、不拥有领域校验。
   module Options
     def self.initialization(parser, values)
-      parser.on("--init", "创建缺失配置和环境模板后退出；已有文件不覆盖") { values[:init] = true }
-      parser.on("--interactive", "缺少配置时询问是否创建；要求真实终端") { values[:interactive] = true }
-      parser.on("--non-interactive", "禁用问答；创建文件须同时指定 --init") { values[:interactive] = false }
+      parser.on("--init", "Create missing configuration and environment templates, then exit; preserve existing files") { values[:init] = true }
+      parser.on("--interactive", "Prompt to create missing configuration; requires an interactive terminal") { values[:interactive] = true }
+      parser.on("--non-interactive", "Disable prompts; specify --init to create files") { values[:interactive] = false }
     end
 
     def self.output(parser, values, quiet: :quiet)
-      parser.on("--json", "stdout 输出 JSON；默认显示可读摘要") { values[:json] = true }
-      parser.on("--quiet", "--no-progress", "关闭 stderr 进度，可配合 --json") { values[quiet] = true }
-      parser.on("--verbose", "显示逐台结果及安全命令事件") { values[:verbose] = true }
+      parser.on("--json", "Write JSON to stdout; defaults to a readable summary") { values[:json] = true }
+      parser.on("--quiet", "--no-progress", "Disable progress on stderr; can be combined with --json") { values[quiet] = true }
+      parser.on("--verbose", "Show per-device results and safe command events") { values[:verbose] = true }
     end
 
     def self.information(parser, values)
-      parser.on("-h", "--help", "查看选项帮助") { values[:help] = true }
-      parser.on("--help-all", "查看全部选项、路径与环境约定") { values[:help_all] = true }
-      parser.on("--examples", "查看常用命令范例，不执行任务") { values[:examples] = true }
+      parser.on("-h", "--help", "Show option help") { values[:help] = true }
+      parser.on("--help-all", "Show all options, paths and environment conventions") { values[:help_all] = true }
+      parser.on("--examples", "Show common command examples without executing tasks") { values[:examples] = true }
     end
 
     # 值转换留在宿主边界，允许不同入口沿用原有存储格式。
-    def self.configuration(parser, parallel_help: "设备并发数", &store)
-      parser.on("--config FILE", "显式 YAML 最后叠加于自动发现的配置") { |value| store.call(:config, value) }
-      parser.on("--env-file FILE", "显式环境文件最后叠加；进程环境优先") { |value| store.call(:env_file, value) }
+    def self.configuration(parser, parallel_help: "Device concurrency", &store)
+      parser.on("--config FILE", "Overlay explicit YAML after automatically discovered configuration") { |value| store.call(:config, value) }
+      parser.on("--env-file FILE", "Load explicit environment files last; process environment takes precedence") { |value| store.call(:env_file, value) }
       parser.on("-p", "--parallel N", Integer, parallel_help) { |value| store.call(:parallel, value) }
-      parser.on("--directory DIR", "按设备保存报告的目录") { |value| store.call(:directory, value) }
+      parser.on("--directory DIR", "Directory for per-device reports") { |value| store.call(:directory, value) }
     end
 
     def self.list(value)
       values = value.split(",", -1).map(&:strip)
-      raise ArgumentError, "列表不能有空项" if values.any?(&:empty?)
+      raise ArgumentError, "Lists must not contain empty entries" if values.any?(&:empty?)
       values
     end
   end

data/lib/ctx_cli/output.rb

@@ -14,7 +14,7 @@ module CtxCli
 
     # 最后的错误流失败不能覆盖原本的失败或取消状态。
     def diagnostic(message, exception: nil)
-      @error.puts(exception ? "#{message}（#{exception.class.name}）" : message)
+      @error.puts(exception ? "#{message} (#{exception.class.name})" : message)
     rescue StandardError
       nil
     end

data/lib/ctx_cli/review.rb

@@ -23,10 +23,10 @@ module CtxCli
     def run(argv)
       options = @command.parse(argv)
       return 0 if @command.informational?
-      raise ArgumentError, "需要批次目录" unless options[:batch]
+      raise ArgumentError, "A batch directory is required" unless options[:batch]
       batch = File.expand_path(options[:batch])
       paths = source_paths(File.join(batch, @directory))
-      raise ArgumentError, "无设备报告" if paths.empty?
+      raise ArgumentError, "No device reports found" if paths.empty?
       remaining = @max_total_bytes
       sources = paths.map do |path|
         raise ArgumentError, "review byte budget exceeded" unless remaining.positive?
@@ -38,10 +38,10 @@ module CtxCli
       @output.text(@adapter.publish(sources, options, batch: batch, context: context))
       0
     rescue Interrupt
-      @output.diagnostic("建议生成已取消；已有报告保留，未执行设备变更。")
+      @output.diagnostic("Review cancelled; existing reports retained; no device changes executed.")
       130
     rescue StandardError => error
-      @output.diagnostic("建议生成失败（#{error.class.name}）；请检查输入结构、目录权限和 --help；未执行设备变更。")
+      @output.diagnostic("Review failed (#{error.class.name}); check the input structure, directory permissions and --help; no device changes executed.")
       2
     end
 

data/lib/ctx_cli/router.rb

@@ -21,7 +21,7 @@ module CtxCli
         return 0
       end
       return @commands.fetch(command).call(arguments) if @commands.key?(command)
-      @error.puts "未知命令或多余参数；使用 #{@name} --help 查看用法"
+      @error.puts "Unknown command or extra arguments; use #{@name} --help for usage"
       2
     end
   end

data/lib/ctx_cli/terminal.rb

@@ -10,7 +10,7 @@ module CtxCli
     def self.tty?(*streams) = streams.all? { |stream| stream.respond_to?(:tty?) && stream.tty? }
     def tty?(*others) = self.class.tty?(@input, @out, *others)
 
-    def require_tty!(*others, message: "必须使用真实交互终端")
+    def require_tty!(*others, message: "An interactive terminal is required")
       raise ArgumentError, message unless tty?(*others)
     end
 
@@ -26,13 +26,13 @@ module CtxCli
     end
 
     def password(label:)
-      raise ArgumentError, "密码提示需要交互终端；自动化任务可使用环境变量或 --stdin-credentials" unless self.class.tty?(@input)
+      raise ArgumentError, "Password prompts require an interactive terminal; use environment variables or --stdin-credentials for automation" unless self.class.tty?(@input)
       require "io/console"
-      @out.print "#{label}："
+      @out.print "#{label}: "
       @out.flush
       value = @input.noecho { |terminal| terminal.gets("\n") }&.chomp("\n")
       @out.puts
-      raise ArgumentError, "密码不能为空" if value.nil? || value.empty?
+      raise ArgumentError, "Password must not be empty" if value.nil? || value.empty?
       value
     end
   end

data/lib/ctx_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CtxCli
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ctx_cli
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Gatework contributors
@@ -15,20 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: fileutils
   requirement: !ruby/object:Gem::Requirement
@@ -123,6 +117,8 @@ files:
 - LICENSE
 - README.md
 - docs/migration.md
+- docs/superpowers/plans/2026-10-24-configuration-source-paths.md
+- docs/superpowers/specs/2026-10-24-configuration-source-paths.md
 - examples/configuration.rb
 - examples/offline.rb
 - lib/ctx_cli.rb