@kungfu-tech/buildchain 4.0.1-alpha.8 → 4.0.1

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 (98) hide show
  1. package/README.md +9 -6
  2. package/actions/v4-release-candidate-promote/README.md +3 -0
  3. package/architecture/agent-change-map.md +1015 -0
  4. package/architecture/ci-lane-change-budget.json +70 -1
  5. package/architecture/decisions/0004-v4-declarative-release-tail.md +47 -0
  6. package/architecture/internal-capabilities.json +156 -11
  7. package/architecture/maintainability-debt.json +3229 -0
  8. package/architecture/maintainability-policy.json +480 -129
  9. package/architecture/v3-core-mechanism-inventory.json +4 -3
  10. package/architecture/v3-v4-capability-closure.md +59 -0
  11. package/architecture/v3-v4-live-capability-inventory.json +102404 -0
  12. package/architecture/v4-cross-platform-adopter-qualification.json +52 -0
  13. package/architecture/v4-delivery-warrant-shadow-fixtures.json +3 -3
  14. package/architecture/v4-runtime-semantic-closure.json +710 -0
  15. package/bin/internal/trust-release-release-handlers.mjs +5 -0
  16. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
  17. package/contracts/v4-publication-qualification-v1.schema.json +51 -0
  18. package/dist/site/agent-index.json +1 -0
  19. package/dist/site/artifact-schemas.json +2 -0
  20. package/dist/site/buildchain-contract.json +123 -32
  21. package/dist/site/buildchain-site.json +96 -28
  22. package/dist/site/capability-registry.json +6 -6
  23. package/dist/site/cli-registry.json +5 -2
  24. package/dist/site/controller-registry.json +41 -5
  25. package/dist/site/kfd-claims.json +170 -21
  26. package/dist/site/kfd-upstream-aggregate.json +1 -1
  27. package/dist/site/manual-registry.json +6 -6
  28. package/dist/site/node-api-registry.json +1474 -215
  29. package/dist/site/page-registry.json +85 -17
  30. package/dist/site/public-surface-audit.json +85 -20
  31. package/dist/site/publication-authority-registry.json +28 -1
  32. package/dist/site/publication-registry.json +4 -4
  33. package/dist/site/release-provenance.json +5 -0
  34. package/dist/site/schemas/v4-publication-qualification-v1.schema.json +51 -0
  35. package/dist/site/site-manifest.json +10 -10
  36. package/dist/site/workflow-registry.json +94 -18
  37. package/docs/MAP.md +1 -1
  38. package/docs/cli-reference.md +4 -4
  39. package/docs/dev-delivery-warrant.md +12 -9
  40. package/docs/node-api-reference.md +291 -206
  41. package/docs/publish-transaction.md +11 -4
  42. package/docs/release-candidate.md +7 -0
  43. package/docs/v4-adopter-delivery.md +23 -4
  44. package/docs/v4-declarative-release-tail-migration.md +43 -0
  45. package/package.json +8 -3
  46. package/packages/core/adopter-delivery-passport.js +36 -0
  47. package/packages/core/buildchain-contract.js +31 -1
  48. package/packages/core/buildchain-publication-authority.js +1 -0
  49. package/packages/core/dev-delivery-warrant-settlement.js +239 -3
  50. package/packages/core/dev-delivery-warrant-state.js +15 -2
  51. package/packages/core/dev-delivery-warrant.js +21 -4
  52. package/packages/core/github-governance-authority.js +4 -4
  53. package/packages/core/index.js +1 -0
  54. package/packages/core/paper-scaffold-content.js +401 -0
  55. package/packages/core/paper.js +12 -378
  56. package/packages/core/publication-control-plane-audit.js +135 -111
  57. package/packages/core/publication-rehearsal-projection.js +104 -0
  58. package/packages/core/publication-rehearsal-runtime.js +190 -0
  59. package/packages/core/release-candidate-recovery.js +6 -5
  60. package/packages/core/release-passport.js +82 -184
  61. package/packages/core/v4-cross-platform-adopter-qualification.js +343 -0
  62. package/packages/core/v4-floating-consumer-policy.js +3 -2
  63. package/packages/core/v4-floating-consumer-release-passport.js +134 -15
  64. package/packages/core/v4-publication-qualification.js +222 -0
  65. package/scripts/artifact-signing-controller-core.mjs +1 -1
  66. package/scripts/audit-publication-control-plane.mjs +17 -17
  67. package/scripts/buildchain-cli-help.mjs +3 -0
  68. package/scripts/check-internal-architecture.mjs +23 -3
  69. package/scripts/check-inventory.mjs +23 -5
  70. package/scripts/check-maintainability.mjs +145 -4
  71. package/scripts/check-project-cut-merge-queue-admission.mjs +87 -0
  72. package/scripts/check-v3-v4-capability-inventory.mjs +574 -0
  73. package/scripts/check-v4-floating-consumer-policy-contract.mjs +10 -3
  74. package/scripts/check-v4-runtime-semantic-closure.mjs +266 -0
  75. package/scripts/dev-delivery-warrant-options.mjs +27 -11
  76. package/scripts/dev-delivery-warrant.mjs +45 -5
  77. package/scripts/dev-pr-auto-merge.mjs +25 -11
  78. package/scripts/dev-pr-delivery-warrant.mjs +44 -0
  79. package/scripts/dev-pr-prequeue-guard.mjs +0 -18
  80. package/scripts/dispatch-artifact-signing-authority.mjs +1 -1
  81. package/scripts/generate-agent-change-map.mjs +118 -0
  82. package/scripts/generate-release-candidate-passport.mjs +26 -1
  83. package/scripts/generate-site-bundle.mjs +6 -0
  84. package/scripts/maintainability-domain-metrics.mjs +237 -0
  85. package/scripts/maintainability-governance.mjs +473 -0
  86. package/scripts/maintainability-metrics.mjs +28 -6
  87. package/scripts/project-cut-merge-queue-admission.mjs +394 -0
  88. package/scripts/promotion-routing-evidence.mjs +35 -6
  89. package/scripts/release-candidate-resolver.mjs +44 -0
  90. package/scripts/release-line-policy.mjs +25 -15
  91. package/scripts/release-tail.mjs +19 -2
  92. package/scripts/resume-from-candidate-run.mjs +106 -103
  93. package/scripts/run-lifecycle-core.mjs +341 -376
  94. package/scripts/site-capability-metadata.mjs +4 -0
  95. package/scripts/stable-candidate-qualification.mjs +9 -10
  96. package/scripts/v3-v4-capability-catalog.mjs +439 -0
  97. package/scripts/v4-cross-platform-adopter-qualification.mjs +228 -0
  98. package/scripts/v4-declarative-promotion-admission.mjs +42 -0
@@ -318,7 +318,7 @@
318
318
  ],
319
319
  "source": {
320
320
  "path": "packages/core/adopter-delivery-passport.js",
321
- "line": 131
321
+ "line": 167
322
322
  },
323
323
  "example": "import { createAdopterDeliveryPassportBinding } from \"@kungfu-tech/buildchain/adopter-delivery-passport\";",
324
324
  "maturity": "stable",
@@ -347,7 +347,7 @@
347
347
  ],
348
348
  "source": {
349
349
  "path": "packages/core/adopter-delivery-passport.js",
350
- "line": 151
350
+ "line": 187
351
351
  },
352
352
  "example": "import { normalizeAdopterDeliveryPassportBinding } from \"@kungfu-tech/buildchain/adopter-delivery-passport\";",
353
353
  "maturity": "stable",
@@ -356,6 +356,35 @@
356
356
  "agent"
357
357
  ]
358
358
  },
359
+ {
360
+ "id": "packages/core/adopter-delivery-passport.js#releasePassportKfdAdopterSourceSha",
361
+ "name": "releasePassportKfdAdopterSourceSha",
362
+ "kind": "function",
363
+ "signature": "function releasePassportKfdAdopterSourceSha({ passportSourceSha = \"\", release = undefined, } = {})",
364
+ "parameters": [
365
+ {
366
+ "name": "parameter1",
367
+ "signature": "{ passportSourceSha = \"\", release = undefined, } = {}"
368
+ }
369
+ ],
370
+ "returns": "unknown",
371
+ "errors": [
372
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
373
+ ],
374
+ "sideEffects": [
375
+ "none-detected-by-static-source-scan"
376
+ ],
377
+ "source": {
378
+ "path": "packages/core/adopter-delivery-passport.js",
379
+ "line": 12
380
+ },
381
+ "example": "import { releasePassportKfdAdopterSourceSha } from \"@kungfu-tech/buildchain/adopter-delivery-passport\";",
382
+ "maturity": "stable",
383
+ "audience": [
384
+ "developer",
385
+ "agent"
386
+ ]
387
+ },
359
388
  {
360
389
  "id": "packages/core/adopter-delivery-passport.js#validateAdopterDeliveryGateResult",
361
390
  "name": "validateAdopterDeliveryGateResult",
@@ -376,7 +405,7 @@
376
405
  ],
377
406
  "source": {
378
407
  "path": "packages/core/adopter-delivery-passport.js",
379
- "line": 104
408
+ "line": 140
380
409
  },
381
410
  "example": "import { validateAdopterDeliveryGateResult } from \"@kungfu-tech/buildchain/adopter-delivery-passport\";",
382
411
  "maturity": "stable",
@@ -409,7 +438,7 @@
409
438
  ],
410
439
  "source": {
411
440
  "path": "packages/core/adopter-delivery-passport.js",
412
- "line": 158
441
+ "line": 194
413
442
  },
414
443
  "example": "import { validateAdopterDeliveryPassportBinding } from \"@kungfu-tech/buildchain/adopter-delivery-passport\";",
415
444
  "maturity": "stable",
@@ -438,7 +467,7 @@
438
467
  ],
439
468
  "source": {
440
469
  "path": "packages/core/adopter-delivery-passport.js",
441
- "line": 233
470
+ "line": 269
442
471
  },
443
472
  "example": "import { validateAdopterDeliveryReleaseEvidence } from \"@kungfu-tech/buildchain/adopter-delivery-passport\";",
444
473
  "maturity": "stable",
@@ -3285,7 +3314,7 @@
3285
3314
  ],
3286
3315
  "source": {
3287
3316
  "path": "packages/core/buildchain-contract.js",
3288
- "line": 981
3317
+ "line": 1011
3289
3318
  },
3290
3319
  "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
3291
3320
  "maturity": "stable",
@@ -3314,7 +3343,7 @@
3314
3343
  ],
3315
3344
  "source": {
3316
3345
  "path": "packages/core/buildchain-contract.js",
3317
- "line": 910
3346
+ "line": 940
3318
3347
  },
3319
3348
  "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
3320
3349
  "maturity": "stable",
@@ -3343,7 +3372,7 @@
3343
3372
  ],
3344
3373
  "source": {
3345
3374
  "path": "packages/core/buildchain-contract.js",
3346
- "line": 169
3375
+ "line": 199
3347
3376
  },
3348
3377
  "example": "import { createBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
3349
3378
  "maturity": "stable",
@@ -3396,7 +3425,7 @@
3396
3425
  ],
3397
3426
  "source": {
3398
3427
  "path": "packages/core/buildchain-contract.js",
3399
- "line": 977
3428
+ "line": 1007
3400
3429
  },
3401
3430
  "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
3402
3431
  "maturity": "stable",
@@ -3425,7 +3454,7 @@
3425
3454
  ],
3426
3455
  "source": {
3427
3456
  "path": "packages/core/buildchain-contract.js",
3428
- "line": 851
3457
+ "line": 881
3429
3458
  },
3430
3459
  "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
3431
3460
  "maturity": "stable",
@@ -3502,7 +3531,7 @@
3502
3531
  ],
3503
3532
  "source": {
3504
3533
  "path": "packages/core/buildchain-contract.js",
3505
- "line": 966
3534
+ "line": 996
3506
3535
  },
3507
3536
  "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
3508
3537
  "maturity": "stable",
@@ -3531,7 +3560,7 @@
3531
3560
  ],
3532
3561
  "source": {
3533
3562
  "path": "packages/core/buildchain-contract.js",
3534
- "line": 946
3563
+ "line": 976
3535
3564
  },
3536
3565
  "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
3537
3566
  "maturity": "stable",
@@ -3560,7 +3589,7 @@
3560
3589
  ],
3561
3590
  "source": {
3562
3591
  "path": "packages/core/buildchain-contract.js",
3563
- "line": 996
3592
+ "line": 1026
3564
3593
  },
3565
3594
  "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
3566
3595
  "maturity": "stable",
@@ -5247,7 +5276,7 @@
5247
5276
  ],
5248
5277
  "source": {
5249
5278
  "path": "packages/core/buildchain-publication-authority.js",
5250
- "line": 63
5279
+ "line": 64
5251
5280
  },
5252
5281
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
5253
5282
  "maturity": "stable",
@@ -5276,7 +5305,7 @@
5276
5305
  ],
5277
5306
  "source": {
5278
5307
  "path": "packages/core/buildchain-publication-authority.js",
5279
- "line": 87
5308
+ "line": 88
5280
5309
  },
5281
5310
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
5282
5311
  "maturity": "stable",
@@ -8120,7 +8149,7 @@
8120
8149
  ],
8121
8150
  "source": {
8122
8151
  "path": "packages/core/dev-delivery-warrant.js",
8123
- "line": 508
8152
+ "line": 512
8124
8153
  },
8125
8154
  "example": "import { cancelQueuedDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8126
8155
  "maturity": "stable",
@@ -8157,7 +8186,7 @@
8157
8186
  ],
8158
8187
  "source": {
8159
8188
  "path": "packages/core/dev-delivery-warrant.js",
8160
- "line": 384
8189
+ "line": 387
8161
8190
  },
8162
8191
  "example": "import { closeDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8163
8192
  "maturity": "stable",
@@ -8382,6 +8411,30 @@
8382
8411
  "agent"
8383
8412
  ]
8384
8413
  },
8414
+ {
8415
+ "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_TERMINAL_EVIDENCE_CORRECTION_SCHEMA",
8416
+ "name": "DEV_DELIVERY_TERMINAL_EVIDENCE_CORRECTION_SCHEMA",
8417
+ "kind": "value",
8418
+ "signature": "DEV_DELIVERY_TERMINAL_EVIDENCE_CORRECTION_SCHEMA",
8419
+ "parameters": [],
8420
+ "returns": "unknown",
8421
+ "errors": [
8422
+ "No narrower error contract was mechanically discoverable."
8423
+ ],
8424
+ "sideEffects": [
8425
+ "unknown"
8426
+ ],
8427
+ "source": {
8428
+ "path": "packages/core/dev-delivery-warrant.js",
8429
+ "line": 1
8430
+ },
8431
+ "example": "import { DEV_DELIVERY_TERMINAL_EVIDENCE_CORRECTION_SCHEMA } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8432
+ "maturity": "stable",
8433
+ "audience": [
8434
+ "developer",
8435
+ "agent"
8436
+ ]
8437
+ },
8385
8438
  {
8386
8439
  "id": "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_WARRANT_SCHEMA",
8387
8440
  "name": "DEV_DELIVERY_WARRANT_SCHEMA",
@@ -8434,7 +8487,7 @@
8434
8487
  ],
8435
8488
  "source": {
8436
8489
  "path": "packages/core/dev-delivery-warrant.js",
8437
- "line": 255
8490
+ "line": 258
8438
8491
  },
8439
8492
  "example": "import { heartbeatDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8440
8493
  "maturity": "stable",
@@ -8491,7 +8544,7 @@
8491
8544
  ],
8492
8545
  "source": {
8493
8546
  "path": "packages/core/dev-delivery-warrant.js",
8494
- "line": 517
8547
+ "line": 526
8495
8548
  },
8496
8549
  "example": "import { observeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8497
8550
  "maturity": "stable",
@@ -8515,7 +8568,7 @@
8515
8568
  ],
8516
8569
  "source": {
8517
8570
  "path": "packages/core/dev-delivery-warrant.js",
8518
- "line": 380
8571
+ "line": 383
8519
8572
  },
8520
8573
  "example": "import { qualifyDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8521
8574
  "maturity": "stable",
@@ -8548,6 +8601,30 @@
8548
8601
  "agent"
