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

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 (79) hide show
  1. package/README.md +4 -4
  2. package/actions/promote-buildchain-ref/README.md +13 -1
  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 +104 -0
  6. package/dist/site/buildchain-contract.json +134 -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 +60 -4
  11. package/dist/site/kfd-claims.json +189 -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 +1295 -80
  15. package/dist/site/page-registry.json +157 -31
  16. package/dist/site/public-surface-audit.json +427 -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 +202 -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 +105 -44
  29. package/docs/publication-authority.md +11 -0
  30. package/docs/publish-transaction.md +10 -1
  31. package/docs/release-candidate.md +140 -12
  32. package/docs/release-governance.md +58 -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/publication-sealed-bundle.js +10 -1
  49. package/packages/core/release-candidate-recovery.js +539 -0
  50. package/scripts/audit-publication-control-plane.mjs +12 -4
  51. package/scripts/auditable-demo-bundle-verification.mjs +148 -0
  52. package/scripts/auditable-demo-platform.mjs +86 -50
  53. package/scripts/auditable-demo-presentation.mjs +83 -0
  54. package/scripts/auditable-demo-renditions.mjs +264 -0
  55. package/scripts/auditable-demo.mjs +24 -30
  56. package/scripts/build-contract-core.mjs +58 -3
  57. package/scripts/buildchain-cli-help.mjs +8 -0
  58. package/scripts/buildchain-patrol.mjs +9 -0
  59. package/scripts/check-inventory.mjs +25 -3
  60. package/scripts/dev-alpha-candidate-patrol.mjs +45 -48
  61. package/scripts/dev-delivery-proof.mjs +193 -0
  62. package/scripts/dev-delivery-warrant.mjs +426 -0
  63. package/scripts/dev-pr-auto-merge.mjs +488 -46
  64. package/scripts/dev-pr-delivery-warrant.mjs +209 -0
  65. package/scripts/gate-profile-core.mjs +24 -0
  66. package/scripts/generate-channel-promotion-workflow.mjs +30 -14
  67. package/scripts/generate-site-bundle.mjs +2 -2
  68. package/scripts/git-fetch-process-tree.mjs +142 -0
  69. package/scripts/lifecycle-substage-evidence.mjs +274 -0
  70. package/scripts/locked-source-checkout.mjs +6 -3
  71. package/scripts/publication-candidate-sealer.mjs +104 -0
  72. package/scripts/release-candidate-resolver.mjs +91 -5
  73. package/scripts/resolve-artifact-transfer-mode.mjs +9 -0
  74. package/scripts/resolve-build-contract.mjs +7 -0
  75. package/scripts/resume-from-candidate-run.mjs +598 -0
  76. package/scripts/route-offline-runners.mjs +1 -0
  77. package/scripts/run-lifecycle-core.mjs +9 -9
  78. package/scripts/shifu-gate-profile.mjs +10 -16
  79. 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",
@@ -4285,7 +4285,955 @@
4285
4285
  },
4286
4286
  {
4287
4287
  "name": "parameter2",
4288
- "signature": "{ plan = undefined, expectedSourceSha = \"\", expectedRuntimeSha = \"\", expectedPlanDigest = \"\", } = {}"
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."
5073
+ ],
5074
+ "sideEffects": [
5075
+ "none-on-import"
5076
+ ],
5077
+ "source": {
5078
+ "path": "packages/core/dev-delivery-warrant.js",
5079
+ "line": 9
5080
+ },
5081
+ "example": "import { DEV_DELIVERY_WARRANT_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5082
+ "maturity": "stable",
5083
+ "audience": [
5084
+ "developer",
5085
+ "agent"
5086
+ ]
5087
+ },
5088
+ {
5089
+ "id": "packages/core/dev-delivery-warrant.js#heartbeatDevDeliveryWarrant",
5090
+ "name": "heartbeatDevDeliveryWarrant",
5091
+ "kind": "function",
5092
+ "signature": "function heartbeatDevDeliveryWarrant(queueInput, warrant, { now = new Date().toISOString(), leaseSeconds } = {})",
5093
+ "parameters": [
5094
+ {
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 } = {}"
5105
+ }
5106
+ ],
5107
+ "returns": "unknown",
5108
+ "errors": [
5109
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
5110
+ ],
5111
+ "sideEffects": [
5112
+ "none-detected-by-static-source-scan"
5113
+ ],
5114
+ "source": {
5115
+ "path": "packages/core/dev-delivery-warrant.js",
5116
+ "line": 428
5117
+ },
5118
+ "example": "import { heartbeatDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5119
+ "maturity": "stable",
5120
+ "audience": [
5121
+ "developer",
5122
+ "agent"
5123
+ ]
5124
+ },
5125
+ {
5126
+ "id": "packages/core/dev-delivery-warrant.js#normalizeDevDeliveryQueue",
5127
+ "name": "normalizeDevDeliveryQueue",
5128
+ "kind": "function",
5129
+ "signature": "function normalizeDevDeliveryQueue(input, expected = {})",
5130
+ "parameters": [
5131
+ {
5132
+ "name": "input",
5133
+ "signature": "input"
5134
+ },
5135
+ {
5136
+ "name": "expected",
5137
+ "signature": "expected = {}"
5138
+ }
5139
+ ],
5140
+ "returns": "unknown",
5141
+ "errors": [
5142
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
5143
+ ],
5144
+ "sideEffects": [
5145
+ "none-detected-by-static-source-scan"
5146
+ ],
5147
+ "source": {
5148
+ "path": "packages/core/dev-delivery-warrant.js",
5149
+ "line": 110
5150
+ },
5151
+ "example": "import { normalizeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5152
+ "maturity": "stable",
5153
+ "audience": [
5154
+ "developer",
5155
+ "agent"
5156
+ ]
5157
+ },
5158
+ {
5159
+ "id": "packages/core/dev-delivery-warrant.js#observeDevDeliveryQueue",
5160
+ "name": "observeDevDeliveryQueue",
5161
+ "kind": "function",
5162
+ "signature": "function observeDevDeliveryQueue(queueInput, { now = new Date().toISOString() } = {})",
5163
+ "parameters": [
5164
+ {
5165
+ "name": "queueInput",
5166
+ "signature": "queueInput"
5167
+ },
5168
+ {
5169
+ "name": "parameter2",
5170
+ "signature": "{ now = new Date().toISOString() } = {}"
5171
+ }
5172
+ ],
5173
+ "returns": "unknown",
5174
+ "errors": [
5175
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
5176
+ ],
5177
+ "sideEffects": [
5178
+ "none-detected-by-static-source-scan"
5179
+ ],
5180
+ "source": {
5181
+ "path": "packages/core/dev-delivery-warrant.js",
5182
+ "line": 562
5183
+ },
5184
+ "example": "import { observeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5185
+ "maturity": "stable",
5186
+ "audience": [
5187
+ "developer",
5188
+ "agent"
5189
+ ]
5190
+ },
5191
+ {
5192
+ "id": "packages/core/dev-delivery-warrant.js#rankDevDeliveryCandidates",
5193
+ "name": "rankDevDeliveryCandidates",
5194
+ "kind": "function",
5195
+ "signature": "function rankDevDeliveryCandidates(queueInput, { now = new Date().toISOString() } = {})",
5196
+ "parameters": [
5197
+ {
5198
+ "name": "queueInput",
5199
+ "signature": "queueInput"
5200
+ },
5201
+ {
5202
+ "name": "parameter2",
5203
+ "signature": "{ now = new Date().toISOString() } = {}"
5204
+ }
5205
+ ],
5206
+ "returns": "unknown",
5207
+ "errors": [
5208
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
5209
+ ],
5210
+ "sideEffects": [
5211
+ "none-detected-by-static-source-scan"
5212
+ ],
5213
+ "source": {
5214
+ "path": "packages/core/dev-delivery-warrant.js",
5215
+ "line": 269
5216
+ },
5217
+ "example": "import { rankDevDeliveryCandidates } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5218
+ "maturity": "stable",
5219
+ "audience": [
5220
+ "developer",
5221
+ "agent"
5222
+ ]
5223
+ },
5224
+ {
5225
+ "id": "packages/core/dev-delivery-warrant.js#recoverExpiredDevDeliveryWarrant",
5226
+ "name": "recoverExpiredDevDeliveryWarrant",
5227
+ "kind": "function",
5228
+ "signature": "function recoverExpiredDevDeliveryWarrant(queueInput, { now = new Date().toISOString() } = {})",
5229
+ "parameters": [
5230
+ {
5231
+ "name": "queueInput",
5232
+ "signature": "queueInput"
5233
+ },
5234
+ {
5235
+ "name": "parameter2",
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",
@@ -12723,7 +13650,7 @@
12723
13650
  ],
12724
13651
  "source": {
12725
13652
  "path": "packages/core/publication-sealed-bundle.js",
12726
- "line": 75
13653
+ "line": 84
12727
13654
  },
12728
13655
  "example": "import { createPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
12729
13656
  "maturity": "stable",
@@ -12776,7 +13703,7 @@
12776
13703
  ],
12777
13704
  "source": {
12778
13705
  "path": "packages/core/publication-sealed-bundle.js",
12779
- "line": 124
13706
+ "line": 133
12780
13707
  },
12781
13708
  "example": "import { verifyPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
12782
13709
  "maturity": "stable",
@@ -13853,6 +14780,203 @@
13853
14780
  "agent"
13854
14781
  ]
