devcontour-harness 0.1.0-alpha.42 → 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 (65) hide show
  1. package/README.md +25 -2
  2. package/docs/architecture.md +38 -3
  3. package/docs/contracts.md +117 -3
  4. package/docs/release-notes/0.1.0-alpha.43.md +40 -0
  5. package/docs/release-notes/0.1.0-alpha.44.md +44 -0
  6. package/docs/release-notes/0.1.0-alpha.45.md +77 -0
  7. package/docs/upgrade.md +107 -17
  8. package/lib/contracts/cli.d.ts +115 -4
  9. package/lib/contracts/cli.js +6 -1
  10. package/lib/contracts/events.d.ts +65 -5
  11. package/lib/contracts/events.js +18 -1
  12. package/lib/contracts/execution.d.ts +76 -0
  13. package/lib/contracts/execution.js +35 -2
  14. package/lib/contracts/policy.d.ts +39 -0
  15. package/lib/contracts/policy.js +64 -0
  16. package/lib/contracts/profiles.d.ts +6 -0
  17. package/lib/contracts/published.d.ts +97 -2
  18. package/lib/contracts/report.d.ts +8 -0
  19. package/lib/contracts/report.js +7 -1
  20. package/lib/contracts/result.d.ts +93 -0
  21. package/lib/contracts/result.js +37 -1
  22. package/lib/contracts/review.d.ts +1 -1
  23. package/lib/control/harness.d.ts +29 -2
  24. package/lib/engine/engine.d.ts +54 -6
  25. package/lib/engine/engine.js +191 -24
  26. package/lib/engine/joint-runner.d.ts +2 -0
  27. package/lib/engine/joint-runner.js +13 -3
  28. package/lib/engine/result.js +7 -3
  29. package/lib/engine/runner.d.ts +8 -0
  30. package/lib/engine/runner.js +91 -3
  31. package/lib/environment/git-trust.js +3 -0
  32. package/lib/environment/isolation.d.ts +1 -1
  33. package/lib/environment/isolation.js +38 -4
  34. package/lib/environment/process.d.ts +2 -0
  35. package/lib/environment/process.js +7 -1
  36. package/lib/explain/state.js +1 -1
  37. package/lib/index.d.ts +1 -0
  38. package/lib/index.js +1 -0
  39. package/lib/integrations/connector/history.js +1 -1
  40. package/lib/integrations/connector/summary.js +2 -1
  41. package/lib/profiles/resolve.d.ts +6 -0
  42. package/lib/projections/attempt.d.ts +4 -2
  43. package/lib/projections/attempt.js +14 -1
  44. package/lib/report/compute.js +7 -3
  45. package/lib/report/document.js +1 -1
  46. package/lib/storage/document.d.ts +28 -2
  47. package/lib/testing/store-contract.d.ts +8 -2
  48. package/lib/testing/store-contract.js +56 -1
  49. package/lib/verification/acceptance.d.ts +12 -0
  50. package/lib/verification/acceptance.js +62 -7
  51. package/lib/verification/applicability.d.ts +134 -0
  52. package/lib/verification/applicability.js +373 -0
  53. package/lib/verification/gates.d.ts +6 -0
  54. package/lib/verification/joint.d.ts +179 -1
  55. package/lib/verification/joint.js +23 -3
  56. package/lib/verification/proof.d.ts +18 -4
  57. package/lib/verification/proof.js +52 -9
  58. package/package.json +1 -1
  59. package/schemas/execution-document.schema.json +77 -1
  60. package/schemas/execution-policy.schema.json +38 -0
  61. package/schemas/joint-verification.schema.json +4 -0
  62. package/schemas/result-envelope.schema.json +138 -2
  63. package/schemas/run-event.schema.json +100 -0
  64. package/schemas/run-result.schema.json +138 -2
  65. package/schemas/value-report.schema.json +20 -0
@@ -223,6 +223,9 @@ export declare const resolvedProfileSchema: z.ZodObject<{
223
223
  path: z.ZodString;
224
224
  }, z.core.$strict>;
225
225
  artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
226
+ when: z.ZodOptional<z.ZodObject<{
227
+ paths: z.ZodArray<z.ZodString>;
228
+ }, z.core.$strict>>;
226
229
  id: z.ZodString;
227
230
  command: z.ZodArray<z.ZodString>;
228
231
  timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -239,6 +242,9 @@ export declare const resolvedProfileSchema: z.ZodObject<{
239
242
  path: z.ZodString;
240
243
  }, z.core.$strict>>;
241
244
  artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
245
+ when: z.ZodOptional<z.ZodObject<{
246
+ paths: z.ZodArray<z.ZodString>;
247
+ }, z.core.$strict>>;
242
248
  id: z.ZodString;