8549
8602
  ]
8550
8603
  },
8604
+ {
8605
+ "id": "packages/core/dev-delivery-warrant.js#reconcileDevDeliveryTerminalEvidence",
8606
+ "name": "reconcileDevDeliveryTerminalEvidence",
8607
+ "kind": "constant",
8608
+ "signature": "const reconcileDevDeliveryTerminalEvidence",
8609
+ "parameters": [],
8610
+ "returns": "value",
8611
+ "errors": [
8612
+ "Import does not declare a throw contract."
8613
+ ],
8614
+ "sideEffects": [
8615
+ "none-on-import"
8616
+ ],
8617
+ "source": {
8618
+ "path": "packages/core/dev-delivery-warrant.js",
8619
+ "line": 521
8620
+ },
8621
+ "example": "import { reconcileDevDeliveryTerminalEvidence } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8622
+ "maturity": "stable",
8623
+ "audience": [
8624
+ "developer",
8625
+ "agent"
8626
+ ]
8627
+ },
8551
8628
  {
8552
8629
  "id": "packages/core/dev-delivery-warrant.js#recoverExpiredDevDeliveryWarrant",
8553
8630
  "name": "recoverExpiredDevDeliveryWarrant",
@@ -8572,7 +8649,7 @@
8572
8649
  ],
8573
8650
  "source": {
8574
8651
  "path": "packages/core/dev-delivery-warrant.js",
8575
- "line": 301
8652
+ "line": 304
8576
8653
  },
8577
8654
  "example": "import { recoverExpiredDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8578
8655
  "maturity": "stable",
@@ -8605,7 +8682,7 @@
8605
8682
  ],
8606
8683
  "source": {
8607
8684
  "path": "packages/core/dev-delivery-warrant.js",
8608
- "line": 95
8685
+ "line": 98
8609
8686
  },
8610
8687
  "example": "import { selectDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8611
8688
  "maturity": "stable",
@@ -8629,7 +8706,7 @@
8629
8706
  ],
8630
8707
  "source": {
8631
8708
  "path": "packages/core/dev-delivery-warrant.js",
8632
- "line": 511
8709
+ "line": 515
8633
8710
  },
8634
8711
  "example": "import { settleDevDeliveryTerminalEvent } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
8635
8712
  "maturity": "stable",
@@ -10541,7 +10618,7 @@
10541
10618
  ],
10542
10619
  "source": {
10543
10620
  "path": "packages/core/github-governance-authority.js",
10544
- "line": 420
10621
+ "line": 422
10545
10622
  },
10546
10623
  "example": "import { codeownersForPath } from \"@kungfu-tech/buildchain\";",
10547
10624
  "maturity": "stable",
@@ -10570,7 +10647,7 @@
10570
10647
  ],
10571
10648
  "source": {
10572
10649
  "path": "packages/core/github-governance-authority.js",
10573
- "line": 314
10650
+ "line": 316
10574
10651
  },
10575
10652
  "example": "import { compileEffectiveGithubGovernancePolicy } from \"@kungfu-tech/buildchain\";",
10576
10653
  "maturity": "stable",
@@ -10594,7 +10671,7 @@
10594
10671
  ],
10595
10672
  "source": {
10596
10673
  "path": "packages/core/github-governance-authority.js",
10597
- "line": 453
10674
+ "line": 455
10598
10675
  },
10599
10676
  "example": "import { createBuildchainGithubGovernanceAuthority } from \"@kungfu-tech/buildchain\";",
10600
10677
  "maturity": "stable",
@@ -10710,7 +10787,7 @@
10710
10787
  ],
10711
10788
  "source": {
10712
10789
  "path": "packages/core/github-governance-authority.js",
10713
- "line": 428
10790
+ "line": 430
10714
10791
  },
10715
10792
  "example": "import { evaluateCodeownersAuthority } from \"@kungfu-tech/buildchain\";",
10716
10793
  "maturity": "stable",
@@ -10864,7 +10941,7 @@
10864
10941
  ],
10865
10942
  "source": {
10866
10943
  "path": "packages/core/github-governance-authority.js",
10867
- "line": 166
10944
+ "line": 168
10868
10945
  },
10869
10946
  "example": "import { githubGovernanceDigest } from \"@kungfu-tech/buildchain\";",
10870
10947
  "maturity": "stable",
@@ -10980,7 +11057,7 @@
10980
11057
  ],
10981
11058
  "source": {
10982
11059
  "path": "packages/core/github-governance-authority.js",
10983
- "line": 404
11060
+ "line": 406
10984
11061
  },
10985
11062
  "example": "import { parseCodeowners } from \"@kungfu-tech/buildchain\";",
10986
11063
  "maturity": "stable",
@@ -16501,7 +16578,7 @@
16501
16578
  ],
16502
16579
  "source": {
16503
16580
  "path": "packages/core/paper.js",
16504
- "line": 2425
16581
+ "line": 2059
16505
16582
  },
16506
16583
  "example": "import { collectPaperPreflight } from \"@kungfu-tech/buildchain\";",
16507
16584
  "maturity": "stable",
@@ -16530,7 +16607,7 @@
16530
16607
  ],
16531
16608
  "source": {
16532
16609
  "path": "packages/core/paper.js",
16533
- "line": 1483
16610
+ "line": 1117
16534
16611
  },
16535
16612
  "example": "import { collectPaperStatus } from \"@kungfu-tech/buildchain\";",
16536
16613
  "maturity": "stable",
@@ -16559,7 +16636,7 @@
16559
16636
  ],
16560
16637
  "source": {
16561
16638
  "path": "packages/core/paper.js",
16562
- "line": 2667
16639
+ "line": 2301
16563
16640
  },
16564
16641
  "example": "import { createPaperAlphaPlan } from \"@kungfu-tech/buildchain\";",
16565
16642
  "maturity": "stable",
@@ -16588,7 +16665,7 @@
16588
16665
  ],
16589
16666
  "source": {
16590
16667
  "path": "packages/core/paper.js",
16591
- "line": 2604
16668
+ "line": 2238
16592
16669
  },
16593
16670
  "example": "import { createPaperBuildPlan } from \"@kungfu-tech/buildchain\";",
16594
16671
  "maturity": "stable",
@@ -16610,14 +16687,14 @@
16610
16687
  ],
16611
16688
  "returns": "unknown",
16612
16689
  "errors": [
16613
- "Errors from called operations may propagate; no narrower throw contract is declared in source."
16690
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
16614
16691
  ],
16615
16692
  "sideEffects": [
16616
16693
  "none-detected-by-static-source-scan"
16617
16694
  ],
16618
16695
  "source": {
16619
16696
  "path": "packages/core/paper.js",
16620
- "line": 524
16697
+ "line": 525
16621
16698
  },
16622
16699
  "example": "import { createPaperProvisioningAuthority } from \"@kungfu-tech/buildchain/paper\";",
16623
16700
  "maturity": "stable",
@@ -16646,7 +16723,7 @@
16646
16723
  ],
16647
16724
  "source": {
16648
16725
  "path": "packages/core/paper.js",
16649
- "line": 2725
16726
+ "line": 2359
16650
16727
  },
16651
16728
  "example": "import { createPaperResumePlan } from \"@kungfu-tech/buildchain\";",
16652
16729
  "maturity": "stable",
@@ -16675,7 +16752,7 @@
16675
16752
  ],
16676
16753
  "source": {
16677
16754
  "path": "packages/core/paper.js",
16678
- "line": 2852
16755
+ "line": 2486
16679
16756
  },
16680
16757
  "example": "import { executePaperNpmBootstrap } from \"@kungfu-tech/buildchain\";",
16681
16758
  "maturity": "stable",
@@ -16699,7 +16776,7 @@
16699
16776
  ],
16700
16777
  "source": {
16701
16778
  "path": "packages/core/paper.js",
16702
- "line": 95
16779
+ "line": 96
16703
16780
  },
16704
16781
  "example": "import { PAPER_ALPHA_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
16705
16782
  "maturity": "stable",
@@ -16723,7 +16800,7 @@
16723
16800
  ],
16724
16801
  "source": {
16725
16802
  "path": "packages/core/paper.js",
16726
- "line": 94
16803
+ "line": 95
16727
16804
  },
16728
16805
  "example": "import { PAPER_BUILD_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
16729
16806
  "maturity": "stable",
@@ -16747,7 +16824,7 @@
16747
16824
  ],
16748
16825
  "source": {
16749
16826
  "path": "packages/core/paper.js",
16750
- "line": 87
16827
+ "line": 88
16751
16828
  },
16752
16829
  "example": "import { PAPER_MIGRATION_CONTRACT } from \"@kungfu-tech/buildchain\";",
16753
16830
  "maturity": "stable",
@@ -16771,7 +16848,7 @@
16771
16848
  ],
16772
16849
  "source": {
16773
16850
  "path": "packages/core/paper.js",
16774
- "line": 90
16851
+ "line": 91
16775
16852
  },
16776
16853
  "example": "import { PAPER_NPM_BOOTSTRAP_CONTRACT } from \"@kungfu-tech/buildchain\";",
16777
16854
  "maturity": "stable",
@@ -16795,7 +16872,7 @@
16795
16872
  ],
16796
16873
  "source": {
16797
16874
  "path": "packages/core/paper.js",
16798
- "line": 88
16875
+ "line": 89
16799
16876
  },
16800
16877
  "example": "import { PAPER_PREFLIGHT_CONTRACT } from \"@kungfu-tech/buildchain\";",
16801
16878
  "maturity": "stable",
@@ -16819,7 +16896,7 @@
16819
16896
  ],
16820
16897
  "source": {
16821
16898
  "path": "packages/core/paper.js",
16822
- "line": 92
16899
+ "line": 93
16823
16900
  },
16824
16901
  "example": "import { PAPER_PROVISIONING_CONTRACT } from \"@kungfu-tech/buildchain/paper\";",
16825
16902
  "maturity": "stable",
@@ -16843,7 +16920,7 @@
16843
16920
  ],
16844
16921
  "source": {
16845
16922
  "path": "packages/core/paper.js",
16846
- "line": 96
16923
+ "line": 97
16847
16924
  },
16848
16925
  "example": "import { PAPER_RESUME_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
16849
16926
  "maturity": "stable",
@@ -16867,7 +16944,7 @@
16867
16944
  ],
16868
16945
  "source": {
16869
16946
  "path": "packages/core/paper.js",
16870
- "line": 86
16947
+ "line": 87
16871
16948
  },
16872
16949
  "example": "import { PAPER_SCAFFOLD_CONTRACT } from \"@kungfu-tech/buildchain\";",
16873
16950
  "maturity": "stable",
@@ -16891,7 +16968,7 @@
16891
16968
  ],
16892
16969
  "source": {
16893
16970
  "path": "packages/core/paper.js",
16894
- "line": 99
16971
+ "line": 100
16895
16972
  },
16896
16973
  "example": "import { PAPER_STATE_ORDER } from \"@kungfu-tech/buildchain\";",
16897
16974
  "maturity": "stable",
@@ -16915,7 +16992,7 @@
16915
16992
  ],
16916
16993
  "source": {
16917
16994
  "path": "packages/core/paper.js",
16918
- "line": 89
16995
+ "line": 90
16919
16996
  },
16920
16997
  "example": "import { PAPER_STATUS_CONTRACT } from \"@kungfu-tech/buildchain\";",
16921
16998
  "maturity": "stable",
@@ -16939,7 +17016,7 @@
16939
17016
  ],
16940
17017
  "source": {
16941
17018
  "path": "packages/core/paper.js",
16942
- "line": 97
17019
+ "line": 98
16943
17020
  },
16944
17021
  "example": "import { PAPER_VISIBILITY_CONTRACT } from \"@kungfu-tech/buildchain\";",
16945
17022
  "maturity": "stable",
@@ -16951,24 +17028,19 @@
16951
17028
  {
16952
17029
  "id": "packages/core/paper.js#planPaperMigration",
16953
17030
  "name": "planPaperMigration",
16954
- "kind": "function",
16955
- "signature": "function planPaperMigration({ cwd = process.cwd(), buildchainRoot = process.cwd(), buildchainVersion = \"\", buildchainSha = \"\", } = {})",
16956
- "parameters": [
16957
- {
16958
- "name": "parameter1",
16959
- "signature": "{ cwd = process.cwd(), buildchainRoot = process.cwd(), buildchainVersion = \"\", buildchainSha = \"\", } = {}"
16960
- }
16961
- ],
17031
+ "kind": "value",
17032
+ "signature": "planPaperMigration",
17033
+ "parameters": [],
16962
17034
  "returns": "unknown",
16963
17035
  "errors": [
16964
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
17036
+ "No narrower error contract was mechanically discoverable."
16965
17037
  ],
16966
17038
  "sideEffects": [
16967
- "none-detected-by-static-source-scan"
17039
+ "unknown"
16968
17040
  ],
16969
17041
  "source": {
16970
17042
  "path": "packages/core/paper.js",
16971
- "line": 1024
17043
+ "line": 1
16972
17044
  },
16973
17045
  "example": "import { planPaperMigration } from \"@kungfu-tech/buildchain\";",
16974
17046
  "maturity": "stable",
@@ -16980,24 +17052,19 @@
16980
17052
  {
16981
17053
  "id": "packages/core/paper.js#planPaperScaffold",
16982
17054
  "name": "planPaperScaffold",
16983
- "kind": "function",
16984
- "signature": "function planPaperScaffold({ cwd = process.cwd(), buildchainRoot = process.cwd(), buildchainVersion = \"\", buildchainRef = \"v3\", buildchainSha = \"\", name = path.basename(path.resolve(cwd)), title = \"\", packageName = \"\", repository = \"\", version = \"0.1.0-alpha.0\", siteBaseUrl = \"\", } = {})",
16985
- "parameters": [
16986
- {
16987
- "name": "parameter1",
16988
- "signature": "{ cwd = process.cwd(), buildchainRoot = process.cwd(), buildchainVersion = \"\", buildchainRef = \"v3\", buildchainSha = \"\", name = path.basename(path.resolve(cwd)), title = \"\", packageName = \"\", repository = \"\", version = \"0.1.0-alpha.0\", siteBaseUrl = \"\", } = {}"
16989
- }
16990
- ],
17055
+ "kind": "value",
17056
+ "signature": "planPaperScaffold",
17057
+ "parameters": [],
16991
17058
  "returns": "unknown",
16992
17059
  "errors": [
16993
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
17060
+ "No narrower error contract was mechanically discoverable."
16994
17061
  ],
16995
17062
  "sideEffects": [
16996
- "none-detected-by-static-source-scan"
17063
+ "unknown"
16997
17064
  ],
16998
17065
  "source": {
16999
17066
  "path": "packages/core/paper.js",
17000
- "line": 707
17067
+ "line": 1
17001
17068
  },
17002
17069
  "example": "import { planPaperScaffold } from \"@kungfu-tech/buildchain\";",
17003
17070
  "maturity": "stable",
@@ -17030,7 +17097,7 @@
17030
17097
  ],
17031
17098
  "source": {
17032
17099
  "path": "packages/core/paper.js",
17033
- "line": 250
17100
+ "line": 251
17034
17101
  },
17035
17102
  "example": "import { resolvePaperRuntimeGitSha } from \"@kungfu-tech/buildchain/paper\";",
17036
17103
  "maturity": "stable",
@@ -17042,24 +17109,19 @@
17042
17109
  {
17043
17110
  "id": "packages/core/paper.js#writePaperMigration",
17044
17111
  "name": "writePaperMigration",
17045
- "kind": "function",
17046
- "signature": "function writePaperMigration(plan)",
17047
- "parameters": [
17048
- {
17049
- "name": "plan",
17050
- "signature": "plan"
17051
- }
17052
- ],
17112
+ "kind": "value",
17113
+ "signature": "writePaperMigration",
17114
+ "parameters": [],
17053
17115
  "returns": "unknown",
17054
17116
  "errors": [
17055
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
17117
+ "No narrower error contract was mechanically discoverable."
17056
17118
  ],
17057
17119
  "sideEffects": [
17058
- "local-filesystem-write"
17120
+ "unknown"
17059
17121
  ],
17060
17122
  "source": {
17061
17123
  "path": "packages/core/paper.js",
17062
- "line": 1141
17124
+ "line": 1
17063
17125
  },
17064
17126
  "example": "import { writePaperMigration } from \"@kungfu-tech/buildchain\";",
17065
17127
  "maturity": "stable",
@@ -17071,24 +17133,19 @@
17071
17133
  {
17072
17134
  "id": "packages/core/paper.js#writePaperScaffold",
17073
17135
  "name": "writePaperScaffold",
17074
- "kind": "function",
17075
- "signature": "function writePaperScaffold(plan)",
17076
- "parameters": [
17077
- {
17078
- "name": "plan",
17079
- "signature": "plan"
17080
- }
17081
- ],
17136
+ "kind": "value",
17137
+ "signature": "writePaperScaffold",
17138
+ "parameters": [],
17082
17139
  "returns": "unknown",
17083
17140
  "errors": [
17084
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
17141
+ "No narrower error contract was mechanically discoverable."
17085
17142
  ],
17086
17143
  "sideEffects": [
17087
- "local-filesystem-write"
17144
+ "unknown"
17088
17145
  ],
17089
17146
  "source": {
17090
17147
  "path": "packages/core/paper.js",
17091
- "line": 852
17148
+ "line": 1
17092
17149
  },
17093
17150
  "example": "import { writePaperScaffold } from \"@kungfu-tech/buildchain\";",
17094
17151
  "maturity": "stable",
@@ -18424,7 +18481,7 @@
18424
18481
  ],
18425
18482
  "source": {
18426
18483
  "path": "packages/core/publication-control-plane-audit.js",
18427
- "line": 75
18484
+ "line": 245
18428
18485
  },
18429
18486
  "example": "import { evaluatePublicationControlPlaneSnapshot } from \"@kungfu-tech/buildchain\";",
18430
18487
  "maturity": "stable",
@@ -18549,23 +18606,28 @@
18549
18606
  ]
18550
18607
  },
