@quolu/lattice 0.52.3 → 0.53.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 (188) hide show
  1. package/LICENSE +147 -147
  2. package/README.ja.md +355 -355
  3. package/README.md +258 -258
  4. package/bin/lattice-bridge.mjs +25 -0
  5. package/bin/lattice-hub.mjs +67 -0
  6. package/bin/lattice-mcp.mjs +0 -0
  7. package/bin/lattice-scripted-adapter.mjs +0 -0
  8. package/bin/lattice-scripted-worker.mjs +0 -0
  9. package/bin/lattice-work-order-adapter.mjs +0 -0
  10. package/bin/lattice.mjs +0 -0
  11. package/docs/bridge-setup.md +132 -132
  12. package/docs/schemas/lattice.executor_packet.v1.schema.json +57 -57
  13. package/docs/schemas/lattice.executor_receipt.v1.schema.json +66 -66
  14. package/docs/schemas/lattice.phase_todo_revision.v3.schema.json +360 -360
  15. package/docs/schemas/lattice.plan_create_input.v1.schema.json +56 -56
  16. package/docs/schemas/lattice.plan_create_input.v2.schema.json +72 -72
  17. package/docs/schemas/lattice.plan_create_input.v3.schema.json +81 -81
  18. package/docs/schemas/lattice.plan_create_input.v4.schema.json +85 -85
  19. package/docs/schemas/lattice.run_request.v1.schema.json +238 -238
  20. package/docs/schemas/lattice.runtime_adapter_capabilities.v2.schema.json +55 -55
  21. package/docs/schemas/lattice.runtime_adapter_registration_input.v1.schema.json +78 -78
  22. package/docs/schemas/lattice.runtime_adapter_registration_input.v2.schema.json +86 -86
  23. package/docs/schemas/lattice.todo_extraction.v2.schema.json +298 -298
  24. package/docs/schemas/lattice.todo_extraction.v3.schema.json +146 -146
  25. package/docs/schemas/lattice.todo_revision.v2.schema.json +260 -260
  26. package/docs/schemas/lattice.todo_revision_set.v3.schema.json +363 -363
  27. package/package.json +103 -103
  28. package/sensor/LICENSE +21 -21
  29. package/sensor/NOTICE +19 -19
  30. package/sensor/dist/bin/lattice-sensor.js +9 -9
  31. package/sensor/dist/db/index.js +24 -24
  32. package/sensor/dist/db/migrations.js +41 -41
  33. package/sensor/dist/db/queries.js +164 -164
  34. package/sensor/dist/db/schema.sql +205 -205
  35. package/sensor/dist/directory.js +5 -5
  36. package/sensor/dist/extraction/wasm/tree-sitter-c_sharp.wasm +0 -0
  37. package/sensor/dist/extraction/wasm/tree-sitter-cfml.wasm +0 -0
  38. package/sensor/dist/extraction/wasm/tree-sitter-cfquery.wasm +0 -0
  39. package/sensor/dist/extraction/wasm/tree-sitter-cfscript.wasm +0 -0
  40. package/sensor/dist/extraction/wasm/tree-sitter-cobol.wasm +0 -0
  41. package/sensor/dist/extraction/wasm/tree-sitter-erlang.wasm +0 -0
  42. package/sensor/dist/extraction/wasm/tree-sitter-go.wasm +0 -0
  43. package/sensor/dist/extraction/wasm/tree-sitter-java.wasm +0 -0
  44. package/sensor/dist/extraction/wasm/tree-sitter-javascript.wasm +0 -0
  45. package/sensor/dist/extraction/wasm/tree-sitter-nix.wasm +0 -0
  46. package/sensor/dist/extraction/wasm/tree-sitter-pascal.wasm +0 -0
  47. package/sensor/dist/extraction/wasm/tree-sitter-python.wasm +0 -0
  48. package/sensor/dist/extraction/wasm/tree-sitter-tsx.wasm +0 -0
  49. package/sensor/dist/extraction/wasm/tree-sitter-typescript.wasm +0 -0
  50. package/sensor/dist/extraction/wasm/tree-sitter-vbnet.wasm +0 -0
  51. package/sensor/dist/mcp/liveness-watchdog.js +53 -53
  52. package/sensor/dist/mcp/server-instructions.js +95 -95
  53. package/sensor/package.json +56 -56
  54. package/src/artifact-contracts-v2.mjs +325 -325
  55. package/src/artifact-contracts.mjs +895 -895
  56. package/src/boundary-compiler.mjs +712 -712
  57. package/src/boundary-observation-compiler-v2.mjs +344 -344
  58. package/src/bounded-seam.mjs +230 -230
  59. package/src/bridge-address.mjs +107 -107
  60. package/src/bridge-cli.mjs +303 -297
  61. package/src/bridge-config.mjs +382 -346
  62. package/src/bridge-daemon.mjs +378 -378
  63. package/src/bridge-hub-heartbeat.mjs +170 -0
  64. package/src/bridge-hub-protocol.mjs +198 -0
  65. package/src/bridge-hub-server.mjs +544 -0
  66. package/src/bridge-launch-agent.mjs +323 -323
  67. package/src/bridge-registrar.mjs +102 -102
  68. package/src/bridge-server.mjs +376 -376
  69. package/src/cli-help.mjs +308 -308
  70. package/src/cli-stdio.mjs +40 -40
  71. package/src/control-compiler.mjs +532 -532
  72. package/src/dag-chain.mjs +261 -261
  73. package/src/factory-diagnostics.mjs +188 -188
  74. package/src/git-process.mjs +72 -0
  75. package/src/hash-chain.mjs +76 -76
  76. package/src/hooks-cli.mjs +1057 -1057
  77. package/src/isolation-runner.mjs +409 -409
  78. package/src/node-version-guard.mjs +44 -44
  79. package/src/project-cli.mjs +3 -3
  80. package/src/project-identity.mjs +130 -130
  81. package/src/rc1-black-box-oracle.mjs +906 -906
  82. package/src/rc1-comparison.mjs +154 -154
  83. package/src/rc1-evidence-bundle.mjs +456 -456
  84. package/src/rc1-v4-campaign.mjs +708 -708
  85. package/src/rc1-v4-transform.mjs +467 -467
  86. package/src/rc1-v5-artifact-set.mjs +855 -855
  87. package/src/rc1-v5-behavior-evidence.mjs +594 -594
  88. package/src/rc1-v5-campaign.mjs +797 -797
  89. package/src/rc1-v5-transform.mjs +421 -421
  90. package/src/rc1-v6-artifact-set.mjs +807 -807
  91. package/src/rc1-v6-behavior-evidence.mjs +273 -273
  92. package/src/rc1-v6-campaign.mjs +623 -623
  93. package/src/rc1-v6-causal-binding.mjs +473 -473
  94. package/src/rc1-v6-measurement.mjs +313 -313
  95. package/src/rc2-artifact-set.mjs +1584 -1584
  96. package/src/rc2-campaign.mjs +1506 -1506
  97. package/src/rc2-delivery-policy-front-end.mjs +1079 -1079
  98. package/src/rc2-delivery-policy-oracle.mjs +134 -134
  99. package/src/rc2-delivery-policy-transform.mjs +1127 -1127
  100. package/src/rc2-rc1-transfer-front-end.mjs +511 -511
  101. package/src/rc3-actual-dogfood.mjs +652 -652
  102. package/src/rc3-dogfood-scaffold.mjs +315 -315
  103. package/src/rc3-scripted-campaign.mjs +1383 -1383
  104. package/src/rc4-stage1-dogfood.mjs +673 -673
  105. package/src/runtime-adapter-registry.mjs +524 -524
  106. package/src/runtime-cli.mjs +4588 -4588
  107. package/src/runtime-contracts.mjs +824 -824
  108. package/src/runtime-control-store.mjs +604 -604
  109. package/src/runtime-controller-protocol.mjs +587 -587
  110. package/src/runtime-decision-verifier.mjs +701 -701
  111. package/src/runtime-diff-observer.mjs +361 -361
  112. package/src/runtime-direct-os-observer.mjs +301 -301
  113. package/src/runtime-driver-state.mjs +166 -166
  114. package/src/runtime-engine.mjs +779 -779
  115. package/src/runtime-errors.mjs +356 -356
  116. package/src/runtime-event-store.mjs +189 -189
  117. package/src/runtime-front-end.mjs +925 -925
  118. package/src/runtime-gate-store.mjs +481 -481
  119. package/src/runtime-hold-recompile.mjs +916 -916
  120. package/src/runtime-io-sentinel.mjs +391 -391
  121. package/src/runtime-lifecycle-lock.mjs +294 -294
  122. package/src/runtime-managed-supervisor.mjs +1490 -1490
  123. package/src/runtime-multi-epoch-store.mjs +838 -838
  124. package/src/runtime-projection.mjs +269 -269
  125. package/src/runtime-pull-intake.mjs +1192 -1192
  126. package/src/runtime-scripted-adapter-controller.mjs +1160 -1160
  127. package/src/runtime-scripted-executor.mjs +163 -163
  128. package/src/runtime-scripted-worktree.mjs +104 -104
  129. package/src/runtime-seam-resolve.mjs +428 -428
  130. package/src/runtime-seam-treatment.mjs +173 -173
  131. package/src/runtime-socket-owner.mjs +125 -125
  132. package/src/runtime-work-order-contracts.mjs +91 -91
  133. package/src/runtime-work-order-controller.mjs +1171 -1171
  134. package/src/runtime-worktree-executor.mjs +199 -199
  135. package/src/schedulability-compiler-v2.mjs +303 -303
  136. package/src/schedulability-verifier-v2.mjs +317 -317
  137. package/src/seam-apply.mjs +549 -549
  138. package/src/seam-commit-shared.mjs +22 -22
  139. package/src/seam-commit-transform.mjs +81 -81
  140. package/src/seam-commit.mjs +18 -18
  141. package/src/seam-cost.mjs +322 -322
  142. package/src/seam-derivation.mjs +188 -188
  143. package/src/seam-gate.mjs +146 -146
  144. package/src/seam-proposal-contracts.mjs +446 -446
  145. package/src/seam-proposal-queries.mjs +521 -521
  146. package/src/seam-proposal.mjs +2011 -2011
  147. package/src/seam-ref.mjs +33 -33
  148. package/src/seam-rewrite.mjs +286 -286
  149. package/src/seam-transform.mjs +554 -554
  150. package/src/seam-verification.mjs +260 -260
  151. package/src/sensor-adapter.mjs +432 -432
  152. package/src/sensor-cli.mjs +139 -139
  153. package/src/sensor-diff.mjs +661 -661
  154. package/src/sensor-node-runtime.mjs +53 -53
  155. package/src/sensor-runtime.mjs +52 -52
  156. package/src/timestamp-contract.mjs +8 -8
  157. package/src/todo-audit-pending.mjs +91 -91
  158. package/src/todo-chain.mjs +178 -178
  159. package/src/todo-cli.mjs +8 -8
  160. package/src/todo-contracts.mjs +728 -728
  161. package/src/todo-dashboard-registry.mjs +573 -573
  162. package/src/todo-dispatch-shape.mjs +190 -190
  163. package/src/todo-gantt-html-independence.mjs +239 -239
  164. package/src/todo-gantt-html-shared.mjs +226 -226
  165. package/src/todo-gantt-html-style.mjs +131 -131
  166. package/src/todo-gantt-html.mjs +248 -248
  167. package/src/todo-gantt-layout.mjs +974 -974
  168. package/src/todo-gantt-live.mjs +361 -361
  169. package/src/todo-gantt-nested.mjs +263 -263
  170. package/src/todo-gantt-presentation.mjs +217 -217
  171. package/src/todo-gantt-scope.mjs +123 -123
  172. package/src/todo-gantt-svg.mjs +353 -353
  173. package/src/todo-independence-contracts.mjs +595 -595
  174. package/src/todo-independence-guidance.mjs +322 -322
  175. package/src/todo-independence.mjs +640 -640
  176. package/src/todo-markdown-renderer.mjs +260 -260
  177. package/src/todo-migration.mjs +448 -448
  178. package/src/todo-narrative-anchor.mjs +130 -130
  179. package/src/todo-note-store.mjs +629 -629
  180. package/src/todo-parallel-candidates.mjs +114 -114
  181. package/src/todo-revision.mjs +995 -995
  182. package/src/todo-split.mjs +472 -472
  183. package/src/todo-status.mjs +690 -690
  184. package/src/todo-store-git-transaction.mjs +418 -418
  185. package/src/todo-store.mjs +42 -21
  186. package/src/treatment-compiler.mjs +728 -728
  187. package/src/treatment-runner.mjs +656 -656
  188. 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
+ }