@inventarch/cli 1.2.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 +20 -5
- package/SPEC.md +86 -11
- package/assets/base/08eaab3e1a6215d78283b82a94a0228367ac7bd78d0a746c56db79c8d7546c3a.ia.tgz +0 -0
- package/assets/base.json +3 -3
- package/assets/host/d7722e32fd0511df2a6dfdf2353e621fdff1cf559d5c8b7ac256c7eceac0452f.tgz +0 -0
- package/assets/host.json +4 -4
- package/assets/vocabulary.json +11 -3
- package/dist/adopt.d.ts +8 -0
- package/dist/adopt.d.ts.map +1 -0
- package/dist/adopt.js +60 -0
- package/dist/adopt.js.map +1 -0
- package/dist/author.d.ts +32 -0
- package/dist/author.d.ts.map +1 -0
- package/dist/author.js +226 -0
- package/dist/author.js.map +1 -0
- package/dist/briefing.d.ts +2 -0
- package/dist/briefing.d.ts.map +1 -1
- package/dist/briefing.js +15 -3
- package/dist/briefing.js.map +1 -1
- package/dist/bundled-base.d.ts +18 -0
- package/dist/bundled-base.d.ts.map +1 -0
- package/dist/bundled-base.js +44 -0
- package/dist/bundled-base.js.map +1 -0
- package/dist/capture.d.ts +41 -6
- package/dist/capture.d.ts.map +1 -1
- package/dist/capture.js +132 -43
- package/dist/capture.js.map +1 -1
- package/dist/commands.d.ts +30 -8
- package/dist/commands.d.ts.map +1 -1
- package/dist/commands.js +287 -35
- package/dist/commands.js.map +1 -1
- package/dist/compile.d.ts +3 -4
- package/dist/compile.d.ts.map +1 -1
- package/dist/compile.js +28 -72
- package/dist/compile.js.map +1 -1
- package/dist/consumer.d.ts +11 -2
- package/dist/consumer.d.ts.map +1 -1
- package/dist/consumer.js +103 -20
- package/dist/consumer.js.map +1 -1
- package/dist/distribute.d.ts +30 -8
- package/dist/distribute.d.ts.map +1 -1
- package/dist/distribute.js +112 -60
- package/dist/distribute.js.map +1 -1
- package/dist/doctor-authority.d.ts +3 -0
- package/dist/doctor-authority.d.ts.map +1 -0
- package/dist/doctor-authority.js +65 -0
- package/dist/doctor-authority.js.map +1 -0
- package/dist/doctor-mounts.d.ts +4 -0
- package/dist/doctor-mounts.d.ts.map +1 -0
- package/dist/doctor-mounts.js +32 -0
- package/dist/doctor-mounts.js.map +1 -0
- package/dist/doctor.d.ts.map +1 -1
- package/dist/doctor.js +327 -79
- package/dist/doctor.js.map +1 -1
- package/dist/format.d.ts.map +1 -1
- package/dist/format.js +2 -1
- package/dist/format.js.map +1 -1
- package/dist/host-projection.d.ts +131 -6
- package/dist/host-projection.d.ts.map +1 -1
- package/dist/host-projection.js +663 -42
- package/dist/host-projection.js.map +1 -1
- package/dist/host.d.ts +154 -32
- package/dist/host.d.ts.map +1 -1
- package/dist/host.js +393 -142
- package/dist/host.js.map +1 -1
- package/dist/init.d.ts +296 -38
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +1303 -203
- package/dist/init.js.map +1 -1
- package/dist/main.d.ts +1 -6
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +4 -7
- package/dist/main.js.map +1 -1
- package/dist/migration-journal.d.ts +35 -0
- package/dist/migration-journal.d.ts.map +1 -0
- package/dist/migration-journal.js +205 -0
- package/dist/migration-journal.js.map +1 -0
- package/dist/next.d.ts +21 -0
- package/dist/next.d.ts.map +1 -0
- package/dist/next.js +216 -0
- package/dist/next.js.map +1 -0
- package/dist/operation-help.d.ts.map +1 -1
- package/dist/operation-help.js +15 -4
- package/dist/operation-help.js.map +1 -1
- package/dist/pack.d.ts.map +1 -1
- package/dist/pack.js +24 -2
- package/dist/pack.js.map +1 -1
- package/dist/position.d.ts +22 -0
- package/dist/position.d.ts.map +1 -0
- package/dist/position.js +244 -0
- package/dist/position.js.map +1 -0
- package/dist/preview.d.ts +145 -0
- package/dist/preview.d.ts.map +1 -0
- package/dist/preview.js +962 -0
- package/dist/preview.js.map +1 -0
- package/dist/profile.d.ts +118 -0
- package/dist/profile.d.ts.map +1 -0
- package/dist/profile.js +362 -0
- package/dist/profile.js.map +1 -0
- package/dist/project.d.ts +45 -0
- package/dist/project.d.ts.map +1 -0
- package/dist/project.js +263 -0
- package/dist/project.js.map +1 -0
- package/dist/read.d.ts +12 -2
- package/dist/read.d.ts.map +1 -1
- package/dist/read.js +32 -18
- package/dist/read.js.map +1 -1
- package/dist/render.d.ts +24 -2
- package/dist/render.d.ts.map +1 -1
- package/dist/render.js +171 -4
- package/dist/render.js.map +1 -1
- package/dist/session.d.ts +39 -12
- package/dist/session.d.ts.map +1 -1
- package/dist/session.js +55 -11
- package/dist/session.js.map +1 -1
- package/dist/user-host.d.ts +3 -3
- package/dist/user-host.js +10 -10
- package/dist/user-host.js.map +1 -1
- package/dist/validate.d.ts +28 -16
- package/dist/validate.d.ts.map +1 -1
- package/dist/validate.js +245 -23
- package/dist/validate.js.map +1 -1
- package/package.json +6 -6
- package/assets/base/0305ca741b1dfec97ff35fbeb36d4a66a0c9c0614b730fe14fcdac0f1565e28a.ia.tgz +0 -0
- package/assets/host/c5fb2bfbba619cbd558ecc1e94dd2c16e37aa8599b4e423f1f59ed01f2074e03.tgz +0 -0
package/dist/adopt.js
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { applyAdoption, openRegistry, planAdoption, selectCollection } from '@inventarch/distribution/registry';
|
|
2
|
+
import { confirm, Refusal, requireRoot, respell } from './consumer.js';
|
|
3
|
+
import { UsageError } from './args.js';
|
|
4
|
+
import { collectCapture } from './capture.js';
|
|
5
|
+
import { hostRegistryChooser, registeredProjections, REQUEST, requireProjectionsClean } from './distribute.js';
|
|
6
|
+
import { applyHostProjection, renderProjectionFor } from './host-projection.js';
|
|
7
|
+
export async function registryWorkspace(context, root, locator) {
|
|
8
|
+
const match = REQUEST.exec(locator);
|
|
9
|
+
if (!match)
|
|
10
|
+
throw new UsageError('Adoption locator must be <provider/name>[@version]');
|
|
11
|
+
const id = match[1], choose = hostRegistryChooser(context.host, root, context.args.value('registry'));
|
|
12
|
+
const registry = await openRegistry(choose(id).base, { signal: context.host.signal });
|
|
13
|
+
return { id, release: await selectCollection(registry, 'workspace', id, match[2] ?? '*') };
|
|
14
|
+
}
|
|
15
|
+
export async function runAdopt(context) {
|
|
16
|
+
const root = requireRoot(context), selected = await registryWorkspace(context, root, context.args.positionals[0]);
|
|
17
|
+
const plan = planAdoption(root, selected.id, selected.release);
|
|
18
|
+
const hosts = registeredProjections(root, 'update');
|
|
19
|
+
const summary = `Adopt ${selected.id}@${selected.release.version} at ${plan.tree}/.ia/src @open (band 50).\n`;
|
|
20
|
+
if (!context.args.flag('apply'))
|
|
21
|
+
return {
|
|
22
|
+
exitCode: 0,
|
|
23
|
+
stdout: context.json
|
|
24
|
+
? JSON.stringify({ command: 'adopt', applied: false, plan, refresh: hosts }) + '\n'
|
|
25
|
+
: summary + 'Apply with --apply --yes.\n',
|
|
26
|
+
stderr: '',
|
|
27
|
+
};
|
|
28
|
+
requireProjectionsClean(root, hosts, true);
|
|
29
|
+
if (!context.args.flag('yes') && !(await confirm(context.host.interaction, summary, 'Apply this adoption?')))
|
|
30
|
+
return { exitCode: 0, stdout: 'Adoption declined.\n', stderr: '' };
|
|
31
|
+
context.host.signal?.throwIfAborted();
|
|
32
|
+
applyAdoption(plan);
|
|
33
|
+
try {
|
|
34
|
+
const capture = collectCapture(root, root);
|
|
35
|
+
const projections = hosts.map((host) => applyHostProjection(root, host, renderProjectionFor(root, host)));
|
|
36
|
+
return {
|
|
37
|
+
exitCode: 0,
|
|
38
|
+
stdout: context.json
|
|
39
|
+
? JSON.stringify({
|
|
40
|
+
command: 'adopt',
|
|
41
|
+
applied: true,
|
|
42
|
+
id: selected.id,
|
|
43
|
+
revision: selected.release.revision,
|
|
44
|
+
tree: plan.tree,
|
|
45
|
+
capture: capture.snapshot.revision,
|
|
46
|
+
projections,
|
|
47
|
+
}) + '\n'
|
|
48
|
+
: summary + 'Adopted, captured and refreshed registered projections.\n',
|
|
49
|
+
stderr: '',
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
catch (error) {
|
|
53
|
+
const retry = respell(context, {
|
|
54
|
+
positionals: [`${selected.id}@${selected.release.version}`],
|
|
55
|
+
options: { root: [root] },
|
|
56
|
+
});
|
|
57
|
+
throw new Refusal('IA-CLI-ADOPTION-APPLIED', `The adoption is applied; capture/projection failed: ${error instanceof Error ? error.message : String(error)}`, 3, { path: root }, `Repair the reported failure, then run "${retry} --apply --yes" to finish capture and registered projections.`);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=adopt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../src/adopt.ts"],"names":[],"mappings":"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"}
|
package/dist/author.d.ts
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { Context, Result } from './consumer.js';
|
|
2
|
+
import type { PreviewView } from './preview.js';
|
|
3
|
+
import type { Profile } from './profile.js';
|
|
4
|
+
import type { Capabilities } from './render.js';
|
|
5
|
+
/** What an author form wrote: the envelope's and the renderer's one input. */
|
|
6
|
+
export interface AuthorView {
|
|
7
|
+
readonly mode: PreviewView['mode'];
|
|
8
|
+
readonly root: string;
|
|
9
|
+
readonly path: string;
|
|
10
|
+
/** Whether the write created the file. */
|
|
11
|
+
readonly created: boolean;
|
|
12
|
+
/** The file's sha256 before the write (an absent file reads as empty) and after it. */
|
|
13
|
+
readonly previousDigest: string;
|
|
14
|
+
readonly digest: string;
|
|
15
|
+
readonly identity: string;
|
|
16
|
+
/** The attribution comment written above the record. */
|
|
17
|
+
readonly attribution: string;
|
|
18
|
+
/** The record as written, its attribution first. */
|
|
19
|
+
readonly record: string;
|
|
20
|
+
/** The authored revision the candidate was compiled against, and the revision of the workspace with what was written. */
|
|
21
|
+
readonly authoredRevision: string;
|
|
22
|
+
readonly revision: string;
|
|
23
|
+
readonly records: PreviewView['records'];
|
|
24
|
+
readonly findings: PreviewView['findings'];
|
|
25
|
+
readonly profile: Profile;
|
|
26
|
+
/** The one command to run next. */
|
|
27
|
+
readonly next: string;
|
|
28
|
+
}
|
|
29
|
+
export declare function authorEnvelope(view: AuthorView): unknown;
|
|
30
|
+
export declare function renderAuthor(view: AuthorView, caps: Capabilities): string;
|
|
31
|
+
export declare function runAuthor(context: Context): Result;
|
|
32
|
+
//# sourceMappingURL=author.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"author.d.ts","sourceRoot":"","sources":["../src/author.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,KAAK,EAAyB,WAAW,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkBhD,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yHAAyH;IACzH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA0FD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CA2BxD;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAwDzE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAqGlD"}
|
package/dist/author.js
ADDED
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `ia author`: the writing half of record authoring (milestone generation-binding plan amendments C19 and C20, lane C
|
|
3
|
+
* round 3), in the author mode, whose move is Synthesis.
|
|
4
|
+
*
|
|
5
|
+
* Every form of `ia preview` that changes a non-administrative record has an author form with `--digest <sha256>`,
|
|
6
|
+
* the target file's sha256 the preview printed: `ia author <word> <name> [<field>=<value>...] [--at <path>]`,
|
|
7
|
+
* `ia author --relate <owned> <spelling> <target>` and `ia author --set <owned> <section.key>=<value>` (or `+=`). Each
|
|
8
|
+
* compiles exactly the candidate the preview showed, against one editor snapshot of the workspace, judged for the
|
|
9
|
+
* author mode, and writes it only when the file is still the one the digest names and the candidate is clean.
|
|
10
|
+
* Administrative words, including the system starter, are refused by candidateOf before any write.
|
|
11
|
+
*
|
|
12
|
+
* The record written carries one attribution comment above it, `# authored-by @agent <participant> under @mandate <name>
|
|
13
|
+
* at <authored revision>`: the acting participant, the governing mandate that grants it Synthesis, and the authored
|
|
14
|
+
* revision of the workspace the candidate was compiled against (db `authoredRevision`, which the editor snapshot reads
|
|
15
|
+
* as every reader does). A comment is trivia: it moves no digest and is not written into capture membership. A second
|
|
16
|
+
* author replaces the attribution rather than stacking one.
|
|
17
|
+
*
|
|
18
|
+
* The write is the distribution's: `replace` (a temporary file, then a rename, every path component checked for links)
|
|
19
|
+
* for a file that exists, after an opened-handle read confirms it is still the file the snapshot read; `createFile` (a
|
|
20
|
+
* hard link that refuses an existing entry) for a new file. Nothing else is written.
|
|
21
|
+
*/
|
|
22
|
+
import { lstatSync } from 'node:fs';
|
|
23
|
+
import { resolve } from 'node:path';
|
|
24
|
+
import { readWorkspaceBytes } from '@inventarch/db';
|
|
25
|
+
import { createFile, replace } from '@inventarch/distribution/services';
|
|
26
|
+
import { annotateRecord, SourceEditError } from '@inventarch/runtime/editor';
|
|
27
|
+
import { UsageError } from './args.js';
|
|
28
|
+
import { findCommand } from './commands.js';
|
|
29
|
+
import { Refusal, requireRoot, respell } from './consumer.js';
|
|
30
|
+
import { candidateOf, invocationOf, previewRequest, sha256 } from './preview.js';
|
|
31
|
+
import { DIGEST, judgedNext } from './profile.js';
|
|
32
|
+
import { atom, document, entry, errorBlock, fieldRows, headerLine, sectionLabel, terminalText, truncateDigest, words, } from './render.js';
|
|
33
|
+
import { openEditor } from './session.js';
|
|
34
|
+
/** The bytes a source may hold for its opened-handle read before the write. */
|
|
35
|
+
const SOURCE_LIMIT = 16 * 1024 * 1024;
|
|
36
|
+
/** The same form as `ia preview`: what prints the candidate and the digest an author form needs. */
|
|
37
|
+
const previewOf = (context) => respell({ command: findCommand('preview'), args: context.args });
|
|
38
|
+
/** `# authored-by @agent <participant> under @mandate <name> at <authored revision>`, from the profile that allowed it. */
|
|
39
|
+
function attributionOf(run, profile) {
|
|
40
|
+
const name = (identity) => identity === undefined
|
|
41
|
+
? undefined
|
|
42
|
+
: run.snapshot.records({ within: run.within }).find((node) => node.identity === identity)?.displayName;
|
|
43
|
+
const agent = name(profile.actor), mandate = name(profile.grantedBy);
|
|
44
|
+
return `# authored-by ${agent === undefined ? 'no participant' : `@agent ${agent}`} under ${mandate === undefined ? 'no @mandate' : `@mandate ${mandate}`} at ${run.snapshot.authoredRevision}`;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* A failed write's refusal code: the distribution's own (IA-DIST-*) or another IA code as raised, and IA-CLI-FAILED for
|
|
48
|
+
* anything else, a volume's raw errno (EPERM, EACCES, EROFS) included, which is no refusal code (review C2-N15).
|
|
49
|
+
*/
|
|
50
|
+
const distribution = (error) => ({
|
|
51
|
+
code: error !== null &&
|
|
52
|
+
typeof error === 'object' &&
|
|
53
|
+
'code' in error &&
|
|
54
|
+
typeof error.code === 'string' &&
|
|
55
|
+
error.code.startsWith('IA-')
|
|
56
|
+
? error.code
|
|
57
|
+
: 'IA-CLI-FAILED',
|
|
58
|
+
message: error instanceof Error ? error.message : String(error),
|
|
59
|
+
});
|
|
60
|
+
/**
|
|
61
|
+
* Writes `text` over the target, which must still be the file the snapshot read: an existing file through an
|
|
62
|
+
* opened-handle read and `replace`, keeping its permission bits; a new one through `createFile`, which refuses an entry
|
|
63
|
+
* that appeared since. Returns the written bytes' sha256.
|
|
64
|
+
*/
|
|
65
|
+
function write(run, candidate, text, again) {
|
|
66
|
+
const { target } = candidate, bytes = Buffer.from(text, 'utf8'), stale = (message) => new Refusal('IA-CLI-EDIT-STALE', message, 1, { path: target.path }, `Run "${again}" for the candidate against the file as it is now, and the digest to pass.`);
|
|
67
|
+
if (target.exists) {
|
|
68
|
+
let now;
|
|
69
|
+
try {
|
|
70
|
+
now = readWorkspaceBytes(run.root, target.path, SOURCE_LIMIT);
|
|
71
|
+
}
|
|
72
|
+
catch (error) {
|
|
73
|
+
throw stale(`${target.path} cannot be read as the file the preview named: ${distribution(error).message}`);
|
|
74
|
+
}
|
|
75
|
+
if (sha256(now) !== target.digest)
|
|
76
|
+
throw stale(`${target.path} changed while it was authored; nothing was written`);
|
|
77
|
+
const mode = lstatSync(resolve(run.root, ...target.path.split('/'))).mode & 0o777;
|
|
78
|
+
try {
|
|
79
|
+
replace(run.root, target.path, bytes, mode);
|
|
80
|
+
}
|
|
81
|
+
catch (error) {
|
|
82
|
+
const { code, message } = distribution(error);
|
|
83
|
+
throw new Refusal(code, message, 3, { path: target.path }, `Make ${target.path} writable, or close what holds it open, then run "${again}" for the candidate and the digest to pass; nothing was written.`);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
else {
|
|
87
|
+
try {
|
|
88
|
+
createFile(run.root, target.path, bytes, 0o644);
|
|
89
|
+
}
|
|
90
|
+
catch (error) {
|
|
91
|
+
const { code, message } = distribution(error);
|
|
92
|
+
if (code === 'IA-DIST-LOCAL-MODIFICATION')
|
|
93
|
+
throw stale(`${target.path} appeared while it was authored; nothing was written`);
|
|
94
|
+
throw new Refusal(code, message, 3, { path: target.path }, `Make the directory of ${target.path} writable, then run "${again}" for the candidate and the digest to pass; nothing was written.`);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
return sha256(bytes);
|
|
98
|
+
}
|
|
99
|
+
export function authorEnvelope(view) {
|
|
100
|
+
const count = (severity) => view.findings.filter((finding) => finding.severity === severity).length;
|
|
101
|
+
return {
|
|
102
|
+
version: 1,
|
|
103
|
+
mode: view.mode,
|
|
104
|
+
root: view.root,
|
|
105
|
+
path: view.path,
|
|
106
|
+
created: view.created,
|
|
107
|
+
previousDigest: view.previousDigest,
|
|
108
|
+
digest: view.digest,
|
|
109
|
+
identity: view.identity,
|
|
110
|
+
attribution: view.attribution,
|
|
111
|
+
record: view.record,
|
|
112
|
+
authoredRevision: view.authoredRevision,
|
|
113
|
+
revision: view.revision,
|
|
114
|
+
counts: { errors: count('error'), warnings: count('warning') },
|
|
115
|
+
findings: view.findings,
|
|
116
|
+
records: view.records,
|
|
117
|
+
profile: {
|
|
118
|
+
actor: view.profile.actor ?? null,
|
|
119
|
+
by: view.profile.by ?? null,
|
|
120
|
+
mandates: view.profile.mandates,
|
|
121
|
+
grantedBy: view.profile.grantedBy ?? null,
|
|
122
|
+
...(view.profile.notice === undefined ? {} : { notice: view.profile.notice }),
|
|
123
|
+
},
|
|
124
|
+
next: view.next,
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
export function renderAuthor(view, caps) {
|
|
128
|
+
const warnings = view.findings.filter((finding) => finding.severity === 'warning').length;
|
|
129
|
+
const blocks = [
|
|
130
|
+
headerLine('Authored', terminalText(view.path), [{ text: view.created ? 'new file' : 'existing file', column: 50 }], caps),
|
|
131
|
+
entry([words(`Wrote ${view.identity}, ${warnings} ${warnings === 1 ? 'warning' : 'warnings'} in what it changed.`)], { depth: 1, symbol: 'success' }, caps),
|
|
132
|
+
fieldRows([
|
|
133
|
+
{ label: 'sha256', value: [atom(view.digest, null, 0)], note: words(`was ${view.previousDigest}`, 'dim') },
|
|
134
|
+
{
|
|
135
|
+
label: 'revision',
|
|
136
|
+
value: words(`authored ${truncateDigest(view.authoredRevision, caps.ascii)}, now ${truncateDigest(view.revision, caps.ascii)}`),
|
|
137
|
+
},
|
|
138
|
+
{
|
|
139
|
+
label: 'actor',
|
|
140
|
+
value: words(view.profile.actor === undefined
|
|
141
|
+
? `none named${view.profile.notice === undefined ? '' : `; ${view.profile.notice}`}`
|
|
142
|
+
: `${view.profile.actor}${view.profile.grantedBy === undefined ? '' : `, under ${view.profile.grantedBy}`}`),
|
|
143
|
+
},
|
|
144
|
+
], { depth: 1 }, caps),
|
|
145
|
+
[
|
|
146
|
+
sectionLabel('Record', caps),
|
|
147
|
+
...view.record.split('\n').map((line) => (line === '' ? '' : ` ${terminalText(line)}`)),
|
|
148
|
+
],
|
|
149
|
+
];
|
|
150
|
+
const located = view.findings.map((finding) => errorBlock({
|
|
151
|
+
location: finding.path === '' ? null : terminalText(`${finding.path}:${finding.line}`),
|
|
152
|
+
...(finding.identity === undefined ? {} : { identity: terminalText(finding.identity) }),
|
|
153
|
+
code: finding.code,
|
|
154
|
+
message: terminalText(finding.message),
|
|
155
|
+
severity: finding.severity,
|
|
156
|
+
}, { depth: 1 }, caps));
|
|
157
|
+
if (located.length > 0)
|
|
158
|
+
blocks.push([sectionLabel('Findings', caps), ...located.flat()]);
|
|
159
|
+
blocks.push(entry([words(terminalText(view.next))], { depth: 0, symbol: 'step' }, caps));
|
|
160
|
+
return document(blocks, { leadingBlank: true });
|
|
161
|
+
}
|
|
162
|
+
export function runAuthor(context) {
|
|
163
|
+
const { args, caps, json } = context;
|
|
164
|
+
const request = previewRequest(args);
|
|
165
|
+
if (request.mode === 'word')
|
|
166
|
+
throw new UsageError(`ia author writes a new record, one relationship row or one field; it needs <name>, --relate or --set after ${request.word}`);
|
|
167
|
+
const digest = args.value('digest');
|
|
168
|
+
const root = requireRoot(context);
|
|
169
|
+
const editor = openEditor(root);
|
|
170
|
+
let view;
|
|
171
|
+
try {
|
|
172
|
+
const run = invocationOf(context, root, editor), again = previewOf(context);
|
|
173
|
+
const candidate = candidateOf(run, request, 'author'), { target } = candidate, preview = candidate.view;
|
|
174
|
+
// Review C2-R4: the profile is judged first (candidateOf), so a missing or malformed digest is refused only for an
|
|
175
|
+
// actor the author mode allows, and the preview it names is judged by that profile (gatedNext) before it is printed.
|
|
176
|
+
if (digest !== undefined && !DIGEST.test(digest))
|
|
177
|
+
throw new Refusal('IA-CLI-USAGE', `--digest takes the 64 lowercase hex digits of the target file's sha256; got ${digest}`, 2, null, `Run "${again}" for the candidate and the digest to pass.`);
|
|
178
|
+
if (digest === undefined)
|
|
179
|
+
throw new Refusal('IA-CLI-USAGE', 'ia author requires --digest <sha256>, the target file digest ia preview prints for the same form', 2, null, `Run "${again}" for the candidate and the digest to pass.`);
|
|
180
|
+
if (digest !== undefined && digest !== target.digest)
|
|
181
|
+
throw new Refusal('IA-CLI-EDIT-STALE', `${target.path} is not the file the preview named: its sha256 is ${target.digest}, not ${digest}`, 1, { path: target.path }, `Run "${again}" for the candidate against the file as it is now, and the digest to pass.`);
|
|
182
|
+
if (!preview.clean) {
|
|
183
|
+
const errors = preview.findings.filter((finding) => finding.severity === 'error'), first = errors[0], at = `${first.path}:${first.line}`;
|
|
184
|
+
// Review C2-N12: a located finding's message already opens with its location, which is stated once.
|
|
185
|
+
const message = first.message.startsWith(`${at}: `) ? first.message.slice(at.length + 2) : first.message;
|
|
186
|
+
throw new Refusal('IA-CLI-EDIT-UNCLEAN', `The candidate has ${errors.length} ${errors.length === 1 ? 'error' : 'errors'} in what it changes, so nothing was written; the first is ${first.code} at ${at}: ${message}`, 1, { path: target.path, identity: preview.identity }, `Run "${again}" for the candidate's findings.`);
|
|
187
|
+
}
|
|
188
|
+
const attribution = attributionOf(run, preview.profile);
|
|
189
|
+
let text;
|
|
190
|
+
try {
|
|
191
|
+
text = annotateRecord(candidate.text, candidate.reference, attribution);
|
|
192
|
+
}
|
|
193
|
+
catch (error) {
|
|
194
|
+
if (!(error instanceof SourceEditError))
|
|
195
|
+
throw error;
|
|
196
|
+
throw new Refusal('IA-CLI-EDIT-INVALID', error.message, 1, { path: target.path }, `Run "${again}" for the candidate.`);
|
|
197
|
+
}
|
|
198
|
+
// The revision of what is written, the attribution included: the candidate's own revision has no comment in it.
|
|
199
|
+
const revision = run.snapshot.preview([{ path: target.path, text }]).revision, written = write(run, candidate, text, again);
|
|
200
|
+
view = {
|
|
201
|
+
mode: preview.mode,
|
|
202
|
+
root,
|
|
203
|
+
path: target.path,
|
|
204
|
+
created: !target.exists,
|
|
205
|
+
previousDigest: target.digest,
|
|
206
|
+
digest: written,
|
|
207
|
+
identity: preview.identity,
|
|
208
|
+
attribution,
|
|
209
|
+
record: `${attribution}\n${preview.after}`,
|
|
210
|
+
authoredRevision: run.snapshot.authoredRevision,
|
|
211
|
+
revision,
|
|
212
|
+
records: preview.records,
|
|
213
|
+
findings: preview.findings,
|
|
214
|
+
profile: preview.profile,
|
|
215
|
+
// Review C2-N11: the next command is judged by the profile that allowed the author, as a refusal's would be.
|
|
216
|
+
next: judgedNext(`Run "ia validate${run.rooted}" to confirm the workspace admits what was written.`, context.gate),
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
finally {
|
|
220
|
+
editor.close();
|
|
221
|
+
}
|
|
222
|
+
return json
|
|
223
|
+
? { exitCode: 0, stdout: JSON.stringify(authorEnvelope(view)) + '\n', stderr: '' }
|
|
224
|
+
: { exitCode: 0, stdout: renderAuthor(view, caps), stderr: '' };
|
|
225
|
+
}
|
|
226
|
+
//# sourceMappingURL=author.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"author.js","sourceRoot":"","sources":["../src/author.ts"],"names":[],"mappings":"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"}
|
package/dist/briefing.d.ts
CHANGED
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
import type { Decision } from '@inventarch/distribution/decisions';
|
|
22
22
|
import type { Intent } from '@inventarch/distribution/hosts';
|
|
23
23
|
import type { Channel } from './channel.js';
|
|
24
|
+
import type { AdviceContext } from './render.js';
|
|
24
25
|
export interface NextAction {
|
|
25
26
|
readonly intent: Intent;
|
|
26
27
|
readonly argv: readonly string[];
|
|
@@ -38,6 +39,7 @@ export interface Session {
|
|
|
38
39
|
readonly refresh: readonly string[] | null;
|
|
39
40
|
}
|
|
40
41
|
export interface BriefInput {
|
|
42
|
+
readonly advice?: AdviceContext;
|
|
41
43
|
readonly host: string;
|
|
42
44
|
readonly version: string;
|
|
43
45
|
readonly channel: Channel;
|
package/dist/briefing.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,wHAAwH;IACxH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,OAAO;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uHAAuH;IACvH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,6HAA6H;IAC7H,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5C;AACD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uGAAuG;IACvG,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,0GAA0G;IAC1G,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,mGAAmG;IACnG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5F,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5C;AAQD,iEAAiE;AACjE,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,MAAkD,CAAC;AAE1F,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CA6GnH"}
|
package/dist/briefing.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { hostRow, invocation, workspaceRow } from '@inventarch/distribution/hosts';
|
|
2
2
|
import { describeChannel, updateInstruction } from './channel.js';
|
|
3
|
-
import { quote } from './render.js';
|
|
3
|
+
import { quote, safeRootAdvice, safeRootCommand } from './render.js';
|
|
4
4
|
/** An argument vector as one printable command, each argument quoted the way doctor's rows quote a root. */
|
|
5
5
|
const command = (argv) => argv.map(quote).join(' ');
|
|
6
6
|
/**
|
|
@@ -36,7 +36,7 @@ export function brief(input) {
|
|
|
36
36
|
}
|
|
37
37
|
else if (input.root === undefined && input.enclosing !== null) {
|
|
38
38
|
// The report is about the supplied directory, not the workspace above it; name that workspace and stop.
|
|
39
|
-
context.push(`${input.supplied} is inside InventArch workspace ${input.enclosing}; run ${command(['ia', 'doctor', '--root', input.enclosing])} for its state.`);
|
|
39
|
+
context.push(`${input.supplied} is inside InventArch workspace ${input.enclosing}; run "${command(['ia', 'doctor', '--root', input.enclosing])}" for its state.`);
|
|
40
40
|
}
|
|
41
41
|
else if (input.root === undefined) {
|
|
42
42
|
const decision = input.decision;
|
|
@@ -100,6 +100,18 @@ export function brief(input) {
|
|
|
100
100
|
nudge = 'update';
|
|
101
101
|
}
|
|
102
102
|
}
|
|
103
|
-
|
|
103
|
+
const safe = (text) => safeRootAdvice(text, [input.root, input.supplied, input.enclosing ?? undefined], input.advice);
|
|
104
|
+
return {
|
|
105
|
+
session: {
|
|
106
|
+
context: context.map(safe),
|
|
107
|
+
notice: notice === null ? null : safe(notice),
|
|
108
|
+
nudge,
|
|
109
|
+
refresh: input.refresh,
|
|
110
|
+
},
|
|
111
|
+
nextActions: actions.map((action) => ({
|
|
112
|
+
...action,
|
|
113
|
+
host: safeRootCommand(action.host, [input.root, input.supplied, input.enclosing ?? undefined], input.advice),
|
|
114
|
+
})),
|
|
115
|
+
};
|
|
104
116
|
}
|
|
105
117
|
//# sourceMappingURL=briefing.js.map
|
package/dist/briefing.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"briefing.js","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"briefing.js","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export declare const PIN_PATH = "assets/base.json";
|
|
2
|
+
export declare const baseArchivePath: (digest: string) => string;
|
|
3
|
+
export declare const PACKAGE_ID: RegExp;
|
|
4
|
+
export declare const DAMAGED = "The ia installation is damaged; run \"ia doctor\" for its install channel and reinstall @inventarch/cli through it.";
|
|
5
|
+
export interface BasePin {
|
|
6
|
+
readonly id: string;
|
|
7
|
+
readonly version: string;
|
|
8
|
+
readonly archive: string;
|
|
9
|
+
readonly manifest: string;
|
|
10
|
+
}
|
|
11
|
+
export interface Base {
|
|
12
|
+
readonly pin: BasePin;
|
|
13
|
+
readonly bytes: Buffer;
|
|
14
|
+
/** The systems the bundled manifest carries, sorted, which the starter composes and the descriptor externalizes. */
|
|
15
|
+
readonly systems: readonly string[];
|
|
16
|
+
}
|
|
17
|
+
export declare function readBase(packageRoot: string): Base;
|
|
18
|
+
//# sourceMappingURL=bundled-base.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundled-base.d.ts","sourceRoot":"","sources":["../src/bundled-base.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAC3C,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAwC,CAAC;AAC1F,eAAO,MAAM,UAAU,QAAwC,CAAC;AAChE,eAAO,MAAM,OAAO,wHACiG,CAAC;AACtH,MAAM,WAAW,OAAO;IACtB,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;CAC3B;AACD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oHAAoH;IACpH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AACD,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAmDlD"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/** Exact packaged base acquisition shared by init, migration and restore. */
|
|
2
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
3
|
+
import { resolve } from 'node:path';
|
|
4
|
+
import { verifyArchive } from '@inventarch/distribution/archive';
|
|
5
|
+
import { Refusal } from './consumer.js';
|
|
6
|
+
import { codeOf } from './session.js';
|
|
7
|
+
export const PIN_PATH = 'assets/base.json';
|
|
8
|
+
export const baseArchivePath = (digest) => `assets/base/${digest}.ia.tgz`;
|
|
9
|
+
export const PACKAGE_ID = /^[a-z][a-z0-9.-]*\/[a-z][a-z0-9-]*$/;
|
|
10
|
+
export const DAMAGED = 'The ia installation is damaged; run "ia doctor" for its install channel and reinstall @inventarch/cli through it.';
|
|
11
|
+
export function readBase(packageRoot) {
|
|
12
|
+
const pinPath = resolve(packageRoot, PIN_PATH);
|
|
13
|
+
let pin;
|
|
14
|
+
try {
|
|
15
|
+
const value = JSON.parse(readFileSync(pinPath, 'utf8'));
|
|
16
|
+
const keys = Object.keys(value).sort().join(',');
|
|
17
|
+
if (keys !== 'archive,id,manifest,version' ||
|
|
18
|
+
!Object.values(value).every((item) => typeof item === 'string') ||
|
|
19
|
+
!PACKAGE_ID.test(String(value['id'])))
|
|
20
|
+
throw new Error('unexpected fields');
|
|
21
|
+
if (!/^[a-f0-9]{64}$/.test(String(value['archive'])) || !/^[a-f0-9]{64}$/.test(String(value['manifest'])))
|
|
22
|
+
throw new Error('malformed digest');
|
|
23
|
+
pin = value;
|
|
24
|
+
}
|
|
25
|
+
catch (error) {
|
|
26
|
+
throw new Refusal('IA-CLI-FAILED', `The bundled base package pin cannot be read: ${error instanceof Error ? error.message : String(error)}`, 3, { path: pinPath }, DAMAGED);
|
|
27
|
+
}
|
|
28
|
+
const archivePath = resolve(packageRoot, baseArchivePath(pin.archive));
|
|
29
|
+
const bytes = existsSync(archivePath) ? readFileSync(archivePath) : Buffer.alloc(0);
|
|
30
|
+
try {
|
|
31
|
+
const verified = verifyArchive(bytes, pin.archive);
|
|
32
|
+
if (verified.manifestDigest !== pin.manifest ||
|
|
33
|
+
verified.manifest.id !== pin.id ||
|
|
34
|
+
verified.manifest.version !== pin.version)
|
|
35
|
+
throw new Refusal('IA-CLI-FAILED', 'The bundled base archive does not carry the pinned manifest', 3, { path: archivePath }, DAMAGED);
|
|
36
|
+
return { pin, bytes, systems: verified.manifest.systems.map((system) => system.name) };
|
|
37
|
+
}
|
|
38
|
+
catch (error) {
|
|
39
|
+
if (error instanceof Refusal)
|
|
40
|
+
throw error;
|
|
41
|
+
throw new Refusal(codeOf(error, 'IA-CLI-FAILED'), error instanceof Error ? error.message : String(error), 3, { path: archivePath }, DAMAGED);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=bundled-base.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundled-base.js","sourceRoot":"","sources":["../src/bundled-base.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,eAAe,MAAM,SAAS,CAAC;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,qCAAqC,CAAC;AAChE,MAAM,CAAC,MAAM,OAAO,GAClB,mHAAmH,CAAC;AAatH,MAAM,UAAU,QAAQ,CAAC,WAAmB;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAA4B,CAAC;QACnF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,IACE,IAAI,KAAK,6BAA6B;YACtC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;YAC/D,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAErC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACvG,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,GAAG,GAAG,KAA2B,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,OAAO,CACf,eAAe,EACf,gDAAgD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACxG,CAAC,EACD,EAAE,IAAI,EAAE,OAAO,EAAE,EACjB,OAAO,CACR,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IACE,QAAQ,CAAC,cAAc,KAAK,GAAG,CAAC,QAAQ;YACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE;YAC/B,QAAQ,CAAC,QAAQ,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO;YAEzC,MAAM,IAAI,OAAO,CACf,eAAe,EACf,6DAA6D,EAC7D,CAAC,EACD,EAAE,IAAI,EAAE,WAAW,EAAE,EACrB,OAAO,CACR,CAAC;QACJ,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACzF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,OAAO;YAAE,MAAM,KAAK,CAAC;QAC1C,MAAM,IAAI,OAAO,CACf,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,EAC9B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACtD,CAAC,EACD,EAAE,IAAI,EAAE,WAAW,EAAE,EACrB,OAAO,CACR,CAAC;IACJ,CAAC;AACH,CAAC"}
|
package/dist/capture.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import type { CaptureWrite, MembershipRow, Snapshot } from '@inventarch/db';
|
|
1
|
+
import type { CapturePlan, CaptureWrite, MembershipRow, Snapshot } from '@inventarch/db';
|
|
2
2
|
import type { Context, Result } from './consumer.js';
|
|
3
3
|
import type { Capabilities } from './render.js';
|
|
4
|
+
import type { SessionGate } from './profile.js';
|
|
4
5
|
import type { Session } from './session.js';
|
|
5
6
|
type Admission = ReturnType<Session['admission']>;
|
|
6
7
|
type Finding = Admission['findings'][number];
|
|
@@ -20,6 +21,11 @@ export interface SnapshotDocument {
|
|
|
20
21
|
readonly language: string;
|
|
21
22
|
readonly kernelDigest: string;
|
|
22
23
|
readonly revision: string;
|
|
24
|
+
/**
|
|
25
|
+
* The revision without the sources at runtime placement (db `authoredRevision`), which the db trusts and rotates the
|
|
26
|
+
* pair by (D08a), so runtime-band evidence alone neither stales nor rotates it.
|
|
27
|
+
*/
|
|
28
|
+
readonly authoredRevision: string;
|
|
23
29
|
readonly records: Snapshot['records'];
|
|
24
30
|
readonly membership: readonly MembershipRow[];
|
|
25
31
|
readonly diagnostics: readonly Finding[];
|
|
@@ -34,6 +40,16 @@ export interface CaptureView extends CaptureWrite {
|
|
|
34
40
|
readonly text: string;
|
|
35
41
|
readonly digest: string;
|
|
36
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
* A capture previewed: the document a capture would write and db D08b's plan of it (`CapturePlan`), the identities its
|
|
45
|
+
* counts count included. `text` and `digest` are the bytes the capture would write; nothing is written.
|
|
46
|
+
*/
|
|
47
|
+
export interface CapturePreview extends CaptureView, CapturePlan {
|
|
48
|
+
readonly preview: true;
|
|
49
|
+
/** The capture that writes what this preview reports, with `--root` as given. */
|
|
50
|
+
readonly capture: string;
|
|
51
|
+
readonly captureFromRoot?: true;
|
|
52
|
+
}
|
|
37
53
|
/** The ordering the compliance layer already applies, reused rather than reinvented. */
|
|
38
54
|
export declare const orderFindings: (findings: readonly Finding[]) => readonly Finding[];
|
|
39
55
|
export declare const findingCounts: (records: number, findings: readonly Finding[]) => SnapshotCounts;
|
|
@@ -51,13 +67,24 @@ export declare const SYNTAX_CODES: ReadonlySet<string>;
|
|
|
51
67
|
export declare const unparsedSeed: (diagnostics: readonly Finding[]) => Finding | undefined;
|
|
52
68
|
/**
|
|
53
69
|
* Admits the workspace at `root` and writes its snapshot pair through db D08a, unless one of §5's two refusals answers
|
|
54
|
-
* first. `given` is the `--root` the invocation typed, which the `ia validate` a refusal names carries.
|
|
70
|
+
* first. `given` is the `--root` the invocation typed, which the `ia validate` a refusal names carries. `gate`,
|
|
71
|
+
* when given, judges the admitting session before anything is read from it (review C2-N3).
|
|
72
|
+
*/
|
|
73
|
+
export declare function collectCapture(root: string, given?: string, gate?: SessionGate): CaptureView;
|
|
74
|
+
/**
|
|
75
|
+
* `ia capture --preview`: admits and refuses exactly as `collectCapture` does, then plans the write through db D08b's
|
|
76
|
+
* `planCapture` instead of making it, so nothing is created or written and the pair stays as it was.
|
|
55
77
|
*/
|
|
56
|
-
export declare function
|
|
57
|
-
/**
|
|
78
|
+
export declare function previewCapture(root: string, given?: string, gate?: SessionGate): CapturePreview;
|
|
79
|
+
/** The snapshot is written even when admission has errors; the exit class carries the verdict. */
|
|
58
80
|
export declare const captureExit: (view: CaptureView) => 0 | 1;
|
|
59
|
-
|
|
60
|
-
export declare function
|
|
81
|
+
/** A preview adds `preview: true` and the identities its counts count; a capture's keys are the 1.x ones. */
|
|
82
|
+
export declare function captureEnvelope(view: CaptureView | CapturePreview): unknown;
|
|
83
|
+
/**
|
|
84
|
+
* A capture's report, or a preview's: the same counts and snapshot rows. A preview says it wrote nothing, states the
|
|
85
|
+
* rotation as the one the capture would make, and names every changed, new and removed identity, each list sorted.
|
|
86
|
+
*/
|
|
87
|
+
export declare function renderCapture(view: CaptureView | CapturePreview, caps: Capabilities): string;
|
|
61
88
|
/** What a failed snapshot write names to repair: a file the system would not let it replace, or a directory. */
|
|
62
89
|
export interface WriteRepair {
|
|
63
90
|
readonly path: string;
|
|
@@ -76,6 +103,14 @@ export declare const WRITE_REPAIRABLE: ReadonlySet<string>;
|
|
|
76
103
|
* directory.
|
|
77
104
|
*/
|
|
78
105
|
export declare function writeRepair(root: string, error: unknown, platform?: NodeJS.Platform): WriteRepair;
|
|
106
|
+
/**
|
|
107
|
+
* A capture's failure as this verb refuses it, each repair followed by `rerun`. A refusal from opening the workspace, or
|
|
108
|
+
* one of the capture's own, already names its own repair and is returned as it is. A snapshot path the db does not
|
|
109
|
+
* write through is located and named, and so is a file or directory the system would not let a capture write, which a
|
|
110
|
+
* preview (`writes` false) never writes. Any other failure is returned as it is. `ia init`'s capture effect refuses
|
|
111
|
+
* through this too, so it locates and repairs what `ia capture` would.
|
|
112
|
+
*/
|
|
113
|
+
export declare function captureFailure(error: unknown, root: string, rerun: string, writes?: boolean): unknown;
|
|
79
114
|
export declare function runCapture(context: Context): Result;
|
|
80
115
|
export {};
|
|
81
116
|
//# sourceMappingURL=capture.d.ts.map
|