@amalgm/agents 0.2.2 → 0.2.3-main.34175696578

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 +20 -0
  2. package/README.md +27 -0
  3. package/package.json +38 -3
package/PURPOSE.md CHANGED
@@ -27,6 +27,26 @@ hosts supply explicit ports for resources owned by other products.
27
27
 
28
28
  ## Axioms
29
29
 
30
+ Consumer assembly derives exact same-branch dependency pins from the declared
31
+ package manifests and registry candidate records. One pending composition per
32
+ branch preserves human edits; complete consumer checks for the exact merge tree govern its
33
+ merge, and publication never implies installed adoption.
34
+
35
+ Managed package delivery starts from a clean, exact main or preview source
36
+ commit. The workflow occurrence supplies only its generated version and source
37
+ record; tests run against those candidate inputs before packing. Every native
38
+ gate and publication use that same tarball and integrity. A candidate tag makes
39
+ bytes available to release assembly; it never promotes an installed runtime.
40
+ Release tooling remains available inside each owner repository so a developer
41
+ or CI job never needs access to another private product repository.
42
+ Registry credentials are available only to the final protected publication job,
43
+ after every native examination proves the exact candidate bytes.
44
+ Native consumers install the archive as a dependency, so SDK development
45
+ dependencies never become an end-user installation requirement.
46
+ The repository token creates only its own dependency proposals and explicitly
47
+ dispatches checks and delivery; every admitted gate proves the actual checkout,
48
+ including the exact two-parent merge commit that becomes managed source.
49
+
30
50
  Managed releases bind to one exact published Core version and build from the
31
51
  locked dependency graph on the supported Node toolchain.
32
52
 
package/README.md CHANGED
@@ -128,3 +128,30 @@ npm run verify
128
128
  `verify` runs strict typechecking for source, tests, and examples; enforces the
129
129
  220-line source-file limit; builds JavaScript and declarations; and runs the
130
130
  real SQLite, TCP, stdio MCP, and CLI tests.
131
+
132
+ ## Managed package delivery
133
+
134
+ Managed npm delivery uses `.github/workflows/publish-package.yml` after the
135
+ exact main/preview owner checks pass. The occurrence generates a unique
136
+ prerelease version and records its source SHA; it reruns the owner suite, packs
137
+ once, and installs that tarball on Linux, macOS and Windows before publication.
138
+ The `candidate-main`/`candidate-preview` tags are release-assembly inputs and
139
+ never select installed runtimes. `package.json` declares this owner's gates,
140
+ CLI probes, peer-only exports and lifecycle permissions. The standalone runner
141
+ under `scripts/release/` is intentionally copied across owners to preserve
142
+ private repository access boundaries. The final publish step uses the `NPM_TOKEN`
143
+ secret in the `npm-release` environment. Where npm trusted publishing is
144
+ configured for this repository's `publish-package.yml` and that environment,
145
+ the token can be omitted. Authentication does not replace native certification,
146
+ exact source records or artifact integrity; private source repositories do not
147
+ receive npm's public-source provenance.
148
+
149
+ Managed dependency reconciliation reads this owner’s declared manifests and
150
+ updates exact same-branch registry candidates in one pending composition PR per
151
+ branch. The repository token explicitly dispatches the owner checks. Every declared gate must
152
+ pass for the exact merge tree; an atomic expected-base update prevents merging
153
+ with untested concurrent source. Human additions or amendments are preserved.
154
+ The half-hour CI reconciliation recovers missed dispatch hints. Assembly runs
155
+ no dependency code or lifecycle hooks, and repeated owner checks do not publish
156
+ another candidate for unchanged source. Repository policy must allow GitHub Actions to create pull requests; no
157
+ cross-repository credential or paid auto-merge feature is required.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amalgm/agents",
3
- "version": "0.2.2",
3
+ "version": "0.2.3-main.34175696578",
4
4
  "description": "Local-first agent identities, installations, and immutable revisions.",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -46,13 +46,19 @@
46
46
  "check": "tsx scripts/check-tree.ts && tsc -p tsconfig.json && tsc -p tsconfig.test.json",
47
47
  "test": "tsx --test --test-concurrency=1 --test-timeout=30000 test/*.test.ts",
48
48
  "verify": "npm run check && npm run build && npm test",
49
- "prepack": "npm run build"
49
+ "prepack": "npm run build",
50
+ "release:admit": "node scripts/release/package.mjs admit",
51
+ "release:prepare": "node scripts/release/package.mjs prepare",
52
+ "release:examine": "node scripts/release/package.mjs examine",
53
+ "release:publish": "node scripts/release/package.mjs publish",
54
+ "release:compose": "node scripts/release/compose.mjs",
55
+ "test:release": "node --test scripts/release/*.test.mjs"
50
56
  },
51
57
  "engines": {
52
58
  "node": ">=24"
53
59
  },
54
60
  "dependencies": {
55
- "@amalgm/core": "0.4.7",
61
+ "@amalgm/core": "0.4.8-main.34168902443",
56
62
  "@types/better-sqlite3": "^7.6.13",
57
63
  "@types/node": "^20.19.43",
58
64
  "better-sqlite3": "^12.6.2"
@@ -60,5 +66,34 @@
60
66
  "devDependencies": {
61
67
  "tsx": "^4.23.1",
62
68
  "typescript": "^5.9.3"
69
+ },
70
+ "amalgmRelease": {
71
+ "schema": 1,
72
+ "workflow": "verify.yml",
73
+ "jobs": [
74
+ "verify"
75
+ ],
76
+ "verify": "verify",
77
+ "cli": [
78
+ "amalgm-agents"
79
+ ]
80
+ },
81
+ "allowScripts": {
82
+ "better-sqlite3@12.11.1": true,
83
+ "esbuild@0.28.1": true,
84
+ "fsevents@2.3.3": false
85
+ },
86
+ "amalgmComposition": {
87
+ "schema": 1,
88
+ "manifests": [
89
+ "package.json"
90
+ ]
91
+ },
92
+ "gitHead": "e127c1324c238a8651f2643dd2611684dba96ff4",
93
+ "amalgmSource": {
94
+ "repository": "amalgm-inc/amalgm-agents",
95
+ "branch": "main",
96
+ "commit": "e127c1324c238a8651f2643dd2611684dba96ff4",
97
+ "occurrence": "34175696578"
63
98
  }
64
99
  }