@kungfu-tech/buildchain 3.0.6-alpha.1 → 3.0.6-alpha.3

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 (75) hide show
  1. package/README.md +4 -4
  2. package/actions/promote-buildchain-ref/README.md +8 -0
  3. package/bin/buildchain.mjs +13 -1
  4. package/contracts/auditable-demo-scenario-v1.schema.json +52 -0
  5. package/contracts/release-candidate-recovery-v1.schema.json +102 -0
  6. package/dist/site/buildchain-contract.json +129 -34
  7. package/dist/site/buildchain-site.json +171 -45
  8. package/dist/site/capability-registry.json +5 -5
  9. package/dist/site/cli-registry.json +40 -4
  10. package/dist/site/controller-registry.json +56 -4
  11. package/dist/site/kfd-claims.json +184 -20
  12. package/dist/site/kfd-upstream-aggregate.json +1 -1
  13. package/dist/site/manual-registry.json +10 -10
  14. package/dist/site/node-api-registry.json +1242 -121
  15. package/dist/site/page-registry.json +157 -31
  16. package/dist/site/public-surface-audit.json +422 -21
  17. package/dist/site/publication-authority-registry.json +66 -1
  18. package/dist/site/publication-registry.json +4 -4
  19. package/dist/site/release-provenance.json +2 -0
  20. package/dist/site/site-manifest.json +14 -14
  21. package/dist/site/workflow-registry.json +197 -15
  22. package/docs/MAP.md +1 -0
  23. package/docs/auditable-demo.md +58 -11
  24. package/docs/aws-us-elastic-runner-burst-plane.md +23 -19
  25. package/docs/cli-reference.md +154 -0
  26. package/docs/dev-alpha-candidate-patrol.md +13 -5
  27. package/docs/dev-delivery-warrant.md +158 -0
  28. package/docs/node-api-reference.md +96 -38
  29. package/docs/publication-authority.md +11 -0
  30. package/docs/publish-transaction.md +10 -1
  31. package/docs/release-candidate.md +106 -12
  32. package/docs/release-governance.md +52 -0
  33. package/docs/reusable-build-surface.md +11 -1
  34. package/docs/shifu-gate-profiles.md +12 -1
  35. package/docs/versioning.md +2 -0
  36. package/package.json +3 -1
  37. package/packages/core/buildchain-contract.js +30 -2
  38. package/packages/core/buildchain-publication-authority.js +3 -1
  39. package/packages/core/channel-candidate.js +2 -21
  40. package/packages/core/channel-promotion-baseline.js +199 -0
  41. package/packages/core/dev-delivery-candidate-identity.js +94 -0
  42. package/packages/core/dev-delivery-common.js +73 -0
  43. package/packages/core/dev-delivery-proof.js +252 -0
  44. package/packages/core/dev-delivery-warrant-cancellation.js +94 -0
  45. package/packages/core/dev-delivery-warrant-settlement.js +73 -0
  46. package/packages/core/dev-delivery-warrant.js +591 -0
  47. package/packages/core/index.js +7 -0
  48. package/packages/core/release-candidate-recovery.js +386 -0
  49. package/scripts/auditable-demo-bundle-verification.mjs +148 -0
  50. package/scripts/auditable-demo-platform.mjs +86 -50
  51. package/scripts/auditable-demo-presentation.mjs +83 -0
  52. package/scripts/auditable-demo-renditions.mjs +264 -0
  53. package/scripts/auditable-demo.mjs +24 -30
  54. package/scripts/build-contract-core.mjs +58 -3
  55. package/scripts/buildchain-cli-help.mjs +8 -0
  56. package/scripts/buildchain-patrol.mjs +9 -0
  57. package/scripts/check-inventory.mjs +13 -2
  58. package/scripts/dev-alpha-candidate-patrol.mjs +45 -48
  59. package/scripts/dev-delivery-proof.mjs +193 -0
  60. package/scripts/dev-delivery-warrant.mjs +426 -0
  61. package/scripts/dev-pr-auto-merge.mjs +488 -46
  62. package/scripts/dev-pr-delivery-warrant.mjs +209 -0
  63. package/scripts/gate-profile-core.mjs +24 -0
  64. package/scripts/generate-site-bundle.mjs +2 -2
  65. package/scripts/git-fetch-process-tree.mjs +142 -0
  66. package/scripts/lifecycle-substage-evidence.mjs +274 -0
  67. package/scripts/locked-source-checkout.mjs +6 -3
  68. package/scripts/release-candidate-resolver.mjs +35 -3
  69. package/scripts/resolve-artifact-transfer-mode.mjs +9 -0
  70. package/scripts/resolve-build-contract.mjs +7 -0
  71. package/scripts/resume-from-candidate-run.mjs +498 -0
  72. package/scripts/route-offline-runners.mjs +1 -0
  73. package/scripts/run-lifecycle-core.mjs +9 -9
  74. package/scripts/shifu-gate-profile.mjs +10 -16
  75. package/scripts/site-capability-metadata.mjs +15 -0
@@ -1881,7 +1881,7 @@
1881
1881
  ],
1882
1882
  "source": {
1883
1883
  "path": "packages/core/buildchain-contract.js",
1884
- "line": 945
1884
+ "line": 973
1885
1885
  },
1886
1886
  "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
1887
1887
  "maturity": "stable",
@@ -1910,7 +1910,7 @@
1910
1910
  ],
1911
1911
  "source": {
1912
1912
  "path": "packages/core/buildchain-contract.js",
1913
- "line": 787
1913
+ "line": 815
1914
1914
  },
1915
1915
  "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
1916
1916
  "maturity": "stable",
@@ -1968,7 +1968,7 @@
1968
1968
  ],
1969
1969
  "source": {
1970
1970
  "path": "packages/core/buildchain-contract.js",
1971
- "line": 853
1971
+ "line": 881
1972
1972
  },
1973
1973
  "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
1974
1974
  "maturity": "stable",
@@ -1997,7 +1997,7 @@
1997
1997
  ],
1998
1998
  "source": {
1999
1999
  "path": "packages/core/buildchain-contract.js",
2000
- "line": 762
2000
+ "line": 790
2001
2001
  },
2002
2002
  "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
2003
2003
  "maturity": "stable",
@@ -2026,7 +2026,7 @@
2026
2026
  ],
2027
2027
  "source": {
2028
2028
  "path": "packages/core/buildchain-contract.js",
2029
- "line": 838
2029
+ "line": 866
2030
2030
  },
2031
2031
  "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
2032
2032
  "maturity": "stable",
@@ -2055,7 +2055,7 @@
2055
2055
  ],
2056
2056
  "source": {
2057
2057
  "path": "packages/core/buildchain-contract.js",
2058
- "line": 818
2058
+ "line": 846
2059
2059
  },
2060
2060
  "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
2061
2061
  "maturity": "stable",
@@ -2084,7 +2084,7 @@
2084
2084
  ],
2085
2085
  "source": {
2086
2086
  "path": "packages/core/buildchain-contract.js",
2087
- "line": 957
2087
+ "line": 985
2088
2088
  },
2089
2089
  "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
2090
2090
  "maturity": "stable",
@@ -3493,7 +3493,7 @@
3493
3493
  ],
3494
3494
  "source": {
3495
3495
  "path": "packages/core/buildchain-publication-authority.js",
3496
- "line": 54
3496
+ "line": 57
3497
3497
  },
3498
3498
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
3499
3499
  "maturity": "stable",
@@ -3522,7 +3522,7 @@
3522
3522
  ],
3523
3523
  "source": {
3524
3524
  "path": "packages/core/buildchain-publication-authority.js",
3525
- "line": 79
3525
+ "line": 81
3526
3526
  },
3527
3527
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
3528
3528
  "maturity": "stable",
@@ -3874,7 +3874,7 @@
3874
3874
  ],
3875
3875
  "source": {
3876
3876
  "path": "packages/core/channel-candidate.js",
3877
- "line": 5
3877
+ "line": 6
3878
3878
  },
3879
3879
  "example": "import { CHANNEL_CANDIDATE_DECISION_SCHEMA } from \"@kungfu-tech/buildchain\";",
3880
3880
  "maturity": "stable",
@@ -3907,7 +3907,7 @@
3907
3907
  ],
3908
3908
  "source": {
3909
3909
  "path": "packages/core/channel-candidate.js",
3910
- "line": 84
3910
+ "line": 85
3911
3911
  },
3912
3912
  "example": "import { channelCandidateSourceLockRef } from \"@kungfu-tech/buildchain\";",
3913
3913
  "maturity": "stable",
@@ -3936,7 +3936,7 @@
3936
3936
  ],
3937
3937
  "source": {
3938
3938
  "path": "packages/core/channel-candidate.js",
3939
- "line": 90
3939
+ "line": 91
3940
3940
  },
3941
3941
  "example": "import { decideChannelCandidate } from \"@kungfu-tech/buildchain\";",
3942
3942
  "maturity": "stable",
@@ -4141,16 +4141,944 @@
4141
4141
  ],
4142
4142
  "returns": "unknown",
4143
4143
  "errors": [
4144
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
4144
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4145
+ ],
4146
+ "sideEffects": [
4147
+ "none-detected-by-static-source-scan"
4148
+ ],
4149
+ "source": {
4150
+ "path": "packages/core/controller-evidence.js",
4151
+ "line": 362
4152
+ },
4153
+ "example": "import { createControllerReceipt } from \"@kungfu-tech/buildchain\";",
4154
+ "maturity": "stable",
4155
+ "audience": [
4156
+ "developer",
4157
+ "agent"
4158
+ ]
4159
+ },
4160
+ {
4161
+ "id": "packages/core/controller-evidence.js#createControllerReceiptReference",
4162
+ "name": "createControllerReceiptReference",
4163
+ "kind": "function",
4164
+ "signature": "function createControllerReceiptReference(receipt)",
4165
+ "parameters": [
4166
+ {
4167
+ "name": "receipt",
4168
+ "signature": "receipt"
4169
+ }
4170
+ ],
4171
+ "returns": "unknown",
4172
+ "errors": [
4173
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4174
+ ],
4175
+ "sideEffects": [
4176
+ "none-detected-by-static-source-scan"
4177
+ ],
4178
+ "source": {
4179
+ "path": "packages/core/controller-evidence.js",
4180
+ "line": 490
4181
+ },
4182
+ "example": "import { createControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
4183
+ "maturity": "stable",
4184
+ "audience": [
4185
+ "developer",
4186
+ "agent"
4187
+ ]
4188
+ },
4189
+ {
4190
+ "id": "packages/core/controller-evidence.js#createControllerRegistry",
4191
+ "name": "createControllerRegistry",
4192
+ "kind": "function",
4193
+ "signature": "function createControllerRegistry({ workflows = [] } = {})",
4194
+ "parameters": [
4195
+ {
4196
+ "name": "parameter1",
4197
+ "signature": "{ workflows = [] } = {}"
4198
+ }
4199
+ ],
4200
+ "returns": "unknown",
4201
+ "errors": [
4202
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4203
+ ],
4204
+ "sideEffects": [
4205
+ "none-detected-by-static-source-scan"
4206
+ ],
4207
+ "source": {
4208
+ "path": "packages/core/controller-evidence.js",
4209
+ "line": 196
4210
+ },
4211
+ "example": "import { createControllerRegistry } from \"@kungfu-tech/buildchain\";",
4212
+ "maturity": "stable",
4213
+ "audience": [
4214
+ "developer",
4215
+ "agent"
4216
+ ]
4217
+ },
4218
+ {
4219
+ "id": "packages/core/controller-evidence.js#normalizeControllerReceiptReferences",
4220
+ "name": "normalizeControllerReceiptReferences",
4221
+ "kind": "function",
4222
+ "signature": "function normalizeControllerReceiptReferences({ receipts = [], references = [], expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {})",
4223
+ "parameters": [
4224
+ {
4225
+ "name": "parameter1",
4226
+ "signature": "{ receipts = [], references = [], expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {}"
4227
+ }
4228
+ ],
4229
+ "returns": "unknown",
4230
+ "errors": [
4231
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4232
+ ],
4233
+ "sideEffects": [
4234
+ "none-detected-by-static-source-scan"
4235
+ ],
4236
+ "source": {
4237
+ "path": "packages/core/controller-evidence.js",
4238
+ "line": 531
4239
+ },
4240
+ "example": "import { normalizeControllerReceiptReferences } from \"@kungfu-tech/buildchain\";",
4241
+ "maturity": "stable",
4242
+ "audience": [
4243
+ "developer",
4244
+ "agent"
4245
+ ]
4246
+ },
4247
+ {
4248
+ "id": "packages/core/controller-evidence.js#validateControllerPlan",
4249
+ "name": "validateControllerPlan",
4250
+ "kind": "function",
4251
+ "signature": "function validateControllerPlan(plan)",
4252
+ "parameters": [
4253
+ {
4254
+ "name": "plan",
4255
+ "signature": "plan"
4256
+ }
4257
+ ],
4258
+ "returns": "unknown",
4259
+ "errors": [
4260
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4261
+ ],
4262
+ "sideEffects": [
4263
+ "none-detected-by-static-source-scan"
4264
+ ],
4265
+ "source": {
4266
+ "path": "packages/core/controller-evidence.js",
4267
+ "line": 324
4268
+ },
4269
+ "example": "import { validateControllerPlan } from \"@kungfu-tech/buildchain\";",
4270
+ "maturity": "stable",
4271
+ "audience": [
4272
+ "developer",
4273
+ "agent"
4274
+ ]
4275
+ },
4276
+ {
4277
+ "id": "packages/core/controller-evidence.js#validateControllerReceipt",
4278
+ "name": "validateControllerReceipt",
4279
+ "kind": "function",
4280
+ "signature": "function validateControllerReceipt(receipt, { plan = undefined, expectedSourceSha = \"\", expectedRuntimeSha = \"\", expectedPlanDigest = \"\", } = {})",
4281
+ "parameters": [
4282
+ {
4283
+ "name": "receipt",
4284
+ "signature": "receipt"
4285
+ },
4286
+ {
4287
+ "name": "parameter2",
4288
+ "signature": "{ plan = undefined, expectedSourceSha = \"\", expectedRuntimeSha = \"\", expectedPlanDigest = \"\", } = {}"
4289
+ }
4290
+ ],
4291
+ "returns": "unknown",
4292
+ "errors": [
4293
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4294
+ ],
4295
+ "sideEffects": [
4296
+ "none-detected-by-static-source-scan"
4297
+ ],
4298
+ "source": {
4299
+ "path": "packages/core/controller-evidence.js",
4300
+ "line": 422
4301
+ },
4302
+ "example": "import { validateControllerReceipt } from \"@kungfu-tech/buildchain\";",
4303
+ "maturity": "stable",
4304
+ "audience": [
4305
+ "developer",
4306
+ "agent"
4307
+ ]
4308
+ },
4309
+ {
4310
+ "id": "packages/core/controller-evidence.js#validateControllerReceiptReference",
4311
+ "name": "validateControllerReceiptReference",
4312
+ "kind": "function",
4313
+ "signature": "function validateControllerReceiptReference(reference, { expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {})",
4314
+ "parameters": [
4315
+ {
4316
+ "name": "reference",
4317
+ "signature": "reference"
4318
+ },
4319
+ {
4320
+ "name": "parameter2",
4321
+ "signature": "{ expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {}"
4322
+ }
4323
+ ],
4324
+ "returns": "unknown",
4325
+ "errors": [
4326
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4327
+ ],
4328
+ "sideEffects": [
4329
+ "none-detected-by-static-source-scan"
4330
+ ],
4331
+ "source": {
4332
+ "path": "packages/core/controller-evidence.js",
4333
+ "line": 504
4334
+ },
4335
+ "example": "import { validateControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
4336
+ "maturity": "stable",
4337
+ "audience": [
4338
+ "developer",
4339
+ "agent"
4340
+ ]
4341
+ },
4342
+ {
4343
+ "id": "packages/core/detached-artifact-signature.js#DETACHED_ARTIFACT_SIGNATURE_CONTRACT",
4344
+ "name": "DETACHED_ARTIFACT_SIGNATURE_CONTRACT",
4345
+ "kind": "constant",
4346
+ "signature": "const DETACHED_ARTIFACT_SIGNATURE_CONTRACT",
4347
+ "parameters": [],
4348
+ "returns": "value",
4349
+ "errors": [
4350
+ "Import does not declare a throw contract."
4351
+ ],
4352
+ "sideEffects": [
4353
+ "none-on-import"
4354
+ ],
4355
+ "source": {
4356
+ "path": "packages/core/detached-artifact-signature.js",
4357
+ "line": 10
4358
+ },
4359
+ "example": "import { DETACHED_ARTIFACT_SIGNATURE_CONTRACT } from \"@kungfu-tech/buildchain\";",
4360
+ "maturity": "stable",
4361
+ "audience": [
4362
+ "developer",
4363
+ "agent"
4364
+ ]
4365
+ },
4366
+ {
4367
+ "id": "packages/core/detached-artifact-signature.js#signDetachedArtifactRequest",
4368
+ "name": "signDetachedArtifactRequest",
4369
+ "kind": "function",
4370
+ "signature": "function signDetachedArtifactRequest({ request, privateKey, keyId, authority = {}, } = {})",
4371
+ "parameters": [
4372
+ {
4373
+ "name": "parameter1",
4374
+ "signature": "{ request, privateKey, keyId, authority = {}, } = {}"
4375
+ }
4376
+ ],
4377
+ "returns": "unknown",
4378
+ "errors": [
4379
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4380
+ ],
4381
+ "sideEffects": [
4382
+ "none-detected-by-static-source-scan"
4383
+ ],
4384
+ "source": {
4385
+ "path": "packages/core/detached-artifact-signature.js",
4386
+ "line": 36
4387
+ },
4388
+ "example": "import { signDetachedArtifactRequest } from \"@kungfu-tech/buildchain\";",
4389
+ "maturity": "stable",
4390
+ "audience": [
4391
+ "developer",
4392
+ "agent"
4393
+ ]
4394
+ },
4395
+ {
4396
+ "id": "packages/core/detached-artifact-signature.js#verifyDetachedArtifactSignature",
4397
+ "name": "verifyDetachedArtifactSignature",
4398
+ "kind": "function",
4399
+ "signature": "function verifyDetachedArtifactSignature({ request, envelope, publicKey, } = {})",
4400
+ "parameters": [
4401
+ {
4402
+ "name": "parameter1",
4403
+ "signature": "{ request, envelope, publicKey, } = {}"
4404
+ }
4405
+ ],
4406
+ "returns": "unknown",
4407
+ "errors": [
4408
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4409
+ ],
4410
+ "sideEffects": [
4411
+ "none-detected-by-static-source-scan"
4412
+ ],
4413
+ "source": {
4414
+ "path": "packages/core/detached-artifact-signature.js",
4415
+ "line": 82
4416
+ },
4417
+ "example": "import { verifyDetachedArtifactSignature } from \"@kungfu-tech/buildchain\";",
4418
+ "maturity": "stable",
4419
+ "audience": [
4420
+ "developer",
4421
+ "agent"
4422
+ ]
4423
+ },
4424
+ {
4425
+ "id": "packages/core/dev-delivery-common.js#devDeliveryContentRoot",
4426
+ "name": "devDeliveryContentRoot",
4427
+ "kind": "function",
4428
+ "signature": "function devDeliveryContentRoot(value)",
4429
+ "parameters": [
4430
+ {
4431
+ "name": "value",
4432
+ "signature": "value"
4433
+ }
4434
+ ],
4435
+ "returns": "unknown",
4436
+ "errors": [
4437
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4438
+ ],
4439
+ "sideEffects": [
4440
+ "none-detected-by-static-source-scan"
4441
+ ],
4442
+ "source": {
4443
+ "path": "packages/core/dev-delivery-common.js",
4444
+ "line": 27
4445
+ },
4446
+ "example": "import { devDeliveryContentRoot } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4447
+ "maturity": "stable",
4448
+ "audience": [
4449
+ "developer",
4450
+ "agent"
4451
+ ]
4452
+ },
4453
+ {
4454
+ "id": "packages/core/dev-delivery-proof.js#classifyDevDeliveryDelta",
4455
+ "name": "classifyDevDeliveryDelta",
4456
+ "kind": "function",
4457
+ "signature": "function classifyDevDeliveryDelta({ proof, current = {} } = {})",
4458
+ "parameters": [
4459
+ {
4460
+ "name": "parameter1",
4461
+ "signature": "{ proof, current = {} } = {}"
4462
+ }
4463
+ ],
4464
+ "returns": "unknown",
4465
+ "errors": [
4466
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4467
+ ],
4468
+ "sideEffects": [
4469
+ "none-detected-by-static-source-scan"
4470
+ ],
4471
+ "source": {
4472
+ "path": "packages/core/dev-delivery-proof.js",
4473
+ "line": 75
4474
+ },
4475
+ "example": "import { classifyDevDeliveryDelta } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4476
+ "maturity": "stable",
4477
+ "audience": [
4478
+ "developer",
4479
+ "agent"
4480
+ ]
4481
+ },
4482
+ {
4483
+ "id": "packages/core/dev-delivery-proof.js#createIntegrationDeliveryProof",
4484
+ "name": "createIntegrationDeliveryProof",
4485
+ "kind": "function",
4486
+ "signature": "function createIntegrationDeliveryProof(input = {})",
4487
+ "parameters": [
4488
+ {
4489
+ "name": "input",
4490
+ "signature": "input = {}"
4491
+ }
4492
+ ],
4493
+ "returns": "unknown",
4494
+ "errors": [
4495
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4496
+ ],
4497
+ "sideEffects": [
4498
+ "none-detected-by-static-source-scan"
4499
+ ],
4500
+ "source": {
4501
+ "path": "packages/core/dev-delivery-proof.js",
4502
+ "line": 207
4503
+ },
4504
+ "example": "import { createIntegrationDeliveryProof } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4505
+ "maturity": "stable",
4506
+ "audience": [
4507
+ "developer",
4508
+ "agent"
4509
+ ]
4510
+ },
4511
+ {
4512
+ "id": "packages/core/dev-delivery-proof.js#createProjectCutReplayPlan",
4513
+ "name": "createProjectCutReplayPlan",
4514
+ "kind": "function",
4515
+ "signature": "function createProjectCutReplayPlan(input = {})",
4516
+ "parameters": [
4517
+ {
4518
+ "name": "input",
4519
+ "signature": "input = {}"
4520
+ }
4521
+ ],
4522
+ "returns": "unknown",
4523
+ "errors": [
4524
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4525
+ ],
4526
+ "sideEffects": [
4527
+ "none-detected-by-static-source-scan"
4528
+ ],
4529
+ "source": {
4530
+ "path": "packages/core/dev-delivery-proof.js",
4531
+ "line": 121
4532
+ },
4533
+ "example": "import { createProjectCutReplayPlan } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4534
+ "maturity": "stable",
4535
+ "audience": [
4536
+ "developer",
4537
+ "agent"
4538
+ ]
4539
+ },
4540
+ {
4541
+ "id": "packages/core/dev-delivery-proof.js#createProjectCutReplayProof",
4542
+ "name": "createProjectCutReplayProof",
4543
+ "kind": "function",
4544
+ "signature": "function createProjectCutReplayProof(input = {})",
4545
+ "parameters": [
4546
+ {
4547
+ "name": "input",
4548
+ "signature": "input = {}"
4549
+ }
4550
+ ],
4551
+ "returns": "unknown",
4552
+ "errors": [
4553
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4554
+ ],
4555
+ "sideEffects": [
4556
+ "none-detected-by-static-source-scan"
4557
+ ],
4558
+ "source": {
4559
+ "path": "packages/core/dev-delivery-proof.js",
4560
+ "line": 141
4561
+ },
4562
+ "example": "import { createProjectCutReplayProof } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4563
+ "maturity": "stable",
4564
+ "audience": [
4565
+ "developer",
4566
+ "agent"
4567
+ ]
4568
+ },
4569
+ {
4570
+ "id": "packages/core/dev-delivery-proof.js#createSourceQualificationProof",
4571
+ "name": "createSourceQualificationProof",
4572
+ "kind": "function",
4573
+ "signature": "function createSourceQualificationProof(input = {})",
4574
+ "parameters": [
4575
+ {
4576
+ "name": "input",
4577
+ "signature": "input = {}"
4578
+ }
4579
+ ],
4580
+ "returns": "unknown",
4581
+ "errors": [
4582
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4583
+ ],
4584
+ "sideEffects": [
4585
+ "none-detected-by-static-source-scan"
4586
+ ],
4587
+ "source": {
4588
+ "path": "packages/core/dev-delivery-proof.js",
4589
+ "line": 31
4590
+ },
4591
+ "example": "import { createSourceQualificationProof } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4592
+ "maturity": "stable",
4593
+ "audience": [
4594
+ "developer",
4595
+ "agent"
4596
+ ]
4597
+ },
4598
+ {
4599
+ "id": "packages/core/dev-delivery-proof.js#INTEGRATION_DELIVERY_PROOF_SCHEMA",
4600
+ "name": "INTEGRATION_DELIVERY_PROOF_SCHEMA",
4601
+ "kind": "constant",
4602
+ "signature": "const INTEGRATION_DELIVERY_PROOF_SCHEMA",
4603
+ "parameters": [],
4604
+ "returns": "value",
4605
+ "errors": [
4606
+ "Import does not declare a throw contract."
4607
+ ],
4608
+ "sideEffects": [
4609
+ "none-on-import"
4610
+ ],
4611
+ "source": {
4612
+ "path": "packages/core/dev-delivery-proof.js",
4613
+ "line": 5
4614
+ },
4615
+ "example": "import { INTEGRATION_DELIVERY_PROOF_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4616
+ "maturity": "stable",
4617
+ "audience": [
4618
+ "developer",
4619
+ "agent"
4620
+ ]
4621
+ },
4622
+ {
4623
+ "id": "packages/core/dev-delivery-proof.js#PROJECT_CUT_REPLAY_PROOF_SCHEMA",
4624
+ "name": "PROJECT_CUT_REPLAY_PROOF_SCHEMA",
4625
+ "kind": "constant",
4626
+ "signature": "const PROJECT_CUT_REPLAY_PROOF_SCHEMA",
4627
+ "parameters": [],
4628
+ "returns": "value",
4629
+ "errors": [
4630
+ "Import does not declare a throw contract."
4631
+ ],
4632
+ "sideEffects": [
4633
+ "none-on-import"
4634
+ ],
4635
+ "source": {
4636
+ "path": "packages/core/dev-delivery-proof.js",
4637
+ "line": 4
4638
+ },
4639
+ "example": "import { PROJECT_CUT_REPLAY_PROOF_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4640
+ "maturity": "stable",
4641
+ "audience": [
4642
+ "developer",
4643
+ "agent"
4644
+ ]
4645
+ },
4646
+ {
4647
+ "id": "packages/core/dev-delivery-proof.js#SOURCE_QUALIFICATION_PROOF_SCHEMA",
4648
+ "name": "SOURCE_QUALIFICATION_PROOF_SCHEMA",
4649
+ "kind": "constant",
4650
+ "signature": "const SOURCE_QUALIFICATION_PROOF_SCHEMA",
4651
+ "parameters": [],
4652
+ "returns": "value",
4653
+ "errors": [
4654
+ "Import does not declare a throw contract."
4655
+ ],
4656
+ "sideEffects": [
4657
+ "none-on-import"
4658
+ ],
4659
+ "source": {
4660
+ "path": "packages/core/dev-delivery-proof.js",
4661
+ "line": 3
4662
+ },
4663
+ "example": "import { SOURCE_QUALIFICATION_PROOF_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4664
+ "maturity": "stable",
4665
+ "audience": [
4666
+ "developer",
4667
+ "agent"
4668
+ ]
4669
+ },
4670
+ {
4671
+ "id": "packages/core/dev-delivery-proof.js#verifyIntegrationDeliveryProof",
4672
+ "name": "verifyIntegrationDeliveryProof",
4673
+ "kind": "function",
4674
+ "signature": "function verifyIntegrationDeliveryProof(proofInput, expected = {})",
4675
+ "parameters": [
4676
+ {
4677
+ "name": "proofInput",
4678
+ "signature": "proofInput"
4679
+ },
4680
+ {
4681
+ "name": "expected",
4682
+ "signature": "expected = {}"
4683
+ }
4684
+ ],
4685
+ "returns": "unknown",
4686
+ "errors": [
4687
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4688
+ ],
4689
+ "sideEffects": [
4690
+ "none-detected-by-static-source-scan"
4691
+ ],
4692
+ "source": {
4693
+ "path": "packages/core/dev-delivery-proof.js",
4694
+ "line": 228
4695
+ },
4696
+ "example": "import { verifyIntegrationDeliveryProof } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4697
+ "maturity": "stable",
4698
+ "audience": [
4699
+ "developer",
4700
+ "agent"
4701
+ ]
4702
+ },
4703
+ {
4704
+ "id": "packages/core/dev-delivery-proof.js#verifyProjectCutReplayProof",
4705
+ "name": "verifyProjectCutReplayProof",
4706
+ "kind": "function",
4707
+ "signature": "function verifyProjectCutReplayProof(proofInput, expected = {})",
4708
+ "parameters": [
4709
+ {
4710
+ "name": "proofInput",
4711
+ "signature": "proofInput"
4712
+ },
4713
+ {
4714
+ "name": "expected",
4715
+ "signature": "expected = {}"
4716
+ }
4717
+ ],
4718
+ "returns": "unknown",
4719
+ "errors": [
4720
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4721
+ ],
4722
+ "sideEffects": [
4723
+ "none-detected-by-static-source-scan"
4724
+ ],
4725
+ "source": {
4726
+ "path": "packages/core/dev-delivery-proof.js",
4727
+ "line": 187
4728
+ },
4729
+ "example": "import { verifyProjectCutReplayProof } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4730
+ "maturity": "stable",
4731
+ "audience": [
4732
+ "developer",
4733
+ "agent"
4734
+ ]
4735
+ },
4736
+ {
4737
+ "id": "packages/core/dev-delivery-proof.js#verifySourceQualificationProof",
4738
+ "name": "verifySourceQualificationProof",
4739
+ "kind": "function",
4740
+ "signature": "function verifySourceQualificationProof(proofInput, expected = {})",
4741
+ "parameters": [
4742
+ {
4743
+ "name": "proofInput",
4744
+ "signature": "proofInput"
4745
+ },
4746
+ {
4747
+ "name": "expected",
4748
+ "signature": "expected = {}"
4749
+ }
4750
+ ],
4751
+ "returns": "unknown",
4752
+ "errors": [
4753
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4754
+ ],
4755
+ "sideEffects": [
4756
+ "none-detected-by-static-source-scan"
4757
+ ],
4758
+ "source": {
4759
+ "path": "packages/core/dev-delivery-proof.js",
4760
+ "line": 52
4761
+ },
4762
+ "example": "import { verifySourceQualificationProof } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4763
+ "maturity": "stable",
4764
+ "audience": [
4765
+ "developer",
4766
+ "agent"
4767
+ ]
4768
+ },
4769
+ {
4770
+ "id": "packages/core/dev-delivery-warrant.js#cancelQueuedDevDeliveryCandidate",
4771
+ "name": "cancelQueuedDevDeliveryCandidate",
4772
+ "kind": "function",
4773
+ "signature": "function cancelQueuedDevDeliveryCandidate(queueInput, input, options)",
4774
+ "parameters": [
4775
+ {
4776
+ "name": "queueInput",
4777
+ "signature": "queueInput"
4778
+ },
4779
+ {
4780
+ "name": "input",
4781
+ "signature": "input"
4782
+ },
4783
+ {
4784
+ "name": "options",
4785
+ "signature": "options"
4786
+ }
4787
+ ],
4788
+ "returns": "unknown",
4789
+ "errors": [
4790
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4791
+ ],
4792
+ "sideEffects": [
4793
+ "none-detected-by-static-source-scan"
4794
+ ],
4795
+ "source": {
4796
+ "path": "packages/core/dev-delivery-warrant.js",
4797
+ "line": 559
4798
+ },
4799
+ "example": "import { cancelQueuedDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4800
+ "maturity": "stable",
4801
+ "audience": [
4802
+ "developer",
4803
+ "agent"
4804
+ ]
4805
+ },
4806
+ {
4807
+ "id": "packages/core/dev-delivery-warrant.js#closeDevDeliveryWarrant",
4808
+ "name": "closeDevDeliveryWarrant",
4809
+ "kind": "function",
4810
+ "signature": "function closeDevDeliveryWarrant(queueInput, warrant, { outcome, evidenceRoot, reason = \"\", now = new Date().toISOString() } = {})",
4811
+ "parameters": [
4812
+ {
4813
+ "name": "queueInput",
4814
+ "signature": "queueInput"
4815
+ },
4816
+ {
4817
+ "name": "warrant",
4818
+ "signature": "warrant"
4819
+ },
4820
+ {
4821
+ "name": "parameter3",
4822
+ "signature": "{ outcome, evidenceRoot, reason = \"\", now = new Date().toISOString() } = {}"
4823
+ }
4824
+ ],
4825
+ "returns": "unknown",
4826
+ "errors": [
4827
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4828
+ ],
4829
+ "sideEffects": [
4830
+ "none-detected-by-static-source-scan"
4831
+ ],
4832
+ "source": {
4833
+ "path": "packages/core/dev-delivery-warrant.js",
4834
+ "line": 511
4835
+ },
4836
+ "example": "import { closeDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4837
+ "maturity": "stable",
4838
+ "audience": [
4839
+ "developer",
4840
+ "agent"
4841
+ ]
4842
+ },
4843
+ {
4844
+ "id": "packages/core/dev-delivery-warrant.js#createDevDeliveryQueue",
4845
+ "name": "createDevDeliveryQueue",
4846
+ "kind": "function",
4847
+ "signature": "function createDevDeliveryQueue({ repository: repositoryInput, protectedBase: protectedBaseInput, policy = {}, now = new Date().toISOString() } = {})",
4848
+ "parameters": [
4849
+ {
4850
+ "name": "parameter1",
4851
+ "signature": "{ repository: repositoryInput, protectedBase: protectedBaseInput, policy = {}, now = new Date().toISOString() } = {}"
4852
+ }
4853
+ ],
4854
+ "returns": "unknown",
4855
+ "errors": [
4856
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4857
+ ],
4858
+ "sideEffects": [
4859
+ "none-detected-by-static-source-scan"
4860
+ ],
4861
+ "source": {
4862
+ "path": "packages/core/dev-delivery-warrant.js",
4863
+ "line": 95
4864
+ },
4865
+ "example": "import { createDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4866
+ "maturity": "stable",
4867
+ "audience": [
4868
+ "developer",
4869
+ "agent"
4870
+ ]
4871
+ },
4872
+ {
4873
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_CANCELLATION_RECEIPT_SCHEMA",
4874
+ "name": "DEV_DELIVERY_CANCELLATION_RECEIPT_SCHEMA",
4875
+ "kind": "value",
4876
+ "signature": "DEV_DELIVERY_CANCELLATION_RECEIPT_SCHEMA",
4877
+ "parameters": [],
4878
+ "returns": "unknown",
4879
+ "errors": [
4880
+ "No narrower error contract was mechanically discoverable."
4881
+ ],
4882
+ "sideEffects": [
4883
+ "unknown"
4884
+ ],
4885
+ "source": {
4886
+ "path": "packages/core/dev-delivery-warrant.js",
4887
+ "line": 1
4888
+ },
4889
+ "example": "import { DEV_DELIVERY_CANCELLATION_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4890
+ "maturity": "stable",
4891
+ "audience": [
4892
+ "developer",
4893
+ "agent"
4894
+ ]
4895
+ },
4896
+ {
4897
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_CLASSES",
4898
+ "name": "DEV_DELIVERY_CLASSES",
4899
+ "kind": "constant",
4900
+ "signature": "const DEV_DELIVERY_CLASSES",
4901
+ "parameters": [],
4902
+ "returns": "value",
4903
+ "errors": [
4904
+ "Import does not declare a throw contract."
4905
+ ],
4906
+ "sideEffects": [
4907
+ "none-on-import"
4908
+ ],
4909
+ "source": {
4910
+ "path": "packages/core/dev-delivery-warrant.js",
4911
+ "line": 20
4912
+ },
4913
+ "example": "import { DEV_DELIVERY_CLASSES } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4914
+ "maturity": "stable",
4915
+ "audience": [
4916
+ "developer",
4917
+ "agent"
4918
+ ]
4919
+ },
4920
+ {
4921
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_LEASE_RECEIPT_SCHEMA",
4922
+ "name": "DEV_DELIVERY_LEASE_RECEIPT_SCHEMA",
4923
+ "kind": "constant",
4924
+ "signature": "const DEV_DELIVERY_LEASE_RECEIPT_SCHEMA",
4925
+ "parameters": [],
4926
+ "returns": "value",
4927
+ "errors": [
4928
+ "Import does not declare a throw contract."
4929
+ ],
4930
+ "sideEffects": [
4931
+ "none-on-import"
4932
+ ],
4933
+ "source": {
4934
+ "path": "packages/core/dev-delivery-warrant.js",
4935
+ "line": 12
4936
+ },
4937
+ "example": "import { DEV_DELIVERY_LEASE_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4938
+ "maturity": "stable",
4939
+ "audience": [
4940
+ "developer",
4941
+ "agent"
4942
+ ]
4943
+ },
4944
+ {
4945
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_PRIORITIES",
4946
+ "name": "DEV_DELIVERY_PRIORITIES",
4947
+ "kind": "constant",
4948
+ "signature": "const DEV_DELIVERY_PRIORITIES",
4949
+ "parameters": [],
4950
+ "returns": "value",
4951
+ "errors": [
4952
+ "Import does not declare a throw contract."
4953
+ ],
4954
+ "sideEffects": [
4955
+ "none-on-import"
4956
+ ],
4957
+ "source": {
4958
+ "path": "packages/core/dev-delivery-warrant.js",
4959
+ "line": 14
4960
+ },
4961
+ "example": "import { DEV_DELIVERY_PRIORITIES } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4962
+ "maturity": "stable",
4963
+ "audience": [
4964
+ "developer",
4965
+ "agent"
4966
+ ]
4967
+ },
4968
+ {
4969
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_QUEUE_CONTRACT",
4970
+ "name": "DEV_DELIVERY_QUEUE_CONTRACT",
4971
+ "kind": "constant",
4972
+ "signature": "const DEV_DELIVERY_QUEUE_CONTRACT",
4973
+ "parameters": [],
4974
+ "returns": "value",
4975
+ "errors": [
4976
+ "Import does not declare a throw contract."
4977
+ ],
4978
+ "sideEffects": [
4979
+ "none-on-import"
4980
+ ],
4981
+ "source": {
4982
+ "path": "packages/core/dev-delivery-warrant.js",
4983
+ "line": 8
4984
+ },
4985
+ "example": "import { DEV_DELIVERY_QUEUE_CONTRACT } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4986
+ "maturity": "stable",
4987
+ "audience": [
4988
+ "developer",
4989
+ "agent"
4990
+ ]
4991
+ },
4992
+ {
4993
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA",
4994
+ "name": "DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA",
4995
+ "kind": "constant",
4996
+ "signature": "const DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA",
4997
+ "parameters": [],
4998
+ "returns": "value",
4999
+ "errors": [
5000
+ "Import does not declare a throw contract."
5001
+ ],
5002
+ "sideEffects": [
5003
+ "none-on-import"
5004
+ ],
5005
+ "source": {
5006
+ "path": "packages/core/dev-delivery-warrant.js",
5007
+ "line": 11
5008
+ },
5009
+ "example": "import { DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5010
+ "maturity": "stable",
5011
+ "audience": [
5012
+ "developer",
5013
+ "agent"
5014
+ ]
5015
+ },
5016
+ {
5017
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA",
5018
+ "name": "DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA",
5019
+ "kind": "value",
5020
+ "signature": "DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA",
5021
+ "parameters": [],
5022
+ "returns": "unknown",
5023
+ "errors": [
5024
+ "No narrower error contract was mechanically discoverable."
5025
+ ],
5026
+ "sideEffects": [
5027
+ "unknown"
5028
+ ],
5029
+ "source": {
5030
+ "path": "packages/core/dev-delivery-warrant.js",
5031
+ "line": 1
5032
+ },
5033
+ "example": "import { DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5034
+ "maturity": "stable",
5035
+ "audience": [
5036
+ "developer",
5037
+ "agent"
5038
+ ]
5039
+ },
5040
+ {
5041
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA",
5042
+ "name": "DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA",
5043
+ "kind": "constant",
5044
+ "signature": "const DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA",
5045
+ "parameters": [],
5046
+ "returns": "value",
5047
+ "errors": [
5048
+ "Import does not declare a throw contract."
5049
+ ],
5050
+ "sideEffects": [
5051
+ "none-on-import"
5052
+ ],
5053
+ "source": {
5054
+ "path": "packages/core/dev-delivery-warrant.js",
5055
+ "line": 10
5056
+ },
5057
+ "example": "import { DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5058
+ "maturity": "stable",
5059
+ "audience": [
5060
+ "developer",
5061
+ "agent"
5062
+ ]
5063
+ },
5064
+ {
5065
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_WARRANT_SCHEMA",
5066
+ "name": "DEV_DELIVERY_WARRANT_SCHEMA",
5067
+ "kind": "constant",
5068
+ "signature": "const DEV_DELIVERY_WARRANT_SCHEMA",
5069
+ "parameters": [],
5070
+ "returns": "value",
5071
+ "errors": [
5072
+ "Import does not declare a throw contract."
4145
5073
  ],
4146
5074
  "sideEffects": [
4147
- "none-detected-by-static-source-scan"
5075
+ "none-on-import"
4148
5076
  ],
4149
5077
  "source": {
4150
- "path": "packages/core/controller-evidence.js",
4151
- "line": 362
5078
+ "path": "packages/core/dev-delivery-warrant.js",
5079
+ "line": 9
4152
5080
  },
4153
- "example": "import { createControllerReceipt } from \"@kungfu-tech/buildchain\";",
5081
+ "example": "import { DEV_DELIVERY_WARRANT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4154
5082
  "maturity": "stable",
4155
5083
  "audience": [
4156
5084
  "developer",
@@ -4158,28 +5086,36 @@
4158
5086
  ]
4159
5087
  },