18551
18608
  {
18552
- "id": "packages/core/publication-reproducibility.js#PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT",
18553
- "name": "PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT",
18554
- "kind": "constant",
18555
- "signature": "const PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT",
18556
- "parameters": [],
18557
- "returns": "value",
18609
+ "id": "packages/core/publication-rehearsal-projection.js#appendPublicationRehearsalToml",
18610
+ "name": "appendPublicationRehearsalToml",
18611
+ "kind": "function",
18612
+ "signature": "function appendPublicationRehearsalToml(source)",
18613
+ "parameters": [
18614
+ {
18615
+ "name": "source",
18616
+ "signature": "source"
18617
+ }
18618
+ ],
18619
+ "returns": "unknown",
18558
18620
  "errors": [
18559
- "Import does not declare a throw contract."
18621
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
18560
18622
  ],
18561
18623
  "sideEffects": [
18562
- "none-on-import"
18624
+ "may-write-or-invoke-external-actions"
18563
18625
  ],
18564
18626
  "source": {
18565
- "path": "packages/core/publication-reproducibility.js",
18566
- "line": 12
18627
+ "path": "packages/core/publication-rehearsal-projection.js",
18628
+ "line": 46
18567
18629
  },
18568
- "example": "import { PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT } from \"@kungfu-tech/buildchain\";",
18630
+ "example": "import { appendPublicationRehearsalToml } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18569
18631
  "maturity": "stable",
18570
18632
  "audience": [
18571
18633
  "developer",
@@ -18573,14 +18635,14 @@
18573
18635
  ]
18574
18636
  },
18575
18637
  {
18576
- "id": "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
18577
- "name": "verifyPublicationReproducibility",
18638
+ "id": "packages/core/publication-rehearsal-projection.js#assertPublicationRehearsalConfig",
18639
+ "name": "assertPublicationRehearsalConfig",
18578
18640
  "kind": "function",
18579
- "signature": "function verifyPublicationReproducibility({ cwd = process.cwd(), sourceSha = \"\", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = \"\", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {})",
18641
+ "signature": "function assertPublicationRehearsalConfig(config)",
18580
18642
  "parameters": [
18581
18643
  {
18582
- "name": "parameter1",
18583
- "signature": "{ cwd = process.cwd(), sourceSha = \"\", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = \"\", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {}"
18644
+ "name": "config",
18645
+ "signature": "config"
18584
18646
  }
18585
18647
  ],
18586
18648
  "returns": "unknown",
@@ -18588,13 +18650,13 @@
18588
18650
  "May throw an Error on rejected input or failed operations; follow the linked source contract."
18589
18651
  ],
18590
18652
  "sideEffects": [
18591
- "local-filesystem-write"
18653
+ "none-detected-by-static-source-scan"
18592
18654
  ],
18593
18655
  "source": {
18594
- "path": "packages/core/publication-reproducibility.js",
18595
- "line": 869
18656
+ "path": "packages/core/publication-rehearsal-projection.js",
18657
+ "line": 19
18596
18658
  },
18597
- "example": "import { verifyPublicationReproducibility } from \"@kungfu-tech/buildchain\";",
18659
+ "example": "import { assertPublicationRehearsalConfig } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18598
18660
  "maturity": "stable",
18599
18661
  "audience": [
18600
18662
  "developer",
@@ -18602,14 +18664,14 @@
18602
18664
  ]
18603
18665
  },
18604
18666
  {
18605
- "id": "packages/core/publication-sealed-bundle.js#createPublicationSealedBundle",
18606
- "name": "createPublicationSealedBundle",
18667
+ "id": "packages/core/publication-rehearsal-projection.js#mergePublicationRehearsalAgentInstructions",
18668
+ "name": "mergePublicationRehearsalAgentInstructions",
18607
18669
  "kind": "function",
18608
- "signature": "function createPublicationSealedBundle({ candidate, packageName, packageVersion, npmTarballPath, npmIntegrity, releaseAssetPaths = [], githubReleaseRequired = true, } = {})",
18670
+ "signature": "function mergePublicationRehearsalAgentInstructions(current = \"\")",
18609
18671
  "parameters": [
18610
18672
  {
18611
- "name": "parameter1",
18612
- "signature": "{ candidate, packageName, packageVersion, npmTarballPath, npmIntegrity, releaseAssetPaths = [], githubReleaseRequired = true, } = {}"
18673
+ "name": "current",
18674
+ "signature": "current = \"\""
18613
18675
  }
18614
18676
  ],
18615
18677
  "returns": "unknown",
@@ -18620,10 +18682,10 @@
18620
18682
  "none-detected-by-static-source-scan"
18621
18683
  ],
18622
18684
  "source": {
18623
- "path": "packages/core/publication-sealed-bundle.js",
18624
- "line": 84
18685
+ "path": "packages/core/publication-rehearsal-projection.js",
18686
+ "line": 73
18625
18687
  },
18626
- "example": "import { createPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
18688
+ "example": "import { mergePublicationRehearsalAgentInstructions } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18627
18689
  "maturity": "stable",
18628
18690
  "audience": [
18629
18691
  "developer",
@@ -18631,23 +18693,28 @@
18631
18693
  ]
18632
18694
  },
18633
18695
  {
18634
- "id": "packages/core/publication-sealed-bundle.js#PUBLICATION_SEALED_BUNDLE_CONTRACT",
18635
- "name": "PUBLICATION_SEALED_BUNDLE_CONTRACT",
18636
- "kind": "constant",
18637
- "signature": "const PUBLICATION_SEALED_BUNDLE_CONTRACT",
18638
- "parameters": [],
18639
- "returns": "value",
18696
+ "id": "packages/core/publication-rehearsal-projection.js#projectPublicationRehearsalToml",
18697
+ "name": "projectPublicationRehearsalToml",
18698
+ "kind": "function",
18699
+ "signature": "function projectPublicationRehearsalToml(source)",
18700
+ "parameters": [
18701
+ {
18702
+ "name": "source",
18703
+ "signature": "source"
18704
+ }
18705
+ ],
18706
+ "returns": "unknown",
18640
18707
  "errors": [
18641
- "Import does not declare a throw contract."
18708
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
18642
18709
  ],
18643
18710
  "sideEffects": [
18644
- "none-on-import"
18711
+ "none-detected-by-static-source-scan"
18645
18712
  ],
18646
18713
  "source": {
18647
- "path": "packages/core/publication-sealed-bundle.js",
18648
- "line": 10
18714
+ "path": "packages/core/publication-rehearsal-projection.js",
18715
+ "line": 55
18649
18716
  },
18650
- "example": "import { PUBLICATION_SEALED_BUNDLE_CONTRACT } from \"@kungfu-tech/buildchain\";",
18717
+ "example": "import { projectPublicationRehearsalToml } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18651
18718
  "maturity": "stable",
18652
18719
  "audience": [
18653
18720
  "developer",
@@ -18655,28 +18722,23 @@
18655
18722
  ]
18656
18723
  },
18657
18724
  {
18658
- "id": "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
18659
- "name": "verifyPublicationSealedBundle",
18660
- "kind": "function",
18661
- "signature": "function verifyPublicationSealedBundle({ bundleRoot, manifest } = {})",
18662
- "parameters": [
18663
- {
18664
- "name": "parameter1",
18665
- "signature": "{ bundleRoot, manifest } = {}"
18666
- }
18667
- ],
18668
- "returns": "unknown",
18725
+ "id": "packages/core/publication-rehearsal-projection.js#PUBLICATION_REHEARSAL_AGENT_SECTION_END",
18726
+ "name": "PUBLICATION_REHEARSAL_AGENT_SECTION_END",
18727
+ "kind": "constant",
18728
+ "signature": "const PUBLICATION_REHEARSAL_AGENT_SECTION_END",
18729
+ "parameters": [],
18730
+ "returns": "value",
18669
18731
  "errors": [
18670
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
18732
+ "Import does not declare a throw contract."
18671
18733
  ],
18672
18734
  "sideEffects": [
18673
- "none-detected-by-static-source-scan"
18735
+ "none-on-import"
18674
18736
  ],
18675
18737
  "source": {
18676
- "path": "packages/core/publication-sealed-bundle.js",
18677
- "line": 133
18738
+ "path": "packages/core/publication-rehearsal-projection.js",
18739
+ "line": 10
18678
18740
  },
18679
- "example": "import { verifyPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
18741
+ "example": "import { PUBLICATION_REHEARSAL_AGENT_SECTION_END } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18680
18742
  "maturity": "stable",
18681
18743
  "audience": [
18682
18744
  "developer",
@@ -18684,7 +18746,646 @@
18684
18746
  ]
18685
18747
  },
