ctx_checker 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 271bedce96855d5603beaa8ad69dffa2bb7acf04a33057780f01db0f79dea270
-  data.tar.gz: cf2c7b5c9427f709c945541ebbb44dfb0cfdd070f729e40cf81e327444bd86d4
+  metadata.gz: cfe9d7699f554a26eef174cf473835a6354cae53a94e35b4b010b9521c1702fb
+  data.tar.gz: 111dfc67e4e7acb4d77ce2e39d59962caf0a95a55dda4dfc111a1b8d9bef9df0
 SHA512:
-  metadata.gz: 366fbedebe8f7e0eaba9f41a0d4b9057005818a29bf382bf8eecd8f3ea18aa1a37f001fdcbd96c8d00604831fdcd933de7cca5555dfdc8500668beea05323f00
-  data.tar.gz: 31ce9a2c85943188f3dd8ca2f26fe9770e9684925d68f319542d58116ea1f0f96c8e352dcfe185a2514d4e1cc020b3f028522f07523f45a3873bb63ef5058d9f
+  metadata.gz: 329e9a0df103da02238c0c15fd1ca251254e9147821f14da142d946a530b40b7f506ea176f61eded7034099f2512248d83228136a506f19ebb384087ee740f55
+  data.tar.gz: ef5cf8c751dccfa83e6abe7af545e50d86a01c9934b9a42fd57503960f78770c0e38ce37559fe1df94b271ad6e84469bf11b02d43c7a6619ee85b5ebaafe188c

data/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 Changes to the public contract are recorded here. Versions follow Semantic Versioning.
 
+## 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.
+
 ## 0.2.0 (2026-10-17)
 
 - Require ctx_parser and ctx_driver 0.2.x for the renamed public contracts.

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/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

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

@@ -18,7 +18,7 @@ module CtxChecker
         # 识别无地址链路时，仍保留 IP 协议 down 状态。
         def parse_output(text, complete:)
           rows, issues, header = [], diagnostics, false
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A[-=]+\z/.match?(line) || LEGEND.match?(line)
 

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

@@ -15,7 +15,7 @@ module CtxChecker
         # 解释计数器前先校验列顺序；缺少采样时保留 nil。
         def parse_output(text, complete:)
           rows, issues, header, count = [], diagnostics, false, 0
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A[-=]+\z/.match?(line)
 

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

@@ -11,7 +11,7 @@ module CtxChecker
 
         # 仅支持已观察到的 StoneOS 格式，不假设使用 Cisco 表格语法。
         def parse_output(text, complete:)
-          lines = clean(text).lines.map(&:strip).reject(&:empty?)
+          lines = clean(text).lines("\n").map(&:strip).reject(&:empty?)
           recognized = lines == [ "No IPv4 neighbor is configured" ]
           issues = [ { code: recognized ? :protocol_not_configured : :unrecognized_bgp_output } ]
           build_result([], complete: complete, recognized: recognized, issues: issues)

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

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           percentages, totals, histories = [], [], []
           header_count, history = 0, nil
-          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 = /\AThe percentage of memory utilization:\s*(\S+)\s*%\z/i.match(line))
               percentages << percentage(match[1])

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

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, clients, versions, settings = [], [], [], []
-          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_transceiver.rb

@@ -17,7 +17,7 @@ module CtxChecker
         # 逐模块隔离，避免未知块将测量值错误关联到前一模块。
         def parse_output(text, complete:)
           rows, issues, blocks, current, header = [], diagnostics, [], nil, false
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A=+\z/.match?(line)
 

data/lib/ctx_checker/observation.rb

@@ -68,8 +68,7 @@ module CtxChecker
         raise ArgumentError, "Invalid evidence byte count" if entry.key?(:bytes) && !(entry[:bytes].is_a?(Integer) && entry[:bytes] >= 0)
         raise ArgumentError, "Invalid evidence reference" if entry.key?(:reference) && !text?(entry[:reference])
         if entry.key?(:observed_at)