4160
5088
  {
4161
- "id": "packages/core/controller-evidence.js#createControllerReceiptReference",
4162
- "name": "createControllerReceiptReference",
5089
+ "id": "packages/core/dev-delivery-warrant.js#heartbeatDevDeliveryWarrant",
5090
+ "name": "heartbeatDevDeliveryWarrant",
4163
5091
  "kind": "function",
4164
- "signature": "function createControllerReceiptReference(receipt)",
5092
+ "signature": "function heartbeatDevDeliveryWarrant(queueInput, warrant, { now = new Date().toISOString(), leaseSeconds } = {})",
4165
5093
  "parameters": [
4166
5094
  {
4167
- "name": "receipt",
4168
- "signature": "receipt"
5095
+ "name": "queueInput",
5096
+ "signature": "queueInput"
5097
+ },
5098
+ {
5099
+ "name": "warrant",
5100
+ "signature": "warrant"
5101
+ },
5102
+ {
5103
+ "name": "parameter3",
5104
+ "signature": "{ now = new Date().toISOString(), leaseSeconds } = {}"
4169
5105
  }
4170
5106
  ],
4171
5107
  "returns": "unknown",
4172
5108
  "errors": [
4173
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
5109
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4174
5110
  ],
4175
5111
  "sideEffects": [
4176
5112
  "none-detected-by-static-source-scan"
4177
5113
  ],
4178
5114
  "source": {
4179
- "path": "packages/core/controller-evidence.js",
4180
- "line": 490
5115
+ "path": "packages/core/dev-delivery-warrant.js",
5116
+ "line": 428
4181
5117
  },
4182
- "example": "import { createControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
5118
+ "example": "import { heartbeatDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4183
5119
  "maturity": "stable",
4184
5120
  "audience": [
4185
5121
  "developer",
@@ -4187,14 +5123,18 @@
4187
5123
  ]
4188
5124
  },
