@inventarch/distribution 2.0.0 → 3.0.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.
- package/README.md +10 -0
- package/SPEC.md +19 -1
- package/dist/adoption.d.ts +21 -0
- package/dist/adoption.d.ts.map +1 -0
- package/dist/adoption.js +187 -0
- package/dist/adoption.js.map +1 -0
- package/dist/archive.d.ts.map +1 -1
- package/dist/archive.js +4 -1
- package/dist/archive.js.map +1 -1
- package/dist/command.d.ts.map +1 -1
- package/dist/command.js +22 -6
- package/dist/command.js.map +1 -1
- package/dist/files.d.ts.map +1 -1
- package/dist/files.js +30 -23
- package/dist/files.js.map +1 -1
- package/dist/guard-registration.d.ts +120 -5
- package/dist/guard-registration.d.ts.map +1 -1
- package/dist/guard-registration.js +419 -57
- package/dist/guard-registration.js.map +1 -1
- package/dist/host-modes.d.ts.map +1 -1
- package/dist/host-modes.js +2 -2
- package/dist/host-modes.js.map +1 -1
- package/dist/host-observe.d.ts +20 -1
- package/dist/host-observe.d.ts.map +1 -1
- package/dist/host-observe.js +18 -5
- package/dist/host-observe.js.map +1 -1
- package/dist/host.d.ts +7 -0
- package/dist/host.d.ts.map +1 -1
- package/dist/host.js +3 -0
- package/dist/host.js.map +1 -1
- package/dist/implementations.d.ts +181 -0
- package/dist/implementations.d.ts.map +1 -0
- package/dist/implementations.js +371 -0
- package/dist/implementations.js.map +1 -0
- package/dist/installation-core.d.ts.map +1 -1
- package/dist/installation-core.js +3 -3
- package/dist/installation-core.js.map +1 -1
- package/dist/lifecycle-registration.d.ts +6 -2
- package/dist/lifecycle-registration.d.ts.map +1 -1
- package/dist/lifecycle-registration.js +5 -1
- package/dist/lifecycle-registration.js.map +1 -1
- package/dist/minting.d.ts.map +1 -1
- package/dist/minting.js +2 -2
- package/dist/minting.js.map +1 -1
- package/dist/projection.d.ts +11 -2
- package/dist/projection.d.ts.map +1 -1
- package/dist/projection.js +78 -13
- package/dist/projection.js.map +1 -1
- package/dist/registry-build.d.ts +3 -0
- package/dist/registry-build.d.ts.map +1 -1
- package/dist/registry-build.js +20 -0
- package/dist/registry-build.js.map +1 -1
- package/dist/registry-collections.d.ts +32 -0
- package/dist/registry-collections.d.ts.map +1 -0
- package/dist/registry-collections.js +105 -0
- package/dist/registry-collections.js.map +1 -0
- package/dist/registry-resolve.d.ts +2 -0
- package/dist/registry-resolve.d.ts.map +1 -1
- package/dist/registry-resolve.js +23 -2
- package/dist/registry-resolve.js.map +1 -1
- package/dist/registry-source.d.ts +3 -0
- package/dist/registry-source.d.ts.map +1 -1
- package/dist/registry-source.js +15 -6
- package/dist/registry-source.js.map +1 -1
- package/dist/registry.d.ts +4 -0
- package/dist/registry.d.ts.map +1 -1
- package/dist/registry.js +2 -0
- package/dist/registry.js.map +1 -1
- package/dist/services.d.ts +89 -6
- package/dist/services.d.ts.map +1 -1
- package/dist/services.js +94 -4
- package/dist/services.js.map +1 -1
- package/dist/snapshot.d.ts +1 -1
- package/dist/snapshot.d.ts.map +1 -1
- package/dist/snapshot.js +30 -6
- package/dist/snapshot.js.map +1 -1
- package/package.json +16 -7
- package/references/registry-collections.md +15 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@inventarch/distribution",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
6
|
"ia-distribution": "./dist/cli.js"
|
|
@@ -13,20 +13,21 @@
|
|
|
13
13
|
"LICENSE",
|
|
14
14
|
"NOTICE",
|
|
15
15
|
"references/system-package.md",
|
|
16
|
+
"references/registry-collections.md",
|
|
16
17
|
"LANGUAGE.md"
|
|
17
18
|
],
|
|
18
19
|
"engines": {
|
|
19
20
|
"node": ">=22.22.0 <23"
|
|
20
21
|
},
|
|
21
22
|
"dependencies": {
|
|
22
|
-
"@inventarch/db": "
|
|
23
|
-
"@inventarch/graph": "
|
|
24
|
-
"@inventarch/language": "
|
|
25
|
-
"@inventarch/authoring-system": "
|
|
26
|
-
"@inventarch/workspace-runtime": "
|
|
23
|
+
"@inventarch/db": "3.0.0",
|
|
24
|
+
"@inventarch/graph": "3.0.0",
|
|
25
|
+
"@inventarch/language": "3.0.0",
|
|
26
|
+
"@inventarch/authoring-system": "3.0.0",
|
|
27
|
+
"@inventarch/workspace-runtime": "3.0.0",
|
|
27
28
|
"smol-toml": "1.9.0",
|
|
28
29
|
"jsonc-parser": "3.3.1",
|
|
29
|
-
"@inventarch/steward-hook": "
|
|
30
|
+
"@inventarch/steward-hook": "3.0.0"
|
|
30
31
|
},
|
|
31
32
|
"devDependencies": {
|
|
32
33
|
"@types/node": "^22.19.0",
|
|
@@ -110,6 +111,10 @@
|
|
|
110
111
|
"types": "./dist/host-observe.d.ts",
|
|
111
112
|
"default": "./dist/host-observe.js"
|
|
112
113
|
},
|
|
114
|
+
"./implementations": {
|
|
115
|
+
"types": "./dist/implementations.d.ts",
|
|
116
|
+
"default": "./dist/implementations.js"
|
|
117
|
+
},
|
|
113
118
|
"./lifecycle-registration": {
|
|
114
119
|
"types": "./dist/lifecycle-registration.d.ts",
|
|
115
120
|
"default": "./dist/lifecycle-registration.js"
|
|
@@ -202,6 +207,10 @@
|
|
|
202
207
|
"types": "./dist/ia-home.d.ts",
|
|
203
208
|
"default": "./dist/ia-home.js"
|
|
204
209
|
},
|
|
210
|
+
"./internal/implementations": {
|
|
211
|
+
"types": "./dist/implementations.d.ts",
|
|
212
|
+
"default": "./dist/implementations.js"
|
|
213
|
+
},
|
|
205
214
|
"./internal/install": {
|
|
206
215
|
"types": "./dist/install.d.ts",
|
|
207
216
|
"default": "./dist/install.js"
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Registry collections and source adoption
|
|
2
|
+
|
|
3
|
+
The public `./registry` interface supports `index(id)` and `index('release', id)` for existing release indexes, `index('kit', id)` for `kits/<provider>/<name>/index.json`, and `index('workspace', id)` for `workspaces/<provider>/<name>/index.json`. The built-in Inventarch mapping is unchanged. Providers serve a credential-free HTTPS base or an explicit local directory. A missing index is an empty release list. The existing shared 256-read budget, 4 MiB document limit, bounded fetch, no redirects, and portable/link-free directory reads apply to every kind.
|
|
4
|
+
|
|
5
|
+
`ia.registry-kit.v1` contains `id` and `releases`; each release contains `version`, `withdrawn`, and `distributions` with ordinary `{id, range}` requests. `ia install <id>[@range]` treats an explicitly named id as a kit only when its release index is empty. Its members pass the existing resolution, archive integrity, native admission, install transaction and registered packet refresh. The lock pins the resulting distribution requests and exact archive closure, so restore stays offline-capable without kit metadata. Removing or updating a kit is performed on those explicit distribution requests; kits confer no implementation catalog, registry override, credential or host permission.
|
|
6
|
+
|
|
7
|
+
`ia.registry-workspace.v1` contains `id` and `releases`; each release contains `version`, `withdrawn`, `revision`, and `files` with `{path, text}`. It is source data, with at most 1,000 files, 1 MiB per file and 3 MiB of combined text. Native paths must be under `.ia/src`, outside its floor; documentation is explicit portable `.md` or `.txt` paths outside hidden roots. The revision is SHA-256 of the stable serialization of the sorted native `{path,text}` rows. The source parser checks every native file and refuses authority-producing `mandate`, `agent-profile`, `execution-binding`, `hook`, `capability`, and `check` records, including nested records. Author and review those records locally. No executable, host configuration, registry mapping, implementation catalog or remote credential is copied or loaded.
|
|
8
|
+
|
|
9
|
+
`ia adopt <id>[@range] --registry <base>` previews by default. `--apply --yes` pins a source tree at `.ia/open/<binding-id>/<revision>`, records a version-1 `.ia/workspace.json` `open` binding, and adds `<tree>/.ia/src @open` to the sole authored workspace's `composition.sources`. These records enter at band 50, below installed/adopted band 90 and authored band 100. Binding IDs are deterministic hashes of the provider-qualified id; identities, edges and native bytes are unchanged. Existing local `adopted` bindings keep their version-1 behavior. The planner checks candidate admission and any existing destination entries before writes. Native paths excluded by physical source discovery (`dist`, `node_modules`, `.git`, and the floor) are refused. Apply verifies exact destination file membership and bytes, then checks the physical native revision before publishing the declaration or binding; unlisted owner data is preserved and causes refusal. Apply holds an exclusive adoption lock, rechecks the inputs, writes immutable mount files, then updates the declaration and binding. A manifest-write failure restores the declaration when it still holds this operation's bytes. After a process crash, inspect the declaration and binding before removing the stale `.ia/adoption.lock`; no automatic crash recovery is claimed. Unreferenced immutable files may remain after interruption; the published source set does not include them. Capture and registered packet refresh follow publication; their failure explicitly reports that adoption already applied and prints one adoption retry pinned to the selected version, preserving the root and explicit registry. After repairing the reported failure, that retry completes capture and registered projections. A repeated application of the same pin is safe; a different revision requires explicit removal of the old binding first.
|
|
10
|
+
|
|
11
|
+
`ia init --adopt <id>[@range] [--registry <base>]` includes the selected source-only adoption in its preview, then installs the bundled language, pins the mount, authors the starter including its source declaration, admits, captures, and projects. Existing bindings are reflected in the starter even without `--adopt`. `ia doctor` verifies pinned source bytes and lists each mount and placement. Reading and captured-resource resolution preserve the open mount's source locator and revision; they do not create execution authority.
|
|
12
|
+
|
|
13
|
+
For rollback, remove the exact open binding and its matching authored `composition.sources` entry, then run `ia capture` and `ia project <host> --apply --yes` for each registered host. Keep the immutable tree until no retained capture needs it. No install or adoption operation publishes a release.
|
|
14
|
+
|
|
15
|
+
`registryAddCollection(dir, kind, index)` validates and writes directory-registry kit/workspace indexes, refusing removal or mutation of an already listed version. `tools/release/distribution.mjs <directory> <output>` reads an explicitly authored `.ia/kit.json` with `systems`, `descriptor`, and `assets` (and an optional `kit` index), then uses the public language dependency closure to pack exactly the selected owned systems. The output is local package artifacts and optional kit metadata; publishing its dependency closure and release indexes uses the existing reviewed registry builder. The exported `packOptionalDistribution(root, options)` also accepts already-selected asset bytes. The product-structure wrapper keeps its reviewed assets/resources and delegates packing to that common implementation.
|