@quolu/lattice 0.52.2 → 0.52.4

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 (134) hide show
  1. package/package.json +1 -1
  2. package/src/artifact-contracts-v2.mjs +325 -325
  3. package/src/artifact-contracts.mjs +895 -895
  4. package/src/boundary-compiler.mjs +712 -712
  5. package/src/boundary-observation-compiler-v2.mjs +344 -344
  6. package/src/bounded-seam.mjs +230 -230
  7. package/src/bridge-address.mjs +107 -107
  8. package/src/bridge-cli.mjs +297 -297
  9. package/src/bridge-config.mjs +346 -346
  10. package/src/bridge-daemon.mjs +378 -378
  11. package/src/bridge-hub-protocol.mjs +198 -0
  12. package/src/bridge-launch-agent.mjs +323 -323
  13. package/src/bridge-registrar.mjs +102 -102
  14. package/src/bridge-server.mjs +376 -376
  15. package/src/cli-help.mjs +308 -308
  16. package/src/cli-stdio.mjs +40 -40
  17. package/src/control-compiler.mjs +532 -532
  18. package/src/dag-chain.mjs +261 -261
  19. package/src/factory-diagnostics.mjs +188 -188
  20. package/src/git-process.mjs +72 -0
  21. package/src/hash-chain.mjs +76 -76
  22. package/src/hooks-cli.mjs +1057 -1057
  23. package/src/isolation-runner.mjs +409 -409
  24. package/src/node-version-guard.mjs +44 -44
  25. package/src/project-cli.mjs +699 -697
  26. package/src/project-identity.mjs +130 -130
  27. package/src/rc1-black-box-oracle.mjs +906 -906
  28. package/src/rc1-comparison.mjs +154 -154
  29. package/src/rc1-evidence-bundle.mjs +456 -456
  30. package/src/rc1-v4-campaign.mjs +708 -708
  31. package/src/rc1-v4-transform.mjs +467 -467
  32. package/src/rc1-v5-artifact-set.mjs +855 -855
  33. package/src/rc1-v5-behavior-evidence.mjs +594 -594
  34. package/src/rc1-v5-campaign.mjs +797 -797
  35. package/src/rc1-v5-transform.mjs +421 -421
  36. package/src/rc1-v6-artifact-set.mjs +807 -807
  37. package/src/rc1-v6-behavior-evidence.mjs +273 -273
  38. package/src/rc1-v6-campaign.mjs +623 -623
  39. package/src/rc1-v6-causal-binding.mjs +473 -473
  40. package/src/rc1-v6-measurement.mjs +313 -313
  41. package/src/rc2-artifact-set.mjs +1584 -1584
  42. package/src/rc2-campaign.mjs +1506 -1506
  43. package/src/rc2-delivery-policy-front-end.mjs +1079 -1079
  44. package/src/rc2-delivery-policy-oracle.mjs +134 -134
  45. package/src/rc2-delivery-policy-transform.mjs +1127 -1127
  46. package/src/rc2-rc1-transfer-front-end.mjs +511 -511
  47. package/src/rc3-actual-dogfood.mjs +652 -652
  48. package/src/rc3-dogfood-scaffold.mjs +315 -315
  49. package/src/rc3-scripted-campaign.mjs +1383 -1383
  50. package/src/rc4-stage1-dogfood.mjs +673 -673
  51. package/src/runtime-adapter-registry.mjs +524 -524
  52. package/src/runtime-cli.mjs +4588 -4588
  53. package/src/runtime-contracts.mjs +824 -824
  54. package/src/runtime-control-store.mjs +604 -604
  55. package/src/runtime-controller-protocol.mjs +587 -587
  56. package/src/runtime-decision-verifier.mjs +701 -701
  57. package/src/runtime-diff-observer.mjs +361 -361
  58. package/src/runtime-direct-os-observer.mjs +301 -301
  59. package/src/runtime-driver-state.mjs +166 -166
  60. package/src/runtime-engine.mjs +779 -779
  61. package/src/runtime-errors.mjs +356 -356
  62. package/src/runtime-event-store.mjs +189 -189
  63. package/src/runtime-front-end.mjs +925 -925
  64. package/src/runtime-gate-store.mjs +481 -481
  65. package/src/runtime-hold-recompile.mjs +916 -916
  66. package/src/runtime-io-sentinel.mjs +391 -391
  67. package/src/runtime-lifecycle-lock.mjs +294 -294
  68. package/src/runtime-managed-supervisor.mjs +1490 -1490
  69. package/src/runtime-multi-epoch-store.mjs +838 -838
  70. package/src/runtime-projection.mjs +269 -269
  71. package/src/runtime-pull-intake.mjs +1192 -1192
  72. package/src/runtime-scripted-adapter-controller.mjs +1160 -1160
  73. package/src/runtime-scripted-executor.mjs +163 -163
  74. package/src/runtime-scripted-worktree.mjs +104 -104
  75. package/src/runtime-seam-resolve.mjs +428 -428
  76. package/src/runtime-seam-treatment.mjs +173 -173
  77. package/src/runtime-socket-owner.mjs +125 -125
  78. package/src/runtime-work-order-contracts.mjs +91 -91
  79. package/src/runtime-work-order-controller.mjs +1171 -1171
  80. package/src/runtime-worktree-executor.mjs +199 -199
  81. package/src/schedulability-compiler-v2.mjs +303 -303
  82. package/src/schedulability-verifier-v2.mjs +317 -317
  83. package/src/seam-apply.mjs +549 -549
  84. package/src/seam-commit-shared.mjs +22 -22
  85. package/src/seam-commit-transform.mjs +81 -81
  86. package/src/seam-commit.mjs +18 -18
  87. package/src/seam-cost.mjs +322 -322
  88. package/src/seam-derivation.mjs +188 -188
  89. package/src/seam-gate.mjs +146 -146
  90. package/src/seam-proposal-contracts.mjs +446 -446
  91. package/src/seam-proposal-queries.mjs +521 -521
  92. package/src/seam-proposal.mjs +2011 -2011
  93. package/src/seam-ref.mjs +33 -33
  94. package/src/seam-rewrite.mjs +286 -286
  95. package/src/seam-transform.mjs +554 -554
  96. package/src/seam-verification.mjs +260 -260
  97. package/src/sensor-adapter.mjs +432 -432
  98. package/src/sensor-cli.mjs +139 -139
  99. package/src/sensor-diff.mjs +661 -661
  100. package/src/sensor-node-runtime.mjs +53 -53
  101. package/src/sensor-runtime.mjs +52 -52
  102. package/src/timestamp-contract.mjs +8 -8
  103. package/src/todo-audit-pending.mjs +91 -91
  104. package/src/todo-chain.mjs +178 -178
  105. package/src/todo-cli.mjs +3143 -3141
  106. package/src/todo-contracts.mjs +728 -728
  107. package/src/todo-dashboard-registry.mjs +573 -573
  108. package/src/todo-dispatch-shape.mjs +190 -190
  109. package/src/todo-gantt-html-independence.mjs +239 -239
  110. package/src/todo-gantt-html-shared.mjs +226 -226
  111. package/src/todo-gantt-html-style.mjs +131 -131
  112. package/src/todo-gantt-html.mjs +248 -248
  113. package/src/todo-gantt-layout.mjs +974 -974
  114. package/src/todo-gantt-live.mjs +361 -361
  115. package/src/todo-gantt-nested.mjs +263 -263
  116. package/src/todo-gantt-presentation.mjs +217 -217
  117. package/src/todo-gantt-scope.mjs +123 -123
  118. package/src/todo-gantt-svg.mjs +353 -353
  119. package/src/todo-independence-contracts.mjs +595 -595
  120. package/src/todo-independence-guidance.mjs +322 -322
  121. package/src/todo-independence.mjs +640 -640
  122. package/src/todo-markdown-renderer.mjs +260 -260
  123. package/src/todo-migration.mjs +448 -448
  124. package/src/todo-narrative-anchor.mjs +130 -130
  125. package/src/todo-note-store.mjs +629 -629
  126. package/src/todo-parallel-candidates.mjs +114 -114
  127. package/src/todo-revision.mjs +995 -995
  128. package/src/todo-split.mjs +472 -472
  129. package/src/todo-status.mjs +690 -690
  130. package/src/todo-store-git-transaction.mjs +418 -418
  131. package/src/todo-store.mjs +4360 -4322
  132. package/src/treatment-compiler.mjs +728 -728
  133. package/src/treatment-runner.mjs +656 -656
  134. package/src/witness-scaffold.mjs +180 -180