4189
5125
  {
4190
- "id": "packages/core/controller-evidence.js#createControllerRegistry",
4191
- "name": "createControllerRegistry",
5126
+ "id": "packages/core/dev-delivery-warrant.js#normalizeDevDeliveryQueue",
5127
+ "name": "normalizeDevDeliveryQueue",
4192
5128
  "kind": "function",
4193
- "signature": "function createControllerRegistry({ workflows = [] } = {})",
5129
+ "signature": "function normalizeDevDeliveryQueue(input, expected = {})",
4194
5130
  "parameters": [
4195
5131
  {
4196
- "name": "parameter1",
4197
- "signature": "{ workflows = [] } = {}"
5132
+ "name": "input",
5133
+ "signature": "input"
5134
+ },
5135
+ {
5136
+ "name": "expected",
5137
+ "signature": "expected = {}"
4198
5138
  }
4199
5139
  ],
4200
5140
  "returns": "unknown",
@@ -4205,10 +5145,10 @@
4205
5145
  "none-detected-by-static-source-scan"
4206
5146
  ],
4207
5147
  "source": {
4208
- "path": "packages/core/controller-evidence.js",
4209
- "line": 196
5148
+ "path": "packages/core/dev-delivery-warrant.js",
5149
+ "line": 110
4210
5150
  },
