@agent-blueprint-protocol/verifier 0.8.1 → 0.8.2

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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,87 @@
2
2
 
3
3
  All notable public changes to `agent_blueprint_protocol` are documented here.
4
4
 
5
+ ## [0.8.2] — 2026-11-05
6
+
7
+ ### Fixed — documentation
8
+
9
+ - Correction to an earlier entry: bare `npx agent-blueprint-protocol` and
10
+ `npx verifier` work only where `@agent-blueprint-protocol/verifier` is
11
+ installed. Elsewhere, npx looks the bare name up on the public registry,
12
+ where it is not this project's. Use `npx @agent-blueprint-protocol/verifier`.
13
+ - The post-publish check runs `npx --no-install verifier`, so it can never
14
+ fetch the unrelated npm package named `verifier`.
15
+
16
+ ### Added — documentation
17
+
18
+ - A Livebook walkthrough, `docs/livebooks/abp-walkthrough.livemd`,
19
+ shipped in the package and on HexDocs. It installs the package from
20
+ Hex, composes and signs a Blueprint, negotiates extensions, binds a
21
+ Deployment Manifest, reconciles the pair, runs the shipped corpus, and
22
+ shows each denial: a tampered signature, the wrong key, an unknown
23
+ `key_id`, a small-order key, an edited member, non-canonical bytes,
24
+ and the strict R and S rule. The test suite runs every cell in order
25
+ and compares each result with the output printed in the notebook.
26
+ - The README opens with a first-verification example, and the
27
+ TypeScript guide with an import example; the README example runs in
28
+ the guide mirror test, and the TypeScript one runs against the kit
29
+ as npm packs it (installed from the `npm pack` tarball) in a new
30
+ quality step, `mix typescript.guide`, which the doc-gates workflow also
31
+ runs.
32
+
33
+ ### Changed — documentation
34
+
35
+ - The CI workflows' GitHub Action pins move with their dependabot bumps
36
+ (`actions/setup-node` v7.1.0, `actions/upload-pages-artifact` v5.0.0,
37
+ `actions/deploy-pages` v5.0.1); the toolchain lockstep test's pinned
38
+ setup-node identity moves with them. No workflow inputs changed.
39
+ - npm kit commands in the README, the TypeScript guide, and the landing
40
+ page stay unpinned, with a line saying npx runs the latest published
41
+ kit and how to check its version (a kit release goes live after a
42
+ maintainer approves its staged publish). The documentation-currency
43
+ gate requires the README's npm commands to stay unpinned.
44
+ - The document-citation gate now checks the guides under
45
+ `documentation/` and the Livebook (it skipped directory entries
46
+ before), and the version gate scans the Livebook.
47
+ - Corrected guide statements: the Deployment binding check has six
48
+ ordered stages, not three; the echo example has 16 members (the table
49
+ has 18); the kit has four modes and two bin names; the error guide
50
+ lists the `{:ceiling, key}` decoder-limit family; SECURITY.md names
51
+ the Security tab's **Report a vulnerability** form; the battery lists
52
+ in the README, CONTRIBUTING.md, and the operations guide name every
53
+ step; the evidence-commitments guide cites the AI Act articles it
54
+ relies on (12, 25(4), and 26) and points to Regulation (EU) 2026/1744,
55
+ which moved the high-risk application dates.
56
+ - The release-candidate reprove turns off git's automatic maintenance in
57
+ its scratch repositories, as does the privacy gate's throwaway
58
+ repository. From git 2.54, `git commit` starts a detached repack that
59
+ keeps writing into `.git` after the command returns; on hosted CI
60
+ (git 2.55) it raced the scratch cleanup and failed the check with
61
+ `could not remove files and directories recursively ... file already
62
+ exists`. A new architecture test requires every script or test that
63
+ commits in a scratch repository to set `maintenance.auto` false.
64
+ - Removed duplicated sentences from eighteen module docs. The comments
65
+ on small-order keys in `Signature` and the TypeScript verifier now say
66
+ exactly what the backends accept: under the identity key, R = identity
67
+ with S = 0 verifies for every message; under the all-zero key, the
68
+ all-zero signature verifies for about one message in four.
69
+ - The errata table's release boundaries now name the recording date
70
+ instead of a concrete version ("every release published before
71
+ 2026-10-13 that ships this specification"), so each row stays true and
72
+ gate-clean at every later release without rewording. The corrections'
73
+ substance is unchanged; the specification digest moves with the
74
+ rewording (the digest covers the whole extracted specification,
75
+ errata included), which is recorded in the release history;
76
+ `verification_semantics_version` stays 1.
77
+
78
+ This is a documentation-only release; the public API, the registry, and
79
+ the corpus are unchanged from 0.8.1, and `spec/protocol.md` is
80
+ byte-identical. The test suite is 957 tests (63 properties) at 100%
81
+ coverage. Corpus: 129 cases, digest
82
+ `sha-256:WOZcBfvCW88L6TG_66vxG1fw0QN8cCXrJxveqHgI8a4`; registry
83
+ `sha-256:FG2f38K0hba8tTP7iUaw7vHjgcnN_5F5Mp0v4G6UDVs`; specification
84
+ digest `sha-256:aBgeih79woOR7YmJ_OBhyFgKU0j2euO-eieJKxLVDeA`.
85
+
5
86
  ## [0.8.1] — 2026-10-14
6
87
 
7
88
  ### Fixed
package/README.md CHANGED
@@ -31,13 +31,32 @@ and evidence retention.
31
31
  ```elixir
32
32
  def deps do
33
33
  [
34
- {:agent_blueprint_protocol, "~> 0.8.1"}
34
+ {:agent_blueprint_protocol, "~> 0.8.2"}
35
35
  ]
36
36
  end
37
37
  ```
38
38
 
39
39
  The package has **zero production dependencies**, no application callback, and
40
- no supervision tree.
40
+ no supervision tree. It requires Elixir 1.19 or newer on OTP 27, 28, or 29.
41
+
42
+ ## A first verification
43
+
44
+ From a checkout of this repository (or with the example file fetched as
45
+ the [quickstart](documentation/quickstart.md) shows), decode the example
46
+ Blueprint, then watch a value that is not a Blueprint get a typed denial:
47
+
48
+ ```elixir
49
+ bytes = File.read!("examples/echo-blueprint.json")
50
+ {:ok, blueprint} = AgentBlueprintProtocol.decode_blueprint(bytes)
51
+ AgentBlueprintProtocol.canonical_bytes(blueprint) == {:ok, bytes} # => true
52
+ {:ok, other} = AgentBlueprintProtocol.Canonicalization.encode({:object, [{"a", {:integer, 1}}]})
53
+ AgentBlueprintProtocol.decode_blueprint(other) # => {:error, :unknown_member}
54
+ ```
55
+
56
+ The quickstart runs this from a new Mix project, and the
57
+ [Livebook walkthrough](docs/livebooks/abp-walkthrough.livemd)
58
+ goes end to end: compose, sign, negotiate, reconcile, and the attacks that
59
+ fail closed.
41
60
 
42
61
  ## Installation (TypeScript)
43
62
 
@@ -51,6 +70,8 @@ npx @agent-blueprint-protocol/verifier # verify the embed
51
70
  npx @agent-blueprint-protocol/verifier --artifact <file.json> # verify one artifact
52
71
  ```
53
72
 
73
+ npx runs the latest published kit; `npm view @agent-blueprint-protocol/verifier version` shows which.
74
+
54
75
  See the [TypeScript quickstart](documentation/typescript.md) and the
55
76
  [examples gallery](documentation/examples.md).
56
77
 
@@ -109,7 +130,7 @@ against its tags' actual trees.
109
130
  ## Status
110
131
 
111
132
  The protocol API, schemas, canonicalization profile, extension registry,
112
- and conformance corpus are implemented and gated: 951 tests
133
+ and conformance corpus are implemented and gated: 957 tests
113
134
  (63 properties) at 100% coverage, zero Dialyzer errors, `--strict`
114
135
  Credo clean, a 129-case conformance corpus with a mutation gate, and a
115
136
  byte-agreement gate against an independent second-language verifier.
@@ -159,12 +180,16 @@ mix deps.get
159
180
  mix quality
160
181
  ```
161
182
 
162
- `mix quality` runs dependency audits, formatting, warnings-as-errors
163
- compilation, Credo, tests with the 100% coverage threshold, the
164
- conformance corpus and its mutation gate, the second-language verifier
165
- agreement gate, Dialyzer, documentation with warnings-as-errors, and the
166
- release-candidate check (requirement-map completeness plus protocol-doc
167
- coupling). Every gate carries a recorded red proof — see the requirement map at
183
+ `mix quality` runs dependency audits (retirement, the unused-lock-entry
184
+ check `deps.unlock --check-unused`, advisories, and dependency
185
+ currency), formatting, warnings-as-errors compilation, Credo,
186
+ tests with the 100% coverage threshold, the conformance corpus and its
187
+ mutation gate, the npm kit build, the TypeScript guide's import example,
188
+ the second-language verifier agreement gate, the compatibility replay, Dialyzer, documentation with
189
+ warnings-as-errors, the specification-extraction, grammar-derivation,
190
+ registry-equality, and release-asset gates, and the release-candidate
191
+ check (requirement-map completeness, specification coupling, and the
192
+ release identity chain). Every gate carries a recorded red proof — see the requirement map at
168
193
  `docs/design/requirement-map.md` in this repository.
169
194
 
170
195
  ### Conformance corpus
@@ -200,11 +225,11 @@ compatibility, and federation semantics. Run it:
200
225
  ```bash
201
226
  node verifier/cli.ts --corpus priv/conformance # exit 0/1/2, report bytes on stdout
202
227
  node verifier/self_checks.ts # RFC 8785 Appendix B, window matrix,
203
- # Ed25519 keys, stored JOSE vectors
204
- mix verifier.agreement # byte-agrees the TS report with the
205
- # escript's (repo AND built archive),
206
- # runs the self-checks, and proves three
207
- # seeded reds fire
228
+ # Ed25519 keys, stored JOSE vectors
229
+ mix verifier.agreement # byte-agrees the TS report with the
230
+ # escript's (repo AND built archive),
231
+ # runs the self-checks, and proves its
232
+ # seeded reds (planted breaks) fire
208
233
  ```
209
234
 
210
235
  The agreement gate is part of `mix quality`: the two implementations must
@@ -217,7 +242,8 @@ Every guide ships in the package and renders on HexDocs:
217
242
 
218
243
  - Start here: [getting started](documentation/getting-started.md) ·
219
244
  [quickstart](documentation/quickstart.md) ·
220
- [TypeScript quickstart](documentation/typescript.md)
245
+ [TypeScript quickstart](documentation/typescript.md) ·
246
+ [Livebook walkthrough](docs/livebooks/abp-walkthrough.livemd)
221
247
  - Concepts: [what a blueprint is](documentation/what-a-blueprint-is.md) ·
222
248
  [what a deployment is](documentation/what-a-deployment-is.md) ·
223
249
  [portability](documentation/portability.md) ·
@@ -1 +1 @@
1
- {"archive_is_publication_authorization":false,"corpus_digest":"sha-256:WOZcBfvCW88L6TG_66vxG1fw0QN8cCXrJxveqHgI8a4","digest_identity":"rfc8785-jcs+sha-256+domain-separated+base64url-unpadded","format":"agent-blueprint-protocol-release-metadata","index_sha256_base64url":"GKUP9TjzCWcyTCwYtEMWvFJNOWzztpY-aJBjm6vceZQ","manifest_version":2,"package":"agent_blueprint_protocol","package_version":"0.8.1","prior_census_verdicts":{"sha-256:sg6Fo7p8nZpJDzxFn4dXHBWgbGvEvtOk-7t3m7OT7Yo":"equivalent","sha-256:vMyREM8ggUqVvGG0y2e4Gf-KmpksJjnx2eF8UjtpVP8":"equivalent"},"protocol_revisions_supported":[1],"registry_digest":"sha-256:FG2f38K0hba8tTP7iUaw7vHjgcnN_5F5Mp0v4G6UDVs","spec_digest":"sha-256:CsVC7jVvA2ZP0NA6D5_h94A_ryb6F795h7ZpSo66CBA","verification_semantics_version":1,"verifier_kit":{"name":"@agent-blueprint-protocol/verifier","registry":"npm","version":"0.8.1"},"verifier_runtime":"node>=24"}
1
+ {"archive_is_publication_authorization":false,"corpus_digest":"sha-256:WOZcBfvCW88L6TG_66vxG1fw0QN8cCXrJxveqHgI8a4","digest_identity":"rfc8785-jcs+sha-256+domain-separated+base64url-unpadded","format":"agent-blueprint-protocol-release-metadata","index_sha256_base64url":"GKUP9TjzCWcyTCwYtEMWvFJNOWzztpY-aJBjm6vceZQ","manifest_version":2,"package":"agent_blueprint_protocol","package_version":"0.8.2","prior_census_verdicts":{"sha-256:sg6Fo7p8nZpJDzxFn4dXHBWgbGvEvtOk-7t3m7OT7Yo":"equivalent","sha-256:vMyREM8ggUqVvGG0y2e4Gf-KmpksJjnx2eF8UjtpVP8":"equivalent"},"protocol_revisions_supported":[1],"registry_digest":"sha-256:FG2f38K0hba8tTP7iUaw7vHjgcnN_5F5Mp0v4G6UDVs","spec_digest":"sha-256:aBgeih79woOR7YmJ_OBhyFgKU0j2euO-eieJKxLVDeA","verification_semantics_version":1,"verifier_kit":{"name":"@agent-blueprint-protocol/verifier","registry":"npm","version":"0.8.2"},"verifier_runtime":"node>=24"}
@@ -2,9 +2,12 @@
2
2
  // RFC 7515 compact + RFC 7797 b64=false unencoded detached payload, Ed25519
3
3
  // via node:crypto (one-shot verify arg order on node ≥ 24 is
4
4
  // (algorithm, data, key, signature) — probed on v25.9.0), and the
5
- // small-order / off-curve public-key rejection the twin added after the
6
- // found live (:crypto AND OpenSSL both accept small-order keys
7
- // with all-zero signatures — a universal forgery), and the strict
5
+ // small-order / off-curve public-key rejection the Elixir twin also
6
+ // carries, added after a live finding (:crypto accepts forgeries under small-order keys: under the
7
+ // identity key, R = identity with S = 0 verifies for every message; measured
8
+ // October 14, 2026, node:crypto on Node 22.23.1 accepts the same forgery and
9
+ // Node 24.19.0 rejects it — runtime-dependent, which is why the rule lives
10
+ // here), and the strict
8
11
  // signature rule (R canonical and not small-order, S < L) checked before
9
12
  // node:crypto, so the verdict never depends on the runtime's backend.
10
13
  //
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-blueprint-protocol/verifier",
3
- "version": "0.8.1",
3
+ "version": "0.8.2",
4
4
  "description": "Installable verifier for the Agent Blueprint Protocol: canonical-bytes, digest, signature, bounds, and conformance-corpus verification. Non-authorizing \u2014 evidence, never a decision.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {