@uvrn/core 1.0.3 → 1.3.0

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 (2) hide show
  1. package/README.md +15 -1
  2. package/package.json +14 -26
package/README.md CHANGED
@@ -1,9 +1,11 @@
1
1
  # @uvrn/core
2
2
 
3
- UVRN Delta Engine core — deterministic multi-source comparison and verification. Runs the Delta formula on bundles, produces canonical receipts with SHA-256 hashes, and validates or verifies bundles and receipts.
3
+ UVRN Delta Engine core — deterministic multi-source comparison and verification. Runs the Delta formula on bundles, produces canonical receipts with SHA-256 hashes, and validates or verifies bundles and receipts. **Release:** 1.3.0.
4
4
 
5
5
  **Disclaimer:** UVRN is in Alpha testing. The engine measures whether your sources agree with each other — not whether they’re correct. Final trust of output rests with the user. Use at your own risk. Have fun.
6
6
 
7
+ *UVRN makes no claims to "truth", the "verification" is the output of math — it is up to any user to decide if claim is actually "true" — Research and testing are absolutely recommended per use case and individual system!!*
8
+
7
9
  ## Install
8
10
 
9
11
  ```bash
@@ -60,6 +62,18 @@ console.log(receipt.hash); // SHA-256 of canonical receipt
60
62
  - **Validate before running** — Use `validateBundle(bundle)` to check structure and threshold without executing the engine.
61
63
  - **Integrate into pipelines** — Use as a library in CI, ETL, or any service that needs deterministic comparison and proof.
62
64
 
65
+ ### Use case: Product / content research
66
+
67
+ Your audience and market data often live in multiple places: platform analytics (e.g. YouTube, Spotify), surveys, CRM exports, or APIs. When one source says +41%, another +35%, and a third +38%, it’s hard to know if you can safely pivot or ship — **who do you trust?**
68
+
69
+ UVRN helps **content creators, product teams, and designers** reconcile that split. You feed **2 to 100+ data sources** into the Delta Engine (each with comparable metrics). The engine:
70
+
71
+ 1. **Canonically serializes** the inputs, runs a **deterministic delta comparison**, and checks whether the spread is within your **threshold** (e.g. 8%).
72
+ 2. Produces a **verifiable receipt** with a clear outcome: **consensus** (sources agree within threshold — e.g. “Both signals agree. Pivot with proof.”) or **indeterminate** (outside threshold — time to investigate).
73
+ 3. The receipt is **hash-verified** and **reproducible**; you can share it with partners or your team so anyone can verify the same result.
74
+
75
+ **Example:** Three sources — YouTube Analytics (+41% how-to views), a subscriber survey (+35% demand), and a platform API (+38% engagement). The engine returns **consensus** with a 4.83% delta (within an 8% threshold), so the designer or creator can confidently decide to pivot or ship, backed by a receipt — not just a hunch.
76
+
63
77
  ## Links
64
78
 
65
79
  **Open source:** Source code and issues: [GitHub (uvrn-packages)](https://github.com/UVRN-org/uvrn-packages). Project landing: [UVRN](https://github.com/UVRN-org/uvrn).
package/package.json CHANGED
@@ -1,18 +1,11 @@
1
1
  {
2
2
  "name": "@uvrn/core",
3
- "version": "1.0.3",
4
- "publishConfig": {
5
- "access": "public"
6
- },
3
+ "version": "1.3.0",
4
+ "publishConfig": { "access": "public" },
7
5
  "description": "UVRN engine core — deterministic protocol infrastructure",
8
6
  "main": "dist/index.js",
9
7
  "types": "dist/index.d.ts",
10
- "keywords": [
11
- "uvrn",
12
- "deterministic",
13
- "protocol",
14
- "consensus"
15
- ],
8
+ "keywords": ["uvrn", "deterministic", "protocol", "consensus"],
16
9
  "license": "MIT",
17
10
  "repository": {
18
11
  "type": "git",
@@ -20,6 +13,14 @@
20
13
  "directory": "uvrn-core"
21
14
  },
22
15
  "homepage": "https://github.com/UVRN-org/uvrn-packages#readme",
16
+ "scripts": {
17
+ "build": "tsc",
18
+ "test": "jest",
19
+ "test:watch": "jest --watch",
20
+ "test:coverage": "jest --coverage",
21
+ "lint": "eslint src/**/*.ts",
22
+ "clean": "rm -rf dist"
23
+ },
23
24
  "devDependencies": {
24
25
  "@types/jest": "^29.5.0",
25
26
  "@types/node": "^20.0.0",
@@ -31,19 +32,6 @@
31
32
  "typescript": "^5.3.0"
32
33
  },
33
34
  "dependencies": {},
34
- "files": [
35
- "dist",
36
- "README.md"
37
- ],
38
- "engines": {
39
- "node": ">=18.0.0"
40
- },
41
- "scripts": {
42
- "build": "tsc",
43
- "test": "jest",
44
- "test:watch": "jest --watch",
45
- "test:coverage": "jest --coverage",
46
- "lint": "eslint src/**/*.ts",
47
- "clean": "rm -rf dist"
48
- }
49
- }
35
+ "files": ["dist", "README.md"],
36
+ "engines": { "node": ">=18.0.0" }
37
+ }