4211
- "example": "import { createControllerRegistry } from \"@kungfu-tech/buildchain\";",
5151
+ "example": "import { normalizeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4212
5152
  "maturity": "stable",
4213
5153
  "audience": [
4214
5154
  "developer",
@@ -4216,28 +5156,32 @@
4216
5156
  ]
4217
5157
  },
4218
5158
  {
4219
- "id": "packages/core/controller-evidence.js#normalizeControllerReceiptReferences",
4220
- "name": "normalizeControllerReceiptReferences",
5159
+ "id": "packages/core/dev-delivery-warrant.js#observeDevDeliveryQueue",
5160
+ "name": "observeDevDeliveryQueue",
4221
5161
  "kind": "function",
4222
- "signature": "function normalizeControllerReceiptReferences({ receipts = [], references = [], expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {})",
5162
+ "signature": "function observeDevDeliveryQueue(queueInput, { now = new Date().toISOString() } = {})",
4223
5163
  "parameters": [
4224
5164
  {
4225
- "name": "parameter1",
4226
- "signature": "{ receipts = [], references = [], expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {}"
5165
+ "name": "queueInput",
5166
+ "signature": "queueInput"
5167
+ },
5168
+ {
5169
+ "name": "parameter2",
5170
+ "signature": "{ now = new Date().toISOString() } = {}"
4227
5171
  }
4228
5172
  ],
4229
5173
  "returns": "unknown",
4230
5174
  "errors": [
4231
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
5175
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
4232
5176
  ],
4233
5177
  "sideEffects": [
4234
5178
  "none-detected-by-static-source-scan"
4235
5179
  ],
4236
5180
  "source": {
4237
- "path": "packages/core/controller-evidence.js",
4238
- "line": 531
5181
+ "path": "packages/core/dev-delivery-warrant.js",
5182
+ "line": 562
4239
5183
  },
4240
- "example": "import { normalizeControllerReceiptReferences } from \"@kungfu-tech/buildchain\";",
5184
+ "example": "import { observeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4241
5185
  "maturity": "stable",
4242
5186
  "audience": [
4243
5187
  "developer",
@@ -4245,14 +5189,18 @@
4245
5189
  ]
4246
5190
  },
