@inventarch/db 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.
Files changed (77) hide show
  1. package/README.md +6 -2
  2. package/SPEC.md +49 -7
  3. package/dist/checks.d.ts +66 -0
  4. package/dist/checks.d.ts.map +1 -0
  5. package/dist/checks.js +143 -0
  6. package/dist/checks.js.map +1 -0
  7. package/dist/descriptors/codec.js +2 -2
  8. package/dist/descriptors/codec.js.map +1 -1
  9. package/dist/descriptors/envelope.js +2 -2
  10. package/dist/descriptors/envelope.js.map +1 -1
  11. package/dist/descriptors/index.d.ts +1 -1
  12. package/dist/descriptors/index.js +1 -1
  13. package/dist/distribution/codec.d.ts +7 -1
  14. package/dist/distribution/codec.d.ts.map +1 -1
  15. package/dist/distribution/codec.js +6 -0
  16. package/dist/distribution/codec.js.map +1 -1
  17. package/dist/distribution/contracts.d.ts +6 -1
  18. package/dist/distribution/contracts.d.ts.map +1 -1
  19. package/dist/distribution/contracts.js +14 -7
  20. package/dist/distribution/contracts.js.map +1 -1
  21. package/dist/distribution/implementations.d.ts +56 -0
  22. package/dist/distribution/implementations.d.ts.map +1 -0
  23. package/dist/distribution/implementations.js +148 -0
  24. package/dist/distribution/implementations.js.map +1 -0
  25. package/dist/distribution/index.d.ts +4 -1
  26. package/dist/distribution/index.d.ts.map +1 -1
  27. package/dist/distribution/index.js +3 -1
  28. package/dist/distribution/index.js.map +1 -1
  29. package/dist/distribution/reader.d.ts +1 -1
  30. package/dist/distribution/reader.d.ts.map +1 -1
  31. package/dist/distribution/reader.js +34 -8
  32. package/dist/distribution/reader.js.map +1 -1
  33. package/dist/distribution/release-control.d.ts +4 -0
  34. package/dist/distribution/release-control.d.ts.map +1 -0
  35. package/dist/distribution/release-control.js +46 -0
  36. package/dist/distribution/release-control.js.map +1 -0
  37. package/dist/editor/index.d.ts +13 -2
  38. package/dist/editor/index.d.ts.map +1 -1
  39. package/dist/editor/index.js +9 -4
  40. package/dist/editor/index.js.map +1 -1
  41. package/dist/evidence.d.ts +84 -0
  42. package/dist/evidence.d.ts.map +1 -0
  43. package/dist/evidence.js +313 -0
  44. package/dist/evidence.js.map +1 -0
  45. package/dist/handle.d.ts +55 -8
  46. package/dist/handle.d.ts.map +1 -1
  47. package/dist/handle.js +85 -15
  48. package/dist/handle.js.map +1 -1
  49. package/dist/index.d.ts +14 -4
  50. package/dist/index.d.ts.map +1 -1
  51. package/dist/index.js +7 -1
  52. package/dist/index.js.map +1 -1
  53. package/dist/inputs.d.ts +47 -1
  54. package/dist/inputs.d.ts.map +1 -1
  55. package/dist/inputs.js +255 -19
  56. package/dist/inputs.js.map +1 -1
  57. package/dist/membership.d.ts +6 -0
  58. package/dist/membership.d.ts.map +1 -1
  59. package/dist/membership.js +7 -1
  60. package/dist/membership.js.map +1 -1
  61. package/dist/preview.d.ts +2 -2
  62. package/dist/preview.d.ts.map +1 -1
  63. package/dist/preview.js +9 -7
  64. package/dist/preview.js.map +1 -1
  65. package/dist/retention.d.ts +52 -15
  66. package/dist/retention.d.ts.map +1 -1
  67. package/dist/retention.js +102 -52
  68. package/dist/retention.js.map +1 -1
  69. package/dist/runner-evidence.d.ts +22 -0
  70. package/dist/runner-evidence.d.ts.map +1 -0
  71. package/dist/runner-evidence.js +388 -0
  72. package/dist/runner-evidence.js.map +1 -0
  73. package/dist/view.d.ts +85 -2
  74. package/dist/view.d.ts.map +1 -1
  75. package/dist/view.js +343 -42
  76. package/dist/view.js.map +1 -1
  77. package/package.json +8 -4
