devcontour-harness 0.1.0-alpha.34 → 0.1.0-alpha.35

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 (57) hide show
  1. package/README.md +8 -2
  2. package/docs/contracts.md +54 -8
  3. package/docs/release-notes/0.1.0-alpha.35.md +27 -0
  4. package/docs/upgrade.md +35 -0
  5. package/lib/agents/cli-adapter.d.ts +10 -1
  6. package/lib/agents/cli-adapter.js +38 -7
  7. package/lib/agents/usage.d.ts +9 -0
  8. package/lib/agents/usage.js +22 -1
  9. package/lib/contracts/cli.d.ts +49 -1
  10. package/lib/contracts/cli.js +1 -0
  11. package/lib/contracts/diagnosis.d.ts +3 -1
  12. package/lib/contracts/diagnosis.js +1 -0
  13. package/lib/contracts/errors.d.ts +3 -1
  14. package/lib/contracts/errors.js +2 -0
  15. package/lib/contracts/events.d.ts +15 -0
  16. package/lib/contracts/execution.d.ts +32 -1
  17. package/lib/contracts/execution.js +19 -0
  18. package/lib/contracts/failure.d.ts +7 -3
  19. package/lib/contracts/failure.js +6 -2
  20. package/lib/contracts/handoff.d.ts +9 -0
  21. package/lib/contracts/planning.d.ts +2 -0
  22. package/lib/contracts/ports.d.ts +10 -2
  23. package/lib/contracts/published.d.ts +28 -0
  24. package/lib/contracts/repair-policy.d.ts +10 -1
  25. package/lib/contracts/repair-policy.js +18 -0
  26. package/lib/contracts/report.d.ts +2 -0
  27. package/lib/contracts/result.d.ts +2 -0
  28. package/lib/control/harness.d.ts +10 -10
  29. package/lib/control/recovery.d.ts +1 -1
  30. package/lib/control/status.d.ts +8 -8
  31. package/lib/engine/classify.js +1 -1
  32. package/lib/engine/engine.d.ts +9 -7
  33. package/lib/engine/engine.js +3 -0
  34. package/lib/engine/failure.d.ts +1 -1
  35. package/lib/engine/failure.js +1 -1
  36. package/lib/engine/prompt.js +11 -1
  37. package/lib/engine/property-recovery.js +2 -0
  38. package/lib/engine/repair.js +4 -2
  39. package/lib/engine/reuse.js +2 -0
  40. package/lib/engine/runner.js +9 -0
  41. package/lib/explain/state.d.ts +1 -1
  42. package/lib/explain/state.js +10 -4
  43. package/lib/index.d.ts +1 -1
  44. package/lib/index.js +1 -1
  45. package/lib/projections/stop.d.ts +3 -1
  46. package/lib/projections/stop.js +30 -2
  47. package/lib/report/compute.js +1 -0
  48. package/lib/report/document.js +1 -1
  49. package/lib/storage/document.d.ts +8 -6
  50. package/package.json +1 -1
  51. package/schemas/execution-document.schema.json +11 -0
  52. package/schemas/handoff-pack.schema.json +9 -0
  53. package/schemas/result-envelope.schema.json +1 -0
  54. package/schemas/run-event.schema.json +3 -0
  55. package/schemas/run-result.schema.json +1 -0
  56. package/schemas/stop-diagnosis.schema.json +2 -0
  57. package/schemas/value-report.schema.json +1 -0
