@quolu/lattice 0.52.0 → 0.52.2

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