devcontour-harness 0.1.0-alpha.26 → 0.1.0-alpha.28

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 (69) hide show
  1. package/README.md +15 -2
  2. package/docs/architecture.md +59 -0
  3. package/docs/compatibility.md +25 -12
  4. package/docs/connectors.md +5 -2
  5. package/docs/contracts.md +80 -25
  6. package/docs/release-notes/0.1.0-alpha.27.md +36 -0
  7. package/docs/release-notes/0.1.0-alpha.28.md +37 -0
  8. package/docs/review-protocol.md +10 -4
  9. package/docs/toolchains.md +83 -0
  10. package/docs/upgrade.md +22 -0
  11. package/lib/cli.js +13 -0
  12. package/lib/contracts/cli.d.ts +147 -19
  13. package/lib/contracts/cli.js +66 -0
  14. package/lib/contracts/diagnosis.d.ts +1 -1
  15. package/lib/contracts/events.d.ts +6 -6
  16. package/lib/contracts/execution.d.ts +268 -16
  17. package/lib/contracts/execution.js +3 -1
  18. package/lib/contracts/policy.d.ts +37 -5
  19. package/lib/contracts/policy.js +42 -2
  20. package/lib/contracts/profiles.d.ts +2 -0
  21. package/lib/contracts/published.d.ts +226 -20
  22. package/lib/contracts/result.d.ts +268 -12
  23. package/lib/contracts/result.js +66 -0
  24. package/lib/control/harness.d.ts +64 -7
  25. package/lib/control/harness.js +4 -0
  26. package/lib/control/recovery.d.ts +1 -1
  27. package/lib/control/review.js +6 -1
  28. package/lib/engine/engine.d.ts +117 -12
  29. package/lib/engine/joint-runner.d.ts +96 -6
  30. package/lib/engine/joint-runner.js +47 -1
  31. package/lib/engine/runner.d.ts +29 -0
  32. package/lib/engine/runner.js +200 -2
  33. package/lib/engine/worktree-cleanup.d.ts +131 -0
  34. package/lib/engine/worktree-cleanup.js +520 -0
  35. package/lib/environment/isolation.d.ts +1 -0
  36. package/lib/environment/isolation.js +2 -1
  37. package/lib/environment/os-tools.d.ts +4 -2
  38. package/lib/environment/os-tools.js +4 -2
  39. package/lib/environment/process.d.ts +5 -0
  40. package/lib/environment/process.js +40 -17
  41. package/lib/environment/resources.d.ts +9 -0
  42. package/lib/environment/resources.js +24 -0
  43. package/lib/index.d.ts +1 -0
  44. package/lib/index.js +1 -0
  45. package/lib/integrations/connector/commands.d.ts +2 -1
  46. package/lib/integrations/connector/commands.js +10 -2
  47. package/lib/integrations/connector/store.d.ts +1 -1
  48. package/lib/integrations/connector/store.js +11 -6
  49. package/lib/profiles/resolve.d.ts +8 -0
  50. package/lib/storage/document.d.ts +132 -12
  51. package/lib/toolchains/inspect.d.ts +1 -1
  52. package/lib/toolchains/inspect.js +29 -1
  53. package/lib/toolchains/probe.d.ts +16 -0
  54. package/lib/toolchains/probe.js +20 -0
  55. package/lib/verification/confirm.d.ts +3 -1
  56. package/lib/verification/confirm.js +16 -2
  57. package/lib/verification/dependencies.d.ts +3 -0
  58. package/lib/verification/dependencies.js +11 -0
  59. package/lib/verification/dependency-store.d.ts +117 -0
  60. package/lib/verification/dependency-store.js +811 -0
  61. package/lib/verification/gate-artifacts.d.ts +34 -0
  62. package/lib/verification/gate-artifacts.js +303 -0
  63. package/lib/verification/gates-at.js +18 -0
  64. package/lib/verification/gates.js +15 -0
  65. package/lib/verification/joint.d.ts +48 -3
  66. package/package.json +1 -1
  67. package/schemas/execution-document.schema.json +372 -0
  68. package/schemas/execution-policy.schema.json +56 -0
  69. package/schemas/joint-verification.schema.json +279 -0
@@ -3013,6 +3013,99 @@
3013
3013
  ],
3014
3014
  "additionalProperties": false
3015
3015
  },