13855
14782
  },
14783
+ {
14784
+ "id": "packages/core/release-candidate-recovery.js#rebindPublicationGateAggregateForEquivalentTree",
14785
+ "name": "rebindPublicationGateAggregateForEquivalentTree",
14786
+ "kind": "function",
14787
+ "signature": "function rebindPublicationGateAggregateForEquivalentTree(gateAggregate, { evidenceSourceSha = \"\", targetSourceSha = \"\", targetSourceTreeSha = \"\", expectedSourceTreeSha = \"\" } = {})",
14788
+ "parameters": [
14789
+ {
14790
+ "name": "gateAggregate",
14791
+ "signature": "gateAggregate"
14792
+ },
14793
+ {
14794
+ "name": "parameter2",
14795
+ "signature": "{ evidenceSourceSha = \"\", targetSourceSha = \"\", targetSourceTreeSha = \"\", expectedSourceTreeSha = \"\" } = {}"
14796
+ }
14797
+ ],
14798
+ "returns": "unknown",
14799
+ "errors": [
14800
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
14801
+ ],
14802
+ "sideEffects": [
14803
+ "none-detected-by-static-source-scan"
14804
+ ],
14805
+ "source": {
14806
+ "path": "packages/core/release-candidate-recovery.js",
14807
+ "line": 18
14808
+ },
14809
+ "example": "import { rebindPublicationGateAggregateForEquivalentTree } from \"@kungfu-tech/buildchain/release-candidate-recovery\";",
14810
+ "maturity": "stable",
14811
+ "audience": [
14812
+ "developer",
14813
+ "agent"
14814
+ ]
14815
+ },
14816
+ {
14817
+ "id": "packages/core/release-candidate-recovery.js#recoveryFailure",
14818
+ "name": "recoveryFailure",
14819
+ "kind": "function",
14820
+ "signature": "function recoveryFailure(error)",
14821
+ "parameters": [
14822
+ {
14823
+ "name": "error",
14824
+ "signature": "error"
14825
+ }
14826
+ ],
14827
+ "returns": "unknown",
14828
+ "errors": [
14829
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14830
+ ],
14831
+ "sideEffects": [
14832
+ "none-detected-by-static-source-scan"
14833
+ ],
14834
+ "source": {
14835
+ "path": "packages/core/release-candidate-recovery.js",
14836
+ "line": 529
14837
+ },
14838
+ "example": "import { recoveryFailure } from \"@kungfu-tech/buildchain\";",
14839
+ "maturity": "stable",
14840
+ "audience": [
14841
+ "developer",
14842
+ "agent"
14843
+ ]
14844
+ },
14845
+ {
14846
+ "id": "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
14847
+ "name": "RELEASE_CANDIDATE_RECOVERY_CONTRACT",
14848
+ "kind": "constant",
14849
+ "signature": "const RELEASE_CANDIDATE_RECOVERY_CONTRACT",
14850
+ "parameters": [],
14851
+ "returns": "value",
14852
+ "errors": [
14853
+ "Import does not declare a throw contract."
14854
+ ],
14855
+ "sideEffects": [
14856
+ "none-on-import"
14857
+ ],
14858
+ "source": {
14859
+ "path": "packages/core/release-candidate-recovery.js",
14860
+ "line": 15
14861
+ },
14862
+ "example": "import { RELEASE_CANDIDATE_RECOVERY_CONTRACT } from \"@kungfu-tech/buildchain\";",
14863
+ "maturity": "stable",
14864
+ "audience": [
14865
+ "developer",
14866
+ "agent"
14867
+ ]
14868
+ },
14869
+ {
14870
+ "id": "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
14871
+ "name": "ReleaseCandidateRecoveryError",
14872
+ "kind": "class",
14873
+ "signature": "class ReleaseCandidateRecoveryError",
14874
+ "parameters": [],
14875
+ "returns": "ReleaseCandidateRecoveryError",
14876
+ "errors": [
14877
+ "Construction and method errors follow the linked source implementation."
14878
+ ],
14879
+ "sideEffects": [
14880
+ "class-dependent"
14881
+ ],
14882
+ "source": {
14883
+ "path": "packages/core/release-candidate-recovery.js",
14884
+ "line": 56
14885
+ },
14886
+ "example": "import { ReleaseCandidateRecoveryError } from \"@kungfu-tech/buildchain\";",
14887
+ "maturity": "stable",
14888
+ "audience": [
14889
+ "developer",
14890
+ "agent"
14891
+ ]
14892
+ },
14893
+ {
14894
+ "id": "packages/core/release-candidate-recovery.js#validateRecoveryTargetRef",
14895
+ "name": "validateRecoveryTargetRef",
14896
+ "kind": "function",
14897
+ "signature": "function validateRecoveryTargetRef({ targetSha, observedTargetSha, expectedTransactionId = \"\", existingTransaction = undefined, ancestry = undefined, } = {})",
14898
+ "parameters": [
14899
+ {
14900
+ "name": "parameter1",
14901
+ "signature": "{ targetSha, observedTargetSha, expectedTransactionId = \"\", existingTransaction = undefined, ancestry = undefined, } = {}"
14902
+ }
14903
+ ],
14904
+ "returns": "unknown",
14905
+ "errors": [
14906
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14907
+ ],
14908
+ "sideEffects": [
14909
+ "none-detected-by-static-source-scan"
14910
+ ],
14911
+ "source": {
14912
+ "path": "packages/core/release-candidate-recovery.js",
14913
+ "line": 134
14914
+ },
14915
+ "example": "import { validateRecoveryTargetRef } from \"@kungfu-tech/buildchain/release-candidate-recovery\";",
14916
+ "maturity": "stable",
14917
+ "audience": [
14918
+ "developer",
14919
+ "agent"
14920
+ ]
14921
+ },
14922
+ {
14923
+ "id": "packages/core/release-candidate-recovery.js#validateReleaseCandidateRecoveryReceipt",
14924
+ "name": "validateReleaseCandidateRecoveryReceipt",
14925
+ "kind": "function",
14926
+ "signature": "function validateReleaseCandidateRecoveryReceipt({ receipt, passport, repository = \"\", targetChannel = \"\", targetRef = \"\", targetSha = \"\", targetTree = \"\", version = \"\", } = {})",
14927
+ "parameters": [
14928
+ {
14929
+ "name": "parameter1",
14930
+ "signature": "{ receipt, passport, repository = \"\", targetChannel = \"\", targetRef = \"\", targetSha = \"\", targetTree = \"\", version = \"\", } = {}"
14931
+ }
14932
+ ],
14933
+ "returns": "unknown",
14934
+ "errors": [
14935
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14936
+ ],
14937
+ "sideEffects": [
14938
+ "none-detected-by-static-source-scan"
14939
+ ],
14940
+ "source": {
14941
+ "path": "packages/core/release-candidate-recovery.js",
14942
+ "line": 176
14943
+ },
14944
+ "example": "import { validateReleaseCandidateRecoveryReceipt } from \"@kungfu-tech/buildchain/release-candidate-recovery\";",
14945
+ "maturity": "stable",
14946
+ "audience": [
14947
+ "developer",
14948
+ "agent"
14949
+ ]
14950
+ },
14951
+ {
14952
+ "id": "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
14953
+ "name": "verifyReleaseCandidateRecovery",
14954
+ "kind": "function",
14955
+ "signature": "function verifyReleaseCandidateRecovery({ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetRefSha = targetSha, targetTree, expectedSourceTree = \"\", expectedCandidateRoot = \"\", expectedRuntimeSha, expectedTransactionId = \"\", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], platformManifestEvidence = [], productPayloadManifests = [], artifacts = [], publicationVersion = \"\", currentToolingSha, recoveryRunId = \"\", createdAt = new Date().toISOString(), } = {})",
14956
+ "parameters": [
14957
+ {
14958
+ "name": "parameter1",
14959
+ "signature": "{ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetRefSha = targetSha, targetTree, expectedSourceTree = \"\", expectedCandidateRoot = \"\", expectedRuntimeSha, expectedTransactionId = \"\", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], platformManifestEvidence = [], productPayloadManifests = [], artifacts = [], publicationVersion = \"\", currentToolingSha, recoveryRunId = \"\", createdAt = new Date().toISOString(), } = {}"
14960
+ }
14961
+ ],
14962
+ "returns": "unknown",
14963
+ "errors": [
14964
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14965
+ ],
14966
+ "sideEffects": [
14967
+ "none-detected-by-static-source-scan"
14968
+ ],
14969
+ "source": {
14970
+ "path": "packages/core/release-candidate-recovery.js",
14971
+ "line": 398
14972
+ },
14973
+ "example": "import { verifyReleaseCandidateRecovery } from \"@kungfu-tech/buildchain\";",
14974
+ "maturity": "stable",
14975
+ "audience": [
14976
+ "developer",
14977
+ "agent"
14978
+ ]
14979
+ },
13856
14980
  {
13857
14981
  "id": "packages/core/release-candidate.js#createReleaseCandidatePassport",
13858
14982
  "name": "createReleaseCandidatePassport",
@@ -16589,14 +17713,14 @@
16589
17713
  "specifier": "@kungfu-tech/buildchain",
16590
17714
  "export": ".",
16591
17715
  "target": "./packages/core/index.js",
16592
- "digest": "sha256:0a415732a05ad95fe9a8ae4da20df826f392c9c5227e9f0eee3722a3d97af49d",
17716
+ "digest": "sha256:6f22c5a7afd733e03d948cd322e01f7255b973780c89a70892c869eb3c15d05f",
16593
17717
  "summary": "Root toolkit export for Buildchain's public Node API.",
16594
17718
  "capabilityGroup": "api-cli-reference",
16595
17719
  "audience": [
16596
17720
  "developer",
16597
17721
  "agent"
16598
17722
  ],
16599
- "symbolCount": 558,
17723
+ "symbolCount": 562,
16600
17724
  "symbolIds": [
16601
17725
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
16602
17726
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -17017,6 +18141,7 @@
17017
18141
  "packages/core/publish-transaction.js#readReleaseTransaction",
17018
18142
  "packages/core/release-activation-transaction.js#recordReleaseActivationPhase",
17019
18143
  "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
18144
+ "packages/core/release-candidate-recovery.js#recoveryFailure",
17020
18145
  "packages/core/logging.js#redactBuildchainLogAttributes",
17021
18146
  "packages/core/diagnostics.js#redactDiagnosticsValue",
17022
18147
  "packages/core/issue-reporting.js#redactIssueText",
@@ -17026,6 +18151,7 @@
17026
18151
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_PHASES",
17027
18152
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_RECEIPT_SET_CONTRACT",
17028
18153
  "packages/core/release-candidate.js#RELEASE_CANDIDATE_PASSPORT_CONTRACT",
18154
+ "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
17029
18155
  "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
17030
18156
  "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
17031
18157
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_CHECK_MANIFEST_CONTRACT",
@@ -17044,6 +18170,7 @@
17044
18170
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
17045
18171
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_STAGES",
17046
18172
  "packages/core/release-activation-transaction.js#releaseActivationRoot",
18173
+ "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
17047
18174
  "packages/core/readme-badges.js#renderBadgeBundleBlock",
17048
18175
  "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
17049
18176
  "packages/core/homebrew.js#renderHomebrewFormula",
@@ -17138,6 +18265,7 @@
17138
18265
  "packages/core/publication-authority.js#verifyPublicationQualificationReceipt",
17139
18266
  "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
17140
18267
  "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
18268
+ "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
17141
18269
  "packages/core/release-passport.js#verifyReleasePassport",
17142
18270
  "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
17143
18271
  "packages/core/web-surface-publication-candidate.js#WEB_SURFACE_PRODUCTION_DECISION_CONTRACT",
@@ -17245,14 +18373,14 @@
17245
18373
  "specifier": "@kungfu-tech/buildchain/core",
17246
18374
  "export": "./core",
17247
18375
  "target": "./packages/core/index.js",
17248
- "digest": "sha256:0a415732a05ad95fe9a8ae4da20df826f392c9c5227e9f0eee3722a3d97af49d",
18376
+ "digest": "sha256:6f22c5a7afd733e03d948cd322e01f7255b973780c89a70892c869eb3c15d05f",
17249
18377
  "summary": "Alias for the root public toolkit export.",
17250
18378
  "capabilityGroup": "api-cli-reference",
17251
18379
  "audience": [
17252
18380
  "developer",
17253
18381
  "agent"
17254
18382
  ],
17255
- "symbolCount": 558,
18383
+ "symbolCount": 562,
17256
18384
  "symbolIds": [
17257
18385
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
17258
18386
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -17673,6 +18801,7 @@
17673
18801
  "packages/core/publish-transaction.js#readReleaseTransaction",
17674
18802
  "packages/core/release-activation-transaction.js#recordReleaseActivationPhase",
17675
18803
  "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
18804
+ "packages/core/release-candidate-recovery.js#recoveryFailure",
17676
18805
  "packages/core/logging.js#redactBuildchainLogAttributes",
17677
18806
  "packages/core/diagnostics.js#redactDiagnosticsValue",
17678
18807
  "packages/core/issue-reporting.js#redactIssueText",
@@ -17682,6 +18811,7 @@
17682
18811
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_PHASES",
17683
18812
  "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_RECEIPT_SET_CONTRACT",
17684
18813
  "packages/core/release-candidate.js#RELEASE_CANDIDATE_PASSPORT_CONTRACT",
18814
+ "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
17685
18815
  "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
17686
18816
  "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
17687
18817
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_CHECK_MANIFEST_CONTRACT",
@@ -17700,6 +18830,7 @@
17700
18830
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
17701
18831
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_STAGES",
17702
18832
  "packages/core/release-activation-transaction.js#releaseActivationRoot",
18833
+ "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
17703
18834
  "packages/core/readme-badges.js#renderBadgeBundleBlock",
17704
18835
  "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
17705
18836
  "packages/core/homebrew.js#renderHomebrewFormula",
@@ -17794,6 +18925,7 @@
17794
18925
  "packages/core/publication-authority.js#verifyPublicationQualificationReceipt",
17795
18926
  "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
17796
18927
  "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
18928
+ "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
17797
18929
  "packages/core/release-passport.js#verifyReleasePassport",
17798
18930
  "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
17799
18931
  "packages/core/web-surface-publication-candidate.js#WEB_SURFACE_PRODUCTION_DECISION_CONTRACT",
@@ -18034,7 +19166,7 @@
18034
19166
  "specifier": "@kungfu-tech/buildchain/buildchain-contract",
18035
19167
  "export": "./buildchain-contract",
18036
19168
  "target": "./packages/core/buildchain-contract.js",
18037
- "digest": "sha256:876f747eccd92d31e821c85b2f38a54ba6056704adfb30cbf7e545ff61148625",
19169
+ "digest": "sha256:90e88e4ac4759838afc4d760811ab30aad3e79066ba64fc69c81a31f3fffd291",
18038
19170
  "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
18039
19171
  "capabilityGroup": "governance-versioning",
18040
19172
  "audience": [
@@ -18095,7 +19227,7 @@
18095
19227
  "specifier": "@kungfu-tech/buildchain/channel-candidate",
18096
19228
  "export": "./channel-candidate",
18097
19229
  "target": "./packages/core/channel-candidate.js",
18098
- "digest": "sha256:4f667440dc1d3df1663fba13afe68358aa3fc0c9316d1393e760bd932cec8a45",
19230
+ "digest": "sha256:2dcd0899d8c0f4bbb7876108529f4bed0e5e82f6536474a1a505e65a322d10a6",
18099
19231
  "summary": "Exact-source channel candidate decisions, same-SHA workflow evidence validation, and deterministic source-lock reference APIs.",
18100
19232
  "capabilityGroup": "governance-versioning",
18101
19233
  "audience": [
@@ -18233,6 +19365,60 @@
18233
19365
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
18234
19366
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
18235
19367
  },
19368
+ {
19369
+ "specifier": "@kungfu-tech/buildchain/dev-delivery-warrant",
19370
+ "export": "./dev-delivery-warrant",
19371
+ "target": "./packages/core/dev-delivery-warrant.js",
19372
+ "digest": "sha256:09a0b75d556d9722faab70a7e9113701f33edf51386d6c4d5f00c7a1d786e925",
19373
+ "summary": "Durable fair Dev Delivery Warrant queue, fenced lease, and split source and integration proof APIs.",
19374
+ "capabilityGroup": "governance-versioning",
19375
+ "audience": [
19376
+ "developer",
19377
+ "agent"
19378
+ ],
19379
+ "symbolCount": 32,
19380
+ "symbolIds": [
19381
+ "packages/core/dev-delivery-warrant.js#cancelQueuedDevDeliveryCandidate",
19382
+ "packages/core/dev-delivery-proof.js#classifyDevDeliveryDelta",
19383
+ "packages/core/dev-delivery-warrant.js#closeDevDeliveryWarrant",
19384
+ "packages/core/dev-delivery-warrant.js#createDevDeliveryQueue",
19385
+ "packages/core/dev-delivery-proof.js#createIntegrationDeliveryProof",
19386
+ "packages/core/dev-delivery-proof.js#createProjectCutReplayPlan",
19387
+ "packages/core/dev-delivery-proof.js#createProjectCutReplayProof",
19388
+ "packages/core/dev-delivery-proof.js#createSourceQualificationProof",
19389
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_CANCELLATION_RECEIPT_SCHEMA",
19390
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_CLASSES",
19391
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_LEASE_RECEIPT_SCHEMA",
19392
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_PRIORITIES",
19393
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_QUEUE_CONTRACT",
19394
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA",
19395
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA",
19396
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA",
19397
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_WARRANT_SCHEMA",
19398
+ "packages/core/dev-delivery-common.js#devDeliveryContentRoot",
19399
+ "packages/core/dev-delivery-warrant.js#heartbeatDevDeliveryWarrant",
19400
+ "packages/core/dev-delivery-proof.js#INTEGRATION_DELIVERY_PROOF_SCHEMA",
19401
+ "packages/core/dev-delivery-warrant.js#normalizeDevDeliveryQueue",
19402
+ "packages/core/dev-delivery-warrant.js#observeDevDeliveryQueue",
19403
+ "packages/core/dev-delivery-proof.js#PROJECT_CUT_REPLAY_PROOF_SCHEMA",
19404
+ "packages/core/dev-delivery-warrant.js#rankDevDeliveryCandidates",
19405
+ "packages/core/dev-delivery-warrant.js#recoverExpiredDevDeliveryWarrant",
19406
+ "packages/core/dev-delivery-warrant.js#selectDevDeliveryWarrant",
19407
+ "packages/core/dev-delivery-warrant.js#settleDevDeliveryTerminalEvent",
19408
+ "packages/core/dev-delivery-proof.js#SOURCE_QUALIFICATION_PROOF_SCHEMA",
19409
+ "packages/core/dev-delivery-warrant.js#submitDevDeliveryCandidate",
19410
+ "packages/core/dev-delivery-proof.js#verifyIntegrationDeliveryProof",
19411
+ "packages/core/dev-delivery-proof.js#verifyProjectCutReplayProof",
19412
+ "packages/core/dev-delivery-proof.js#verifySourceQualificationProof"
19413
+ ],
19414
+ "owner": "buildchain-core",
19415
+ "maturity": "stable",
19416
+ "introducedVersion": "pre-3.0.2-alpha.4",
19417
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
19418
+ "deprecationReplacement": "",
19419
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
19420
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
19421
+ },
18236
19422
  {
18237
19423
  "specifier": "@kungfu-tech/buildchain/homebrew",
18238
19424
  "export": "./homebrew",
@@ -18706,7 +19892,7 @@
18706
19892
  "specifier": "@kungfu-tech/buildchain/publication-sealed-bundle",
18707
19893
  "export": "./publication-sealed-bundle",
18708
19894
  "target": "./packages/core/publication-sealed-bundle.js",
18709
- "digest": "sha256:9b1405a04548c9a87863c2cf410224f6cd7b44e06b76e0de0f7b8052029bc92d",
19895
+ "digest": "sha256:0b912deace895b3f99e7a77b77678d35a7c22a68b3d18eb31aff2995fb66a51e",
18710
19896
  "summary": "Build-once publication bundle manifests and exact-byte resume verification APIs.",
18711
19897
  "capabilityGroup": "reusable-build",
18712
19898
  "audience": [
@@ -18873,7 +20059,7 @@
18873
20059
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
18874
20060
  "export": "./buildchain-publication-authority",
18875
20061
  "target": "./packages/core/buildchain-publication-authority.js",
18876
- "digest": "sha256:377c23328c8d07fd98def4e2f170d68294893f695cda8cb85766c45083510e87",
20062
+ "digest": "sha256:25816efeee5367eb512f97a2daf5788e1095b81c794b8eca933888acacf3d9a4",
18877
20063
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
18878
20064
  "capabilityGroup": "release-passport-trust",
18879
20065
  "audience": [
@@ -19005,6 +20191,35 @@
19005
20191
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
19006
20192
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
19007
20193
  },
20194
+ {
20195
+ "specifier": "@kungfu-tech/buildchain/release-candidate-recovery",
20196
+ "export": "./release-candidate-recovery",
20197
+ "target": "./packages/core/release-candidate-recovery.js",
20198
+ "digest": "sha256:d863601bcd5be9cfbf4455961d1183486e6d191ce34dc7c6a14f2ad71146b175",
20199
+ "summary": "Fail-closed verification and immutable receipts for reusing a successful sealed candidate run without rebuilding product payloads.",
20200
+ "capabilityGroup": "release-passport-trust",
20201
+ "audience": [
20202
+ "developer",
20203
+ "agent"
20204
+ ],
20205
+ "symbolCount": 7,
20206
+ "symbolIds": [
20207
+ "packages/core/release-candidate-recovery.js#rebindPublicationGateAggregateForEquivalentTree",
20208
+ "packages/core/release-candidate-recovery.js#recoveryFailure",
20209
+ "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
20210
+ "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
20211
+ "packages/core/release-candidate-recovery.js#validateRecoveryTargetRef",
20212
+ "packages/core/release-candidate-recovery.js#validateReleaseCandidateRecoveryReceipt",
20213
+ "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery"
20214
+ ],
20215
+ "owner": "buildchain-core",
20216
+ "maturity": "stable",
20217
+ "introducedVersion": "pre-3.0.2-alpha.4",
20218
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
20219
+ "deprecationReplacement": "",
20220
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
20221
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
20222
+ },
19008
20223
  {
19009
20224
  "specifier": "@kungfu-tech/buildchain/stable-candidate-ledger",
19010
20225
  "export": "./stable-candidate-ledger",
@@ -19274,7 +20489,7 @@
19274
20489
  {
19275
20490
  "id": "node-api-reference",
19276
20491
  "path": "docs/node-api-reference.md",
19277
- "digest": "sha256:ae49a589091d1ab91d29f2d6ac52cf2551a9d0b1f78350965b408f40fd219e29"
20492
+ "digest": "sha256:f5592359584e98ab4283d56b0262fdcf9c5da61f48033cecad1b0404aa95bd2e"
19278
20493
  },
19279
20494
  {
19280
20495
  "id": "build-facts",