ctx_driver 0.2.8 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e16f6458370d2fd1faed594b6e3b26f15fece62edd4ecc868e4f426d83643f73
-  data.tar.gz: d31b0cff024ecff064f466bb54bfa4f2aef9170e033d3b0e57e5095cb6d1d7b4
+  metadata.gz: 4568b50606564c6f379c1110bd52c00566cfc7868f59f4253e38f675e2cf11db
+  data.tar.gz: 32e3dc04f8ee25ec7c21dd6c52beb607f0a51ecf2e80b4d39a30b125a28f70d4
 SHA512:
-  metadata.gz: 5ff09c69fbaa5c1d9568b87520a6ca61b8933e1c5651d77926402071cd7f4089ec2759ea78acd5627fdbc2db452d4766dc472c1609a203d0cd9a122300351d03
-  data.tar.gz: c8724a5627823cc81c3d2eecc17b7e91eeb56e9da7cca2796c396e4ce7a05daae9c80fdae37e465092f56197bca5eb0c8a7238d4c0d8693503b9155acf48d3e4
+  metadata.gz: af9f05c3a2fa5f0f9324641a2d81dc95a0488ab0ff7fccc50ec1302852f04e75b074015c34390f27ce7c66aa9a9bfb8ced2916f29c2878656929d85c6ea35cf8
+  data.tar.gz: 8527273f5407104dfa36c6414d0b65a5a2ecc9991a1572c408044b435fa8792346f4c923fabda6ee2dd365df6a1bc793a2cce3fa325d98e155282df8e63d66e2

data/CHANGELOG.md

@@ -4,6 +4,15 @@ Changes to the public contract are recorded here. Versions follow Semantic Versi
 
 ## Unreleased
 
+## 0.4.0 (2026-10-29)
+
+- Use the parser command contract for borrowed-session reads; preserve single-command identity and stop-after-desynchronization behavior.
+- Require ctx_parser 0.4.x.
+
+## 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,8 @@ 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.
+
+本次使用 ctx_parser 0.4 系列契约；`Result` 新增 `covered_scopes`，单行命令统一由 `CtxParser::Commands.command_text` 校验。跨模块约定见 [ctx_runner 契约迁移](https://github.com/gatework/ctx_runner/blob/main/docs/contracts-2026-10-29.md)。

data/docs/release.md

@@ -11,3 +11,7 @@ Configure `RUBYGEMS_API_KEY` as an encrypted secret in the GitHub `release` envi
 A failed publish is not permission to overwrite an existing version. Rerun the failed publish job to retain the original CI artifact. The script verifies an existing RubyGems version before proceeding and rejects different bytes or yanked versions. `workflow_dispatch` is restricted to version tags by the publish validation.
 
 Raw device `*.log`, local secrets, and build outputs are ignored. Package files use an explicit gemspec allowlist; review both the Git index and gem contents before publishing. Tests and examples must use synthetic or sanitized evidence.
+
+For a workspace release, `script/verify_package.rb` also accepts dependency artifacts after the driver gem. Pass them in installation order: ctx_cli, expect-pty, ctx_parser, then the optional net-connector candidate. The verifier installs those exact packages in its isolated GEM_HOME and skips the registry connector install when a connector candidate is supplied.
+
+Candidate installation and registry installation are separate checks. Publish the parser dependency first and confirm its registry availability before running the driver's clean Linux/macOS CI; the release tag must point to the commit whose complete CI matrix passed.

data/examples/connector.rb

@@ -7,7 +7,7 @@ require "net/connector"
 class ExampleConnectorTransport < Net::Connector::Transports::Pty
   # 子进程先给出提示符，随后逐条回显查询和合成正文。
   def argv
-    [ RbConfig.ruby, "-e", '$stdout.sync = true; print "device>"; while (line = gets); print line, "  interface Ethernet1/1 up\r\ndevice>"; end' ]
+    [ RbConfig.ruby, "--disable-gems", "-e", '$stdout.sync = true; print "device>"; while (line = gets); print line, "  interface Ethernet1/1 up\r\ndevice>"; end' ]
   end
 end
 

data/lib/ctx_driver/command.rb

@@ -1,16 +1,12 @@
 # frozen_string_literal: true
 
+require "ctx_parser/commands"
+
 module CtxDriver
   # 单条命令的值边界；只校验文本完整性，是否为只读查询由宿主决定。
   module Command
     # 校验并固定命令；已有冻结文本可以安全共享。
-    def self.snapshot(value)
-      unless value.is_a?(String) && !value.strip.empty? && !/[\x00-\x1f\x7f]/.match?(value)
-        raise ArgumentError, "One command without control characters is required"
-      end
-
-      value.frozen? ? value : value.dup.freeze
-    end
+    def self.snapshot(value) = CtxParser::Commands.command_text(value)
   end
   private_constant :Command
 end

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.4.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.4.0
 platform: ruby
 authors:
 - Gatework contributors
@@ -15,14 +15,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.4.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.4.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: digest
   requirement: !ruby/object:Gem::Requirement