3016
+ "artifactFiles": {
3017
+ "type": "object",
3018
+ "properties": {
3019
+ "dir": {
3020
+ "type": "string",
3021
+ "minLength": 1
3022
+ },
3023
+ "files": {
3024
+ "maxItems": 64,
3025
+ "type": "array",
3026
+ "items": {
3027
+ "type": "object",
3028
+ "properties": {
3029
+ "path": {
3030
+ "type": "string",
3031
+ "minLength": 1,
3032
+ "maxLength": 1000
3033
+ },
3034
+ "sha256": {
3035
+ "type": "string",
3036
+ "pattern": "^[a-f0-9]{64}$"
3037
+ },
3038
+ "bytes": {
3039
+ "type": "integer",
3040
+ "minimum": 0,
3041
+ "maximum": 9007199254740991
3042
+ },
3043
+ "redacted": {
3044
+ "type": "boolean",
3045
+ "const": true
3046
+ }
3047
+ },
3048
+ "required": [
3049
+ "path",
3050
+ "sha256",
3051
+ "bytes"
3052
+ ],
3053
+ "additionalProperties": false
3054
+ }
3055
+ },
3056
+ "skipped": {
3057
+ "maxItems": 100,
3058
+ "type": "array",
3059
+ "items": {
3060
+ "type": "object",
3061
+ "properties": {
3062
+ "path": {
3063
+ "type": "string",
3064
+ "minLength": 1,
3065
+ "maxLength": 1000
3066
+ },
3067
+ "reason": {
3068
+ "type": "string",
3069
+ "enum": [
3070
+ "missing",
3071
+ "symlink",
3072
+ "outside",
3073
+ "not-regular",
3074
+ "hardlink",
3075
+ "secret",
3076
+ "extension",
3077
+ "file-limit",
3078
+ "total-limit",
3079
+ "count-limit",
3080
+ "scan-limit",
3081
+ "copy-failed"
3082
+ ]
3083
+ },
3084
+ "detail": {
3085
+ "type": "string",
3086
+ "maxLength": 500
3087
+ }
3088
+ },
3089
+ "required": [
3090
+ "path",
3091
+ "reason"
3092
+ ],
3093
+ "additionalProperties": false
3094
+ }
3095
+ },
3096
+ "skippedMore": {
3097
+ "type": "integer",
3098
+ "exclusiveMinimum": 0,
3099
+ "maximum": 9007199254740991
3100
+ }
3101
+ },
3102
+ "required": [
3103
+ "dir",
3104
+ "files",
3105
+ "skipped"
3106
+ ],
3107
+ "additionalProperties": false
3108
+ },
3016
3109
  "checks": {
3017
3110
  "type": "string",
3018
3111
  "pattern": "^[a-f0-9]{64}$"
@@ -3281,6 +3374,99 @@
3281
3374
  "additionalProperties": false
3282
3375
  }
3283
3376
  },
3377
+ "artifactFiles": {
3378
+ "type": "object",
3379
+ "properties": {
3380
+ "dir": {
3381
+ "type": "string",
3382
+ "minLength": 1
3383
+ },
3384
+ "files": {
3385
+ "maxItems": 64,
3386
+ "type": "array",
3387
+ "items": {
3388
+ "type": "object",
3389
+ "properties": {
3390
+ "path": {
3391
+ "type": "string",
3392
+ "minLength": 1,
3393
+ "maxLength": 1000
3394
+ },
3395
+ "sha256": {
3396
+ "type": "string",
3397
+ "pattern": "^[a-f0-9]{64}$"
3398
+ },
3399
+ "bytes": {
3400
+ "type": "integer",
3401
+ "minimum": 0,
3402
+ "maximum": 9007199254740991
3403
+ },
3404
+ "redacted": {
3405
+ "type": "boolean",
3406
+ "const": true
3407
+ }
3408
+ },
3409
+ "required": [
3410
+ "path",
3411
+ "sha256",
3412
+ "bytes"
3413
+ ],
3414
+ "additionalProperties": false
3415
+ }
3416
+ },
3417
+ "skipped": {
3418
+ "maxItems": 100,
3419
+ "type": "array",
3420
+ "items": {
3421
+ "type": "object",
3422
+ "properties": {
3423
+ "path": {
3424
+ "type": "string",
3425
+ "minLength": 1,
3426
+ "maxLength": 1000
3427
+ },
3428
+ "reason": {
3429
+ "type": "string",
3430
+ "enum": [
3431
+ "missing",
3432
+ "symlink",
3433
+ "outside",
3434
+ "not-regular",
3435
+ "hardlink",
3436
+ "secret",
3437
+ "extension",
3438
+ "file-limit",
3439
+ "total-limit",
3440
+ "count-limit",
3441
+ "scan-limit",
3442
+ "copy-failed"
3443
+ ]
3444
+ },
3445
+ "detail": {
3446
+ "type": "string",
3447
+ "maxLength": 500
3448
+ }
3449
+ },
3450
+ "required": [
3451
+ "path",
3452
+ "reason"
3453
+ ],
3454
+ "additionalProperties": false
3455
+ }
3456
+ },
3457
+ "skippedMore": {
3458
+ "type": "integer",
3459
+ "exclusiveMinimum": 0,
3460
+ "maximum": 9007199254740991
3461
+ }
3462
+ },
3463
+ "required": [
3464
+ "dir",
3465
+ "files",
3466
+ "skipped"
3467
+ ],
3468
+ "additionalProperties": false
3469
+ },
3284
3470
  "durationMs": {
3285
3471
  "type": "number",
3286
3472
  "minimum": 0
@@ -3495,6 +3681,99 @@
3495
3681
  "additionalProperties": false
3496
3682
  }