@@ -211,7 +211,7 @@ export declare class DocumentView {
211
211
  activeRunId?: string | undefined;
212
212
  resultSha?: string | undefined;
213
213
  failure?: string | undefined;
214
- failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
214
+ failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "context-exhausted" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
215
215
  failureFingerprint?: string | undefined;
216
216
  approvedAt?: string | undefined;
217
217
  approvedDigest?: string | undefined;
@@ -359,7 +359,7 @@ export declare class DocumentView {
359
359
  activeRunId?: string | undefined;
360
360
  resultSha?: string | undefined;
361
361
  failure?: string | undefined;
362
- failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
362
+ failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "context-exhausted" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
363
363
  failureFingerprint?: string | undefined;
364
364
  approvedAt?: string | undefined;
365
365
  approvedDigest?: string | undefined;
@@ -659,7 +659,8 @@ export declare class DocumentView {
659
659
  integrationSha?: string | undefined;
660
660
  error?: string | undefined;
661
661
  blocked?: boolean | undefined;
662
- failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
662
+ failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "context-exhausted" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
663
+ contextLimit?: "prompt-too-long" | "blocking-limit" | undefined;
663
664
  failureFingerprint?: string | undefined;
664
665
  requiredGates?: string[] | undefined;
665
666
  consumers?: {
@@ -749,7 +750,7 @@ export declare class DocumentView {
749
750
  kind: "candidate" | "unfinished";
750
751
  applied: boolean;
751
752
  files: string[];
752
- reason?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
753
+ reason?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "context-exhausted" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
753
754
  respecified?: boolean | undefined;
754
755
  } | undefined;
755
756
  callsRecorded?: true | undefined;
@@ -999,7 +1000,8 @@ export declare class DocumentView {
999
1000
  integrationSha?: string | undefined;
1000
1001
  error?: string | undefined;
1001
1002
  blocked?: boolean | undefined;
1002
- failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
1003
+ failureKind?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "context-exhausted" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
1004
+ contextLimit?: "prompt-too-long" | "blocking-limit" | undefined;
1003
1005
  failureFingerprint?: string | undefined;
1004
1006
  requiredGates?: string[] | undefined;
1005
1007
  consumers?: {
@@ -1089,7 +1091,7 @@ export declare class DocumentView {
1089
1091
  kind: "candidate" | "unfinished";
1090
1092
  applied: boolean;
1091
1093
  files: string[];
1092
- reason?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
1094
+ reason?: "gate" | "unknown" | "review" | "cancelled" | "environment" | "timeout" | "provider-auth" | "stalled" | "context-exhausted" | "stale-base" | "empty-result" | "unfinished" | "scope-violation" | "review-protocol" | "merge" | "budget" | "needs-lead" | undefined;
1093
1095
  respecified?: boolean | undefined;
1094
1096
  } | undefined;
1095
1097
  callsRecorded?: true | undefined;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devcontour-harness",
3
- "version": "0.1.0-alpha.34",
3
+ "version": "0.1.0-alpha.35",
4
4
  "description": "Headless execution harness: work graph, isolated attempts, gates, independent reviews and accepted results.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -787,6 +787,7 @@
787
787
  "environment",
788
788
  "timeout",
789
789
  "stalled",
790
+ "context-exhausted",
790
791
  "stale-base",
791
792
  "empty-result",
792
793
  "unfinished",
@@ -1476,6 +1477,7 @@
1476
1477
  "environment",
1477
1478
  "timeout",
1478
1479
  "stalled",
1480
+ "context-exhausted",
1479
1481
  "stale-base",
1480
1482
  "empty-result",
1481
1483
  "unfinished",
@@ -1490,6 +1492,13 @@
1490
1492
  "unknown"
1491
1493
  ]
1492
1494
  },
1495
+ "contextLimit": {
1496
+ "type": "string",
1497
+ "enum": [
1498
+ "prompt-too-long",
1499
+ "blocking-limit"
1500
+ ]
1501
+ },
1493
1502
  "failureFingerprint": {
1494
1503
  "type": "string"
1495
1504
  },
@@ -1962,6 +1971,7 @@
1962
1971
  "environment",
1963
1972
  "timeout",
1964
1973
  "stalled",
1974
+ "context-exhausted",
1965
1975
  "stale-base",
1966
1976
  "empty-result",
1967
1977
  "unfinished",
@@ -4284,6 +4294,7 @@
4284
4294
  "environment",
4285
4295
  "timeout",
4286
4296
  "stalled",
4297
+ "context-exhausted",
4287
4298
  "stale-base",
4288
4299
  "empty-result",
4289
4300
  "unfinished",
@@ -140,6 +140,7 @@
140
140
  "environment",
141
141
  "timeout",
142
142
  "stalled",
143
+ "context-exhausted",
143
144
  "stale-base",
144
145
  "empty-result",
145
146
  "unfinished",
@@ -185,6 +186,7 @@
185
186
  "BUDGET_EXHAUSTED",
186
187
  "BUDGET_UNKNOWN",
187
188
  "ATTEMPTS_EXHAUSTED",
189
+ "CONTEXT_EXHAUSTED",
188
190
  "REVISION_CONFLICT",
189
191
  "CANCELLED",
190
192
  "NOT_FOUND",
@@ -497,6 +499,7 @@
497
499
  "environment",
498
500
  "timeout",
499
501
  "stalled",
502
+ "context-exhausted",
500
503
  "stale-base",
501
504
  "empty-result",
502
505
  "unfinished",
@@ -590,6 +593,7 @@
590
593
  "BUDGET_EXHAUSTED",
591
594
  "BUDGET_UNKNOWN",
592
595
  "ATTEMPTS_EXHAUSTED",
596
+ "CONTEXT_EXHAUSTED",
593
597
  "REVISION_CONFLICT",
594
598
  "CANCELLED",
595
599
  "NOT_FOUND",
@@ -744,6 +748,7 @@
744
748
  "BUDGET_EXHAUSTED",
745
749
  "BUDGET_UNKNOWN",
746
750
  "ATTEMPTS_EXHAUSTED",
751
+ "CONTEXT_EXHAUSTED",
747
752
  "REVISION_CONFLICT",
748
753
  "CANCELLED",
749
754
  "NOT_FOUND",
@@ -765,6 +770,7 @@
765
770
  "environment",
766
771
  "timeout",
767
772
  "stalled",
773
+ "context-exhausted",
768
774
  "stale-base",
769
775
  "empty-result",
770
776
  "unfinished",
@@ -971,6 +977,7 @@
971
977
  "environment",
972
978
  "timeout",
973
979
  "stalled",
980
+ "context-exhausted",
974
981
  "stale-base",
975
982
  "empty-result",
976
983
  "unfinished",
@@ -1011,6 +1018,7 @@
1011
1018
  "BUDGET_EXHAUSTED",
1012
1019
  "BUDGET_UNKNOWN",
1013
1020
  "ATTEMPTS_EXHAUSTED",
1021
+ "CONTEXT_EXHAUSTED",
1014
1022
  "REVISION_CONFLICT",
1015
1023
  "CANCELLED",
1016
1024
  "NOT_FOUND",
@@ -1307,6 +1315,7 @@
1307
1315
  "BUDGET_EXHAUSTED",
1308
1316
  "BUDGET_UNKNOWN",
1309
1317
  "ATTEMPTS_EXHAUSTED",
1318
+ "CONTEXT_EXHAUSTED",
1310
1319
  "REVISION_CONFLICT",
1311
1320
  "CANCELLED",
1312
1321
  "NOT_FOUND",
@@ -1529,6 +1529,7 @@
1529
1529
  "BUDGET_EXHAUSTED",
1530
1530
  "BUDGET_UNKNOWN",
1531
1531
  "ATTEMPTS_EXHAUSTED",
1532
+ "CONTEXT_EXHAUSTED",
1532
1533
  "REVISION_CONFLICT",
1533
1534
  "CANCELLED",
1534
1535
  "NOT_FOUND",
@@ -1089,6 +1089,7 @@
1089
1089
  "environment",
1090
1090
  "timeout",
1091
1091
  "stalled",
1092
+ "context-exhausted",
1092
1093
  "stale-base",
1093
1094
  "empty-result",
1094
1095
  "unfinished",
@@ -1177,6 +1178,7 @@
1177
1178
  "environment",
1178
1179
  "timeout",
1179
1180
  "stalled",
1181
+ "context-exhausted",
1180
1182
  "stale-base",
1181
1183
  "empty-result",
1182
1184
  "unfinished",
@@ -1772,6 +1774,7 @@
1772
1774
  "environment",
1773
1775
  "timeout",
1774
1776
  "stalled",
1777
+ "context-exhausted",
1775
1778
  "stale-base",
1776
1779
  "empty-result",
1777
1780
  "unfinished",
@@ -1522,6 +1522,7 @@
1522
1522
  "BUDGET_EXHAUSTED",
1523
1523
  "BUDGET_UNKNOWN",
1524
1524
  "ATTEMPTS_EXHAUSTED",
1525
+ "CONTEXT_EXHAUSTED",
1525
1526
  "REVISION_CONFLICT",
1526
1527
  "CANCELLED",
1527
1528
  "NOT_FOUND",
@@ -30,6 +30,7 @@
30
30
  "BUDGET_EXHAUSTED",
31
31
  "BUDGET_UNKNOWN",
32
32
  "ATTEMPTS_EXHAUSTED",
33
+ "CONTEXT_EXHAUSTED",
33
34
  "REVISION_CONFLICT",
34
35
  "CANCELLED",
35
36
  "NOT_FOUND",
@@ -51,6 +52,7 @@
51
52
  "environment",
52
53
  "timeout",
53
54
  "stalled",
55
+ "context-exhausted",
54
56
  "stale-base",
55
57
  "empty-result",
56
58
  "unfinished",
@@ -1176,6 +1176,7 @@
1176
1176
  "environment",
1177
1177
  "timeout",
1178
1178
  "stalled",
1179
+ "context-exhausted",
1179
1180
  "stale-base",
1180
1181
  "empty-result",
1181
1182
  "unfinished",