243
249
  command: z.ZodArray<z.ZodString>;
244
250
  timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -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";
@@ -1661,7 +1715,7 @@ export declare const publishedSchemas: {
1661
1715
  workId: z.ZodOptional<z.ZodString>;
1662
1716
  runId: z.ZodOptional<z.ZodString>;
1663
1717
  attempt: z.ZodOptional<z.ZodNumber>;
1664
- type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "input.requested" | "input.answered" | "input.applied" | "input.closed" | "input.stale" | "input.delivered" | "attempt.assumptions" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
1718
+ type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "joint.budget-reset" | "policy.applied" | "policy.reconfigure" | "input.requested" | "input.answered" | "input.applied" | "input.closed" | "input.stale" | "input.delivered" | "attempt.assumptions" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
1665
1719
  payload: z.ZodObject<{
1666
1720
  digest: z.ZodString;
1667
1721
  orders: z.ZodNumber;
@@ -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<{
@@ -2026,6 +2081,16 @@ export declare const publishedSchemas: {
2026
2081
  }>;
2027
2082
  manifestDigest: z.ZodOptional<z.ZodString>;
2028
2083
  error: z.ZodOptional<z.ZodString>;
2084
+ interrupted: z.ZodOptional<z.ZodLiteral<true>>;
2085
+ }, z.core.$strict> | z.ZodObject<{
2086
+ resetId: z.ZodString;
2087
+ workIds: z.ZodArray<z.ZodString>;
2088
+ by: z.ZodEnum<{
2089
+ operator: "operator";
2090
+ host: "host";
2091
+ }>;
2092
+ settled: z.ZodNumber;
2093
+ reasonLength: z.ZodNumber;
2029
2094
  }, z.core.$strict> | z.ZodObject<{
2030
2095
  digest: z.ZodString;
2031
2096
  generation: z.ZodNumber;
@@ -2149,7 +2214,7 @@ export declare const publishedSchemas: {
2149
2214
  workId: z.ZodOptional<z.ZodString>;
2150
2215
  runId: z.ZodOptional<z.ZodString>;
2151
2216
  attempt: z.ZodOptional<z.ZodNumber>;
2152
- type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "policy.applied" | "policy.reconfigure" | "input.requested" | "input.answered" | "input.applied" | "input.closed" | "input.stale" | "input.delivered" | "attempt.assumptions" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
2217
+ type: z.ZodLiteral<"graph.registered" | "graph.reviewed" | "graph.approved" | "work.ready" | "work.held" | "attempt.claimed" | "attempt.phase" | "attempt.gate" | "attempt.review" | "attempt.stage" | "attempt.liveness" | "attempt.failed" | "attempt.diagnosed" | "attempt.expired" | "attempt.cancelled" | "attempt.recovered" | "work.accepted" | "work.retried" | "work.cancelled" | "work.blocked" | "control.paused" | "control.resumed" | "controller.acquired" | "base.moved" | "controller.released" | "budget.blocked" | "corpus.adopted" | "work.recovery" | "joint.started" | "joint.liveness" | "joint.finished" | "joint.budget-reset" | "policy.applied" | "policy.reconfigure" | "input.requested" | "input.answered" | "input.applied" | "input.closed" | "input.stale" | "input.delivered" | "attempt.assumptions" | "delivery.pending" | "delivery.delivered" | "delivery.failed" | "delivery.conflict" | "delivery.uncertain">;
2153
2218
  payload: z.ZodObject<{
2154
2219
  digest: z.ZodString;
2155
2220
  orders: z.ZodNumber;
@@ -2217,6 +2282,7 @@ export declare const publishedSchemas: {
2217
2282
  passed: z.ZodBoolean;
2218
2283
  evidenceId: z.ZodString;
2219
2284
  consumer: z.ZodOptional<z.ZodString>;
2285
+ notApplicable: z.ZodOptional<z.ZodLiteral<true>>;
2220
2286
  recheck: z.ZodOptional<z.ZodObject<{
2221
2287
  of: z.ZodString;
2222
2288
  outcome: z.ZodEnum<{
@@ -2514,6 +2580,16 @@ export declare const publishedSchemas: {
2514
2580
  }>;
2515
2581
  manifestDigest: z.ZodOptional<z.ZodString>;
2516
2582
  error: z.ZodOptional<z.ZodString>;
2583
+ interrupted: z.ZodOptional<z.ZodLiteral<true>>;
2584
+ }, z.core.$strict> | z.ZodObject<{
2585
+ resetId: z.ZodString;
2586
+ workIds: z.ZodArray<z.ZodString>;
2587
+ by: z.ZodEnum<{
2588
+ operator: "operator";
2589
+ host: "host";
2590
+ }>;
2591
+ settled: z.ZodNumber;
2592
+ reasonLength: z.ZodNumber;
2517
2593
  }, z.core.$strict> | z.ZodObject<{
2518
2594
  digest: z.ZodString;
2519
2595
  generation: z.ZodNumber;
@@ -2753,6 +2829,7 @@ export declare const publishedSchemas: {
2753
2829
  }, z.core.$strict>>>;
2754
2830
  manifestDigest: z.ZodOptional<z.ZodString>;
2755
2831
  error: z.ZodString;
2832
+ interrupted: z.ZodOptional<z.ZodLiteral<true>>;
2756
2833
  apiVersion: z.ZodLiteral<"devcontour-harness/v1alpha1">;
2757
2834
  id: z.ZodString;
2758
2835
  startedAt: z.ZodISODateTime;
@@ -3485,6 +3562,7 @@ export declare const publishedSchemas: {
3485
3562
  kind: z.ZodEnum<{
3486
3563
  review: "review";
3487
3564
  test: "test";
3565
+ "not-applicable": "not-applicable";
3488
3566
  }>;
3489
3567
  phase: z.ZodEnum<{
3490
3568
  candidate: "candidate";
@@ -3725,6 +3803,18 @@ export declare const publishedSchemas: {
3725
3803
  skippedMore: z.ZodOptional<z.ZodNumber>;
3726
3804
  }, z.core.$strict>>;
3727
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>>;
3728
3818
  alreadySatisfied: z.ZodOptional<z.ZodObject<{
3729
3819
  gates: z.ZodArray<z.ZodString>;
3730
3820
  evidence: z.ZodString;
@@ -3818,6 +3908,7 @@ export declare const publishedSchemas: {
3818
3908
  }, z.core.$strict>>>;
3819
3909
  manifestDigest: z.ZodOptional<z.ZodString>;
3820
3910
  error: z.ZodString;
3911
+ interrupted: z.ZodOptional<z.ZodLiteral<true>>;
3821
3912
  apiVersion: z.ZodLiteral<"devcontour-harness/v1alpha1">;
3822
3913
  id: z.ZodString;
3823
3914
  startedAt: z.ZodISODateTime;
@@ -4637,6 +4728,10 @@ export declare const publishedSchemas: {
4637
4728
  host: z.ZodNumber;
4638
4729
  controller: z.ZodNumber;
4639
4730
  }, z.core.$strict>;
4731
+ jointResets: z.ZodOptional<z.ZodObject<{
4732
+ operator: z.ZodNumber;
4733
+ host: z.ZodNumber;
4734
+ }, z.core.$strict>>;
4640
4735
  baseMovesBound: z.ZodLiteral<"lower">;
4641
4736
  gaps: z.ZodNumber;
4642
4737
  }, z.core.$strict>>;
@@ -285,6 +285,10 @@ export declare const valueReportSchema: z.ZodObject<{
285
285
  host: z.ZodNumber;
286
286
  controller: z.ZodNumber;
287
287
  }, z.core.$strict>;
288
+ jointResets: z.ZodOptional<z.ZodObject<{
289
+ operator: z.ZodNumber;
290
+ host: z.ZodNumber;
291
+ }, z.core.$strict>>;
288
292
  baseMovesBound: z.ZodLiteral<"lower">;
289
293
  gaps: z.ZodNumber;
290
294
  }, z.core.$strict>>;
@@ -904,6 +908,10 @@ export declare const reportDataSchema: z.ZodUnion<readonly [z.ZodObject<{
904
908
  host: z.ZodNumber;
905
909
  controller: z.ZodNumber;
906
910
  }, z.core.$strict>;
911
+ jointResets: z.ZodOptional<z.ZodObject<{
912
+ operator: z.ZodNumber;
913
+ host: z.ZodNumber;
914
+ }, z.core.$strict>>;
907
915
  baseMovesBound: z.ZodLiteral<"lower">;
908
916
  gaps: z.ZodNumber;
909
917
  }, z.core.$strict>>;
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { baseMoveActors, cancelActors, environmentCauses, retryActors } from "./events.js";
3
- import { failureKindSchema, pauseReasons } from "./execution.js";
3
+ import { failureKindSchema, jointResetActors, pauseReasons } from "./execution.js";
4
4
  import { isoTimeSchema } from "./primitives.js";
5
5
  /**
6
6
  * Отчёт об эффекте harness (`harness report`, `valueReport`): что дали
@@ -288,6 +288,12 @@ export const valueReportSchema = z.strictObject({
288
288
  /** Отмены поручений без активной попытки (их `attempt.cancelled` нет). */
289
289
  cancelledWithoutAttempt: count,
290
290
  baseMoves: actorCounts(baseMoveActors),
291
+ /**
292
+ * Явные сбросы бюджета совместных проверок (`joint.budget-reset`)
293
+ * по актёру. Событие пишется с версии, где появился сброс: до неё
294
+ * сбросов не было, число точное (нет у отчётов прежних версий).
295
+ */
296
+ jointResets: actorCounts(jointResetActors).optional(),
291
297
  /** Сдвиги базы — всегда нижняя граница: перенос вне `fencedRefMove` не пишется. */
292
298
  baseMovesBound: z.literal('lower'),
293
299
  /**
@@ -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";
@@ -1211,6 +1302,7 @@ export declare const jointFailedSchema: z.ZodObject<{
1211
1302
  }, z.core.$strict>>>;
1212
1303
  manifestDigest: z.ZodOptional<z.ZodString>;
1213
1304
  error: z.ZodString;
1305
+ interrupted: z.ZodOptional<z.ZodLiteral<true>>;
1214
1306
  apiVersion: z.ZodLiteral<"devcontour-harness/v1alpha1">;
1215
1307
  id: z.ZodString;
1216
1308
  startedAt: z.ZodISODateTime;
@@ -1414,6 +1506,7 @@ export declare const jointVerificationSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1414
1506
  }, z.core.$strict>>>;
1415
1507
  manifestDigest: z.ZodOptional<z.ZodString>;
1416
1508
  error: z.ZodString;
1509
+ interrupted: z.ZodOptional<z.ZodLiteral<true>>;
1417
1510
  apiVersion: z.ZodLiteral<"devcontour-harness/v1alpha1">;
1418
1511
  id: z.ZodString;
1419
1512
  startedAt: z.ZodISODateTime;
@@ -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,
@@ -362,6 +392,12 @@ export const jointFailedSchema = z.strictObject({
362
392
  manifest: jointManifestSchema.optional(),
363
393
  manifestDigest: digestSchema.optional(),
364
394
  error: z.string().min(1),
395
+ /**
396
+ * Проверку прервали до результата gates: остановка хоста или потеря
397
+ * владения. Ставится только без evidence; такая проверка не тратит предел
398
+ * совместных проверок набора (у прежних записей поля нет).
399
+ */
400
+ interrupted: z.literal(true).optional(),
365
401
  });
366
402
  export const jointPassedSchema = z.strictObject({
367
403
  ...jointCommon,
@@ -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;
@@ -164,6 +164,7 @@ export declare class Harness {
164
164
  tree: string;
165
165
  }> | undefined;
166
166
  manifestDigest?: string | undefined;
167
+ interrupted?: true | undefined;
167
168
  impact?: {
168
169
  changed: string[];
169
170
  affected: string[];
@@ -3638,6 +3639,10 @@ export declare class Harness {
3638
3639
  };
3639
3640
  baseMovesBound: "lower";
3640
3641
  gaps: number;
3642
+ jointResets?: {
3643
+ operator: number;
3644
+ host: number;
3645
+ } | undefined;
3641
3646
  } | null;
3642
3647
  };
3643
3648
  approvals: {
@@ -3990,7 +3995,7 @@ export declare class Harness {
3990
3995
  };
3991
3996
  evidence: {
3992
3997
  id: string;
3993
- kind: "check" | "review" | "test" | "property" | "consumer";
3998
+ kind: "check" | "review" | "test" | "property" | "consumer" | "not-applicable";
3994
3999
  phase: "candidate" | "integration";
3995
4000
  gate: string;
3996
4001
  sha: string;
@@ -4016,6 +4021,17 @@ export declare class Harness {
4016
4021
  } | undefined;
4017
4022
  } | undefined;
4018
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;
4019
4035
  reviewer?: {
4020
4036
  runtime: "codex" | "claude" | "fixture";
4021
4037
  sameVendor: boolean;
@@ -4131,7 +4147,7 @@ export declare class Harness {
4131
4147
  };
4132
4148
  evidence: {
4133
4149
  id: string;
4134
- kind: "check" | "review" | "test" | "property" | "consumer";
4150
+ kind: "check" | "review" | "test" | "property" | "consumer" | "not-applicable";
4135
4151
  phase: "candidate" | "integration";
4136
4152
  gate: string;
4137
4153
  sha: string;
@@ -4157,6 +4173,17 @@ export declare class Harness {
4157
4173
  } | undefined;
4158
4174
  } | undefined;
4159
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;
4160
4187
  reviewer?: {
4161
4188
  runtime: "codex" | "claude" | "fixture";
4162
4189
  sameVendor: boolean;