3497
3683
  },
3684
+ "artifactFiles": {
3685
+ "type": "object",
3686
+ "properties": {
3687
+ "dir": {
3688
+ "type": "string",
3689
+ "minLength": 1
3690
+ },
3691
+ "files": {
3692
+ "maxItems": 64,
3693
+ "type": "array",
3694
+ "items": {
3695
+ "type": "object",
3696
+ "properties": {
3697
+ "path": {
3698
+ "type": "string",
3699
+ "minLength": 1,
3700
+ "maxLength": 1000
3701
+ },
3702
+ "sha256": {
3703
+ "type": "string",
3704
+ "pattern": "^[a-f0-9]{64}$"
3705
+ },
3706
+ "bytes": {
3707
+ "type": "integer",
3708
+ "minimum": 0,
3709
+ "maximum": 9007199254740991
3710
+ },
3711
+ "redacted": {
3712
+ "type": "boolean",
3713
+ "const": true
3714
+ }
3715
+ },
3716
+ "required": [
3717
+ "path",
3718
+ "sha256",
3719
+ "bytes"
3720
+ ],
3721
+ "additionalProperties": false
3722
+ }
3723
+ },
3724
+ "skipped": {
3725
+ "maxItems": 100,
3726
+ "type": "array",
3727
+ "items": {
3728
+ "type": "object",
3729
+ "properties": {
3730
+ "path": {
3731
+ "type": "string",
3732
+ "minLength": 1,
3733
+ "maxLength": 1000
3734
+ },
3735
+ "reason": {
3736
+ "type": "string",
3737
+ "enum": [
3738
+ "missing",
3739
+ "symlink",
3740
+ "outside",
3741
+ "not-regular",
3742
+ "hardlink",
3743
+ "secret",
3744
+ "extension",
3745
+ "file-limit",
3746
+ "total-limit",
3747
+ "count-limit",
3748
+ "scan-limit",
3749
+ "copy-failed"
3750
+ ]
3751
+ },
3752
+ "detail": {
3753
+ "type": "string",
3754
+ "maxLength": 500
3755
+ }
3756
+ },
3757
+ "required": [
3758
+ "path",
3759
+ "reason"
3760
+ ],
3761
+ "additionalProperties": false
3762
+ }
3763
+ },
3764
+ "skippedMore": {
3765
+ "type": "integer",
3766
+ "exclusiveMinimum": 0,
3767
+ "maximum": 9007199254740991
3768
+ }
3769
+ },
3770
+ "required": [
3771
+ "dir",
3772
+ "files",
3773
+ "skipped"
3774
+ ],
3775
+ "additionalProperties": false
3776
+ },
3498
3777
  "durationMs": {
3499
3778
  "type": "number",
3500
3779
  "minimum": 0
@@ -3720,6 +3999,99 @@
3720
3999
  "additionalProperties": false
3721
4000
  }
3722
4001
  },