18686
18748
  {
18687
- "id": "packages/core/publish-transaction.js#createReleaseTransaction",
18749
+ "id": "packages/core/publication-rehearsal-projection.js#PUBLICATION_REHEARSAL_AGENT_SECTION_START",
18750
+ "name": "PUBLICATION_REHEARSAL_AGENT_SECTION_START",
18751
+ "kind": "constant",
18752
+ "signature": "const PUBLICATION_REHEARSAL_AGENT_SECTION_START",
18753
+ "parameters": [],
18754
+ "returns": "value",
18755
+ "errors": [
18756
+ "Import does not declare a throw contract."
18757
+ ],
18758
+ "sideEffects": [
18759
+ "none-on-import"
18760
+ ],
18761
+ "source": {
18762
+ "path": "packages/core/publication-rehearsal-projection.js",
18763
+ "line": 8
18764
+ },
18765
+ "example": "import { PUBLICATION_REHEARSAL_AGENT_SECTION_START } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18766
+ "maturity": "stable",
18767
+ "audience": [
18768
+ "developer",
18769
+ "agent"
18770
+ ]
18771
+ },
18772
+ {
18773
+ "id": "packages/core/publication-rehearsal-projection.js#PUBLICATION_REHEARSAL_WORKFLOW_PATH",
18774
+ "name": "PUBLICATION_REHEARSAL_WORKFLOW_PATH",
18775
+ "kind": "constant",
18776
+ "signature": "const PUBLICATION_REHEARSAL_WORKFLOW_PATH",
18777
+ "parameters": [],
18778
+ "returns": "value",
18779
+ "errors": [
18780
+ "Import does not declare a throw contract."
18781
+ ],
18782
+ "sideEffects": [
18783
+ "none-on-import"
18784
+ ],
18785
+ "source": {
18786
+ "path": "packages/core/publication-rehearsal-projection.js",
18787
+ "line": 12
18788
+ },
18789
+ "example": "import { PUBLICATION_REHEARSAL_WORKFLOW_PATH } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18790
+ "maturity": "stable",
18791
+ "audience": [
18792
+ "developer",
18793
+ "agent"
18794
+ ]
18795
+ },
18796
+ {
18797
+ "id": "packages/core/publication-rehearsal-projection.js#publicationRehearsalAgentInstructions",
18798
+ "name": "publicationRehearsalAgentInstructions",
18799
+ "kind": "function",
18800
+ "signature": "function publicationRehearsalAgentInstructions()",
18801
+ "parameters": [],
18802
+ "returns": "unknown",
18803
+ "errors": [
18804
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
18805
+ ],
18806
+ "sideEffects": [
18807
+ "none-detected-by-static-source-scan"
18808
+ ],
18809
+ "source": {
18810
+ "path": "packages/core/publication-rehearsal-projection.js",
18811
+ "line": 69
18812
+ },
18813
+ "example": "import { publicationRehearsalAgentInstructions } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18814
+ "maturity": "stable",
18815
+ "audience": [
18816
+ "developer",
18817
+ "agent"
18818
+ ]
18819
+ },
18820
+ {
18821
+ "id": "packages/core/publication-rehearsal-projection.js#publicationRehearsalToml",
18822
+ "name": "publicationRehearsalToml",
18823
+ "kind": "function",
18824
+ "signature": "function publicationRehearsalToml()",
18825
+ "parameters": [],
18826
+ "returns": "unknown",
18827
+ "errors": [
18828
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
18829
+ ],
18830
+ "sideEffects": [
18831
+ "none-detected-by-static-source-scan"
18832
+ ],
18833
+ "source": {
18834
+ "path": "packages/core/publication-rehearsal-projection.js",
18835
+ "line": 15
18836
+ },
18837
+ "example": "import { publicationRehearsalToml } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18838
+ "maturity": "stable",
18839
+ "audience": [
18840
+ "developer",
18841
+ "agent"
18842
+ ]
18843
+ },
18844
+ {
18845
+ "id": "packages/core/publication-rehearsal-projection.js#publicationRehearsalWorkflow",
18846
+ "name": "publicationRehearsalWorkflow",
18847
+ "kind": "function",
18848
+ "signature": "function publicationRehearsalWorkflow(buildchainRef)",
18849
+ "parameters": [
18850
+ {
18851
+ "name": "buildchainRef",
18852
+ "signature": "buildchainRef"
18853
+ }
18854
+ ],
18855
+ "returns": "unknown",
18856
+ "errors": [
18857
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
18858
+ ],
18859
+ "sideEffects": [
18860
+ "none-detected-by-static-source-scan"
18861
+ ],
18862
+ "source": {
18863
+ "path": "packages/core/publication-rehearsal-projection.js",
18864
+ "line": 99
18865
+ },
18866
+ "example": "import { publicationRehearsalWorkflow } from \"@kungfu-tech/buildchain/publication-rehearsal-projection\";",
18867
+ "maturity": "stable",
18868
+ "audience": [
18869
+ "developer",
18870
+ "agent"
18871
+ ]
18872
+ },
18873
+ {
18874
+ "id": "packages/core/publication-rehearsal-runtime.js#createPublicationRehearsalCapsule",
18875
+ "name": "createPublicationRehearsalCapsule",
18876
+ "kind": "function",
18877
+ "signature": "function createPublicationRehearsalCapsule(input = {})",
18878
+ "parameters": [
18879
+ {
18880
+ "name": "input",
18881
+ "signature": "input = {}"
18882
+ }
18883
+ ],
18884
+ "returns": "unknown",
18885
+ "errors": [
18886
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
18887
+ ],
18888
+ "sideEffects": [
18889
+ "none-detected-by-static-source-scan"
18890
+ ],
18891
+ "source": {
18892
+ "path": "packages/core/publication-rehearsal-runtime.js",
18893
+ "line": 91
18894
+ },
18895
+ "example": "import { createPublicationRehearsalCapsule } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
18896
+ "maturity": "stable",
18897
+ "audience": [
18898
+ "developer",
18899
+ "agent"
18900
+ ]
18901
+ },
18902
+ {
18903
+ "id": "packages/core/publication-rehearsal-runtime.js#executePublicationRehearsal",
18904
+ "name": "executePublicationRehearsal",
18905
+ "kind": "function",
18906
+ "signature": "async function executePublicationRehearsal({ capsule, capsuleRoot, candidateRoot = capsuleRoot, mode = \"simulate\", environment = {}, adapters = {}, authority = null, transaction = null, checkpoint, } = {})",
18907
+ "parameters": [
18908
+ {
18909
+ "name": "parameter1",
18910
+ "signature": "{ capsule, capsuleRoot, candidateRoot = capsuleRoot, mode = \"simulate\", environment = {}, adapters = {}, authority = null, transaction = null, checkpoint, } = {}"
18911
+ }
18912
+ ],
18913
+ "returns": "Promise<unknown>",
18914
+ "errors": [
18915
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
18916
+ ],
18917
+ "sideEffects": [
18918
+ "may-write-or-invoke-external-actions"
18919
+ ],
18920
+ "source": {
18921
+ "path": "packages/core/publication-rehearsal-runtime.js",
18922
+ "line": 133
18923
+ },
18924
+ "example": "import { executePublicationRehearsal } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
18925
+ "maturity": "stable",
18926
+ "audience": [
18927
+ "developer",
18928
+ "agent"
18929
+ ]
18930
+ },
18931
+ {
18932
+ "id": "packages/core/publication-rehearsal-runtime.js#normalizePublicationRehearsalCapsule",
18933
+ "name": "normalizePublicationRehearsalCapsule",
18934
+ "kind": "function",
18935
+ "signature": "function normalizePublicationRehearsalCapsule(input)",
18936
+ "parameters": [
18937
+ {
18938
+ "name": "input",
18939
+ "signature": "input"
18940
+ }
18941
+ ],
18942
+ "returns": "unknown",
18943
+ "errors": [
18944
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
18945
+ ],
18946
+ "sideEffects": [
18947
+ "none-detected-by-static-source-scan"
18948
+ ],
18949
+ "source": {
18950
+ "path": "packages/core/publication-rehearsal-runtime.js",
18951
+ "line": 99
18952
+ },
18953
+ "example": "import { normalizePublicationRehearsalCapsule } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
18954
+ "maturity": "stable",
18955
+ "audience": [
18956
+ "developer",
18957
+ "agent"
18958
+ ]
18959
+ },
18960
+ {
18961
+ "id": "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_CAPSULE_CONTRACT",
18962
+ "name": "PUBLICATION_REHEARSAL_CAPSULE_CONTRACT",
18963
+ "kind": "constant",
18964
+ "signature": "const PUBLICATION_REHEARSAL_CAPSULE_CONTRACT",
18965
+ "parameters": [],
18966
+ "returns": "value",
18967
+ "errors": [
18968
+ "Import does not declare a throw contract."
18969
+ ],
18970
+ "sideEffects": [
18971
+ "none-on-import"
18972
+ ],
18973
+ "source": {
18974
+ "path": "packages/core/publication-rehearsal-runtime.js",
18975
+ "line": 14
18976
+ },
18977
+ "example": "import { PUBLICATION_REHEARSAL_CAPSULE_CONTRACT } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
18978
+ "maturity": "stable",
18979
+ "audience": [
18980
+ "developer",
18981
+ "agent"
18982
+ ]
18983
+ },
18984
+ {
18985
+ "id": "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_COMMAND",
18986
+ "name": "PUBLICATION_REHEARSAL_COMMAND",
18987
+ "kind": "constant",
18988
+ "signature": "const PUBLICATION_REHEARSAL_COMMAND",
18989
+ "parameters": [],
18990
+ "returns": "value",
18991
+ "errors": [
18992
+ "Import does not declare a throw contract."
18993
+ ],
18994
+ "sideEffects": [
18995
+ "none-on-import"
18996
+ ],
18997
+ "source": {
18998
+ "path": "packages/core/publication-rehearsal-runtime.js",
18999
+ "line": 24
19000
+ },
19001
+ "example": "import { PUBLICATION_REHEARSAL_COMMAND } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19002
+ "maturity": "stable",
19003
+ "audience": [
19004
+ "developer",
19005
+ "agent"
19006
+ ]
19007
+ },
19008
+ {
19009
+ "id": "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_DIAGNOSTIC_CONTRACT",
19010
+ "name": "PUBLICATION_REHEARSAL_DIAGNOSTIC_CONTRACT",
19011
+ "kind": "constant",
19012
+ "signature": "const PUBLICATION_REHEARSAL_DIAGNOSTIC_CONTRACT",
19013
+ "parameters": [],
19014
+ "returns": "value",
19015
+ "errors": [
19016
+ "Import does not declare a throw contract."
19017
+ ],
19018
+ "sideEffects": [
19019
+ "none-on-import"
19020
+ ],
19021
+ "source": {
19022
+ "path": "packages/core/publication-rehearsal-runtime.js",
19023
+ "line": 18
19024
+ },
19025
+ "example": "import { PUBLICATION_REHEARSAL_DIAGNOSTIC_CONTRACT } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19026
+ "maturity": "stable",
19027
+ "audience": [
19028
+ "developer",
19029
+ "agent"
19030
+ ]
19031
+ },
19032
+ {
19033
+ "id": "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_EVIDENCE_CONTRACT",
19034
+ "name": "PUBLICATION_REHEARSAL_EVIDENCE_CONTRACT",
19035
+ "kind": "constant",
19036
+ "signature": "const PUBLICATION_REHEARSAL_EVIDENCE_CONTRACT",
19037
+ "parameters": [],
19038
+ "returns": "value",
19039
+ "errors": [
19040
+ "Import does not declare a throw contract."
19041
+ ],
19042
+ "sideEffects": [
19043
+ "none-on-import"
19044
+ ],
19045
+ "source": {
19046
+ "path": "packages/core/publication-rehearsal-runtime.js",
19047
+ "line": 16
19048
+ },
19049
+ "example": "import { PUBLICATION_REHEARSAL_EVIDENCE_CONTRACT } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19050
+ "maturity": "stable",
19051
+ "audience": [
19052
+ "developer",
19053
+ "agent"
19054
+ ]
19055
+ },
19056
+ {
19057
+ "id": "packages/core/publication-rehearsal-runtime.js#publicationRehearsalBindingRoot",
19058
+ "name": "publicationRehearsalBindingRoot",
19059
+ "kind": "function",
19060
+ "signature": "function publicationRehearsalBindingRoot(capsule)",
19061
+ "parameters": [
19062
+ {
19063
+ "name": "capsule",
19064
+ "signature": "capsule"
19065
+ }
19066
+ ],
19067
+ "returns": "unknown",
19068
+ "errors": [
19069
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
19070
+ ],
19071
+ "sideEffects": [
19072
+ "none-detected-by-static-source-scan"
19073
+ ],
19074
+ "source": {
19075
+ "path": "packages/core/publication-rehearsal-runtime.js",
19076
+ "line": 111
19077
+ },
19078
+ "example": "import { publicationRehearsalBindingRoot } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19079
+ "maturity": "stable",
19080
+ "audience": [
19081
+ "developer",
19082
+ "agent"
19083
+ ]
19084
+ },
19085
+ {
19086
+ "id": "packages/core/publication-rehearsal-runtime.js#publicationRehearsalDiagnostic",
19087
+ "name": "publicationRehearsalDiagnostic",
19088
+ "kind": "function",
19089
+ "signature": "function publicationRehearsalDiagnostic(error, { capsule } = {})",
19090
+ "parameters": [
19091
+ {
19092
+ "name": "error",
19093
+ "signature": "error"
19094
+ },
19095
+ {
19096
+ "name": "parameter2",
19097
+ "signature": "{ capsule } = {}"
19098
+ }
19099
+ ],
19100
+ "returns": "unknown",
19101
+ "errors": [
19102
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
19103
+ ],
19104
+ "sideEffects": [
19105
+ "none-detected-by-static-source-scan"
19106
+ ],
19107
+ "source": {
19108
+ "path": "packages/core/publication-rehearsal-runtime.js",
19109
+ "line": 115
19110
+ },
19111
+ "example": "import { publicationRehearsalDiagnostic } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19112
+ "maturity": "stable",
19113
+ "audience": [
19114
+ "developer",
19115
+ "agent"
19116
+ ]
19117
+ },
19118
+ {
19119
+ "id": "packages/core/publication-rehearsal-runtime.js#PublicationRehearsalError",
19120
+ "name": "PublicationRehearsalError",
19121
+ "kind": "class",
19122
+ "signature": "class PublicationRehearsalError",
19123
+ "parameters": [],
19124
+ "returns": "PublicationRehearsalError",
19125
+ "errors": [
19126
+ "Construction and method errors follow the linked source implementation."
19127
+ ],
19128
+ "sideEffects": [
19129
+ "class-dependent"
19130
+ ],
19131
+ "source": {
19132
+ "path": "packages/core/publication-rehearsal-runtime.js",
19133
+ "line": 52
19134
+ },
19135
+ "example": "import { PublicationRehearsalError } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19136
+ "maturity": "stable",
19137
+ "audience": [
19138
+ "developer",
19139
+ "agent"
19140
+ ]
19141
+ },
19142
+ {
19143
+ "id": "packages/core/publication-rehearsal-runtime.js#RELEASE_LOCAL_CONSTRUCTIBILITY_ADR",
19144
+ "name": "RELEASE_LOCAL_CONSTRUCTIBILITY_ADR",
19145
+ "kind": "constant",
19146
+ "signature": "const RELEASE_LOCAL_CONSTRUCTIBILITY_ADR",
19147
+ "parameters": [],
19148
+ "returns": "value",
19149
+ "errors": [
19150
+ "Import does not declare a throw contract."
19151
+ ],
19152
+ "sideEffects": [
19153
+ "none-on-import"
19154
+ ],
19155
+ "source": {
19156
+ "path": "packages/core/publication-rehearsal-runtime.js",
19157
+ "line": 20
19158
+ },
19159
+ "example": "import { RELEASE_LOCAL_CONSTRUCTIBILITY_ADR } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19160
+ "maturity": "stable",
19161
+ "audience": [
19162
+ "developer",
19163
+ "agent"
19164
+ ]
19165
+ },
19166
+ {
19167
+ "id": "packages/core/publication-rehearsal-runtime.js#RELEASE_LOCAL_CONSTRUCTIBILITY_INVARIANT",
19168
+ "name": "RELEASE_LOCAL_CONSTRUCTIBILITY_INVARIANT",
19169
+ "kind": "constant",
19170
+ "signature": "const RELEASE_LOCAL_CONSTRUCTIBILITY_INVARIANT",
19171
+ "parameters": [],
19172
+ "returns": "value",
19173
+ "errors": [
19174
+ "Import does not declare a throw contract."
19175
+ ],
19176
+ "sideEffects": [
19177
+ "none-on-import"
19178
+ ],
19179
+ "source": {
19180
+ "path": "packages/core/publication-rehearsal-runtime.js",
19181
+ "line": 22
19182
+ },
19183
+ "example": "import { RELEASE_LOCAL_CONSTRUCTIBILITY_INVARIANT } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19184
+ "maturity": "stable",
19185
+ "audience": [
19186
+ "developer",
19187
+ "agent"
19188
+ ]
19189
+ },
19190
+ {
19191
+ "id": "packages/core/publication-rehearsal-runtime.js#resolvePublicationRehearsalFile",
19192
+ "name": "resolvePublicationRehearsalFile",
19193
+ "kind": "function",
19194
+ "signature": "function resolvePublicationRehearsalFile(capsuleRoot, relativePath)",
19195
+ "parameters": [
19196
+ {
19197
+ "name": "capsuleRoot",
19198
+ "signature": "capsuleRoot"
19199
+ },
19200
+ {
19201
+ "name": "relativePath",
19202
+ "signature": "relativePath"
19203
+ }
19204
+ ],
19205
+ "returns": "unknown",
19206
+ "errors": [
19207
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
19208
+ ],
19209
+ "sideEffects": [
19210
+ "none-detected-by-static-source-scan"
19211
+ ],
19212
+ "source": {
19213
+ "path": "packages/core/publication-rehearsal-runtime.js",
19214
+ "line": 170
19215
+ },
19216
+ "example": "import { resolvePublicationRehearsalFile } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19217
+ "maturity": "stable",
19218
+ "audience": [
19219
+ "developer",
19220
+ "agent"
19221
+ ]
19222
+ },
19223
+ {
19224
+ "id": "packages/core/publication-rehearsal-runtime.js#verifyPublicationRehearsalCapsule",
19225
+ "name": "verifyPublicationRehearsalCapsule",
19226
+ "kind": "function",
19227
+ "signature": "function verifyPublicationRehearsalCapsule({ capsule, capsuleRoot, candidateRoot = capsuleRoot, } = {})",
19228
+ "parameters": [
19229
+ {
19230
+ "name": "parameter1",
19231
+ "signature": "{ capsule, capsuleRoot, candidateRoot = capsuleRoot, } = {}"
19232
+ }
19233
+ ],
19234
+ "returns": "unknown",
19235
+ "errors": [
19236
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
19237
+ ],
19238
+ "sideEffects": [
19239
+ "none-detected-by-static-source-scan"
19240
+ ],
19241
+ "source": {
19242
+ "path": "packages/core/publication-rehearsal-runtime.js",
19243
+ "line": 103
19244
+ },
19245
+ "example": "import { verifyPublicationRehearsalCapsule } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
19246
+ "maturity": "stable",
19247
+ "audience": [
19248
+ "developer",
19249
+ "agent"
19250
+ ]
19251
+ },
19252
+ {
19253
+ "id": "packages/core/publication-reproducibility.js#PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT",
19254
+ "name": "PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT",
19255
+ "kind": "constant",
19256
+ "signature": "const PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT",
19257
+ "parameters": [],
19258
+ "returns": "value",
19259
+ "errors": [
19260
+ "Import does not declare a throw contract."
19261
+ ],
19262
+ "sideEffects": [
19263
+ "none-on-import"
19264
+ ],
19265
+ "source": {
19266
+ "path": "packages/core/publication-reproducibility.js",
19267
+ "line": 12
19268
+ },
19269
+ "example": "import { PUBLICATION_REPRODUCIBILITY_RECEIPT_CONTRACT } from \"@kungfu-tech/buildchain\";",
19270
+ "maturity": "stable",
19271
+ "audience": [
19272
+ "developer",
19273
+ "agent"
19274
+ ]
19275
+ },
19276
+ {
19277
+ "id": "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
19278
+ "name": "verifyPublicationReproducibility",
19279
+ "kind": "function",
19280
+ "signature": "function verifyPublicationReproducibility({ cwd = process.cwd(), sourceSha = \"\", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = \"\", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {})",
19281
+ "parameters": [
19282
+ {
19283
+ "name": "parameter1",
19284
+ "signature": "{ cwd = process.cwd(), sourceSha = \"\", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = \"\", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {}"
19285
+ }
19286
+ ],
19287
+ "returns": "unknown",
19288
+ "errors": [
19289
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
19290
+ ],
19291
+ "sideEffects": [
19292
+ "local-filesystem-write"
19293
+ ],
19294
+ "source": {
19295
+ "path": "packages/core/publication-reproducibility.js",
19296
+ "line": 869
19297
+ },
19298
+ "example": "import { verifyPublicationReproducibility } from \"@kungfu-tech/buildchain\";",
19299
+ "maturity": "stable",
19300
+ "audience": [
19301
+ "developer",
19302
+ "agent"
19303
+ ]
19304
+ },
19305
+ {
19306
+ "id": "packages/core/publication-sealed-bundle.js#createPublicationSealedBundle",
19307
+ "name": "createPublicationSealedBundle",
19308
+ "kind": "function",
19309
+ "signature": "function createPublicationSealedBundle({ candidate, packageName, packageVersion, npmTarballPath, npmIntegrity, releaseAssetPaths = [], githubReleaseRequired = true, } = {})",
19310
+ "parameters": [
19311
+ {
19312
+ "name": "parameter1",
19313
+ "signature": "{ candidate, packageName, packageVersion, npmTarballPath, npmIntegrity, releaseAssetPaths = [], githubReleaseRequired = true, } = {}"
19314
+ }
19315
+ ],
19316
+ "returns": "unknown",
19317
+ "errors": [
19318
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
19319
+ ],
19320
+ "sideEffects": [
19321
+ "none-detected-by-static-source-scan"
19322
+ ],
19323
+ "source": {
19324
+ "path": "packages/core/publication-sealed-bundle.js",
19325
+ "line": 84
19326
+ },
19327
+ "example": "import { createPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
19328
+ "maturity": "stable",
19329
+ "audience": [
19330
+ "developer",
19331
+ "agent"
19332
+ ]
19333
+ },
19334
+ {
19335
+ "id": "packages/core/publication-sealed-bundle.js#PUBLICATION_SEALED_BUNDLE_CONTRACT",
19336
+ "name": "PUBLICATION_SEALED_BUNDLE_CONTRACT",
19337
+ "kind": "constant",
19338
+ "signature": "const PUBLICATION_SEALED_BUNDLE_CONTRACT",
19339
+ "parameters": [],
19340
+ "returns": "value",
19341
+ "errors": [
19342
+ "Import does not declare a throw contract."
19343
+ ],
19344
+ "sideEffects": [
19345
+ "none-on-import"
19346
+ ],
19347
+ "source": {
19348
+ "path": "packages/core/publication-sealed-bundle.js",
19349
+ "line": 10
19350
+ },
19351
+ "example": "import { PUBLICATION_SEALED_BUNDLE_CONTRACT } from \"@kungfu-tech/buildchain\";",
19352
+ "maturity": "stable",
19353
+ "audience": [
19354
+ "developer",
19355
+ "agent"
19356
+ ]
19357
+ },
19358
+ {
19359
+ "id": "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
19360
+ "name": "verifyPublicationSealedBundle",
19361
+ "kind": "function",
19362
+ "signature": "function verifyPublicationSealedBundle({ bundleRoot, manifest } = {})",
19363
+ "parameters": [
19364
+ {
19365
+ "name": "parameter1",
19366
+ "signature": "{ bundleRoot, manifest } = {}"
19367
+ }
19368
+ ],
19369
+ "returns": "unknown",
19370
+ "errors": [
19371
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
19372
+ ],
19373
+ "sideEffects": [
19374
+ "none-detected-by-static-source-scan"
19375
+ ],
19376
+ "source": {
19377
+ "path": "packages/core/publication-sealed-bundle.js",
19378
+ "line": 133
19379
+ },
19380
+ "example": "import { verifyPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
19381
+ "maturity": "stable",
19382
+ "audience": [
19383
+ "developer",
19384
+ "agent"
19385
+ ]
19386
+ },
19387
+ {
19388
+ "id": "packages/core/publish-transaction.js#createReleaseTransaction",
18688
19389
  "name": "createReleaseTransaction",
18689
19390
  "kind": "function",
18690
19391
  "signature": "function createReleaseTransaction({ repository, version, exactTag = \"\", channel, line = \"\", sourceSha, targetRef, releaseSha, releaseMaterialSha = releaseSha, publishToolingSha = \"\", lifecycleIdentity = \"lifecycle.publish\", statePath = \"\", evidencePath = \"\", actor = \"\", runId = \"\", } = {})",
@@ -19947,7 +20648,7 @@
19947
20648
  ],