4247
5191
  {
4248
- "id": "packages/core/controller-evidence.js#validateControllerPlan",
4249
- "name": "validateControllerPlan",
5192
+ "id": "packages/core/dev-delivery-warrant.js#rankDevDeliveryCandidates",
5193
+ "name": "rankDevDeliveryCandidates",
4250
5194
  "kind": "function",
4251
- "signature": "function validateControllerPlan(plan)",
5195
+ "signature": "function rankDevDeliveryCandidates(queueInput, { now = new Date().toISOString() } = {})",
4252
5196
  "parameters": [
4253
5197
  {
4254
- "name": "plan",
4255
- "signature": "plan"
5198
+ "name": "queueInput",
5199
+ "signature": "queueInput"
5200
+ },
5201
+ {
5202
+ "name": "parameter2",
5203
+ "signature": "{ now = new Date().toISOString() } = {}"
4256
5204
  }
4257
5205
  ],
4258
5206
  "returns": "unknown",
@@ -4263,10 +5211,10 @@
4263
5211
  "none-detected-by-static-source-scan"
4264
5212
  ],
4265
5213
  "source": {
4266
- "path": "packages/core/controller-evidence.js",
4267
- "line": 324
5214
+ "path": "packages/core/dev-delivery-warrant.js",
5215
+ "line": 269
4268
5216
  },
4269
- "example": "import { validateControllerPlan } from \"@kungfu-tech/buildchain\";",
5217
+ "example": "import { rankDevDeliveryCandidates } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4270
5218
  "maturity": "stable",
4271
5219
  "audience": [
4272
5220
  "developer",
@@ -4274,18 +5222,18 @@
4274
5222
  ]
4275
5223
  },
4276
5224
  {
4277
- "id": "packages/core/controller-evidence.js#validateControllerReceipt",
4278
- "name": "validateControllerReceipt",
5225
+ "id": "packages/core/dev-delivery-warrant.js#recoverExpiredDevDeliveryWarrant",
5226
+ "name": "recoverExpiredDevDeliveryWarrant",
4279
5227
  "kind": "function",
4280
- "signature": "function validateControllerReceipt(receipt, { plan = undefined, expectedSourceSha = \"\", expectedRuntimeSha = \"\", expectedPlanDigest = \"\", } = {})",
5228
+ "signature": "function recoverExpiredDevDeliveryWarrant(queueInput, { now = new Date().toISOString() } = {})",
4281
5229
  "parameters": [
4282
5230
  {
4283
- "name": "receipt",
4284
- "signature": "receipt"
5231
+ "name": "queueInput",
5232
+ "signature": "queueInput"
4285
5233
  },
4286
5234
  {
4287
5235
  "name": "parameter2",
4288
- "signature": "{ plan = undefined, expectedSourceSha = \"\", expectedRuntimeSha = \"\", expectedPlanDigest = \"\", } = {}"
5236
+ "signature": "{ now = new Date().toISOString() } = {}"
4289
5237
  }
4290
5238
  ],
4291
5239
  "returns": "unknown",
@@ -4296,10 +5244,10 @@
4296
5244
  "none-detected-by-static-source-scan"
4297
5245
  ],
4298
5246
  "source": {
4299
- "path": "packages/core/controller-evidence.js",
4300
- "line": 422
5247
+ "path": "packages/core/dev-delivery-warrant.js",
5248
+ "line": 461
4301
5249
  },
4302
- "example": "import { validateControllerReceipt } from \"@kungfu-tech/buildchain\";",
5250
+ "example": "import { recoverExpiredDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4303
5251
  "maturity": "stable",
4304
5252
  "audience": [
4305
5253
  "developer",
@@ -4307,32 +5255,32 @@
4307
5255
  ]
4308
5256
  },
4309
5257
  {
4310
- "id": "packages/core/controller-evidence.js#validateControllerReceiptReference",
4311
- "name": "validateControllerReceiptReference",
5258
+ "id": "packages/core/dev-delivery-warrant.js#selectDevDeliveryWarrant",
5259
+ "name": "selectDevDeliveryWarrant",
4312
5260
  "kind": "function",
4313
- "signature": "function validateControllerReceiptReference(reference, { expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {})",
5261
+ "signature": "function selectDevDeliveryWarrant(queueInput, { now = new Date().toISOString(), leaseSeconds } = {})",
4314
5262
  "parameters": [
4315
5263
  {
4316
- "name": "reference",
4317
- "signature": "reference"
5264
+ "name": "queueInput",
5265
+ "signature": "queueInput"
4318
5266
  },
4319
5267
  {
4320
5268
  "name": "parameter2",
4321
- "signature": "{ expectedSourceSha = \"\", acceptedSourceShas = [], expectedRuntimeSha = \"\", requirePassed = false, } = {}"
5269
+ "signature": "{ now = new Date().toISOString(), leaseSeconds } = {}"
4322
5270
  }
4323
5271
  ],
4324
5272
  "returns": "unknown",
4325
5273
  "errors": [
4326
- "Errors from called operations may propagate; no narrower throw contract is declared in source."
5274
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4327
5275
  ],
4328
5276
  "sideEffects": [
4329
5277
  "none-detected-by-static-source-scan"
4330
5278
  ],
4331
5279
  "source": {
4332
- "path": "packages/core/controller-evidence.js",
4333
- "line": 504
5280
+ "path": "packages/core/dev-delivery-warrant.js",
5281
+ "line": 293
4334
5282
  },
4335
- "example": "import { validateControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
5283
+ "example": "import { selectDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4336
5284
  "maturity": "stable",
4337
5285
  "audience": [
4338
5286
  "developer",
@@ -4340,10 +5288,10 @@
4340
5288
  ]
4341
5289
  },
4342
5290
  {
4343
- "id": "packages/core/detached-artifact-signature.js#DETACHED_ARTIFACT_SIGNATURE_CONTRACT",
4344
- "name": "DETACHED_ARTIFACT_SIGNATURE_CONTRACT",
5291
+ "id": "packages/core/dev-delivery-warrant.js#settleDevDeliveryTerminalEvent",
5292
+ "name": "settleDevDeliveryTerminalEvent",
4345
5293
  "kind": "constant",
4346
- "signature": "const DETACHED_ARTIFACT_SIGNATURE_CONTRACT",
5294
+ "signature": "const settleDevDeliveryTerminalEvent",
4347
5295
  "parameters": [],
4348
5296
  "returns": "value",
4349
5297
  "errors": [
@@ -4353,10 +5301,10 @@
4353
5301
  "none-on-import"
4354
5302
  ],
4355
5303
  "source": {
4356
- "path": "packages/core/detached-artifact-signature.js",
4357
- "line": 10
5304
+ "path": "packages/core/dev-delivery-warrant.js",
5305
+ "line": 560
4358
5306
  },
4359
- "example": "import { DETACHED_ARTIFACT_SIGNATURE_CONTRACT } from \"@kungfu-tech/buildchain\";",
5307
+ "example": "import { settleDevDeliveryTerminalEvent } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4360
5308
  "maturity": "stable",
4361
5309
  "audience": [
4362
5310
  "developer",
@@ -4364,57 +5312,36 @@
4364
5312
  ]
4365
5313
  },
4366
5314
  {
4367
- "id": "packages/core/detached-artifact-signature.js#signDetachedArtifactRequest",
4368
- "name": "signDetachedArtifactRequest",
5315
+ "id": "packages/core/dev-delivery-warrant.js#submitDevDeliveryCandidate",
5316
+ "name": "submitDevDeliveryCandidate",
4369
5317
  "kind": "function",
4370
- "signature": "function signDetachedArtifactRequest({ request, privateKey, keyId, authority = {}, } = {})",
5318
+ "signature": "function submitDevDeliveryCandidate(queueInput, input, { now = new Date().toISOString() } = {})",
4371
5319
  "parameters": [
4372
5320
  {
4373
- "name": "parameter1",
4374
- "signature": "{ request, privateKey, keyId, authority = {}, } = {}"
4375
- }
4376
- ],
4377
- "returns": "unknown",
4378
- "errors": [
4379
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
4380
- ],
4381
- "sideEffects": [
4382
- "none-detected-by-static-source-scan"
4383
- ],
4384
- "source": {
4385
- "path": "packages/core/detached-artifact-signature.js",
4386
- "line": 36
4387
- },
4388
- "example": "import { signDetachedArtifactRequest } from \"@kungfu-tech/buildchain\";",
4389
- "maturity": "stable",
4390
- "audience": [
4391
- "developer",
4392
- "agent"
4393
- ]
4394
- },
4395
- {
4396
- "id": "packages/core/detached-artifact-signature.js#verifyDetachedArtifactSignature",
4397
- "name": "verifyDetachedArtifactSignature",
4398
- "kind": "function",
4399
- "signature": "function verifyDetachedArtifactSignature({ request, envelope, publicKey, } = {})",
4400
- "parameters": [
5321
+ "name": "queueInput",
5322
+ "signature": "queueInput"
5323
+ },
4401
5324
  {
4402
- "name": "parameter1",
4403
- "signature": "{ request, envelope, publicKey, } = {}"
5325
+ "name": "input",
5326
+ "signature": "input"
5327
+ },
5328
+ {
5329
+ "name": "parameter3",
5330
+ "signature": "{ now = new Date().toISOString() } = {}"
4404
5331
  }
4405
5332
  ],