@@ -1,656 +1,656 @@
1
- import { spawn } from 'node:child_process';
2
- import { createHash } from 'node:crypto';
3
- import {
4
- access,
5
- mkdtemp,
6
- readFile,
7
- rm,
8
- } from 'node:fs/promises';
9
- import os from 'node:os';
10
- import path from 'node:path';
11
- import { performance } from 'node:perf_hooks';
12
-
13
- import {
14
- canonicalizeArtifact,
15
- digestArtifact,
16
- validateTransformArtifact,
17
- } from './artifact-contracts.mjs';
18
- import {
19
- collectSensorEvidence,
20
- portableSensorOutcome,
21
- } from './sensor-adapter.mjs';
22
- import { spawnSensorCli } from './sensor-runtime.mjs';
23
- import { compileTreatmentArtifacts } from './treatment-compiler.mjs';
24
-
25
- const SHA1 = /^[0-9a-f]{40}$/;
26
- const SHA256 = /^[0-9a-f]{64}$/;
27
- const PORTABLE_PROJECTION = 'lattice.sensor_portable_outcome.v1';
28
- const VERIFIER = Object.freeze({
29
- id: 'dispatch-characterization',
30
- command: 'node',
31
- args: ['--test', '--test-reporter=dot', 'test/research-dispatch-record.test.mjs'],
32
- });
33
-
34
- function fail(reason) {
35
- throw new TypeError(`treatment recompile契約違反: ${reason}`);
36
- }
37
-
38
- function exactRecord(value, keys) {
39
- if (value === null || typeof value !== 'object' || Array.isArray(value)
40
- || Object.getPrototypeOf(value) !== Object.prototype) {
41
- return false;
42
- }
43
- const actual = Object.keys(value).sort();
44
- const expected = [...keys].sort();
45
- return actual.length === expected.length
46
- && actual.every((key, index) => key === expected[index]);
47
- }
48
-
49
- function sha256(value) {
50
- return createHash('sha256').update(value).digest('hex');
51
- }
52
-
53
- function run(command, args, { cwd, env, input, allowExitCodes = [0] } = {}) {
54
- return new Promise((resolve, reject) => {
55
- const child = spawn(command, args, {
56
- cwd,
57
- env,
58
- shell: false,
59
- stdio: ['pipe', 'pipe', 'pipe'],
60
- });
61
- const stdout = [];
62
- const stderr = [];
63
- child.stdout.on('data', (chunk) => stdout.push(chunk));
64
- child.stderr.on('data', (chunk) => stderr.push(chunk));
65
- child.once('error', reject);
66
- child.once('close', (code, signal) => {
67
- const result = {
68
- code,
69
- signal,
70
- stdout: Buffer.concat(stdout),
71
- stderr: Buffer.concat(stderr),
72
- };
73
- if (allowExitCodes.includes(code) && signal === null) resolve(result);
74
- else reject(Object.assign(
75
- new Error(`${command} failed (${signal ?? code}): ${result.stderr.toString('utf8').trim()}`),
76
- result,
77
- ));
78
- });
79
- child.stdin.end(input);
80
- });
81
- }
82
-
83
- function sensorEnvironment() {
84
- const env = {
85
- ...process.env,
86
- LATTICE_SENSOR_NO_DAEMON: '1',
87
- LATTICE_SENSOR_NO_WATCH: '1',
88
- LATTICE_SENSOR_NO_UPDATE_CHECK: '1',
89
- DO_NOT_TRACK: '1',
90
- NO_COLOR: '1',
91
- };
92
- delete env.FORCE_COLOR;
93
- return env;
94
- }
95
-
96
- function executeLatticeSensor({ args, cwd }) {
97
- return new Promise((resolve) => {
98
- const child = spawnSensorCli(args, {
99
- cwd,
100
- env: sensorEnvironment(),
101
- stdio: ['ignore', 'pipe', 'pipe'],
102
- });
103
- let stdout = '';
104
- let stderr = '';
105
- child.stdout.on('data', (chunk) => { stdout += chunk; });
106
- child.stderr.on('data', (chunk) => { stderr += chunk; });
107
- child.once('error', (error) => {
108
- resolve({ code: null, stdout, stderr, error: error.message });
109
- });
110
- child.once('close', (code) => resolve({ code, stdout, stderr }));
111
- });
112
- }
113
-
114
- function artifactMeta(value) {
115
- return exactRecord(value, ['digest', 'canonical_bytes'])
116
- && typeof value.digest === 'string'
117
- && SHA256.test(value.digest)
118
- && Number.isSafeInteger(value.canonical_bytes)
119
- && value.canonical_bytes > 0;
120
- }
121
-
122
- function artifactSet(value) {
123
- return exactRecord(value, ['boundary_manifest', 'boundary_verdict', 'plan_graph'])
124
- && Object.values(value).every(artifactMeta);
125
- }
126
-
127
- function assertPortableControlEvidence(evidence) {
128
- if (!exactRecord(evidence, [
129
- 'schema',
130
- 'observed_at',
131
- 'head',
132
- 'executor_head',
133
- 'graph_digest_projection',
134
- 'input_digests',
135
- 'sensor',
136
- 'artifacts',
137
- 'observed_facts',
138
- 'presentation_note',
139
- ])
140
- || evidence.schema !== 'lattice.rc1.control_compilation_evidence.v2'
141
- || evidence.graph_digest_projection !== PORTABLE_PROJECTION) {
142
- fail('portable control evidence v2だけがrecompileへ進める');
143
- }
144
- if (typeof evidence.head !== 'string'
145
- || !SHA1.test(evidence.head)
146
- || typeof evidence.executor_head !== 'string'
147
- || !SHA1.test(evidence.executor_head)
148
- || !exactRecord(evidence.input_digests, [
149
- 'plan_input',
150
- 'query_set',
151
- 'manual_normal',
152
- 'manual_shared_state_negative',
153
- 'code_snapshot',
154
- ])
155
- || Object.values(evidence.input_digests).some((digest) => (
156
- typeof digest !== 'string' || !SHA256.test(digest)
157
- ))
158
- || !exactRecord(evidence.artifacts, ['control', 'shared_state_negative'])
159
- || !artifactSet(evidence.artifacts.control)
160
- || !artifactSet(evidence.artifacts.shared_state_negative)
161
- || !exactRecord(evidence.sensor, [
162
- 'version',
163
- 'file_count',
164
- 'node_count',
165
- 'edge_count',
166
- 'pending_changes',
167
- 'pending_refs',
168
- 'worktree_mismatch',
169
- 'fresh_index_repetitions',
170
- 'raw_outcomes_digests',
171
- 'raw_outcomes_equal',
172
- 'portable_outcomes_digest',
173
- 'portable_outcomes_equal',
174
- 'outcomes',
175
- ])
176
- || evidence.sensor.fresh_index_repetitions !== 2
177
- || !Array.isArray(evidence.sensor.raw_outcomes_digests)
178
- || evidence.sensor.raw_outcomes_digests.length !== 2
179
- || evidence.sensor.raw_outcomes_digests.some((digest) => (
180
- typeof digest !== 'string' || !SHA256.test(digest)
181
- ))
182
- || new Set(evidence.sensor.raw_outcomes_digests).size !== 2
183
- || evidence.sensor.raw_outcomes_equal !== false
184
- || typeof evidence.sensor.portable_outcomes_digest !== 'string'
185
- || !SHA256.test(evidence.sensor.portable_outcomes_digest)
186
- || evidence.sensor.portable_outcomes_equal !== true
187
- || !Array.isArray(evidence.sensor.outcomes)
188
- || evidence.sensor.outcomes.length === 0) {
189
- fail('portable control evidence v2のdigest metadataが不正');
190
- }
191
- }
192
-
193
- function assertTransformExecutionEvidence(evidence, {
194
- transformArtifact,
195
- transformPatch,
196
- controlCompilationEvidence,
197
- querySetDigest,
198
- normal,
199
- }) {
200
- if (!exactRecord(evidence, [
201
- 'schema',
202
- 'observed_at',
203
- 'executor_head',
204
- 'experiment_base_sha',
205
- 'control_compilation_evidence_schema',
206
- 'graph_digest_projection',
207
- 'input_digests',
208
- 'runs',
209
- 'artifacts',
210
- 'observed_facts',
211
- 'presentation_note',
212
- ])
213
- || evidence.schema !== 'lattice.rc1.seam_transform_execution_evidence.v2'
214
- || typeof evidence.executor_head !== 'string'
215
- || !SHA1.test(evidence.executor_head)
216
- || evidence.experiment_base_sha !== transformArtifact.source.base_sha
217
- || evidence.control_compilation_evidence_schema !== controlCompilationEvidence.schema
218
- || evidence.graph_digest_projection !== PORTABLE_PROJECTION
219
- || !exactRecord(evidence.input_digests, [
220
- 'boundary_manifest',
221
- 'boundary_verdict',
222
- 'control_plan',
223
- 'query_set',
224
- 'control_compilation_evidence',
225
- ])
226
- || !exactRecord(evidence.runs, [
227
- 'accepted_primary',
228
- 'accepted_repeat',
229
- 'scope_rejection',
230
- 'behavior_rejection',
231
- ])
232
- || !exactRecord(evidence.artifacts, [
233
- 'transform',
234
- 'scope_rejection',
235
- 'behavior_rejection',
236
- 'patch',
237
- ])
238
- || !artifactMeta(evidence.artifacts.transform)
239
- || !artifactMeta(evidence.artifacts.scope_rejection)
240
- || !artifactMeta(evidence.artifacts.behavior_rejection)
241
- || !exactRecord(evidence.artifacts.patch, ['digest', 'bytes'])) {
242
- fail('transform execution evidence v2が不正');
243
- }
244
- const transformArtifactDigest = digestArtifact(transformArtifact);
245
- const transformCanonicalBytes = Buffer.byteLength(canonicalizeArtifact(transformArtifact));
246
- if (evidence.input_digests.boundary_manifest !== normal.boundary_manifest
247
- || evidence.input_digests.boundary_verdict !== normal.boundary_verdict
248
- || evidence.input_digests.control_plan !== normal.plan_graph
249
- || evidence.input_digests.query_set !== querySetDigest
250
- || evidence.input_digests.control_compilation_evidence
251
- !== digestArtifact(controlCompilationEvidence)
252
- || evidence.runs.accepted_primary?.artifact_digest !== transformArtifactDigest
253
- || evidence.runs.accepted_repeat?.artifact_digest !== transformArtifactDigest
254
- || evidence.artifacts.transform.digest !== transformArtifactDigest
255
- || evidence.artifacts.transform.canonical_bytes !== transformCanonicalBytes
256
- || evidence.artifacts.patch.digest !== sha256(transformPatch)
257
- || evidence.artifacts.patch.bytes !== transformPatch.byteLength
258
- || evidence.observed_facts?.deterministic_repeat !== true
259
- || evidence.observed_facts?.same_control_base !== true
260
- || evidence.observed_facts?.portable_control_chain !== true
261
- || evidence.observed_facts?.characterization_passed !== true
262
- || evidence.observed_facts?.git_apply_check !== 'passed'
263
- || evidence.observed_facts?.source_unchanged !== true
264
- || evidence.observed_facts?.cleanup !== 'passed') {
265
- fail('transform execution evidenceのpredecessor chainが一致しない');
266
- }
267
- return digestArtifact(evidence);
268
- }
269
-
270
- function bundleDigests(bundle) {
271
- if (!exactRecord(bundle, ['boundary_manifest', 'boundary_verdict', 'plan_graph'])) {
272
- fail('control artifact setが不正');
273
- }
274
- return {
275
- boundary_manifest: digestArtifact(bundle.boundary_manifest),
276
- boundary_verdict: digestArtifact(bundle.boundary_verdict),
277
- plan_graph: digestArtifact(bundle.plan_graph),
278
- };
279
- }
280
-
281
- function assertAdmission({
282
- planInput,
283
- manualNormal,
284
- manualNegative,
285
- querySet,
286
- transformArtifact,
287
- transformExecutionEvidence,
288
- transformPatch,
289
- controlCompilationEvidence,
290
- control,
291
- }) {
292
- for (const value of [
293
- planInput,
294
- manualNormal,
295
- manualNegative,
296
- querySet,
297
- transformArtifact,
298
- transformExecutionEvidence,
299
- controlCompilationEvidence,
300
- control,
301
- ]) {
302
- canonicalizeArtifact(value);
303
- }
304
- if (!validateTransformArtifact(transformArtifact) || transformArtifact.status !== 'accepted') {
305
- fail('accepted transform artifactが必要');
306
- }
307
- if (!Buffer.isBuffer(transformPatch)
308
- || sha256(transformPatch) !== transformArtifact.patch.digest
309
- || transformPatch.byteLength !== transformArtifact.patch.bytes) {
310
- fail('transform patch digestまたはpatch bytesがartifactと一致しない');
311
- }
312
- assertPortableControlEvidence(controlCompilationEvidence);
313
- if (!exactRecord(control, ['normal', 'negative'])) fail('control artifact setが不正');
314
- const normal = bundleDigests(control.normal);
315
- const negative = bundleDigests(control.negative);
316
- const evidence = controlCompilationEvidence;
317
- if (evidence.head !== transformArtifact.source.base_sha
318
- || evidence.input_digests.plan_input !== digestArtifact(planInput)
319
- || evidence.input_digests.query_set !== digestArtifact(querySet)
320
- || evidence.input_digests.manual_normal !== digestArtifact(manualNormal)
321
- || evidence.input_digests.manual_shared_state_negative !== digestArtifact(manualNegative)
322
- || evidence.input_digests.code_snapshot !== transformArtifact.source.code_snapshot_digest
323
- || evidence.artifacts.control.boundary_manifest.digest !== normal.boundary_manifest
324
- || evidence.artifacts.control.boundary_verdict.digest !== normal.boundary_verdict
325
- || evidence.artifacts.control.plan_graph.digest !== normal.plan_graph
326
- || evidence.artifacts.shared_state_negative.boundary_manifest.digest
327
- !== negative.boundary_manifest
328
- || evidence.artifacts.shared_state_negative.boundary_verdict.digest
329
- !== negative.boundary_verdict
330
- || evidence.artifacts.shared_state_negative.plan_graph.digest !== negative.plan_graph
331
- || transformArtifact.source.boundary_manifest_digest !== normal.boundary_manifest
332
- || transformArtifact.source.boundary_verdict_digest !== normal.boundary_verdict
333
- || transformArtifact.source.control_plan_digest !== normal.plan_graph
334
- || transformArtifact.source.query_set_digest !== digestArtifact(querySet)) {
335
- fail('query setまたはcontrol artifact digest chainがportable predecessorと一致しない');
336
- }
337
- if (evidence.sensor.outcomes.length !== querySet.queries.length
338
- || evidence.sensor.outcomes.some((outcome, index) => (
339
- outcome.id !== querySet.queries[index]?.id
340
- || outcome.operation !== querySet.queries[index]?.operation
341
- || typeof outcome.result_digest !== 'string'
342
- || !SHA256.test(outcome.result_digest)
343
- ))
344
- || JSON.stringify(evidence.sensor.outcomes.map((outcome) => ({
345
- id: outcome.id,
346
- operation: outcome.operation,
347
- status: outcome.outcome,
348
- result_digest: outcome.result_digest,
349
- }))) !== JSON.stringify(control.normal.boundary_manifest.graph_evidence)) {
350
- fail('portable control evidenceがquery set/control graph evidenceと一致しない');
351
- }
352
- const transformExecutionEvidenceDigest = assertTransformExecutionEvidence(
353
- transformExecutionEvidence,
354
- {
355
- transformArtifact,
356
- transformPatch,
357
- controlCompilationEvidence,
358
- querySetDigest: digestArtifact(querySet),
359
- normal,
360
- },
361
- );
362
- const receipt = transformArtifact.verification.receipts[0];
363
- if (transformArtifact.verification.receipts.length !== 1
364
- || receipt.id !== VERIFIER.id
365
- || receipt.command !== VERIFIER.command
366
- || JSON.stringify(receipt.args) !== JSON.stringify(VERIFIER.args)) {
367
- fail('accepted transform verifierがRC1 fixed verifierと一致しない');
368
- }
369
- return {
370
- baseSha: transformArtifact.source.base_sha,
371
- transformArtifactDigest: digestArtifact(transformArtifact),
372
- transformExecutionEvidenceDigest,
373
- controlCompilationEvidenceDigest: digestArtifact(controlCompilationEvidence),
374
- };
375
- }
376
-
377
- function statusPaths(status) {
378
- const fields = status.toString('utf8').split('\0');
379
- const paths = [];
380
- for (let index = 0; index < fields.length - 1; index += 1) {
381
- const entry = fields[index];
382
- if (!entry) continue;
383
- const code = entry.slice(0, 2);
384
- paths.push(entry.slice(3));
385
- if (code[0] === 'R' || code[0] === 'C') paths.push(fields[++index]);
386
- }
387
- return [...new Set(paths)].sort();
388
- }
389
-
390
- function sameArray(left, right) {
391
- return left.length === right.length && left.every((value, index) => value === right[index]);
392
- }
393
-
394
- async function assertPatchScope(worktreePath, expectedPaths, { allowSensor = false } = {}) {
395
- const status = await run('git', [
396
- 'status', '--porcelain=v1', '-z', '--untracked-files=all',
397
- ], { cwd: worktreePath });
398
- const actual = statusPaths(status.stdout);
399
- const sensorPrefix = `${INDEX_DIRECTORY}/`;
400
- const sensorPaths = actual.filter((entry) => entry.startsWith(sensorPrefix));
401
- const sourcePaths = actual.filter((entry) => !entry.startsWith(sensorPrefix));
402
- if (!sameArray(sourcePaths, expectedPaths) || (!allowSensor && sensorPaths.length > 0)) {
403
- fail(`isolated treatment changed unexpected paths: ${actual.join(',')}`);
404
- }
405
- }
406
-
407
- async function observeSnapshot(worktreePath, transformArtifact) {
408
- const files = await Promise.all(transformArtifact.output.files.map(async (expected) => {
409
- const content = await readFile(path.join(worktreePath, expected.path));
410
- const contentDigest = sha256(content);
411
- if (contentDigest !== expected.content_digest) {
412
- fail(`post-transform file digest drift: ${expected.path}`);
413
- }
414
- return { path: expected.path, content_digest: contentDigest };
415
- }));
416
- const snapshotDigest = digestArtifact({ files });
417
- if (snapshotDigest !== transformArtifact.output.snapshot_digest) {
418
- fail('post-transform snapshot digestがaccepted artifactと一致しない');
419
- }
420
- return snapshotDigest;
421
- }
422
-
423
- function verifierEnvironment() {
424
- const env = { ...process.env, NO_COLOR: '1' };
425
- delete env.NODE_TEST_CONTEXT;
426
- delete env.FORCE_COLOR;
427
- return env;
428
- }
429
-
430
- async function runVerifier(worktreePath) {
431
- const result = await run(VERIFIER.command, VERIFIER.args, {
432
- cwd: worktreePath,
433
- env: verifierEnvironment(),
434
- });
435
- return {
436
- id: VERIFIER.id,
437
- command: VERIFIER.command,
438
- args: [...VERIFIER.args],
439
- outcome: 'passed',
440
- exit_code: result.code,
441
- stdout_digest: sha256(result.stdout),
442
- stderr_digest: sha256(result.stderr),
443
- };
444
- }
445
-
446
- function portableStatusSummary(outcome) {
447
- const portable = portableSensorOutcome(outcome);
448
- const status = portable?.data;
449
- if (!status || typeof status !== 'object') fail('portable LatticeSensor statusがない');
450
- return {
451
- version: status.version,
452
- file_count: status.fileCount,
453
- node_count: status.nodeCount,
454
- edge_count: status.edgeCount,
455
- pending_changes: status.pendingChanges,
456
- pending_refs: status.index?.pendingRefs,
457
- worktree_mismatch: status.worktreeMismatch,
458
- };
459
- }
460
-
461
- async function assertSourceUnchanged(repoRoot, expected) {
462
- const [head, status, ignoredStatus, worktrees] = await Promise.all([
463
- run('git', ['rev-parse', 'HEAD'], { cwd: repoRoot }),
464
- run('git', ['status', '--porcelain=v1', '-z'], { cwd: repoRoot }),
465
- run('git', [
466
- 'status', '--porcelain=v1', '-z', '--untracked-files=all', '--ignored=matching',
467
- ], { cwd: repoRoot }),
468
- run('git', ['worktree', 'list', '--porcelain'], { cwd: repoRoot }),
469
- ]);
470
- if (head.stdout.toString('utf8').trim() !== expected.head
471
- || !status.stdout.equals(expected.status)
472
- || !ignoredStatus.stdout.equals(expected.ignoredStatus)
473
- || !worktrees.stdout.equals(expected.worktrees)) {
474
- throw new Error('source repository changed during treatment recompile');
475
- }
476
- }
477
-
478
- /**
479
- * accepted seam patchをdisposable worktreeへ適用し、fresh LatticeSensor indexからRC1 plan v2をcompileする。
480
- * @param {object} options
481
- * @returns {Promise<{compiled: object, execution: object}>}
482
- */
483
- export async function runRc1TreatmentRecompile({
484
- repoRoot,
485
- planInput,
486
- manualNormal,
487
- manualNegative,
488
- querySet,
489
- transformArtifact,
490
- transformExecutionEvidence,
491
- transformPatch,
492
- controlCompilationEvidence,
493
- control,
494
- execute = executeLatticeSensor,
495
- } = {}) {
496
- const admission = assertAdmission({
497
- planInput,
498
- manualNormal,
499
- manualNegative,
500
- querySet,
501
- transformArtifact,
502
- transformExecutionEvidence,
503
- transformPatch,
504
- controlCompilationEvidence,
505
- control,
506
- });
507
- if (typeof repoRoot !== 'string' || repoRoot.length === 0 || typeof execute !== 'function') {
508
- throw new TypeError('invalid treatment recompile arguments');
509
- }
510
-
511
- const [sourceHead, sourceStatus, sourceIgnoredStatus, sourceWorktrees] = await Promise.all([
512
- run('git', ['rev-parse', 'HEAD'], { cwd: repoRoot }),
513
- run('git', ['status', '--porcelain=v1', '-z'], { cwd: repoRoot }),
514
- run('git', [
515
- 'status', '--porcelain=v1', '-z', '--untracked-files=all', '--ignored=matching',
516
- ], { cwd: repoRoot }),
517
- run('git', ['worktree', 'list', '--porcelain'], { cwd: repoRoot }),
518
- ]);
519
- if (sourceStatus.stdout.length > 0) fail('source repository must be clean');
520
- const sourceInvariant = {
521
- head: sourceHead.stdout.toString('utf8').trim(),
522
- status: sourceStatus.stdout,
523
- ignoredStatus: sourceIgnoredStatus.stdout,
524
- worktrees: sourceWorktrees.stdout,
525
- };
526
- const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'lattice-treatment-recompile-'));
527
- const worktreePath = path.join(tempRoot, 'worktree');
528
- const totalStarted = performance.now();
529
- let added = false;
530
- let primaryError;
531
- let compiled;
532
- let verifierReceipt;
533
- let rawOutcomesDigest;
534
- let portableOutcomesDigest;
535
- let sensorSummary;
536
- let applyVerifyMs;
537
- let indexMs;
538
- let compileMs;
539
- let sensorCleanup = 'unresolved';
540
- let worktreeCleanup = 'unresolved';
541
- try {
542
- await run('git', ['worktree', 'add', '--detach', worktreePath, admission.baseSha], {
543
- cwd: repoRoot,
544
- });
545
- added = true;
546
- const applyStarted = performance.now();
547
- await run('git', ['apply', '--check', '--whitespace=error-all', '-'], {
548
- cwd: worktreePath,
549
- input: transformPatch,
550
- });
551
- await run('git', ['apply', '--whitespace=error-all', '-'], {
552
- cwd: worktreePath,
553
- input: transformPatch,
554
- });
555
- await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths);
556
- const codeSnapshotDigest = await observeSnapshot(worktreePath, transformArtifact);
557
- verifierReceipt = await runVerifier(worktreePath);
558
- await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths);
559
- applyVerifyMs = Number((performance.now() - applyStarted).toFixed(3));
560
-
561
- const indexStarted = performance.now();
562
- const initialized = await execute({ args: ['init', '.'], cwd: worktreePath });
563
- if (initialized?.code !== 0) {
564
- throw new Error(`LatticeSensor init failed (${initialized?.code ?? 'unknown'}): ${initialized?.stderr ?? ''}`);
565
- }
566
- const sensorEvidence = await collectSensorEvidence({
567
- cwd: worktreePath,
568
- querySet,
569
- execute,
570
- });
571
- indexMs = Number((performance.now() - indexStarted).toFixed(3));
572
- rawOutcomesDigest = digestArtifact(sensorEvidence.outcomes);
573
- portableOutcomesDigest = digestArtifact(
574
- sensorEvidence.outcomes.map(portableSensorOutcome),
575
- );
576
- sensorSummary = portableStatusSummary(sensorEvidence.outcomes[0]);
577
- await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths, {
578
- allowSensor: true,
579
- });
580
- await observeSnapshot(worktreePath, transformArtifact);
581
-
582
- const compileStarted = performance.now();
583
- compiled = compileTreatmentArtifacts({
584
- planInput,
585
- manualNormal,
586
- manualNegative,
587
- querySet,
588
- sensorEvidence,
589
- codeSnapshotDigest,
590
- transformArtifact,
591
- control,
592
- });
593
- compileMs = Number((performance.now() - compileStarted).toFixed(3));
594
-
595
- await rm(path.join(worktreePath, INDEX_DIRECTORY), { recursive: true, force: true });
596
- try {
597
- await access(path.join(worktreePath, INDEX_DIRECTORY));
598
- throw new Error('LatticeSensor sensor state cleanup failed');
599
- } catch (error) {
600
- if (error.code !== 'ENOENT') throw error;
601
- }
602
- sensorCleanup = 'passed';
603
- await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths);
604
- } catch (error) {
605
- primaryError = error;
606
- }
607
-
608
- let cleanupError;
609
- try {
610
- if (added) {
611
- await run('git', ['worktree', 'remove', '--force', worktreePath], { cwd: repoRoot });
612
- }
613
- await rm(tempRoot, { recursive: true, force: true });
614
- worktreeCleanup = 'passed';
615
- } catch (error) {
616
- cleanupError = new Error(`treatment worktree cleanup failed: ${error.message}`);
617
- }
618
- let sourceError;
619
- try {
620
- await assertSourceUnchanged(repoRoot, sourceInvariant);
621
- } catch (error) {
622
- sourceError = error;
623
- }
624
- const errors = [primaryError, cleanupError, sourceError].filter(Boolean);
625
- if (errors.length === 1) throw errors[0];
626
- if (errors.length > 1) throw new AggregateError(errors, 'treatment recompile failed and cleanup or source invariant also failed');
627
-
628
- return {
629
- compiled,
630
- execution: {
631
- schema: 'lattice.rc1.treatment_recompile_run.v1',
632
- base_sha: admission.baseSha,
633
- transform_artifact_digest: admission.transformArtifactDigest,
634
- transform_execution_evidence_digest: admission.transformExecutionEvidenceDigest,
635
- control_compilation_evidence_digest: admission.controlCompilationEvidenceDigest,
636
- patch_digest: transformArtifact.patch.digest,
637
- query_set_digest: digestArtifact(querySet),
638
- code_snapshot_digest: transformArtifact.output.snapshot_digest,
639
- graph_digest_projection: PORTABLE_PROJECTION,
640
- raw_outcomes_digest: rawOutcomesDigest,
641
- portable_outcomes_digest: portableOutcomesDigest,
642
- sensor: sensorSummary,
643
- verifier: verifierReceipt,
644
- timings_ms: {
645
- apply_and_verify: applyVerifyMs,
646
- fresh_index_and_query: indexMs,
647
- compile: compileMs,
648
- total: Number((performance.now() - totalStarted).toFixed(3)),
649
- },
650
- sensor_directory: INDEX_DIRECTORY,
651
- sensor_cleanup: sensorCleanup,
652
- worktree_cleanup: worktreeCleanup,
653
- source_unchanged: true,
654
- },
655
- };
656
- }
1
+ import { spawn } from 'node:child_process';
2
+ import { createHash } from 'node:crypto';
3
+ import {
4
+ access,
5
+ mkdtemp,
6
+ readFile,
7
+ rm,
8
+ } from 'node:fs/promises';
9
+ import os from 'node:os';
10
+ import path from 'node:path';
11
+ import { performance } from 'node:perf_hooks';
12
+
13
+ import {
14
+ canonicalizeArtifact,
15
+ digestArtifact,
16
+ validateTransformArtifact,
17
+ } from './artifact-contracts.mjs';
18
+ import {
19
+ collectSensorEvidence,
20
+ portableSensorOutcome,
21
+ } from './sensor-adapter.mjs';
22
+ import { spawnSensorCli } from './sensor-runtime.mjs';
23
+ import { compileTreatmentArtifacts } from './treatment-compiler.mjs';
24
+
25
+ const SHA1 = /^[0-9a-f]{40}$/;
26
+ const SHA256 = /^[0-9a-f]{64}$/;
27
+ const PORTABLE_PROJECTION = 'lattice.sensor_portable_outcome.v1';
28
+ const VERIFIER = Object.freeze({
29
+ id: 'dispatch-characterization',
30
+ command: 'node',
31
+ args: ['--test', '--test-reporter=dot', 'test/research-dispatch-record.test.mjs'],
32
+ });
33
+
34
+ function fail(reason) {
35
+ throw new TypeError(`treatment recompile契約違反: ${reason}`);
36
+ }
37
+
38
+ function exactRecord(value, keys) {
39
+ if (value === null || typeof value !== 'object' || Array.isArray(value)
40
+ || Object.getPrototypeOf(value) !== Object.prototype) {
41
+ return false;
42
+ }
43
+ const actual = Object.keys(value).sort();
44
+ const expected = [...keys].sort();
45
+ return actual.length === expected.length
46
+ && actual.every((key, index) => key === expected[index]);
47
+ }
48
+
49
+ function sha256(value) {
50
+ return createHash('sha256').update(value).digest('hex');
51
+ }
52
+
53
+ function run(command, args, { cwd, env, input, allowExitCodes = [0] } = {}) {
54
+ return new Promise((resolve, reject) => {
55
+ const child = spawn(command, args, {
56
+ cwd,
57
+ env,
58
+ shell: false,
59
+ stdio: ['pipe', 'pipe', 'pipe'],
60
+ });
61
+ const stdout = [];
62
+ const stderr = [];
63
+ child.stdout.on('data', (chunk) => stdout.push(chunk));
64
+ child.stderr.on('data', (chunk) => stderr.push(chunk));
65
+ child.once('error', reject);
66
+ child.once('close', (code, signal) => {
67
+ const result = {
68
+ code,
69
+ signal,
70
+ stdout: Buffer.concat(stdout),
71
+ stderr: Buffer.concat(stderr),
72
+ };
73
+ if (allowExitCodes.includes(code) && signal === null) resolve(result);
74
+ else reject(Object.assign(
75
+ new Error(`${command} failed (${signal ?? code}): ${result.stderr.toString('utf8').trim()}`),
76
+ result,
77
+ ));
78
+ });
79
+ child.stdin.end(input);
80
+ });
81
+ }
82
+
83
+ function sensorEnvironment() {
84
+ const env = {
85
+ ...process.env,
86
+ LATTICE_SENSOR_NO_DAEMON: '1',
87
+ LATTICE_SENSOR_NO_WATCH: '1',
88
+ LATTICE_SENSOR_NO_UPDATE_CHECK: '1',
89
+ DO_NOT_TRACK: '1',
90
+ NO_COLOR: '1',
91
+ };
92
+ delete env.FORCE_COLOR;
93
+ return env;
94
+ }
95
+
96
+ function executeLatticeSensor({ args, cwd }) {
97
+ return new Promise((resolve) => {
98
+ const child = spawnSensorCli(args, {
99
+ cwd,
100
+ env: sensorEnvironment(),
101
+ stdio: ['ignore', 'pipe', 'pipe'],
102
+ });
103
+ let stdout = '';
104
+ let stderr = '';
105
+ child.stdout.on('data', (chunk) => { stdout += chunk; });
106
+ child.stderr.on('data', (chunk) => { stderr += chunk; });
107
+ child.once('error', (error) => {
108
+ resolve({ code: null, stdout, stderr, error: error.message });
109
+ });
110
+ child.once('close', (code) => resolve({ code, stdout, stderr }));
111
+ });
112
+ }
113
+
114
+ function artifactMeta(value) {
115
+ return exactRecord(value, ['digest', 'canonical_bytes'])
116
+ && typeof value.digest === 'string'
117
+ && SHA256.test(value.digest)
118
+ && Number.isSafeInteger(value.canonical_bytes)
119
+ && value.canonical_bytes > 0;
120
+ }
121
+
122
+ function artifactSet(value) {
123
+ return exactRecord(value, ['boundary_manifest', 'boundary_verdict', 'plan_graph'])
124
+ && Object.values(value).every(artifactMeta);
125
+ }
126
+
127
+ function assertPortableControlEvidence(evidence) {
128
+ if (!exactRecord(evidence, [
129
+ 'schema',
130
+ 'observed_at',
131
+ 'head',
132
+ 'executor_head',
133
+ 'graph_digest_projection',
134
+ 'input_digests',
135
+ 'sensor',
136
+ 'artifacts',
137
+ 'observed_facts',
138
+ 'presentation_note',
139
+ ])
140
+ || evidence.schema !== 'lattice.rc1.control_compilation_evidence.v2'
141
+ || evidence.graph_digest_projection !== PORTABLE_PROJECTION) {
142
+ fail('portable control evidence v2だけがrecompileへ進める');
143
+ }
144
+ if (typeof evidence.head !== 'string'
145
+ || !SHA1.test(evidence.head)
146
+ || typeof evidence.executor_head !== 'string'
147
+ || !SHA1.test(evidence.executor_head)
148
+ || !exactRecord(evidence.input_digests, [
149
+ 'plan_input',
150
+ 'query_set',
151
+ 'manual_normal',
152
+ 'manual_shared_state_negative',
153
+ 'code_snapshot',
154
+ ])
155
+ || Object.values(evidence.input_digests).some((digest) => (
156
+ typeof digest !== 'string' || !SHA256.test(digest)
157
+ ))
158
+ || !exactRecord(evidence.artifacts, ['control', 'shared_state_negative'])
159
+ || !artifactSet(evidence.artifacts.control)
160
+ || !artifactSet(evidence.artifacts.shared_state_negative)
161
+ || !exactRecord(evidence.sensor, [
162
+ 'version',
163
+ 'file_count',
164
+ 'node_count',
165
+ 'edge_count',
166
+ 'pending_changes',
167
+ 'pending_refs',
168
+ 'worktree_mismatch',
169
+ 'fresh_index_repetitions',
170
+ 'raw_outcomes_digests',
171
+ 'raw_outcomes_equal',
172
+ 'portable_outcomes_digest',
173
+ 'portable_outcomes_equal',
174
+ 'outcomes',
175
+ ])
176
+ || evidence.sensor.fresh_index_repetitions !== 2
177
+ || !Array.isArray(evidence.sensor.raw_outcomes_digests)
178
+ || evidence.sensor.raw_outcomes_digests.length !== 2
179
+ || evidence.sensor.raw_outcomes_digests.some((digest) => (
180
+ typeof digest !== 'string' || !SHA256.test(digest)
181
+ ))
182
+ || new Set(evidence.sensor.raw_outcomes_digests).size !== 2
183
+ || evidence.sensor.raw_outcomes_equal !== false
184
+ || typeof evidence.sensor.portable_outcomes_digest !== 'string'
185
+ || !SHA256.test(evidence.sensor.portable_outcomes_digest)
186
+ || evidence.sensor.portable_outcomes_equal !== true
187
+ || !Array.isArray(evidence.sensor.outcomes)
188
+ || evidence.sensor.outcomes.length === 0) {
189
+ fail('portable control evidence v2のdigest metadataが不正');
190
+ }
191
+ }
192
+
193
+ function assertTransformExecutionEvidence(evidence, {
194
+ transformArtifact,
195
+ transformPatch,
196
+ controlCompilationEvidence,
197
+ querySetDigest,
198
+ normal,
199
+ }) {
200
+ if (!exactRecord(evidence, [
201
+ 'schema',
202
+ 'observed_at',
203
+ 'executor_head',
204
+ 'experiment_base_sha',
205
+ 'control_compilation_evidence_schema',
206
+ 'graph_digest_projection',
207
+ 'input_digests',
208
+ 'runs',
209
+ 'artifacts',
210
+ 'observed_facts',
211
+ 'presentation_note',
212
+ ])
213
+ || evidence.schema !== 'lattice.rc1.seam_transform_execution_evidence.v2'
214
+ || typeof evidence.executor_head !== 'string'
215
+ || !SHA1.test(evidence.executor_head)
216
+ || evidence.experiment_base_sha !== transformArtifact.source.base_sha
217
+ || evidence.control_compilation_evidence_schema !== controlCompilationEvidence.schema
218
+ || evidence.graph_digest_projection !== PORTABLE_PROJECTION
219
+ || !exactRecord(evidence.input_digests, [
220
+ 'boundary_manifest',
221
+ 'boundary_verdict',
222
+ 'control_plan',
223
+ 'query_set',
224
+ 'control_compilation_evidence',
225
+ ])
226
+ || !exactRecord(evidence.runs, [
227
+ 'accepted_primary',
228
+ 'accepted_repeat',
229
+ 'scope_rejection',
230
+ 'behavior_rejection',
231
+ ])
232
+ || !exactRecord(evidence.artifacts, [
233
+ 'transform',
234
+ 'scope_rejection',
235
+ 'behavior_rejection',
236
+ 'patch',
237
+ ])
238
+ || !artifactMeta(evidence.artifacts.transform)
239
+ || !artifactMeta(evidence.artifacts.scope_rejection)
240
+ || !artifactMeta(evidence.artifacts.behavior_rejection)
241
+ || !exactRecord(evidence.artifacts.patch, ['digest', 'bytes'])) {
242
+ fail('transform execution evidence v2が不正');
243
+ }
244
+ const transformArtifactDigest = digestArtifact(transformArtifact);
245
+ const transformCanonicalBytes = Buffer.byteLength(canonicalizeArtifact(transformArtifact));
246
+ if (evidence.input_digests.boundary_manifest !== normal.boundary_manifest
247
+ || evidence.input_digests.boundary_verdict !== normal.boundary_verdict
248
+ || evidence.input_digests.control_plan !== normal.plan_graph
249
+ || evidence.input_digests.query_set !== querySetDigest
250
+ || evidence.input_digests.control_compilation_evidence
251
+ !== digestArtifact(controlCompilationEvidence)
252
+ || evidence.runs.accepted_primary?.artifact_digest !== transformArtifactDigest
253
+ || evidence.runs.accepted_repeat?.artifact_digest !== transformArtifactDigest
254
+ || evidence.artifacts.transform.digest !== transformArtifactDigest
255
+ || evidence.artifacts.transform.canonical_bytes !== transformCanonicalBytes
256
+ || evidence.artifacts.patch.digest !== sha256(transformPatch)
257
+ || evidence.artifacts.patch.bytes !== transformPatch.byteLength
258
+ || evidence.observed_facts?.deterministic_repeat !== true
259
+ || evidence.observed_facts?.same_control_base !== true
260
+ || evidence.observed_facts?.portable_control_chain !== true
261
+ || evidence.observed_facts?.characterization_passed !== true
262
+ || evidence.observed_facts?.git_apply_check !== 'passed'
263
+ || evidence.observed_facts?.source_unchanged !== true
264
+ || evidence.observed_facts?.cleanup !== 'passed') {
265
+ fail('transform execution evidenceのpredecessor chainが一致しない');
266
+ }
267
+ return digestArtifact(evidence);
268
+ }
269
+
270
+ function bundleDigests(bundle) {
271
+ if (!exactRecord(bundle, ['boundary_manifest', 'boundary_verdict', 'plan_graph'])) {
272
+ fail('control artifact setが不正');
273
+ }
274
+ return {
275
+ boundary_manifest: digestArtifact(bundle.boundary_manifest),
276
+ boundary_verdict: digestArtifact(bundle.boundary_verdict),
277
+ plan_graph: digestArtifact(bundle.plan_graph),
278
+ };
279
+ }
280
+
281
+ function assertAdmission({
282
+ planInput,
283
+ manualNormal,
284
+ manualNegative,
285
+ querySet,
286
+ transformArtifact,
287
+ transformExecutionEvidence,
288
+ transformPatch,
289
+ controlCompilationEvidence,
290
+ control,
291
+ }) {
292
+ for (const value of [
293
+ planInput,
294
+ manualNormal,
295
+ manualNegative,
296
+ querySet,
297
+ transformArtifact,
298
+ transformExecutionEvidence,
299
+ controlCompilationEvidence,
300
+ control,
301
+ ]) {
302
+ canonicalizeArtifact(value);
303
+ }
304
+ if (!validateTransformArtifact(transformArtifact) || transformArtifact.status !== 'accepted') {
305
+ fail('accepted transform artifactが必要');
306
+ }
307
+ if (!Buffer.isBuffer(transformPatch)
308
+ || sha256(transformPatch) !== transformArtifact.patch.digest
309
+ || transformPatch.byteLength !== transformArtifact.patch.bytes) {
310
+ fail('transform patch digestまたはpatch bytesがartifactと一致しない');
311
+ }
312
+ assertPortableControlEvidence(controlCompilationEvidence);
313
+ if (!exactRecord(control, ['normal', 'negative'])) fail('control artifact setが不正');
314
+ const normal = bundleDigests(control.normal);
315
+ const negative = bundleDigests(control.negative);
316
+ const evidence = controlCompilationEvidence;
317
+ if (evidence.head !== transformArtifact.source.base_sha
318
+ || evidence.input_digests.plan_input !== digestArtifact(planInput)
319
+ || evidence.input_digests.query_set !== digestArtifact(querySet)
320
+ || evidence.input_digests.manual_normal !== digestArtifact(manualNormal)
321
+ || evidence.input_digests.manual_shared_state_negative !== digestArtifact(manualNegative)
322
+ || evidence.input_digests.code_snapshot !== transformArtifact.source.code_snapshot_digest
323
+ || evidence.artifacts.control.boundary_manifest.digest !== normal.boundary_manifest
324
+ || evidence.artifacts.control.boundary_verdict.digest !== normal.boundary_verdict
325
+ || evidence.artifacts.control.plan_graph.digest !== normal.plan_graph
326
+ || evidence.artifacts.shared_state_negative.boundary_manifest.digest
327
+ !== negative.boundary_manifest
328
+ || evidence.artifacts.shared_state_negative.boundary_verdict.digest
329
+ !== negative.boundary_verdict
330
+ || evidence.artifacts.shared_state_negative.plan_graph.digest !== negative.plan_graph
331
+ || transformArtifact.source.boundary_manifest_digest !== normal.boundary_manifest
332
+ || transformArtifact.source.boundary_verdict_digest !== normal.boundary_verdict
333
+ || transformArtifact.source.control_plan_digest !== normal.plan_graph
334
+ || transformArtifact.source.query_set_digest !== digestArtifact(querySet)) {
335
+ fail('query setまたはcontrol artifact digest chainがportable predecessorと一致しない');
336
+ }
337
+ if (evidence.sensor.outcomes.length !== querySet.queries.length
338
+ || evidence.sensor.outcomes.some((outcome, index) => (
339
+ outcome.id !== querySet.queries[index]?.id
340
+ || outcome.operation !== querySet.queries[index]?.operation
341
+ || typeof outcome.result_digest !== 'string'
342
+ || !SHA256.test(outcome.result_digest)
343
+ ))
344
+ || JSON.stringify(evidence.sensor.outcomes.map((outcome) => ({
345
+ id: outcome.id,
346
+ operation: outcome.operation,
347
+ status: outcome.outcome,
348
+ result_digest: outcome.result_digest,
349
+ }))) !== JSON.stringify(control.normal.boundary_manifest.graph_evidence)) {
350
+ fail('portable control evidenceがquery set/control graph evidenceと一致しない');
351
+ }
352
+ const transformExecutionEvidenceDigest = assertTransformExecutionEvidence(
353
+ transformExecutionEvidence,
354
+ {
355
+ transformArtifact,
356
+ transformPatch,
357
+ controlCompilationEvidence,
358
+ querySetDigest: digestArtifact(querySet),
359
+ normal,
360
+ },
361
+ );
362
+ const receipt = transformArtifact.verification.receipts[0];
363
+ if (transformArtifact.verification.receipts.length !== 1
364
+ || receipt.id !== VERIFIER.id
365
+ || receipt.command !== VERIFIER.command
366
+ || JSON.stringify(receipt.args) !== JSON.stringify(VERIFIER.args)) {
367
+ fail('accepted transform verifierがRC1 fixed verifierと一致しない');
368
+ }
369
+ return {
370
+ baseSha: transformArtifact.source.base_sha,
371
+ transformArtifactDigest: digestArtifact(transformArtifact),
372
+ transformExecutionEvidenceDigest,
373
+ controlCompilationEvidenceDigest: digestArtifact(controlCompilationEvidence),
374
+ };
375
+ }
376
+
377
+ function statusPaths(status) {
378
+ const fields = status.toString('utf8').split('\0');
379
+ const paths = [];
380
+ for (let index = 0; index < fields.length - 1; index += 1) {
381
+ const entry = fields[index];
382
+ if (!entry) continue;
383
+ const code = entry.slice(0, 2);
384
+ paths.push(entry.slice(3));
385
+ if (code[0] === 'R' || code[0] === 'C') paths.push(fields[++index]);
386
+ }
387
+ return [...new Set(paths)].sort();
388
+ }
389
+
390
+ function sameArray(left, right) {
391
+ return left.length === right.length && left.every((value, index) => value === right[index]);
392
+ }
393
+
394
+ async function assertPatchScope(worktreePath, expectedPaths, { allowSensor = false } = {}) {
395
+ const status = await run('git', [
396
+ 'status', '--porcelain=v1', '-z', '--untracked-files=all',
397
+ ], { cwd: worktreePath });
398
+ const actual = statusPaths(status.stdout);
399
+ const sensorPrefix = `${INDEX_DIRECTORY}/`;
400
+ const sensorPaths = actual.filter((entry) => entry.startsWith(sensorPrefix));
401
+ const sourcePaths = actual.filter((entry) => !entry.startsWith(sensorPrefix));
402
+ if (!sameArray(sourcePaths, expectedPaths) || (!allowSensor && sensorPaths.length > 0)) {
403
+ fail(`isolated treatment changed unexpected paths: ${actual.join(',')}`);
404
+ }
405
+ }
406
+
407
+ async function observeSnapshot(worktreePath, transformArtifact) {
408
+ const files = await Promise.all(transformArtifact.output.files.map(async (expected) => {
409
+ const content = await readFile(path.join(worktreePath, expected.path));
410
+ const contentDigest = sha256(content);
411
+ if (contentDigest !== expected.content_digest) {
412
+ fail(`post-transform file digest drift: ${expected.path}`);
413
+ }
414
+ return { path: expected.path, content_digest: contentDigest };
415
+ }));
416
+ const snapshotDigest = digestArtifact({ files });
417
+ if (snapshotDigest !== transformArtifact.output.snapshot_digest) {
418
+ fail('post-transform snapshot digestがaccepted artifactと一致しない');
419
+ }
420
+ return snapshotDigest;
421
+ }
422
+
423
+ function verifierEnvironment() {
424
+ const env = { ...process.env, NO_COLOR: '1' };
425
+ delete env.NODE_TEST_CONTEXT;
426
+ delete env.FORCE_COLOR;
427
+ return env;
428
+ }
429
+
430
+ async function runVerifier(worktreePath) {
431
+ const result = await run(VERIFIER.command, VERIFIER.args, {
432
+ cwd: worktreePath,
433
+ env: verifierEnvironment(),
434
+ });
435
+ return {
436
+ id: VERIFIER.id,
437
+ command: VERIFIER.command,
438
+ args: [...VERIFIER.args],
439
+ outcome: 'passed',
440
+ exit_code: result.code,
441
+ stdout_digest: sha256(result.stdout),
442
+ stderr_digest: sha256(result.stderr),
443
+ };
444
+ }
445
+
446
+ function portableStatusSummary(outcome) {
447
+ const portable = portableSensorOutcome(outcome);
448
+ const status = portable?.data;
449
+ if (!status || typeof status !== 'object') fail('portable LatticeSensor statusがない');
450
+ return {
451
+ version: status.version,
452
+ file_count: status.fileCount,
453
+ node_count: status.nodeCount,
454
+ edge_count: status.edgeCount,
455
+ pending_changes: status.pendingChanges,
456
+ pending_refs: status.index?.pendingRefs,
457
+ worktree_mismatch: status.worktreeMismatch,
458
+ };
459
+ }
460
+
461
+ async function assertSourceUnchanged(repoRoot, expected) {
462
+ const [head, status, ignoredStatus, worktrees] = await Promise.all([
463
+ run('git', ['rev-parse', 'HEAD'], { cwd: repoRoot }),
464
+ run('git', ['status', '--porcelain=v1', '-z'], { cwd: repoRoot }),
465
+ run('git', [
466
+ 'status', '--porcelain=v1', '-z', '--untracked-files=all', '--ignored=matching',
467
+ ], { cwd: repoRoot }),
468
+ run('git', ['worktree', 'list', '--porcelain'], { cwd: repoRoot }),
469
+ ]);
470
+ if (head.stdout.toString('utf8').trim() !== expected.head
471
+ || !status.stdout.equals(expected.status)
472
+ || !ignoredStatus.stdout.equals(expected.ignoredStatus)
473
+ || !worktrees.stdout.equals(expected.worktrees)) {
474
+ throw new Error('source repository changed during treatment recompile');
475
+ }
476
+ }
477
+
478
+ /**
479
+ * accepted seam patchをdisposable worktreeへ適用し、fresh LatticeSensor indexからRC1 plan v2をcompileする。
480
+ * @param {object} options
481
+ * @returns {Promise<{compiled: object, execution: object}>}
482
+ */
483
+ export async function runRc1TreatmentRecompile({
484
+ repoRoot,
485
+ planInput,
486
+ manualNormal,
487
+ manualNegative,
488
+ querySet,
489
+ transformArtifact,
490
+ transformExecutionEvidence,
491
+ transformPatch,
492
+ controlCompilationEvidence,
493
+ control,
494
+ execute = executeLatticeSensor,
495
+ } = {}) {
496
+ const admission = assertAdmission({
497
+ planInput,
498
+ manualNormal,
499
+ manualNegative,
500
+ querySet,
501
+ transformArtifact,
502
+ transformExecutionEvidence,
503
+ transformPatch,
504
+ controlCompilationEvidence,
505
+ control,
506
+ });
507
+ if (typeof repoRoot !== 'string' || repoRoot.length === 0 || typeof execute !== 'function') {
508
+ throw new TypeError('invalid treatment recompile arguments');
509
+ }
510
+
511
+ const [sourceHead, sourceStatus, sourceIgnoredStatus, sourceWorktrees] = await Promise.all([
512
+ run('git', ['rev-parse', 'HEAD'], { cwd: repoRoot }),
513
+ run('git', ['status', '--porcelain=v1', '-z'], { cwd: repoRoot }),
514
+ run('git', [
515
+ 'status', '--porcelain=v1', '-z', '--untracked-files=all', '--ignored=matching',
516
+ ], { cwd: repoRoot }),
517
+ run('git', ['worktree', 'list', '--porcelain'], { cwd: repoRoot }),
518
+ ]);
519
+ if (sourceStatus.stdout.length > 0) fail('source repository must be clean');
520
+ const sourceInvariant = {
521
+ head: sourceHead.stdout.toString('utf8').trim(),
522
+ status: sourceStatus.stdout,
523
+ ignoredStatus: sourceIgnoredStatus.stdout,
524
+ worktrees: sourceWorktrees.stdout,
525
+ };
526
+ const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'lattice-treatment-recompile-'));
527
+ const worktreePath = path.join(tempRoot, 'worktree');
528
+ const totalStarted = performance.now();
529
+ let added = false;
530
+ let primaryError;
531
+ let compiled;
532
+ let verifierReceipt;
533
+ let rawOutcomesDigest;
534
+ let portableOutcomesDigest;
535
+ let sensorSummary;
536
+ let applyVerifyMs;
537
+ let indexMs;
538
+ let compileMs;
539
+ let sensorCleanup = 'unresolved';
540
+ let worktreeCleanup = 'unresolved';
541
+ try {
542
+ await run('git', ['worktree', 'add', '--detach', worktreePath, admission.baseSha], {
543
+ cwd: repoRoot,
544
+ });
545
+ added = true;
546
+ const applyStarted = performance.now();
547
+ await run('git', ['apply', '--check', '--whitespace=error-all', '-'], {
548
+ cwd: worktreePath,
549
+ input: transformPatch,
550
+ });
551
+ await run('git', ['apply', '--whitespace=error-all', '-'], {
552
+ cwd: worktreePath,
553
+ input: transformPatch,
554
+ });
555
+ await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths);
556
+ const codeSnapshotDigest = await observeSnapshot(worktreePath, transformArtifact);
557
+ verifierReceipt = await runVerifier(worktreePath);
558
+ await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths);
559
+ applyVerifyMs = Number((performance.now() - applyStarted).toFixed(3));
560
+
561
+ const indexStarted = performance.now();
562
+ const initialized = await execute({ args: ['init', '.'], cwd: worktreePath });
563
+ if (initialized?.code !== 0) {
564
+ throw new Error(`LatticeSensor init failed (${initialized?.code ?? 'unknown'}): ${initialized?.stderr ?? ''}`);
565
+ }
566
+ const sensorEvidence = await collectSensorEvidence({
567
+ cwd: worktreePath,
568
+ querySet,
569
+ execute,
570
+ });
571
+ indexMs = Number((performance.now() - indexStarted).toFixed(3));
572
+ rawOutcomesDigest = digestArtifact(sensorEvidence.outcomes);
573
+ portableOutcomesDigest = digestArtifact(
574
+ sensorEvidence.outcomes.map(portableSensorOutcome),
575
+ );
576
+ sensorSummary = portableStatusSummary(sensorEvidence.outcomes[0]);
577
+ await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths, {
578
+ allowSensor: true,
579
+ });
580
+ await observeSnapshot(worktreePath, transformArtifact);
581
+
582
+ const compileStarted = performance.now();
583
+ compiled = compileTreatmentArtifacts({
584
+ planInput,
585
+ manualNormal,
586
+ manualNegative,
587
+ querySet,
588
+ sensorEvidence,
589
+ codeSnapshotDigest,
590
+ transformArtifact,
591
+ control,
592
+ });
593
+ compileMs = Number((performance.now() - compileStarted).toFixed(3));
594
+
595
+ await rm(path.join(worktreePath, INDEX_DIRECTORY), { recursive: true, force: true });
596
+ try {
597
+ await access(path.join(worktreePath, INDEX_DIRECTORY));
598
+ throw new Error('LatticeSensor sensor state cleanup failed');
599
+ } catch (error) {
600
+ if (error.code !== 'ENOENT') throw error;
601
+ }
602
+ sensorCleanup = 'passed';
603
+ await assertPatchScope(worktreePath, transformArtifact.scope.changed_paths);
604
+ } catch (error) {
605
+ primaryError = error;
606
+ }
607
+
608
+ let cleanupError;
609
+ try {
610
+ if (added) {
611
+ await run('git', ['worktree', 'remove', '--force', worktreePath], { cwd: repoRoot });
612
+ }
613
+ await rm(tempRoot, { recursive: true, force: true });
614
+ worktreeCleanup = 'passed';
615
+ } catch (error) {
616
+ cleanupError = new Error(`treatment worktree cleanup failed: ${error.message}`);
617
+ }
618
+ let sourceError;
619
+ try {
620
+ await assertSourceUnchanged(repoRoot, sourceInvariant);
621
+ } catch (error) {
622
+ sourceError = error;
623
+ }
624
+ const errors = [primaryError, cleanupError, sourceError].filter(Boolean);
625
+ if (errors.length === 1) throw errors[0];
626
+ if (errors.length > 1) throw new AggregateError(errors, 'treatment recompile failed and cleanup or source invariant also failed');
627
+
628
+ return {
629
+ compiled,
630
+ execution: {
631
+ schema: 'lattice.rc1.treatment_recompile_run.v1',
632
+ base_sha: admission.baseSha,
633
+ transform_artifact_digest: admission.transformArtifactDigest,
634
+ transform_execution_evidence_digest: admission.transformExecutionEvidenceDigest,
635
+ control_compilation_evidence_digest: admission.controlCompilationEvidenceDigest,
636
+ patch_digest: transformArtifact.patch.digest,
637
+ query_set_digest: digestArtifact(querySet),
638
+ code_snapshot_digest: transformArtifact.output.snapshot_digest,
639
+ graph_digest_projection: PORTABLE_PROJECTION,
640
+ raw_outcomes_digest: rawOutcomesDigest,
641
+ portable_outcomes_digest: portableOutcomesDigest,
642
+ sensor: sensorSummary,
643
+ verifier: verifierReceipt,
644
+ timings_ms: {
645
+ apply_and_verify: applyVerifyMs,
646
+ fresh_index_and_query: indexMs,
647
+ compile: compileMs,
648
+ total: Number((performance.now() - totalStarted).toFixed(3)),
649
+ },
650
+ sensor_directory: INDEX_DIRECTORY,
651
+ sensor_cleanup: sensorCleanup,
652
+ worktree_cleanup: worktreeCleanup,
653
+ source_unchanged: true,
654
+ },
655
+ };
656
+ }