xoonya 2.15.0 → 3.0.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.
package/README.md CHANGED
@@ -82,6 +82,22 @@ The current proof breadth already includes:
82
82
  - proof-side continuity for economic consequence carry
83
83
  - proof-adjacent integration registration and review
84
84
 
85
+ It also already carries broader first-class proof and interoperability lanes for:
86
+
87
+ - framework continuity across `langchain`, `langgraph`, `semantic_kernel`, `autogen`, `crewai`, and `llamaindex`
88
+ - native and external verification methods such as `XNYA`, JWT assertion, DID VC, SD-JWT VC, signed-envelope, detached assertion, and partner proof-envelope compatibility
89
+ - operator and artifact lanes such as telemetry, provenance, artifact distribution, shared signals, feature control, trust portability, and external proof import review
90
+
91
+ If you want the broadest machine-readable census for these already-core proof lanes, inspect:
92
+
93
+ - `GET /v1/integration-matrix`
94
+ - `GET /v1/proof-bridge`
95
+ - `GET /v1/telemetry`
96
+ - `GET /v1/provenance`
97
+ - `GET /v1/artifact-distribution`
98
+ - `GET /v1/shared-signals`
99
+ - `GET /v1/feature-control`
100
+
85
101
  ## One-Line After Install
86
102
 
87
103
  If you only run two commands after install, use:
@@ -105,31 +121,39 @@ If you want the shortest machine-readable discovery path, inspect:
105
121
 
106
122
  If you are new to the proof-side package, use this order:
107
123
 
108
- 1. read [START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/START_HERE.md)
124
+ 1. read [START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/START_HERE.md)
109
125
  2. run `node examples/package_quickstart.js`
110
126
  3. run `npm run verify:all`
111
- 4. use [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/FINAL_CONTRACT.md) and [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/SERVICE_CONTRACT.md) as the durable public contract
127
+ 4. use [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/FINAL_CONTRACT.md) and [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/SERVICE_CONTRACT.md) as the durable public contract
112
128
 
113
129
  If you are reading the GitHub repo and want deeper product context beyond the npm starter path, continue with:
114
130
 
115
- - [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/WHY_XYTARA_XOONYA.md)
116
- - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
131
+ - [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/WHY_XYTARA_XOONYA.md)
132
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PARTNER_READY_PATH.md)
117
133
 
118
134
  If you want one concrete cross-repo adoption story, start with:
119
135
 
120
- - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
136
+ - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
121
137
 
122
138
  If you want the shortest neutral external-adoption bundle, continue with:
123
139
 
124
- - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
125
- - [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PUBLIC_DEMO_SCRIPT.md)
126
- - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/EXAMPLE_PATHS.md)
140
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PARTNER_READY_PATH.md)
141
+ - [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PUBLIC_DEMO_SCRIPT.md)
142
+ - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/EXAMPLE_PATHS.md)
127
143
  - `node examples/partner_proof_walkthrough.js`
128
144
 
129
145
  If you are integrating from outside the stack, also read:
130
146
 