19948
20649
  "source": {
19949
20650
  "path": "packages/core/release-candidate-recovery.js",
19950
- "line": 584
20651
+ "line": 585
19951
20652
  },
19952
20653
  "example": "import { recoveryFailure } from \"@kungfu-tech/buildchain\";",
19953
20654
  "maturity": "stable",
@@ -19995,7 +20696,7 @@
19995
20696
  ],
19996
20697
  "source": {
19997
20698
  "path": "packages/core/release-candidate-recovery.js",
19998
- "line": 56
20699
+ "line": 57
19999
20700
  },
20000
20701
  "example": "import { ReleaseCandidateRecoveryError } from \"@kungfu-tech/buildchain\";",
20001
20702
  "maturity": "stable",
@@ -20024,7 +20725,7 @@
20024
20725
  ],
20025
20726
  "source": {
20026
20727
  "path": "packages/core/release-candidate-recovery.js",
20027
- "line": 134
20728
+ "line": 135
20028
20729
  },
20029
20730
  "example": "import { validateRecoveryTargetRef } from \"@kungfu-tech/buildchain/release-candidate-recovery\";",
20030
20731
  "maturity": "stable",
@@ -20053,7 +20754,7 @@
20053
20754
  ],
20054
20755
  "source": {
20055
20756
  "path": "packages/core/release-candidate-recovery.js",
20056
- "line": 176
20757
+ "line": 177
20057
20758
  },
20058
20759
  "example": "import { validateReleaseCandidateRecoveryReceipt } from \"@kungfu-tech/buildchain/release-candidate-recovery\";",
20059
20760
  "maturity": "stable",
@@ -20082,7 +20783,7 @@
20082
20783
  ],
20083
20784
  "source": {
20084
20785
  "path": "packages/core/release-candidate-recovery.js",
20085
- "line": 443
20786
+ "line": 444
20086
20787
  },
20087
20788
  "example": "import { verifyReleaseCandidateRecovery } from \"@kungfu-tech/buildchain\";",
20088
20789
  "maturity": "stable",
@@ -20796,7 +21497,7 @@
20796
21497
  ],
20797
21498
  "source": {
20798
21499
  "path": "packages/core/release-passport.js",
20799
- "line": 51
21500
+ "line": 54
20800
21501
  },
20801
21502
  "example": "import { AGENT_INDEX_CONTRACT } from \"@kungfu-tech/buildchain\";",
20802
21503
  "maturity": "stable",
@@ -20820,7 +21521,7 @@
20820
21521
  ],
20821
21522
  "source": {
20822
21523
  "path": "packages/core/release-passport.js",
20823
- "line": 49
21524
+ "line": 52
20824
21525
  },
20825
21526
  "example": "import { ARTIFACT_EVIDENCE_CONTRACT } from \"@kungfu-tech/buildchain\";",
20826
21527
  "maturity": "stable",
@@ -20849,7 +21550,7 @@
20849
21550
  ],
20850
21551
  "source": {
20851
21552
  "path": "packages/core/release-passport.js",
20852
- "line": 1584
21553
+ "line": 1465
20853
21554
  },
20854
21555
  "example": "import { collectGitHubReleasePassport } from \"@kungfu-tech/buildchain\";",
20855
21556
  "maturity": "stable",
@@ -20878,7 +21579,7 @@
20878
21579
  ],
20879
21580
  "source": {
20880
21581
  "path": "packages/core/release-passport.js",
20881
- "line": 1249
21582
+ "line": 1128
20882
21583
  },
20883
21584
  "example": "import { createArtifactEvidence } from \"@kungfu-tech/buildchain\";",
20884
21585
  "maturity": "stable",
@@ -20907,7 +21608,7 @@
20907
21608
  ],
20908
21609
  "source": {
20909
21610
  "path": "packages/core/release-passport.js",
20910
- "line": 220
21611
+ "line": 223
20911
21612
  },
20912
21613
  "example": "import { createInvariantPassportGate } from \"@kungfu-tech/buildchain/release-passport\";",
20913
21614
  "maturity": "stable",
@@ -20936,7 +21637,7 @@
20936
21637
  ],
20937
21638
  "source": {
20938
21639
  "path": "packages/core/release-passport.js",
20939
- "line": 2786
21640
+ "line": 2607
20940
21641
  },
20941
21642
  "example": "import { createReleaseCheckReport } from \"@kungfu-tech/buildchain\";",
20942
21643
  "maturity": "stable",
@@ -20965,7 +21666,7 @@
20965
21666
  ],
20966
21667
  "source": {
20967
21668
  "path": "packages/core/release-passport.js",
20968
- "line": 1284
21669
+ "line": 1165
20969
21670
  },
20970
21671
  "example": "import { createReleasePassport } from \"@kungfu-tech/buildchain\";",
20971
21672
  "maturity": "stable",
@@ -20994,7 +21695,7 @@
20994
21695
  ],
20995
21696
  "source": {
20996
21697
  "path": "packages/core/release-passport.js",
20997
- "line": 2942
21698
+ "line": 2763
20998
21699
  },
20999
21700
  "example": "import { explainReleasePassport } from \"@kungfu-tech/buildchain\";",
21000
21701
  "maturity": "stable",
@@ -21018,7 +21719,7 @@
21018
21719
  ],
21019
21720
  "source": {
21020
21721
  "path": "packages/core/release-passport.js",
21021
- "line": 50
21722
+ "line": 53
21022
21723
  },
21023
21724
  "example": "import { IMPACT_LEDGER_CONTRACT } from \"@kungfu-tech/buildchain\";",
21024
21725
  "maturity": "stable",
@@ -21042,7 +21743,7 @@
21042
21743
  ],
21043
21744
  "source": {
21044
21745
  "path": "packages/core/release-passport.js",
21045
- "line": 56
21746
+ "line": 59
21046
21747
  },
21047
21748
  "example": "import { INVARIANT_PASSPORT_GATE_CONTRACT } from \"@kungfu-tech/buildchain/release-passport\";",
21048
21749
  "maturity": "stable",
@@ -21066,7 +21767,7 @@
21066
21767
  ],
21067
21768
  "source": {
21068
21769
  "path": "packages/core/release-passport.js",
21069
- "line": 57
21770
+ "line": 60
21070
21771
  },
21071
21772
  "example": "import { KFD_AGENT_HUB_RELEASE_EVIDENCE_CONTRACT } from \"@kungfu-tech/buildchain/release-passport\";",
21072
21773
  "maturity": "stable",
@@ -21090,7 +21791,7 @@
21090
21791
  ],
21091
21792
  "source": {
21092
21793
  "path": "packages/core/release-passport.js",
21093
- "line": 54
21794
+ "line": 57
21094
21795
  },
21095
21796
  "example": "import { KFD2_RELEASE_TRUST_PASSPORT_CONTRACT } from \"@kungfu-tech/buildchain\";",
21096
21797
  "maturity": "stable",
@@ -21114,7 +21815,7 @@
21114
21815
  ],
21115
21816
  "source": {
21116
21817
  "path": "packages/core/release-passport.js",
21117
- "line": 55
21818
+ "line": 58
21118
21819
  },
21119
21820
  "example": "import { KFD2_TRUST_PROOF_CONTRACT } from \"@kungfu-tech/buildchain\";",
21120
21821
  "maturity": "stable",
@@ -21143,7 +21844,7 @@
21143
21844
  ],
21144
21845
  "source": {
21145
21846
  "path": "packages/core/release-passport.js",
21146
- "line": 2971
21847
+ "line": 2792
21147
21848
  },
21148
21849
  "example": "import { makeReleasePassportFixtureAssets } from \"@kungfu-tech/buildchain\";",
21149
21850
  "maturity": "stable",
@@ -21167,7 +21868,7 @@
21167
21868
  ],
21168
21869
  "source": {
21169
21870
  "path": "packages/core/release-passport.js",
21170
- "line": 52
21871
+ "line": 55
21171
21872
  },
21172
21873
  "example": "import { PRODUCT_MECHANISM_CONTRACT } from \"@kungfu-tech/buildchain\";",
21173
21874
  "maturity": "stable",
@@ -21204,7 +21905,7 @@
21204
21905
  ],
21205
21906
  "source": {
21206
21907
  "path": "packages/core/release-passport.js",
21207
- "line": 2858
21908
+ "line": 2679
21208
21909
  },
21209
21910
  "example": "import { readJsonFromLocation } from \"@kungfu-tech/buildchain\";",
21210
21911
  "maturity": "stable",
@@ -21252,7 +21953,7 @@
21252
21953
  ],
21253
21954
  "source": {
21254
21955
  "path": "packages/core/release-passport.js",
21255
- "line": 53
21956
+ "line": 56
21256
21957
  },
21257
21958
  "example": "import { RELEASE_EVIDENCE_ATTACHMENT_CONTRACT } from \"@kungfu-tech/buildchain\";",
21258
21959
  "maturity": "stable",
@@ -21306,7 +22007,7 @@
21306
22007
  ],
21307
22008
  "source": {
21308
22009
  "path": "packages/core/release-passport.js",
21309
- "line": 235
22010
+ "line": 238
21310
22011
  },
21311
22012
  "example": "import { sha256File } from \"@kungfu-tech/buildchain\";",
21312
22013
  "maturity": "stable",
@@ -21335,7 +22036,7 @@
21335
22036
  ],
21336
22037
  "source": {
21337
22038
  "path": "packages/core/release-passport.js",
21338
- "line": 157
22039
+ "line": 160
21339
22040
  },
21340
22041
  "example": "import { sha256Text } from \"@kungfu-tech/buildchain\";",
21341
22042
  "maturity": "stable",
@@ -21359,7 +22060,7 @@
21359
22060
  ],
21360
22061
  "source": {
21361
22062
  "path": "packages/core/release-passport.js",
21362
- "line": 2983
22063
+ "line": 2804
21363
22064
  },
21364
22065
  "example": "import { validateKnownReleasePassportContracts } from \"@kungfu-tech/buildchain\";",
21365
22066
  "maturity": "stable",
@@ -21388,7 +22089,7 @@
21388
22089
  ],
21389
22090
  "source": {
21390
22091
  "path": "packages/core/release-passport.js",
21391
- "line": 2907
22092
+ "line": 2728
21392
22093
  },
21393
22094
  "example": "import { verifyReleasePassport } from \"@kungfu-tech/buildchain\";",
21394
22095
  "maturity": "stable",
@@ -24635,7 +25336,223 @@
24635
25336
  "path": "packages/core/v4-adopter-delivery.js",
24636
25337
  "line": 356
24637
25338
  },
