devcontour-harness 0.1.0-alpha.44 → 0.1.0-alpha.45
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -2
- package/docs/contracts.md +107 -1
- package/docs/release-notes/0.1.0-alpha.45.md +77 -0
- package/docs/upgrade.md +60 -18
- package/lib/contracts/cli.d.ts +67 -0
- package/lib/contracts/cli.js +6 -1
- package/lib/contracts/events.d.ts +5 -0
- package/lib/contracts/events.js +2 -0
- package/lib/contracts/execution.d.ts +39 -0
- package/lib/contracts/execution.js +15 -2
- package/lib/contracts/policy.d.ts +39 -0
- package/lib/contracts/policy.js +64 -0
- package/lib/contracts/profiles.d.ts +6 -0
- package/lib/contracts/published.d.ts +69 -0
- package/lib/contracts/result.d.ts +91 -0
- package/lib/contracts/result.js +31 -1
- package/lib/contracts/review.d.ts +1 -1
- package/lib/control/harness.d.ts +24 -2
- package/lib/engine/engine.d.ts +18 -3
- package/lib/engine/engine.js +74 -8
- package/lib/engine/result.js +7 -3
- package/lib/engine/runner.d.ts +8 -0
- package/lib/engine/runner.js +91 -3
- package/lib/environment/git-trust.js +3 -0
- package/lib/environment/process.d.ts +2 -0
- package/lib/environment/process.js +7 -1
- package/lib/explain/state.js +1 -1
- package/lib/index.d.ts +1 -0
- package/lib/index.js +1 -0
- package/lib/integrations/connector/history.js +1 -1
- package/lib/integrations/connector/summary.js +2 -1
- package/lib/profiles/resolve.d.ts +6 -0
- package/lib/projections/attempt.d.ts +4 -2
- package/lib/projections/attempt.js +14 -1
- package/lib/report/compute.js +4 -3
- package/lib/storage/document.d.ts +26 -2
- package/lib/verification/acceptance.d.ts +12 -0
- package/lib/verification/acceptance.js +62 -7
- package/lib/verification/applicability.d.ts +134 -0
- package/lib/verification/applicability.js +373 -0
- package/lib/verification/gates.d.ts +6 -0
- package/lib/verification/proof.d.ts +18 -4
- package/lib/verification/proof.js +52 -9
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +73 -1
- package/schemas/execution-policy.schema.json +38 -0
- package/schemas/result-envelope.schema.json +138 -2
- package/schemas/run-event.schema.json +4 -0
- package/schemas/run-result.schema.json +138 -2
|
@@ -218,6 +218,9 @@ export declare const publishedSchemas: {
|
|
|
218
218
|
path: z.ZodString;
|
|
219
219
|
}, z.core.$strict>;
|
|
220
220
|
artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
221
|
+
when: z.ZodOptional<z.ZodObject<{
|
|
222
|
+
paths: z.ZodArray<z.ZodString>;
|
|
223
|
+
}, z.core.$strict>>;
|
|
221
224
|
id: z.ZodString;
|
|
222
225
|
command: z.ZodArray<z.ZodString>;
|
|
223
226
|
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
@@ -234,6 +237,9 @@ export declare const publishedSchemas: {
|
|
|
234
237
|
path: z.ZodString;
|
|
235
238
|
}, z.core.$strict>>;
|
|
236
239
|
artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
240
|
+
when: z.ZodOptional<z.ZodObject<{
|
|
241
|
+
paths: z.ZodArray<z.ZodString>;
|
|
242
|
+
}, z.core.$strict>>;
|
|
237
243
|
id: z.ZodString;
|
|
238
244
|
command: z.ZodArray<z.ZodString>;
|
|
239
245
|
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
@@ -916,6 +922,7 @@ export declare const publishedSchemas: {
|
|
|
916
922
|
test: "test";
|
|
917
923
|
property: "property";
|
|
918
924
|
consumer: "consumer";
|
|
925
|
+
"not-applicable": "not-applicable";
|
|
919
926
|
}>;
|
|
920
927
|
phase: z.ZodEnum<{
|
|
921
928
|
candidate: "candidate";
|
|
@@ -952,6 +959,17 @@ export declare const publishedSchemas: {
|
|
|
952
959
|
}, z.core.$strict>>;
|
|
953
960
|
}, z.core.$strict>>;
|
|
954
961
|
}, z.core.$strict>>;
|
|
962
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
963
|
+
gateDigest: z.ZodString;
|
|
964
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
965
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
966
|
+
from: z.ZodString;
|
|
967
|
+
to: z.ZodString;
|
|
968
|
+
}, z.core.$strict>>;
|
|
969
|
+
count: z.ZodNumber;
|
|
970
|
+
files: z.ZodArray<z.ZodString>;
|
|
971
|
+
pathsDigest: z.ZodString;
|
|
972
|
+
}, z.core.$strict>>;
|
|
955
973
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
956
974
|
runtime: z.ZodEnum<{
|
|
957
975
|
codex: "codex";
|
|
@@ -1140,6 +1158,7 @@ export declare const publishedSchemas: {
|
|
|
1140
1158
|
test: "test";
|
|
1141
1159
|
property: "property";
|
|
1142
1160
|
consumer: "consumer";
|
|
1161
|
+
"not-applicable": "not-applicable";
|
|
1143
1162
|
}>;
|
|
1144
1163
|
phase: z.ZodEnum<{
|
|
1145
1164
|
candidate: "candidate";
|
|
@@ -1176,6 +1195,17 @@ export declare const publishedSchemas: {
|
|
|
1176
1195
|
}, z.core.$strict>>;
|
|
1177
1196
|
}, z.core.$strict>>;
|
|
1178
1197
|
}, z.core.$strict>>;
|
|
1198
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
1199
|
+
gateDigest: z.ZodString;
|
|
1200
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
1201
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
1202
|
+
from: z.ZodString;
|
|
1203
|
+
to: z.ZodString;
|
|
1204
|
+
}, z.core.$strict>>;
|
|
1205
|
+
count: z.ZodNumber;
|
|
1206
|
+
files: z.ZodArray<z.ZodString>;
|
|
1207
|
+
pathsDigest: z.ZodString;
|
|
1208
|
+
}, z.core.$strict>>;
|
|
1179
1209
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
1180
1210
|
runtime: z.ZodEnum<{
|
|
1181
1211
|
codex: "codex";
|
|
@@ -1321,6 +1351,7 @@ export declare const publishedSchemas: {
|
|
|
1321
1351
|
test: "test";
|
|
1322
1352
|
property: "property";
|
|
1323
1353
|
consumer: "consumer";
|
|
1354
|
+
"not-applicable": "not-applicable";
|
|
1324
1355
|
}>;
|
|
1325
1356
|
phase: z.ZodEnum<{
|
|
1326
1357
|
candidate: "candidate";
|
|
@@ -1357,6 +1388,17 @@ export declare const publishedSchemas: {
|
|
|
1357
1388
|
}, z.core.$strict>>;
|
|
1358
1389
|
}, z.core.$strict>>;
|
|
1359
1390
|
}, z.core.$strict>>;
|
|
1391
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
1392
|
+
gateDigest: z.ZodString;
|
|
1393
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
1394
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
1395
|
+
from: z.ZodString;
|
|
1396
|
+
to: z.ZodString;
|
|
1397
|
+
}, z.core.$strict>>;
|
|
1398
|
+
count: z.ZodNumber;
|
|
1399
|
+
files: z.ZodArray<z.ZodString>;
|
|
1400
|
+
pathsDigest: z.ZodString;
|
|
1401
|
+
}, z.core.$strict>>;
|
|
1360
1402
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
1361
1403
|
runtime: z.ZodEnum<{
|
|
1362
1404
|
codex: "codex";
|
|
@@ -1545,6 +1587,7 @@ export declare const publishedSchemas: {
|
|
|
1545
1587
|
test: "test";
|
|
1546
1588
|
property: "property";
|
|
1547
1589
|
consumer: "consumer";
|
|
1590
|
+
"not-applicable": "not-applicable";
|
|
1548
1591
|
}>;
|
|
1549
1592
|
phase: z.ZodEnum<{
|
|
1550
1593
|
candidate: "candidate";
|
|
@@ -1581,6 +1624,17 @@ export declare const publishedSchemas: {
|
|
|
1581
1624
|
}, z.core.$strict>>;
|
|
1582
1625
|
}, z.core.$strict>>;
|
|
1583
1626
|
}, z.core.$strict>>;
|
|
1627
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
1628
|
+
gateDigest: z.ZodString;
|
|
1629
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
1630
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
1631
|
+
from: z.ZodString;
|
|
1632
|
+
to: z.ZodString;
|
|
1633
|
+
}, z.core.$strict>>;
|
|
1634
|
+
count: z.ZodNumber;
|
|
1635
|
+
files: z.ZodArray<z.ZodString>;
|
|
1636
|
+
pathsDigest: z.ZodString;
|
|
1637
|
+
}, z.core.$strict>>;
|
|
1584
1638
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
1585
1639
|
runtime: z.ZodEnum<{
|
|
1586
1640
|
codex: "codex";
|
|
@@ -1729,6 +1783,7 @@ export declare const publishedSchemas: {
|
|
|
1729
1783
|
passed: z.ZodBoolean;
|
|
1730
1784
|
evidenceId: z.ZodString;
|
|
1731
1785
|
consumer: z.ZodOptional<z.ZodString>;
|
|
1786
|
+
notApplicable: z.ZodOptional<z.ZodLiteral<true>>;
|
|
1732
1787
|
recheck: z.ZodOptional<z.ZodObject<{
|
|
1733
1788
|
of: z.ZodString;
|
|
1734
1789
|
outcome: z.ZodEnum<{
|
|
@@ -2227,6 +2282,7 @@ export declare const publishedSchemas: {
|
|
|
2227
2282
|
passed: z.ZodBoolean;
|
|
2228
2283
|
evidenceId: z.ZodString;
|
|
2229
2284
|
consumer: z.ZodOptional<z.ZodString>;
|
|
2285
|
+
notApplicable: z.ZodOptional<z.ZodLiteral<true>>;
|
|
2230
2286
|
recheck: z.ZodOptional<z.ZodObject<{
|
|
2231
2287
|
of: z.ZodString;
|
|
2232
2288
|
outcome: z.ZodEnum<{
|
|
@@ -3506,6 +3562,7 @@ export declare const publishedSchemas: {
|
|
|
3506
3562
|
kind: z.ZodEnum<{
|
|
3507
3563
|
review: "review";
|
|
3508
3564
|
test: "test";
|
|
3565
|
+
"not-applicable": "not-applicable";
|
|
3509
3566
|
}>;
|
|
3510
3567
|
phase: z.ZodEnum<{
|
|
3511
3568
|
candidate: "candidate";
|
|
@@ -3746,6 +3803,18 @@ export declare const publishedSchemas: {
|
|
|
3746
3803
|
skippedMore: z.ZodOptional<z.ZodNumber>;
|
|
3747
3804
|
}, z.core.$strict>>;
|
|
3748
3805
|
checks: z.ZodOptional<z.ZodString>;
|
|
3806
|
+
gateBasis: z.ZodOptional<z.ZodString>;
|
|
3807
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
3808
|
+
gateDigest: z.ZodString;
|
|
3809
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
3810
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
3811
|
+
from: z.ZodString;
|
|
3812
|
+
to: z.ZodString;
|
|
3813
|
+
}, z.core.$strict>>;
|
|
3814
|
+
count: z.ZodNumber;
|
|
3815
|
+
files: z.ZodArray<z.ZodString>;
|
|
3816
|
+
pathsDigest: z.ZodString;
|
|
3817
|
+
}, z.core.$strict>>;
|
|
3749
3818
|
alreadySatisfied: z.ZodOptional<z.ZodObject<{
|
|
3750
3819
|
gates: z.ZodArray<z.ZodString>;
|
|
3751
3820
|
evidence: z.ZodString;
|
|
@@ -13,6 +13,37 @@ export declare const findingSchema: z.ZodObject<{
|
|
|
13
13
|
}>>;
|
|
14
14
|
}, z.core.$strict>;
|
|
15
15
|
export type Finding = z.infer<typeof findingSchema>;
|
|
16
|
+
/** Пределы сведений о неприменимости gate (`when.paths`). */
|
|
17
|
+
export declare const gateApplicabilityLimits: {
|
|
18
|
+
/** Шаблонов путей у gate. */
|
|
19
|
+
readonly patterns: 64;
|
|
20
|
+
/** Перечисленных изменённых путей; остальные — числом (`count`) и digest. */
|
|
21
|
+
readonly files: 50;
|
|
22
|
+
/** Изменённых путей, сверх которых diff не разбирается и gate исполняется. */
|
|
23
|
+
readonly changed: 5000;
|
|
24
|
+
};
|
|
25
|
+
/**
|
|
26
|
+
* Почему gate с `when.paths` не исполнялся: настоящий diff фазы (не заявление
|
|
27
|
+
* исполнителя) не задел ни одного его пути и ни одного неявного входа. Это не
|
|
28
|
+
* PASS: запись вида `not-applicable` закрывает только обычный обязательный
|
|
29
|
+
* gate, но не доказательство требования, свойства или testcase.
|
|
30
|
+
* `gateDigest` — digest определения gate (`gateDigest`), под которым принято
|
|
31
|
+
* решение; `ranges` — сравненные пары коммитов, `count` — число изменённых
|
|
32
|
+
* путей, `files` — первые из них, `pathsDigest` — SHA-256 отсортированного
|
|
33
|
+
* полного списка, разделённого NUL.
|
|
34
|
+
*/
|
|
35
|
+
export declare const gateApplicabilitySchema: z.ZodObject<{
|
|
36
|
+
gateDigest: z.ZodString;
|
|
37
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
38
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
39
|
+
from: z.ZodString;
|
|
40
|
+
to: z.ZodString;
|
|
41
|
+
}, z.core.$strict>>;
|
|
42
|
+
count: z.ZodNumber;
|
|
43
|
+
files: z.ZodArray<z.ZodString>;
|
|
44
|
+
pathsDigest: z.ZodString;
|
|
45
|
+
}, z.core.$strict>;
|
|
46
|
+
export type GateApplicability = z.infer<typeof gateApplicabilitySchema>;
|
|
16
47
|
/**
|
|
17
48
|
* Ссылка на доказательство. Само evidence (логи, отчёты) хранит
|
|
18
49
|
* ExecutionStore; результат несёт digest и SHA, по которым его сверяют.
|
|
@@ -25,6 +56,7 @@ export declare const evidenceRefSchema: z.ZodObject<{
|
|
|
25
56
|
test: "test";
|
|
26
57
|
property: "property";
|
|
27
58
|
consumer: "consumer";
|
|
59
|
+
"not-applicable": "not-applicable";
|
|
28
60
|
}>;
|
|
29
61
|
phase: z.ZodEnum<{
|
|
30
62
|
candidate: "candidate";
|
|
@@ -61,6 +93,17 @@ export declare const evidenceRefSchema: z.ZodObject<{
|
|
|
61
93
|
}, z.core.$strict>>;
|
|
62
94
|
}, z.core.$strict>>;
|
|
63
95
|
}, z.core.$strict>>;
|
|
96
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
97
|
+
gateDigest: z.ZodString;
|
|
98
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
99
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
100
|
+
from: z.ZodString;
|
|
101
|
+
to: z.ZodString;
|
|
102
|
+
}, z.core.$strict>>;
|
|
103
|
+
count: z.ZodNumber;
|
|
104
|
+
files: z.ZodArray<z.ZodString>;
|
|
105
|
+
pathsDigest: z.ZodString;
|
|
106
|
+
}, z.core.$strict>>;
|
|
64
107
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
65
108
|
runtime: z.ZodEnum<{
|
|
66
109
|
codex: "codex";
|
|
@@ -241,6 +284,7 @@ export declare const runResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
241
284
|
test: "test";
|
|
242
285
|
property: "property";
|
|
243
286
|
consumer: "consumer";
|
|
287
|
+
"not-applicable": "not-applicable";
|
|
244
288
|
}>;
|
|
245
289
|
phase: z.ZodEnum<{
|
|
246
290
|
candidate: "candidate";
|
|
@@ -277,6 +321,17 @@ export declare const runResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
277
321
|
}, z.core.$strict>>;
|
|
278
322
|
}, z.core.$strict>>;
|
|
279
323
|
}, z.core.$strict>>;
|
|
324
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
325
|
+
gateDigest: z.ZodString;
|
|
326
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
327
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
328
|
+
from: z.ZodString;
|
|
329
|
+
to: z.ZodString;
|
|
330
|
+
}, z.core.$strict>>;
|
|
331
|
+
count: z.ZodNumber;
|
|
332
|
+
files: z.ZodArray<z.ZodString>;
|
|
333
|
+
pathsDigest: z.ZodString;
|
|
334
|
+
}, z.core.$strict>>;
|
|
280
335
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
281
336
|
runtime: z.ZodEnum<{
|
|
282
337
|
codex: "codex";
|
|
@@ -465,6 +520,7 @@ export declare const runResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
465
520
|
test: "test";
|
|
466
521
|
property: "property";
|
|
467
522
|
consumer: "consumer";
|
|
523
|
+
"not-applicable": "not-applicable";
|
|
468
524
|
}>;
|
|
469
525
|
phase: z.ZodEnum<{
|
|
470
526
|
candidate: "candidate";
|
|
@@ -501,6 +557,17 @@ export declare const runResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
501
557
|
}, z.core.$strict>>;
|
|
502
558
|
}, z.core.$strict>>;
|
|
503
559
|
}, z.core.$strict>>;
|
|
560
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
561
|
+
gateDigest: z.ZodString;
|
|
562
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
563
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
564
|
+
from: z.ZodString;
|
|
565
|
+
to: z.ZodString;
|
|
566
|
+
}, z.core.$strict>>;
|
|
567
|
+
count: z.ZodNumber;
|
|
568
|
+
files: z.ZodArray<z.ZodString>;
|
|
569
|
+
pathsDigest: z.ZodString;
|
|
570
|
+
}, z.core.$strict>>;
|
|
504
571
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
505
572
|
runtime: z.ZodEnum<{
|
|
506
573
|
codex: "codex";
|
|
@@ -672,6 +739,7 @@ export declare const resultEnvelopeSchema: z.ZodObject<{
|
|
|
672
739
|
test: "test";
|
|
673
740
|
property: "property";
|
|
674
741
|
consumer: "consumer";
|
|
742
|
+
"not-applicable": "not-applicable";
|
|
675
743
|
}>;
|
|
676
744
|
phase: z.ZodEnum<{
|
|
677
745
|
candidate: "candidate";
|
|
@@ -708,6 +776,17 @@ export declare const resultEnvelopeSchema: z.ZodObject<{
|
|
|
708
776
|
}, z.core.$strict>>;
|
|
709
777
|
}, z.core.$strict>>;
|
|
710
778
|
}, z.core.$strict>>;
|
|
779
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
780
|
+
gateDigest: z.ZodString;
|
|
781
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
782
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
783
|
+
from: z.ZodString;
|
|
784
|
+
to: z.ZodString;
|
|
785
|
+
}, z.core.$strict>>;
|
|
786
|
+
count: z.ZodNumber;
|
|
787
|
+
files: z.ZodArray<z.ZodString>;
|
|
788
|
+
pathsDigest: z.ZodString;
|
|
789
|
+
}, z.core.$strict>>;
|
|
711
790
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
712
791
|
runtime: z.ZodEnum<{
|
|
713
792
|
codex: "codex";
|
|
@@ -896,6 +975,7 @@ export declare const resultEnvelopeSchema: z.ZodObject<{
|
|
|
896
975
|
test: "test";
|
|
897
976
|
property: "property";
|
|
898
977
|
consumer: "consumer";
|
|
978
|
+
"not-applicable": "not-applicable";
|
|
899
979
|
}>;
|
|
900
980
|
phase: z.ZodEnum<{
|
|
901
981
|
candidate: "candidate";
|
|
@@ -932,6 +1012,17 @@ export declare const resultEnvelopeSchema: z.ZodObject<{
|
|
|
932
1012
|
}, z.core.$strict>>;
|
|
933
1013
|
}, z.core.$strict>>;
|
|
934
1014
|
}, z.core.$strict>>;
|
|
1015
|
+
notApplicable: z.ZodOptional<z.ZodObject<{
|
|
1016
|
+
gateDigest: z.ZodString;
|
|
1017
|
+
patterns: z.ZodArray<z.ZodString>;
|
|
1018
|
+
ranges: z.ZodArray<z.ZodObject<{
|
|
1019
|
+
from: z.ZodString;
|
|
1020
|
+
to: z.ZodString;
|
|
1021
|
+
}, z.core.$strict>>;
|
|
1022
|
+
count: z.ZodNumber;
|
|
1023
|
+
files: z.ZodArray<z.ZodString>;
|
|
1024
|
+
pathsDigest: z.ZodString;
|
|
1025
|
+
}, z.core.$strict>>;
|
|
935
1026
|
reviewer: z.ZodOptional<z.ZodObject<{
|
|
936
1027
|
runtime: z.ZodEnum<{
|
|
937
1028
|
codex: "codex";
|
package/lib/contracts/result.js
CHANGED
|
@@ -15,13 +15,41 @@ export const findingSchema = z.strictObject({
|
|
|
15
15
|
/** Статус находки на момент раунда, в котором она записана. */
|
|
16
16
|
status: z.enum(['open', 'closed', 'withdrawn']).optional(),
|
|
17
17
|
});
|
|
18
|
+
/** Пределы сведений о неприменимости gate (`when.paths`). */
|
|
19
|
+
export const gateApplicabilityLimits = {
|
|
20
|
+
/** Шаблонов путей у gate. */
|
|
21
|
+
patterns: 64,
|
|
22
|
+
/** Перечисленных изменённых путей; остальные — числом (`count`) и digest. */
|
|
23
|
+
files: 50,
|
|
24
|
+
/** Изменённых путей, сверх которых diff не разбирается и gate исполняется. */
|
|
25
|
+
changed: 5000,
|
|
26
|
+
};
|
|
27
|
+
/**
|
|
28
|
+
* Почему gate с `when.paths` не исполнялся: настоящий diff фазы (не заявление
|
|
29
|
+
* исполнителя) не задел ни одного его пути и ни одного неявного входа. Это не
|
|
30
|
+
* PASS: запись вида `not-applicable` закрывает только обычный обязательный
|
|
31
|
+
* gate, но не доказательство требования, свойства или testcase.
|
|
32
|
+
* `gateDigest` — digest определения gate (`gateDigest`), под которым принято
|
|
33
|
+
* решение; `ranges` — сравненные пары коммитов, `count` — число изменённых
|
|
34
|
+
* путей, `files` — первые из них, `pathsDigest` — SHA-256 отсортированного
|
|
35
|
+
* полного списка, разделённого NUL.
|
|
36
|
+
*/
|
|
37
|
+
export const gateApplicabilitySchema = z.strictObject({
|
|
38
|
+
gateDigest: digestSchema,
|
|
39
|
+
patterns: z.array(z.string().min(1).max(200)).max(gateApplicabilityLimits.patterns),
|
|
40
|
+
ranges: z.array(z.strictObject({ from: gitShaSchema, to: gitShaSchema })).max(4),
|
|
41
|
+
count: z.number().int().min(0).max(gateApplicabilityLimits.changed),
|
|
42
|
+
files: z.array(z.string().min(1).max(1000)).max(gateApplicabilityLimits.files),
|
|
43
|
+
pathsDigest: digestSchema,
|
|
44
|
+
});
|
|
18
45
|
/**
|
|
19
46
|
* Ссылка на доказательство. Само evidence (логи, отчёты) хранит
|
|
20
47
|
* ExecutionStore; результат несёт digest и SHA, по которым его сверяют.
|
|
21
48
|
*/
|
|
22
49
|
export const evidenceRefSchema = z.strictObject({
|
|
23
50
|
id: z.string().min(1).max(200),
|
|
24
|
-
|
|
51
|
+
/** `not-applicable` — gate не исполнялся по `when.paths` (`notApplicable`); не PASS. */
|
|
52
|
+
kind: z.enum(['test', 'check', 'review', 'property', 'consumer', 'not-applicable']),
|
|
25
53
|
phase: z.enum(['candidate', 'integration']),
|
|
26
54
|
gate: z.string().min(1).max(200),
|
|
27
55
|
sha: gitShaSchema,
|
|
@@ -62,6 +90,8 @@ export const evidenceRefSchema = z.strictObject({
|
|
|
62
90
|
.optional(),
|
|
63
91
|
})
|
|
64
92
|
.optional(),
|
|
93
|
+
/** Только у записи `not-applicable`: правило и diff, по которым gate не исполнялся. */
|
|
94
|
+
notApplicable: gateApplicabilitySchema.optional(),
|
|
65
95
|
reviewer: z
|
|
66
96
|
.strictObject({
|
|
67
97
|
runtime: runtimeNameSchema,
|
package/lib/control/harness.d.ts
CHANGED
|
@@ -3995,7 +3995,7 @@ export declare class Harness {
|
|
|
3995
3995
|
};
|
|
3996
3996
|
evidence: {
|
|
3997
3997
|
id: string;
|
|
3998
|
-
kind: "check" | "review" | "test" | "property" | "consumer";
|
|
3998
|
+
kind: "check" | "review" | "test" | "property" | "consumer" | "not-applicable";
|
|
3999
3999
|
phase: "candidate" | "integration";
|
|
4000
4000
|
gate: string;
|
|
4001
4001
|
sha: string;
|
|
@@ -4021,6 +4021,17 @@ export declare class Harness {
|
|
|
4021
4021
|
} | undefined;
|
|
4022
4022
|
} | undefined;
|
|
4023
4023
|
} | undefined;
|
|
4024
|
+
notApplicable?: {
|
|
4025
|
+
gateDigest: string;
|
|
4026
|
+
patterns: string[];
|
|
4027
|
+
ranges: {
|
|
4028
|
+
from: string;
|
|
4029
|
+
to: string;
|
|
4030
|
+
}[];
|
|
4031
|
+
count: number;
|
|
4032
|
+
files: string[];
|
|
4033
|
+
pathsDigest: string;
|
|
4034
|
+
} | undefined;
|
|
4024
4035
|
reviewer?: {
|
|
4025
4036
|
runtime: "codex" | "claude" | "fixture";
|
|
4026
4037
|
sameVendor: boolean;
|
|
@@ -4136,7 +4147,7 @@ export declare class Harness {
|
|
|
4136
4147
|
};
|
|
4137
4148
|
evidence: {
|
|
4138
4149
|
id: string;
|
|
4139
|
-
kind: "check" | "review" | "test" | "property" | "consumer";
|
|
4150
|
+
kind: "check" | "review" | "test" | "property" | "consumer" | "not-applicable";
|
|
4140
4151
|
phase: "candidate" | "integration";
|
|
4141
4152
|
gate: string;
|
|
4142
4153
|
sha: string;
|
|
@@ -4162,6 +4173,17 @@ export declare class Harness {
|
|
|
4162
4173
|
} | undefined;
|
|
4163
4174
|
} | undefined;
|
|
4164
4175
|
} | undefined;
|
|
4176
|
+
notApplicable?: {
|
|
4177
|
+
gateDigest: string;
|
|
4178
|
+
patterns: string[];
|
|
4179
|
+
ranges: {
|
|
4180
|
+
from: string;
|
|
4181
|
+
to: string;
|
|
4182
|
+
}[];
|
|
4183
|
+
count: number;
|
|
4184
|
+
files: string[];
|
|
4185
|
+
pathsDigest: string;
|
|
4186
|
+
} | undefined;
|
|
4165
4187
|
reviewer?: {
|
|
4166
4188
|
runtime: "codex" | "claude" | "fixture";
|
|
4167
4189
|
sameVendor: boolean;
|
package/lib/engine/engine.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type ReproductionRecord, type AttemptState, type RunEventPayload, type CancelActor, type ContextLimit, type EnvironmentCause, type RetryActor, type JointBudgetReset, type JointResetActor, type Author, type CallRecord, type ContractDocument, type EvidenceRecord, type ExecutionHost, type ExecutionPolicy, type ExecutionTransaction, type ExecutionView, type FailureKind, type GraphState, type InputActor, type InputAnswer, type InputOutcome, type InputRequest, type ContextSnapshot, type JointVerification, type JointVerificationState, type NotPromise, type Prerequisite, type PropertyRecovery, type ReviewRecord, type TechnicalApproval, type TransactionKind, type WorkGraph, type WorkState } from '../contracts/index.ts';
|
|
2
2
|
import { type BudgetContext, type CallMeta } from './budget.ts';
|
|
3
|
+
import { type ChangedPaths } from '../verification/applicability.ts';
|
|
3
4
|
/** Префикс причины неудавшегося продления: первая причина не затирается следствиями. */
|
|
4
5
|
export declare const HEARTBEAT_FAILED = "\u041F\u0440\u043E\u0434\u043B\u0435\u043D\u0438\u0435 \u0432\u043B\u0430\u0434\u0435\u043D\u0438\u044F \u043D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C";
|
|
5
6
|
export interface EngineOptions {
|
|
@@ -695,9 +696,11 @@ export declare class Engine {
|
|
|
695
696
|
* поручений: покрытие — по фактическому собственному evidence на принятом
|
|
696
697
|
* SHA попытки под текущим основанием политики, для любой области. Evidence потребителя — проверка другого
|
|
697
698
|
* компонента и не в счёт; запись ревью не закрывает одноимённый test gate.
|
|
698
|
-
*
|
|
699
|
+
* Gate с `when`, признанный где-то неприменимым, решается по объединённому
|
|
700
|
+
* diff набора `changes` (`uncoveredGates` проверки). Решение о приёмке набора
|
|
701
|
+
* поручений — за хостом.
|
|
699
702
|
*/
|
|
700
|
-
uncoveredGates(workIds: string[]): {
|
|
703
|
+
uncoveredGates(workIds: string[], changes?: Readonly<Record<string, ChangedPaths>>, finalShas?: Readonly<Record<string, string>>): {
|
|
701
704
|
repositoryId: string;
|
|
702
705
|
gates: string[];
|
|
703
706
|
}[];
|
|
@@ -745,7 +748,7 @@ export declare class Engine {
|
|
|
745
748
|
evidence(id: string, token: string, evidence: Omit<EvidenceRecord, 'id' | 'runId' | 'createdAt'>): {
|
|
746
749
|
id: string;
|
|
747
750
|
runId: string;
|
|
748
|
-
kind: "review" | "test";
|
|
751
|
+
kind: "review" | "test" | "not-applicable";
|
|
749
752
|
phase: "candidate" | "integration";
|
|
750
753
|
sha: string;
|
|
751
754
|
gate: string;
|
|
@@ -901,6 +904,18 @@ export declare class Engine {
|
|
|
901
904
|
skippedMore?: number | undefined;
|
|
902
905
|
} | undefined;
|
|
903
906
|
checks?: string | undefined;
|
|
907
|
+
gateBasis?: string | undefined;
|
|
908
|
+
notApplicable?: {
|
|
909
|
+
gateDigest: string;
|
|
910
|
+
patterns: string[];
|
|
911
|
+
ranges: {
|
|
912
|
+
from: string;
|
|
913
|
+
to: string;
|
|
914
|
+
}[];
|
|
915
|
+
count: number;
|
|
916
|
+
files: string[];
|
|
917
|
+
pathsDigest: string;
|
|
918
|
+
} | undefined;
|
|
904
919
|
alreadySatisfied?: {
|
|
905
920
|
gates: string[];
|
|
906
921
|
evidence: string;
|
package/lib/engine/engine.js
CHANGED
|
@@ -10,6 +10,7 @@ import { alreadySatisfiedVerdict, contractCheckGates } from "../verification/alr
|
|
|
10
10
|
import { contractDocuments, corpusBindingHolds, effectiveChecks, episodeBasis, orderPropertyProblems, } from "../verification/checks.js";
|
|
11
11
|
import { afterFailure, afterSuccess, blocksClaim, closeIfBasisChanged, } from "./property-recovery.js";
|
|
12
12
|
import { REQUIREMENT_GATE } from "../verification/requirements.js";
|
|
13
|
+
import { notApplicableProblem, proofGates, } from "../verification/applicability.js";
|
|
13
14
|
import { blockingRequest, inputManifestOf, requestById, requestsOf, unappliedInputs, } from "./input-requests.js";
|
|
14
15
|
import { pinnedCorpus, propertyProofProblem } from "../verification/acceptance.js";
|
|
15
16
|
import { jointImpact, jointPolicyDigest, jointSpecDigest, publicJoint, sameWorks, jointBudgetWindow, jointInterrupted, } from "../verification/joint.js";
|
|
@@ -1266,9 +1267,11 @@ export class Engine {
|
|
|
1266
1267
|
* поручений: покрытие — по фактическому собственному evidence на принятом
|
|
1267
1268
|
* SHA попытки под текущим основанием политики, для любой области. Evidence потребителя — проверка другого
|
|
1268
1269
|
* компонента и не в счёт; запись ревью не закрывает одноимённый test gate.
|
|
1269
|
-
*
|
|
1270
|
+
* Gate с `when`, признанный где-то неприменимым, решается по объединённому
|
|
1271
|
+
* diff набора `changes` (`uncoveredGates` проверки). Решение о приёмке набора
|
|
1272
|
+
* поручений — за хостом.
|
|
1270
1273
|
*/
|
|
1271
|
-
uncoveredGates(workIds) {
|
|
1274
|
+
uncoveredGates(workIds, changes, finalShas) {
|
|
1272
1275
|
return this.read((v) => {
|
|
1273
1276
|
const works = workIds.map((id) => v.work(id)).filter((w) => !!w);
|
|
1274
1277
|
const repositories = [...new Set(works.map((w) => w.order.repositoryId))].map((id) => this.repository(id));
|
|
@@ -1282,7 +1285,7 @@ export class Engine {
|
|
|
1282
1285
|
.attempts(w.id)
|
|
1283
1286
|
.filter((a) => a.policyDigest === this.host.basis.policyDigest(w, v))
|
|
1284
1287
|
.flatMap((a) => a.evidence),
|
|
1285
|
-
})));
|
|
1288
|
+
})), changes, finalShas);
|
|
1286
1289
|
});
|
|
1287
1290
|
}
|
|
1288
1291
|
/**
|
|
@@ -1436,6 +1439,42 @@ export class Engine {
|
|
|
1436
1439
|
// доказывала бы его (и названный testcase).
|
|
1437
1440
|
if ((evidence.kind === 'review') !== (evidence.gate === 'independent-review'))
|
|
1438
1441
|
throw new HarnessError('INVALID_INPUT', `Evidence вида ${evidence.kind} не может относиться к gate ${evidence.gate}`);
|
|
1442
|
+
// Неприменимость (`when.paths`) — только у gate с `when` области
|
|
1443
|
+
// попытки, под его текущим определением, без исполнения и не PASS;
|
|
1444
|
+
// сведения о ней — только у такой записи.
|
|
1445
|
+
if ((evidence.kind === 'not-applicable') !== (evidence.notApplicable !== undefined))
|
|
1446
|
+
throw new HarnessError('INVALID_INPUT', 'Сведения о неприменимости — только у записи вида not-applicable');
|
|
1447
|
+
if (evidence.kind === 'not-applicable') {
|
|
1448
|
+
const problem = evidence.passed ||
|
|
1449
|
+
evidence.consumer !== undefined ||
|
|
1450
|
+
evidence.recheck !== undefined ||
|
|
1451
|
+
evidence.tests !== undefined ||
|
|
1452
|
+
evidence.property !== undefined ||
|
|
1453
|
+
evidence.artifactFiles !== undefined ||
|
|
1454
|
+
!(a.requiredGates ?? []).includes(evidence.gate)
|
|
1455
|
+
? 'запись неприменимости не может быть PASS, исполнением или gate вне области'
|
|
1456
|
+
: // Решение — о SHA текущей фазы, diff заканчивается на нём.
|
|
1457
|
+
evidence.sha !==
|
|
1458
|
+
(evidence.phase === 'candidate' ? a.candidateSha : a.integrationSha) ||
|
|
1459
|
+
evidence.notApplicable.ranges.at(-1)?.to !== evidence.sha
|
|
1460
|
+
? 'запись неприменимости не относится к SHA фазы попытки'
|
|
1461
|
+
: // Исполненный gate не становится неприменимым на том же SHA.
|
|
1462
|
+
a.evidence.some((e) => e.kind === 'test' &&
|
|
1463
|
+
e.gate === evidence.gate &&
|
|
1464
|
+
e.phase === evidence.phase &&
|
|
1465
|
+
e.sha === evidence.sha &&
|
|
1466
|
+
e.consumer === undefined)
|
|
1467
|
+
? 'gate уже исполнялся на этом SHA: запись неприменимости не заменяет его исход'
|
|
1468
|
+
: notApplicableProblem({
|
|
1469
|
+
gates: this.repository(a.repositoryId).gates,
|
|
1470
|
+
gate: evidence.gate,
|
|
1471
|
+
record: evidence,
|
|
1472
|
+
proof: proofGates(w.order, contractDocuments(w.order, tx)),
|
|
1473
|
+
ran: [],
|
|
1474
|
+
});
|
|
1475
|
+
if (problem)
|
|
1476
|
+
throw new HarnessError('INVALID_INPUT', problem);
|
|
1477
|
+
}
|
|
1439
1478
|
// Повтор ссылается на провал того же gate этой попытки на том же SHA, и
|
|
1440
1479
|
// попытка повторяет не больше одного провала на фазу.
|
|
1441
1480
|
if (evidence.recheck) {
|
|
@@ -1489,6 +1528,7 @@ export class Engine {
|
|
|
1489
1528
|
passed: record.passed,
|
|
1490
1529
|
evidenceId: record.id,
|
|
1491
1530
|
...(record.consumer ? { consumer: record.consumer } : {}),
|
|
1531
|
+
...(record.kind === 'not-applicable' ? { notApplicable: true } : {}),
|
|
1492
1532
|
...(record.recheck ? { recheck: record.recheck } : {}),
|
|
1493
1533
|
},
|
|
1494
1534
|
});
|
|
@@ -1516,16 +1556,42 @@ export class Engine {
|
|
|
1516
1556
|
// попытка: новый корпус, принятый поручением, требует новой попытки.
|
|
1517
1557
|
if (a.checks && this.checksOf(w, tx) !== a.checks.effective)
|
|
1518
1558
|
throw new HarnessError('APPROVAL_STALE', 'Версия проверок поручения изменилась; нужна новая попытка');
|
|
1519
|
-
const
|
|
1559
|
+
const decisive = (kinds, phase, at, gate) => a.evidence.findLast((e) => kinds.includes(e.kind) &&
|
|
1520
1560
|
e.phase === phase &&
|
|
1521
1561
|
e.sha === at &&
|
|
1522
1562
|
e.gate === gate &&
|
|
1523
1563
|
e.consumer === undefined &&
|
|
1524
|
-
(!a.checks || e.checks === a.checks.effective))
|
|
1564
|
+
(!a.checks || e.checks === a.checks.effective));
|
|
1565
|
+
const last = (kind, phase, at, gate) => decisive([kind], phase, at, gate)?.passed === true;
|
|
1566
|
+
// Обязательный gate закрыт PASS или — только обычный gate с `when` —
|
|
1567
|
+
// записью неприменимости под текущим определением (`notApplicableProblem`).
|
|
1568
|
+
const repoGates = this.repository(a.repositoryId).gates;
|
|
1569
|
+
const named = proofGates(w.order, contractDocuments(w.order, tx));
|
|
1570
|
+
const shaOf = (phase) => phase === 'candidate' ? a.candidateSha : sha;
|
|
1571
|
+
const ran = Object.fromEntries(['candidate', 'integration'].map((phase) => [
|
|
1572
|
+
phase,
|
|
1573
|
+
(a.requiredGates ?? []).filter((gate) => decisive(['test'], phase, shaOf(phase), gate) !== undefined),
|
|
1574
|
+
]));
|
|
1525
1575
|
for (const gate of a.requiredGates ?? [])
|
|
1526
|
-
for (const phase of ['candidate', 'integration'])
|
|
1527
|
-
|
|
1528
|
-
|
|
1576
|
+
for (const phase of ['candidate', 'integration']) {
|
|
1577
|
+
// Исход исполнения решает всегда; неприменимость — только без него.
|
|
1578
|
+
const record = decisive(['test'], phase, shaOf(phase), gate) ??
|
|
1579
|
+
decisive(['not-applicable'], phase, shaOf(phase), gate);
|
|
1580
|
+
if (record?.kind === 'test' && record.passed)
|
|
1581
|
+
continue;
|
|
1582
|
+
const problem = record?.kind === 'not-applicable'
|
|
1583
|
+
? notApplicableProblem({
|
|
1584
|
+
gates: repoGates,
|
|
1585
|
+
gate,
|
|
1586
|
+
record,
|
|
1587
|
+
proof: named,
|
|
1588
|
+
ran: ran[phase],
|
|
1589
|
+
})
|
|
1590
|
+
: 'нет записи';
|
|
1591
|
+
if (problem)
|
|
1592
|
+
throw new HarnessError('GATE_FAILED', `Нет PASS: ${phase}/${gate}` +
|
|
1593
|
+
(record?.kind === 'not-applicable' ? ': ' + problem : ''));
|
|
1594
|
+
}
|
|
1529
1595
|
for (const phase of ['candidate', 'integration'])
|
|
1530
1596
|
if (!last('review', phase, phase === 'candidate' ? a.candidateSha : sha, 'independent-review'))
|
|
1531
1597
|
throw new HarnessError('REVIEW_REJECTED', `Нет независимого ревью: ${phase}`);
|
package/lib/engine/result.js
CHANGED
|
@@ -24,9 +24,11 @@ const ref = (e, attempt) => ({
|
|
|
24
24
|
id: e.id,
|
|
25
25
|
kind: e.kind === 'review'
|
|
26
26
|
? 'review'
|
|
27
|
-
: e.
|
|
28
|
-
? '
|
|
29
|
-
:
|
|
27
|
+
: e.kind === 'not-applicable'
|
|
28
|
+
? 'not-applicable'
|
|
29
|
+
: e.consumer
|
|
30
|
+
? 'consumer'
|
|
31
|
+
: 'test',
|
|
30
32
|
phase: e.phase,
|
|
31
33
|
gate: e.gate,
|
|
32
34
|
sha: e.sha,
|
|
@@ -35,6 +37,8 @@ const ref = (e, attempt) => ({
|
|
|
35
37
|
summary: e.summary.slice(0, 4000),
|
|
36
38
|
...(e.consumer ? { consumer: e.consumer } : {}),
|
|
37
39
|
...(e.checks ? { checks: e.checks } : {}),
|
|
40
|
+
// Gate не исполнялся по `when.paths`: правило и diff — получателю.
|
|
41
|
+
...(e.notApplicable ? { notApplicable: e.notApplicable } : {}),
|
|
38
42
|
// Список тестов собственной проверки интеграции — для доказательства
|
|
39
43
|
// названного testcase у получателя.
|
|
40
44
|
...(e.kind === 'test' && !e.consumer && e.phase === 'integration' && e.tests
|