ctx_driver 0.2.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80d06361fc6394791573257eb9fb244193ef62c3af63f2c4840bf06d8899a18f
-  data.tar.gz: 27f328d64cd3ae09a108aed29e26ddebbaa6c60131299dcabff8bc85179f76b3
+  metadata.gz: 9751c6adfa30351832bfca015e6557cf2395935ecf324e402b3baed8ce6c8d7b
+  data.tar.gz: 88defddfaa64c52675c13200a1ee03b9f7c09db1b3d9994ee625e1b853ba2db8
 SHA512:
-  metadata.gz: dd4ea380ec3eaeb44475259809a66ad3e8bd1b306bd98846ce70d5f3181cc428777b68c80bbf04184309016a2be9ce4e877986315eeb0887ec3d7258f17bedee
-  data.tar.gz: 354b3de16106cf86cad5c19b63982cd71d199c194dd2b3d8c441ffe30e61eff8bd9323179d2c8561c4787a6b00cd5805fd73ae0327f708b6022c65c7762d06a5
+  metadata.gz: fef8d0960f3d91ba79e2f4d7f359369d23875255c6085c6339141f4d961372e9a4cd6f0ae578c4b55abc21788008e81ce00c8fabc9bbca0229a0051cd20b75f0
+  data.tar.gz: f329ad83d7e09b04321dc02c9a202dab3c7748c958be484e851b2845168ed2ab4dfe84471ab0464327728a2175c731680b001329618534afb1147a5423598d3c

data/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.
+
 ## 0.2.7 (2026-10-23)
 
 - Skip subsequent queries after malformed single-command receipts while preserving valid command failure and local decoding isolation.

data/README-zh.md

@@ -21,7 +21,7 @@ gem "ctx_driver"
 
 然后执行 `bundle install`；也可直接执行 `gem install ctx_driver`。Ruby 加载入口为 `ctx_driver`，公开命名空间为 `CtxDriver`；gem 包名与 Ruby 命名空间分别维护。
 
-模块运行依赖：[`ctx_parser`](https://github.com/gatework/ctx_parser)。 共享 Gatework 依赖要求兼容的 0.2.x API；应用应提交自己的 `Gemfile.lock`，保持部署可复现。使用本库不需要启动 Rails 或配置兄弟模块的本地路径。
+模块运行依赖：[`ctx_parser`](https://github.com/gatework/ctx_parser)。gemspec 不限制依赖版本；应用应提交经过验证的 `Gemfile.lock`，保持部署可复现。使用本库不需要启动 Rails 或配置兄弟模块的本地路径。
 
 发布产物和校验值见 [GitHub Releases](https://github.com/gatework/ctx_driver/releases)，已发布版本以 [RubyGems](https://rubygems.org/gems/ctx_driver) 为准。
 
@@ -118,3 +118,6 @@ CI 在 Linux、macOS 上执行测试、lint、示例、构建和隔离安装。`
 ## 许可证
 
 MIT，见 [LICENSE](LICENSE)。
+
+
+回执协议：每个已完成步骤必须是 `{ command: String }`，命令字节与请求完全一致。成功恰好一个步骤；失败可以零或一个。旧的不透明占位步骤不再支持；缺失或不匹配标记 `invalid_command_result` 并停止后续查询，保留原始字节摘要。原生 net-connector 步骤由 Session 自动适配。

data/README.md

@@ -21,7 +21,7 @@ gem "ctx_driver"
 
 Then run `bundle install`, or install directly with `gem install ctx_driver`. The require path is `ctx_driver` and the public namespace is `CtxDriver`; package names and Ruby namespaces are intentionally separate.
 
-Internal runtime dependencies: [`ctx_parser`](https://github.com/gatework/ctx_parser). Shared Gatework dependencies require the compatible 0.2.x API. Applications should commit their own `Gemfile.lock` to make deployments reproducible. No Rails boot or sibling checkout paths are required.
+Internal runtime dependencies: [`ctx_parser`](https://github.com/gatework/ctx_parser). The gemspec leaves their versions unconstrained; applications should commit a verified `Gemfile.lock` for reproducible deployments. No Rails boot or sibling checkout paths are required.
 
 Release artifacts and checksums are available from [GitHub Releases](https://github.com/gatework/ctx_driver/releases). Check [RubyGems](https://rubygems.org/gems/ctx_driver) for published versions.
 
@@ -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.7"
+  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.7
+  version: 0.3.0
 platform: ruby
 authors:
 - Gatework contributors
@@ -15,14 +15,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        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.2.7
+        version: 0.3.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: digest
   requirement: !ruby/object:Gem::Requirement