ap2_mandate_verifier 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +28 -11
  3. data/docs/SUPPORT_CONTRACT.md +23 -7
  4. metadata +8 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fa2ea5451e11d660fac34e24d6ceb56364f40e35cceab36e1c07d065eee5c39b
4
- data.tar.gz: 52a9bbc66525cff272c186da35fb1f3441d886a973a0e6c292477cff1ab3f61f
3
+ metadata.gz: f45da719098900e3ddd4044f4285b6d2cb8df42e4ca23168b322ae96bdc4fce7
4
+ data.tar.gz: 661d44d4ac03ffa8427e68f9f121fc747f33056df6c7de007734ff3b583c7247
5
5
  SHA512:
6
- metadata.gz: bfadcb64ea84e9215ed19936468894d93015c89961aad6a912acb780ab8c7d27902dcd5acf664d79700d50054341a957a573a91e172a45bd61f246df468a9d59
7
- data.tar.gz: a39f11ead57b553dcf8c2b4b8dcba57ae2a0309d4183ecad9a7607988f2593fcdbe577ae81d9caf2b3232b62b2cc7f8d80471e40cbe025ffe7c658cb6b31010a
6
+ metadata.gz: 94c8b80c1eac4257ade9c329aaf80dfe75ed42d2ba1f54744a43167002520e6fd0b5457ab65392336b6090ee5a09314ee784a52e8e27b12f04d91da092b13a35
7
+ data.tar.gz: aa5d2eac3f0aaf2a69c9fe4a76c22e774cdcad44b8760f1405568bb47b6554225e2b36ea6ab1fa15dd4b50255a7115e74a82cd0299bf76757d7405035a292e08
data/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # AP2 Mandate Verifier — 0.2.0 release preparation
1
+ # AP2 Mandate Verifier — 0.2.1 candidate / published 0.2.0
2
2
 
3
3
  [Japanese / 日本語](README.ja.md)
4
4
 
@@ -21,35 +21,50 @@ Both routes use the fixed-profile verifier, not payment execution or Host author
21
21
 
22
22
  ## Distribution and installation
23
23
 
