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.
Files changed (49) hide show
  1. package/README.md +11 -2
  2. package/docs/contracts.md +107 -1
  3. package/docs/release-notes/0.1.0-alpha.45.md +77 -0
  4. package/docs/upgrade.md +60 -18
  5. package/lib/contracts/cli.d.ts +67 -0
  6. package/lib/contracts/cli.js +6 -1
  7. package/lib/contracts/events.d.ts +5 -0
  8. package/lib/contracts/events.js +2 -0
  9. package/lib/contracts/execution.d.ts +39 -0
  10. package/lib/contracts/execution.js +15 -2
  11. package/lib/contracts/policy.d.ts +39 -0
  12. package/lib/contracts/policy.js +64 -0
  13. package/lib/contracts/profiles.d.ts +6 -0
  14. package/lib/contracts/published.d.ts +69 -0
  15. package/lib/contracts/result.d.ts +91 -0
  16. package/lib/contracts/result.js +31 -1
  17. package/lib/contracts/review.d.ts +1 -1
  18. package/lib/control/harness.d.ts +24 -2
  19. package/lib/engine/engine.d.ts +18 -3
  20. package/lib/engine/engine.js +74 -8
  21. package/lib/engine/result.js +7 -3
  22. package/lib/engine/runner.d.ts +8 -0
  23. package/lib/engine/runner.js +91 -3
  24. package/lib/environment/git-trust.js +3 -0
  25. package/lib/environment/process.d.ts +2 -0
  26. package/lib/environment/process.js +7 -1
  27. package/lib/explain/state.js +1 -1
  28. package/lib/index.d.ts +1 -0
  29. package/lib/index.js +1 -0
  30. package/lib/integrations/connector/history.js +1 -1
  31. package/lib/integrations/connector/summary.js +2 -1
  32. package/lib/profiles/resolve.d.ts +6 -0
  33. package/lib/projections/attempt.d.ts +4 -2
  34. package/lib/projections/attempt.js +14 -1
  35. package/lib/report/compute.js +4 -3
  36. package/lib/storage/document.d.ts +26 -2
  37. package/lib/verification/acceptance.d.ts +12 -0
  38. package/lib/verification/acceptance.js +62 -7
  39. package/lib/verification/applicability.d.ts +134 -0
  40. package/lib/verification/applicability.js +373 -0
  41. package/lib/verification/gates.d.ts +6 -0
  42. package/lib/verification/proof.d.ts +18 -4
  43. package/lib/verification/proof.js +52 -9
  44. package/package.json +1 -1
  45. package/schemas/execution-document.schema.json +73 -1
  46. package/schemas/execution-policy.schema.json +38 -0
  47. package/schemas/result-envelope.schema.json +138 -2
  48. package/schemas/run-event.schema.json +4 -0
  49. 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";
@@ -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
- kind: z.enum(['test', 'check', 'review', 'property', 'consumer']),
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,
@@ -471,7 +471,7 @@ export interface HistoryAttempt {
471
471
  evidence: {
472
472
  id: string;
473
473
  runId: string;
474
- kind: 'test' | 'review';
474
+ kind: 'test' | 'review' | 'not-applicable';
475
475
  phase: 'candidate' | 'integration';
476
476
  sha: string;
477
477
  passed: boolean;
@@ -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;
@@ -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;
@@ -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 last = (kind, phase, at, gate) => a.evidence.findLast((e) => e.kind === kind &&
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))?.passed === true;
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
- if (!last('test', phase, phase === 'candidate' ? a.candidateSha : sha, gate))
1528
- throw new HarnessError('GATE_FAILED', `Нет PASS: ${phase}/${gate}`);
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}`);
@@ -24,9 +24,11 @@ const ref = (e, attempt) => ({
24
24
  id: e.id,
25
25
  kind: e.kind === 'review'
26
26
  ? 'review'
27
- : e.consumer
28
- ? 'consumer'
29
- : 'test',
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