@inventarch/runtime 0.0.0-stage → 1.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/LICENSE +202 -0
- package/NOTICE +4 -0
- package/README.md +11 -2
- package/SPEC.md +77 -0
- package/dist/authoring/index.d.ts +159 -0
- package/dist/authoring/index.d.ts.map +1 -0
- package/dist/authoring/index.js +416 -0
- package/dist/authoring/index.js.map +1 -0
- package/dist/authoring-execution/execution.d.ts +12 -0
- package/dist/authoring-execution/execution.d.ts.map +1 -0
- package/dist/authoring-execution/execution.js +73 -0
- package/dist/authoring-execution/execution.js.map +1 -0
- package/dist/authoring-execution/index.d.ts +6 -0
- package/dist/authoring-execution/index.d.ts.map +1 -0
- package/dist/authoring-execution/index.js +6 -0
- package/dist/authoring-execution/index.js.map +1 -0
- package/dist/authoring-execution/inventory.d.ts +5 -0
- package/dist/authoring-execution/inventory.d.ts.map +1 -0
- package/dist/authoring-execution/inventory.js +41 -0
- package/dist/authoring-execution/inventory.js.map +1 -0
- package/dist/authoring-execution/shared.d.ts +22 -0
- package/dist/authoring-execution/shared.d.ts.map +1 -0
- package/dist/authoring-execution/shared.js +101 -0
- package/dist/authoring-execution/shared.js.map +1 -0
- package/dist/authoring-execution/types.d.ts +43 -0
- package/dist/authoring-execution/types.d.ts.map +1 -0
- package/dist/authoring-execution/types.js +21 -0
- package/dist/authoring-execution/types.js.map +1 -0
- package/dist/candidate.d.ts +49 -0
- package/dist/candidate.d.ts.map +1 -0
- package/dist/candidate.js +158 -0
- package/dist/candidate.js.map +1 -0
- package/dist/classify.d.ts +12 -0
- package/dist/classify.d.ts.map +1 -0
- package/dist/classify.js +21 -0
- package/dist/classify.js.map +1 -0
- package/dist/collect.d.ts +16 -0
- package/dist/collect.d.ts.map +1 -0
- package/dist/collect.js +133 -0
- package/dist/collect.js.map +1 -0
- package/dist/context.d.ts +5 -0
- package/dist/context.d.ts.map +1 -0
- package/dist/context.js +124 -0
- package/dist/context.js.map +1 -0
- package/dist/coordinate.d.ts +21 -0
- package/dist/coordinate.d.ts.map +1 -0
- package/dist/coordinate.js +40 -0
- package/dist/coordinate.js.map +1 -0
- package/dist/door.d.ts +17 -0
- package/dist/door.d.ts.map +1 -0
- package/dist/door.js +217 -0
- package/dist/door.js.map +1 -0
- package/dist/editor/index.d.ts +5 -0
- package/dist/editor/index.d.ts.map +1 -0
- package/dist/editor/index.js +4 -0
- package/dist/editor/index.js.map +1 -0
- package/dist/editor/types.d.ts +226 -0
- package/dist/editor/types.d.ts.map +1 -0
- package/dist/editor/types.js +2 -0
- package/dist/editor/types.js.map +1 -0
- package/dist/editor/workspace.d.ts +46 -0
- package/dist/editor/workspace.d.ts.map +1 -0
- package/dist/editor/workspace.js +903 -0
- package/dist/editor/workspace.js.map +1 -0
- package/dist/entry.d.ts +9 -0
- package/dist/entry.d.ts.map +1 -0
- package/dist/entry.js +26 -0
- package/dist/entry.js.map +1 -0
- package/dist/errors.d.ts +8 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +15 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +14 -0
- package/dist/index.js.map +1 -0
- package/dist/machine-protocol.d.ts +33 -0
- package/dist/machine-protocol.d.ts.map +1 -0
- package/dist/machine-protocol.js +339 -0
- package/dist/machine-protocol.js.map +1 -0
- package/dist/mentions.d.ts +20 -0
- package/dist/mentions.d.ts.map +1 -0
- package/dist/mentions.js +79 -0
- package/dist/mentions.js.map +1 -0
- package/dist/publication.d.ts +22 -0
- package/dist/publication.d.ts.map +1 -0
- package/dist/publication.js +275 -0
- package/dist/publication.js.map +1 -0
- package/dist/render.d.ts +9 -0
- package/dist/render.d.ts.map +1 -0
- package/dist/render.js +78 -0
- package/dist/render.js.map +1 -0
- package/dist/select.d.ts +16 -0
- package/dist/select.d.ts.map +1 -0
- package/dist/select.js +55 -0
- package/dist/select.js.map +1 -0
- package/dist/steward.d.ts +22 -0
- package/dist/steward.d.ts.map +1 -0
- package/dist/steward.js +45 -0
- package/dist/steward.js.map +1 -0
- package/dist/types.d.ts +97 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +10 -0
- package/dist/types.js.map +1 -0
- package/package.json +161 -3
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { execFileSync } from 'node:child_process';
|
|
3
|
+
import { closeSync, existsSync, fsyncSync, linkSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync, } from 'node:fs';
|
|
4
|
+
import { createRequire } from 'node:module';
|
|
5
|
+
import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
|
|
6
|
+
export const PUBLICATION_CODES = [
|
|
7
|
+
'IA-PUBLICATION-INVALID',
|
|
8
|
+
'IA-PUBLICATION-PATH-UNSAFE',
|
|
9
|
+
'IA-PUBLICATION-CONFLICT',
|
|
10
|
+
'IA-PUBLICATION-BUSY',
|
|
11
|
+
'IA-PUBLICATION-UNAVAILABLE',
|
|
12
|
+
];
|
|
13
|
+
export class PublicationError extends Error {
|
|
14
|
+
code;
|
|
15
|
+
constructor(code, message) {
|
|
16
|
+
super(message);
|
|
17
|
+
this.code = code;
|
|
18
|
+
this.name = 'PublicationError';
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
const fail = (code, message) => {
|
|
22
|
+
throw new PublicationError(code, message);
|
|
23
|
+
};
|
|
24
|
+
const hash = (text) => createHash('sha256').update(text).digest('hex');
|
|
25
|
+
const require = createRequire(import.meta.url), localVolumes = new Set();
|
|
26
|
+
export function portableDraftPath(value) {
|
|
27
|
+
if (typeof value !== 'string' || value !== value.normalize('NFC') || Buffer.from(value).toString('utf8') !== value)
|
|
28
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Expected a portable Unicode path');
|
|
29
|
+
const parts = value.split('/');
|
|
30
|
+
if (parts.some((s) => !s ||
|
|
31
|
+
s === '.' ||
|
|
32
|
+
s === '..' ||
|
|
33
|
+
/[\u0000-\u001f<>:"|?*\\]/.test(s) ||
|
|
34
|
+
/[. ]$/.test(s) ||
|
|
35
|
+
/^(con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(s)) ||
|
|
36
|
+
parts[0].toLowerCase() === 'result.json')
|
|
37
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Unsafe or reserved draft path');
|
|
38
|
+
return value;
|
|
39
|
+
}
|
|
40
|
+
function safe(root, path) {
|
|
41
|
+
const target = resolve(root, path), rel = relative(root, target);
|
|
42
|
+
if (isAbsolute(rel) || rel === '..' || rel.startsWith('..' + sep))
|
|
43
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Path escapes the managed root');
|
|
44
|
+
for (let current = target;; current = dirname(current)) {
|
|
45
|
+
try {
|
|
46
|
+
if (lstatSync(current).isSymbolicLink())
|
|
47
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Filesystem aliases are unsupported');
|
|
48
|
+
}
|
|
49
|
+
catch (error) {
|
|
50
|
+
if (error.code !== 'ENOENT')
|
|
51
|
+
throw error;
|
|
52
|
+
}
|
|
53
|
+
if (dirname(current) === current)
|
|
54
|
+
break;
|
|
55
|
+
}
|
|
56
|
+
return target;
|
|
57
|
+
}
|
|
58
|
+
/** Read-only host qualification of the canonical root and supported filesystem. */
|
|
59
|
+
export function qualifyPublicationRoot(root) {
|
|
60
|
+
const base = resolve(root);
|
|
61
|
+
if (process.platform !== 'win32' || !/^[a-z]:\\/i.test(base) || !existsSync(base))
|
|
62
|
+
return fail('IA-PUBLICATION-UNAVAILABLE', 'Managed publication requires a qualified local Windows NTFS root');
|
|
63
|
+
safe(base, '');
|
|
64
|
+
if (realpathSync.native(base).toLowerCase() !== base.toLowerCase() || !lstatSync(base).isDirectory())
|
|
65
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Managed root is not a canonical directory');
|
|
66
|
+
const drive = base.slice(0, 2).toUpperCase();
|
|
67
|
+
if (!localVolumes.has(drive)) {
|
|
68
|
+
try {
|
|
69
|
+
// The only interpolation is a validated drive letter, never authored/model text.
|
|
70
|
+
// Query the drive directly; CIM adds a cold WMI service dependency to every CLI process.
|
|
71
|
+
const script = `$ErrorActionPreference='Stop'; $drive=[System.IO.DriveInfo]::new('${drive}\\'); @{DriveType=[int]$drive.DriveType; FileSystem=$drive.DriveFormat} | ConvertTo-Json -Compress`;
|
|
72
|
+
// Cold PowerShell startup exceeded 10s on Windows CI (35559311967).
|
|
73
|
+
// Keep qualification bounded and fail closed; only successful probes are cached.
|
|
74
|
+
const info = JSON.parse(execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script], {
|
|
75
|
+
encoding: 'utf8',
|
|
76
|
+
windowsHide: true,
|
|
77
|
+
timeout: 30_000,
|
|
78
|
+
}).trim());
|
|
79
|
+
if (info?.DriveType !== 3 || info.FileSystem !== 'NTFS')
|
|
80
|
+
return fail('IA-PUBLICATION-UNAVAILABLE', 'Remote or unqualified publication filesystem');
|
|
81
|
+
localVolumes.add(drive);
|
|
82
|
+
}
|
|
83
|
+
catch (error) {
|
|
84
|
+
if (error instanceof PublicationError)
|
|
85
|
+
throw error;
|
|
86
|
+
return fail('IA-PUBLICATION-UNAVAILABLE', `Cannot qualify the publication filesystem: ${error instanceof Error ? error.message : String(error)}`);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
return base;
|
|
90
|
+
}
|
|
91
|
+
function destinationPath(root, destination) {
|
|
92
|
+
if (!/^\.ia\/work\/generated\/[a-z0-9][a-z0-9-]{0,100}$/.test(destination))
|
|
93
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Destination must be one managed draft directory');
|
|
94
|
+
portableDraftPath(destination);
|
|
95
|
+
return safe(root, destination);
|
|
96
|
+
}
|
|
97
|
+
function checkedFiles(files, metadata) {
|
|
98
|
+
if (!Array.isArray(files) ||
|
|
99
|
+
files.length < 1 ||
|
|
100
|
+
files.length > 16 ||
|
|
101
|
+
typeof metadata !== 'string' ||
|
|
102
|
+
Buffer.byteLength(metadata) > 2 * 1024 * 1024 ||
|
|
103
|
+
Buffer.from(metadata).toString('utf8') !== metadata)
|
|
104
|
+
return fail('IA-PUBLICATION-INVALID', 'Publication exceeds its bounded contract');
|
|
105
|
+
const paths = new Set();
|
|
106
|
+
let bytes = 0;
|
|
107
|
+
const snapshot = files.map((file) => {
|
|
108
|
+
if (!file || typeof file !== 'object')
|
|
109
|
+
return fail('IA-PUBLICATION-INVALID', 'Invalid draft file');
|
|
110
|
+
const path = portableDraftPath(file.path), key = path.toLowerCase();
|
|
111
|
+
if (paths.has(key) || [...paths].some((p) => p.startsWith(key + '/') || key.startsWith(p + '/')))
|
|
112
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Draft paths collide');
|
|
113
|
+
paths.add(key);
|
|
114
|
+
if (typeof file.text !== 'string' ||
|
|
115
|
+
Buffer.from(file.text).toString('utf8') !== file.text ||
|
|
116
|
+
Buffer.byteLength(file.text) > 1024 * 1024)
|
|
117
|
+
return fail('IA-PUBLICATION-INVALID', 'Invalid or oversized draft bytes');
|
|
118
|
+
bytes += Buffer.byteLength(file.text);
|
|
119
|
+
return { path, text: file.text };
|
|
120
|
+
});
|
|
121
|
+
if (bytes > 2 * 1024 * 1024)
|
|
122
|
+
return fail('IA-PUBLICATION-INVALID', 'Draft byte limit exceeded');
|
|
123
|
+
return snapshot;
|
|
124
|
+
}
|
|
125
|
+
function acquire(root, destination) {
|
|
126
|
+
const locks = safe(root, '.ia/work/publication-locks');
|
|
127
|
+
mkdirSync(locks, { recursive: true });
|
|
128
|
+
safe(root, '.ia/work/publication-locks');
|
|
129
|
+
const file = safe(root, `.ia/work/publication-locks/${hash(destination)}.sqlite`);
|
|
130
|
+
for (const suffix of ['', '-journal', '-wal', '-shm']) {
|
|
131
|
+
safe(root, relative(root, file + suffix));
|
|
132
|
+
if (existsSync(file + suffix) && (!lstatSync(file + suffix).isFile() || lstatSync(file + suffix).nlink !== 1))
|
|
133
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Destination lock is aliased');
|
|
134
|
+
}
|
|
135
|
+
// Lazy loading keeps unrelated runtime/CLI consumers free of SQLite initialization.
|
|
136
|
+
const { DatabaseSync: Database } = require('node:sqlite');
|
|
137
|
+
let db;
|
|
138
|
+
try {
|
|
139
|
+
db = new Database(file);
|
|
140
|
+
db.exec('PRAGMA busy_timeout=0; BEGIN IMMEDIATE');
|
|
141
|
+
return db;
|
|
142
|
+
}
|
|
143
|
+
catch (error) {
|
|
144
|
+
db?.close();
|
|
145
|
+
if (error.errcode === 5 || /locked|busy/i.test(String(error)))
|
|
146
|
+
return fail('IA-PUBLICATION-BUSY', 'Another publisher owns this destination');
|
|
147
|
+
return fail('IA-PUBLICATION-UNAVAILABLE', 'Destination ownership is unavailable');
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
function flush(path, text) {
|
|
151
|
+
const fd = openSync(path, 'wx');
|
|
152
|
+
try {
|
|
153
|
+
writeFileSync(fd, text, 'utf8');
|
|
154
|
+
fsyncSync(fd);
|
|
155
|
+
}
|
|
156
|
+
finally {
|
|
157
|
+
closeSync(fd);
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
function cleanup(root, stage) {
|
|
161
|
+
const parent = resolve(root, '.ia/work/generated'), rel = relative(parent, stage);
|
|
162
|
+
if (isAbsolute(rel) || !/^\.stage-[a-zA-Z0-9]+$/.test(rel))
|
|
163
|
+
return fail('IA-PUBLICATION-PATH-UNSAFE', 'Unsafe staging cleanup');
|
|
164
|
+
safe(root, relative(root, stage));
|
|
165
|
+
rmSync(stage, { recursive: true, force: true });
|
|
166
|
+
}
|
|
167
|
+
/** Trusted host primitive. Hold this object through the last authority check and always close it. */
|
|
168
|
+
export function preparePublication(root, destination, files, metadata) {
|
|
169
|
+
const snapshot = checkedFiles(files, metadata), base = qualifyPublicationRoot(root), target = destinationPath(base, destination), lock = acquire(base, destination);
|
|
170
|
+
let stage, closed = false, published = false;
|
|
171
|
+
const close = () => {
|
|
172
|
+
if (closed)
|
|
173
|
+
return;
|
|
174
|
+
closed = true;
|
|
175
|
+
try {
|
|
176
|
+
if (stage)
|
|
177
|
+
cleanup(base, stage);
|
|
178
|
+
}
|
|
179
|
+
finally {
|
|
180
|
+
lock.close();
|
|
181
|
+
}
|
|
182
|
+
};
|
|
183
|
+
try {
|
|
184
|
+
if (existsSync(target))
|
|
185
|
+
return fail('IA-PUBLICATION-CONFLICT', 'Draft destination already exists');
|
|
186
|
+
const parent = safe(base, '.ia/work/generated');
|
|
187
|
+
mkdirSync(parent, { recursive: true });
|
|
188
|
+
safe(base, '.ia/work/generated');
|
|
189
|
+
stage = mkdtempSync(resolve(parent, '.stage-'));
|
|
190
|
+
for (const file of [...snapshot, { path: 'result.json', text: metadata }]) {
|
|
191
|
+
const path = safe(base, relative(base, resolve(stage, file.path)));
|
|
192
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
193
|
+
safe(base, relative(base, path));
|
|
194
|
+
flush(path, file.text);
|
|
195
|
+
}
|
|
196
|
+
return {
|
|
197
|
+
close,
|
|
198
|
+
publish: () => {
|
|
199
|
+
if (closed || published || !lock.isTransaction)
|
|
200
|
+
return fail('IA-PUBLICATION-UNAVAILABLE', 'Destination ownership is unavailable');
|
|
201
|
+
destinationPath(base, destination);
|
|
202
|
+
safe(base, relative(base, stage));
|
|
203
|
+
try {
|
|
204
|
+
// mkdir is the no-replace claim; rename never decides whether a destination is ours.
|
|
205
|
+
mkdirSync(target);
|
|
206
|
+
for (const file of [...snapshot, { path: 'result.json', text: metadata }]) {
|
|
207
|
+
const to = safe(base, `${destination}/${file.path}`), from = safe(base, relative(base, resolve(stage, file.path)));
|
|
208
|
+
mkdirSync(dirname(to), { recursive: true });
|
|
209
|
+
safe(base, `${destination}/${file.path}`);
|
|
210
|
+
linkSync(from, to);
|
|
211
|
+
}
|
|
212
|
+
published = true;
|
|
213
|
+
return destination;
|
|
214
|
+
}
|
|
215
|
+
catch (error) {
|
|
216
|
+
if (error instanceof PublicationError)
|
|
217
|
+
throw error;
|
|
218
|
+
if (error.code === 'EEXIST')
|
|
219
|
+
return fail('IA-PUBLICATION-CONFLICT', 'Draft destination or file already exists');
|
|
220
|
+
return fail('IA-PUBLICATION-UNAVAILABLE', 'Publication incomplete; inspect before any retry');
|
|
221
|
+
}
|
|
222
|
+
},
|
|
223
|
+
};
|
|
224
|
+
}
|
|
225
|
+
catch (error) {
|
|
226
|
+
close();
|
|
227
|
+
throw error;
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
/** Acquiring the destination lock proves no cooperating earlier publisher can still apply. */
|
|
231
|
+
export async function inspectPublication(root, destination, files, metadata, assertCurrent) {
|
|
232
|
+
const snapshot = checkedFiles(files, metadata), base = qualifyPublicationRoot(root), target = destinationPath(base, destination), lock = acquire(base, destination);
|
|
233
|
+
try {
|
|
234
|
+
await assertCurrent();
|
|
235
|
+
destinationPath(base, destination);
|
|
236
|
+
if (!existsSync(target))
|
|
237
|
+
return 'absent';
|
|
238
|
+
if (!lstatSync(target).isDirectory())
|
|
239
|
+
return 'unknown';
|
|
240
|
+
const marker = safe(base, `${destination}/result.json`);
|
|
241
|
+
if (!existsSync(marker))
|
|
242
|
+
return 'partial';
|
|
243
|
+
if (!lstatSync(marker).isFile() ||
|
|
244
|
+
lstatSync(marker).size > 2 * 1024 * 1024 ||
|
|
245
|
+
readFileSync(marker, 'utf8') !== metadata)
|
|
246
|
+
return 'unknown';
|
|
247
|
+
const expected = new Map([...snapshot.map((f) => [f.path, f.text]), ['result.json', metadata]]);
|
|
248
|
+
const found = [];
|
|
249
|
+
const walk = (path) => {
|
|
250
|
+
for (const entry of readdirSync(safe(base, `${destination}/${path}`), { withFileTypes: true })) {
|
|
251
|
+
const child = path ? `${path}/${entry.name}` : entry.name, full = safe(base, `${destination}/${child}`);
|
|
252
|
+
if (entry.isDirectory()) {
|
|
253
|
+
if (![...expected.keys()].some((p) => p.startsWith(child + '/')) || !walk(child))
|
|
254
|
+
return false;
|
|
255
|
+
}
|
|
256
|
+
else if (entry.isFile()) {
|
|
257
|
+
const text = expected.get(child);
|
|
258
|
+
if (text === undefined ||
|
|
259
|
+
lstatSync(full).size !== Buffer.byteLength(text) ||
|
|
260
|
+
!readFileSync(full).equals(Buffer.from(text)))
|
|
261
|
+
return false;
|
|
262
|
+
found.push(child);
|
|
263
|
+
}
|
|
264
|
+
else
|
|
265
|
+
return false;
|
|
266
|
+
}
|
|
267
|
+
return true;
|
|
268
|
+
};
|
|
269
|
+
return walk('') && found.length === expected.size ? 'applied' : 'partial';
|
|
270
|
+
}
|
|
271
|
+
finally {
|
|
272
|
+
lock.close();
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
//# sourceMappingURL=publication.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"publication.js","sourceRoot":"","sources":["../src/publication.ts"],"names":[],"mappings":"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"}
|
package/dist/render.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { CompiledValue, Variant } from '@inventarch/language';
|
|
2
|
+
import type { Coordinate, Node } from '@inventarch/graph';
|
|
3
|
+
import type { Clause } from './types.js';
|
|
4
|
+
export declare function valueText(value: CompiledValue): string;
|
|
5
|
+
/** The record's `says` and `answers`, rendered as recordText renders its meaning, or undefined when it has neither. */
|
|
6
|
+
export declare function purposeOf(node: Node): string | undefined;
|
|
7
|
+
export declare function clausesOf(node: Node, selected: ReadonlyMap<string, Variant>): readonly Clause[];
|
|
8
|
+
export declare function recordText(node: Node, coordinate: Coordinate, clauses: readonly Clause[]): string;
|
|
9
|
+
//# sourceMappingURL=render.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,aAAa,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAElF,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CActD;AAYD,uHAAuH;AACvH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAMxD;AACD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,MAAM,EAAE,CAmB/F;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAmBjG"}
|
package/dist/render.js
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { REQUIREMENT_KINDS } from '@inventarch/language';
|
|
2
|
+
import { conditionHolds } from '@inventarch/graph';
|
|
3
|
+
export function valueText(value) {
|
|
4
|
+
switch (value.kind) {
|
|
5
|
+
case 'scalar':
|
|
6
|
+
case 'string':
|
|
7
|
+
case 'prose':
|
|
8
|
+
return value.text;
|
|
9
|
+
case 'ref':
|
|
10
|
+
return `@${value.discriminator} ${value.name}${value.fragment === undefined ? '' : '#' + value.fragment}`;
|
|
11
|
+
case 'list':
|
|
12
|
+
return '[' + value.items.map(valueText).join(', ') + ']';
|
|
13
|
+
case 'none':
|
|
14
|
+
case 'block':
|
|
15
|
+
return '';
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
function childrenText(children) {
|
|
19
|
+
return children
|
|
20
|
+
.filter((child) => !('key' in child) || child.key !== 'when')
|
|
21
|
+
.map((child) => {
|
|
22
|
+
if ('item' in child)
|
|
23
|
+
return '- ' + valueText(child.item);
|
|
24
|
+
return [child.key, valueText(child.value), ...(child.fields === undefined ? [] : [childrenText(child.fields)])]
|
|
25
|
+
.filter(Boolean)
|
|
26
|
+
.join(' ');
|
|
27
|
+
})
|
|
28
|
+
.join('\n');
|
|
29
|
+
}
|
|
30
|
+
/** The record's `says` and `answers`, rendered as recordText renders its meaning, or undefined when it has neither. */
|
|
31
|
+
export function purposeOf(node) {
|
|
32
|
+
const fields = node.sections
|
|
33
|
+
.filter((s) => s.name === 'meaning')
|
|
34
|
+
.flatMap((s) => s.fields)
|
|
35
|
+
.filter((f) => 'key' in f && (f.key === 'says' || f.key === 'answers'));
|
|
36
|
+
return fields.length === 0 ? undefined : childrenText(fields);
|
|
37
|
+
}
|
|
38
|
+
export function clausesOf(node, selected) {
|
|
39
|
+
return [...selected.values()].map((variant) => {
|
|
40
|
+
const field = node.sections
|
|
41
|
+
.filter((s) => s.name === 'governance')
|
|
42
|
+
.flatMap((s) => s.fields)
|
|
43
|
+
.find((f) => 'key' in f && f.key === variant.key && f.span.line === variant.span.line);
|
|
44
|
+
const text = [
|
|
45
|
+
valueText(variant.value),
|
|
46
|
+
...(field !== undefined && 'fields' in field && field.fields !== undefined ? [childrenText(field.fields)] : []),
|
|
47
|
+
]
|
|
48
|
+
.filter(Boolean)
|
|
49
|
+
.join('\n');
|
|
50
|
+
return {
|
|
51
|
+
key: variant.key,
|
|
52
|
+
text,
|
|
53
|
+
...(variant.condition === undefined ? {} : { condition: variant.condition }),
|
|
54
|
+
citation: { path: node.source.path, ...variant.span },
|
|
55
|
+
};
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
export function recordText(node, coordinate, clauses) {
|
|
59
|
+
const semanticSections = new Set([
|
|
60
|
+
'cognition',
|
|
61
|
+
'activation',
|
|
62
|
+
'relationships',
|
|
63
|
+
'governance',
|
|
64
|
+
...(node.requirements.length === 0 ? [] : REQUIREMENT_KINDS),
|
|
65
|
+
]);
|
|
66
|
+
return [
|
|
67
|
+
`@${node.discriminator} ${node.displayName}`,
|
|
68
|
+
childrenText(node.head),
|
|
69
|
+
...node.sections.filter((s) => !semanticSections.has(s.name)).map((s) => `${s.name}\n${childrenText(s.fields)}`),
|
|
70
|
+
...clauses.map((c) => `${c.key}: ${c.text}`),
|
|
71
|
+
...node.requirements
|
|
72
|
+
.filter((r) => conditionHolds(r.condition, node.dimensions, coordinate))
|
|
73
|
+
.map((r) => `${r.id}: ${r.text}`),
|
|
74
|
+
]
|
|
75
|
+
.filter(Boolean)
|
|
76
|
+
.join('\n');
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=render.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}
|
package/dist/select.d.ts
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { ConditionAxis } from '@inventarch/language';
|
|
2
|
+
import type { ReadHandle, Scope } from '@inventarch/db';
|
|
3
|
+
import type { ContextOptions, ContextRequest, Entry, Refusal } from './types.js';
|
|
4
|
+
export interface SelectOptions extends ContextOptions {
|
|
5
|
+
readonly requiredAxes?: readonly ConditionAxis[];
|
|
6
|
+
}
|
|
7
|
+
export type SelectResult = {
|
|
8
|
+
readonly ok: true;
|
|
9
|
+
readonly selection: {
|
|
10
|
+
readonly revision: string;
|
|
11
|
+
readonly scope: Scope;
|
|
12
|
+
readonly entry: Entry;
|
|
13
|
+
};
|
|
14
|
+
} | Refusal;
|
|
15
|
+
export declare function select(handle: ReadHandle, request: ContextRequest, candidates: readonly string[], options?: SelectOptions): SelectResult;
|
|
16
|
+
//# sourceMappingURL=select.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAClD;AACD,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;CACjG,GACD,OAAO,CAAC;AACZ,wBAAgB,MAAM,CACpB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,GAAE,aAAkB,GAC1B,YAAY,CA+Cd"}
|
package/dist/select.js
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { CONDITION_AXES } from '@inventarch/language';
|
|
2
|
+
import { selectors } from '@inventarch/graph';
|
|
3
|
+
import { collect } from './collect.js';
|
|
4
|
+
import { RuntimeError } from './errors.js';
|
|
5
|
+
import { freeze } from './types.js';
|
|
6
|
+
export function select(handle, request, candidates, options = {}) {
|
|
7
|
+
const required = options.requiredAxes ?? [];
|
|
8
|
+
if (required.some((axis) => !CONDITION_AXES.includes(axis)))
|
|
9
|
+
throw new RuntimeError('IA-RUNTIME-REQUEST-INVALID', `Required axes must be among ${CONDITION_AXES.join(', ')}`);
|
|
10
|
+
const collected = collect(handle, request, options);
|
|
11
|
+
if ('ok' in collected)
|
|
12
|
+
return collected;
|
|
13
|
+
const wanted = new Set(candidates), coordinate = collected.coordinate.values;
|
|
14
|
+
const missing = new Set(required.filter((axis) => coordinate[axis] === undefined));
|
|
15
|
+
for (const node of handle.records({ within: collected.scope.token })) {
|
|
16
|
+
if (!wanted.has(node.identity) || node.selectors.length === 0 || selectors(node, coordinate).status !== 'neutral')
|
|
17
|
+
continue;
|
|
18
|
+
for (const group of node.selectors) {
|
|
19
|
+
if (group.some((term) => coordinate[term.axis] !== undefined && coordinate[term.axis] !== term.value))
|
|
20
|
+
continue;
|
|
21
|
+
for (const term of group)
|
|
22
|
+
if (coordinate[term.axis] === undefined)
|
|
23
|
+
missing.add(term.axis);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
if (missing.size > 0)
|
|
27
|
+
return freeze({
|
|
28
|
+
ok: false,
|
|
29
|
+
code: 'coordinate-incomplete',
|
|
30
|
+
escalation: 'coordinate-incomplete',
|
|
31
|
+
message: `Exclusive selection requires ${[...missing].sort().join(', ')}`,
|
|
32
|
+
missing: [...missing].sort(),
|
|
33
|
+
});
|
|
34
|
+
const eligible = collected.candidates.map((c) => c.entry).filter((entry) => wanted.has(entry.identity));
|
|
35
|
+
const top = eligible[0];
|
|
36
|
+
if (top === undefined)
|
|
37
|
+
return freeze({
|
|
38
|
+
ok: false,
|
|
39
|
+
code: 'no-candidate',
|
|
40
|
+
escalation: 'no-candidate',
|
|
41
|
+
message: 'No supplied candidate is eligible in this scope and coordinate',
|
|
42
|
+
});
|
|
43
|
+
const tied = new Set(eligible
|
|
44
|
+
.filter((entry) => entry.step === top.step && entry.score === top.score && entry.band === top.band)
|
|
45
|
+
.map((entry) => entry.identity));
|
|
46
|
+
if (tied.size > 1)
|
|
47
|
+
return freeze({
|
|
48
|
+
ok: false,
|
|
49
|
+
code: 'deny-wins-tie',
|
|
50
|
+
escalation: 'deny-wins-tie',
|
|
51
|
+
message: `Equal leading step, score and band: ${[...tied].sort().join(', ')}`,
|
|
52
|
+
});
|
|
53
|
+
return freeze({ ok: true, selection: { revision: collected.scope.revision, scope: collected.scope, entry: top } });
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=select.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"select.js","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { CompiledRecord } from '@inventarch/language';
|
|
2
|
+
export declare const HOOK_CODES: readonly ["IA-HOOK-INPUT-INVALID", "IA-HOOK-PATH-UNSAFE", "IA-HOOK-STEWARD-UNAVAILABLE", "IA-HOOK-IDENTITY-UNAVAILABLE", "IA-HOOK-NOT-STEWARD", "IA-HOOK-PROJECTION-MANAGED"];
|
|
3
|
+
export type HookCode = (typeof HOOK_CODES)[number];
|
|
4
|
+
export type StewardActor = {
|
|
5
|
+
readonly kind: 'operator';
|
|
6
|
+
} | {
|
|
7
|
+
readonly kind: 'agent';
|
|
8
|
+
readonly identity: string;
|
|
9
|
+
};
|
|
10
|
+
export interface StewardDecision {
|
|
11
|
+
readonly allowed: boolean;
|
|
12
|
+
readonly code?: HookCode;
|
|
13
|
+
readonly message: string;
|
|
14
|
+
readonly steward?: {
|
|
15
|
+
readonly identity: string;
|
|
16
|
+
readonly name: string;
|
|
17
|
+
readonly path: string;
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
/** R13: admitted typed records only; the caller owns actor authentication. */
|
|
21
|
+
export declare function evaluateSteward(records: readonly CompiledRecord[], system: string, actor?: StewardActor): StewardDecision;
|
|
22
|
+
//# sourceMappingURL=steward.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"steward.d.ts","sourceRoot":"","sources":["../src/steward.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,eAAO,MAAM,UAAU,+KAOb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACjH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAChG;AACD,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,YAAY,GACnB,eAAe,CAuCjB"}
|
package/dist/steward.js
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { systemMember } from '@inventarch/db';
|
|
2
|
+
export const HOOK_CODES = [
|
|
3
|
+
'IA-HOOK-INPUT-INVALID',
|
|
4
|
+
'IA-HOOK-PATH-UNSAFE',
|
|
5
|
+
'IA-HOOK-STEWARD-UNAVAILABLE',
|
|
6
|
+
'IA-HOOK-IDENTITY-UNAVAILABLE',
|
|
7
|
+
'IA-HOOK-NOT-STEWARD',
|
|
8
|
+
'IA-HOOK-PROJECTION-MANAGED',
|
|
9
|
+
];
|
|
10
|
+
/** R13: admitted typed records only; the caller owns actor authentication. */
|
|
11
|
+
export function evaluateSteward(records, system, actor) {
|
|
12
|
+
const declarations = records.filter((r) => r.discriminator === 'system' &&
|
|
13
|
+
r.name === system &&
|
|
14
|
+
systemMember(r.source.path)?.name === system &&
|
|
15
|
+
r.source.path.endsWith('/system.ia'));
|
|
16
|
+
const folder = declarations.length === 1 ? systemMember(declarations[0].source.path).root + '/' : '';
|
|
17
|
+
const refs = declarations.length === 1 ? declarations[0].head.filter((f) => f.key === 'steward').map((f) => f.value) : [];
|
|
18
|
+
const ref = refs.length === 1 ? refs[0] : undefined;
|
|
19
|
+
const agents = ref?.kind === 'ref' && ref.discriminator === 'agent' && ref.fragment === undefined
|
|
20
|
+
? records.filter((r) => r.discriminator === 'agent' && r.name === ref.name && r.source.path.startsWith(folder))
|
|
21
|
+
: [];
|
|
22
|
+
if (agents.length !== 1)
|
|
23
|
+
return Object.freeze({
|
|
24
|
+
allowed: false,
|
|
25
|
+
code: 'IA-HOOK-STEWARD-UNAVAILABLE',
|
|
26
|
+
message: `No unique admitted steward for ${system}`,
|
|
27
|
+
});
|
|
28
|
+
const agent = agents[0], steward = Object.freeze({ identity: agent.identity, name: agent.name, path: agent.source.path });
|
|
29
|
+
if (actor === undefined)
|
|
30
|
+
return Object.freeze({
|
|
31
|
+
allowed: false,
|
|
32
|
+
code: 'IA-HOOK-IDENTITY-UNAVAILABLE',
|
|
33
|
+
message: `Host identity required; expected ${agent.name}`,
|
|
34
|
+
steward,
|
|
35
|
+
});
|
|
36
|
+
if (actor.kind === 'operator' || actor.identity === agent.identity)
|
|
37
|
+
return Object.freeze({ allowed: true, message: `Authorized steward of ${system}`, steward });
|
|
38
|
+
return Object.freeze({
|
|
39
|
+
allowed: false,
|
|
40
|
+
code: 'IA-HOOK-NOT-STEWARD',
|
|
41
|
+
message: `Only ${agent.name} may author ${system}`,
|
|
42
|
+
steward,
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=steward.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"steward.js","sourceRoot":"","sources":["../src/steward.ts"],"names":[],"mappings":"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"}
|