@inventarch/runtime 3.6.0 → 3.7.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/SPEC.md +2 -0
  2. package/package.json +4 -4
package/SPEC.md CHANGED
@@ -4,6 +4,8 @@
4
4
 
5
5
  ## Method kits and packets
6
6
 
7
+ The [kit runtime specification](../../docs/specs/kit-runtime/README.md) is normative for the kit layout, `bindings.json`, the check, delivery and on-write sidecars, lanes and the door contract; this section keeps the package-specific detail and defers to it on any disagreement.
8
+
7
9
  `@inventarch/runtime/method` is the shared method resolver the MCP door reads kits through, in process. It reads kit folders (`.ia/release.json`, `.ia/src`, the lock, `releases.json` in format 1 or format 2 with `releases/<version>.json`, and the `checks.json`, `delivery.json`, `bindings.json` and `onwrite.json` sidecars) from a bundled folder and then `<IA home>/kits/<folder>/<version>/`; selects a repository's binding from `.ia/bindings.json` (exact, wildcard, default, then precedence); keeps task pins (format 3, format 1 read as format 3) under `<IA home>/work-v1/<project>/<task>/`; retains exact method bytes under the closure store; restores kit read roots under `<IA home>/kit-roots-v1/` unless the caller names a cache; and assembles the packet with the digest over its sorted-key canonical form, the envelope and binding excluded. `resolveMethod` follows the `ia` plugin's `resolve.mjs` step for step, reading position bodies, records, inbound rows and cell bodies through db and this package instead of the CLI. Its caller supplies the native restore that installs a kit's language base into the kit's read root, so this package gains no distribution dependency. `laneCatalogue`, `openSession`, `readRegistry`, `registerWorkspace` and `checkRoot` serve the door's catalogue, session log, workspace registry (format `ia-workspace-locations-2`, reading `personal-workspace-locations-1` and Studio's format 1, writing format 2 only) and per-root mandate check. Lanes, keys, words and phases are closed tokens; a subject is carried as the caller gives it and never reaches a position.
8
10
 
9
11
  Installed kits (2026-10-31, contract C7b): a workspace lock's `package` entries (`lockedPackageKits`) name kit releases the engine installs as ordinary releases in `.ia/distributions/store/<archive>/`; npm is transport only, and no kit is read from an npm package folder. `installedPackageKits` reads each from the store: its `distribution.json` must hash to the manifest digest the lock pins and name that release, and its pinned files are copied, each checked against its SHA-256, into `<IA home>/installed-kits-v1/<archive>/` with a format 1 `releases.json` of its one release and a `.ia/distributions.lock.json` that pins its dependencies exactly as the workspace lock does, so retention, read roots and the door's restore treat it as any kit folder (origin `installed`). `workspaceKits` lists a workspace's kits: the bundled ones, each installed kit, then the home's; a kit an entry names is taken from no other source, so `resolveMethod` refuses a binding to one the store lacks `IA-CORE-KIT-RESTORE-REQUIRED` ("run ia restore"; a pinned task may still read its retained bytes), and a kit no source provides still refuses `IA-CORE-KIT-UNKNOWN`. `installedKit` counts an entry kit as installed, so its packet's laws are the repository's position's and `envelope.kitInstalled` is true. `openSession` takes the kits the store lacks and adds `restore: {kits, message}` and a "Kits not restored" briefing line. `checkRoot` keeps the installation's refusal reason (`restore-required`, `lock-drift`) on its error. A lock without entries changes none of this.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inventarch/runtime",
3
- "version": "3.6.0",
3
+ "version": "3.7.0",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
@@ -171,9 +171,9 @@
171
171
  "LANGUAGE.md"
172
172
  ],
173
173
  "dependencies": {
174
- "@inventarch/language": "3.6.0",
175
- "@inventarch/graph": "3.6.0",
176
- "@inventarch/db": "3.6.0"
174
+ "@inventarch/language": "3.7.0",
175
+ "@inventarch/graph": "3.7.0",
176
+ "@inventarch/db": "3.7.0"
177
177
  },
178
178
  "devDependencies": {
179
179
  "@types/node": "^22.19.0",