24
- [0.1.0 is published on RubyGems](https://rubygems.org/gems/ap2_mandate_verifier/versions/0.1.0). This is the fixed-profile, verifier-only stable release; the research prerelease pre3 is a separate artifact.
24
+ [0.2.0 is published on RubyGems](https://rubygems.org/gems/ap2_mandate_verifier/versions/0.2.0). This is the fixed-profile, verifier-only stable release; the research prerelease pre3 is a separate artifact.
25
25
 
26
26
  Use an existing MRI 4.0.9 environment and your chosen Gem isolation. Normal installation may fetch dependencies and build JSON native extensions. Stop on conflicts or unknown providers rather than relaxing pins.
27
27
 
28
28
  ```sh
29
29
  ruby --version # MRI 4.0.9 required
30
- gem install ap2_mandate_verifier --version 0.1.0
30
+ gem install ap2_mandate_verifier --version 0.2.0
31
31
  ```
32
32
 
33
33
  Bundler Gemfile:
34
34
 
35
35
  ```ruby
36
- gem "ap2_mandate_verifier", "= 0.1.0"
36
+ gem "ap2_mandate_verifier", "= 0.2.0"
37
37
  ```
38
38
 
39
39
  Fixed runtime dependencies: JSON 2.19.9, JWT 3.3.0, base64 0.3.0, OpenSSL gem 4.0.2 and Digest 3.2.1.
40
40
  Bundler 4.0.20 is the observed resolver baseline, not a runtime dependency. Gem version constraints alone do not enforce the MRI engine, OS or native-provider provenance.
41
41
 
42
- ## Verification APIs: published 0.1.0 and unreleased 0.2.0
42
+ ## Unpublished 0.2.1 candidate: Ruby 3.4.12 compatibility
43
43
 
44
- **The commands and saved example below remain the published 0.1.0 route using `verify_research`.** Repository metadata is now a 0.2.0 release candidate, with `verify_checkout` as its recommended full entry. This documentation does not announce a 0.2.0 publication or provide a registry installation command for it; installing 0.1.0 does not provide this method.
44
+ 0.2.1 is being prepared; RubyGems publication, a public tag and GitHub Release require a separate Owner decision. The published 0.2.0 commands above continue to require MRI 4.0.9.
45
+
46
+ The candidate targets exactly MRI 3.4.12 and MRI 4.0.9 with the same five fixed dependencies. Its installation metadata permits Ruby `>= 3.4.12, < 4.1`; that interval does not declare every intermediate Ruby version or another engine supported. Initial validation uses Debian 12/arm64 and official Ruby bookworm images. Actual build, loaded-provider and installed-Gem results are tracked in the [compatibility record](docs/RUBY_3_4_12_COMPATIBILITY.md); fresh source regressions passed on both versions; exact-archive packaging checks are recorded there separately. Historical macOS/Ubuntu observations do not validate the candidate.
47
+
48
+ After obtaining the prepared candidate Gem and checking its SHA256 against that record, install it in your chosen isolated environment:
49
+
50
+ ```sh
51
+ ruby --version # MRI 3.4.12 or MRI 4.0.9
52
+ gem install ./ap2_mandate_verifier-0.2.1.gem --no-document
53
+ ```
54
+
55
+ This is ordinary installation from the candidate file and may fetch/build the fixed dependencies. Seven inputs, the fixed profile, Fail Closed behavior, Result/Evidence v2 and all existing API meanings are retained. Candidate preparation is separate from publication and Host production GO.
56
+
57
+ ## Verification APIs: 0.2.0 and compatibility
58
+
59
+ **The installation commands and saved example use published 0.2.0 and its recommended `verify_checkout` entry.** Existing 0.1.0 applications can continue using `verify_research`; it remains available in 0.2.0 without a deprecation warning. Installing 0.1.0 does not provide `verify_checkout`.
45
60
 
46
61
  | Entry | Availability and contract |
47
62
  | --- | --- |
48
- | `verify_checkout(**inputs)` | Recommended full-verification entry for unreleased v0.2.0 source. Delegates directly to `ResearchResult.verify` without changing inputs or the verification pipeline. |
63
+ | `verify_checkout(**inputs)` | Recommended full-verification entry in 0.2.0. Delegates directly to `ResearchResult.verify` without changing inputs or the verification pipeline. |
49
64
  | `verify_research(**inputs)` | Full-verification entry in published 0.1.0; retained unchanged in v0.2.0, without a deprecation warning. |
50
65
  | `verify(presentation_json:)` | Existing JSON syntax check only. Valid JSON returns `:unverified` / `:verification_not_implemented`, never successful Evidence. It is not a substitute for full verification. |
51
66
 
52
- For a separately validated 0.2.0 candidate installation, replace only the call in the saved example with the recommended entry below. All seven values come from that example's `full` object; real integrations must supply the authenticated Host inputs described below. Use a registry install route only after publication is confirmed:
67
+ The recommended entry takes all seven inputs. In the saved example below, these values come from `full`; real integrations must supply the authenticated Host inputs described below:
53
68
 
54
69
  ```ruby
55
70
  result = AP2MandateVerifier.verify_checkout(
@@ -81,7 +96,7 @@ See [SUPPORT_CONTRACT](docs/SUPPORT_CONTRACT.md) for exact required shapes, boun
81
96
 
82
97
  ## Environment, compatibility and maintenance
83
98
 
84
- The baseline is MRI 4.0.9 with fixed dependencies and the exact observed MBA/macOS arm64 and Ubuntu 24.04/x86_64 configurations. Distinguish [release-package/provider evidence](research/stable010_release_linux_package/README.md) from [historical environment records](docs/VERIFIER_CORE_COMPLETION_CRITERIA.md#初回の対応環境保証範囲owner採用済み). Other OS versions, engines, architectures and arbitrary provider updates are not covered.
99
+ The published 0.2.0 baseline is MRI 4.0.9 with fixed dependencies and the exact observed MBA/macOS arm64 and Ubuntu 24.04/x86_64 configurations. The 0.2.1 candidate targets MRI 3.4.12 and 4.0.9; its Debian 12/arm64 validation status is tracked separately above. Distinguish [release-package/provider evidence](research/stable010_release_linux_package/README.md) from [historical environment records](docs/VERIFIER_CORE_COMPLETION_CRITERIA.md#初回の対応環境保証範囲owner採用済み). Other OS versions, engines, architectures and arbitrary provider updates are not covered.
85
100
 
86
101
  Supported-input semantics and APIs do not change silently. Security-driven narrowing identifies reason, impact and migration; breaking API/required-field/profile changes are explicit. Dependency updates are not automatically compatible.
87
102
 
@@ -121,7 +136,7 @@ inputs = {
121
136
  verified_at: full.fetch("verified_at")
122
137
  }
123
138
 
124
- result = AP2MandateVerifier.verify_research(**inputs)
139
+ result = AP2MandateVerifier.verify_checkout(**inputs)
125
140
  puts "status=#{result.status} code=#{result.code}"
126
141
  if result.success?
127
142
  checked_facts = result.evidence.to_h # Detached, deeply frozen in-process facts.
@@ -172,7 +187,9 @@ The Host supplies authenticated token-independent trust/keys/profile and current
172
187
 
173
188
  ## Evidence and history
174
189
 
175
- A prior 0.2.0 candidate passed the limited Debian 12/arm64 packaging observation recorded in [PR #213](https://github.com/cuichangquan/ap2-mandate-verifier/pull/213): 13 payload files matched source/archive/installation, 10 product Ruby files loaded normally and 118 installed cases passed. This adds an observation, not a supported-platform guarantee. README.md and SUPPORT_CONTRACT are packaged; these documentation changes require a new artifact and separately approved build/install/13-payload/10-loaded/118-case validation. That final candidate is NOT_RUN. Prior 190/885 source checks were not rerun in the packaging attempt; publication remains a separate decision.
190
+ The published 0.2.0 Gem is **33,280 bytes**, SHA256 `9a52e802de5a0564c34d198f4c4ad2c2b60791a8f1eb6e31db14c49e28e91f16`, from source commit `9b2e28d91fc4886722de7b9c39a5422e966953a9`. Publication on 2026-10-30 was verified against official RubyGems metadata, distribution bytes and the retained Gem. Its final Debian 12/arm64 / MRI 4.0.9 packaging observation matched all 13 payload files across source/archive/installation, loaded 10 product Ruby files normally and passed 118 installed cases using saved inputs/expected values. This is a limited observation, not a supported-platform expansion; source190/885 were not rerun in that packaging step. See [current publication status](docs/PROJECT_STATUS.md#020公開済み--現在の配布状態).
191
+
192
+ The packaged README and contract are snapshots from before publication. These repository documentation updates do not change the published Gem, require no rebuild, and do not transfer its validation to a rebuilt artifact. GitHub source archives contain repository source, not the RubyGems binary.
176
193
 
177
194
  The published 0.1.0 archive is **34,304 bytes**, SHA256 `37b2a235b6fab2d9d9765ae985dd9db27afd3b2c5407fe263a6b65314550db32`. Official metadata, owner `cuichangquan`, downloaded distribution bytes and all 13 payload hashes were checked on 2026-10-26. See the [publication record](research/stable010_release_linux_package/README.md#rubygems-publication-verified). This repository README was reorganized after publication and differs from the packaged README; the published archive was not rebuilt.
178
195
 
@@ -1,13 +1,21 @@
1
- # Fixed-profile AP2 verification — 0.1.0 baseline / 0.2.0 candidate
1
+ # Fixed-profile AP2 verification — 0.2.1 candidate / published 0.2.0
2
2
 
3
3
  **Fixed-profile verification contract; Evidence is not Host ALLOW or payment permission.**
4
4
  Distribution availability is determined by the official RubyGems version listing, not by this document. Specific Host production GO remains separate.
5
5
  Owner adopted the existing verification API and bounded stable-release conditions below. Publication and a specific Host's production operation are separate decisions; this contract does not authorize either.
6
6
  Published research-only pre3 remains unchanged. Its historical observations below do not certify this new archive.
7
7
 
8
- ## Unreleased 0.2.0 candidate API addition
8
+ ## Unpublished 0.2.1 compatibility candidate
9
9
 
10
- Repository candidate metadata is 0.2.0; this is not a publication or validated-archive claim. Published 0.1.0 and its historical evidence below remain unchanged. The initial source-only NOT_RUN record was followed by the limited candidate observation below; it does not validate later packaged-document changes.
10
+ The candidate's formal runtime targets are exactly MRI 3.4.12 and MRI 4.0.9, with JSON 2.19.9, JWT 3.3.0, base64 0.3.0, OpenSSL gem 4.0.2 and Digest 3.2.1 unchanged. Bundler 4.0.20 is the resolver validation baseline, not a runtime dependency. The Gem's installation requirement `>= 3.4.12, < 4.1` is an interval for dependency resolution; it does not certify other Ruby versions or engines.
11
+
12
+ Initial validation targets Debian 12/arm64 with official Ruby bookworm images. Actual runtime/OS/native-provider identities, source regressions, ordinary installed-Gem checks and exact artifact identity are tracked in the [compatibility record](RUBY_3_4_12_COMPATIBILITY.md). Fresh source regressions passed on both versions; exact-archive packaging checks are recorded there separately. Historical observations below do not validate the new candidate. Platform/provider observations remain limited to their recorded configuration.
13
+
14
+ The candidate retains the seven inputs, fixed profile, Fail Closed behavior, Result/Evidence v2 and `verify_checkout` / `verify_research` / legacy `verify` meanings described below. Candidate implementation, completed validation, publication readiness and completed publication are separate states. RubyGems publication, a public tag and GitHub Release await a separate Owner decision. Real Issuer trust and Host production GO remain separate and HOLD.
15
+
16
+ ## Published 0.2.0 API
17
+
18
+ [0.2.0 is published on RubyGems](https://rubygems.org/gems/ap2_mandate_verifier/versions/0.2.0). The published artifact and final packaging observation are identified below; 0.1.0 and earlier candidate evidence retain their historical identities.
11
19
 
12
20
  `verify_checkout(**inputs)` delegates directly to `ResearchResult.verify(**inputs)` without input transformation. It requires the same seven inputs listed below (six original Strings and externally supplied integer Unix seconds), fixed profile, bounds and trusted Host preconditions. `verify_research` is retained unchanged without deprecation warnings; `verify(presentation_json:)` remains syntax-only and never produces successful Evidence.
13
21
 
@@ -19,7 +27,15 @@ Both full entries preserve Result/ResearchResult, status/code and immutable Evid
19
27
 
20
28
  The limited Debian 12/arm64 observation used MRI 4.0.9 and the fixed Gem dependencies, OpenSSL library 3.0.22 / OS package `libssl3:arm64 3.0.22-1~deb12u2`. All 13 payload files matched source/archive/installed bytes, ordinary RubyGems require loaded 10 product Ruby files, and 118 logical cases passed: research42 + checkout42 + unavailable24 + legacy7 + input rejection2 + constructor rejection1. Saved inputs/independent expected values were reused; source190/885 were not rerun in this attempt. Earlier auxiliary-diagnostic STOP records remain preserved in PR #213.
21
29
 
22
- This is an additional bounded observation, not adoption of Debian as a supported platform or proof of general runtime security, symbol binding, whole-wire accounting or resource performance. The 0.1.0 baseline and historical evidence below retain their own artifact identities. README.md and this contract are packaged; editing them creates different candidate bytes. The documentation-final candidate build/install, 13-payload/10-loaded identity checks and 118 installed cases are pending separate approval and NOT_RUN. Final dependency/provider advisory review and exact-artifact publication approval remain required. Real Issuer trust/revocation, actual Host operation, performance and production GO remain HOLD.
30
+ This is an additional bounded observation, not adoption of Debian as a supported platform or proof of general runtime security, symbol binding, whole-wire accounting or resource performance. The 0.1.0 baseline and historical evidence below retain their own artifact identities. README.md and this contract are packaged; editing them creates different candidate bytes. The preparation-time NOT_RUN statement applied before the separately approved final observation below; prior candidate results were not reused as validation of the final bytes. Real Issuer trust/revocation, actual Host operation, performance and production GO remain HOLD.
31
+
32
+ ## Published 0.2.0 artifact and final observation
33
+
34
+ Published 2026-10-30 06:43:10 UTC, verified 06:44:48 UTC: owner `cuichangquan`, version `0.2.0`, platform `ruby`, non-prerelease. Official RubyGems SHA, distributed Gem and retained Gem matched: **33,280 bytes**, SHA256 `9a52e802de5a0564c34d198f4c4ad2c2b60791a8f1eb6e31db14c49e28e91f16`. Source `9b2e28d91fc4886722de7b9c39a5422e966953a9`, tree `a7739f966416bdbc18cfee266efc93223a587407`.
35
+
36
+ This final candidate separately passed the limited Debian 12/arm64 / MRI 4.0.9 observation: all 13 payload files matched source/archive/installation, 10 product Ruby files loaded through ordinary require, and 118 installed cases passed (42 research +42 checkout +24 unavailable +7 legacy +2 invalid inputs +1 constructor). Fixed dependencies and saved inputs/expected values were reused; source190/885 were NOT_RUN in this packaging step. Final report SHA256 `4348837cc153c65633e36c83c7939540819f164f43588d8140656e5ab50c2ccd`; publication receipt SHA256 `4b8264c5b990b10ad76a3fa3f01fc4ca94e6a828664ab3cefe11e6792c94a139`. These identify retained local records, not public downloads.
37
+
38
+ Publication does not expand supported-platform guarantees or establish real Issuer trust, revocation, actual Host operation, performance, production GO or Phase 2-B. The published Gem's documents are the pre-publication snapshot. Repository-only follow-up edits do not alter its bytes and require no rebuild; rebuilt artifacts do not inherit its validation. GitHub source archives differ from the RubyGems Gem. See [current status](PROJECT_STATUS.md#020公開済み--現在の配布状態).
23
39
 
24
40
  ## Verification contract
25
41
 
@@ -32,7 +48,7 @@ Evidence is immutable checked facts in the same trusted Ruby process, not ALLOW
32
48
  No worst-case CPU/RSS/concurrency or numeric SLA is promised. Host process/time/memory/concurrency limits supplement, not replace, Gem finite input bounds. Issuance, presentation generation, Receipt, Rails adapter, real payments and Host DB operations are outside this verifier.
33
49
  Supported-input semantics and existing API/status/code/Evidence contracts must not change silently. Security-driven acceptance narrowing requires impact/reason/migration disclosure; breaking required-field/profile/API changes must be explicit. Dependency updates are not automatically compatible.
34
50
 
35
- The proposed baseline remains MRI4.0.9 plus JSON2.19.9/JWT3.3.0/base640.3.0/OpenSSL gem4.0.2/Digest3.2.1, with the exact observed MBA arm64-darwin25 and Ubuntu24.04/x86_64 configurations. RubyGems version constraints do not enforce MRI/OS/provider identity. All OS versions, other engines/architectures and arbitrary provider updates are not supported by past observations.
51
+ The published 0.2.0 and historical baseline below is MRI4.0.9 plus JSON2.19.9/JWT3.3.0/base640.3.0/OpenSSL gem4.0.2/Digest3.2.1, with the exact observed MBA arm64-darwin25 and Ubuntu24.04/x86_64 configurations. RubyGems version constraints do not enforce MRI/OS/provider identity. All OS versions, other engines/architectures and arbitrary provider updates are not supported by past observations.
36
52
  Historical D3 observed MBA component identities and four selected crypto symbol sources; OS dyld hashes/all symbol bindings/global runtime security remain unproved. JSON2.19.9 official IO-buffer fix/tag/source identity is adopted static evidence; inconsistent GHSA patched-version metadata remains recorded. Neither observation is global S3 PASS. The earlier R1 archive subsequently passed Mac/Ubuntu packaging checks. It is a different archive; see the separate release-package record for current bytes and observations.
37
53
 
38
54
  Initial maintenance contact: Owner cuichangquan via repository Issues for ordinary bugs and private vulnerability reporting for vulnerabilities. No secrets, real Mandates or personal data in reports. Maintain only the latest patch in the selected initial stable series; no prerelease/old-series backport, fixed support years, response/fix/disclosure deadline or 24/7 promise.
@@ -40,7 +56,7 @@ Manual dependency/provider review is adopted monthly, on relevant advisories and
40
56
 
41
57
  ## Existing API/limits and historical evidence baseline
42
58
 
43
- The API/limit specification below preserves the existing contract. All pre2/pre3/MBA409/R1 observations are historical, not proof of a newly built archive. Exact current source/archive/installed identities and observations are recorded externally in [release-package evidence](../research/stable010_release_linux_package/README.md); no old result is relabelled.
59
+ The API/limit specification below preserves the existing contract. All pre2/pre3/MBA409/R1 observations are historical, not proof of a newly built archive. Historical release source/archive/installed identities and observations are recorded in [release-package evidence](../research/stable010_release_linux_package/README.md); the 0.2.1 candidate has its separate compatibility record above. No old result is relabelled.
44
60
 
45
61
  ## Supported proposition and environment
46
62
 
@@ -55,7 +71,7 @@ constraints, USD/EUR/JPY and empty links only. Other profiles/forms are rejected
55
71
  not accepted through a generic AP2/Schema fallback. This synthetic registered
56
72
  profile does not establish real Issuer enrollment or general interoperability.
57
73
 
58
- The supported baseline is MRI Ruby4.0.9 and JSON2.19.9/JWT3.3.0/base640.3.0/
74
+ The historical baseline described in this section is MRI Ruby4.0.9 and JSON2.19.9/JWT3.3.0/base640.3.0/
59
75
  OpenSSL gem4.0.2/Digest3.2.1, all fixed in the gemspec. These versions must be
60
76
  available through normal RubyGems/Bundler resolution; source-loadpath bypass
61
77
  or dependency replacement is not a compatibility contract. MBA409-20261023-BUILD02
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: ap2_mandate_verifier
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.2.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - AP2 Mandate Verifier contributors
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 1980-01-02 00:00:00.000000000 Z
10
+ date: 2026-10-30 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: json
@@ -109,16 +109,19 @@ require_paths:
109
109
  - lib
110
110
  required_ruby_version: !ruby/object:Gem::Requirement
111
111
  requirements:
112
- - - '='
112
+ - - ">="
113
+ - !ruby/object:Gem::Version
114
+ version: 3.4.12
115
+ - - "<"
113
116
  - !ruby/object:Gem::Version
114
- version: 4.0.9
117
+ version: '4.1'
115
118
  required_rubygems_version: !ruby/object:Gem::Requirement
116
119
  requirements:
117
120
  - - ">="
118
121
  - !ruby/object:Gem::Version
119
122
  version: '0'
120
123
  requirements: []
121
- rubygems_version: 4.0.20
124
+ rubygems_version: 3.6.9
122
125
  specification_version: 4
123
126
  summary: Fixed-profile AP2 verification for Ruby
124
127
  test_files: []