@@ -1 +1 @@
1
- {"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,12 @@
1
1
  import type { MembershipRow } from './membership.js';
2
- /** D08: an admitted root snapshot (location '', no phase) as retained: its revision and D02a membership rows. */
2
+ /** D08: an admitted root snapshot (location '', no phase) as retained: its revisions and D02a membership rows. */
3
3
  export interface RetainedSnapshot {
4
4
  readonly revision: string;
5
+ /** Its authored revision (graph `authoredRevisionOf`), which retention rotates by and trusts a capture by. */
6
+ readonly authoredRevision: string;
5
7
  readonly membership: readonly MembershipRow[];
6
8
  }
7
- /** D08: the current root snapshot and the most recent one whose revision differs from it, when there is one. */
9
+ /** D08: the current root snapshot and the most recent one whose authored revision differs from it, when there is one. */
8
10
  export interface Retained {
9
11
  readonly current: RetainedSnapshot;
10
12
  readonly previous?: RetainedSnapshot;
@@ -19,7 +21,10 @@ export declare function digestIn(snapshot: RetainedSnapshot | undefined, identit
19
21
  export declare function stalenessOf(now: string | undefined, before: string | undefined): Staleness | undefined;
20
22
  /** D08: equality only, never an order; the current side answers first. */
21
23
  export declare function readinessOf(now: string | undefined, before: string | undefined, digest: string): Readiness;
22
- /** D08 rotation: the prior current becomes previous only when the revision changed; otherwise the prior previous stays. */
24
+ /**
25
+ * D08 rotation: the prior current becomes previous only when the authored revision changed, so a change to runtime-band
26
+ * sources alone keeps the prior previous, as an unchanged revision does.
27
+ */
23
28
  export declare function rotate(prior: Retained | undefined, current: RetainedSnapshot): Retained;
24
29
  /**
25
30
  * D08a: the capture pair, the one retained pair that persists between processes. `ia capture` writes it through
@@ -29,19 +34,30 @@ export declare const CAPTURE_FORMAT = "ia-snapshot-1";
29
34
  export declare const CAPTURE_DIRECTORY = ".ia/work/snapshot";
30
35
  export declare const CAPTURE_CURRENT = ".ia/work/snapshot/current.json";
31
36
  export declare const CAPTURE_PREVIOUS = ".ia/work/snapshot/previous.json";
37
+ /**
38
+ * The entry at `path`, contained the D01 way: undefined when nothing is there, refused as IA-DB-PATH-UNSAFE when the
39
+ * path runs through a link or junction or the entry is not a regular file, so nothing is read or written through one.
40
+ */
41
+ export declare function entryAt(root: string, path: string): string | undefined;
32
42
  /** D08a: what the capture pair seeds a handle with. */
33
43
  export interface CaptureSeed {
34
- /** The pair as `rotate` takes it: the capture at current.json and, at another revision, the one at previous.json. */
44
+ /**
45
+ * The pair as `rotate` takes it: the capture at current.json and, at another authored revision, the one at
46
+ * previous.json.
47
+ */
35
48
  readonly prior?: Retained;
36
- /** The revision of the capture at current.json, when that file holds one. */
37
- readonly captured?: string;
49
+ /** The revision and authored revision of the capture at current.json, when that file holds one. */
50
+ readonly captured?: Pick<RetainedSnapshot, 'revision' | 'authoredRevision'>;
38
51
  }
39
52
  /**
40
53
  * D08a: the capture pair as a handle reads it, never written. A link or junction on the way, an entry that is not a
41
54
  * regular file, or a file that is no capture is ignored, never followed, so a read stays usable. With no readable
42
- * current.json a capture at previous.json still seeds, as the most recent capture there is. A current.json that names
43
- * the fresh revision with other membership rows is not this workspace's capture at that revision, so the pair seeds
44
- * nothing; a capture at another revision cannot be rebuilt from the fresh inputs, so it is trusted as written.
55
+ * current.json a capture at previous.json still seeds, as the most recent capture there is. A capture is trusted by its
56
+ * authored revision and the membership rows of its records not at runtime placement, by identity, band and digest
57
+ * (`authoredRows`): a current.json that names the fresh authored revision with other such rows is not this workspace's
58
+ * capture at that revision, so the pair seeds nothing, while one that differs from the fresh snapshot only in its
59
+ * runtime-band rows (and so in its revision) or in the roots a runtime-band @workspace declares is this workspace's; a
60
+ * capture at another authored revision cannot be rebuilt from the fresh inputs, so it is trusted as written.
45
61
  */
46
62
  export declare function readCapture(root: string, fresh: RetainedSnapshot): CaptureSeed;
47
63
  /** D08a: what a capture wrote and how its records compare with the prior capture. */
@@ -59,21 +75,42 @@ export interface CaptureWrite {
59
75
  readonly added: number;
60
76
  readonly removed: number;
61
77
  }
78
+ /** D08b: what a capture would write, decided before its first write: its result and the identities it counts. */
79
+ export interface CapturePlan extends CaptureWrite {
80
+ /** The identities `changed`, `added` and `removed` count, each list sorted. */
81
+ readonly identities: {
82
+ readonly changed: readonly string[];
83
+ readonly added: readonly string[];
84
+ readonly removed: readonly string[];
85
+ };
86
+ }
87
+ /**
88
+ * D08b: what `writeCapture(root, text)` would write and report, without writing: the same checks and reads, so it
89
+ * refuses and throws as the capture would before its first write, and the same counts and rotation, with the
90
+ * identities they count, each list sorted. It creates no directory and writes nothing, so the pair it reads stays as
91
+ * it was.
92
+ */
93
+ export declare function planCapture(root: string, text: string): CapturePlan;
94
+ export declare const syncDirectory: (path: string) => void;
95
+ /** A new same-directory temporary file holding `bytes`, flushed, owner-only; its workspace-relative path. */
96
+ export declare function staged(root: string, path: string, bytes: Buffer): string;
97
+ export declare const discard: (root: string, path: string | undefined) => void;
62
98
  /**
63
99
  * D08a: write `text`, an `ia-snapshot-1` document, as the current capture and keep the pair D08 retains. Its counts
64
100
  * follow `stalenessOf` against the prior capture at current.json: an equal digest is unchanged, another changed, a row
65
- * the prior lacks new, a prior row with none now removed. Its rotation is `rotate`'s: a capture at a new revision makes
66
- * the prior current.json previous.json, renamed, so byte for byte; one at an unchanged revision keeps previous.json while
67
- * it holds a capture at another revision; and with no readable prior capture a previous.json at another revision is
68
- * kept as the most recent capture there is. A previous.json at the new revision, or one that is no capture, is removed
69
- * once the current one is written.
101
+ * the prior lacks new, a prior row with none now removed. Its rotation is `rotate`'s, by authored revision: a capture at
102
+ * a new authored revision makes the prior current.json previous.json, renamed, so byte for byte; one at an unchanged
103
+ * authored revision (one that changes runtime-band sources alone among them) keeps previous.json while it holds a
104
+ * capture at another authored revision; and with no readable prior capture a previous.json at another authored revision
105
+ * is kept as the most recent capture there is. A previous.json at the new authored revision, or one that is no capture,
106
+ * is removed once the current one is written.
70
107
  *
71
108
  * Nothing is written before every check passes: a link or junction on the way, an entry at `.ia`, `.ia/work` or the
72
109
  * snapshot directory that is not a directory, or an entry at either path that is not a regular file, refuses as
73
110
  * IA-DB-PATH-UNSAFE. The new bytes are staged first; a rotation then moves previous.json aside,
74
111
  * renames current.json to previous.json and the staged file to current.json, and a failed step renames each file back,
75
112
  * so a capture that fails leaves the pair it found, and only the error escapes. A current.json that already holds `text`
76
- * is not rewritten.
113
+ * is not rewritten. Everything before the first write is `planCapture`'s.
77
114
  */
78
115
  export declare function writeCapture(root: string, text: string): CaptureWrite;
79
116
  //# sourceMappingURL=retention.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../src/retention.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,iHAAiH;AACjH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AACD,gHAAgH;AAChH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CACtC;AACD,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AACpE,oHAAoH;AACpH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAI3D,0HAA0H;AAC1H,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrG;AACD,qHAAqH;AACrH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAGtG;AACD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAE1G;AACD,2HAA2H;AAC3H,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAIvF;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,eAAe,mCAAsC,CAAC;AACnE,eAAO,MAAM,gBAAgB,oCAAuC,CAAC;AA0ErE,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,qHAAqH;IACrH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,WAAW,CA4B9E;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,kHAAkH;IAClH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iHAAiH;IACjH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA+BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CA8FrE"}
1
+ {"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../src/retention.ts"],"names":[],"mappings":"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"}
package/dist/retention.js CHANGED
@@ -5,6 +5,7 @@ import { isBand } from '@inventarch/language';
5
5
  import { stableSerialize } from '@inventarch/graph';
6
6
  import { DbError } from './errors.js';
7
7
  import { safePath } from './inputs.js';
8
+ import { authoredRows } from './membership.js';
8
9
  const HEX = /^[0-9a-f]{64}$/;
9
10
  const digests = new WeakMap();
10
11
  /** D08: the identity's digest in a retained snapshot, from an identity -> digest index built once per frozen row list. */
@@ -27,9 +28,16 @@ export function stalenessOf(now, before) {
27
28
  export function readinessOf(now, before, digest) {
28
29
  return digest === now ? 'current' : digest === before ? 'previous' : 'unknown';
29
30
  }
30
- /** D08 rotation: the prior current becomes previous only when the revision changed; otherwise the prior previous stays. */
31
+ /**
32
+ * D08 rotation: the prior current becomes previous only when the authored revision changed, so a change to runtime-band
33
+ * sources alone keeps the prior previous, as an unchanged revision does.
34
+ */
31
35
  export function rotate(prior, current) {
32
- const previous = prior === undefined ? undefined : prior.current.revision === current.revision ? prior.previous : prior.current;
36
+ const previous = prior === undefined
37
+ ? undefined
38
+ : prior.current.authoredRevision === current.authoredRevision
39
+ ? prior.previous
40
+ : prior.current;
33
41
  return Object.freeze({ current, ...(previous === undefined ? {} : { previous }) });
34
42
  }
35
43
  /**
@@ -42,7 +50,11 @@ export const CAPTURE_CURRENT = `${CAPTURE_DIRECTORY}/current.json`;
42
50
  export const CAPTURE_PREVIOUS = `${CAPTURE_DIRECTORY}/previous.json`;
43
51
  const plain = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
44
52
  const exactly = (value, keys) => JSON.stringify(Object.keys(value).sort()) === JSON.stringify(keys);
45
- /** The retained part of an `ia-snapshot-1` document, or why the bytes are none. */
53
+ /**
54
+ * The retained part of an `ia-snapshot-1` document, or why the bytes are none. A document without `authoredRevision`
55
+ * (one written before the authored revision) names its `revision` as its authored revision, which it was while no
56
+ * source sat at runtime placement.
57
+ */
46
58
  function capturedOf(bytes) {
47
59
  let value;
48
60
  try {
@@ -53,9 +65,11 @@ function capturedOf(bytes) {
53
65
  }
54
66
  if (!plain(value) || value['format'] !== CAPTURE_FORMAT)
55
67
  return `is not an ${CAPTURE_FORMAT} document`;
56
- const revision = value['revision'], rows = value['membership'];
68
+ const revision = value['revision'], authoredRevision = Object.hasOwn(value, 'authoredRevision') ? value['authoredRevision'] : revision, rows = value['membership'];
57
69
  if (typeof revision !== 'string' || !HEX.test(revision) || !Array.isArray(rows))
58
70
  return 'has no revision or membership rows';
71
+ if (typeof authoredRevision !== 'string' || !HEX.test(authoredRevision))
72
+ return 'has a malformed authored revision';
59
73
  const identities = new Set(), membership = [];
60
74
  for (const row of rows) {
61
75
  if (!plain(row) ||
@@ -71,13 +85,13 @@ function capturedOf(bytes) {
71
85
  identities.add(row['identity']);
72
86
  membership.push(Object.freeze({ identity: row['identity'], root: row['root'], band: row['band'], digest: row['digest'] }));
73
87
  }
74
- return Object.freeze({ bytes, revision, membership: Object.freeze(membership) });
88
+ return Object.freeze({ bytes, revision, authoredRevision, membership: Object.freeze(membership) });
75
89
  }
76
90
  /**
77
91
  * The entry at `path`, contained the D01 way: undefined when nothing is there, refused as IA-DB-PATH-UNSAFE when the
78
92
  * path runs through a link or junction or the entry is not a regular file, so nothing is read or written through one.
79
93
  */
80
- function entryAt(root, path) {
94
+ export function entryAt(root, path) {
81
95
  const target = safePath(root, path), stat = lstatSync(target, { throwIfNoEntry: false });
82
96
  if (stat === undefined)
83
97
  return undefined;
@@ -107,9 +121,12 @@ function readCaptured(root, path) {
107
121
  /**
108
122
  * D08a: the capture pair as a handle reads it, never written. A link or junction on the way, an entry that is not a
109
123
  * regular file, or a file that is no capture is ignored, never followed, so a read stays usable. With no readable
110
- * current.json a capture at previous.json still seeds, as the most recent capture there is. A current.json that names
111
- * the fresh revision with other membership rows is not this workspace's capture at that revision, so the pair seeds
112
- * nothing; a capture at another revision cannot be rebuilt from the fresh inputs, so it is trusted as written.
124
+ * current.json a capture at previous.json still seeds, as the most recent capture there is. A capture is trusted by its
125
+ * authored revision and the membership rows of its records not at runtime placement, by identity, band and digest
126
+ * (`authoredRows`): a current.json that names the fresh authored revision with other such rows is not this workspace's
127
+ * capture at that revision, so the pair seeds nothing, while one that differs from the fresh snapshot only in its
128
+ * runtime-band rows (and so in its revision) or in the roots a runtime-band @workspace declares is this workspace's; a
129
+ * capture at another authored revision cannot be rebuilt from the fresh inputs, so it is trusted as written.
113
130
  */
114
131
  export function readCapture(root, fresh) {
115
132
  const read = (path) => {
@@ -122,24 +139,83 @@ export function readCapture(root, fresh) {
122
139
  }
123
140
  };
124
141
  const current = read(CAPTURE_CURRENT), previous = read(CAPTURE_PREVIOUS);
125
- const snapshot = (captured) => Object.freeze({ revision: captured.revision, membership: captured.membership });
142
+ const snapshot = (captured) => Object.freeze({
143
+ revision: captured.revision,
144
+ authoredRevision: captured.authoredRevision,
145
+ membership: captured.membership,
146
+ });
126
147
  if (current === undefined)
127
148
  return previous === undefined ? {} : { prior: Object.freeze({ current: snapshot(previous) }) };
128
149
  const sameRows = (a, b) => {
129
150
  const order = (rows) => [...rows].sort((x, y) => (x.identity < y.identity ? -1 : x.identity > y.identity ? 1 : 0));
130
151
  return stableSerialize(order(a)) === stableSerialize(order(b));
131
152
  };
132
- if (current.revision === fresh.revision && !sameRows(current.membership, fresh.membership))
153
+ if (current.authoredRevision === fresh.authoredRevision &&
154
+ !sameRows(authoredRows(current.membership), authoredRows(fresh.membership)))
133
155
  return {};
134
156
  return {
135
- captured: current.revision,
157
+ captured: Object.freeze({ revision: current.revision, authoredRevision: current.authoredRevision }),
136
158
  prior: Object.freeze({
137
159
  current: snapshot(current),
138
- ...(previous === undefined || previous.revision === current.revision ? {} : { previous: snapshot(previous) }),
160
+ ...(previous === undefined || previous.authoredRevision === current.authoredRevision
161
+ ? {}
162
+ : { previous: snapshot(previous) }),
139
163
  }),
140
164
  };
141
165
  }
142
- const syncDirectory = (path) => {
166
+ const compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
167
+ /** Every check and read `writeCapture` makes before its first write; nothing is created or written. */
168
+ function planned(root, text) {
169
+ const bytes = Buffer.from(text, 'utf8'), built = capturedOf(bytes);
170
+ if (typeof built === 'string')
171
+ throw new TypeError(`The capture to write ${built}`);
172
+ directories(root);
173
+ const read = readCaptured(root, CAPTURE_CURRENT), kept = readCaptured(root, CAPTURE_PREVIOUS), prior = read !== null && typeof read === 'object' ? read : undefined, held = kept !== null && typeof kept === 'object' ? kept : undefined;
174
+ const changed = [], added = [];
175
+ let unchanged = 0;
176
+ for (const row of built.membership) {
177
+ const staleness = stalenessOf(row.digest, digestIn(prior, row.identity));
178
+ if (staleness === 'new')
179
+ added.push(row.identity);
180
+ else if (staleness === 'unchanged')
181
+ unchanged += 1;
182
+ else
183
+ changed.push(row.identity);
184
+ }
185
+ const now = new Set(built.membership.map((row) => row.identity));
186
+ const removed = prior === undefined ? [] : prior.membership.filter((row) => !now.has(row.identity)).map((row) => row.identity);
187
+ const moving = prior !== undefined && prior.authoredRevision !== built.authoredRevision ? prior : undefined, keeping = moving === undefined && held !== undefined && held.authoredRevision !== built.authoredRevision ? held : undefined;
188
+ const result = Object.freeze({
189
+ prior: prior?.revision ?? null,
190
+ ignored: typeof read === 'string' ? read : null,
191
+ previous: (moving ?? keeping)?.revision ?? null,
192
+ rotated: moving !== undefined,
193
+ changed: changed.length,
194
+ unchanged,
195
+ added: added.length,
196
+ removed: removed.length,
197
+ });
198
+ return { result, identities: { changed, added, removed }, bytes, kept, prior, moving, keeping };
199
+ }
200
+ /**
201
+ * D08b: what `writeCapture(root, text)` would write and report, without writing: the same checks and reads, so it
202
+ * refuses and throws as the capture would before its first write, and the same counts and rotation, with the
203
+ * identities they count, each list sorted. It creates no directory and writes nothing, so the pair it reads stays as
204
+ * it was.
205
+ */
206
+ export function planCapture(root, text) {
207
+ const { result, identities } = planned(root, text);
208
+ const sorted = (named) => Object.freeze(named.sort(compare));
209
+ return Object.freeze({
210
+ ...result,
211
+ identities: Object.freeze({
212
+ changed: sorted(identities.changed),
213
+ added: sorted(identities.added),
214
+ removed: sorted(identities.removed),
215
+ }),
216
+ });
217
+ }
218
+ export const syncDirectory = (path) => {
143
219
  // Windows exposes no fsync on a directory handle; a flushed file and a same-volume rename are what it offers.
144
220
  if (process.platform === 'win32')
145
221
  return;
@@ -152,7 +228,7 @@ const syncDirectory = (path) => {
152
228
  }
153
229
  };
154
230
  /** A new same-directory temporary file holding `bytes`, flushed, owner-only; its workspace-relative path. */
155
- function staged(root, path, bytes) {
231
+ export function staged(root, path, bytes) {
156
232
  const temporary = `${path}.${randomUUID()}.tmp`, fd = openSync(safePath(root, temporary), 'wx', 0o600);
157
233
  try {
158
234
  writeFileSync(fd, bytes);
@@ -163,7 +239,7 @@ function staged(root, path, bytes) {
163
239
  }
164
240
  return temporary;
165
241
  }
166
- const discard = (root, path) => {
242
+ export const discard = (root, path) => {
167
243
  if (path === undefined)
168
244
  return;
169
245
  try {
@@ -176,48 +252,22 @@ const discard = (root, path) => {
176
252
  /**
177
253
  * D08a: write `text`, an `ia-snapshot-1` document, as the current capture and keep the pair D08 retains. Its counts
178
254
  * follow `stalenessOf` against the prior capture at current.json: an equal digest is unchanged, another changed, a row
179
- * the prior lacks new, a prior row with none now removed. Its rotation is `rotate`'s: a capture at a new revision makes
180
- * the prior current.json previous.json, renamed, so byte for byte; one at an unchanged revision keeps previous.json while
181
- * it holds a capture at another revision; and with no readable prior capture a previous.json at another revision is
182
- * kept as the most recent capture there is. A previous.json at the new revision, or one that is no capture, is removed
183
- * once the current one is written.
255
+ * the prior lacks new, a prior row with none now removed. Its rotation is `rotate`'s, by authored revision: a capture at
256
+ * a new authored revision makes the prior current.json previous.json, renamed, so byte for byte; one at an unchanged
257
+ * authored revision (one that changes runtime-band sources alone among them) keeps previous.json while it holds a
258
+ * capture at another authored revision; and with no readable prior capture a previous.json at another authored revision
259
+ * is kept as the most recent capture there is. A previous.json at the new authored revision, or one that is no capture,
260
+ * is removed once the current one is written.
184
261
  *
185
262
  * Nothing is written before every check passes: a link or junction on the way, an entry at `.ia`, `.ia/work` or the
186
263
  * snapshot directory that is not a directory, or an entry at either path that is not a regular file, refuses as
187
264
  * IA-DB-PATH-UNSAFE. The new bytes are staged first; a rotation then moves previous.json aside,
188
265
  * renames current.json to previous.json and the staged file to current.json, and a failed step renames each file back,
189
266
  * so a capture that fails leaves the pair it found, and only the error escapes. A current.json that already holds `text`
190
- * is not rewritten.
267
+ * is not rewritten. Everything before the first write is `planCapture`'s.
191
268
  */
192
269
  export function writeCapture(root, text) {
193
- const bytes = Buffer.from(text, 'utf8'), built = capturedOf(bytes);
194
- if (typeof built === 'string')
195
- throw new TypeError(`The capture to write ${built}`);
196
- directories(root);
197
- const read = readCaptured(root, CAPTURE_CURRENT), kept = readCaptured(root, CAPTURE_PREVIOUS), prior = read !== null && typeof read === 'object' ? read : undefined, held = kept !== null && typeof kept === 'object' ? kept : undefined;
198
- let changed = 0, unchanged = 0, added = 0;
199
- for (const row of built.membership) {
200
- const staleness = stalenessOf(row.digest, digestIn(prior, row.identity));
201
- if (staleness === 'new')
202
- added += 1;
203
- else if (staleness === 'unchanged')
204
- unchanged += 1;
205
- else
206
- changed += 1;
207
- }
208
- const now = new Set(built.membership.map((row) => row.identity));
209
- const removed = prior === undefined ? 0 : prior.membership.filter((row) => !now.has(row.identity)).length;
210
- const moving = prior !== undefined && prior.revision !== built.revision ? prior : undefined, keeping = moving === undefined && held !== undefined && held.revision !== built.revision ? held : undefined;
211
- const result = Object.freeze({
212
- prior: prior?.revision ?? null,
213
- ignored: typeof read === 'string' ? read : null,
214
- previous: (moving ?? keeping)?.revision ?? null,
215
- rotated: moving !== undefined,
216
- changed,
217
- unchanged,
218
- added,
219
- removed,
220
- });
270
+ const { result, bytes, kept, prior, moving, keeping } = planned(root, text);
221
271
  mkdirSync(safePath(root, CAPTURE_DIRECTORY), { recursive: true });
222
272
  const current = safePath(root, CAPTURE_CURRENT), previous = safePath(root, CAPTURE_PREVIOUS);
223
273
  if (moving !== undefined) {
@@ -255,8 +305,8 @@ export function writeCapture(root, text) {
255
305
  }
256
306
  else {
257
307
  // No rotation: current.json is replaced when its bytes differ, and a previous.json that is no capture, or one at the
258
- // revision being written, is dropped. It is moved aside before current.json is published and removed only after,
259
- // so a failure at either step restores it and leaves the pair this capture found.
308
+ // authored revision being written, is dropped. It is moved aside before current.json is published and removed only
309
+ // after, so a failure at either step restores it and leaves the pair this capture found.
260
310
  let temporary = prior === undefined || !prior.bytes.equals(bytes) ? staged(root, CAPTURE_CURRENT, bytes) : undefined, aside;
261
311
  try {
262
312
  if (keeping === undefined && kept !== null) {
@@ -1 +1 @@
1
- {"version":3,"file":"retention.js","sourceRoot":"","sources":["../src/retention.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"retention.js","sourceRoot":"","sources":["../src/retention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAoB/C,MAAM,GAAG,GAAG,gBAAgB,CAAC;AAC7B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyD,CAAC;AACrF,0HAA0H;AAC1H,MAAM,UAAU,QAAQ,CAAC,QAAsC,EAAE,QAAgB;IAC/E,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC;IACjC,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AACD,qHAAqH;AACrH,MAAM,UAAU,WAAW,CAAC,GAAuB,EAAE,MAA0B;IAC7E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AACD,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,GAAuB,EAAE,MAA0B,EAAE,MAAc;IAC7F,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AACD;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAA2B,EAAE,OAAyB;IAC3E,MAAM,QAAQ,GACZ,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,KAAK,OAAO,CAAC,gBAAgB;YAC3D,CAAC,CAAC,KAAK,CAAC,QAAQ;YAChB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,iBAAiB,eAAe,CAAC;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,iBAAiB,gBAAgB,CAAC;AAMrE,MAAM,KAAK,GAAG,CAAC,KAAc,EAAoC,EAAE,CACjE,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,MAAM,OAAO,GAAG,CAAC,KAA8B,EAAE,IAAuB,EAAW,EAAE,CACnF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACrE;;;;GAIG;AACH,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,cAAc;QAAE,OAAO,aAAa,cAAc,WAAW,CAAC;IACvG,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,EAChC,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,EAClG,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7B,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7E,OAAO,oCAAoC,CAAC;IAC9C,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAAE,OAAO,mCAAmC,CAAC;IACpH,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,EAClC,UAAU,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,IAAiB,EAAE,CAAC;QACpC,IACE,CAAC,KAAK,CAAC,GAAG,CAAC;YACX,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YACrD,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;YACnC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC/B,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;YAC/B,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;YAC/B,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACjC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExB,OAAO,gCAAgC,CAAC;QAC1C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAChC,UAAU,CAAC,IAAI,CACb,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AACrG,CAAC;AACD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EACjC,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,OAAO,CAAC,mBAAmB,EAAE,GAAG,IAAI,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAClG,OAAO,MAAM,CAAC;AAChB,CAAC;AACD;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,MAAM,IAAI,OAAO,CAAC,mBAAmB,EAAE,GAAG,IAAI,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AACD,2FAA2F;AAC3F,SAAS,YAAY,CAAC,IAAY,EAAE,IAAY;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AACxE,CAAC;AAYD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAuB;IAC/D,MAAM,IAAI,GAAG,CAAC,IAAY,EAAwB,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,OAAO,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,EACnC,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,CAAC,QAAkB,EAAoB,EAAE,CACxD,MAAM,CAAC,MAAM,CAAC;QACZ,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC;IACL,IAAI,OAAO,KAAK,SAAS;QACvB,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACjG,MAAM,QAAQ,GAAG,CAAC,CAAyC,EAAE,CAAyC,EAAW,EAAE;QACjH,MAAM,KAAK,GAAG,CAAC,IAA4C,EAAE,EAAE,CAC7D,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC;IACF,IACE,OAAO,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB;QACnD,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE3E,OAAO,EAAE,CAAC;IACZ,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACnG,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;YAC1B,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,gBAAgB,KAAK,OAAO,CAAC,gBAAgB;gBAClF,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;SACtC,CAAC;KACH,CAAC;AACJ,CAAC;AAwCD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,uGAAuG;AACvG,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EACrC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;IACpF,WAAW,CAAC,IAAI,CAAC,CAAC;IAClB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,eAAe,CAAC,EAC9C,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAC3C,KAAK,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EACpE,IAAI,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,OAAO,GAAa,EAAE,EAC1B,KAAK,GAAa,EAAE,CAAC;IACvB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,IAAI,SAAS,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;aAC7C,IAAI,SAAS,KAAK,WAAW;YAAE,SAAS,IAAI,CAAC,CAAC;;YAC9C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAM,OAAO,GACX,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjH,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EACzG,OAAO,GACL,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtH,MAAM,MAAM,GAAiB,MAAM,CAAC,MAAM,CAAC;QACzC,KAAK,EAAE,KAAK,EAAE,QAAQ,IAAI,IAAI;QAC9B,OAAO,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC/C,QAAQ,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,QAAQ,IAAI,IAAI;QAC/C,OAAO,EAAE,MAAM,KAAK,SAAS;QAC7B,OAAO,EAAE,OAAO,CAAC,MAAM;QACvB,SAAS;QACT,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,OAAO,EAAE,OAAO,CAAC,MAAM;KACxB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAClG,CAAC;AACD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,CAAC,KAAe,EAAqB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,MAAM;QACT,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;YACxB,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;YACnC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YAC/B,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;SACpC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AACD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAQ,EAAE;IAClD,8GAA8G;IAC9G,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO;IACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC,CAAC;AACF,6GAA6G;AAC7G,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa;IAC9D,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,EAC7C,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzB,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AACD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAwB,EAAQ,EAAE;IACtE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC;AACF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5E,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,EAC7C,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,SAAS,GAAuB,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,EACtE,KAAyB,EACzB,KAAK,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC;YACH,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,GAAG,gBAAgB,IAAI,UAAU,EAAE,MAAM,CAAC;gBACzD,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC7C,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC;YACD,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9B,KAAK,GAAG,IAAI,CAAC;YACb,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/C,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wFAAwF;YACxF,IAAI,CAAC;gBACH,IAAI,KAAK;oBAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACzC,IAAI,KAAK,KAAK,SAAS;oBAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACrE,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,uGAAuG;gBACvG,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACzB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,qHAAqH;QACrH,mHAAmH;QACnH,yFAAyF;QACzF,IAAI,SAAS,GACT,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EACtG,KAAyB,CAAC;QAC5B,IAAI,CAAC;YACH,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,GAAG,gBAAgB,IAAI,UAAU,EAAE,MAAM,CAAC;gBACzD,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC7C,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC;YACD,IAAI,SAAS,KAAK,SAAS;gBAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5E,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,IAAI,KAAK,KAAK,SAAS;oBAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,uGAAuG;YACzG,CAAC;YACD,KAAK,GAAG,SAAS,CAAC;YAClB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACzB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,22 @@
1
+ import type { Graph, RevisionSource } from '@inventarch/graph';
2
+ import type { InputSnapshot } from './inputs.js';
3
+ /** Local journal claims, not execution authorization or an attestation by an external observer. */
4
+ export declare const RUNNER_EVIDENCE_FORMAT = "ia.runner-evidence.v1";
5
+ export interface RunnerEvidenceWrite {
6
+ readonly path: string;
7
+ readonly written: boolean;
8
+ readonly sequence: number;
9
+ readonly hash: string;
10
+ }
11
+ /**
12
+ * The trusted runner calls this after reading its verified journal. It accepts no native source text. A receipt is
13
+ * an atomic local copy of that journal, not independent proof it executed. It never prunes other sessions/revisions.
14
+ * One runner owns a session; an older or divergent receipt cannot replace a newer receipt through this API.
15
+ */
16
+ export declare function writeRunnerEvidence(root: string, input: {
17
+ readonly authoredRevision: string;
18
+ readonly events: readonly unknown[];
19
+ }): RunnerEvidenceWrite;
20
+ /** Optional evidence fails closed without making authored data unavailable. No filesystem or journal code executes. */
21
+ export declare function runnerEvidenceSources(input: InputSnapshot, authoredRevision: string, graph: Graph): readonly RevisionSource[];
22
+ //# sourceMappingURL=runner-evidence.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runner-evidence.d.ts","sourceRoot":"","sources":["../src/runner-evidence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAiN9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IACL,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC,GACA,mBAAmB,CAwCrB;AAsHD,uHAAuH;AACvH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,KAAK,GACX,SAAS,cAAc,EAAE,CAwC3B"}