4406
5333
  "returns": "unknown",
4407
5334
  "errors": [
4408
- "Errors from called operations may propagate; no narrower throw contract is declared in source."
5335
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
4409
5336
  ],
4410
5337
  "sideEffects": [
4411
5338
  "none-detected-by-static-source-scan"
4412
5339
  ],
4413
5340
  "source": {
4414
- "path": "packages/core/detached-artifact-signature.js",
4415
- "line": 82
5341
+ "path": "packages/core/dev-delivery-warrant.js",
5342
+ "line": 193
4416
5343
  },
4417
- "example": "import { verifyDetachedArtifactSignature } from \"@kungfu-tech/buildchain\";",
5344
+ "example": "import { submitDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4418
5345
  "maturity": "stable",
4419
5346
  "audience": [
4420
5347
  "developer",
@@ -13853,6 +14780,112 @@
13853
14780
  "agent"
13854
14781
  ]
13855
14782
  },
14783
+ {
14784
+ "id": "packages/core/release-candidate-recovery.js#recoveryFailure",
14785
+ "name": "recoveryFailure",
14786
+ "kind": "function",
14787
+ "signature": "function recoveryFailure(error)",
14788
+ "parameters": [
14789
+ {
14790
+ "name": "error",
14791
+ "signature": "error"
14792
+ }
14793
+ ],
14794
+ "returns": "unknown",
14795
+ "errors": [
14796
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14797
+ ],
14798
+ "sideEffects": [
14799
+ "none-detected-by-static-source-scan"
14800
+ ],
14801
+ "source": {
14802
+ "path": "packages/core/release-candidate-recovery.js",
14803
+ "line": 376
14804
+ },
14805
+ "example": "import { recoveryFailure } from \"@kungfu-tech/buildchain\";",
14806
+ "maturity": "stable",
14807
+ "audience": [
14808
+ "developer",
14809
+ "agent"
14810
+ ]
14811
+ },
14812
+ {
14813
+ "id": "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
14814
+ "name": "RELEASE_CANDIDATE_RECOVERY_CONTRACT",
14815
+ "kind": "constant",
14816
+ "signature": "const RELEASE_CANDIDATE_RECOVERY_CONTRACT",
14817
+ "parameters": [],
14818
+ "returns": "value",
14819
+ "errors": [
14820
+ "Import does not declare a throw contract."
14821
+ ],
14822
+ "sideEffects": [
14823
+ "none-on-import"
14824
+ ],
14825
+ "source": {
14826
+ "path": "packages/core/release-candidate-recovery.js",
14827
+ "line": 11
14828
+ },
14829
+ "example": "import { RELEASE_CANDIDATE_RECOVERY_CONTRACT } from \"@kungfu-tech/buildchain\";",
14830
+ "maturity": "stable",
14831
+ "audience": [
14832
+ "developer",
14833
+ "agent"
14834
+ ]
14835
+ },
14836
+ {
14837
+ "id": "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
14838
+ "name": "ReleaseCandidateRecoveryError",
14839
+ "kind": "class",
14840
+ "signature": "class ReleaseCandidateRecoveryError",
14841
+ "parameters": [],
14842
+ "returns": "ReleaseCandidateRecoveryError",
14843
+ "errors": [
14844
+ "Construction and method errors follow the linked source implementation."
14845
+ ],
14846
+ "sideEffects": [
14847
+ "class-dependent"
14848
+ ],
14849
+ "source": {
14850
+ "path": "packages/core/release-candidate-recovery.js",
14851
+ "line": 18
14852
+ },
14853
+ "example": "import { ReleaseCandidateRecoveryError } from \"@kungfu-tech/buildchain\";",
14854
+ "maturity": "stable",
14855
+ "audience": [
14856
+ "developer",
14857
+ "agent"
14858
+ ]
14859
+ },
14860
+ {
14861
+ "id": "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
14862
+ "name": "verifyReleaseCandidateRecovery",
14863
+ "kind": "function",
14864
+ "signature": "function verifyReleaseCandidateRecovery({ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetTree, expectedSourceTree = \"\", expectedCandidateRoot = \"\", expectedRuntimeSha, expectedTransactionId = \"\", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], productPayloadManifests = [], artifacts = [], currentToolingSha, recoveryRunId = \"\", createdAt = new Date().toISOString(), } = {})",
14865
+ "parameters": [
14866
+ {
14867
+ "name": "parameter1",
14868
+ "signature": "{ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetTree, expectedSourceTree = \"\", expectedCandidateRoot = \"\", expectedRuntimeSha, expectedTransactionId = \"\", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], productPayloadManifests = [], artifacts = [], currentToolingSha, recoveryRunId = \"\", createdAt = new Date().toISOString(), } = {}"
14869
+ }
14870
+ ],
14871
+ "returns": "unknown",
14872
+ "errors": [
14873
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14874
+ ],
14875
+ "sideEffects": [
14876
+ "none-detected-by-static-source-scan"
14877
+ ],
14878
+ "source": {
14879
+ "path": "packages/core/release-candidate-recovery.js",
14880
+ "line": 256
14881
+ },
14882
+ "example": "import { verifyReleaseCandidateRecovery } from \"@kungfu-tech/buildchain\";",
14883
+ "maturity": "stable",
14884
+ "audience": [
14885
+ "developer",
14886
+ "agent"
14887
+ ]
14888
+ },
13856
14889
  {
13857
14890
  "id": "packages/core/release-candidate.js#createReleaseCandidatePassport",
13858
14891
  "name": "createReleaseCandidatePassport",
@@ -16589,14 +17622,14 @@
16589
17622
  "specifier": "@kungfu-tech/buildchain",
16590
17623
  "export": ".",
16591
17624
  "target": "./packages/core/index.js",
16592
- "digest": "sha256:0a415732a05ad95fe9a8ae4da20df826f392c9c5227e9f0eee3722a3d97af49d",
17625
+ "digest": "sha256:6f22c5a7afd733e03d948cd322e01f7255b973780c89a70892c869eb3c15d05f",
16593
17626
  "summary": "Root toolkit export for Buildchain's public Node API.",
16594
17627
  "capabilityGroup": "api-cli-reference",
16595
17628
  "audience": [
16596
17629
  "developer",
16597
17630
  "agent"
16598
17631
  ],
16599
- "symbolCount": 558,
17632
+ "symbolCount": 562,
16600
17633
  "symbolIds": [
16601
17634
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
16602
17635
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -17017,6 +18050,7 @@
17017
18050
  "packages/core/publish-transaction.js#readReleaseTransaction",
17018
18051
  "packages/core/release-activation-transaction.js#recordReleaseActivationPhase",
17019
18052
  "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
18053
+ "packages/core/release-candidate-recovery.js#recoveryFailure",
17020
18054
  "packages/core/logging.js#redactBuildchainLogAttributes",
17021
18055
  "packages/core/diagnostics.js#redactDiagnosticsValue",
17022
18056
  "packages/core/issue-reporting.js#redactIssueText",
@@ -17026,6 +18060,7 @@
17026
18060
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_PHASES",
17027
18061
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_RECEIPT_SET_CONTRACT",
17028
18062
  "packages/core/release-candidate.js#RELEASE_CANDIDATE_PASSPORT_CONTRACT",
18063
+ "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
17029
18064
  "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
17030
18065
  "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
17031
18066
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_CHECK_MANIFEST_CONTRACT",
@@ -17044,6 +18079,7 @@
17044
18079
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
17045
18080
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_STAGES",
17046
18081
  "packages/core/release-activation-transaction.js#releaseActivationRoot",
18082
+ "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
17047
18083
  "packages/core/readme-badges.js#renderBadgeBundleBlock",
17048
18084
  "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
17049
18085
  "packages/core/homebrew.js#renderHomebrewFormula",
@@ -17138,6 +18174,7 @@
17138
18174
  "packages/core/publication-authority.js#verifyPublicationQualificationReceipt",
17139
18175
  "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
17140
18176
  "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
18177
+ "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
17141
18178
  "packages/core/release-passport.js#verifyReleasePassport",
17142
18179
  "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
17143
18180
  "packages/core/web-surface-publication-candidate.js#WEB_SURFACE_PRODUCTION_DECISION_CONTRACT",
@@ -17245,14 +18282,14 @@
17245
18282
  "specifier": "@kungfu-tech/buildchain/core",
17246
18283
  "export": "./core",
17247
18284
  "target": "./packages/core/index.js",
17248
- "digest": "sha256:0a415732a05ad95fe9a8ae4da20df826f392c9c5227e9f0eee3722a3d97af49d",
18285
+ "digest": "sha256:6f22c5a7afd733e03d948cd322e01f7255b973780c89a70892c869eb3c15d05f",
17249
18286
  "summary": "Alias for the root public toolkit export.",
17250
18287
  "capabilityGroup": "api-cli-reference",
17251
18288
  "audience": [
17252
18289
  "developer",
17253
18290
  "agent"
17254
18291
  ],
17255
- "symbolCount": 558,
18292
+ "symbolCount": 562,
17256
18293
  "symbolIds": [
17257
18294
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
17258
18295
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -17673,6 +18710,7 @@
17673
18710
  "packages/core/publish-transaction.js#readReleaseTransaction",
17674
18711
  "packages/core/release-activation-transaction.js#recordReleaseActivationPhase",
17675
18712
  "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
18713
+ "packages/core/release-candidate-recovery.js#recoveryFailure",
17676
18714
  "packages/core/logging.js#redactBuildchainLogAttributes",
17677
18715
  "packages/core/diagnostics.js#redactDiagnosticsValue",
17678
18716
  "packages/core/issue-reporting.js#redactIssueText",
@@ -17682,6 +18720,7 @@
17682
18720
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_PHASES",
17683
18721
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_RECEIPT_SET_CONTRACT",
17684
18722
  "packages/core/release-candidate.js#RELEASE_CANDIDATE_PASSPORT_CONTRACT",
18723
+ "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
17685
18724
  "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
17686
18725
  "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
17687
18726
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_CHECK_MANIFEST_CONTRACT",
@@ -17700,6 +18739,7 @@
17700
18739
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
17701
18740
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_STAGES",
17702
18741
  "packages/core/release-activation-transaction.js#releaseActivationRoot",
18742
+ "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
17703
18743
  "packages/core/readme-badges.js#renderBadgeBundleBlock",
17704
18744
  "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
17705
18745
  "packages/core/homebrew.js#renderHomebrewFormula",
@@ -17794,6 +18834,7 @@
17794
18834
  "packages/core/publication-authority.js#verifyPublicationQualificationReceipt",
17795
18835
  "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
17796
18836
  "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
18837
+ "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
17797
18838
  "packages/core/release-passport.js#verifyReleasePassport",
17798
18839
  "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
17799
18840
  "packages/core/web-surface-publication-candidate.js#WEB_SURFACE_PRODUCTION_DECISION_CONTRACT",
@@ -18034,7 +19075,7 @@
18034
19075
  "specifier": "@kungfu-tech/buildchain/buildchain-contract",
18035
19076
  "export": "./buildchain-contract",
18036
19077
  "target": "./packages/core/buildchain-contract.js",
18037
- "digest": "sha256:876f747eccd92d31e821c85b2f38a54ba6056704adfb30cbf7e545ff61148625",
19078
+ "digest": "sha256:90e88e4ac4759838afc4d760811ab30aad3e79066ba64fc69c81a31f3fffd291",
18038
19079
  "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
18039
19080
  "capabilityGroup": "governance-versioning",
18040
19081
  "audience": [
@@ -18095,7 +19136,7 @@
18095
19136
  "specifier": "@kungfu-tech/buildchain/channel-candidate",
18096
19137
  "export": "./channel-candidate",
18097
19138
  "target": "./packages/core/channel-candidate.js",
18098
- "digest": "sha256:4f667440dc1d3df1663fba13afe68358aa3fc0c9316d1393e760bd932cec8a45",
19139
+ "digest": "sha256:2dcd0899d8c0f4bbb7876108529f4bed0e5e82f6536474a1a505e65a322d10a6",
18099
19140
  "summary": "Exact-source channel candidate decisions, same-SHA workflow evidence validation, and deterministic source-lock reference APIs.",
18100
19141
  "capabilityGroup": "governance-versioning",
18101
19142
  "audience": [
@@ -18233,6 +19274,60 @@
18233
19274
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
18234
19275
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
18235
19276
  },
19277
+ {
19278
+ "specifier": "@kungfu-tech/buildchain/dev-delivery-warrant",
19279
+ "export": "./dev-delivery-warrant",
19280
+ "target": "./packages/core/dev-delivery-warrant.js",
19281
+ "digest": "sha256:09a0b75d556d9722faab70a7e9113701f33edf51386d6c4d5f00c7a1d786e925",
19282
+ "summary": "Durable fair Dev Delivery Warrant queue, fenced lease, and split source and integration proof APIs.",
19283
+ "capabilityGroup": "governance-versioning",
19284
+ "audience": [
19285
+ "developer",
19286
+ "agent"
19287
+ ],
19288
+ "symbolCount": 32,
19289
+ "symbolIds": [
19290
+ "packages/core/dev-delivery-warrant.js#cancelQueuedDevDeliveryCandidate",
19291
+ "packages/core/dev-delivery-proof.js#classifyDevDeliveryDelta",
19292
+ "packages/core/dev-delivery-warrant.js#closeDevDeliveryWarrant",
19293
+ "packages/core/dev-delivery-warrant.js#createDevDeliveryQueue",
19294
+ "packages/core/dev-delivery-proof.js#createIntegrationDeliveryProof",
19295
+ "packages/core/dev-delivery-proof.js#createProjectCutReplayPlan",
19296
+ "packages/core/dev-delivery-proof.js#createProjectCutReplayProof",
19297
+ "packages/core/dev-delivery-proof.js#createSourceQualificationProof",
19298
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_CANCELLATION_RECEIPT_SCHEMA",
19299
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_CLASSES",
19300
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_LEASE_RECEIPT_SCHEMA",
19301
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_PRIORITIES",
19302
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_QUEUE_CONTRACT",
19303
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA",
19304
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA",
19305
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA",
19306
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_WARRANT_SCHEMA",
19307
+ "packages/core/dev-delivery-common.js#devDeliveryContentRoot",
19308
+ "packages/core/dev-delivery-warrant.js#heartbeatDevDeliveryWarrant",
19309
+ "packages/core/dev-delivery-proof.js#INTEGRATION_DELIVERY_PROOF_SCHEMA",
19310
+ "packages/core/dev-delivery-warrant.js#normalizeDevDeliveryQueue",
19311
+ "packages/core/dev-delivery-warrant.js#observeDevDeliveryQueue",
19312
+ "packages/core/dev-delivery-proof.js#PROJECT_CUT_REPLAY_PROOF_SCHEMA",
19313
+ "packages/core/dev-delivery-warrant.js#rankDevDeliveryCandidates",
19314
+ "packages/core/dev-delivery-warrant.js#recoverExpiredDevDeliveryWarrant",
19315
+ "packages/core/dev-delivery-warrant.js#selectDevDeliveryWarrant",
19316
+ "packages/core/dev-delivery-warrant.js#settleDevDeliveryTerminalEvent",
19317
+ "packages/core/dev-delivery-proof.js#SOURCE_QUALIFICATION_PROOF_SCHEMA",
19318
+ "packages/core/dev-delivery-warrant.js#submitDevDeliveryCandidate",
19319
+ "packages/core/dev-delivery-proof.js#verifyIntegrationDeliveryProof",
19320
+ "packages/core/dev-delivery-proof.js#verifyProjectCutReplayProof",
19321
+ "packages/core/dev-delivery-proof.js#verifySourceQualificationProof"
19322
+ ],
19323
+ "owner": "buildchain-core",
19324
+ "maturity": "stable",
19325
+ "introducedVersion": "pre-3.0.2-alpha.4",
19326
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
19327
+ "deprecationReplacement": "",
19328
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
19329
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
19330
+ },
18236
19331
  {
18237
19332
  "specifier": "@kungfu-tech/buildchain/homebrew",
18238
19333
  "export": "./homebrew",
@@ -18873,7 +19968,7 @@
18873
19968
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
18874
19969
  "export": "./buildchain-publication-authority",
18875
19970
  "target": "./packages/core/buildchain-publication-authority.js",
18876
- "digest": "sha256:377c23328c8d07fd98def4e2f170d68294893f695cda8cb85766c45083510e87",
19971
+ "digest": "sha256:25816efeee5367eb512f97a2daf5788e1095b81c794b8eca933888acacf3d9a4",
18877
19972
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
18878
19973
  "capabilityGroup": "release-passport-trust",
18879
19974
  "audience": [
@@ -19005,6 +20100,32 @@
19005
20100
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
19006
20101
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
19007
20102
  },
20103
+ {
20104
+ "specifier": "@kungfu-tech/buildchain/release-candidate-recovery",
20105
+ "export": "./release-candidate-recovery",
20106
+ "target": "./packages/core/release-candidate-recovery.js",
20107
+ "digest": "sha256:effbc455f83062b52dd11ac72341160d30c7a0c5f35fd829059776eb5cd423ba",
20108
+ "summary": "Fail-closed verification and immutable receipts for reusing a successful sealed candidate run without rebuilding product payloads.",
20109
+ "capabilityGroup": "release-passport-trust",
20110
+ "audience": [
20111
+ "developer",
20112
+ "agent"
20113
+ ],
20114
+ "symbolCount": 4,
20115
+ "symbolIds": [
20116
+ "packages/core/release-candidate-recovery.js#recoveryFailure",
20117
+ "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
20118
+ "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
20119
+ "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery"
20120
+ ],
20121
+ "owner": "buildchain-core",
20122
+ "maturity": "stable",
20123
+ "introducedVersion": "pre-3.0.2-alpha.4",
20124
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
20125
+ "deprecationReplacement": "",
20126
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
20127
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
20128
+ },
19008
20129
  {
19009
20130
  "specifier": "@kungfu-tech/buildchain/stable-candidate-ledger",
19010
20131
  "export": "./stable-candidate-ledger",
@@ -19274,7 +20395,7 @@
19274
20395
  {
19275
20396
  "id": "node-api-reference",
19276
20397
  "path": "docs/node-api-reference.md",
19277
- "digest": "sha256:ae49a589091d1ab91d29f2d6ac52cf2551a9d0b1f78350965b408f40fd219e29"
20398
+ "digest": "sha256:3fbfe0227cf929f0ddc2050605d071643cee0b302a4c31920b4f9047c923ae8c"
19278
20399
  },
19279
20400
  {
19280
20401
  "id": "build-facts",