ctx_driver 0.2.8 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e16f6458370d2fd1faed594b6e3b26f15fece62edd4ecc868e4f426d83643f73
-  data.tar.gz: d31b0cff024ecff064f466bb54bfa4f2aef9170e033d3b0e57e5095cb6d1d7b4
+  metadata.gz: 9751c6adfa30351832bfca015e6557cf2395935ecf324e402b3baed8ce6c8d7b
+  data.tar.gz: 88defddfaa64c52675c13200a1ee03b9f7c09db1b3d9994ee625e1b853ba2db8
 SHA512:
-  metadata.gz: 5ff09c69fbaa5c1d9568b87520a6ca61b8933e1c5651d77926402071cd7f4089ec2759ea78acd5627fdbc2db452d4766dc472c1609a203d0cd9a122300351d03
-  data.tar.gz: c8724a5627823cc81c3d2eecc17b7e91eeb56e9da7cca2796c396e4ce7a05daae9c80fdae37e465092f56197bca5eb0c8a7238d4c0d8693503b9155acf48d3e4
+  metadata.gz: fef8d0960f3d91ba79e2f4d7f359369d23875255c6085c6339141f4d961372e9a4cd6f0ae578c4b55abc21788008e81ce00c8fabc9bbca0229a0051cd20b75f0
+  data.tar.gz: f329ad83d7e09b04321dc02c9a202dab3c7748c958be484e851b2845168ed2ab4dfe84471ab0464327728a2175c731680b001329618534afb1147a5423598d3c

data/CHANGELOG.md

@@ -4,6 +4,10 @@ Changes to the public contract are recorded here. Versions follow Semantic Versi
 
 ## Unreleased
 
+## 0.3.0 (2026-10-29)
+
+- Require every completed receipt step to identify the exact requested command as `{ command: String }`; malformed identities stop later queries while retaining raw fingerprints. Normalize native connector steps at the session boundary.
+
 ## 0.2.8 (2026-10-24)
 
 - Leave the ctx_parser dependency unconstrained in the gemspec; applications select and lock a verified dependency combination.

data/README-zh.md

@@ -118,3 +118,6 @@ CI 在 Linux、macOS 上执行测试、lint、示例、构建和隔离安装。`
 ## 许可证
 
 MIT，见 [LICENSE](LICENSE)。
+
+
+回执协议：每个已完成步骤必须是 `{ command: String }`，命令字节与请求完全一致。成功恰好一个步骤；失败可以零或一个。旧的不透明占位步骤不再支持；缺失或不匹配标记 `invalid_command_result` 并停止后续查询，保留原始字节摘要。原生 net-connector 步骤由 Session 自动适配。

data/README.md

@@ -118,3 +118,6 @@ Publish dependency gems first. A Git tag, a successful build, or a workflow file
 ## License
 
 MIT. See [LICENSE](LICENSE).
+
+
+Receipt protocol: each completed step is `{ command: String }` with exactly the requested command bytes. Success requires one step; failure permits zero or one. Opaque placeholder steps are no longer accepted. Missing or mismatched identity yields `invalid_command_result` and stops later queries while retaining raw fingerprints. Session adapts native net-connector steps automatically.

data/lib/ctx_driver/reader.rb

@@ -71,6 +71,9 @@ module CtxDriver
         unless [ true, false ].include?(success) && steps.is_a?(Array) && (success ? steps.one? : steps.size <= 1)
           raise TypeError, "One query must return one completed command"
         end
+        unless steps.all? { |step| step.is_a?(Hash) && step[:command].is_a?(String) && step[:command].b == command.b }
+          raise TypeError, "Completed step must belong to the requested command"
+        end
         receipt_validated = true
         if success
           body = receipt.value!

data/lib/ctx_driver/session.rb

@@ -17,7 +17,10 @@ module CtxDriver
       def pretty_print(printer) = printer.text(inspect)
 
       def output = result.output
-      def steps = result.steps
+      # 原生命令对象在适配边界投影为驱动的单命令身份协议。
+      def steps
+        result.steps.map { |step| { command: Command.snapshot(step.command.text) }.freeze }.freeze
+      end
       def success? = result.success?
       def error = result.error
 

data/lib/ctx_driver/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ctx_driver
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.3.0
 platform: ruby
 authors:
 - Gatework contributors
@@ -15,14 +15,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: digest
   requirement: !ruby/object:Gem::Requirement