ctx_checker 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71962914e6b52e83b27e6c79345530ef9e92fb4168175a43e6cc46f464abc8f4
-  data.tar.gz: e1e3adf05ec7d615920b49d65734e44cd3df35ba5efff584f11b5d0b5273df22
+  metadata.gz: 5439af7466ca88a19bb7e41cacb918eb78e73d8ae84b2390a060dfa75d5aba4a
+  data.tar.gz: b016023aac35315ea418c880a5b1feb29e277791702351feed6115e8eaaf0cd8
 SHA512:
-  metadata.gz: 270d9b5bf20181cfc30f89dbe9b069ae5ac3499ab57efc726c991be5e2fe3f633156de1e8e51d612b7719be1981d74e89c26334fb546fbe19262f6290d759871
-  data.tar.gz: 124f1e9f0609e3a46e382305ffd23768096b272868e852ffd1a25da317ae58defefac2ec1bfb6200fc94b381f1bb0bf594e69baf4d7db286731043c722ddb49e
+  metadata.gz: e087da6d36474f725cc0626762f79bdfd8b22fb28800fbb4fb98ce461ced95d6f8c72383e33be627c8ea513fe6ac988a0448d4a54ef6a1c6352ba11f2f673b91
+  data.tar.gz: bfa74421c286aefad66d9c7f2266367c79f2b6b006198b4ee461569f8ec4226b14046aeb7f8137872c38cafebe3187f35b7828c1c027b456a061430a7c9867be

data/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 Changes to the public contract are recorded here. Versions follow Semantic Versioning.
 
+## 0.2.3 (2026-10-18)
+
+- Clear Bundler bootstrap variables when verifying packages in an isolated gem installation, including calls made through bundle exec.
+
+- Index protocol coverage and conflicting scopes by field sets, preserving wildcard identities and OSPF interface scopes without quadratic scans.
+
+## 0.2.2 (2026-10-18)
+
+- Snapshot validated collection targets and dimensions before caller callbacks can alter them.
+- Require lifecycle connectors to provide exactly one session, preventing silent empty collections and repeated queries.
+- Reject unrequested observations as command fragments rather than upgrading them to complete evidence.
+
+- Exercise the current optional net-connector API and share protocol receipts across custom-session tests without tying generic fixtures to connector result internals.
+
+- Preserve proven aggregation capacity lower bounds in partial observations while retaining unknown overall coverage.
+- Parse vendor lines and reconstruct H3C counters independently of Ruby's global record and output separators.
+- Require valid dates and explicit UTC offsets in snapshot and command evidence timestamps, consistent with record timestamps.
+- Count only complete member sources when proving aggregation capacity; incomplete sources cannot prove a capacity shortage.
+- Index command diagnostics once per observation when constructing reports, avoiding repeated scans for expanded port queries.
+- Add a synthetic report construction benchmark for 64, 256, and 512 failed queries.
+
 ## 0.2.1 (2026-10-17)
 
 - Validate time-limit snapshot compatibility during policy construction; reject unsupported Numeric objects before evaluation while preserving exact Rational values.

data/README-zh.md

@@ -59,10 +59,14 @@ puts report.to_text
 
 观察完整性 `complete/partial/failed/unsupported/not_requested/not_applicable` 与业务结论 `pass/fail/unknown/not_applicable` 分开。空回显不能独自证明健康或功能未配置。可信配置可证明可选 BGP、OSPF 或聚合检查不适用，必检策略仍优先。
 
+快照字符串、命令证据和记录中的采样时间必须使用有效日期及明确的 `Z` 或 UTC 偏移；快照也接受 `Time` 对象。聚合容量仅计入有完整来源证据的成员，不完整成员不能证明容量充足，也不能证明容量不足。
+
 error、CRC、discard 保持独立，不相加；单次累计值不能当作当前错误速率。增量要求身份一致、时间递增及可靠连续性证据。光功率需要设备或策略阈值；已有格式支持不代表所有型号/版本都已验证。
 
 `Collector#collect` 接收负责会话生命周期的 connector；`collect_session` 借用已有会话。本 gem 不包含 Rails、库存数据库、调度或凭据。指标语义见[计数契约](COUNTER_CONTRACT.md)。
 