131
- - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
132
- - [integrations/PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
147
+ - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
148
+ - [integrations/PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
149
+
150
+ If you want the broader already-core proof continuity layers, continue with:
151
+
152
+ - [XOONYA_NATIVE_PROOF_FORMAT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/XOONYA_NATIVE_PROOF_FORMAT.md)
153
+ - [XOONYA_NATIVE_ATOM_SPEC.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/XOONYA_NATIVE_ATOM_SPEC.md)
154
+ - [XNYA_REFERENCE_IMPLEMENTATIONS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/XNYA_REFERENCE_IMPLEMENTATIONS.md)
155
+ - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/OPERATOR_START_HERE.md)
156
+ - [XOONYA_FOLLOWTHROUGH_TRUTH_MODEL.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/XOONYA_FOLLOWTHROUGH_TRUTH_MODEL.md)
133
157
 
134
158
  ## Production Path
135
159
 
@@ -282,7 +306,7 @@ Current built-in methods:
282
306
 
283
307
  xoonya Native is the optional native proof/result/attestation format direction for machine proof. It is not a replacement for JWT, OAuth, OIDC, DID/VC, or SD-JWT VC. Those remain interoperability lanes.
284
308
 
285
- The native standard is xoonya's own fixed-size hot-path commitment atom, cold-path proof envelope, semantic-free core bytes, and deterministic validation. The current implemented native methods are `xoonya-native-sha256-v1`, `xoonya-native-signed-v1`, and `xoonya-native-anchored-v1`. The signed native method verifies Ed25519, secp256k1, and P-256 today and keeps PQ/hybrid suites in the registry until their validators are implemented, so the standard stays agnostic without overclaiming. The anchored native method binds receipts to declared anchor/finality/attestation refs without claiming the external system has been independently verified by xoonya.
309
+ The native standard is xoonya's own fixed-size hot-path commitment atom, cold-path proof envelope, semantic-free core bytes, and deterministic validation. The current implemented native methods are `xoonya-native-sha256-v1`, `xoonya-native-signed-v1`, `xoonya-native-anchored-v1`, and `xoonya-native-hybrid-v1`. The signed native method verifies Ed25519, secp256k1, and P-256 today. The hybrid native method verifies only registered runtime-supported suite pairs, with `ed25519+ml-dsa-65` as the current promoted baseline and other pairings staying non-claimable until runtime support and vectors exist. The anchored native method binds receipts to declared anchor/finality/attestation refs without claiming the external system has been independently verified by xoonya.
286
310
 
287
311
  The atom ladder is treated as native xoonya design, not a runtime dependency: `xoonya-native-atom/v1` is the 58-byte classical commitment atom, `xoonya-native-atom/v2` is the 70-byte PQ-horizon identity commitment candidate, and `xoonya-native-atom/v3-contingency` stays reserved for a future digest-family shift only if the underlying hash assumptions materially change.
288
312
 
@@ -292,7 +316,7 @@ XNYA atom conformance now includes stable machine-readable reject codes and adve
292
316
 
293
317
  The native payload profile is now explicit: `xoonya-native-payload-profile/v1` uses the binary `XNYP` magic and typed fields with deterministic ordering, fixed-width integer encoding, unknown-field policy checks, and no floats or loose JSON semantics. The optional `xoonya-native-line-rate-frame/v1` wraps an existing 58-byte or 70-byte `XNYA` atom with a 2-byte checksum for transport fast rejection; it does not change the atom and does not claim signature, encryption, custody, settlement, or external finality truth.
294
318
 
295
- The `XNYA-compatible` mark is now defined as a conformance claim, not a marketing label. Implementations may use it only when atom bytes, payload profile rules, proof-envelope method behavior, adversarial vectors, and stable error codes match the published artifacts. The mark must not be used to claim PQ/hybrid verification, live external-provider execution, chain finality, custody, identity/auth, or external issuer truth without separate verifier evidence. Until real PQ/hybrid validators exist, `xoonya-native-hybrid-v1` is an explicit design-gate method that rejects with `native_hybrid_design_gated`.
319
+ The `XNYA-compatible` mark is now defined as a conformance claim, not a marketing label. Implementations may use it only when atom bytes, payload profile rules, proof-envelope method behavior, adversarial vectors, and stable error codes match the published artifacts. The mark must not be used to claim unregistered or runtime-unsupported PQ/hybrid verification, live external-provider execution, chain finality, custody, identity/auth, or external issuer truth without separate verifier evidence. `xoonya-native-hybrid-v1` is now implemented only for registered runtime-supported suite pairs, with current first-class verification centered on `ed25519+ml-dsa-65`.
296
320
 
297
321
  The JavaScript `xoonya` package is the current canonical XNYA reference implementation. A Python candidate scaffold now verifies the XNYA atom, native atom adversarial, XNYP payload profile, line-rate frame, canonical event, receipt, and non-signed proof-bundle vectors independently. It also verifies Ed25519 native signed vectors when Python's optional `cryptography` package is installed, otherwise it reports the deterministic dependency gate. It is not yet a full second reference until always-on signature-suite parity, proof-bundle round trips, and the full promotion gates pass. Rust remains planned until a verified vector-parity implementation exists.
298
322
 
@@ -364,7 +388,7 @@ curl -X POST http://127.0.0.1:4310/v1/events/hash ^
364
388
 
365
389
  Environment example:
366
390
 
367
- - [`.env.example`](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/.env.example)
391
+ - [`.env.example`](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/.env.example)
368
392
 
369
393
  ## Service Routes
370
394
 
@@ -585,7 +609,7 @@ This is intended to make the proof-side continuation path easier to adopt as the
585
609
 
586
610
  The current `1.26.0` line finalizes that public shape into a cleaner production-ready package:
587
611
 
588
- - a publishable [START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/START_HERE.md) onboarding path
612
+ - a publishable [START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/START_HERE.md) onboarding path
589
613
  - clearer top-level README entry points for the default proof-side production flow
590
614
  - publishable contract, compatibility, and terminology docs carried in the package tarball
591
615
  - naming cleanup that keeps the public story anchored to `xytara` and `xoonya`
@@ -643,13 +667,13 @@ xoonya conformance
643
667
  xoonya conformance --json
644
668
  ```
645
669
 
646
- The conformance command verifies the published vector files shipped in the package. The positive set covers `legacy-opreturn-v1`, `detached-assertion-v1`, `xoonya-native-sha256-v1`, `xoonya-native-signed-v1`, `xoonya-native-anchored-v1`, `jwt-assertion-v1`, `did-vc-v1`, `sd-jwt-vc-v1`, `signed-envelope-v1`, and `partner-proof-envelope-v1`. The adversarial set covers bad event versions, missing signatures, mismatched commitments, unsupported methods, ambiguous `none`, explicit native hybrid/PQ design-gated rejection, replayed receipt context, native digest tampering, native signed proof tampering, native anchored proof tampering, native-to-detached downgrade attempts, and receipt-id mismatches.
670
+ The conformance command verifies the published vector files shipped in the package. The positive set covers `legacy-opreturn-v1`, `detached-assertion-v1`, `xoonya-native-sha256-v1`, `xoonya-native-signed-v1`, `xoonya-native-anchored-v1`, `xoonya-native-hybrid-v1`, `jwt-assertion-v1`, `did-vc-v1`, `sd-jwt-vc-v1`, `signed-envelope-v1`, and `partner-proof-envelope-v1`. The adversarial set covers bad event versions, missing signatures, mismatched commitments, unsupported methods, ambiguous `none`, replayed receipt context, native digest tampering, native signed proof tampering, native anchored proof tampering, native hybrid signature and key-binding tampering, native-to-detached downgrade attempts, and receipt-id mismatches.
647
671
 
648
672
  Published proof hardening artifacts:
649
673
 
650
- - [conformance-vectors.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/vectors/conformance-vectors.json)
651
- - [adversarial-vectors.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/vectors/adversarial-vectors.json)
652
- - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
674
+ - [conformance-vectors.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/vectors/conformance-vectors.json)
675
+ - [adversarial-vectors.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/vectors/adversarial-vectors.json)
676
+ - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
653
677
 
654
678
  ## Control Files
655
679
 
@@ -685,7 +709,7 @@ Those helpers are intended to normalize proof-adjacent integrations without lett
685
709
 
686
710
  For the lightweight external-builder path, use:
687
711
 
688
- - [PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
712
+ - [PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
689
713
 
690
714
  For lightweight local review flows, `xoonya` also includes a small repo-local proof-side CLI when working from a cloned `xoonya` repository:
691
715
 
@@ -706,3 +730,4 @@ The proof-side readiness layer now also makes promotion posture explicit without
706
730
  - production-default-ready means certification, maturity, bundled posture, and selection posture all line up
707
731
  - blockers are returned as data instead of being left implicit
708
732
  - promotion workflow summaries now show the next proof-side transition and the current recommendation without introducing approval state
733
+
package/RELEASE_NOTES.md CHANGED
@@ -1,15 +1,15 @@
1
- `xoonya` 2.15.0 is the final intermediary closeout release for frozen proof truth surfaces and clearer proof-side first contact before the final major closeout.
1
+ `xoonya` 3.0.1 is the synchronized stability patch for the live proof, verification, continuity, governance, replay, and public first-contact line.
2
2
 
3
- This release keeps the synchronized public-release bundle intact while freezing the proof-side truth models, tightening umbrella first-contact alignment, and turning the proof-side story into one coherent final intermediary step before the final major closeout.
3
+ This release keeps the public proof line synchronized after the major cut by preserving the same frozen proof truth models, widened finish-line scope, and naxytra public contract, proof, release, and gate surfaces while tightening the installable package experience for outside agents and builders.
4
4
 
5
5
  Highlights:
6
6
 
7
- - freezes `/v1/proof-truth` and `/v1/proof-truth/summary` as the named proof object boundary
8
- - freezes `/v1/default-path` and `/v1/default-path/summary` as the named proof-side multi-surface entry boundary
9
- - freezes `/v1/followthrough-truth` and `/v1/followthrough-truth/summary` as the named bridge, governance, portability, and verification claim boundary
7
+ - keeps `/v1/proof-truth` and `/v1/proof-truth/summary` as the named proof object boundary
8
+ - keeps `/v1/default-path` and `/v1/default-path/summary` as the named proof-side multi-surface entry boundary
9
+ - keeps `/v1/followthrough-truth` and `/v1/followthrough-truth/summary` as the named bridge, governance, portability, and verification claim boundary
10
10
  - keeps verification services, trust-portability surfaces, governance/dispute visibility, and reference-implementation posture aligned with the same synchronized public release line
11
- - preserves XNYA-compatible conformance, native reference implementation boundaries, external proof import boundaries, and the PQ/hybrid design gate
12
- - strengthens the native-standard, payload-profile, line-rate-frame, and conformance-mark story as one discoverable proof stack
11
+ - promotes bounded native hybrid live verification for registered runtime-supported vector-covered suites instead of leaving PQ/hybrid as a design-only posture
12
+ - preserves XNYA-compatible conformance, native reference implementation boundaries, external proof import boundaries, deterministic replay posture, and proof-side governance as one discoverable proof stack inside the final major line
13
13
  - keeps `RELEASE_NOTES.md` scoped to the current release so npm and GitHub release notes stay clean
14
14
  - keeps the canonical `https://naxytra.com/xoonya` public product URL and single naxytra website positioning intact
15
- - verifies the release candidate, full package verifier, umbrella pre-deploy gates, and clean-consumer release smoke
15
+ - verifies the release candidate, full package verifier, umbrella pre-deploy gates, and clean-consumer release smoke before the synchronized stability patch
package/START_HERE.md CHANGED
@@ -4,7 +4,7 @@ This is the shortest reliable path for understanding and using the public `xoony
4
4
 
5
5
  The phase program is now complete, so this file is the right starting point for a closed and release-shaped proof system rather than an in-flight milestone build.
6
6
 
7
- The next public release path is intentionally intermediary and is now centered on the paired `2.15.0` final intermediary closeout milestone documented in [RELEASE_2_15_0_FINAL_INTERMEDIARY_CLOSEOUT_PLAN.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/docs/release/RELEASE_2_15_0_FINAL_INTERMEDIARY_CLOSEOUT_PLAN.md) and [PUBLISH_PLAN.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PUBLISH_PLAN.md). That release is meant to freeze the proof-side public truth surfaces before the final `3.0.0` consolidation.
7
+ The product-side implementation, proof posture, and bounded hybrid verification work for the widened `3.0.0` finish line are now complete. The remaining step is the synchronized public `3.0.0` release cut, publish, deploy, and verification sequence documented in [NAXYTRA_3_0_0_RELEASE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/docs/release/NAXYTRA_3_0_0_RELEASE_CONTRACT.md) and [PUBLISH_PLAN.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PUBLISH_PLAN.md).
8
8
 
9
9
  ## 1. Understand The Role
10
10
 
@@ -62,13 +62,13 @@ This is the fastest way to see the intended proof-side package story end-to-end.
62
62
 
63
63
  If you want the clearest cross-repo adoption path instead of the broad package tour, continue with:
64
64
 
65
- - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
65
+ - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
66
66
 
67
67
  If you want the shortest neutral external-adoption bundle, continue with:
68
68
 
69
- - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
70
- - [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PUBLIC_DEMO_SCRIPT.md)
71
- - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/EXAMPLE_PATHS.md)
69
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PARTNER_READY_PATH.md)
70
+ - [PUBLIC_DEMO_SCRIPT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PUBLIC_DEMO_SCRIPT.md)
71
+ - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/EXAMPLE_PATHS.md)
72
72
  - `node examples/partner_proof_walkthrough.js`
73
73
 
74
74
  ## 3. Verify The Whole Package
@@ -85,8 +85,8 @@ This is the production-confidence check for the published proof package surface.
85
85
 
86
86
  For long-term product understanding, read:
87
87
 
88
- - [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/FINAL_CONTRACT.md)
89
- - [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/SERVICE_CONTRACT.md)
88
+ - [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/FINAL_CONTRACT.md)
89
+ - [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/SERVICE_CONTRACT.md)
90
90
  - `GET /openapi.json`
91
91
  - `GET /asyncapi.json`
92
92
  - `GET /cloudevents.json`
@@ -108,23 +108,23 @@ For long-term product understanding, read:
108
108
  - `GET /v1/result-package-trust`
109
109
  - `GET /v1/event-systems`
110
110
  - `GET /v1/integrations`
111
- - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_STATUS.md)
112
- - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATOR_START_HERE.md)
113
- - [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATIONS_RUNBOOK.md)
114
- - [PROGRAM_COMPLETE_RELEASE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_COMPLETE_RELEASE.md)
115
- - [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/WHY_XYTARA_XOONYA.md)
116
- - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
117
- - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
118
- - [TERMINOLOGY.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/TERMINOLOGY.md)
111
+ - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PROGRAM_STATUS.md)
112
+ - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/OPERATOR_START_HERE.md)
113
+ - [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/OPERATIONS_RUNBOOK.md)
114
+ - [PROGRAM_COMPLETE_RELEASE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PROGRAM_COMPLETE_RELEASE.md)
115
+ - [WHY_XYTARA_XOONYA.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/WHY_XYTARA_XOONYA.md)
116
+ - [CARRIED_HANDOFF_DEMO.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/CARRIED_HANDOFF_DEMO.md)
117
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PARTNER_READY_PATH.md)
118
+ - [TERMINOLOGY.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/TERMINOLOGY.md)
119
119
 
120
120
  ## 5. If You Are Integrating From Outside
121
121
 
122
122
  Continue with:
123
123
 
124
- - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
125
- - [integrations/PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
126
- - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PARTNER_READY_PATH.md)
127
- - [COMPATIBILITY_NOTE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/COMPATIBILITY_NOTE.md)
124
+ - [CROSS_RUNTIME_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/CROSS_RUNTIME_POSTURE.md)
125
+ - [integrations/PROOF_INTEGRATION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/integrations/PROOF_INTEGRATION_PROCESS.md)
126
+ - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PARTNER_READY_PATH.md)
127
+ - [COMPATIBILITY_NOTE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/COMPATIBILITY_NOTE.md)
128
128
 
129
129
  ## 6. Production Reading Rule
130
130
 
@@ -146,5 +146,5 @@ If you want the shortest CLI-first read of the package after install, use:
146
146
 
147
147
  Use:
148
148
 
149
- - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/PROGRAM_STATUS.md)
150
- - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xoonya/OPERATOR_START_HERE.md)
149
+ - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/PROGRAM_STATUS.md)
150
+ - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_naxytra/naxytra/xoonya/OPERATOR_START_HERE.md)
@@ -55,7 +55,7 @@ It currently covers:
55
55
  - receipt emission for external assertion, native digest, legacy OP_RETURN, and native anchored methods
56
56
  - proof-bundle build/verify parity for non-signed native methods
57
57
  - adversarial reason parity for non-signed proof-bundle checks
58
- - deterministic `native_hybrid_design_gated` rejection for the future hybrid/PQ method
58
+ - bounded hybrid-method awareness without yet claiming independent PQ/hybrid validator parity
59
59
  - optional Ed25519 native signed verification when the Python `cryptography` package is available
60
60
  - deterministic `native_signature_crypto_dependency_missing` when the optional crypto dependency is absent
61
61
 
@@ -65,7 +65,7 @@ Run:
65
65
  npm run verify:reference-python
66
66
  ```
67
67
 
68
- This is vector-parity progress, not a full reference promotion. Python does not yet claim always-on native signature-suite cryptographic verification, secp256k1/P-256 parity, external method import, or all native signed proof-bundle round-trip behavior.
68
+ This is vector-parity progress, not a full reference promotion. Python does not yet claim always-on native signature-suite cryptographic verification, secp256k1/P-256 parity, external method import, independent PQ/hybrid signature parity, or all native signed proof-bundle round-trip behavior.
69
69
 
70
70
  Optional Ed25519 crypto check:
71
71
 
@@ -120,7 +120,7 @@ An implementation may claim `XNYA-compatible` only when it:
120
120
  - rejects unsupported or malformed native atoms with deterministic errors
121
121
  - rejects `algorithm: "none"` as a production proof method
122
122
  - verifies only implemented signature suites with suite-specific validators
123
- - treats PQ/hybrid methods as design-gated until validators and vectors exist
123
+ - treats PQ/hybrid methods as independently unverified until that runtime has its own validators and vector parity
124
124
  - binds external proof formats without claiming external issuer truth
125
125
  - binds anchor references without claiming external chain or provider finality truth
126
126
 
@@ -325,13 +325,36 @@ Important boundary:
325
325
 
326
326
  ### `xoonya-native-hybrid-v1`
327
327
 
328
- Design-gated future extension.
328
+ Implemented for registered runtime-supported suite pairs.
329
329
 
330
- This should provide stronger-crypto or PQC-sensitive proof lanes if production need appears. It should not become the default until there is a real reason.
330
+ This method provides stronger-crypto and PQ-sensitive proof lanes without redefining the rest of the native proof model. It is not the global default; it is the promoted higher-assurance lane when a runtime can actually verify the declared classical and PQ signatures together.
331
331
 
332
- The current rule is strict: `xoonya-native-hybrid-v1` remains design-gated until runtime validators, public key formats, conformance vectors, adversarial vectors, and deterministic error codes exist. xoonya may expose readiness and promotion criteria for this method, but must not claim PQC or hybrid verification before those artifacts are real.
332
+ The current rule is strict:
333
333
 
334
- Before promotion, any proof bundle that directly asks the current verifier to accept `xoonya-native-hybrid-v1` must fail with the deterministic reason `native_hybrid_design_gated`. Hybrid-looking native signatures also must not verify through an external assertion method; those downgrade attempts fail as `signature_method_mismatch`.
334
+ - only registered runtime-supported suite pairs may be claimed as verified
335
+ - current first-class promoted verification is `ed25519+ml-dsa-65`
336
+ - other candidate hybrid combinations remain non-claimable until runtime support, vectors, and deterministic error behavior exist
337
+
338
+ Required hybrid fields:
339
+
340
+ - `method`
341
+ - `hybrid_suite`
342
+ - `identity_ref`
343
+ - `classical_public_key_ref`
344
+ - `pq_public_key_ref`
345
+ - `classical_public_key_material`
346
+ - `pq_public_key_material`
347
+ - `proof_material.classical_signature`
348
+ - `proof_material.pq_signature`
349
+ - `proof_material.signing_material_sha256`
350
+
351
+ Current adversarial expectations include:
352
+
353
+ - tampered PQ signature rejects as `native_hybrid_pq_signature_invalid`
354
+ - key-binding mismatches reject as `native_hybrid_public_key_ref_mismatch`
355
+ - downgrade attempts through external assertion methods reject as `signature_method_mismatch`
356
+
357
+ This keeps the boundary honest: xoonya now verifies the hybrid lane where the runtime and vectors are real, and refuses to overclaim beyond that runtime-supported registry.
335
358
 
336
359
  ## Crypto And Identity Support Boundary
337
360
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xoonya",
3
- "version": "2.15.0",
3
+ "version": "3.0.1",
4
4
  "description": "Deterministic proof and review engine for receipts, handoffs, governance, and verification.",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -16,7 +16,7 @@
16
16
  "url": "https://naxytra.com/xoonya"
17
17
  },
18
18
  "engines": {
19
- "node": ">=18"
19
+ "node": ">=24"
20
20
  },
21
21
  "files": [
22
22
  "index.js",