-          raise ArgumentError, "Invalid evidence time" unless entry[:observed_at].is_a?(String)
-          Time.iso8601(entry[:observed_at])
+          raise ArgumentError, "Invalid evidence time" unless SystemFields.timestamp?(entry[:observed_at])
         end
       end
       @records, @issues, @evidence = [ normalized, issues, evidence ].map { |value| CtxParser::Immutable.copy(value) }

data/lib/ctx_checker/observation_merger.rb

@@ -8,8 +8,10 @@ module CtxChecker
   class ObservationMerger
     # 归并已声明的命令证据，不丢失来源失败或身份歧义。
     def self.call(name, observations, commands:, required_metrics: [])
-      unless observations.is_a?(Array) && observations.all? { |observation| observation.is_a?(Observation) && observation.name == name }
-        raise ArgumentError, "Command observations must share a dimension"
+      unless observations.is_a?(Array) && observations.all? do |observation|
+          observation.is_a?(Observation) && observation.name == name && observation.status != :not_requested
+        end
+        raise ArgumentError, "Command observations must share a requested dimension"
       end
       sources = observations.map do |observation|
         source = observation.evidence.map { |entry| entry[:command] }.compact.uniq

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

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, issues = [], diagnostics
-          source.each_line.with_index(1) do |raw, number|
+          source.each_line("\n").with_index(1) do |raw, number|
             next if raw.strip.empty?
             match = /\A(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+([A-Z][a-z]{2})\s+(\d{1,2})\s+(\d{2}:\d{2}:\d{2})\s+(\S+)\s+(\d{4})\z/.match(raw.strip)
             unless match

data/lib/ctx_checker/palo_alto/parsers/show_counter_global.rb

@@ -18,7 +18,7 @@ module CtxChecker
           source = clean(text)
           rows, totals, issues = [], [], diagnostics
           title, header = false, false
-          source.each_line.with_index(1) do |raw, number|
+          source.each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             if line == "Global counters:"
               title = true

data/lib/ctx_checker/palo_alto/parsers/show_counter_interface_all.rb

@@ -24,7 +24,7 @@ module CtxChecker
             next if block.strip.empty?
             match = /\A\s*Interface:\s*([^\n]+)\n/i.match(block)
             unless match
-              lines = block.lines.map(&:strip).reject { |line| line.empty? || line.match?(/\A-+\z/) }
+              lines = block.lines("\n").map(&:strip).reject { |line| line.empty? || line.match?(/\A-+\z/) }
               issues << { code: :unrecognized_counter_block } unless lines == [ "Hardware interface counters:" ]
               next
             end
@@ -33,7 +33,7 @@ module CtxChecker
             kind = CtxChecker::Parsers::InterfaceNames.kind(name)
             wanted = kind == :physical ? :hardware : :logical
             section, values = nil, []
-            block.lines.drop(1).each do |raw|
+            block.lines("\n").drop(1).each do |raw|
               line = raw.strip
               if (heading = /\A(Hardware|Logical) interface counters(?: read from CPU)?:\z/i.match(line))
                 section = heading[1].downcase.to_sym

data/lib/ctx_checker/palo_alto/parsers/show_interface_all.rb

@@ -15,7 +15,7 @@ module CtxChecker
           text = clean(text)
           rows, issues, section, totals, counts, duplicates = {}, diagnostics, nil, {}, Hash.new(0), []
           logical_names = {}
-          text.each_line do |raw|
+          text.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\Atotal configured (hardware|logical) interfaces:\s*(\d+)\z/i.match(line))
               section = match[1].downcase.to_sym

data/lib/ctx_checker/palo_alto/parsers/show_lacp_aggregate_ethernet.rb

@@ -14,7 +14,7 @@ module CtxChecker
         def parse_output(text, complete:)
           text = clean(text)
           rows, issues, group, header, groups = [], diagnostics, nil, false, {}
-          text.each_line do |raw|
+          text.each_line("\n") do |raw|
             line = raw.strip
             if (match = /\AAE group:\s*(ae\d+)\z/i.match(line))
               group = match[1].downcase

data/lib/ctx_checker/palo_alto/parsers/show_ntp.rb

@@ -14,7 +14,7 @@ module CtxChecker
           source = clean(text)
           rows, globals, issues = [], [], diagnostics
           current, fields, header, peer_fields = nil, {}, false, {}
-          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?
             if line == "NTP state:"

data/lib/ctx_checker/palo_alto/parsers/show_routing_protocol_bgp_peer.rb

@@ -22,7 +22,7 @@ module CtxChecker
               issues << { code: :unrecognized_bgp_block }
               next
             end
-            if block.lines.any? { |line| !line.strip.empty? && !FIELDS.match?(line.strip) }
+            if block.lines("\n").any? { |line| !line.strip.empty? && !FIELDS.match?(line.strip) }
               issues << { code: :unrecognized_bgp_field }
             end
             if [ "Remote Address", "Peer status", "Remote AS", "virtual router" ].any? { |field| block.scan(/^\s*#{Regexp.escape(field)}:/i).size > 1 }

data/lib/ctx_checker/palo_alto/parsers/show_routing_protocol_ospf_neighbor.rb

@@ -21,13 +21,13 @@ module CtxChecker
           text.split(/(?=^\s*virtual router:)/i).each do |block|
             unless block.match?(/\A\s*virtual router:/i)
               # 文档规定的图例位于首个邻居前，任意前导文本不构成证据。
-              lines = block.lines.map(&:strip).reject(&:empty?)
+              lines = block.lines("\n").map(&:strip).reject(&:empty?)
               unless lines.all? { |line| line.match?(/\A(?:=+|Options: 0x80:reserved,.*|N\/P:NSSA option,.*)\z/i) }
                 issues << { code: :unrecognized_ospf_block }
               end
               next
             end
-            issues << { code: :unrecognized_ospf_field } if block.lines.any? { |line| !line.strip.empty? && !FIELDS.match?(line.strip) }
+            issues << { code: :unrecognized_ospf_field } if block.lines("\n").any? { |line| !line.strip.empty? && !FIELDS.match?(line.strip) }
             if [ "neighbor address", "neighbor router ID", "status" ].any? { |field| block.scan(/^\s*#{Regexp.escape(field)}:/i).size > 1 }
               issues << { code: :duplicate_ospf_field }
               next

data/lib/ctx_checker/palo_alto/parsers/show_system_environmentals.rb

@@ -19,7 +19,7 @@ module CtxChecker
           rows = { temperature: [], environment: [], power: [] }
           issues = rows.transform_values { diagnostics }
           section, header, sections, section_rows = nil, nil, [], 0
-          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?
             if (match = /\A-+\s*([^-]+?)\s*-+\z/.match(line))

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

@@ -17,9 +17,9 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           cpus, memories, cpu_issues, memory_issues, shared_issues = [], [], diagnostics, diagnostics, diagnostics
-          swap_lines = source.lines.grep(/\A\s*(?:(?:KiB|MiB|GiB|TiB)\s+)?Swap\s*:/)
+          swap_lines = source.lines("\n").grep(/\A\s*(?:(?:KiB|MiB|GiB|TiB)\s+)?Swap\s*:/)
           process_table = false
-          source.each_line.with_index(1) do |raw, number|
+          source.each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             if (match = /\A%?Cpu(?:\(s\)|(\d+))\s*:\s*(.*)\z/i.match(line))
               cpus << cpu(match, cpu_issues)

data/lib/ctx_checker/palo_alto/parsers/show_system_state_alarms.rb

@@ -13,7 +13,7 @@ module CtxChecker
         def parse_output(text, complete:)
           source = clean(text)
           rows, issues = [], diagnostics
-          source.each_line.with_index(1) do |raw, number|
+          source.each_line("\n").with_index(1) do |raw, number|
             line = raw.strip
             # 配置阈值和复制的 HA 对端状态不属于本地当前告警。
             next if line.empty? || line.match?(/\A(?:cfg\.|peer\.)/)

data/lib/ctx_checker/palo_alto/parsers/show_transceiver_all.rb

@@ -15,7 +15,7 @@ module CtxChecker
         def parse_output(text, complete:)
           text = clean(text)
           rows, issues, header = [], diagnostics, false
-          text.each_line do |raw|
+          text.each_line("\n") do |raw|
             line = raw.strip
             if /\APort\s+Temperature\s+Voltage\s+Current\s+Tx Power\s+Rx Power\z/i.match?(line)
               header = true

data/lib/ctx_checker/parsers/base.rb

@@ -23,7 +23,7 @@ module CtxChecker
         @unsupported = false
         @command_failed = false
         source = CtxParser::Input.text(text, encoding: :transcode, newlines: :lf, max_bytes: MAX_BYTES)
-        source.each_line.with_index(1) do |line, number|
+        source.each_line("\n").with_index(1) do |line, number|
           if /\A\s*(?:(?:%\s*)?(?:Error:\s*)?(?:Invalid (?:input|command|syntax)|Unrecognized command|Unknown command|command not (?:found|supported)|not supported on this|syntax error)|\^-+\s*unrecognized keyword\b)/i.match?(line)
             @unsupported = true
             @issues << { code: :unsupported_command, line: number }

data/lib/ctx_checker/radware_alteon/parsers/info_l2_lacp_dump.rb

@@ -15,7 +15,7 @@ module CtxChecker
         # 活跃模式需要额外运行证据，不能由重复的 trunk 记录替代。
         def parse_output(text, complete:)
           issues, ports, header = diagnostics, {}, false
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A-+\z/.match?(line)
 

data/lib/ctx_checker/radware_alteon/parsers/info_l2_trunk.rb

@@ -15,7 +15,7 @@ module CtxChecker
         # 将成员限定在其所属 trunk 中，明确保留不完整聚合组。
         def parse_output(text, complete:)
           rows, issues, groups, current = [], diagnostics, {}, nil
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A-+\z/.match?(line)
 

data/lib/ctx_checker/radware_alteon/parsers/info_l3_bgp_summary.rb

@@ -11,7 +11,7 @@ module CtxChecker
 
         # 协议明确禁用不代表策略要求的对等体健康。
         def parse_output(text, complete:)
-          lines = clean(text).lines.map(&:strip).reject(&:empty?)
+          lines = clean(text).lines("\n").map(&:strip).reject(&:empty?)
           disabled = lines == [ "BGP is disabled." ]
           issues = [ { code: disabled ? :protocol_disabled : :unrecognized_bgp_output } ]
           build_result([], complete: complete, recognized: disabled, issues: issues)

data/lib/ctx_checker/radware_alteon/parsers/info_l3_ip.rb

@@ -16,7 +16,7 @@ module CtxChecker
         def parse_output(text, complete:)
           rows, issues, section = [], diagnostics, :preamble
           header, interfaces, ipv6, closed = false, false, false, false
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A-+\z/.match?(line)
 

data/lib/ctx_checker/radware_alteon/parsers/info_l3_ospf_nbr.rb

@@ -11,7 +11,7 @@ module CtxChecker
 
         # 在验证活跃 Alteon 邻居表前，保留明确禁用状态。
         def parse_output(text, complete:)
-          lines = clean(text).lines.map(&:strip).reject(&:empty?)
+          lines = clean(text).lines("\n").map(&:strip).reject(&:empty?)
           disabled = lines == [ "OSPF is disabled." ]
           issues = [ { code: disabled ? :protocol_disabled : :unrecognized_ospf_output } ]
           build_result([], complete: complete, recognized: disabled, issues: issues)

data/lib/ctx_checker/radware_alteon/parsers/info_link.rb

@@ -15,7 +15,7 @@ module CtxChecker
         # 链路行缺失不能证明端口已禁用或健康。
         def parse_output(text, complete:)
           rows, issues, header = [], diagnostics, false
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A[-\s]+\z/.match?(line)
             next if /\A-+\s+-+\s+-+\s+-+\s+--TX---RX--\s+-+\z/.match?(line)

data/lib/ctx_checker/radware_alteon/parsers/info_sys_fan.rb

@@ -12,7 +12,7 @@ module CtxChecker
         # 校验每条风扇记录，并按厂商关键性定义确定故障严重级别。
         def parse_output(text, complete:)
           rows, tables, headers = [], 0, 0
-          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 line == "Fans table:"
               tables += 1

data/lib/ctx_checker/radware_alteon/parsers/info_sys_general.rb

@@ -13,7 +13,7 @@ module CtxChecker
 
         # 仅投影当前时钟，不使用启动、应用或保存时间戳。
         def parse_output(text, complete:)
-          lines = clean(text).lines.map(&:strip)
+          lines = clean(text).lines("\n").map(&:strip)
           clocks = lines.grep(/\ASystem Information at\b/)
           zones = lines.grep(/\ATime zone:/)
           @issues << { code: :ambiguous_clock_time, count: clocks.size } unless clocks.one?

data/lib/ctx_checker/radware_alteon/parsers/info_sys_ps.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(Single|Dual) Power Supply Status:\s*(.+)\z/i.match(line))
               state = STATES.fetch(match[2].downcase, :unknown)

data/lib/ctx_checker/radware_alteon/parsers/info_sys_temp.rb

@@ -15,7 +15,7 @@ module CtxChecker
         # 阈值缺失时保留未知，拒绝矛盾的汇总或范围证据。
         def parse_output(text, complete:)
           rows, highs, criticals, summaries = [], [], [], []
-          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 = /\ASensor (\d+) has (\S+) degree Celsius\z/.match(line))
               value = /\A#{NUMBER}\z/.match?(match[2]) ? Float(match[2], exception: false) : nil

data/lib/ctx_checker/radware_alteon/parsers/info_transceiver.rb

@@ -18,7 +18,7 @@ module CtxChecker
         # 指定光学方向或单位前，先校验多行表头。
         def parse_output(text, complete:)
           rows, issues, headings = [], diagnostics, []
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A[-\s]+\z/.match?(line)
 

data/lib/ctx_checker/radware_alteon/parsers/stats_mp_cpu.rb

@@ -14,7 +14,7 @@ module CtxChecker
         # 要求各文档规定的 MP 时间窗完整，无效读数保持未知。
         def parse_output(text, complete:)
           rows, headers = [], 0
-          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 line == "CPU utilization:"
               headers += 1

data/lib/ctx_checker/radware_alteon/parsers/stats_mp_mem.rb

@@ -16,7 +16,7 @@ module CtxChecker
         # 扣除明确报告的 Linux 缓存；原始进程数值仅作为来源证据保留。
         def parse_output(text, complete:)
           values, headers = Hash.new { |hash, key| hash[key] = [] }, 0
-          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 line == "Memory stats:"
               headers += 1

data/lib/ctx_checker/radware_alteon/parsers/stats_port_ether.rb

@@ -18,7 +18,7 @@ module CtxChecker
         # 将各 IEEE 计数器绑定到其明确的数据端口标题。
         def parse_output(text, complete:)
           blocks, issues, current = [], diagnostics, nil
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A-+\z/.match?(line)
 

data/lib/ctx_checker/radware_alteon/parsers/stats_port_if.rb

@@ -17,7 +17,7 @@ module CtxChecker
         # 解释方向性测量前，要求存在带标签的累计计数列。
         def parse_output(text, complete:)
           blocks, issues, current, section = [], diagnostics, nil, nil
-          clean(text).each_line do |raw|
+          clean(text).each_line("\n") do |raw|
             line = raw.strip
             next if line.empty? || /\A-+\z/.match?(line)
 

data/lib/ctx_checker/radware_alteon/parsers/stats_sp_allutils.rb

@@ -15,7 +15,7 @@ module CtxChecker
           rows = { cpu: [], memory: [] }
           issues = rows.transform_values { diagnostics }
           sections, current = [], nil
-          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 = /\ASPs CPU utilization percentage for (\d+) sec sampling\s*:\z/.match(line))
               current = section(:cpu, match[1].to_i)

data/lib/ctx_checker/radware_alteon/parsers/stats_sys_ntp.rb

@@ -18,7 +18,7 @@ module CtxChecker
           source = clean(text)
           rows, headers, sections, time_fields = [], 0, [], []
           counter_issues, ntp_issues, section = diagnostics, diagnostics, 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? || /\A-+\z/.match?(line)
 

data/lib/ctx_checker/report.rb

@@ -65,11 +65,16 @@ module CtxChecker
       grouped = {}
       snapshot.observations.each_value do |observation|
         sources = observation.evidence.filter_map { |entry| entry[:command] }.uniq
+        # 逐命令索引诊断，避免发现数百个端口时反复扫描整个列表。
+        issues_by_command = observation.issues.group_by { |issue| issue[:command] }
+        if sources.one?
+          issues_by_command[sources.first] = observation.issues.select { |issue| !issue[:command] || issue[:command] == sources.first }
+        end
         observation.evidence.each do |evidence|
           command = evidence[:command]
           next unless command
 
-          issues = observation.issues.select { |issue| issue[:command] == command || !issue[:command] && sources.one? }
+          issues = issues_by_command.fetch(command, [])
           state = issues.any? { |issue| issue[:skipped] } ? :skipped : evidence.fetch(:status, observation.status)
           entry = grouped[command] ||= { command: command, dimensions: {}, issues: [] }
           entry[:dimensions][observation.name] = command_status([ entry[:dimensions][observation.name], state ].compact)

data/lib/ctx_checker/snapshot.rb

@@ -23,7 +23,9 @@ module CtxChecker
       end
       @observed_at = case observed_at
       when Time then observed_at.getutc.freeze
-      when String then Time.iso8601(observed_at).getutc.freeze
+      when String
+        raise ArgumentError, "Observation time requires a valid date and explicit UTC offset" unless SystemFields.timestamp?(observed_at)
+        Time.iso8601(observed_at).getutc.freeze
       else raise ArgumentError, "Observation time must be Time or ISO8601"
       end
       @target = CtxParser::Immutable.copy(target)

data/lib/ctx_checker/system_policy.rb

@@ -27,7 +27,7 @@ module CtxChecker
       @resource_thresholds = CtxParser::Immutable.copy(DEFAULT_RESOURCES.merge(resource_thresholds))
       @temperature_thresholds, @required_components, @required_dimensions, @device_counter_limits =
         [ temperature_thresholds, required_components, required_dimensions, device_counter_limits ].map { |value| CtxParser::Immutable.copy(value) }
-      @max_clock_skew_seconds, @max_ntp_offset_ms = max_clock_skew_seconds, max_ntp_offset_ms
+      @max_clock_skew_seconds, @max_ntp_offset_ms = CtxParser::Immutable.copy([ max_clock_skew_seconds, max_ntp_offset_ms ])
       freeze
     end
 

data/lib/ctx_checker/version.rb

@@ -2,5 +2,5 @@
 
 module CtxChecker
   # 公开包版本，供 RubyGems 元数据和运行时调用方共用。
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ctx_checker
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Gatework contributors