24638
- "example": "import { V4_ADOPTER_DELIVERY_SELECTORS } from \"@kungfu-tech/buildchain/v4-adopter-delivery\";",
25339
+ "example": "import { V4_ADOPTER_DELIVERY_SELECTORS } from \"@kungfu-tech/buildchain/v4-adopter-delivery\";",
25340
+ "maturity": "stable",
25341
+ "audience": [
25342
+ "developer",
25343
+ "agent"
25344
+ ]
25345
+ },
25346
+ {
25347
+ "id": "packages/core/v4-adopter-delivery.js#V4_ADOPTER_DELIVERY_SOURCE",
25348
+ "name": "V4_ADOPTER_DELIVERY_SOURCE",
25349
+ "kind": "constant",
25350
+ "signature": "const V4_ADOPTER_DELIVERY_SOURCE",
25351
+ "parameters": [],
25352
+ "returns": "value",
25353
+ "errors": [
25354
+ "Import does not declare a throw contract."
25355
+ ],
25356
+ "sideEffects": [
25357
+ "none-on-import"
25358
+ ],
25359
+ "source": {
25360
+ "path": "packages/core/v4-adopter-delivery.js",
25361
+ "line": 20
25362
+ },
25363
+ "example": "import { V4_ADOPTER_DELIVERY_SOURCE } from \"@kungfu-tech/buildchain/v4-adopter-delivery\";",
25364
+ "maturity": "stable",
25365
+ "audience": [
25366
+ "developer",
25367
+ "agent"
25368
+ ]
25369
+ },
25370
+ {
25371
+ "id": "packages/core/v4-adopter-delivery.js#verifyV4AdopterDeliveryReadback",
25372
+ "name": "verifyV4AdopterDeliveryReadback",
25373
+ "kind": "function",
25374
+ "signature": "function verifyV4AdopterDeliveryReadback({ input, readback } = {}, options = {})",
25375
+ "parameters": [
25376
+ {
25377
+ "name": "parameter1",
25378
+ "signature": "{ input, readback } = {}"
25379
+ },
25380
+ {
25381
+ "name": "options",
25382
+ "signature": "options = {}"
25383
+ }
25384
+ ],
25385
+ "returns": "unknown",
25386
+ "errors": [
25387
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
25388
+ ],
25389
+ "sideEffects": [
25390
+ "none-detected-by-static-source-scan"
25391
+ ],
25392
+ "source": {
25393
+ "path": "packages/core/v4-adopter-delivery.js",
25394
+ "line": 233
25395
+ },
25396
+ "example": "import { verifyV4AdopterDeliveryReadback } from \"@kungfu-tech/buildchain/v4-adopter-delivery\";",
25397
+ "maturity": "stable",
25398
+ "audience": [
25399
+ "developer",
25400
+ "agent"
25401
+ ]
25402
+ },
25403
+ {
25404
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#createV4CrossPlatformAdopterReport",
25405
+ "name": "createV4CrossPlatformAdopterReport",
25406
+ "kind": "function",
25407
+ "signature": "function createV4CrossPlatformAdopterReport(input)",
25408
+ "parameters": [
25409
+ {
25410
+ "name": "input",
25411
+ "signature": "input"
25412
+ }
25413
+ ],
25414
+ "returns": "unknown",
25415
+ "errors": [
25416
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
25417
+ ],
25418
+ "sideEffects": [
25419
+ "none-detected-by-static-source-scan"
25420
+ ],
25421
+ "source": {
25422
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25423
+ "line": 259
25424
+ },
25425
+ "example": "import { createV4CrossPlatformAdopterReport } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
25426
+ "maturity": "stable",
25427
+ "audience": [
25428
+ "developer",
25429
+ "agent"
25430
+ ]
25431
+ },
25432
+ {
25433
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#qualifyV4CrossPlatformAdopters",
25434
+ "name": "qualifyV4CrossPlatformAdopters",
25435
+ "kind": "function",
25436
+ "signature": "function qualifyV4CrossPlatformAdopters({ reports, consumers })",
25437
+ "parameters": [
25438
+ {
25439
+ "name": "parameter1",
25440
+ "signature": "{ reports, consumers }"
25441
+ }
25442
+ ],
25443
+ "returns": "unknown",
25444
+ "errors": [
25445
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
25446
+ ],
25447
+ "sideEffects": [
25448
+ "may-write-or-invoke-external-actions"
25449
+ ],
25450
+ "source": {
25451
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25452
+ "line": 270
25453
+ },
25454
+ "example": "import { qualifyV4CrossPlatformAdopters } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
25455
+ "maturity": "stable",
25456
+ "audience": [
25457
+ "developer",
25458
+ "agent"
25459
+ ]
25460
+ },
25461
+ {
25462
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#summarizeV3V4CapabilityInventory",
25463
+ "name": "summarizeV3V4CapabilityInventory",
25464
+ "kind": "function",
25465
+ "signature": "function summarizeV3V4CapabilityInventory(inventory)",
25466
+ "parameters": [
25467
+ {
25468
+ "name": "inventory",
25469
+ "signature": "inventory"
25470
+ }
25471
+ ],
25472
+ "returns": "unknown",
25473
+ "errors": [
25474
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
25475
+ ],
25476
+ "sideEffects": [
25477
+ "none-detected-by-static-source-scan"
25478
+ ],
25479
+ "source": {
25480
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25481
+ "line": 39
25482
+ },
25483
+ "example": "import { summarizeV3V4CapabilityInventory } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
25484
+ "maturity": "stable",
25485
+ "audience": [
25486
+ "developer",
25487
+ "agent"
25488
+ ]
25489
+ },
25490
+ {
25491
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_ADOPTER_PLATFORMS",
25492
+ "name": "V4_CROSS_PLATFORM_ADOPTER_PLATFORMS",
25493
+ "kind": "constant",
25494
+ "signature": "const V4_CROSS_PLATFORM_ADOPTER_PLATFORMS",
25495
+ "parameters": [],
25496
+ "returns": "value",
25497
+ "errors": [
25498
+ "Import does not declare a throw contract."
25499
+ ],
25500
+ "sideEffects": [
25501
+ "none-on-import"
25502
+ ],
25503
+ "source": {
25504
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25505
+ "line": 7
25506
+ },
25507
+ "example": "import { V4_CROSS_PLATFORM_ADOPTER_PLATFORMS } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
25508
+ "maturity": "stable",
25509
+ "audience": [
25510
+ "developer",
25511
+ "agent"
25512
+ ]
25513
+ },
25514
+ {
25515
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_ADOPTER_QUALIFICATION_CONTRACT",
25516
+ "name": "V4_CROSS_PLATFORM_ADOPTER_QUALIFICATION_CONTRACT",
25517
+ "kind": "constant",
25518
+ "signature": "const V4_CROSS_PLATFORM_ADOPTER_QUALIFICATION_CONTRACT",
25519
+ "parameters": [],
25520
+ "returns": "value",
25521
+ "errors": [
25522
+ "Import does not declare a throw contract."
25523
+ ],
25524
+ "sideEffects": [
25525
+ "none-on-import"
25526
+ ],
25527
+ "source": {
25528
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25529
+ "line": 5
25530
+ },
25531
+ "example": "import { V4_CROSS_PLATFORM_ADOPTER_QUALIFICATION_CONTRACT } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
25532
+ "maturity": "stable",
25533
+ "audience": [
25534
+ "developer",
25535
+ "agent"
25536
+ ]
25537
+ },
25538
+ {
25539
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_ADOPTER_REPORT_CONTRACT",
25540
+ "name": "V4_CROSS_PLATFORM_ADOPTER_REPORT_CONTRACT",
25541
+ "kind": "constant",
25542
+ "signature": "const V4_CROSS_PLATFORM_ADOPTER_REPORT_CONTRACT",
25543
+ "parameters": [],
25544
+ "returns": "value",
25545
+ "errors": [
25546
+ "Import does not declare a throw contract."
25547
+ ],
25548
+ "sideEffects": [
25549
+ "none-on-import"
25550
+ ],
25551
+ "source": {
25552
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25553
+ "line": 3
25554
+ },
25555
+ "example": "import { V4_CROSS_PLATFORM_ADOPTER_REPORT_CONTRACT } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
24639
25556
  "maturity": "stable",
24640
25557
  "audience": [
24641
25558
  "developer",
@@ -24643,10 +25560,10 @@
24643
25560
  ]
24644
25561
  },
24645
25562
  {
24646
- "id": "packages/core/v4-adopter-delivery.js#V4_ADOPTER_DELIVERY_SOURCE",
24647
- "name": "V4_ADOPTER_DELIVERY_SOURCE",
25563
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_NEUTRAL_DRIVER",
25564
+ "name": "V4_CROSS_PLATFORM_NEUTRAL_DRIVER",
24648
25565
  "kind": "constant",
24649
- "signature": "const V4_ADOPTER_DELIVERY_SOURCE",
25566
+ "signature": "const V4_CROSS_PLATFORM_NEUTRAL_DRIVER",
24650
25567
  "parameters": [],
24651
25568
  "returns": "value",
24652
25569
  "errors": [
@@ -24656,10 +25573,10 @@
24656
25573
  "none-on-import"
24657
25574
  ],
24658
25575
  "source": {
24659
- "path": "packages/core/v4-adopter-delivery.js",
24660
- "line": 20
25576
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25577
+ "line": 12
24661
25578
  },
24662
- "example": "import { V4_ADOPTER_DELIVERY_SOURCE } from \"@kungfu-tech/buildchain/v4-adopter-delivery\";",
25579
+ "example": "import { V4_CROSS_PLATFORM_NEUTRAL_DRIVER } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
24663
25580
  "maturity": "stable",
24664
25581
  "audience": [
24665
25582
  "developer",
@@ -24667,32 +25584,28 @@
24667
25584
  ]
24668
25585
  },
24669
25586
  {
24670
- "id": "packages/core/v4-adopter-delivery.js#verifyV4AdopterDeliveryReadback",
24671
- "name": "verifyV4AdopterDeliveryReadback",
25587
+ "id": "packages/core/v4-cross-platform-adopter-qualification.js#validateV4CrossPlatformAdopterReport",
25588
+ "name": "validateV4CrossPlatformAdopterReport",
24672
25589
  "kind": "function",
24673
- "signature": "function verifyV4AdopterDeliveryReadback({ input, readback } = {}, options = {})",
25590
+ "signature": "function validateV4CrossPlatformAdopterReport(report)",
24674
25591
  "parameters": [
24675
25592
  {
24676
- "name": "parameter1",
24677
- "signature": "{ input, readback } = {}"
24678
- },
24679
- {
24680
- "name": "options",
24681
- "signature": "options = {}"
25593
+ "name": "report",
25594
+ "signature": "report"
24682
25595
  }
24683
25596
  ],
24684
25597
  "returns": "unknown",
24685
25598
  "errors": [
24686
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
25599
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
24687
25600
  ],
24688
25601
  "sideEffects": [
24689
25602
  "none-detected-by-static-source-scan"
24690
25603
  ],
24691
25604
  "source": {
24692
- "path": "packages/core/v4-adopter-delivery.js",
24693
- "line": 233
25605
+ "path": "packages/core/v4-cross-platform-adopter-qualification.js",
25606
+ "line": 222
24694
25607
  },
24695
- "example": "import { verifyV4AdopterDeliveryReadback } from \"@kungfu-tech/buildchain/v4-adopter-delivery\";",
25608
+ "example": "import { validateV4CrossPlatformAdopterReport } from \"@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification\";",
24696
25609
  "maturity": "stable",
24697
25610
  "audience": [
24698
25611
  "developer",
@@ -24936,7 +25849,7 @@
24936
25849
  ],
24937
25850
  "source": {
24938
25851
  "path": "packages/core/v4-floating-consumer-policy.js",
24939
- "line": 428
25852
+ "line": 429
24940
25853
  },
24941
25854
  "example": "import { scanV4FloatingConsumerPolicy } from \"@kungfu-tech/buildchain\";",
24942
25855
  "maturity": "stable",
@@ -24974,6 +25887,207 @@
24974
25887
  "agent"
24975
25888
  ]
24976
25889
  },