4002
+ "artifactFiles": {
4003
+ "type": "object",
4004
+ "properties": {
4005
+ "dir": {
4006
+ "type": "string",
4007
+ "minLength": 1
4008
+ },
4009
+ "files": {
4010
+ "maxItems": 64,
4011
+ "type": "array",
4012
+ "items": {
4013
+ "type": "object",
4014
+ "properties": {
4015
+ "path": {
4016
+ "type": "string",
4017
+ "minLength": 1,
4018
+ "maxLength": 1000
4019
+ },
4020
+ "sha256": {
4021
+ "type": "string",
4022
+ "pattern": "^[a-f0-9]{64}$"
4023
+ },
4024
+ "bytes": {
4025
+ "type": "integer",
4026
+ "minimum": 0,
4027
+ "maximum": 9007199254740991
4028
+ },
4029
+ "redacted": {
4030
+ "type": "boolean",
4031
+ "const": true
4032
+ }
4033
+ },
4034
+ "required": [
4035
+ "path",
4036
+ "sha256",
4037
+ "bytes"
4038
+ ],
4039
+ "additionalProperties": false
4040
+ }
4041
+ },
4042
+ "skipped": {
4043
+ "maxItems": 100,
4044
+ "type": "array",
4045
+ "items": {
4046
+ "type": "object",
4047
+ "properties": {
4048
+ "path": {
4049
+ "type": "string",
4050
+ "minLength": 1,
4051
+ "maxLength": 1000
4052
+ },
4053
+ "reason": {
4054
+ "type": "string",
4055
+ "enum": [
4056
+ "missing",
4057
+ "symlink",
4058
+ "outside",
4059
+ "not-regular",
4060
+ "hardlink",
4061
+ "secret",
4062
+ "extension",
4063
+ "file-limit",
4064
+ "total-limit",
4065
+ "count-limit",
4066
+ "scan-limit",
4067
+ "copy-failed"
4068
+ ]
4069
+ },
4070
+ "detail": {
4071
+ "type": "string",
4072
+ "maxLength": 500
4073
+ }
4074
+ },
4075
+ "required": [
4076
+ "path",
4077
+ "reason"
4078
+ ],
4079
+ "additionalProperties": false
4080
+ }
4081
+ },
4082
+ "skippedMore": {
4083
+ "type": "integer",
4084
+ "exclusiveMinimum": 0,
4085
+ "maximum": 9007199254740991
4086
+ }
4087
+ },
4088
+ "required": [
4089
+ "dir",
4090
+ "files",
4091
+ "skipped"
4092
+ ],
4093
+ "additionalProperties": false
4094
+ },
3723
4095
  "durationMs": {
3724
4096
  "type": "number",
3725
4097
  "minimum": 0
@@ -368,6 +368,17 @@
368
368
  "path"
369
369
  ],
370
370
  "additionalProperties": false
371
+ },
372
+ "artifacts": {
373
+ "minItems": 1,
374
+ "maxItems": 16,
375
+ "type": "array",
376
+ "items": {
377
+ "type": "string",
378
+ "minLength": 1,
379
+ "maxLength": 500,
380
+ "pattern": "^(?!\\/)(?!.*[\\\\:*?\\[\\]\\x00])(?!(?:.*\\/)?\\.{1,2}(?:\\/|$))(?=.{1,500}$).+$"
381
+ }
371
382
  }
372
383
  },
373
384
  "required": [
@@ -453,6 +464,17 @@
453
464
  "path"
454
465
  ],
455
466
  "additionalProperties": false
467
+ },
468
+ "artifacts": {
469
+ "minItems": 1,
470
+ "maxItems": 16,
471
+ "type": "array",
472
+ "items": {
473
+ "type": "string",
474
+ "minLength": 1,
475
+ "maxLength": 500,
476
+ "pattern": "^(?!\\/)(?!.*[\\\\:*?\\[\\]\\x00])(?!(?:.*\\/)?\\.{1,2}(?:\\/|$))(?=.{1,500}$).+$"
477
+ }
456
478
  }
457
479
  },
458
480
  "required": [
@@ -677,6 +699,40 @@
677
699
  "additionalProperties": false
678
700
  }
679
701
  },
702
+ "dependencyStore": {
703
+ "type": "object",
704
+ "properties": {
705
+ "manager": {
706
+ "type": "string",
707
+ "enum": [
708
+ "pnpm"
709
+ ]
710
+ },
711
+ "lockfile": {
712
+ "default": "pnpm-lock.yaml",
713
+ "type": "string",
714
+ "minLength": 1,
715
+ "maxLength": 500,
716
+ "pattern": "^(?!\\/)(?!.*[\\\\:*?\\[\\]\\x00])(?!(?:.*\\/)?\\.{1,2}(?:\\/|$))(?=.{1,500}$).+$"
717
+ },
718
+ "maxBytes": {
719
+ "default": 8589934592,
720
+ "type": "integer",
721
+ "minimum": 1048576,
722
+ "maximum": 9007199254740991
723
+ },
724
+ "timeoutMs": {
725
+ "default": 600000,
726
+ "type": "integer",
727
+ "exclusiveMinimum": 0,
728
+ "maximum": 3600000
729
+ }
730
+ },
731
+ "required": [
732
+ "manager"
733
+ ],
734
+ "additionalProperties": false
735
+ },
680
736
  "dependencyBuild": {
681
737
  "default": [],
682
738
  "type": "array",