@inventarch/runtime 3.4.1 → 3.5.1

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 (72) hide show
  1. package/SPEC.md +8 -2
  2. package/dist/method/bindings.d.ts +51 -0
  3. package/dist/method/bindings.d.ts.map +1 -0
  4. package/dist/method/bindings.js +166 -0
  5. package/dist/method/bindings.js.map +1 -0
  6. package/dist/method/catalogue.d.ts +39 -0
  7. package/dist/method/catalogue.d.ts.map +1 -0
  8. package/dist/method/catalogue.js +126 -0
  9. package/dist/method/catalogue.js.map +1 -0
  10. package/dist/method/errors.d.ts +28 -0
  11. package/dist/method/errors.d.ts.map +1 -0
  12. package/dist/method/errors.js +39 -0
  13. package/dist/method/errors.js.map +1 -0
  14. package/dist/method/index.d.ts +30 -0
  15. package/dist/method/index.d.ts.map +1 -0
  16. package/dist/method/index.js +16 -0
  17. package/dist/method/index.js.map +1 -0
  18. package/dist/method/installed-kits.d.ts +49 -0
  19. package/dist/method/installed-kits.d.ts.map +1 -0
  20. package/dist/method/installed-kits.js +194 -0
  21. package/dist/method/installed-kits.js.map +1 -0
  22. package/dist/method/kit-root.d.ts +31 -0
  23. package/dist/method/kit-root.d.ts.map +1 -0
  24. package/dist/method/kit-root.js +120 -0
  25. package/dist/method/kit-root.js.map +1 -0
  26. package/dist/method/kits.d.ts +130 -0
  27. package/dist/method/kits.d.ts.map +1 -0
  28. package/dist/method/kits.js +381 -0
  29. package/dist/method/kits.js.map +1 -0
  30. package/dist/method/packet.d.ts +51 -0
  31. package/dist/method/packet.d.ts.map +1 -0
  32. package/dist/method/packet.js +62 -0
  33. package/dist/method/packet.js.map +1 -0
  34. package/dist/method/pin.d.ts +71 -0
  35. package/dist/method/pin.d.ts.map +1 -0
  36. package/dist/method/pin.js +164 -0
  37. package/dist/method/pin.js.map +1 -0
  38. package/dist/method/reader.d.ts +38 -0
  39. package/dist/method/reader.d.ts.map +1 -0
  40. package/dist/method/reader.js +97 -0
  41. package/dist/method/reader.js.map +1 -0
  42. package/dist/method/registry.d.ts +39 -0
  43. package/dist/method/registry.d.ts.map +1 -0
  44. package/dist/method/registry.js +129 -0
  45. package/dist/method/registry.js.map +1 -0
  46. package/dist/method/releases.d.ts +47 -0
  47. package/dist/method/releases.d.ts.map +1 -0
  48. package/dist/method/releases.js +104 -0
  49. package/dist/method/releases.js.map +1 -0
  50. package/dist/method/resolve.d.ts +44 -0
  51. package/dist/method/resolve.d.ts.map +1 -0
  52. package/dist/method/resolve.js +448 -0
  53. package/dist/method/resolve.js.map +1 -0
  54. package/dist/method/retained.d.ts +8 -0
  55. package/dist/method/retained.d.ts.map +1 -0
  56. package/dist/method/retained.js +182 -0
  57. package/dist/method/retained.js.map +1 -0
  58. package/dist/method/root.d.ts +12 -0
  59. package/dist/method/root.d.ts.map +1 -0
  60. package/dist/method/root.js +43 -0
  61. package/dist/method/root.js.map +1 -0
  62. package/dist/method/session.d.ts +64 -0
  63. package/dist/method/session.d.ts.map +1 -0
  64. package/dist/method/session.js +109 -0
  65. package/dist/method/session.js.map +1 -0
  66. package/dist/packet-host.d.ts +1 -1
  67. package/dist/packet-host.d.ts.map +1 -1
  68. package/dist/packet.d.ts +1 -1
  69. package/dist/packet.d.ts.map +1 -1
  70. package/dist/packet.js +3 -2
  71. package/dist/packet.js.map +1 -1
  72. package/package.json +8 -4