+采集会在调用时钟或连接器前固定已校验的目标与所选维度。生命周期连接器的 `open` 必须恰好提供一次会话；未提供或提供两次均抛出 `ArgumentError`，第二次回调不会重复执行查询。合并命令结果时不接受 `not_requested` 观察片段。
+
 详细厂商语义、历史验证记录和 Motor 专用集成说明保留在[架构参考](docs/architecture-zh.md)。其中宿主集成代码需要 Motor，不属于独立 gem API。适配层位于 [Motor 仓库](https://github.com/gatework/motor/tree/main/backend/lib) 的 `backend/lib/baseline`、`backend/lib/vxlan` 和 `backend/lib/wireless`。
 
 生命周期 connector 是宿主适配器，提供 `open { |session| }`，VXLAN 和 Wireless 还要求 `platform`；原生 `Net::Connector::Base` 实例并不提供这一宿主生命周期协议。已连接的原生会话可传入 `CtxDriver::Reader` 或 `CtxChecker::Collector#collect_session`，不会隐式连接或重试。
@@ -75,6 +79,8 @@ error、CRC、discard 保持独立，不相加；单次累计值不能当作当
 
 ## 开发与测试
 
+原生 net-connector 0.13 集成测试要求 ctx_driver 0.2.2 或更新版本。通用借用会话夹具直接实现回执协议，不依赖连接器的结果类。
+
 共享类按实际职责命名，平台信息放在命名空间中。直接对应设备命令的解析器保留文件名和类名。
 
 ```sh
@@ -86,7 +92,7 @@ bundle exec rake build
 
 `bundle exec rake` 执行 RSpec、RuboCop 及离线示例。测试放在 `spec/`，沿用项目 RSpec 约定；样例采用合成或脱敏证据。新增解析格式时补充成功、不完整、不支持及非法输入回归。离线测试不代表所有设备版本均通过实机验证。
 
-运行 `ruby script/verify_package.rb /path/to/ctx_checker.gem`，验证使用已发布依赖的隔离安装。联动开发时可追加明确构建的依赖包路径，例如 `/path/to/ctx_parser.gem`，先安装这些候选包；候选包验证通过不代表注册表中的依赖已兼容。`bundle exec ruby -Ilib benchmark/runtime.rb` 用合成输入测量本地命令查找和诊断开销。
+运行 `ruby script/verify_package.rb /path/to/ctx_checker.gem`，验证使用已发布依赖的隔离安装。联动开发时可追加明确构建的依赖包路径，例如 `/path/to/ctx_parser.gem`，先安装这些候选包；候选包验证通过不代表注册表中的依赖已兼容。`bundle exec ruby -Ilib benchmark/runtime.rb` 用合成输入测量本地命令查找和诊断开销。`bundle exec ruby benchmark/report.rb` 测量 64、256、512 条失败查询的报告构建开销，不含网络和解析时间。
 
 使用声明的最低 Ruby 版本检查兼容性。方法用途统一使用简明中文注释；复杂实现还需说明业务规则、实现思路及关键分支。保持公开返回值与错误契约。真实回显和凭据不可进入示例、fixture、日志或发布包。
 

data/README.md

@@ -59,10 +59,14 @@ puts report.to_text
 
 Observation completeness (`complete`, `partial`, `failed`, `unsupported`, `not_requested`, `not_applicable`) is separate from findings (`pass`, `fail`, `unknown`, `not_applicable`). Empty output alone cannot prove a healthy or unconfigured feature. Confirmed configuration can establish that optional BGP, OSPF, or aggregation checks do not apply; required policy still takes precedence.
 
+Sampling timestamps in snapshot strings, command evidence, and records require a valid ISO8601 date with an explicit `Z` or UTC offset. Snapshots also accept `Time` objects. Aggregation capacity counts only members supported by complete source evidence; incomplete members cannot establish either sufficient capacity or a shortage.
+
 Errors, CRC, and discards are distinct counters and must not be summed. A single cumulative value is not a current error rate. Delta analysis needs matching identities, increasing timestamps, and reliable continuity evidence. Optics need device or policy thresholds; supported command formats do not guarantee every model/version is covered.
 
 `Collector#collect` accepts an injected connector that owns its session lifecycle; `collect_session` borrows an existing session. No Rails, inventory database, scheduler, or credentials are included. See the [counter contract](COUNTER_CONTRACT.md) for metric semantics.
 
+Collection snapshots the validated target and selected dimensions before calling the clock or connector. A lifecycle connector must yield exactly one session from `open`; yielding none or twice raises `ArgumentError`, and a second yield never repeats queries. Unrequested observations are not accepted as command fragments during combination.
+
 Detailed vendor behavior, historical validation notes, and Motor-only integration are preserved in [the architecture reference](docs/architecture-zh.md). Host integration examples in that reference require Motor; they are not standalone gem APIs. Motor adapters live under `backend/lib/baseline`, `backend/lib/vxlan`, and `backend/lib/wireless` in the [Motor repository](https://github.com/gatework/motor/tree/main/backend/lib).
 
 The lifecycle connector is a host adapter exposing `open { |session| }` (and `platform` for VXLAN and Wireless). It is distinct from a native `Net::Connector::Base` device instance. Borrowed native sessions are accepted by `CtxDriver::Reader` and `CtxChecker::Collector#collect_session`; they are never implicitly connected or retried.
@@ -75,6 +79,8 @@ Integer OSPF process IDs are normalized to strings in policies, observations, an
 
 ## Development and tests
 
+Native net-connector 0.13 integration tests require ctx_driver 0.2.2 or newer. Generic borrowed-session fixtures implement the response protocol directly and remain independent of connector result classes.
+
 Name shared classes by their responsibility and use the namespace for platform context. Preserve filenames and class names that directly match device commands.
 
 ```sh
@@ -86,7 +92,7 @@ bundle exec rake build
 
 `bundle exec rake` runs RSpec, RuboCop, and the offline examples. Tests live in `spec/`, following the existing project's RSpec convention; fixtures use synthetic or sanitized evidence. Add regression cases for successful, incomplete, unsupported, and malformed inputs when extending a parser. Offline tests do not certify all device versions or replace live integration checks.
 
-Run `ruby script/verify_package.rb /path/to/ctx_checker.gem` to verify an isolated installation with published dependencies. During coordinated development, append explicitly built dependency artifacts, such as `/path/to/ctx_parser.gem`, to install those candidates first. Candidate verification does not establish that the published dependencies are compatible. `bundle exec ruby -Ilib benchmark/runtime.rb` measures synthetic command lookup and diagnostic overhead locally.
+Run `ruby script/verify_package.rb /path/to/ctx_checker.gem` to verify an isolated installation with published dependencies. During coordinated development, append explicitly built dependency artifacts, such as `/path/to/ctx_parser.gem`, to install those candidates first. Candidate verification does not establish that the published dependencies are compatible. `bundle exec ruby -Ilib benchmark/runtime.rb` measures synthetic command lookup and diagnostic overhead locally. `bundle exec ruby benchmark/report.rb` measures report construction for 64, 256, and 512 failed queries, excluding network and parsing time.
 
 Use the declared minimum Ruby version for compatibility checks. Document source methods and non-obvious business logic in concise Chinese, preserve public return/error contracts, and never add raw device captures or credentials to examples, fixtures, logs, or release archives.
 

data/lib/ctx_checker/checks/aggregation.rb

@@ -38,8 +38,12 @@ module CtxChecker
         @policy.minimum_active_members.each do |group, minimum|
           group_rows = rows.fetch(group, [])
           members = group_rows.reject { |row| row[:member].nil? }
-          active = members.count { |row| row[:member_status] == :active && row[:oper_status] == :up && !member_down?(row) }
-          known = group_rows.none? { |row| row[:member].nil? } && members.all? { |row| row[:member_status] && row[:member_status] != :unknown && %i[up down].include?(row[:oper_status]) }
+          # 容量下界只计入完整来源；不完整成员也不能证明容量不足。
+          active_members = members.select { |row| record_complete?(row, @observation) && row[:member_status] == :active && row[:oper_status] == :up && !member_down?(row) }
+          active = active_members.size
+          known = group_rows.none? { |row| row[:member].nil? } && members.all? do |row|
+            record_complete?(row, @observation) && row[:member_status] && row[:member_status] != :unknown && %i[up down].include?(row[:oper_status])
+          end
           status = if active >= minimum
             :pass
           elsif @observation.complete? && known
@@ -47,7 +51,7 @@ module CtxChecker
           else
             :unknown
           end
-          results << finding(status, :aggregation_capacity, entity: group, actual: active, expected: minimum, severity: :critical)
+          results << finding(status, :aggregation_capacity, entity: group, actual: active, expected: minimum, severity: :critical, sources: active_members)
         end
         results
       end

data/lib/ctx_checker/checks/base.rb

@@ -37,8 +37,14 @@ module CtxChecker
       private
 
       # 局部采集仍保留已知故障；判定成功则要求完整的支持证据。
-      def finding(status, reason, entity: nil, actual: nil, expected: nil, severity: :info, suffix: nil)
-        if status == :pass && !record_complete?(@current_record, @observation)
+      def finding(status, reason, entity: nil, actual: nil, expected: nil, severity: :info, suffix: nil, sources: nil)
+        # 跨记录结论必须由非空且全部完整的来源共同支持，不能只依赖维度状态。
+        complete = if sources
+          sources.any? && sources.all? { |record| record_complete?(record, @observation) }
+        else
+          record_complete?(@current_record, @observation)
+        end
+        if status == :pass && !complete
           status, reason = :unknown, :incomplete_evidence
         end
         Finding.new(id: [ @observation.name, suffix || reason ].join("."), dimension: @observation.name,

data/lib/ctx_checker/checks/routing.rb

@@ -57,6 +57,7 @@ module CtxChecker
         identities = {}
         scopes = {}
         incomplete = Hash.new { |hash, keys| hash[keys] = {} }
+        covered = covered_scope_index
         @observation.records.each do |record|
           identities[record.values_at(*fields)] = true
           scopes[record.values_at(*scope)] = true
@@ -67,7 +68,7 @@ module CtxChecker
           next if identities.key?(identity.values_at(*fields))
 
           ambiguous = incomplete.any? { |keys, values| values.key?(identity.values_at(*keys)) }
-          enumerated = @observation.covered_scopes.any? { |entry| entry.all? { |key, value| identity[key] == value } }
+          enumerated = covered.any? { |keys, values| values.key?(identity.values_at(*keys)) }
           scope_observed = scopes.key?(identity.values_at(*scope))
           status = if ambiguous
             :unknown
@@ -81,6 +82,14 @@ module CtxChecker
           finding(status, :expected_peer_missing, entity: identity, severity: :critical)
         end
       end
+
+      # 按字段组合索引覆盖范围；OSPF 的进程级与接口级证明分别匹配。
+      def covered_scope_index
+        @observation.covered_scopes.each_with_object({}) do |entry, index|
+          fields = entry.keys.sort
+          (index[fields] ||= {})[entry.values_at(*fields)] = true
+        end
+      end
     end
   end
 end

data/lib/ctx_checker/cisco_ios/parsers/show_clock_detail.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           records, issues = [], diagnostics
           time_source = nil
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
 

data/lib/ctx_checker/cisco_ios/parsers/show_environment_all.rb

@@ -21,7 +21,7 @@ module CtxChecker
           @temperature = nil
           @sensor_table = false
           @component_table = nil
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || /\A[- ]+\z/.match?(line)
             next if catalyst_line(line) || stack_component_line(line) || sensor_line(line)

data/lib/ctx_checker/cisco_ios/parsers/show_etherchannel_summary.rb

@@ -20,7 +20,7 @@ module CtxChecker
           text = clean(text)
           rows, issues, groups, totals = [], diagnostics, [], []
           current, header, empty = nil, false, false
-          text.each_line.with_index(1) do |source, number|
+          text.each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || line.match?(/\A[-=+ ]+\z/)
 

data/lib/ctx_checker/cisco_ios/parsers/show_facility_alarm_status.rb

@@ -12,7 +12,7 @@ module CtxChecker
         # 解析 show facility alarm status，保留不完整或不支持的证据。
         def parse_output(text, complete:)
           records, issues, totals, severities = [], diagnostics, [], []
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || /\A[- ]+\z/.match?(line) || /\ASource\s+(?:Time\s+)?Severity\s+/.match?(line)
 

data/lib/ctx_checker/cisco_ios/parsers/show_interfaces.rb

@@ -26,7 +26,7 @@ module CtxChecker
           interfaces, counters, state_issues, counter_issues = [], [], diagnostics, diagnostics
           current = nil
           states = {}
-          text.each_line.with_index(1) do |source, number|
+          text.each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
 

data/lib/ctx_checker/cisco_ios/parsers/show_interfaces_transceiver_detail.rb

@@ -18,7 +18,7 @@ module CtxChecker
           text = clean(text)
           rows, issues, ports = [], diagnostics, []
           metric, header, lane_column = nil, false, false
-          text.each_line.with_index(1) do |source, number|
+          text.each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || line.match?(/\A[-= ]+\z/)
 

data/lib/ctx_checker/cisco_ios/parsers/show_ip_bgp_summary.rb

@@ -25,7 +25,7 @@ module CtxChecker
           section = { header: false, empty: false, count: 0, scope_fields: [], scope: scope }
           sections << section
           pending = nil
-          text.each_line.with_index(1) do |source, number|
+          text.each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || line.match?(/\A[-= ]+\z/)
 

data/lib/ctx_checker/cisco_ios/parsers/show_ip_ospf_neighbor.rb

@@ -24,7 +24,7 @@ module CtxChecker
           sections = []
           section = { header: false, empty: false, count: 0, totals: [], declared: false, scope: scope }
           sections << section
-          text.each_line.with_index(1) do |source, number|
+          text.each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || line.match?(/\A[-= ]+\z/)
 

data/lib/ctx_checker/cisco_ios/parsers/show_ip_traffic.rb

@@ -31,7 +31,7 @@ module CtxChecker
           records, issues = [], diagnostics
           active = false
           recognized = false
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
             if line == "IP statistics:"

data/lib/ctx_checker/cisco_ios/parsers/show_memory_statistics.rb

@@ -12,7 +12,7 @@ module CtxChecker
         # 解析 show memory statistics，保留不完整或不支持的证据。
         def parse_output(text, complete:)
           records, issues = [], diagnostics
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || /\AHead\s+Total\(b\)/.match?(line) || /\ATracekey\s*:\s*[\da-f#]+\z/i.match?(line)
 

data/lib/ctx_checker/cisco_ios/parsers/show_ntp_status.rb

@@ -16,7 +16,7 @@ module CtxChecker
         # 解析 show ntp status，保留不完整或不支持的证据。
         def parse_output(text, complete:)
           records, issues = [], diagnostics
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
 

data/lib/ctx_checker/cisco_ios/parsers/show_processes_cpu.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           records, issues = [], diagnostics
           recognized = false
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
 

data/lib/ctx_checker/cisco_nxos/parsers/show_environment.rb

@@ -22,7 +22,7 @@ module CtxChecker
           @section = nil
           @section_size = 0
           @power_columns = nil
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
             next if section_line(line) || header_line(line)

data/lib/ctx_checker/cisco_nxos/parsers/show_interface_transceiver_details.rb

@@ -18,7 +18,7 @@ module CtxChecker
           text = clean(text)
           rows, issues, devices = [], diagnostics, []
           current, lane, header, lane_valid = nil, nil, false, true
-          text.each_line.with_index(1) do |source, number|
+          text.each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty? || line.match?(/\A[-= ]+\z/)
 

data/lib/ctx_checker/cisco_nxos/parsers/show_ip_traffic.rb

@@ -57,7 +57,7 @@ module CtxChecker
           section = nil
           fragment_sections, acl_sections = 0, 0
           ipv4 = false
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
             if /\AIP Software Processed Traffic Statistics\z/i.match?(line)

data/lib/ctx_checker/cisco_nxos/parsers/show_ntp_peer_status.rb

@@ -81,7 +81,7 @@ module CtxChecker
         # 仅拼接文档明确的续行；未完成的记录不能吞并新的作用域。
         def each_ntp_line(source, issues)
           pending = nil
-          source.each_line.with_index(1) do |raw, number|
+          source.each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             next if line.empty?
 

data/lib/ctx_checker/cisco_nxos/parsers/show_system_resources.rb

@@ -19,7 +19,7 @@ module CtxChecker
           caches, statuses = [], []
           kernel_cache = {}
           duplicate_cache = false
-          clean(text).each_line.with_index(1) do |source, number|
+          clean(text).each_line("\n").with_index(1) do |source, number|
             line = source.strip
             next if line.empty?
 

data/lib/ctx_checker/collector.rb

@@ -19,7 +19,7 @@ module CtxChecker
 
     # 连接的建立与清理由传入连接器的块生命周期管理。
     def collect(target:, connector:, dimensions: DEFAULT_DIMENSIONS, applicability: nil)
-      parser, identity = prepare(target, dimensions)
+      parser, identity, dimensions = prepare(target, dimensions)
       if connector.respond_to?(:platform) && ParserRegistry.canonical(connector.platform) != parser.platform
         raise ArgumentError, "Connector platform differs from the target"
       end
@@ -29,12 +29,17 @@ module CtxChecker
 
       issues = []
       stage = :connect
+      yielded = false
       begin
         connector.open do |session|
+          raise ArgumentError, "Connector must provide one session" if yielded
+
+          yielded = true
           stage = :collect
           collect_into(session, parser, dimensions, observations)
           stage = :close
         end
+        raise ArgumentError, "Connector must provide one session" unless yielded
       rescue StandardError => error
         raise unless CtxDriver::Failure.connection_error?(error, connector)
 
@@ -48,7 +53,7 @@ module CtxChecker
 
     # 借用已打开的 net-connector 会话，不负责建立或关闭连接。
     def collect_session(target:, session:, dimensions: DEFAULT_DIMENSIONS, applicability: nil)
-      parser, identity = prepare(target, dimensions)
+      parser, identity, dimensions = prepare(target, dimensions)
       observations = inapplicable_observations(parser, dimensions, applicability)
       dimensions = dimensions - observations.keys
       collect_into(session, parser, dimensions, observations) if dimensions.any?
@@ -87,13 +92,15 @@ module CtxChecker
     # 发送任何设备命令前，先校验维度选择与目标身份。
     def prepare(target, dimensions)
       RuntimeParser.validate_dimensions!(dimensions)
+      dimensions = dimensions.dup.freeze
       raise ArgumentError, "Target must be a hash" unless target.is_a?(Hash)
+      target = CtxParser::Immutable.copy(target)
 
       parser = RuntimeParser.new(platform: target.fetch(:platform), model: target[:model], software_version: target[:software_version])
       parser.discovery_dimensions(dimensions)
       # 打开连接器前校验身份，避免将输入错误误报为连接故障。
       snapshot = Snapshot.new(target: target.merge(platform: parser.platform), observed_at: @clock.call, observations: {})
-      [ parser, snapshot.target ]
+      [ parser, snapshot.target, dimensions ]
     end
 
     # 采集发现命令及其依赖命令，保留各自独立的失败结果。

data/lib/ctx_checker/h3c/parsers/counters_table.rb

@@ -14,7 +14,7 @@ module CtxChecker
         def parse_counters(text, complete:, metric:)
           source = clean(text)
           rows, sections, section = [], [], nil
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if /\AInterface\s+Total\s*\(pkts?\)\s+Broadcast\s*\(pkts?\)\s+Multicast\s*\(pkts?\)\s+Err\s*\(pkts?\)\z/i.match?(line)
               sections << (section = { count: 0 })

data/lib/ctx_checker/h3c/parsers/display_alarm_active.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, header, empty = [], false, false
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if /\ASeq\s+Level\s+Time\s+Info\z/i.match?(line)
               header = true

data/lib/ctx_checker/h3c/parsers/display_bgp_peer.rb

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           text = clean(text)
           rows, issues, total, header = [], diagnostics, nil, false
-          text.each_line do |raw|
+          text.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\ATotal number of peers:\s*(\d+)\z/i.match(line))
               issues << { code: :duplicate_peer_count } unless total.nil?

data/lib/ctx_checker/h3c/parsers/display_clock.rb

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           timestamps, zones, summer = [], [], false
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\A(\d{1,2}:\d{2}:\d{2}(?:\.\d+)?)\s+(\S+)\s+[A-Za-z]{3}\s+(\d{2})\/(\d{2})\/(\d{4})\z/.match(line))
               timestamps << match.captures

data/lib/ctx_checker/h3c/parsers/display_cpu_usage.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, components, current, table = [], [], nil, nil
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\A((?:Chassis \d+ )?Slot \d+(?: CPU \d+(?: Core \d+)?)?) CPU usage:\z/i.match(line))
               current = scope_name(match[1])

data/lib/ctx_checker/h3c/parsers/display_environment.rb

@@ -18,7 +18,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, chassis, header, auxiliary, contexts, context = [], nil, nil, nil, [], nil
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\AChassis (\d+):\z/i.match(line))
               chassis = "chassis #{match[1]} "

data/lib/ctx_checker/h3c/parsers/display_fan.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, location, current, table, seen, contexts, context, fanless = [], "system", nil, false, {}, [], nil, {}
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\A((?:Chassis \d+ )?Slot \d+|Chassis \d+)\s*:\z/i.match(line))
               location, current, table = scope_name(match[1]), nil, false

data/lib/ctx_checker/h3c/parsers/display_interface.rb

@@ -52,7 +52,7 @@ module CtxChecker
             # Never 或相对时间都不能证明跨重启的计数连续性。
             discontinuity = nil
             section_counters = []
-            counter_source = section.lines.reject { |line| /\A\s*Description:/i.match?(line) }.join
+            counter_source = section.lines("\n").reject { |line| /\A\s*Description:/i.match?(line) }.join("")
             COUNTERS.each do |metric, pattern|
               values = counter_source.scan(pattern).flatten
               if DISCARD_LABELS.key?(metric) && values.size != counter_source.scan(DISCARD_LABELS.fetch(metric)).size
@@ -82,7 +82,7 @@ module CtxChecker
         # 换行 VLAN 列表仅在紧接前一列表时作为元数据处理。
         def known_details?(section)
           vlan_list = false
-          section.lines.drop(1).all? do |raw|
+          section.lines("\n").drop(1).all? do |raw|
             line = raw.strip
             if (match = /\A(?:VLAN (?:Passing|permitted)|(?:Tagged|Untagged)\s+VLAN ID)\s*:\s*(.+)\z/i.match(line))
               vlan_list = valid_vlan_list?(match[1])

data/lib/ctx_checker/h3c/parsers/display_link_aggregation_verbose.rb

@@ -22,7 +22,7 @@ module CtxChecker
             return build_result([], complete: complete, recognized: true, issues: [ { code: :aggregation_not_configured } ])
           end
           rows, issues, group, remote, groups, columns, tables = [], diagnostics, nil, false, {}, nil, []
-          text.each_line do |raw|
+          text.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\AAggregate Interface:\s*(.*)\z/i.match(line))
               group, remote, columns = nil, false, nil

data/lib/ctx_checker/h3c/parsers/display_memory.rb

@@ -20,7 +20,7 @@ module CtxChecker
 
           rows, contexts, sections = [], [], []
           context, scope, unit, columns, current, section = nil, "physical", nil, nil, nil, nil
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if /\A(?:Container memory statistics|Memory statistics|The statistics about memory).*measured in (KB|bytes)(?:\(Available\))?:\z/i.match?(line)
               unit = line.match(/measured in (KB|bytes)/i)[1].casecmp?("KB") ? 1024 : 1
@@ -64,7 +64,7 @@ module CtxChecker
         # 旧交换机仅报告物理内存使用量，不能证明缓存调整后的应用使用量。
         def legacy_memory(source, complete:)
           values, seen = {}, {}
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             next if line.empty?
 

data/lib/ctx_checker/h3c/parsers/display_ntp_service_status.rb

@@ -20,7 +20,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           row, seen, local_sync = { component: "system" }, {}, []
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             next if line.empty?
             key, value = line.split(/:\s*/, 2)

data/lib/ctx_checker/h3c/parsers/display_ospf_peer.rb

@@ -17,7 +17,7 @@ module CtxChecker
             return build_result([], complete: complete, recognized: true, issues: [ { code: :protocol_not_configured } ])
           end
           rows, issues, process, area, header = [], diagnostics, nil, nil, false
-          text.each_line do |raw|
+          text.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\AOSPF Process (\d+) with Router ID ([\d.]+)\z/i.match(line))
               process, area = match[1], nil

data/lib/ctx_checker/h3c/parsers/display_power.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, location, columns, contexts, context = [], "system", nil, [], nil
-          source.each_line do |raw|
+          source.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\A((?:Chassis \d+ )?Slot \d+|Chassis \d+)\s*:\z/i.match(line))
               location, columns = scope_name(match[1]), nil

data/lib/ctx_checker/h3c/parsers/display_transceiver_diagnosis.rb

@@ -27,7 +27,7 @@ module CtxChecker
               next
             end
             name = CtxChecker::Parsers::InterfaceNames.normalize(match[1], platform: :h3c)
-            lines = block.lines.drop(1).map(&:strip).reject(&:empty?)
+            lines = block.lines("\n").drop(1).map(&:strip).reject(&:empty?)
             if (state = availability(lines, name))
               rows.concat(measurements(name, nil, nil, nil, **state))
               next

data/lib/ctx_checker/hillstone/parsers/show_clock.rb

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           zones, clocks = [], []
-          source.each_line.with_index(1) do |raw, number|
+          source.each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             next if line.empty?
 

data/lib/ctx_checker/hillstone/parsers/show_cpu.rb

@@ -14,7 +14,7 @@ module CtxChecker
         # 要求当前采样及回显声明的各标准采样时间窗均有证据。
         def parse_output(text, complete:)
           rows = []
-          clean(text).each_line.with_index(1) do |raw, number|
+          clean(text).each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             if (match = /\A(Average|Current) cpu utilization\s*:\s*(\S+)\s*\z/i.match(line))
               rows << sample(match[2], scope: match[1].casecmp?("average") ? "system_average" : "system", seconds: nil)

data/lib/ctx_checker/hillstone/parsers/show_cpu_cntr.rb

@@ -22,7 +22,7 @@ module CtxChecker
         def parse_output(text, complete:)
           records, contexts = [], []
           context, queue, summary = nil, nil, false
-          clean(text).each_line.with_index(1) do |raw, number|
+          clean(text).each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             if /\Acpu Port Send\s+Rev Counter:\z/i.match?(line)
               summary = true

data/lib/ctx_checker/hillstone/parsers/show_environment.rb

@@ -22,7 +22,7 @@ module CtxChecker
           rows = { temperature: [], environment: [], power: [] }
           issues = rows.transform_values { diagnostics }
           contexts, section, header = [], nil, false
-          clean(text).each_line.with_index(1) do |raw, number|
+          clean(text).each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             if (match = /\A(.+ information(?:\(C\))?):\z/.match(line))
               section, header = SECTIONS[match[1]], false