25890
+ {
25891
+ "id": "packages/core/v4-publication-qualification.js#assertNoV4ExecutionFields",
25892
+ "name": "assertNoV4ExecutionFields",
25893
+ "kind": "function",
25894
+ "signature": "function assertNoV4ExecutionFields(value, location = \"$\")",
25895
+ "parameters": [
25896
+ {
25897
+ "name": "value",
25898
+ "signature": "value"
25899
+ },
25900
+ {
25901
+ "name": "location",
25902
+ "signature": "location = \"$\""
25903
+ }
25904
+ ],
25905
+ "returns": "unknown",
25906
+ "errors": [
25907
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
25908
+ ],
25909
+ "sideEffects": [
25910
+ "none-detected-by-static-source-scan"
25911
+ ],
25912
+ "source": {
25913
+ "path": "packages/core/v4-publication-qualification.js",
25914
+ "line": 46
25915
+ },
25916
+ "example": "import { assertNoV4ExecutionFields } from \"@kungfu-tech/buildchain\";",
25917
+ "maturity": "stable",
25918
+ "audience": [
25919
+ "developer",
25920
+ "agent"
25921
+ ]
25922
+ },
25923
+ {
25924
+ "id": "packages/core/v4-publication-qualification.js#assertV4DeclarativePromotionInputs",
25925
+ "name": "assertV4DeclarativePromotionInputs",
25926
+ "kind": "function",
25927
+ "signature": "function assertV4DeclarativePromotionInputs(inputs)",
25928
+ "parameters": [
25929
+ {
25930
+ "name": "inputs",
25931
+ "signature": "inputs"
25932
+ }
25933
+ ],
25934
+ "returns": "unknown",
25935
+ "errors": [
25936
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
25937
+ ],
25938
+ "sideEffects": [
25939
+ "none-detected-by-static-source-scan"
25940
+ ],
25941
+ "source": {
25942
+ "path": "packages/core/v4-publication-qualification.js",
25943
+ "line": 207
25944
+ },
25945
+ "example": "import { assertV4DeclarativePromotionInputs } from \"@kungfu-tech/buildchain\";",
25946
+ "maturity": "stable",
25947
+ "audience": [
25948
+ "developer",
25949
+ "agent"
25950
+ ]
25951
+ },
25952
+ {
25953
+ "id": "packages/core/v4-publication-qualification.js#createV4PublicationQualificationReceipt",
25954
+ "name": "createV4PublicationQualificationReceipt",
25955
+ "kind": "function",
25956
+ "signature": "function createV4PublicationQualificationReceipt({ repository, candidateRoot, sourceSha, sourceRoot, policyDigest, artifacts, issuedAt, expiresAt, })",
25957
+ "parameters": [
25958
+ {
25959
+ "name": "parameter1",
25960
+ "signature": "{ repository, candidateRoot, sourceSha, sourceRoot, policyDigest, artifacts, issuedAt, expiresAt, }"
25961
+ }
25962
+ ],
25963
+ "returns": "unknown",
25964
+ "errors": [
25965
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
25966
+ ],
25967
+ "sideEffects": [
25968
+ "none-detected-by-static-source-scan"
25969
+ ],
25970
+ "source": {
25971
+ "path": "packages/core/v4-publication-qualification.js",
25972
+ "line": 112
25973
+ },
25974
+ "example": "import { createV4PublicationQualificationReceipt } from \"@kungfu-tech/buildchain\";",
25975
+ "maturity": "stable",
25976
+ "audience": [
25977
+ "developer",
25978
+ "agent"
25979
+ ]
25980
+ },
25981
+ {
25982
+ "id": "packages/core/v4-publication-qualification.js#V4_PUBLICATION_QUALIFICATION_SCHEMA",
25983
+ "name": "V4_PUBLICATION_QUALIFICATION_SCHEMA",
25984
+ "kind": "constant",
25985
+ "signature": "const V4_PUBLICATION_QUALIFICATION_SCHEMA",
25986
+ "parameters": [],
25987
+ "returns": "value",
25988
+ "errors": [
25989
+ "Import does not declare a throw contract."
25990
+ ],
25991
+ "sideEffects": [
25992
+ "none-on-import"
25993
+ ],
25994
+ "source": {
25995
+ "path": "packages/core/v4-publication-qualification.js",
25996
+ "line": 3
25997
+ },
25998
+ "example": "import { V4_PUBLICATION_QUALIFICATION_SCHEMA } from \"@kungfu-tech/buildchain\";",
25999
+ "maturity": "stable",
26000
+ "audience": [
26001
+ "developer",
26002
+ "agent"
26003
+ ]
26004
+ },
26005
+ {
26006
+ "id": "packages/core/v4-publication-qualification.js#V4PublicationQualificationError",
26007
+ "name": "V4PublicationQualificationError",
26008
+ "kind": "class",
26009
+ "signature": "class V4PublicationQualificationError",
26010
+ "parameters": [],
26011
+ "returns": "V4PublicationQualificationError",
26012
+ "errors": [
26013
+ "Construction and method errors follow the linked source implementation."
26014
+ ],
26015
+ "sideEffects": [
26016
+ "class-dependent"
26017
+ ],
26018
+ "source": {
26019
+ "path": "packages/core/v4-publication-qualification.js",
26020
+ "line": 19
26021
+ },
26022
+ "example": "import { V4PublicationQualificationError } from \"@kungfu-tech/buildchain\";",
26023
+ "maturity": "stable",
26024
+ "audience": [
26025
+ "developer",
26026
+ "agent"
26027
+ ]
26028
+ },
26029
+ {
26030
+ "id": "packages/core/v4-publication-qualification.js#v4PublicationQualificationRoot",
26031
+ "name": "v4PublicationQualificationRoot",
26032
+ "kind": "function",
26033
+ "signature": "function v4PublicationQualificationRoot(value)",
26034
+ "parameters": [
26035
+ {
26036
+ "name": "value",
26037
+ "signature": "value"
26038
+ }
26039
+ ],
26040
+ "returns": "unknown",
26041
+ "errors": [
26042
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
26043
+ ],
26044
+ "sideEffects": [
26045
+ "none-detected-by-static-source-scan"
26046
+ ],
26047
+ "source": {
26048
+ "path": "packages/core/v4-publication-qualification.js",
26049
+ "line": 42
26050
+ },
26051
+ "example": "import { v4PublicationQualificationRoot } from \"@kungfu-tech/buildchain\";",
26052
+ "maturity": "stable",
26053
+ "audience": [
26054
+ "developer",
26055
+ "agent"
26056
+ ]
26057
+ },
26058
+ {
26059
+ "id": "packages/core/v4-publication-qualification.js#validateV4PublicationQualificationReceipt",
26060
+ "name": "validateV4PublicationQualificationReceipt",
26061
+ "kind": "function",
26062
+ "signature": "function validateV4PublicationQualificationReceipt(receipt, { repository, candidateRoot, sourceSha, sourceRoot, artifactRoot, policyDigest, evaluatedAt = new Date().toISOString(), } = {})",
26063
+ "parameters": [
26064
+ {
26065
+ "name": "receipt",
26066
+ "signature": "receipt"
26067
+ },
26068
+ {
26069
+ "name": "parameter2",
26070
+ "signature": "{ repository, candidateRoot, sourceSha, sourceRoot, artifactRoot, policyDigest, evaluatedAt = new Date().toISOString(), } = {}"
26071
+ }
26072
+ ],
26073
+ "returns": "unknown",
26074
+ "errors": [
26075
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
26076
+ ],
26077
+ "sideEffects": [
26078
+ "none-detected-by-static-source-scan"
26079
+ ],
26080
+ "source": {
26081
+ "path": "packages/core/v4-publication-qualification.js",
26082
+ "line": 152
26083
+ },
26084
+ "example": "import { validateV4PublicationQualificationReceipt } from \"@kungfu-tech/buildchain\";",
26085
+ "maturity": "stable",
26086
+ "audience": [
26087
+ "developer",
26088
+ "agent"
26089
+ ]
26090
+ },
24977
26091
  {
24978
26092
  "id": "packages/core/v4-publication-rehearsal.js#createV4PublicationRehearsalAuthority",
24979
26093
  "name": "createV4PublicationRehearsalAuthority",
@@ -25976,14 +27090,14 @@
25976
27090
  "specifier": "@kungfu-tech/buildchain",
25977
27091
  "export": ".",
25978
27092
  "target": "./packages/core/index.js",
25979
- "digest": "sha256:133da9d5574d655a6ea618522aae12a3138c7ea647fda85fb0204373d55d4201",
27093
+ "digest": "sha256:2cb7db3f5c833753ec2cbd496b7711a93c1874928a577a7e328128a53c2ace3e",
25980
27094
  "summary": "Root toolkit export for Buildchain's public Node API.",
25981
27095
  "capabilityGroup": "api-cli-reference",
25982
27096
  "audience": [
25983
27097
  "developer",
25984
27098
  "agent"
25985
27099
  ],
25986
- "symbolCount": 629,
27100
+ "symbolCount": 636,
25987
27101
  "symbolIds": [
25988
27102
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
25989
27103
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -26006,8 +27120,10 @@
26006
27120
  "packages/core/artifact-signing.js#artifactSigningDigest",
26007
27121
  "packages/core/artifact-signing-result.js#artifactSigningEvidenceDigest",
26008
27122
  "packages/core/artifact-verification-envelope.js#artifactVerificationEnvelopeDigest",
27123
+ "packages/core/v4-publication-qualification.js#assertNoV4ExecutionFields",
26009
27124
  "packages/core/package-manager.js#assertPackageManager",
26010
27125
  "packages/core/public-surface-audit.js#assertPublicSurfaceReverseAudit",
27126
+ "packages/core/v4-publication-qualification.js#assertV4DeclarativePromotionInputs",
26011
27127
  "packages/core/kfd3-surface-register.js#auditKfd3Surfaces",
26012
27128
  "packages/core/v4-runtime-ref-resume-authority.js#authorizeV4RuntimeSelection",
26013
27129
  "packages/core/readme-badges.js#BADGE_BUNDLE_DEFAULT_CLAIMS",
@@ -26210,6 +27326,7 @@
26210
27326
  "packages/core/release-tail-provider-adapters.js#createSiteReleaseActivationAdapter",
26211
27327
  "packages/core/stable-candidate-ledger.js#createStableCandidateLedger",
26212
27328
  "packages/core/surface-manifest.js#createSurfaceTimestampPolicy",
27329
+ "packages/core/v4-publication-qualification.js#createV4PublicationQualificationReceipt",
26213
27330
  "packages/core/v4-runtime-ref-resume-authority.js#createV4RuntimeResumeLineage",
26214
27331
  "packages/core/web-surface-publication-candidate.js#createWebSurfaceProductionDecision",
26215
27332
  "packages/core/web-surface-publication-candidate.js#createWebSurfacePublicationCandidate",
@@ -26546,11 +27663,14 @@
26546
27663
  "packages/core/v4-floating-consumer-evidence.js#V4_FLOATING_CONSUMER_CERTIFICATION",
26547
27664
  "packages/core/v4-floating-consumer-evidence.js#V4_FLOATING_CONSUMER_POLICY",
26548
27665
  "packages/core/v4-floating-consumer-evidence.js#V4_FLOATING_CONSUMER_RECEIPT",
27666
+ "packages/core/v4-publication-qualification.js#V4_PUBLICATION_QUALIFICATION_SCHEMA",
26549
27667
  "packages/core/v4-runtime-ref-resume-authority.js#V4_RUNTIME_AUTHORIZATION_CONTRACT",
26550
27668
  "packages/core/v4-runtime-ref-resume-authority.js#V4_RUNTIME_PERSISTENCE_SCAN_CONTRACT",
26551
27669
  "packages/core/v4-runtime-ref-resume-authority.js#V4_RUNTIME_RESUME_LINEAGE_CONTRACT",
26552
27670
  "packages/core/v4-floating-consumer-policy.js#v4ConsumerPolicyScannerRoot",
26553
27671
  "packages/core/v4-floating-consumer-evidence.js#v4FloatingConsumerDocumentRoot",
27672
+ "packages/core/v4-publication-qualification.js#V4PublicationQualificationError",
27673
+ "packages/core/v4-publication-qualification.js#v4PublicationQualificationRoot",
26554
27674
  "packages/core/v4-runtime-ref-resume-authority.js#v4RuntimeResumeDocumentRoot",
26555
27675
  "packages/core/diagnostics.js#validateAnchoredPackageRelease",
26556
27676
  "packages/core/artifact-signing.js#validateArtifactSigningReceipt",
@@ -26574,6 +27694,7 @@
26574
27694
  "packages/core/release-passport-contract.js#validateReleasePassportSchema",
26575
27695
  "packages/core/release-tail-provider-plane.js#validateReleaseTailEffectPlan",
26576
27696
  "packages/core/release-tail-provider-plane.js#validateReleaseTailTransaction",
27697
+ "packages/core/v4-publication-qualification.js#validateV4PublicationQualificationReceipt",
26577
27698
  "packages/core/artifact-passport.js#verifyArtifactPassport",
26578
27699
  "packages/core/artifact-signing-result.js#verifyArtifactSigningResultFiles",
26579
27700
  "packages/core/artifact-verification-envelope.js#verifyArtifactVerificationEnvelope",
@@ -26703,14 +27824,14 @@
26703
27824
  "specifier": "@kungfu-tech/buildchain/core",
26704
27825
  "export": "./core",
26705
27826
  "target": "./packages/core/index.js",
26706
- "digest": "sha256:133da9d5574d655a6ea618522aae12a3138c7ea647fda85fb0204373d55d4201",
27827
+ "digest": "sha256:2cb7db3f5c833753ec2cbd496b7711a93c1874928a577a7e328128a53c2ace3e",
26707
27828
  "summary": "Alias for the root public toolkit export.",
26708
27829
  "capabilityGroup": "api-cli-reference",
26709
27830
  "audience": [
26710
27831
  "developer",
26711
27832
  "agent"
26712
27833
  ],
26713
- "symbolCount": 629,
27834
+ "symbolCount": 636,
26714
27835
  "symbolIds": [
26715
27836
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
26716
27837
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -26733,8 +27854,10 @@
26733
27854
  "packages/core/artifact-signing.js#artifactSigningDigest",
26734
27855
  "packages/core/artifact-signing-result.js#artifactSigningEvidenceDigest",
26735
27856
  "packages/core/artifact-verification-envelope.js#artifactVerificationEnvelopeDigest",
27857
+ "packages/core/v4-publication-qualification.js#assertNoV4ExecutionFields",
26736
27858
  "packages/core/package-manager.js#assertPackageManager",
26737
27859
  "packages/core/public-surface-audit.js#assertPublicSurfaceReverseAudit",
27860
+ "packages/core/v4-publication-qualification.js#assertV4DeclarativePromotionInputs",
26738
27861
  "packages/core/kfd3-surface-register.js#auditKfd3Surfaces",
26739
27862
  "packages/core/v4-runtime-ref-resume-authority.js#authorizeV4RuntimeSelection",
26740
27863
  "packages/core/readme-badges.js#BADGE_BUNDLE_DEFAULT_CLAIMS",
@@ -26937,6 +28060,7 @@
26937
28060
  "packages/core/release-tail-provider-adapters.js#createSiteReleaseActivationAdapter",
26938
28061
  "packages/core/stable-candidate-ledger.js#createStableCandidateLedger",
26939
28062
  "packages/core/surface-manifest.js#createSurfaceTimestampPolicy",
28063
+ "packages/core/v4-publication-qualification.js#createV4PublicationQualificationReceipt",
26940
28064
  "packages/core/v4-runtime-ref-resume-authority.js#createV4RuntimeResumeLineage",
26941
28065
  "packages/core/web-surface-publication-candidate.js#createWebSurfaceProductionDecision",
26942
28066
  "packages/core/web-surface-publication-candidate.js#createWebSurfacePublicationCandidate",
@@ -27273,11 +28397,14 @@
27273
28397
  "packages/core/v4-floating-consumer-evidence.js#V4_FLOATING_CONSUMER_CERTIFICATION",
27274
28398
  "packages/core/v4-floating-consumer-evidence.js#V4_FLOATING_CONSUMER_POLICY",
27275
28399
  "packages/core/v4-floating-consumer-evidence.js#V4_FLOATING_CONSUMER_RECEIPT",
28400
+ "packages/core/v4-publication-qualification.js#V4_PUBLICATION_QUALIFICATION_SCHEMA",
27276
28401
  "packages/core/v4-runtime-ref-resume-authority.js#V4_RUNTIME_AUTHORIZATION_CONTRACT",
27277
28402
  "packages/core/v4-runtime-ref-resume-authority.js#V4_RUNTIME_PERSISTENCE_SCAN_CONTRACT",
27278
28403
  "packages/core/v4-runtime-ref-resume-authority.js#V4_RUNTIME_RESUME_LINEAGE_CONTRACT",
27279
28404
  "packages/core/v4-floating-consumer-policy.js#v4ConsumerPolicyScannerRoot",
27280
28405
  "packages/core/v4-floating-consumer-evidence.js#v4FloatingConsumerDocumentRoot",
28406
+ "packages/core/v4-publication-qualification.js#V4PublicationQualificationError",
28407
+ "packages/core/v4-publication-qualification.js#v4PublicationQualificationRoot",
27281
28408
  "packages/core/v4-runtime-ref-resume-authority.js#v4RuntimeResumeDocumentRoot",
27282
28409
  "packages/core/diagnostics.js#validateAnchoredPackageRelease",
27283
28410
  "packages/core/artifact-signing.js#validateArtifactSigningReceipt",
@@ -27301,6 +28428,7 @@
27301
28428
  "packages/core/release-passport-contract.js#validateReleasePassportSchema",
27302
28429
  "packages/core/release-tail-provider-plane.js#validateReleaseTailEffectPlan",
27303
28430
  "packages/core/release-tail-provider-plane.js#validateReleaseTailTransaction",
28431
+ "packages/core/v4-publication-qualification.js#validateV4PublicationQualificationReceipt",
27304
28432
  "packages/core/artifact-passport.js#verifyArtifactPassport",
27305
28433
  "packages/core/artifact-signing-result.js#verifyArtifactSigningResultFiles",
27306
28434
  "packages/core/artifact-verification-envelope.js#verifyArtifactVerificationEnvelope",
@@ -27567,7 +28695,7 @@
27567
28695
  "specifier": "@kungfu-tech/buildchain/buildchain-contract",
27568
28696
  "export": "./buildchain-contract",
27569
28697
  "target": "./packages/core/buildchain-contract.js",
27570
- "digest": "sha256:b9f85d83f8bf638fe967a2aef6ac2b5f3efbe0be46c5a176e03e38c9146c35e3",
28698
+ "digest": "sha256:3a8e9c3c834af04e1e22807030106efeecf053bda7911e939055b2654c54cbd6",
27571
28699
  "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
27572
28700
  "capabilityGroup": "governance-versioning",
27573
28701
  "audience": [
@@ -27926,14 +29054,14 @@
27926
29054
  "specifier": "@kungfu-tech/buildchain/dev-delivery-warrant",
27927
29055
  "export": "./dev-delivery-warrant",
27928
29056
  "target": "./packages/core/dev-delivery-warrant.js",
27929
- "digest": "sha256:621dac9c40b6e9aab15ea9340a5d7b8d05639c4bee497ddb64470cd2141f38a1",
29057
+ "digest": "sha256:19d8a5b924bbc261d39bd33312d9177450d246256b2af44cea89f476394a477c",
27930
29058
  "summary": "Durable fair Dev Delivery Warrant queue, fenced lease, and split source and integration proof APIs.",
27931
29059
  "capabilityGroup": "governance-versioning",
27932
29060
  "audience": [
27933
29061
  "developer",
27934
29062
  "agent"
27935
29063
  ],
27936
- "symbolCount": 54,
29064
+ "symbolCount": 56,
27937
29065
  "symbolIds": [
27938
29066
  "packages/core/dev-delivery-warrant.js#cancelQueuedDevDeliveryCandidate",
27939
29067
  "packages/core/dev-delivery-proof.js#classifyDevDeliveryDelta",
@@ -27960,6 +29088,7 @@
27960
29088
  "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SELECTION_RECEIPT_SCHEMA",
27961
29089
  "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SETTLEMENT_RECEIPT_SCHEMA",
27962
29090
  "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_SUBMISSION_RECEIPT_SCHEMA",
29091
+ "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_TERMINAL_EVIDENCE_CORRECTION_SCHEMA",
27963
29092
  "packages/core/dev-delivery-warrant.js#DEV_DELIVERY_WARRANT_SCHEMA",
27964
29093
  "packages/core/dev-delivery-common.js#devDeliveryContentRoot",
27965
29094
  "packages/core/dev-delivery-warrant.js#heartbeatDevDeliveryWarrant",
@@ -27976,6 +29105,7 @@
27976
29105
  "packages/core/dev-delivery-proof.js#PROJECT_CUT_REPLAY_PROOF_SCHEMA",
27977
29106
  "packages/core/dev-delivery-warrant.js#qualifyDevDeliveryWarrant",
27978
29107
  "packages/core/dev-delivery-warrant.js#rankDevDeliveryCandidates",
29108
+ "packages/core/dev-delivery-warrant.js#reconcileDevDeliveryTerminalEvidence",
27979
29109
  "packages/core/dev-delivery-warrant.js#recoverExpiredDevDeliveryWarrant",
27980
29110
  "packages/core/release-blocker-priority.js#RELEASE_BLOCKER_PRIORITY_CLAIM_SCHEMA",
27981
29111
  "packages/core/dev-delivery-warrant.js#selectDevDeliveryWarrant",
@@ -28389,7 +29519,7 @@
28389
29519
  "specifier": "@kungfu-tech/buildchain/v4-floating-consumer-policy",
28390
29520
  "export": "./v4-floating-consumer-policy",
28391
29521
  "target": "./packages/core/v4-floating-consumer-policy.js",
28392
- "digest": "sha256:63025628454a130404894dd3a08906098c6cdd57ed33aff85264da6548348e42",
29522
+ "digest": "sha256:95136fbc5d53bfd37b39b3e2fb331fbbb518ef51d5362cc65c5df4d2ea0fee35",
28393
29523
  "summary": "Semantic floating-selector admission, dual-lock receipt, and independent v4 consumer certification APIs.",
28394
29524
  "capabilityGroup": "governance-versioning",
28395
29525
  "audience": [
@@ -28538,6 +29668,103 @@
28538
29668
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
28539
29669
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
28540
29670
  },
29671
+ {
29672
+ "specifier": "@kungfu-tech/buildchain/publication-rehearsal-runtime",
29673
+ "export": "./publication-rehearsal-runtime",
29674
+ "target": "./packages/core/publication-rehearsal-runtime.js",
29675
+ "digest": "sha256:cd7b3d76223b859b995a30988d5432c1c5e05fdb304d7fa2d98db43ec85e3606",
29676
+ "summary": "Compatibility names for the source-bound v4 publication rehearsal runtime and explicit rooted migration diagnostics.",
29677
+ "capabilityGroup": "release-passport-trust",
29678
+ "audience": [
29679
+ "developer",
29680
+ "agent"
29681
+ ],
29682
+ "symbolCount": 14,
29683
+ "symbolIds": [
29684
+ "packages/core/publication-rehearsal-runtime.js#createPublicationRehearsalCapsule",
29685
+ "packages/core/publication-rehearsal-runtime.js#executePublicationRehearsal",
29686
+ "packages/core/publication-rehearsal-runtime.js#normalizePublicationRehearsalCapsule",
29687
+ "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_CAPSULE_CONTRACT",
29688
+ "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_COMMAND",
29689
+ "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_DIAGNOSTIC_CONTRACT",
29690
+ "packages/core/publication-rehearsal-runtime.js#PUBLICATION_REHEARSAL_EVIDENCE_CONTRACT",
29691
+ "packages/core/publication-rehearsal-runtime.js#publicationRehearsalBindingRoot",
29692
+ "packages/core/publication-rehearsal-runtime.js#publicationRehearsalDiagnostic",
29693
+ "packages/core/publication-rehearsal-runtime.js#PublicationRehearsalError",
29694
+ "packages/core/publication-rehearsal-runtime.js#RELEASE_LOCAL_CONSTRUCTIBILITY_ADR",
29695
+ "packages/core/publication-rehearsal-runtime.js#RELEASE_LOCAL_CONSTRUCTIBILITY_INVARIANT",
29696
+ "packages/core/publication-rehearsal-runtime.js#resolvePublicationRehearsalFile",
29697
+ "packages/core/publication-rehearsal-runtime.js#verifyPublicationRehearsalCapsule"
29698
+ ],
29699
+ "owner": "buildchain-core",
29700
+ "maturity": "stable",
29701
+ "introducedVersion": "pre-3.0.2-alpha.4",
29702
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
29703
+ "deprecationReplacement": "",
29704
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
29705
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
29706
+ },
29707
+ {
29708
+ "specifier": "@kungfu-tech/buildchain/publication-rehearsal-projection",
29709
+ "export": "./publication-rehearsal-projection",
29710
+ "target": "./packages/core/publication-rehearsal-projection.js",
29711
+ "digest": "sha256:3cd3538b52d4f8abc6e90d8dab1ffe1d3b2cf71c1bb37313cb077fb20ca16d6f",
29712
+ "summary": "Compatibility projection helpers that emit only the current source-bound v4 publication rehearsal configuration and workflow.",
29713
+ "capabilityGroup": "release-passport-trust",
29714
+ "audience": [
29715
+ "developer",
29716
+ "agent"
29717
+ ],
29718
+ "symbolCount": 10,
29719
+ "symbolIds": [
29720
+ "packages/core/publication-rehearsal-projection.js#appendPublicationRehearsalToml",
29721
+ "packages/core/publication-rehearsal-projection.js#assertPublicationRehearsalConfig",
29722
+ "packages/core/publication-rehearsal-projection.js#mergePublicationRehearsalAgentInstructions",
29723
+ "packages/core/publication-rehearsal-projection.js#projectPublicationRehearsalToml",
29724
+ "packages/core/publication-rehearsal-projection.js#PUBLICATION_REHEARSAL_AGENT_SECTION_END",
29725
+ "packages/core/publication-rehearsal-projection.js#PUBLICATION_REHEARSAL_AGENT_SECTION_START",
29726
+ "packages/core/publication-rehearsal-projection.js#PUBLICATION_REHEARSAL_WORKFLOW_PATH",
29727
+ "packages/core/publication-rehearsal-projection.js#publicationRehearsalAgentInstructions",
29728
+ "packages/core/publication-rehearsal-projection.js#publicationRehearsalToml",
29729
+ "packages/core/publication-rehearsal-projection.js#publicationRehearsalWorkflow"
29730
+ ],
29731
+ "owner": "buildchain-core",
29732
+ "maturity": "stable",
29733
+ "introducedVersion": "pre-3.0.2-alpha.4",
29734
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
29735
+ "deprecationReplacement": "",
29736
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
29737
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
29738
+ },
29739
+ {
29740
+ "specifier": "@kungfu-tech/buildchain/v4-publication-qualification",
29741
+ "export": "./v4-publication-qualification",
29742
+ "target": "./packages/core/v4-publication-qualification.js",
29743
+ "digest": "sha256:88df23b5a9e12838edab7c3a3c117fec2c145b7ded92f847d522051574214173",
29744
+ "summary": "Sealed v4 candidate, source, artifact, policy, freshness, and command-free promotion admission APIs.",
29745
+ "capabilityGroup": "release-passport-trust",
29746
+ "audience": [
29747
+ "developer",
29748
+ "agent"
29749
+ ],
29750
+ "symbolCount": 7,
29751
+ "symbolIds": [
29752
+ "packages/core/v4-publication-qualification.js#assertNoV4ExecutionFields",
29753
+ "packages/core/v4-publication-qualification.js#assertV4DeclarativePromotionInputs",
29754
+ "packages/core/v4-publication-qualification.js#createV4PublicationQualificationReceipt",
29755
+ "packages/core/v4-publication-qualification.js#V4_PUBLICATION_QUALIFICATION_SCHEMA",
29756
+ "packages/core/v4-publication-qualification.js#V4PublicationQualificationError",
29757
+ "packages/core/v4-publication-qualification.js#v4PublicationQualificationRoot",
29758
+ "packages/core/v4-publication-qualification.js#validateV4PublicationQualificationReceipt"
29759
+ ],
29760
+ "owner": "buildchain-core",
29761
+ "maturity": "stable",
29762
+ "introducedVersion": "pre-3.0.2-alpha.4",
29763
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
29764
+ "deprecationReplacement": "",
29765
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
29766
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
29767
+ },
28541
29768
  {
28542
29769
  "specifier": "@kungfu-tech/buildchain/adopter-delivery-gate",
28543
29770
  "export": "./adopter-delivery-gate",
@@ -28729,18 +29956,19 @@
28729
29956
  "specifier": "@kungfu-tech/buildchain/adopter-delivery-passport",
28730
29957
  "export": "./adopter-delivery-passport",
28731
29958
  "target": "./packages/core/adopter-delivery-passport.js",
28732
- "digest": "sha256:794e6e14442b0673e3909cab1663c919c331db31ff1b2af538a22940c5ed2e41",
29959
+ "digest": "sha256:1b41d346874a335ca68618d5f78456eefd050b267843f13700db17a1af5ee9af",
28733
29960
  "summary": "Non-authoritative adopter delivery Release Passport binding and substitution checks.",
28734
29961
  "capabilityGroup": "release-passport-trust",
28735
29962
  "audience": [
28736
29963
  "developer",
28737
29964
  "agent"
28738
29965
  ],
28739
- "symbolCount": 6,
29966
+ "symbolCount": 7,
28740
29967
  "symbolIds": [
28741
29968
  "packages/core/adopter-delivery-passport.js#ADOPTER_DELIVERY_PASSPORT_BINDING_CONTRACT",
28742
29969
  "packages/core/adopter-delivery-passport.js#createAdopterDeliveryPassportBinding",
28743
29970
  "packages/core/adopter-delivery-passport.js#normalizeAdopterDeliveryPassportBinding",
29971
+ "packages/core/adopter-delivery-passport.js#releasePassportKfdAdopterSourceSha",
28744
29972
  "packages/core/adopter-delivery-passport.js#validateAdopterDeliveryGateResult",
28745
29973
  "packages/core/adopter-delivery-passport.js#validateAdopterDeliveryPassportBinding",
28746
29974
  "packages/core/adopter-delivery-passport.js#validateAdopterDeliveryReleaseEvidence"
@@ -28814,6 +30042,36 @@
28814
30042
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
28815
30043
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
28816
30044
  },
30045
+ {
30046
+ "specifier": "@kungfu-tech/buildchain/v4-cross-platform-adopter-qualification",
30047
+ "export": "./v4-cross-platform-adopter-qualification",
30048
+ "target": "./packages/core/v4-cross-platform-adopter-qualification.js",
30049
+ "digest": "sha256:5632da352725ecd3f06e06bd7772ede824c76fffeb91c123495be2f6818ea8e8",
30050
+ "summary": "Exact-source v3 capability matrix reports, executed failure and recovery evidence, and cross-platform public adopter qualification APIs.",
30051
+ "capabilityGroup": "reusable-build",
30052
+ "audience": [
30053
+ "developer",
30054
+ "agent"
30055
+ ],
30056
+ "symbolCount": 8,
30057
+ "symbolIds": [
30058
+ "packages/core/v4-cross-platform-adopter-qualification.js#createV4CrossPlatformAdopterReport",
30059
+ "packages/core/v4-cross-platform-adopter-qualification.js#qualifyV4CrossPlatformAdopters",
30060
+ "packages/core/v4-cross-platform-adopter-qualification.js#summarizeV3V4CapabilityInventory",
30061
+ "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_ADOPTER_PLATFORMS",
30062
+ "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_ADOPTER_QUALIFICATION_CONTRACT",
30063
+ "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_ADOPTER_REPORT_CONTRACT",
30064
+ "packages/core/v4-cross-platform-adopter-qualification.js#V4_CROSS_PLATFORM_NEUTRAL_DRIVER",
30065
+ "packages/core/v4-cross-platform-adopter-qualification.js#validateV4CrossPlatformAdopterReport"
30066
+ ],
30067
+ "owner": "buildchain-core",
30068
+ "maturity": "stable",
30069
+ "introducedVersion": "pre-3.0.2-alpha.4",
30070
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
30071
+ "deprecationReplacement": "",
30072
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
30073
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
30074
+ },
28817
30075
  {
28818
30076
  "specifier": "@kungfu-tech/buildchain/logging",
28819
30077
  "export": "./logging",
@@ -28981,7 +30239,7 @@
28981
30239
  "specifier": "@kungfu-tech/buildchain/paper",
28982
30240
  "export": "./paper",
28983
30241
  "target": "./packages/core/paper.js",
28984
- "digest": "sha256:de724d5a0774b98c4a12a1d1f7921c82bcb87102fc622b3ff4505de28cc75001",
30242
+ "digest": "sha256:762f10b7e0f99422ecdc73e717f721a22c940989edaa7b1011b3ba551db2b37e",
28985
30243
  "summary": "Unified Paper work, fleet, scaffold, preflight, npm bootstrap, build, Alpha, status, and resume planning APIs.",
28986
30244
  "capabilityGroup": "reusable-build",
28987
30245
  "audience": [
@@ -29097,7 +30355,7 @@
29097
30355
  "specifier": "@kungfu-tech/buildchain/publication-control-plane-audit",
29098
30356
  "export": "./publication-control-plane-audit",
29099
30357
  "target": "./packages/core/publication-control-plane-audit.js",
29100
- "digest": "sha256:a2d207047837abddf9d1f2b728b5a730467917444cbcb2221310f8c45fe0ce5d",
30358
+ "digest": "sha256:42e9a3877827801ed97b8940382f0780826bc148611077e30b314dcfda8a76ee",
29101
30359
  "summary": "Read-only publication control-plane snapshot evaluation APIs.",
29102
30360
  "capabilityGroup": "release-passport-trust",
29103
30361
  "audience": [
@@ -29123,7 +30381,7 @@
29123
30381
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
29124
30382
  "export": "./buildchain-publication-authority",
29125
30383
  "target": "./packages/core/buildchain-publication-authority.js",
29126
- "digest": "sha256:a8fe39184997624ebcbac7f8eaa48cee5182bd56ead0954d4af34853059379e2",
30384
+ "digest": "sha256:9e35546655e3591e04f985c09b06f2ee4ee9c26bbf733cb807e49698f29c492c",
29127
30385
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
29128
30386
  "capabilityGroup": "release-passport-trust",
29129
30387
  "audience": [
@@ -29147,7 +30405,7 @@
29147
30405
  "specifier": "@kungfu-tech/buildchain/github-governance-authority",
29148
30406
  "export": "./github-governance-authority",
29149
30407
  "target": "./packages/core/github-governance-authority.js",
29150
- "digest": "sha256:2aea877b54d6fc147ce08faf8c49448ecc2e6a1fda14689b41cb107496110b97",
30408
+ "digest": "sha256:4eb7b9a3616b16178062cc88d430f0fb3bd11c16c8e926ebc9fd98396859732c",
29151
30409
  "summary": "Fail-closed GitHub ownership, effective-policy, managed-zone admission, rollout-plan, and immutable receipt APIs.",
29152
30410
  "capabilityGroup": "governance-versioning",
29153
30411
  "audience": [
@@ -29320,7 +30578,7 @@
29320
30578
  "specifier": "@kungfu-tech/buildchain/release-candidate-recovery",
29321
30579
  "export": "./release-candidate-recovery",
29322
30580
  "target": "./packages/core/release-candidate-recovery.js",
29323
- "digest": "sha256:c180e84ab83bc79ef5f4f558cfd6585f34c1505f4b4051ff161528fb7dec9177",
30581
+ "digest": "sha256:c8e5ddfbbed9bca96d6dde3ad945da438eaed977d4bc93c3ff13780f85f6f35a",
29324
30582
  "summary": "Fail-closed verification and immutable receipts for reusing a successful sealed candidate run without rebuilding product payloads.",
29325
30583
  "capabilityGroup": "release-passport-trust",
29326
30584
  "audience": [
@@ -29521,14 +30779,14 @@
29521
30779
  "specifier": "@kungfu-tech/buildchain/release-passport",
29522
30780
  "export": "./release-passport",
29523
30781
  "target": "./packages/core/release-passport.js",
29524
- "digest": "sha256:7b433d34f87651d8fb187d06b83113e93cbc0243a0f93ce33f375a4737f144f6",
30782
+ "digest": "sha256:4932b0ef2ea1c62101347789ef233c77142630a69762d325688269fe29c230c5",
29525
30783
  "summary": "Release passport collection, verification, explanation, and evidence APIs.",
29526
30784
  "capabilityGroup": "release-passport-trust",
29527
30785
  "audience": [
29528
30786
  "developer",
29529
30787
  "agent"
29530
30788
  ],
29531
- "symbolCount": 23,
30789
+ "symbolCount": 24,
29532
30790
  "symbolIds": [
29533
30791
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
29534
30792
  "packages/core/release-passport.js#ARTIFACT_EVIDENCE_CONTRACT",
@@ -29549,6 +30807,7 @@
29549
30807
  "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
29550
30808
  "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
29551
30809
  "packages/core/release-passport.js#RELEASE_PASSPORT_CONTRACT",
30810
+ "packages/core/adopter-delivery-passport.js#releasePassportKfdAdopterSourceSha",
29552
30811
  "packages/core/release-passport.js#sha256File",
29553
30812
  "packages/core/release-passport.js#sha256Text",
29554
30813
  "packages/core/release-passport.js#validateKnownReleasePassportContracts",
@@ -29860,7 +31119,7 @@
29860
31119
  {
29861
31120
  "id": "node-api-reference",
29862
31121
  "path": "docs/node-api-reference.md",
29863
- "digest": "sha256:da744d2071ab7871eccbf6b3049a4d8a44b21daa477598fa9327a28b7d89ae67"
31122
+ "digest": "sha256:e9683e04409d60ee1a4e60f89766c158586cf1eb91fc890f0b2660814f05dbdb"
29864
31123
  },
29865
31124
  {
29866
31125
  "id": "build-facts",