@@ -0,0 +1,126 @@
1
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { ENTRIES, SCOPE_KEYS, readBindings } from './bindings.js';
4
+ import { MethodError } from './errors.js';
5
+ import { kitBindings, kitDelivery } from './kits.js';
6
+ export const DESCRIPTION_LIMIT = 200;
7
+ /** `ia-<lane>:<activity>`, and `ia-<lane>` for the lane's own `<lane>.*` key. */
8
+ export const displayName = (key) => {
9
+ const [lane, activity] = key.split('.');
10
+ return activity === '*' ? `ia-${lane}` : `ia-${lane}:${activity}`;
11
+ };
12
+ const oneLine = (text) => {
13
+ const flat = text.replace(/\s+/g, ' ').trim();
14
+ if (flat.length <= DESCRIPTION_LIMIT)
15
+ return flat;
16
+ const sentence = flat.slice(0, DESCRIPTION_LIMIT).match(/^.*?[.!?](?=\s|$)/)?.[0];
17
+ return sentence && sentence.length >= 40 ? sentence : `${flat.slice(0, DESCRIPTION_LIMIT - 1).trimEnd()}…`;
18
+ };
19
+ /** Each `@capability` record's `meaning.says` in a kit's sources, by name, read as text without opening the kit. */
20
+ export function capabilityDescriptions(kitDir) {
21
+ const found = new Map();
22
+ const systems = join(kitDir, '.ia', 'src', 'systems');
23
+ if (!existsSync(systems))
24
+ return found;
25
+ for (const system of readdirSync(systems).sort()) {
26
+ const records = join(systems, system, 'records');
27
+ const files = [
28
+ join(systems, system, 'system.ia'),
29
+ ...(existsSync(records) ? readdirSync(records).map((file) => join(records, file)) : []),
30
+ ].filter((file) => file.endsWith('.ia') && existsSync(file));
31
+ for (const file of files) {
32
+ const text = readFileSync(file, 'utf8').replace(/\r\n/g, '\n');
33
+ for (const block of text.split(/^(?=@)/m)) {
34
+ const head = /^@capability ([a-z0-9][a-z0-9-]*)/.exec(block);
35
+ const says = /^\s+says "((?:[^"\\]|\\.)*)"/m.exec(block);
36
+ if (head && says && !found.has(head[1]))
37
+ found.set(head[1], says[1].replace(/\\(.)/g, '$1'));
38
+ }
39
+ }
40
+ }
41
+ return found;
42
+ }
43
+ /** The phase an activity states to the position (`SCOPE_KEYS`), its lane's default when the table names none. */
44
+ const phaseOf = (lane, activity) => (SCOPE_KEYS[lane][activity] ?? SCOPE_KEYS[lane]['default'])[1];
45
+ /** The catalogue of one lane, for a workspace root (or none) and the kits a resolve can read. */
46
+ export function laneCatalogue(request, context) {
47
+ if (!ENTRIES.includes(request.lane))
48
+ throw new MethodError(`lane must be one of ${ENTRIES.join(', ')}`, 'IA-CORE-USAGE');
49
+ const lane = request.lane;
50
+ const byId = new Map(context.kits.map((kit) => [kit.id, kit]));
51
+ const descriptions = new Map();
52
+ const describe = (kitId, capability) => {
53
+ const kit = byId.get(kitId);
54
+ if (kit === undefined)
55
+ return '';
56
+ if (!descriptions.has(kitId))
57
+ descriptions.set(kitId, capabilityDescriptions(kit.dir));
58
+ return oneLine(descriptions.get(kitId).get(capability) ?? '');
59
+ };
60
+ const versionOf = (kitId) => {
61
+ const kit = byId.get(kitId);
62
+ return kit === undefined ? null : (kit.latest?.version ?? kit.version ?? null);
63
+ };
64
+ const items = new Map();
65
+ const add = (key, row, state) => {
66
+ items.set(key, {
67
+ key,
68
+ display: displayName(key),
69
+ kit: row.kit,
70
+ version: versionOf(row.kit),
71
+ capability: row.capability,
72
+ ...(row.profile === undefined ? {} : { profile: row.profile }),
73
+ description: describe(row.kit, row.capability),
74
+ state,
75
+ });
76
+ };
77
+ for (const kit of context.kits) {
78
+ let recommend;
79
+ try {
80
+ ({ recommend } = kitBindings(kit));
81
+ }
82
+ catch {
83
+ continue;
84
+ }
85
+ const own = Object.entries(recommend).filter(([key]) => key.startsWith(`${lane}.`));
86
+ for (const [key, row] of own)
87
+ if (!items.has(key))
88
+ add(key, row, 'installed');
89
+ if (own.length === 0)
90
+ continue;
91
+ let whole = [];
92
+ try {
93
+ whole = kitDelivery(kit).whole;
94
+ }
95
+ catch {
96
+ whole = [];
97
+ }
98
+ const named = new Set(own.map(([, row]) => row.capability));
99
+ for (const capability of whole) {
100
+ const key = `${lane}.${capability}`;
101
+ if (!named.has(capability) && !items.has(key))
102
+ add(key, { kit: kit.id, capability }, 'installed');
103
+ }
104
+ }
105
+ const bound = context.root === null ? null : readBindings(context.root);
106
+ if (bound !== null)
107
+ for (const [key, rows] of Object.entries(bound.bindings)) {
108
+ if (!key.startsWith(`${lane}.`))
109
+ continue;
110
+ const ranked = rows.length === 1 ? rows[0] : (rows.find((row) => bound.precedence.includes(row.kit)) ?? rows[0]);
111
+ if (ranked !== undefined)
112
+ add(key, ranked, 'bound');
113
+ }
114
+ const listed = [...items.values()]
115
+ .filter((item) => {
116
+ const activity = item.key.slice(lane.length + 1);
117
+ if (request.word !== undefined && activity !== request.word)
118
+ return false;
119
+ if (request.phase !== undefined && activity !== '*' && phaseOf(lane, activity) !== request.phase)
120
+ return false;
121
+ return true;
122
+ })
123
+ .sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
124
+ return { lane, items: listed };
125
+ }
126
+ //# sourceMappingURL=catalogue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalogue.js","sourceRoot":"","sources":["../../src/method/catalogue.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * A method refusal: the `{ error: { code, message, candidates?, key? } }` payload the `ia` plugin's resolver prints, so a
3
+ * host that reads one reads the other.
4
+ */
5
+ export declare class MethodError extends Error {
6
+ readonly code: string;
7
+ readonly candidates?: readonly unknown[];
8
+ readonly key?: string;
9
+ readonly pinnedRoot?: string;
10
+ constructor(message: string, code: string, extra?: {
11
+ readonly candidates?: readonly unknown[];
12
+ readonly key?: string;
13
+ readonly pinnedRoot?: string;
14
+ });
15
+ }
16
+ export interface MethodRefusal {
17
+ readonly error: {
18
+ readonly code: string;
19
+ readonly message: string;
20
+ readonly candidates?: readonly unknown[];
21
+ readonly key?: string;
22
+ };
23
+ }
24
+ /** The refusal payload for any thrown value; a value without a code is `IA-CORE-ERROR`. */
25
+ export declare function methodRefusal(error: unknown): MethodRefusal;
26
+ /** A JSON object member as a plain record, or undefined. */
27
+ export declare const objectAt: (value: unknown) => Record<string, unknown> | undefined;
28
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/method/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAE3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;CAQhH;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;QACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAe3D;AAED,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SACmD,CAAC"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * A method refusal: the `{ error: { code, message, candidates?, key? } }` payload the `ia` plugin's resolver prints, so a
3
+ * host that reads one reads the other.
4
+ */
5
+ export class MethodError extends Error {
6
+ code;
7
+ candidates;
8
+ key;
9
+ pinnedRoot;
10
+ constructor(message, code, extra = {}) {
11
+ super(message);
12
+ this.code = code;
13
+ if (extra.candidates !== undefined)
14
+ this.candidates = extra.candidates;
15
+ if (extra.key !== undefined)
16
+ this.key = extra.key;
17
+ if (extra.pinnedRoot !== undefined)
18
+ this.pinnedRoot = extra.pinnedRoot;
19
+ }
20
+ }
21
+ /** The refusal payload for any thrown value; a value without a code is `IA-CORE-ERROR`. */
22
+ export function methodRefusal(error) {
23
+ const code = error !== null && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
24
+ ? error.code
25
+ : 'IA-CORE-ERROR';
26
+ const message = error instanceof Error ? error.message : String(error);
27
+ const extra = error instanceof MethodError ? error : undefined;
28
+ return {
29
+ error: {
30
+ code,
31
+ message,
32
+ ...(extra?.candidates === undefined ? {} : { candidates: extra.candidates }),
33
+ ...(extra?.key === undefined ? {} : { key: extra.key }),
34
+ },
35
+ };
36
+ }
37
+ /** A JSON object member as a plain record, or undefined. */
38
+ export const objectAt = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
39
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/method/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACb,UAAU,CAAsB;IAChC,GAAG,CAAU;IACb,UAAU,CAAU;IAC7B,YACE,OAAe,EACf,IAAY,EACZ,QAA2G,EAAE;QAE7G,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACvE,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAClD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACzE,CAAC;CACF;AAWD,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,IAAI,GACR,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9F,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,eAAe,CAAC;IACtB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;YAC5E,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;SACxD;KACF,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAuC,EAAE,CAC9E,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAC"}
@@ -0,0 +1,30 @@
1
+ export { MethodError, methodRefusal } from './errors.js';
2
+ export type { MethodRefusal } from './errors.js';
3
+ export { RELEASES_FORMAT, checkFile, checkIndex, compareVersions, expandIndex, expandReleases, readReleases, releaseFile, releaseRecords, } from './releases.js';
4
+ export type { ReleaseIndex, ReleaseRow } from './releases.js';
5
+ export { SIDECARS, assertPinnedKit, carrierOf, declaredAssets, findKit, folderKits, homeKits, iaHome, identityOf, implementationDigest, installedKit, kitBindings, kitChecks, kitDelivery, kitRecordNames, listKits, readDescriptor, readLock, sourcesDigest, } from './kits.js';
6
+ export type { Kit, KitCheck, KitOrigin, KitRecordName, KitSources, LockedPackage, Recommendation } from './kits.js';
7
+ export { INSTALLED_KITS_DIRECTORY, RESTORE_NEEDED, STORE, installedPackageKits, lockedPackageKits, packagedKit, restoreRefusal, workspaceKits, } from './installed-kits.js';
8
+ export type { InstalledKits, LockedKit } from './installed-kits.js';
9
+ export { ENTRIES, PHASES, RENAMED, SCOPE_KEYS, SHAPES, bindingsPath, findWorkspace, readBindings, renamedMessage, scopeKey, selectBinding, } from './bindings.js';
10
+ export type { Binding, Bindings, Entry, SelectedBinding } from './bindings.js';
11
+ export { PIN_FORMAT, kitUpdate, pinRootFor, projectOf, readPin, writePin } from './pin.js';
12
+ export type { Pin, PinnedKey, PinnedKit } from './pin.js';
13
+ export { DIGESTED, EVIDENCE_STATES, PACKET_CONTRACT, assemblePacket, canonical, packetDigest } from './packet.js';
14
+ export type { MethodPacket } from './packet.js';
15
+ export { closureStore, retainKit, retainedKit } from './retained.js';
16
+ export { assertReadable, kitCache, kitReadRoot, userCache } from './kit-root.js';
17
+ export type { KitRestore } from './kit-root.js';
18
+ export { WorkspaceReader } from './reader.js';
19
+ export type { JsonRecord, PositionAnswer } from './reader.js';
20
+ export { RESOLVER, resolveMethod } from './resolve.js';
21
+ export type { MethodContext, MethodRequest } from './resolve.js';
22
+ export { REGISTRY_FILE, REGISTRY_FORMAT, defaultWorkspaceRoot, readRegistry, registerWorkspace, registryPath, samePath, writeRegistry, } from './registry.js';
23
+ export type { RegisteredWorkspace, WorkspaceRegistry } from './registry.js';
24
+ export { DESCRIPTION_LIMIT, capabilityDescriptions, displayName, laneCatalogue } from './catalogue.js';
25
+ export type { Catalogue, CatalogueItem, CatalogueState } from './catalogue.js';
26
+ export { BRIEFING_LIMIT, LANES, SESSION_DIRECTORY, appendSessionEvent, briefing, currentPin, openSession, sessionKits, sessionRestore, } from './session.js';
27
+ export type { Session, SessionClaim, SessionKit, SessionPin, SessionRestore } from './session.js';
28
+ export { checkRoot } from './root.js';
29
+ export type { RootCheck } from './root.js';
30
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/method/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ export { MethodError, methodRefusal } from './errors.js';
2
+ export { RELEASES_FORMAT, checkFile, checkIndex, compareVersions, expandIndex, expandReleases, readReleases, releaseFile, releaseRecords, } from './releases.js';
3
+ export { SIDECARS, assertPinnedKit, carrierOf, declaredAssets, findKit, folderKits, homeKits, iaHome, identityOf, implementationDigest, installedKit, kitBindings, kitChecks, kitDelivery, kitRecordNames, listKits, readDescriptor, readLock, sourcesDigest, } from './kits.js';
4
+ export { INSTALLED_KITS_DIRECTORY, RESTORE_NEEDED, STORE, installedPackageKits, lockedPackageKits, packagedKit, restoreRefusal, workspaceKits, } from './installed-kits.js';
5
+ export { ENTRIES, PHASES, RENAMED, SCOPE_KEYS, SHAPES, bindingsPath, findWorkspace, readBindings, renamedMessage, scopeKey, selectBinding, } from './bindings.js';
6
+ export { PIN_FORMAT, kitUpdate, pinRootFor, projectOf, readPin, writePin } from './pin.js';
7
+ export { DIGESTED, EVIDENCE_STATES, PACKET_CONTRACT, assemblePacket, canonical, packetDigest } from './packet.js';
8
+ export { closureStore, retainKit, retainedKit } from './retained.js';
9
+ export { assertReadable, kitCache, kitReadRoot, userCache } from './kit-root.js';
10
+ export { WorkspaceReader } from './reader.js';
11
+ export { RESOLVER, resolveMethod } from './resolve.js';
12
+ export { REGISTRY_FILE, REGISTRY_FORMAT, defaultWorkspaceRoot, readRegistry, registerWorkspace, registryPath, samePath, writeRegistry, } from './registry.js';
13
+ export { DESCRIPTION_LIMIT, capabilityDescriptions, displayName, laneCatalogue } from './catalogue.js';
14
+ export { BRIEFING_LIMIT, LANES, SESSION_DIRECTORY, appendSessionEvent, briefing, currentPin, openSession, sessionKits, sessionRestore, } from './session.js';
15
+ export { checkRoot } from './root.js';
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/method/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACL,eAAe,EACf,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,SAAS,EACT,cAAc,EACd,OAAO,EACP,UAAU,EACV,QAAQ,EACR,MAAM,EACN,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,cAAc,EACd,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,KAAK,EACL,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAElH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvG,OAAO,EACL,cAAc,EACd,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,49 @@
1
+ import { MethodError } from './errors.js';
2
+ import type { Kit, KitSources } from './kits.js';
3
+ /**
4
+ * Kits a workspace installs from an npm package of kits (contract C7b, ia-kb `dec-133`). The lock's `package` entry
5
+ * names each kit's IA release by id, version, archive and manifest digest; the engine installs it like any release,
6
+ * expanded under `.ia/distributions/store/<archive>/` at band 90. npm is transport only, so a kit is read from that
7
+ * store, never from the npm package folder. A store payload is not a kit folder (it has no `releases.json` and no lock
8
+ * of its own), so it is materialized once per archive under `<IA home>/installed-kits-v1/<archive>/`: its pinned files,
9
+ * each checked against the manifest the lock pins, a format 1 `releases.json` of its one release, and a
10
+ * `.ia/distributions.lock.json` pinning its dependencies exactly as the workspace lock does. A kit the lock names that
11
+ * the store lacks is not installed yet: a fresh clone runs `ia restore`.
12
+ */
13
+ export declare const INSTALLED_KITS_DIRECTORY = "installed-kits-v1";
14
+ export declare const STORE: string;
15
+ /** What a session and a refusal say when the lock names kits the store lacks. */
16
+ export declare const RESTORE_NEEDED = "run ia restore";
17
+ export interface LockedKit {
18
+ readonly id: string;
19
+ readonly version: string;
20
+ readonly archive: string;
21
+ readonly manifest: string;
22
+ readonly dependencies: readonly string[];
23
+ /** `<name>@<version>` of the package entry that names it. */
24
+ readonly package: string;
25
+ }
26
+ /** The kits the lock's package entries name, in lock order; none without entries or a lock. */
27
+ export declare function lockedPackageKits(root: string): LockedKit[];
28
+ /** Whether the lock's package entries name kit `id`. */
29
+ export declare const packagedKit: (root: string, id: string) => LockedKit | undefined;
30
+ export interface InstalledKits {
31
+ /** The kits the lock's package entries name that the store holds, origin `installed`. */
32
+ readonly kits: readonly Kit[];
33
+ /** Those the store lacks: the workspace needs `ia restore`. */
34
+ readonly missing: readonly LockedKit[];
35
+ }
36
+ /** The kits the workspace at root installs from its package entries, read from its store. */
37
+ export declare function installedPackageKits(root: string, env?: NodeJS.ProcessEnv): InstalledKits;
38
+ /** The refusal a binding to a kit the store lacks meets. */
39
+ export declare const restoreRefusal: (kit: LockedKit) => MethodError;
40
+ /**
41
+ * The kits a resolve at a workspace reads: the bundled folder's, then each kit the lock's package entries install, then
42
+ * the IA home's. A kit a package entry names comes only from the store, so one the store lacks is never answered by
43
+ * another copy. Outside a workspace, or with no package entry, it is `listKits` unchanged.
44
+ */
45
+ export declare function workspaceKits(sources: KitSources, root: string | null, env?: NodeJS.ProcessEnv): {
46
+ readonly kits: Kit[];
47
+ readonly missing: readonly LockedKit[];
48
+ };
49
+ //# sourceMappingURL=installed-kits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-kits.d.ts","sourceRoot":"","sources":["../../src/method/installed-kits.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAY,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAiB,MAAM,WAAW,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAC5D,eAAO,MAAM,KAAK,QAAwC,CAAC;AAC3D,iFAAiF;AACjF,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAgC3D;AAED,wDAAwD;AACxD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,IAAI,MAAM,KAAG,SAAS,GAAG,SACb,CAAC;AA4GvD,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC;AACD,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAgBtG;AAED,4DAA4D;AAC5D,eAAO,MAAM,cAAc,GAAI,KAAK,SAAS,KAAG,WAI7C,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAelE"}
@@ -0,0 +1,194 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
3
+ import { dirname, join } from 'node:path';
4
+ import { MethodError, objectAt } from './errors.js';
5
+ import { iaHome, kitAt, listKits, readLock } from './kits.js';
6
+ /**
7
+ * Kits a workspace installs from an npm package of kits (contract C7b, ia-kb `dec-133`). The lock's `package` entry
8
+ * names each kit's IA release by id, version, archive and manifest digest; the engine installs it like any release,
9
+ * expanded under `.ia/distributions/store/<archive>/` at band 90. npm is transport only, so a kit is read from that
10
+ * store, never from the npm package folder. A store payload is not a kit folder (it has no `releases.json` and no lock
11
+ * of its own), so it is materialized once per archive under `<IA home>/installed-kits-v1/<archive>/`: its pinned files,
12
+ * each checked against the manifest the lock pins, a format 1 `releases.json` of its one release, and a
13
+ * `.ia/distributions.lock.json` pinning its dependencies exactly as the workspace lock does. A kit the lock names that
14
+ * the store lacks is not installed yet: a fresh clone runs `ia restore`.
15
+ */
16
+ export const INSTALLED_KITS_DIRECTORY = 'installed-kits-v1';
17
+ export const STORE = join('.ia', 'distributions', 'store');
18
+ /** What a session and a refusal say when the lock names kits the store lacks. */
19
+ export const RESTORE_NEEDED = 'run ia restore';
20
+ const HEX = /^[a-f0-9]{64}$/;
21
+ const malformed = (message) => {
22
+ throw new MethodError(`.ia/distributions.lock.json: ${message}`, 'IA-CORE-LOCK-MALFORMED');
23
+ };
24
+ /** The kits the lock's package entries name, in lock order; none without entries or a lock. */
25
+ export function lockedPackageKits(root) {
26
+ const lock = readLock(root);
27
+ if (lock?.entries === undefined)
28
+ return [];
29
+ if (!Array.isArray(lock.entries))
30
+ return malformed('entries must be a list');
31
+ return lock.entries.flatMap((value) => {
32
+ const entry = objectAt(value) ?? malformed('an entry must be an object');
33
+ if (entry['kind'] !== 'package')
34
+ return [];
35
+ const kits = entry['kits'];
36
+ if (!Array.isArray(kits))
37
+ return malformed('a package entry needs a kits list');
38
+ return kits.map((row) => {
39
+ const kit = objectAt(row) ?? malformed('a kit row must be an object');
40
+ const { id, version, archive, manifest } = kit;
41
+ const dependencies = Array.isArray(kit['dependencies']) ? kit['dependencies'].map(String) : [];
42
+ if (typeof id !== 'string' ||
43
+ typeof version !== 'string' ||
44
+ typeof archive !== 'string' ||
45
+ !HEX.test(archive) ||
46
+ typeof manifest !== 'string' ||
47
+ !HEX.test(manifest))
48
+ return malformed('a kit row needs its id, version, archive and manifest digests');
49
+ return {
50
+ id,
51
+ version,
52
+ archive,
53
+ manifest,
54
+ dependencies,
55
+ package: `${String(entry['name'])}@${String(entry['version'])}`,
56
+ };
57
+ });
58
+ });
59
+ }
60
+ /** Whether the lock's package entries name kit `id`. */
61
+ export const packagedKit = (root, id) => lockedPackageKits(root).find((kit) => kit.id === id);
62
+ const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
63
+ const pinsOf = (manifest) => (manifest['files'] ?? []).map((file) => {
64
+ if (typeof file.path !== 'string' || typeof file.sha256 !== 'string' || file.path.split('/').includes('..'))
65
+ throw new MethodError('an installed manifest names an unsafe file', 'IA-CORE-CLOSURE-INTEGRITY');
66
+ return { path: file.path, sha256: file.sha256 };
67
+ });
68
+ /** The lock that pins a kit's dependencies as the workspace lock does: their rows and theirs, transitively. */
69
+ function kitLock(root, manifest) {
70
+ const lock = readLock(root) ?? {};
71
+ const rows = [...(lock.packages ?? []), ...lockedPackageKits(root)];
72
+ const dependencies = (manifest['dependencies'] ?? []).map(({ id, range }) => ({
73
+ id,
74
+ range,
75
+ }));
76
+ const needed = new Map();
77
+ const visit = (id) => {
78
+ if (needed.has(id))
79
+ return;
80
+ const row = rows.find((candidate) => candidate.id === id);
81
+ if (row === undefined)
82
+ throw new MethodError(`installed kit depends on ${id}, which the workspace lock does not install`, 'IA-CORE-KIT');
83
+ needed.set(id, row);
84
+ (row.dependencies ?? []).forEach(visit);
85
+ };
86
+ dependencies.forEach((dependency) => visit(dependency.id));
87
+ return {
88
+ engine: '0.1.1',
89
+ formatVersion: 1,
90
+ packages: [...needed.values()]
91
+ .sort((a, b) => (a.id < b.id ? -1 : 1))
92
+ .map((row) => ({
93
+ archive: row.archive,
94
+ dependencies: row.dependencies ?? [],
95
+ id: row.id,
96
+ location: row.location ?? `sha256:${row.archive}`,
97
+ manifest: row.manifest,
98
+ version: row.version,
99
+ })),
100
+ requests: dependencies.sort((a, b) => (a.id < b.id ? -1 : 1)),
101
+ };
102
+ }
103
+ const COMPLETE = '.installed-kit.json';
104
+ /** The materialized kit folder of one installed kit, made from the store once and checked on every read. */
105
+ function materialize(root, kit, home) {
106
+ const store = join(root, STORE, kit.archive);
107
+ const manifestBytes = readFileSync(join(store, 'distribution.json'));
108
+ if (sha256(manifestBytes) !== kit.manifest)
109
+ throw new MethodError(`installed kit ${kit.id} ${kit.version}: ${STORE}/${kit.archive}/distribution.json is not the manifest the lock pins; ${RESTORE_NEEDED}`, 'IA-CORE-CLOSURE-INTEGRITY');
110
+ const manifest = JSON.parse(manifestBytes.toString('utf8'));
111
+ if (manifest['id'] !== kit.id || manifest['version'] !== kit.version)
112
+ throw new MethodError(`installed kit ${kit.id}: its manifest names another release`, 'IA-CORE-CLOSURE-INTEGRITY');
113
+ const pins = pinsOf(manifest);
114
+ const parent = join(home, INSTALLED_KITS_DIRECTORY);
115
+ const target = join(parent, kit.archive);
116
+ const intact = (dir) => existsSync(join(dir, COMPLETE)) &&
117
+ pins.every((pin) => existsSync(join(dir, pin.path)) && sha256(readFileSync(join(dir, pin.path))) === pin.sha256);
118
+ if (intact(target))
119
+ return target;
120
+ mkdirSync(parent, { recursive: true, mode: 0o700 });
121
+ const work = mkdtempSync(join(parent, 'tmp-'));
122
+ try {
123
+ for (const pin of pins) {
124
+ const bytes = readFileSync(join(store, pin.path));
125
+ if (sha256(bytes) !== pin.sha256)
126
+ throw new MethodError(`installed kit ${kit.id}: ${STORE}/${kit.archive}/${pin.path} differs from its pin; ${RESTORE_NEEDED}`, 'IA-CORE-CLOSURE-INTEGRITY');
127
+ mkdirSync(dirname(join(work, pin.path)), { recursive: true });
128
+ writeFileSync(join(work, pin.path), bytes);
129
+ }
130
+ writeFileSync(join(work, 'releases.json'), JSON.stringify({
131
+ kit: kit.id,
132
+ releases: [{ version: kit.version, archive: kit.archive, manifest: kit.manifest, records: [] }],
133
+ }, null, 2) + '\n');
134
+ mkdirSync(join(work, '.ia'), { recursive: true });
135
+ writeFileSync(join(work, '.ia', 'distributions.lock.json'), JSON.stringify(kitLock(root, manifest)) + '\n');
136
+ writeFileSync(join(work, COMPLETE), JSON.stringify({ kit: kit.id, archive: kit.archive, manifest: kit.manifest }));
137
+ rmSync(target, { recursive: true, force: true });
138
+ try {
139
+ renameSync(work, target);
140
+ }
141
+ catch (error) {
142
+ if (!intact(target))
143
+ throw error;
144
+ }
145
+ return target;
146
+ }
147
+ finally {
148
+ rmSync(work, { recursive: true, force: true });
149
+ }
150
+ }
151
+ /** The kits the workspace at root installs from its package entries, read from its store. */
152
+ export function installedPackageKits(root, env = process.env) {
153
+ const locked = lockedPackageKits(root);
154
+ if (locked.length === 0)
155
+ return { kits: [], missing: [] };
156
+ const home = iaHome(env);
157
+ mkdirSync(home, { recursive: true, mode: 0o700 });
158
+ const kits = [], missing = [];
159
+ for (const kit of locked) {
160
+ if (!existsSync(join(root, STORE, kit.archive, 'distribution.json'))) {
161
+ missing.push(kit);
162
+ continue;
163
+ }
164
+ const dir = materialize(root, kit, realpathSync(home));
165
+ kits.push(kitAt(dir, kit.id.slice(kit.id.indexOf('/') + 1), 'installed'));
166
+ }
167
+ return { kits, missing };
168
+ }
169
+ /** The refusal a binding to a kit the store lacks meets. */
170
+ export const restoreRefusal = (kit) => new MethodError(`kit ${kit.id} ${kit.version} is installed from ${kit.package} by .ia/distributions.lock.json, but ${STORE} does not hold it yet: ${RESTORE_NEEDED}`, 'IA-CORE-KIT-RESTORE-REQUIRED');
171
+ /**
172
+ * The kits a resolve at a workspace reads: the bundled folder's, then each kit the lock's package entries install, then
173
+ * the IA home's. A kit a package entry names comes only from the store, so one the store lacks is never answered by
174
+ * another copy. Outside a workspace, or with no package entry, it is `listKits` unchanged.
175
+ */
176
+ export function workspaceKits(sources, root, env) {
177
+ const all = listKits(sources);
178
+ if (root === null)
179
+ return { kits: all, missing: [] };
180
+ const installed = installedPackageKits(root, env);
181
+ const named = new Set([...installed.kits.map((kit) => kit.id), ...installed.missing.map((kit) => kit.id)]);
182
+ if (named.size === 0)
183
+ return { kits: all, missing: [] };
184
+ const kept = all.filter((kit) => !named.has(kit.id));
185
+ return {
186
+ kits: [
187
+ ...kept.filter((kit) => kit.origin === 'bundled'),
188
+ ...installed.kits,
189
+ ...kept.filter((kit) => kit.origin !== 'bundled'),
190
+ ],
191
+ missing: installed.missing,
192
+ };
193
+ }
194
+ //# sourceMappingURL=installed-kits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"installed-kits.js","sourceRoot":"","sources":["../../src/method/installed-kits.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import type { Kit } from './kits.js';
2
+ /**
3
+ * The read root of a kit: a restored copy of its workspace in a per-user cache folder, keyed by its source digests, so
4
+ * any reader opens it with the language base its lock pins. Nothing is written into the kit's own folder. The native
5
+ * restore is the caller's (`KitRestore`): a host that carries the language base installs it in process.
6
+ */
7
+ export type KitRestore = (root: string, kit: Kit) => void;
8
+ /**
9
+ * The default parent of the read-root cache: `kit-roots-v1` under the IA home, which is this user's, never the shared
10
+ * system temporary folder. The IA home is created when missing and named through its links.
11
+ */
12
+ export declare function kitCache(env?: NodeJS.ProcessEnv): string;
13
+ /** The folder under `base` that holds this user's restored copies, refused when another user owns it. */
14
+ export declare function userCache(base: string): string;
15
+ /**
16
+ * A kit can be read only by a reader of the major its latest release was packed with, or a later one: a 3.x release
17
+ * locks a 3.x language base. A reader of unknown version is let through.
18
+ */
19
+ export declare function assertReadable(kit: Kit, reader: {
20
+ readonly version?: string | undefined;
21
+ readonly source: string;
22
+ }): void;
23
+ /**
24
+ * The restored read root of a kit, restoring a fresh copy when the cache holds no complete one. The cache's parent is
25
+ * `options.base`, else `kitCache(options.env)`.
26
+ */
27
+ export declare function kitReadRoot(kit: Kit, restore: KitRestore, options?: {
28
+ readonly base?: string;
29
+ readonly env?: NodeJS.ProcessEnv;
30
+ }): string;
31
+ //# sourceMappingURL=kit-root.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kit-root.d.ts","sourceRoot":"","sources":["../../src/method/kit-root.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAI1D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIrE;AAED,yGAAyG;AACzG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB9C;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzE,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACzE,MAAM,CA4CR"}