@amalgm/live 0.2.80 → 0.2.81-main.34176653973

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 (3) hide show
  1. package/PURPOSE.md +12 -0
  2. package/README.md +11 -0
  3. package/package.json +23 -2
package/PURPOSE.md CHANGED
@@ -18,6 +18,12 @@ its cutover.
18
18
 
19
19
  ## Axioms
20
20
 
21
+ Managed package delivery starts from a clean, exact main or preview source
22
+ commit. Its workflow occurrence supplies only the generated version and source
23
+ record, and native consumer gates use the same packed bytes as publication.
24
+ Candidate publication is an assembly input; it does not change Shell's Live pin
25
+ or certify a new wire contract, cloud migration or cross-machine rollout.
26
+
21
27
  1. **The SDK owns portable live contracts, not a machine.** Entity-record
22
28
  shapes, resource identifiers, content manifests, checksums, frame shapes,
23
29
  mutation envelopes, ordering rules, and portable Watch laws belong here;
@@ -483,3 +489,9 @@ The portable entity Apply/Verify subsystem exists here. Production filesystem,
483
489
  SQLite, immutable-cache, Git-process, and watcher composition remains a Shell
484
490
  release step; until that published-package adoption is complete, universal
485
491
  cross-machine materialization is not a shipped claim.
492
+
493
+ Registry credentials are available only to the final protected publication job,
494
+ after every native examination proves the exact candidate bytes.
495
+ Native consumers install the archive as a dependency, so SDK development
496
+ dependencies never become an end-user installation requirement.
497
+ Each admitted owner gate proves its actual checkout equals the managed source.
package/README.md CHANGED
@@ -45,3 +45,14 @@ npm install
45
45
  npm test # build + unit tests
46
46
  npm run test:parity # golden vectors vs the shipped engine runtime
47
47
  ```
48
+
49
+ ## Managed candidate delivery
50
+
51
+ The owner workflows verify main/preview source and publish one immutable npm
52
+ candidate after ESM/CommonJS tarball examinations on all three desktop OSes.
53
+ The exact version, source commit and integrity travel in the release record.
54
+ Candidate tags do not change installed Shell pins or certify the cloud protocol;
55
+ see `AGENTS.md` for the delivery and adoption boundary. Every native examination must pass before the final publisher receives its
56
+ `npm-release` environment's `NPM_TOKEN` secret. An already configured npm trusted
57
+ publisher can operate without that token. Private source retains exact source
58
+ and artifact evidence rather than npm public-source provenance.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amalgm/live",
3
- "version": "0.2.80",
3
+ "version": "0.2.81-main.34176653973",
4
4
  "description": "Portable realtime SDK for Amalgm — wire contracts, mutation discipline, and delivery state machines behind host-injected adapters.",
5
5
  "type": "module",
6
6
  "main": "./dist-cjs/index.js",
@@ -95,9 +95,30 @@
95
95
  "certification:release": "node certification/src/release.mjs prepare --profile certification",
96
96
  "certification:preflight": "node certification/src/release.mjs preflight",
97
97
  "test": "npm run build && node --test",
98
- "test:parity": "npm run build && node --test tests/parity/"
98
+ "test:parity": "npm run build && node --test tests/parity/",
99
+ "release:admit": "node scripts/release/package.mjs admit",
100
+ "release:prepare": "node scripts/release/package.mjs prepare",
101
+ "release:examine": "node scripts/release/package.mjs examine",
102
+ "release:publish": "node scripts/release/package.mjs publish",
103
+ "test:release": "node --test scripts/release/*.test.mjs"
99
104
  },
100
105
  "devDependencies": {
101
106
  "typescript": "^5.7.3"
107
+ },
108
+ "amalgmRelease": {
109
+ "schema": 1,
110
+ "workflow": "verify.yml",
111
+ "jobs": [
112
+ "verify"
113
+ ],
114
+ "verify": "test",
115
+ "cli": []
116
+ },
117
+ "gitHead": "31e4c3dcf5e82c98aad2cbe076205e8042afccc8",
118
+ "amalgmSource": {
119
+ "repository": "amalgm-inc/amalgm-live",
120
+ "branch": "main",
121
+ "commit": "31e4c3dcf5e82c98aad2cbe076205e8042afccc8",
122
+ "occurrence": "34176653973"
102
123
  }
103
124
  }