@kungfu-tech/buildchain 3.0.7-alpha.0 → 3.0.7

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 (67) hide show
  1. package/actions/promote-buildchain-ref/README.md +10 -0
  2. package/contracts/auditable-demo-scenario-v1.schema.json +1 -1
  3. package/contracts/engineering-housekeeper-v1.schema.json +143 -0
  4. package/contracts/fixtures/engineering-housekeeper-v1/cases.json +68 -0
  5. package/dist/site/buildchain-contract.json +24 -24
  6. package/dist/site/buildchain-site.json +91 -30
  7. package/dist/site/capability-registry.json +3 -3
  8. package/dist/site/controller-registry.json +6 -2
  9. package/dist/site/kfd-claims.json +122 -11
  10. package/dist/site/kfd-upstream-aggregate.json +1 -1
  11. package/dist/site/manual-registry.json +8 -7
  12. package/dist/site/node-api-registry.json +683 -105
  13. package/dist/site/page-registry.json +80 -19
  14. package/dist/site/public-surface-audit.json +98 -7
  15. package/dist/site/publication-authority-registry.json +81 -1
  16. package/dist/site/publication-registry.json +4 -4
  17. package/dist/site/release-provenance.json +2 -0
  18. package/dist/site/site-manifest.json +11 -11
  19. package/dist/site/workflow-registry.json +119 -2
  20. package/docs/MAP.md +1 -0
  21. package/docs/auditable-demo.md +2 -2
  22. package/docs/dev-delivery-warrant.md +49 -4
  23. package/docs/engineering-housekeeper.md +138 -0
  24. package/docs/lifecycle-protocol.md +4 -2
  25. package/docs/node-api-reference.md +277 -212
  26. package/docs/release-governance.md +17 -2
  27. package/docs/release-tail-provider-plane.md +1 -1
  28. package/docs/reusable-build-surface.md +11 -0
  29. package/package.json +4 -1
  30. package/packages/core/artifact-signing.js +61 -0
  31. package/packages/core/buildchain-config.js +66 -6
  32. package/packages/core/buildchain-publication-authority.js +4 -0
  33. package/packages/core/controller-evidence.js +2 -1
  34. package/packages/core/dev-delivery-warrant-cancellation.js +1 -0
  35. package/packages/core/dev-delivery-warrant-shadow.js +502 -0
  36. package/packages/core/dev-delivery-warrant.js +15 -6
  37. package/packages/core/diagnostics.js +8 -3
  38. package/packages/core/engineering-housekeeper-github-client.js +222 -0
  39. package/packages/core/engineering-housekeeper-github.js +501 -0
  40. package/packages/core/engineering-housekeeper.js +259 -0
  41. package/packages/core/index.js +3 -0
  42. package/packages/core/kfd-gate.js +45 -15
  43. package/packages/core/publication-rehearsal-runtime.js +13 -1
  44. package/packages/core/release-passport.js +130 -20
  45. package/scripts/assemble-self-publication-admission.mjs +1 -1
  46. package/scripts/audit-publication-control-plane.mjs +1 -1
  47. package/scripts/auditable-demo-bundle-verification.mjs +2 -3
  48. package/scripts/auditable-demo-platform.mjs +2 -2
  49. package/scripts/auditable-demo-renditions.mjs +1 -1
  50. package/scripts/auditable-demo.mjs +2 -2
  51. package/scripts/build-contract-core.mjs +8 -3
  52. package/scripts/build-standalone-binary.mjs +14 -3
  53. package/scripts/check-inventory.mjs +3 -1
  54. package/scripts/dev-delivery-warrant.mjs +31 -4
  55. package/scripts/dev-pr-auto-merge.mjs +30 -4
  56. package/scripts/dev-pr-delivery-warrant.mjs +50 -0
  57. package/scripts/engineering-housekeeper-workflow.mjs +394 -0
  58. package/scripts/generate-site-bundle.mjs +23 -4
  59. package/scripts/inspect-artifact-signing-requests.mjs +6 -0
  60. package/scripts/materialize-self-release-candidate-version.mjs +6 -0
  61. package/scripts/publication-commit-evidence.mjs +69 -23
  62. package/scripts/release-candidate-resolver.mjs +16 -10
  63. package/scripts/resume-from-candidate-run.mjs +123 -9
  64. package/scripts/seal-artifact-signing-requests.mjs +6 -0
  65. package/scripts/site-capability-metadata.mjs +2 -0
  66. package/scripts/web-surface-core.mjs +8 -2
  67. package/scripts/workflow-call-contract.mjs +1 -1
@@ -567,7 +567,7 @@
567
567
  ],
568
568
  "source": {
569
569
  "path": "packages/core/artifact-signing.js",
570
- "line": 60
570
+ "line": 61
571
571
  },
572
572
  "example": "import { artifactSigningDigest } from \"@kungfu-tech/buildchain\";",
573
573
  "maturity": "stable",
@@ -596,7 +596,7 @@
596
596
  ],
597
597
  "source": {
598
598
  "path": "packages/core/artifact-signing.js",
599
- "line": 313
599
+ "line": 374
600
600
  },
601
601
  "example": "import { createArtifactSigningReceipt } from \"@kungfu-tech/buildchain\";",
602
602
  "maturity": "stable",
@@ -625,7 +625,7 @@
625
625
  ],
626
626
  "source": {
627
627
  "path": "packages/core/artifact-signing.js",
628
- "line": 167
628
+ "line": 226
629
629
  },
630
630
  "example": "import { createArtifactSigningRequest } from \"@kungfu-tech/buildchain\";",
631
631
  "maturity": "stable",
@@ -649,7 +649,7 @@
649
649
  ],
650
650
  "source": {
651
651
  "path": "packages/core/artifact-signing.js",
652
- "line": 103
652
+ "line": 162
653
653
  },
654
654
  "example": "import { listArtifactSigningProfiles } from \"@kungfu-tech/buildchain\";",
655
655
  "maturity": "stable",
@@ -678,7 +678,7 @@
678
678
  ],
679
679
  "source": {
680
680
  "path": "packages/core/artifact-signing.js",
681
- "line": 111
681
+ "line": 170
682
682
  },
683
683
  "example": "import { resolveArtifactSigningProfile } from \"@kungfu-tech/buildchain\";",
684
684
  "maturity": "stable",
@@ -711,7 +711,7 @@
711
711
  ],
712
712
  "source": {
713
713
  "path": "packages/core/artifact-signing.js",
714
- "line": 374
714
+ "line": 435
715
715
  },
716
716
  "example": "import { validateArtifactSigningReceipt } from \"@kungfu-tech/buildchain\";",
717
717
  "maturity": "stable",
@@ -740,7 +740,7 @@
740
740
  ],
741
741
  "source": {
742
742
  "path": "packages/core/artifact-signing.js",
743
- "line": 291
743
+ "line": 352
744
744
  },
745
745
  "example": "import { validateArtifactSigningRequest } from \"@kungfu-tech/buildchain\";",
746
746
  "maturity": "stable",
@@ -1391,7 +1391,7 @@
1391
1391
  ],
1392
1392
  "source": {
1393
1393
  "path": "packages/core/buildchain-config.js",
1394
- "line": 1467
1394
+ "line": 1527
1395
1395
  },
1396
1396
  "example": "import { discoverConfiguredDerivedVersionMaterial } from \"@kungfu-tech/buildchain\";",
1397
1397
  "maturity": "stable",
@@ -1424,7 +1424,7 @@
1424
1424
  ],
1425
1425
  "source": {
1426
1426
  "path": "packages/core/buildchain-config.js",
1427
- "line": 1428
1427
+ "line": 1488
1428
1428
  },
1429
1429
  "example": "import { discoverConfiguredVersionStateFiles } from \"@kungfu-tech/buildchain\";",
1430
1430
  "maturity": "stable",
@@ -1457,7 +1457,7 @@
1457
1457
  ],
1458
1458
  "source": {
1459
1459
  "path": "packages/core/buildchain-config.js",
1460
- "line": 1372
1460
+ "line": 1432
1461
1461
  },
1462
1462
  "example": "import { getLifecycleStage } from \"@kungfu-tech/buildchain\";",
1463
1463
  "maturity": "stable",
@@ -1486,7 +1486,7 @@
1486
1486
  ],
1487
1487
  "source": {
1488
1488
  "path": "packages/core/buildchain-config.js",
1489
- "line": 520
1489
+ "line": 585
1490
1490
  },
1491
1491
  "example": "import { getNativeDiagnosticsProfile } from \"@kungfu-tech/buildchain\";",
1492
1492
  "maturity": "stable",
@@ -1515,7 +1515,7 @@
1515
1515
  ],
1516
1516
  "source": {
1517
1517
  "path": "packages/core/buildchain-config.js",
1518
- "line": 1376
1518
+ "line": 1436
1519
1519
  },
1520
1520
  "example": "import { getPublishContract } from \"@kungfu-tech/buildchain\";",
1521
1521
  "maturity": "stable",
@@ -1544,7 +1544,7 @@
1544
1544
  ],
1545
1545
  "source": {
1546
1546
  "path": "packages/core/buildchain-config.js",
1547
- "line": 328
1547
+ "line": 353
1548
1548
  },
1549
1549
  "example": "import { getStableReleasePolicy } from \"@kungfu-tech/buildchain\";",
1550
1550
  "maturity": "stable",
@@ -1573,7 +1573,7 @@
1573
1573
  ],
1574
1574
  "source": {
1575
1575
  "path": "packages/core/buildchain-config.js",
1576
- "line": 1500
1576
+ "line": 1560
1577
1577
  },
1578
1578
  "example": "import { getVersionStrategy } from \"@kungfu-tech/buildchain\";",
1579
1579
  "maturity": "stable",
@@ -1602,7 +1602,7 @@
1602
1602
  ],
1603
1603
  "source": {
1604
1604
  "path": "packages/core/buildchain-config.js",
1605
- "line": 158
1605
+ "line": 183
1606
1606
  },
1607
1607
  "example": "import { loadBuildchainConfig } from \"@kungfu-tech/buildchain\";",
1608
1608
  "maturity": "stable",
@@ -1635,7 +1635,7 @@
1635
1635
  ],
1636
1636
  "source": {
1637
1637
  "path": "packages/core/buildchain-config.js",
1638
- "line": 1509
1638
+ "line": 1569
1639
1639
  },
1640
1640
  "example": "import { loadConfiguredAnchorManifest } from \"@kungfu-tech/buildchain\";",
1641
1641
  "maturity": "stable",
@@ -1664,7 +1664,7 @@
1664
1664
  ],
1665
1665
  "source": {
1666
1666
  "path": "packages/core/buildchain-config.js",
1667
- "line": 181
1667
+ "line": 206
1668
1668
  },
1669
1669
  "example": "import { normalizeBuildchainConfig } from \"@kungfu-tech/buildchain\";",
1670
1670
  "maturity": "stable",
@@ -1701,7 +1701,7 @@
1701
1701
  ],
1702
1702
  "source": {
1703
1703
  "path": "packages/core/buildchain-config.js",
1704
- "line": 1333
1704
+ "line": 1393
1705
1705
  },
1706
1706
  "example": "import { normalizeLifecycleStage } from \"@kungfu-tech/buildchain\";",
1707
1707
  "maturity": "stable",
@@ -1730,7 +1730,7 @@
1730
1730
  ],
1731
1731
  "source": {
1732
1732
  "path": "packages/core/buildchain-config.js",
1733
- "line": 1380
1733
+ "line": 1440
1734
1734
  },
1735
1735
  "example": "import { runLifecycleStage } from \"@kungfu-tech/buildchain\";",
1736
1736
  "maturity": "stable",
@@ -1763,7 +1763,7 @@
1763
1763
  ],
1764
1764
  "source": {
1765
1765
  "path": "packages/core/buildchain-config.js",
1766
- "line": 1680
1766
+ "line": 1740
1767
1767
  },
1768
1768
  "example": "import { updateConfiguredVersionStateContents } from \"@kungfu-tech/buildchain\";",
1769
1769
  "maturity": "stable",
@@ -1796,7 +1796,7 @@
1796
1796
  ],
1797
1797
  "source": {
1798
1798
  "path": "packages/core/buildchain-config.js",
1799
- "line": 1547
1799
+ "line": 1607
1800
1800
  },
1801
1801
  "example": "import { validateBuildchainConfig } from \"@kungfu-tech/buildchain\";",
1802
1802
  "maturity": "stable",
@@ -3493,7 +3493,7 @@
3493
3493
  ],
3494
3494
  "source": {
3495
3495
  "path": "packages/core/buildchain-publication-authority.js",
3496
- "line": 58
3496
+ "line": 62
3497
3497
  },
3498
3498
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
3499
3499
  "maturity": "stable",
@@ -3522,7 +3522,7 @@
3522
3522
  ],
3523
3523
  "source": {
3524
3524
  "path": "packages/core/buildchain-publication-authority.js",
3525
- "line": 82
3525
+ "line": 86
3526
3526
  },
3527
3527
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
3528
3528
  "maturity": "stable",
@@ -3965,7 +3965,7 @@
3965
3965
  ],
3966
3966
  "source": {
3967
3967
  "path": "packages/core/controller-evidence.js",
3968
- "line": 448
3968
+ "line": 449
3969
3969
  },
3970
3970
  "example": "import { aggregateControllerReceipts } from \"@kungfu-tech/buildchain\";",
3971
3971
  "maturity": "stable",
@@ -4090,7 +4090,7 @@
4090
4090
  ],
4091
4091
  "source": {
4092
4092
  "path": "packages/core/controller-evidence.js",
4093
- "line": 150
4093
+ "line": 151
4094
4094
  },
4095
4095
  "example": "import { controllerEvidenceDigest } from \"@kungfu-tech/buildchain\";",
4096
4096
  "maturity": "stable",
@@ -4119,7 +4119,7 @@
4119
4119
  ],
4120
4120
  "source": {
4121
4121
  "path": "packages/core/controller-evidence.js",
4122
- "line": 286
4122
+ "line": 287
4123
4123
  },
4124
4124
  "example": "import { createControllerPlan } from \"@kungfu-tech/buildchain\";",
4125
4125
  "maturity": "stable",
@@ -4148,7 +4148,7 @@
4148
4148
  ],
4149
4149
  "source": {
4150
4150
  "path": "packages/core/controller-evidence.js",
4151
- "line": 362
4151
+ "line": 363
4152
4152
  },
4153
4153
  "example": "import { createControllerReceipt } from \"@kungfu-tech/buildchain\";",
4154
4154
  "maturity": "stable",
@@ -4177,7 +4177,7 @@
4177
4177
  ],
4178
4178
  "source": {
4179
4179
  "path": "packages/core/controller-evidence.js",
4180
- "line": 490
4180
+ "line": 491
4181
4181
  },
4182
4182
  "example": "import { createControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
4183
4183
  "maturity": "stable",
@@ -4206,7 +4206,7 @@
4206
4206
  ],
4207
4207
  "source": {
4208
4208
  "path": "packages/core/controller-evidence.js",
4209
- "line": 196
4209
+ "line": 197
4210
4210
  },
4211
4211
  "example": "import { createControllerRegistry } from \"@kungfu-tech/buildchain\";",
4212
4212
  "maturity": "stable",
@@ -4235,7 +4235,7 @@
4235
4235
  ],
4236
4236
  "source": {
4237
4237
  "path": "packages/core/controller-evidence.js",
4238
- "line": 531
4238
+ "line": 532
4239
4239
  },
4240
4240
  "example": "import { normalizeControllerReceiptReferences } from \"@kungfu-tech/buildchain\";",
4241
4241
  "maturity": "stable",
@@ -4264,7 +4264,7 @@
4264
4264
  ],
4265
4265
  "source": {
4266
4266
  "path": "packages/core/controller-evidence.js",
4267
- "line": 324
4267
+ "line": 325
4268
4268
  },
4269
4269
  "example": "import { validateControllerPlan } from \"@kungfu-tech/buildchain\";",
4270
4270
  "maturity": "stable",
@@ -4297,7 +4297,7 @@
4297
4297
  ],
4298
4298
  "source": {
4299
4299
  "path": "packages/core/controller-evidence.js",
4300
- "line": 422
4300
+ "line": 423
4301
4301
  },
4302
4302
  "example": "import { validateControllerReceipt } from \"@kungfu-tech/buildchain\";",
4303
4303
  "maturity": "stable",
@@ -4330,7 +4330,7 @@
4330
4330
  ],
4331
4331
  "source": {
4332
4332
  "path": "packages/core/controller-evidence.js",
4333
- "line": 504
4333
+ "line": 505
4334
4334
  },
4335
4335
  "example": "import { validateControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
4336
4336
  "maturity": "stable",
@@ -4794,7 +4794,7 @@
4794
4794
  ],
4795
4795
  "source": {
4796
4796
  "path": "packages/core/dev-delivery-warrant.js",
4797
- "line": 559
4797
+ "line": 568
4798
4798
  },
4799
4799
  "example": "import { cancelQueuedDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4800
4800
  "maturity": "stable",
@@ -4831,7 +4831,7 @@
4831
4831
  ],
4832
4832
  "source": {
4833
4833
  "path": "packages/core/dev-delivery-warrant.js",
4834
- "line": 511
4834
+ "line": 520
4835
4835
  },
4836
4836
  "example": "import { closeDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4837
4837
  "maturity": "stable",
@@ -4860,7 +4860,7 @@
4860
4860
  ],
4861
4861
  "source": {
4862
4862
  "path": "packages/core/dev-delivery-warrant.js",
4863
- "line": 95
4863
+ "line": 96
4864
4864
  },
4865
4865
  "example": "import { createDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
4866
4866
  "maturity": "stable",
@@ -5113,7 +5113,7 @@
5113
5113
  ],
5114
5114
  "source": {
5115
5115
  "path": "packages/core/dev-delivery-warrant.js",
5116
- "line": 428
5116
+ "line": 437
5117
5117
  },
5118
5118
  "example": "import { heartbeatDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5119
5119
  "maturity": "stable",
@@ -5146,7 +5146,7 @@
5146
5146
  ],
5147
5147
  "source": {
5148
5148
  "path": "packages/core/dev-delivery-warrant.js",
5149
- "line": 110
5149
+ "line": 111
5150
5150
  },
5151
5151
  "example": "import { normalizeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5152
5152
  "maturity": "stable",
@@ -5179,7 +5179,7 @@
5179
5179
  ],
5180
5180
  "source": {
5181
5181
  "path": "packages/core/dev-delivery-warrant.js",
5182
- "line": 562
5182
+ "line": 571
5183
5183
  },
5184
5184
  "example": "import { observeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5185
5185
  "maturity": "stable",
@@ -5212,7 +5212,7 @@
5212
5212
  ],
5213
5213
  "source": {
5214
5214
  "path": "packages/core/dev-delivery-warrant.js",
5215
- "line": 269
5215
+ "line": 276
5216
5216
  },
5217
5217
  "example": "import { rankDevDeliveryCandidates } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5218
5218
  "maturity": "stable",
@@ -5245,7 +5245,7 @@
5245
5245
  ],
5246
5246
  "source": {
5247
5247
  "path": "packages/core/dev-delivery-warrant.js",
5248
- "line": 461
5248
+ "line": 470
5249
5249
  },
5250
5250
  "example": "import { recoverExpiredDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5251
5251
  "maturity": "stable",
@@ -5278,7 +5278,7 @@
5278
5278
  ],
5279
5279
  "source": {
5280
5280
  "path": "packages/core/dev-delivery-warrant.js",
5281
- "line": 293
5281
+ "line": 300
5282
5282
  },
5283
5283
  "example": "import { selectDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5284
5284
  "maturity": "stable",
@@ -5302,7 +5302,7 @@
5302
5302
  ],
5303
5303
  "source": {
5304
5304
  "path": "packages/core/dev-delivery-warrant.js",
5305
- "line": 560
5305
+ "line": 569
5306
5306
  },
5307
5307
  "example": "import { settleDevDeliveryTerminalEvent } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5308
5308
  "maturity": "stable",
@@ -5339,7 +5339,7 @@
5339
5339
  ],
5340
5340
  "source": {
5341
5341
  "path": "packages/core/dev-delivery-warrant.js",
5342
- "line": 193
5342
+ "line": 195
5343
5343
  },
5344
5344
  "example": "import { submitDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
5345
5345
  "maturity": "stable",
@@ -5560,7 +5560,7 @@
5560
5560
  ],
5561
5561
  "source": {
5562
5562
  "path": "packages/core/diagnostics.js",
5563
- "line": 1085
5563
+ "line": 1090
5564
5564
  },
5565
5565
  "example": "import { classifyProcessCommand } from \"@kungfu-tech/buildchain\";",
5566
5566
  "maturity": "stable",
@@ -5589,7 +5589,7 @@
5589
5589
  ],
5590
5590
  "source": {
5591
5591
  "path": "packages/core/diagnostics.js",
5592
- "line": 248
5592
+ "line": 252
5593
5593
  },
5594
5594
  "example": "import { collectBuildchainDiagnostics } from \"@kungfu-tech/buildchain\";",
5595
5595
  "maturity": "stable",
@@ -5618,7 +5618,7 @@
5618
5618
  ],
5619
5619
  "source": {
5620
5620
  "path": "packages/core/diagnostics.js",
5621
- "line": 922
5621
+ "line": 927
5622
5622
  },
5623
5623
  "example": "import { collectCacheDiagnostics } from \"@kungfu-tech/buildchain\";",
5624
5624
  "maturity": "stable",
@@ -5647,7 +5647,7 @@
5647
5647
  ],
5648
5648
  "source": {
5649
5649
  "path": "packages/core/diagnostics.js",
5650
- "line": 573
5650
+ "line": 578
5651
5651
  },
5652
5652
  "example": "import { collectCompilerCacheDiagnostics } from \"@kungfu-tech/buildchain\";",
5653
5653
  "maturity": "stable",
@@ -5676,7 +5676,7 @@
5676
5676
  ],
5677
5677
  "source": {
5678
5678
  "path": "packages/core/diagnostics.js",
5679
- "line": 944
5679
+ "line": 949
5680
5680
  },
5681
5681
  "example": "import { collectGitDiagnostics } from \"@kungfu-tech/buildchain\";",
5682
5682
  "maturity": "stable",
@@ -5705,7 +5705,7 @@
5705
5705
  ],
5706
5706
  "source": {
5707
5707
  "path": "packages/core/diagnostics.js",
5708
- "line": 295
5708
+ "line": 299
5709
5709
  },
5710
5710
  "example": "import { collectNativeDiagnostics } from \"@kungfu-tech/buildchain\";",
5711
5711
  "maturity": "stable",
@@ -5734,7 +5734,7 @@
5734
5734
  ],
5735
5735
  "source": {
5736
5736
  "path": "packages/core/diagnostics.js",
5737
- "line": 1029
5737
+ "line": 1034
5738
5738
  },
5739
5739
  "example": "import { collectProcessTreeSnapshot } from \"@kungfu-tech/buildchain\";",
5740
5740
  "maturity": "stable",
@@ -5758,7 +5758,7 @@
5758
5758
  ],
5759
5759
  "source": {
5760
5760
  "path": "packages/core/diagnostics.js",
5761
- "line": 468
5761
+ "line": 472
5762
5762
  },
5763
5763
  "example": "import { collectRunnerDiagnostics } from \"@kungfu-tech/buildchain\";",
5764
5764
  "maturity": "stable",
@@ -5787,7 +5787,7 @@
5787
5787
  ],
5788
5788
  "source": {
5789
5789
  "path": "packages/core/diagnostics.js",
5790
- "line": 495
5790
+ "line": 499
5791
5791
  },
5792
5792
  "example": "import { collectToolDiagnostics } from \"@kungfu-tech/buildchain\";",
5793
5793
  "maturity": "stable",
@@ -5816,7 +5816,7 @@
5816
5816
  ],
5817
5817
  "source": {
5818
5818
  "path": "packages/core/diagnostics.js",
5819
- "line": 1408
5819
+ "line": 1413
5820
5820
  },
5821
5821
  "example": "import { createDiagnosticsArtifact } from \"@kungfu-tech/buildchain\";",
5822
5822
  "maturity": "stable",
@@ -5845,7 +5845,7 @@
5845
5845
  ],
5846
5846
  "source": {
5847
5847
  "path": "packages/core/diagnostics.js",
5848
- "line": 722
5848
+ "line": 727
5849
5849
  },
5850
5850
  "example": "import { createStructuredCacheEvidence } from \"@kungfu-tech/buildchain/diagnostics\";",
5851
5851
  "maturity": "stable",
@@ -5874,7 +5874,7 @@
5874
5874
  ],
5875
5875
  "source": {
5876
5876
  "path": "packages/core/diagnostics.js",
5877
- "line": 1188
5877
+ "line": 1193
5878
5878
  },
5879
5879
  "example": "import { detectRequestedParallelism } from \"@kungfu-tech/buildchain\";",
5880
5880
  "maturity": "stable",
@@ -5903,7 +5903,7 @@
5903
5903
  ],
5904
5904
  "source": {
5905
5905
  "path": "packages/core/diagnostics.js",
5906
- "line": 1223
5906
+ "line": 1228
5907
5907
  },
5908
5908
  "example": "import { detectRequestedParallelismFromProcessSamples } from \"@kungfu-tech/buildchain\";",
5909
5909
  "maturity": "stable",
@@ -5932,7 +5932,7 @@
5932
5932
  ],
5933
5933
  "source": {
5934
5934
  "path": "packages/core/diagnostics.js",
5935
- "line": 1786
5935
+ "line": 1791
5936
5936
  },
5937
5937
  "example": "import { formatDiagnosticsSummaryTable } from \"@kungfu-tech/buildchain\";",
5938
5938
  "maturity": "stable",
@@ -5961,7 +5961,7 @@
5961
5961
  ],
5962
5962
  "source": {
5963
5963
  "path": "packages/core/diagnostics.js",
5964
- "line": 1468
5964
+ "line": 1473
5965
5965
  },
5966
5966
  "example": "import { readDiagnosticsArtifact } from \"@kungfu-tech/buildchain\";",
5967
5967
  "maturity": "stable",
@@ -5998,7 +5998,7 @@
5998
5998
  ],
5999
5999
  "source": {
6000
6000
  "path": "packages/core/diagnostics.js",
6001
- "line": 953
6001
+ "line": 958
6002
6002
  },
6003
6003
  "example": "import { redactDiagnosticsValue } from \"@kungfu-tech/buildchain\";",
6004
6004
  "maturity": "stable",
@@ -6027,7 +6027,7 @@
6027
6027
  ],
6028
6028
  "source": {
6029
6029
  "path": "packages/core/diagnostics.js",
6030
- "line": 1362
6030
+ "line": 1367
6031
6031
  },
6032
6032
  "example": "import { startProcessSampler } from \"@kungfu-tech/buildchain\";",
6033
6033
  "maturity": "stable",
@@ -6056,7 +6056,7 @@
6056
6056
  ],
6057
6057
  "source": {
6058
6058
  "path": "packages/core/diagnostics.js",
6059
- "line": 1824
6059
+ "line": 1829
6060
6060
  },
6061
6061
  "example": "import { summarizeDiagnosticsArtifacts } from \"@kungfu-tech/buildchain\";",
6062
6062
  "maturity": "stable",
@@ -6085,7 +6085,7 @@
6085
6085
  ],
6086
6086
  "source": {
6087
6087
  "path": "packages/core/diagnostics.js",
6088
- "line": 219
6088
+ "line": 223
6089
6089
  },
6090
6090
  "example": "import { summarizeLifecycleObservability } from \"@kungfu-tech/buildchain\";",
6091
6091
  "maturity": "stable",
@@ -6114,7 +6114,7 @@
6114
6114
  ],
6115
6115
  "source": {
6116
6116
  "path": "packages/core/diagnostics.js",
6117
- "line": 1254
6117
+ "line": 1259
6118
6118
  },
6119
6119
  "example": "import { summarizeProcessSamples } from \"@kungfu-tech/buildchain\";",
6120
6120
  "maturity": "stable",
@@ -6143,7 +6143,7 @@
6143
6143
  ],
6144
6144
  "source": {
6145
6145
  "path": "packages/core/diagnostics.js",
6146
- "line": 325
6146
+ "line": 329
6147
6147
  },
6148
6148
  "example": "import { validateAnchoredPackageRelease } from \"@kungfu-tech/buildchain\";",
6149
6149
  "maturity": "stable",
@@ -6176,7 +6176,7 @@
6176
6176
  ],
6177
6177
  "source": {
6178
6178
  "path": "packages/core/diagnostics.js",
6179
- "line": 1459
6179
+ "line": 1464
6180
6180
  },
6181
6181
  "example": "import { writeDiagnosticsArtifact } from \"@kungfu-tech/buildchain\";",
6182
6182
  "maturity": "stable",
@@ -6185,6 +6185,489 @@
6185
6185
  "agent"
6186
6186
  ]
6187
6187
  },
6188
+ {
6189
+ "id": "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperClient",
6190
+ "name": "GitHubHousekeeperClient",
6191
+ "kind": "class",
6192
+ "signature": "class GitHubHousekeeperClient",
6193
+ "parameters": [],
6194
+ "returns": "GitHubHousekeeperClient",
6195
+ "errors": [
6196
+ "Construction and method errors follow the linked source implementation."
6197
+ ],
6198
+ "sideEffects": [
6199
+ "class-dependent"
6200
+ ],
6201
+ "source": {
6202
+ "path": "packages/core/engineering-housekeeper-github-client.js",
6203
+ "line": 53
6204
+ },
6205
+ "example": "import { GitHubHousekeeperClient } from \"@kungfu-tech/buildchain\";",
6206
+ "maturity": "stable",
6207
+ "audience": [
6208
+ "developer",
6209
+ "agent"
6210
+ ]
6211
+ },
6212
+ {
6213
+ "id": "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperProviderError",
6214
+ "name": "GitHubHousekeeperProviderError",
6215
+ "kind": "class",
6216
+ "signature": "class GitHubHousekeeperProviderError",
6217
+ "parameters": [],
6218
+ "returns": "GitHubHousekeeperProviderError",
6219
+ "errors": [
6220
+ "Construction and method errors follow the linked source implementation."
6221
+ ],
6222
+ "sideEffects": [
6223
+ "class-dependent"
6224
+ ],
6225
+ "source": {
6226
+ "path": "packages/core/engineering-housekeeper-github-client.js",
6227
+ "line": 36
6228
+ },
6229
+ "example": "import { GitHubHousekeeperProviderError } from \"@kungfu-tech/buildchain\";",
6230
+ "maturity": "stable",
6231
+ "audience": [
6232
+ "developer",
6233
+ "agent"
6234
+ ]
6235
+ },
6236
+ {
6237
+ "id": "packages/core/engineering-housekeeper-github.js#applyGitHubHousekeeperPlan",
6238
+ "name": "applyGitHubHousekeeperPlan",
6239
+ "kind": "function",
6240
+ "signature": "async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, })",
6241
+ "parameters": [
6242
+ {
6243
+ "name": "parameter1",
6244
+ "signature": "{ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }"
6245
+ }
6246
+ ],
6247
+ "returns": "Promise<unknown>",
6248
+ "errors": [
6249
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6250
+ ],
6251
+ "sideEffects": [
6252
+ "may-write-or-invoke-external-actions"
6253
+ ],
6254
+ "source": {
6255
+ "path": "packages/core/engineering-housekeeper-github.js",
6256
+ "line": 409
6257
+ },
6258
+ "example": "import { applyGitHubHousekeeperPlan } from \"@kungfu-tech/buildchain\";",
6259
+ "maturity": "stable",
6260
+ "audience": [
6261
+ "developer",
6262
+ "agent"
6263
+ ]
6264
+ },
6265
+ {
6266
+ "id": "packages/core/engineering-housekeeper-github.js#collectGitHubHousekeeperInventory",
6267
+ "name": "collectGitHubHousekeeperInventory",
6268
+ "kind": "function",
6269
+ "signature": "async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, })",
6270
+ "parameters": [
6271
+ {
6272
+ "name": "parameter1",
6273
+ "signature": "{ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }"
6274
+ }
6275
+ ],
6276
+ "returns": "Promise<unknown>",
6277
+ "errors": [
6278
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
6279
+ ],
6280
+ "sideEffects": [
6281
+ "none-detected-by-static-source-scan"
6282
+ ],
6283
+ "source": {
6284
+ "path": "packages/core/engineering-housekeeper-github.js",
6285
+ "line": 110
6286
+ },
6287
+ "example": "import { collectGitHubHousekeeperInventory } from \"@kungfu-tech/buildchain\";",
6288
+ "maturity": "stable",
6289
+ "audience": [
6290
+ "developer",
6291
+ "agent"
6292
+ ]
6293
+ },
6294
+ {
6295
+ "id": "packages/core/engineering-housekeeper-github.js#formatGitHubHousekeeperPlan",
6296
+ "name": "formatGitHubHousekeeperPlan",
6297
+ "kind": "function",
6298
+ "signature": "function formatGitHubHousekeeperPlan(plan)",
6299
+ "parameters": [
6300
+ {
6301
+ "name": "plan",
6302
+ "signature": "plan"
6303
+ }
6304
+ ],
6305
+ "returns": "unknown",
6306
+ "errors": [
6307
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6308
+ ],
6309
+ "sideEffects": [
6310
+ "none-detected-by-static-source-scan"
6311
+ ],
6312
+ "source": {
6313
+ "path": "packages/core/engineering-housekeeper-github.js",
6314
+ "line": 491
6315
+ },
6316
+ "example": "import { formatGitHubHousekeeperPlan } from \"@kungfu-tech/buildchain\";",
6317
+ "maturity": "stable",
6318
+ "audience": [
6319
+ "developer",
6320
+ "agent"
6321
+ ]
6322
+ },
6323
+ {
6324
+ "id": "packages/core/engineering-housekeeper-github.js#runGitHubHousekeeper",
6325
+ "name": "runGitHubHousekeeper",
6326
+ "kind": "function",
6327
+ "signature": "async function runGitHubHousekeeper(options)",
6328
+ "parameters": [
6329
+ {
6330
+ "name": "options",
6331
+ "signature": "options"
6332
+ }
6333
+ ],
6334
+ "returns": "Promise<unknown>",
6335
+ "errors": [
6336
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6337
+ ],
6338
+ "sideEffects": [
6339
+ "may-write-or-invoke-external-actions"
6340
+ ],
6341
+ "source": {
6342
+ "path": "packages/core/engineering-housekeeper-github.js",
6343
+ "line": 485
6344
+ },
6345
+ "example": "import { runGitHubHousekeeper } from \"@kungfu-tech/buildchain\";",
6346
+ "maturity": "stable",
6347
+ "audience": [
6348
+ "developer",
6349
+ "agent"
6350
+ ]
6351
+ },
6352
+ {
6353
+ "id": "packages/core/engineering-housekeeper.js#classifyHousekeeperBranch",
6354
+ "name": "classifyHousekeeperBranch",
6355
+ "kind": "function",
6356
+ "signature": "function classifyHousekeeperBranch(branch, policyInput = {})",
6357
+ "parameters": [
6358
+ {
6359
+ "name": "branch",
6360
+ "signature": "branch"
6361
+ },
6362
+ {
6363
+ "name": "policyInput",
6364
+ "signature": "policyInput = {}"
6365
+ }
6366
+ ],
6367
+ "returns": "unknown",
6368
+ "errors": [
6369
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6370
+ ],
6371
+ "sideEffects": [
6372
+ "none-detected-by-static-source-scan"
6373
+ ],
6374
+ "source": {
6375
+ "path": "packages/core/engineering-housekeeper.js",
6376
+ "line": 92
6377
+ },
6378
+ "example": "import { classifyHousekeeperBranch } from \"@kungfu-tech/buildchain\";",
6379
+ "maturity": "stable",
6380
+ "audience": [
6381
+ "developer",
6382
+ "agent"
6383
+ ]
6384
+ },
6385
+ {
6386
+ "id": "packages/core/engineering-housekeeper.js#classifyHousekeeperPullRequest",
6387
+ "name": "classifyHousekeeperPullRequest",
6388
+ "kind": "function",
6389
+ "signature": "function classifyHousekeeperPullRequest(pullRequest, policyInput = {})",
6390
+ "parameters": [
6391
+ {
6392
+ "name": "pullRequest",
6393
+ "signature": "pullRequest"
6394
+ },
6395
+ {
6396
+ "name": "policyInput",
6397
+ "signature": "policyInput = {}"
6398
+ }
6399
+ ],
6400
+ "returns": "unknown",
6401
+ "errors": [
6402
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6403
+ ],
6404
+ "sideEffects": [
6405
+ "none-detected-by-static-source-scan"
6406
+ ],
6407
+ "source": {
6408
+ "path": "packages/core/engineering-housekeeper.js",
6409
+ "line": 129
6410
+ },
6411
+ "example": "import { classifyHousekeeperPullRequest } from \"@kungfu-tech/buildchain\";",
6412
+ "maturity": "stable",
6413
+ "audience": [
6414
+ "developer",
6415
+ "agent"
6416
+ ]
6417
+ },
6418
+ {
6419
+ "id": "packages/core/engineering-housekeeper.js#classifyHousekeeperReplay",
6420
+ "name": "classifyHousekeeperReplay",
6421
+ "kind": "function",
6422
+ "signature": "function classifyHousekeeperReplay(plan, priorReceipt)",
6423
+ "parameters": [
6424
+ {
6425
+ "name": "plan",
6426
+ "signature": "plan"
6427
+ },
6428
+ {
6429
+ "name": "priorReceipt",
6430
+ "signature": "priorReceipt"
6431
+ }
6432
+ ],
6433
+ "returns": "unknown",
6434
+ "errors": [
6435
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6436
+ ],
6437
+ "sideEffects": [
6438
+ "none-detected-by-static-source-scan"
6439
+ ],
6440
+ "source": {
6441
+ "path": "packages/core/engineering-housekeeper.js",
6442
+ "line": 250
6443
+ },
6444
+ "example": "import { classifyHousekeeperReplay } from \"@kungfu-tech/buildchain\";",
6445
+ "maturity": "stable",
6446
+ "audience": [
6447
+ "developer",
6448
+ "agent"
6449
+ ]
6450
+ },
6451
+ {
6452
+ "id": "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperPlan",
6453
+ "name": "createEngineeringHousekeeperPlan",
6454
+ "kind": "function",
6455
+ "signature": "function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, })",
6456
+ "parameters": [
6457
+ {
6458
+ "name": "parameter1",
6459
+ "signature": "{ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }"
6460
+ }
6461
+ ],
6462
+ "returns": "unknown",
6463
+ "errors": [
6464
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6465
+ ],
6466
+ "sideEffects": [
6467
+ "none-detected-by-static-source-scan"
6468
+ ],
6469
+ "source": {
6470
+ "path": "packages/core/engineering-housekeeper.js",
6471
+ "line": 155
6472
+ },
6473
+ "example": "import { createEngineeringHousekeeperPlan } from \"@kungfu-tech/buildchain\";",
6474
+ "maturity": "stable",
6475
+ "audience": [
6476
+ "developer",
6477
+ "agent"
6478
+ ]
6479
+ },
6480
+ {
6481
+ "id": "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperReceipt",
6482
+ "name": "createEngineeringHousekeeperReceipt",
6483
+ "kind": "function",
6484
+ "signature": "function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, })",
6485
+ "parameters": [
6486
+ {
6487
+ "name": "parameter1",
6488
+ "signature": "{ plan, outcomes, appliedAt, }"
6489
+ }
6490
+ ],
6491
+ "returns": "unknown",
6492
+ "errors": [
6493
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6494
+ ],
6495
+ "sideEffects": [
6496
+ "none-detected-by-static-source-scan"
6497
+ ],
6498
+ "source": {
6499
+ "path": "packages/core/engineering-housekeeper.js",
6500
+ "line": 231
6501
+ },
6502
+ "example": "import { createEngineeringHousekeeperReceipt } from \"@kungfu-tech/buildchain\";",
6503
+ "maturity": "stable",
6504
+ "audience": [
6505
+ "developer",
6506
+ "agent"
6507
+ ]
6508
+ },
6509
+ {
6510
+ "id": "packages/core/engineering-housekeeper.js#DEFAULT_HOUSEKEEPER_POLICY",
6511
+ "name": "DEFAULT_HOUSEKEEPER_POLICY",
6512
+ "kind": "constant",
6513
+ "signature": "const DEFAULT_HOUSEKEEPER_POLICY",
6514
+ "parameters": [],
6515
+ "returns": "value",
6516
+ "errors": [
6517
+ "Import does not declare a throw contract."
6518
+ ],
6519
+ "sideEffects": [
6520
+ "none-on-import"
6521
+ ],
6522
+ "source": {
6523
+ "path": "packages/core/engineering-housekeeper.js",
6524
+ "line": 28
6525
+ },
6526
+ "example": "import { DEFAULT_HOUSEKEEPER_POLICY } from \"@kungfu-tech/buildchain\";",
6527
+ "maturity": "stable",
6528
+ "audience": [
6529
+ "developer",
6530
+ "agent"
6531
+ ]
6532
+ },
6533
+ {
6534
+ "id": "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_CONTRACT",
6535
+ "name": "ENGINEERING_HOUSEKEEPER_CONTRACT",
6536
+ "kind": "constant",
6537
+ "signature": "const ENGINEERING_HOUSEKEEPER_CONTRACT",
6538
+ "parameters": [],
6539
+ "returns": "value",
6540
+ "errors": [
6541
+ "Import does not declare a throw contract."
6542
+ ],
6543
+ "sideEffects": [
6544
+ "none-on-import"
6545
+ ],
6546
+ "source": {
6547
+ "path": "packages/core/engineering-housekeeper.js",
6548
+ "line": 3
6549
+ },
6550
+ "example": "import { ENGINEERING_HOUSEKEEPER_CONTRACT } from \"@kungfu-tech/buildchain\";",
6551
+ "maturity": "stable",
6552
+ "audience": [
6553
+ "developer",
6554
+ "agent"
6555
+ ]
6556
+ },
6557
+ {
6558
+ "id": "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION",
6559
+ "name": "ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION",
6560
+ "kind": "constant",
6561
+ "signature": "const ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION",
6562
+ "parameters": [],
6563
+ "returns": "value",
6564
+ "errors": [
6565
+ "Import does not declare a throw contract."
6566
+ ],
6567
+ "sideEffects": [
6568
+ "none-on-import"
6569
+ ],
6570
+ "source": {
6571
+ "path": "packages/core/engineering-housekeeper.js",
6572
+ "line": 5
6573
+ },
6574
+ "example": "import { ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION } from \"@kungfu-tech/buildchain\";",
6575
+ "maturity": "stable",
6576
+ "audience": [
6577
+ "developer",
6578
+ "agent"
6579
+ ]
6580
+ },
6581
+ {
6582
+ "id": "packages/core/engineering-housekeeper.js#engineeringHousekeeperRoot",
6583
+ "name": "engineeringHousekeeperRoot",
6584
+ "kind": "function",
6585
+ "signature": "function engineeringHousekeeperRoot(value)",
6586
+ "parameters": [
6587
+ {
6588
+ "name": "value",
6589
+ "signature": "value"
6590
+ }
6591
+ ],
6592
+ "returns": "unknown",
6593
+ "errors": [
6594
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6595
+ ],
6596
+ "sideEffects": [
6597
+ "none-detected-by-static-source-scan"
6598
+ ],
6599
+ "source": {
6600
+ "path": "packages/core/engineering-housekeeper.js",
6601
+ "line": 49
6602
+ },
6603
+ "example": "import { engineeringHousekeeperRoot } from \"@kungfu-tech/buildchain\";",
6604
+ "maturity": "stable",
6605
+ "audience": [
6606
+ "developer",
6607
+ "agent"
6608
+ ]
6609
+ },
6610
+ {
6611
+ "id": "packages/core/engineering-housekeeper.js#HOUSEKEEPER_REASON_CODES",
6612
+ "name": "HOUSEKEEPER_REASON_CODES",
6613
+ "kind": "constant",
6614
+ "signature": "const HOUSEKEEPER_REASON_CODES",
6615
+ "parameters": [],
6616
+ "returns": "value",
6617
+ "errors": [
6618
+ "Import does not declare a throw contract."
6619
+ ],
6620
+ "sideEffects": [
6621
+ "none-on-import"
6622
+ ],
6623
+ "source": {
6624
+ "path": "packages/core/engineering-housekeeper.js",
6625
+ "line": 7
6626
+ },
6627
+ "example": "import { HOUSEKEEPER_REASON_CODES } from \"@kungfu-tech/buildchain\";",
6628
+ "maturity": "stable",
6629
+ "audience": [
6630
+ "developer",
6631
+ "agent"
6632
+ ]
6633
+ },
6634
+ {
6635
+ "id": "packages/core/engineering-housekeeper.js#revalidateHousekeeperBranchAction",
6636
+ "name": "revalidateHousekeeperBranchAction",
6637
+ "kind": "function",
6638
+ "signature": "function revalidateHousekeeperBranchAction(action, current, policy = {})",
6639
+ "parameters": [
6640
+ {
6641
+ "name": "action",
6642
+ "signature": "action"
6643
+ },
6644
+ {
6645
+ "name": "current",
6646
+ "signature": "current"
6647
+ },
6648
+ {
6649
+ "name": "policy",
6650
+ "signature": "policy = {}"
6651
+ }
6652
+ ],
6653
+ "returns": "unknown",
6654
+ "errors": [
6655
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6656
+ ],
6657
+ "sideEffects": [
6658
+ "none-detected-by-static-source-scan"
6659
+ ],
6660
+ "source": {
6661
+ "path": "packages/core/engineering-housekeeper.js",
6662
+ "line": 208
6663
+ },
6664
+ "example": "import { revalidateHousekeeperBranchAction } from \"@kungfu-tech/buildchain\";",
6665
+ "maturity": "stable",
6666
+ "audience": [
6667
+ "developer",
6668
+ "agent"
6669
+ ]
6670
+ },
6188
6671
  {
6189
6672
  "id": "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationEvidence",
6190
6673
  "name": "createGitHubArtifactAttestationEvidence",
@@ -8236,11 +8719,11 @@
8236
8719
  "id": "packages/core/kfd-gate.js#createKfd1ReleaseGateEvidence",
8237
8720
  "name": "createKfd1ReleaseGateEvidence",
8238
8721
  "kind": "function",
8239
- "signature": "function createKfd1ReleaseGateEvidence({ cwd = process.cwd(), artifactRoot = \"\", artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {})",
8722
+ "signature": "function createKfd1ReleaseGateEvidence({ cwd = process.cwd(), artifactRoot = \"\", artifactSearchRoots = [], artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {})",
8240
8723
  "parameters": [
8241
8724
  {
8242
8725
  "name": "parameter1",
8243
- "signature": "{ cwd = process.cwd(), artifactRoot = \"\", artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {}"
8726
+ "signature": "{ cwd = process.cwd(), artifactRoot = \"\", artifactSearchRoots = [], artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {}"
8244
8727
  }
8245
8728
  ],
8246
8729
  "returns": "unknown",
@@ -8252,7 +8735,7 @@
8252
8735
  ],
8253
8736
  "source": {
8254
8737
  "path": "packages/core/kfd-gate.js",
8255
- "line": 977
8738
+ "line": 1000
8256
8739
  },
8257
8740
  "example": "import { createKfd1ReleaseGateEvidence } from \"@kungfu-tech/buildchain\";",
8258
8741
  "maturity": "stable",
@@ -8281,7 +8764,7 @@
8281
8764
  ],
8282
8765
  "source": {
8283
8766
  "path": "packages/core/kfd-gate.js",
8284
- "line": 1132
8767
+ "line": 1162
8285
8768
  },
8286
8769
  "example": "import { createKfd3CollaborationInterfaceReleaseGateEvidence } from \"@kungfu-tech/buildchain\";",
8287
8770
  "maturity": "stable",
@@ -8702,7 +9185,7 @@
8702
9185
  ],
8703
9186
  "source": {
8704
9187
  "path": "packages/core/kfd-gate.js",
8705
- "line": 1337
9188
+ "line": 1367
8706
9189
  },
8707
9190
  "example": "import { validateKfd1ReleaseGateEvidence } from \"@kungfu-tech/buildchain\";",
8708
9191
  "maturity": "stable",
@@ -8768,7 +9251,7 @@
8768
9251
  ],
8769
9252
  "source": {
8770
9253
  "path": "packages/core/kfd-gate.js",
8771
- "line": 1470
9254
+ "line": 1500
8772
9255
  },
8773
9256
  "example": "import { validateKfd3CollaborationInterfaceReleaseGateEvidence } from \"@kungfu-tech/buildchain\";",
8774
9257
  "maturity": "stable",
@@ -13862,7 +14345,7 @@
13862
14345
  ],
13863
14346
  "source": {
13864
14347
  "path": "packages/core/publication-rehearsal-runtime.js",
13865
- "line": 380
14348
+ "line": 392
13866
14349
  },
13867
14350
  "example": "import { createPublicationRehearsalCapsule } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
13868
14351
  "maturity": "stable",
@@ -13891,7 +14374,7 @@
13891
14374
  ],
13892
14375
  "source": {
13893
14376
  "path": "packages/core/publication-rehearsal-runtime.js",
13894
- "line": 821
14377
+ "line": 833
13895
14378
  },
13896
14379
  "example": "import { executePublicationRehearsal } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
13897
14380
  "maturity": "stable",
@@ -13920,7 +14403,7 @@
13920
14403
  ],
13921
14404
  "source": {
13922
14405
  "path": "packages/core/publication-rehearsal-runtime.js",
13923
- "line": 410
14406
+ "line": 422
13924
14407
  },
13925
14408
  "example": "import { normalizePublicationRehearsalCapsule } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
13926
14409
  "maturity": "stable",
@@ -14045,7 +14528,7 @@
14045
14528
  ],
14046
14529
  "source": {
14047
14530
  "path": "packages/core/publication-rehearsal-runtime.js",
14048
- "line": 787
14531
+ "line": 799
14049
14532
  },
14050
14533
  "example": "import { publicationRehearsalBindingRoot } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
14051
14534
  "maturity": "stable",
@@ -14078,7 +14561,7 @@
14078
14561
  ],
14079
14562
  "source": {
14080
14563
  "path": "packages/core/publication-rehearsal-runtime.js",
14081
- "line": 801
14564
+ "line": 813
14082
14565
  },
14083
14566
  "example": "import { publicationRehearsalDiagnostic } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
14084
14567
  "maturity": "stable",
@@ -14187,7 +14670,7 @@
14187
14670
  ],
14188
14671
  "source": {
14189
14672
  "path": "packages/core/publication-rehearsal-runtime.js",
14190
- "line": 898
14673
+ "line": 910
14191
14674
  },
14192
14675
  "example": "import { resolvePublicationRehearsalFile } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
14193
14676
  "maturity": "stable",
@@ -14216,7 +14699,7 @@
14216
14699
  ],
14217
14700
  "source": {
14218
14701
  "path": "packages/core/publication-rehearsal-runtime.js",
14219
- "line": 571
14702
+ "line": 583
14220
14703
  },
14221
14704
  "example": "import { verifyPublicationRehearsalCapsule } from \"@kungfu-tech/buildchain/publication-rehearsal-runtime\";",
14222
14705
  "maturity": "stable",
@@ -16058,11 +16541,11 @@
16058
16541
  "id": "packages/core/release-passport.js#collectGitHubReleasePassport",
16059
16542
  "name": "collectGitHubReleasePassport",
16060
16543
  "kind": "function",
16061
- "signature": "function collectGitHubReleasePassport({ cwd = process.cwd(), tag = \"\", repository = process.env.GITHUB_REPOSITORY || \"\", sourceSha = process.env.GITHUB_SHA || \"\", line = \"\", outputDir = \".buildchain/release-passport\", assetsJson = \"\", assetsDir = \"\", releaseJson = \"\", productName = \"Buildchain\", packageName = \"@kungfu-tech/buildchain\", packageVersion = \"\", packageSetJson = \"\", publishEvidenceJson = \"\", trustedPublishingJson = \"\", transactionJson = \"\", anchorManifestJson = \"\", versionMaterialJson = \"\", impactJson = \"\", buildSummaryJson = \"\", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = \"\", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = \"\", kfdSupportMatrixJson = \"\", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = \"\", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = \"\", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = \"\", requireBaseKfd = false, releaseJsonExtra = \"\", publishJson = \"\", workflow = {}, checkedAt = \"\", } = {})",
16544
+ "signature": "function collectGitHubReleasePassport({ cwd = process.cwd(), tag = \"\", repository = process.env.GITHUB_REPOSITORY || \"\", sourceSha = process.env.GITHUB_SHA || \"\", line = \"\", outputDir = \".buildchain/release-passport\", assetsJson = \"\", assetsDir = \"\", kfdArtifactSearchRoots = [], releaseJson = \"\", productName = \"Buildchain\", packageName = \"@kungfu-tech/buildchain\", packageVersion = \"\", packageSetJson = \"\", publishEvidenceJson = \"\", trustedPublishingJson = \"\", transactionJson = \"\", anchorManifestJson = \"\", versionMaterialJson = \"\", impactJson = \"\", buildSummaryJson = \"\", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = \"\", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = \"\", kfdSupportMatrixJson = \"\", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = \"\", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = \"\", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = \"\", requireBaseKfd = false, releaseJsonExtra = \"\", publishJson = \"\", workflow = {}, checkedAt = \"\", } = {})",
16062
16545
  "parameters": [
16063
16546
  {
16064
16547
  "name": "parameter1",
16065
- "signature": "{ cwd = process.cwd(), tag = \"\", repository = process.env.GITHUB_REPOSITORY || \"\", sourceSha = process.env.GITHUB_SHA || \"\", line = \"\", outputDir = \".buildchain/release-passport\", assetsJson = \"\", assetsDir = \"\", releaseJson = \"\", productName = \"Buildchain\", packageName = \"@kungfu-tech/buildchain\", packageVersion = \"\", packageSetJson = \"\", publishEvidenceJson = \"\", trustedPublishingJson = \"\", transactionJson = \"\", anchorManifestJson = \"\", versionMaterialJson = \"\", impactJson = \"\", buildSummaryJson = \"\", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = \"\", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = \"\", kfdSupportMatrixJson = \"\", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = \"\", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = \"\", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = \"\", requireBaseKfd = false, releaseJsonExtra = \"\", publishJson = \"\", workflow = {}, checkedAt = \"\", } = {}"
16548
+ "signature": "{ cwd = process.cwd(), tag = \"\", repository = process.env.GITHUB_REPOSITORY || \"\", sourceSha = process.env.GITHUB_SHA || \"\", line = \"\", outputDir = \".buildchain/release-passport\", assetsJson = \"\", assetsDir = \"\", kfdArtifactSearchRoots = [], releaseJson = \"\", productName = \"Buildchain\", packageName = \"@kungfu-tech/buildchain\", packageVersion = \"\", packageSetJson = \"\", publishEvidenceJson = \"\", trustedPublishingJson = \"\", transactionJson = \"\", anchorManifestJson = \"\", versionMaterialJson = \"\", impactJson = \"\", buildSummaryJson = \"\", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = \"\", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = \"\", kfdSupportMatrixJson = \"\", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = \"\", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = \"\", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = \"\", requireBaseKfd = false, releaseJsonExtra = \"\", publishJson = \"\", workflow = {}, checkedAt = \"\", } = {}"
16066
16549
  }
16067
16550
  ],
16068
16551
  "returns": "unknown",
@@ -16074,7 +16557,7 @@
16074
16557
  ],
16075
16558
  "source": {
16076
16559
  "path": "packages/core/release-passport.js",
16077
- "line": 1488
16560
+ "line": 1563
16078
16561
  },
16079
16562
  "example": "import { collectGitHubReleasePassport } from \"@kungfu-tech/buildchain\";",
16080
16563
  "maturity": "stable",
@@ -16103,7 +16586,7 @@
16103
16586
  ],
16104
16587
  "source": {
16105
16588
  "path": "packages/core/release-passport.js",
16106
- "line": 1158
16589
+ "line": 1233
16107
16590
  },
16108
16591
  "example": "import { createArtifactEvidence } from \"@kungfu-tech/buildchain\";",
16109
16592
  "maturity": "stable",
@@ -16132,7 +16615,7 @@
16132
16615
  ],
16133
16616
  "source": {
16134
16617
  "path": "packages/core/release-passport.js",
16135
- "line": 201
16618
+ "line": 228
16136
16619
  },
16137
16620
  "example": "import { createInvariantPassportGate } from \"@kungfu-tech/buildchain/release-passport\";",
16138
16621
  "maturity": "stable",
@@ -16161,7 +16644,7 @@
16161
16644
  ],
16162
16645
  "source": {
16163
16646
  "path": "packages/core/release-passport.js",
16164
- "line": 2628
16647
+ "line": 2738
16165
16648
  },
16166
16649
  "example": "import { createReleaseCheckReport } from \"@kungfu-tech/buildchain\";",
16167
16650
  "maturity": "stable",
@@ -16190,7 +16673,7 @@
16190
16673
  ],
16191
16674
  "source": {
16192
16675
  "path": "packages/core/release-passport.js",
16193
- "line": 1214
16676
+ "line": 1289
16194
16677
  },
16195
16678
  "example": "import { createReleasePassport } from \"@kungfu-tech/buildchain\";",
16196
16679
  "maturity": "stable",
@@ -16219,7 +16702,7 @@
16219
16702
  ],
16220
16703
  "source": {
16221
16704
  "path": "packages/core/release-passport.js",
16222
- "line": 2812
16705
+ "line": 2922
16223
16706
  },
16224
16707
  "example": "import { explainReleasePassport } from \"@kungfu-tech/buildchain\";",
16225
16708
  "maturity": "stable",
@@ -16368,7 +16851,7 @@
16368
16851
  ],
16369
16852
  "source": {
16370
16853
  "path": "packages/core/release-passport.js",
16371
- "line": 2841
16854
+ "line": 2951
16372
16855
  },
16373
16856
  "example": "import { makeReleasePassportFixtureAssets } from \"@kungfu-tech/buildchain\";",
16374
16857
  "maturity": "stable",
@@ -16429,7 +16912,7 @@
16429
16912
  ],
16430
16913
  "source": {
16431
16914
  "path": "packages/core/release-passport.js",
16432
- "line": 2694
16915
+ "line": 2804
16433
16916
  },
16434
16917
  "example": "import { readJsonFromLocation } from \"@kungfu-tech/buildchain\";",
16435
16918
  "maturity": "stable",
@@ -16531,7 +17014,7 @@
16531
17014
  ],
16532
17015
  "source": {
16533
17016
  "path": "packages/core/release-passport.js",
16534
- "line": 216
17017
+ "line": 243
16535
17018
  },
16536
17019
  "example": "import { sha256File } from \"@kungfu-tech/buildchain\";",
16537
17020
  "maturity": "stable",
@@ -16584,7 +17067,7 @@
16584
17067
  ],
16585
17068
  "source": {
16586
17069
  "path": "packages/core/release-passport.js",
16587
- "line": 2853
17070
+ "line": 2963
16588
17071
  },
16589
17072
  "example": "import { validateKnownReleasePassportContracts } from \"@kungfu-tech/buildchain\";",
16590
17073
  "maturity": "stable",
@@ -16613,7 +17096,7 @@
16613
17096
  ],
16614
17097
  "source": {
16615
17098
  "path": "packages/core/release-passport.js",
16616
- "line": 2743
17099
+ "line": 2853
16617
17100
  },
16618
17101
  "example": "import { verifyReleasePassport } from \"@kungfu-tech/buildchain\";",
16619
17102
  "maturity": "stable",
@@ -19188,14 +19671,14 @@
19188
19671
  "specifier": "@kungfu-tech/buildchain",
19189
19672
  "export": ".",
19190
19673
  "target": "./packages/core/index.js",
19191
- "digest": "sha256:d1067d7b0678cd9b6a98f2f1b1ab39f18b13686c2d6fd28f40c83757d4f90881",
19674
+ "digest": "sha256:ae7917ccdbbf268073bad5dac68e9af915d6e40ede628171f4e5241c4e5bc88a",
19192
19675
  "summary": "Root toolkit export for Buildchain's public Node API.",
19193
19676
  "capabilityGroup": "api-cli-reference",
19194
19677
  "audience": [
19195
19678
  "developer",
19196
19679
  "agent"
19197
19680
  ],
19198
- "symbolCount": 592,
19681
+ "symbolCount": 609,
19199
19682
  "symbolIds": [
19200
19683
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
19201
19684
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -19203,6 +19686,7 @@
19203
19686
  "packages/core/controller-evidence.js#aggregateControllerReceipts",
19204
19687
  "packages/core/anchored-version-material.js#ANCHORED_VERSION_MATERIAL_CONTRACT",
19205
19688
  "packages/core/logging.js#appendBuildchainLogEvent",
19689
+ "packages/core/engineering-housekeeper-github.js#applyGitHubHousekeeperPlan",
19206
19690
  "packages/core/surface-manifest.js#applySurfaceTimestampPolicy",
19207
19691
  "packages/core/release-passport.js#ARTIFACT_EVIDENCE_CONTRACT",
19208
19692
  "packages/core/artifact-passport.js#ARTIFACT_PASSPORT_LOCATOR_CONTRACT",
@@ -19294,6 +19778,9 @@
19294
19778
  "packages/core/kfd2-product-claims.js#checkKfd2ProductClaimOutputs",
19295
19779
  "packages/core/readme-badges.js#checkReadmeBadgeBlock",
19296
19780
  "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
19781
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperBranch",
19782
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperPullRequest",
19783
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperReplay",
19297
19784
  "packages/core/diagnostics.js#classifyProcessCommand",
19298
19785
  "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
19299
19786
  "packages/core/github-governance-authority.js#codeownersForPath",
@@ -19302,6 +19789,7 @@
19302
19789
  "packages/core/diagnostics.js#collectCacheDiagnostics",
19303
19790
  "packages/core/diagnostics.js#collectCompilerCacheDiagnostics",
19304
19791
  "packages/core/diagnostics.js#collectGitDiagnostics",
19792
+ "packages/core/engineering-housekeeper-github.js#collectGitHubHousekeeperInventory",
19305
19793
  "packages/core/release-passport.js#collectGitHubReleasePassport",
19306
19794
  "packages/core/build-facts.js#collectGitSourceFacts",
19307
19795
  "packages/core/homebrew.js#collectHomebrewTapFacts",
@@ -19358,6 +19846,8 @@
19358
19846
  "packages/core/controller-evidence.js#createControllerReceiptReference",
19359
19847
  "packages/core/controller-evidence.js#createControllerRegistry",
19360
19848
  "packages/core/diagnostics.js#createDiagnosticsArtifact",
19849
+ "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperPlan",
19850
+ "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperReceipt",
19361
19851
  "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationEvidence",
19362
19852
  "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationPolicy",
19363
19853
  "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationVerificationPlan",
@@ -19416,6 +19906,7 @@
19416
19906
  "packages/core/web-surface-publication-candidate.js#createWebSurfacePublicationCandidate",
19417
19907
  "packages/core/channel-candidate.js#decideChannelCandidate",
19418
19908
  "packages/core/issue-reporting.js#DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY",
19909
+ "packages/core/engineering-housekeeper.js#DEFAULT_HOUSEKEEPER_POLICY",
19419
19910
  "packages/core/logging.js#defaultBuildchainLogPath",
19420
19911
  "packages/core/publish-transaction.js#defaultPublishEvidencePath",
19421
19912
  "packages/core/publish-transaction.js#defaultReleaseStatePath",
@@ -19433,6 +19924,9 @@
19433
19924
  "packages/core/buildchain-config.js#discoverConfiguredVersionStateFiles",
19434
19925
  "packages/core/kfd.js#discoverKfdStandards",
19435
19926
  "packages/core/paper-fleet.js#discoverPaperFleet",
19927
+ "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_CONTRACT",
19928
+ "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION",
19929
+ "packages/core/engineering-housekeeper.js#engineeringHousekeeperRoot",
19436
19930
  "packages/core/public-surface-audit.js#enumerateActionInputs",
19437
19931
  "packages/core/public-surface-cli.js#enumerateCliCommandsFromBin",
19438
19932
  "packages/core/public-surface-audit.js#enumerateDocCommandRefs",
@@ -19456,6 +19950,7 @@
19456
19950
  "packages/core/buildchain-contract.js#finalizeBuildchainContractWorld",
19457
19951
  "packages/core/candidate-timeline.js#formatCandidateTimelineReport",
19458
19952
  "packages/core/diagnostics.js#formatDiagnosticsSummaryTable",
19953
+ "packages/core/engineering-housekeeper-github.js#formatGitHubHousekeeperPlan",
19459
19954
  "packages/core/release-line-dry-run.js#formatReleaseLineDryRun",
19460
19955
  "packages/core/buildchain-config.js#getLifecycleStage",
19461
19956
  "packages/core/buildchain-config.js#getNativeDiagnosticsProfile",
@@ -19478,11 +19973,14 @@
19478
19973
  "packages/core/github-artifact-attestation.js#githubArtifactAttestationSha256Buffer",
19479
19974
  "packages/core/github-artifact-attestation.js#githubArtifactAttestationSha256File",
19480
19975
  "packages/core/github-governance-authority.js#githubGovernanceDigest",
19976
+ "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperClient",
19977
+ "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperProviderError",
19481
19978
  "packages/core/issue-reporting.js#GitHubIssueRequestError",
19482
19979
  "packages/core/release-tail-provider-adapters.js#githubReleaseAssetsTargetRoot",
19483
19980
  "packages/core/homebrew.js#HOMEBREW_TAP_CHECK_CONTRACT",
19484
19981
  "packages/core/homebrew.js#HOMEBREW_TAP_FACTS_CONTRACT",
19485
19982
  "packages/core/homebrew.js#HOMEBREW_TAP_MANIFEST_CONTRACT",
19983
+ "packages/core/engineering-housekeeper.js#HOUSEKEEPER_REASON_CODES",
19486
19984
  "packages/core/release-passport.js#IMPACT_LEDGER_CONTRACT",
19487
19985
  "packages/core/kfd-agent-hub.js#initKfdAgentHub",
19488
19986
  "packages/core/kfd-agent-hub.js#inspectKfdAgentHub",
@@ -19696,8 +20194,10 @@
19696
20194
  "packages/core/publication-artifact-candidate.js#resolvePublicationCandidateFile",
19697
20195
  "packages/core/buildchain-layout.js#resolveReleasePassportPath",
19698
20196
  "packages/core/release-propagation-work.js#resumeReleasePropagationWork",
20197
+ "packages/core/engineering-housekeeper.js#revalidateHousekeeperBranchAction",
19699
20198
  "packages/core/stable-candidate-ledger.js#revokeStableCandidate",
19700
20199
  "packages/core/release-activation-transaction.js#rollbackReleaseActivationTransaction",
20200
+ "packages/core/engineering-housekeeper-github.js#runGitHubHousekeeper",
19701
20201
  "packages/core/buildchain-config.js#runLifecycleStage",
19702
20202
  "packages/core/publication-authority.js#RUNNER_PROVENANCE_CLASSES",
19703
20203
  "packages/core/publication-authority.js#RUNNER_PROVENANCE_CONTRACT",
@@ -19878,14 +20378,14 @@
19878
20378
  "specifier": "@kungfu-tech/buildchain/core",
19879
20379
  "export": "./core",
19880
20380
  "target": "./packages/core/index.js",
19881
- "digest": "sha256:d1067d7b0678cd9b6a98f2f1b1ab39f18b13686c2d6fd28f40c83757d4f90881",
20381
+ "digest": "sha256:ae7917ccdbbf268073bad5dac68e9af915d6e40ede628171f4e5241c4e5bc88a",
19882
20382
  "summary": "Alias for the root public toolkit export.",
19883
20383
  "capabilityGroup": "api-cli-reference",
19884
20384
  "audience": [
19885
20385
  "developer",
19886
20386
  "agent"
19887
20387
  ],
19888
- "symbolCount": 592,
20388
+ "symbolCount": 609,
19889
20389
  "symbolIds": [
19890
20390
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
19891
20391
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -19893,6 +20393,7 @@
19893
20393
  "packages/core/controller-evidence.js#aggregateControllerReceipts",
19894
20394
  "packages/core/anchored-version-material.js#ANCHORED_VERSION_MATERIAL_CONTRACT",
19895
20395
  "packages/core/logging.js#appendBuildchainLogEvent",
20396
+ "packages/core/engineering-housekeeper-github.js#applyGitHubHousekeeperPlan",
19896
20397
  "packages/core/surface-manifest.js#applySurfaceTimestampPolicy",
19897
20398
  "packages/core/release-passport.js#ARTIFACT_EVIDENCE_CONTRACT",
19898
20399
  "packages/core/artifact-passport.js#ARTIFACT_PASSPORT_LOCATOR_CONTRACT",
@@ -19984,6 +20485,9 @@
19984
20485
  "packages/core/kfd2-product-claims.js#checkKfd2ProductClaimOutputs",
19985
20486
  "packages/core/readme-badges.js#checkReadmeBadgeBlock",
19986
20487
  "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
20488
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperBranch",
20489
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperPullRequest",
20490
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperReplay",
19987
20491
  "packages/core/diagnostics.js#classifyProcessCommand",
19988
20492
  "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
19989
20493
  "packages/core/github-governance-authority.js#codeownersForPath",
@@ -19992,6 +20496,7 @@
19992
20496
  "packages/core/diagnostics.js#collectCacheDiagnostics",
19993
20497
  "packages/core/diagnostics.js#collectCompilerCacheDiagnostics",
19994
20498
  "packages/core/diagnostics.js#collectGitDiagnostics",
20499
+ "packages/core/engineering-housekeeper-github.js#collectGitHubHousekeeperInventory",
19995
20500
  "packages/core/release-passport.js#collectGitHubReleasePassport",
19996
20501
  "packages/core/build-facts.js#collectGitSourceFacts",
19997
20502
  "packages/core/homebrew.js#collectHomebrewTapFacts",
@@ -20048,6 +20553,8 @@
20048
20553
  "packages/core/controller-evidence.js#createControllerReceiptReference",
20049
20554
  "packages/core/controller-evidence.js#createControllerRegistry",
20050
20555
  "packages/core/diagnostics.js#createDiagnosticsArtifact",
20556
+ "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperPlan",
20557
+ "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperReceipt",
20051
20558
  "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationEvidence",
20052
20559
  "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationPolicy",
20053
20560
  "packages/core/github-artifact-attestation.js#createGitHubArtifactAttestationVerificationPlan",
@@ -20106,6 +20613,7 @@
20106
20613
  "packages/core/web-surface-publication-candidate.js#createWebSurfacePublicationCandidate",
20107
20614
  "packages/core/channel-candidate.js#decideChannelCandidate",
20108
20615
  "packages/core/issue-reporting.js#DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY",
20616
+ "packages/core/engineering-housekeeper.js#DEFAULT_HOUSEKEEPER_POLICY",
20109
20617
  "packages/core/logging.js#defaultBuildchainLogPath",
20110
20618
  "packages/core/publish-transaction.js#defaultPublishEvidencePath",
20111
20619
  "packages/core/publish-transaction.js#defaultReleaseStatePath",
@@ -20123,6 +20631,9 @@
20123
20631
  "packages/core/buildchain-config.js#discoverConfiguredVersionStateFiles",
20124
20632
  "packages/core/kfd.js#discoverKfdStandards",
20125
20633
  "packages/core/paper-fleet.js#discoverPaperFleet",
20634
+ "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_CONTRACT",
20635
+ "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION",
20636
+ "packages/core/engineering-housekeeper.js#engineeringHousekeeperRoot",
20126
20637
  "packages/core/public-surface-audit.js#enumerateActionInputs",
20127
20638
  "packages/core/public-surface-cli.js#enumerateCliCommandsFromBin",
20128
20639
  "packages/core/public-surface-audit.js#enumerateDocCommandRefs",
@@ -20146,6 +20657,7 @@
20146
20657
  "packages/core/buildchain-contract.js#finalizeBuildchainContractWorld",
20147
20658
  "packages/core/candidate-timeline.js#formatCandidateTimelineReport",
20148
20659
  "packages/core/diagnostics.js#formatDiagnosticsSummaryTable",
20660
+ "packages/core/engineering-housekeeper-github.js#formatGitHubHousekeeperPlan",
20149
20661
  "packages/core/release-line-dry-run.js#formatReleaseLineDryRun",
20150
20662
  "packages/core/buildchain-config.js#getLifecycleStage",
20151
20663
  "packages/core/buildchain-config.js#getNativeDiagnosticsProfile",
@@ -20168,11 +20680,14 @@
20168
20680
  "packages/core/github-artifact-attestation.js#githubArtifactAttestationSha256Buffer",
20169
20681
  "packages/core/github-artifact-attestation.js#githubArtifactAttestationSha256File",
20170
20682
  "packages/core/github-governance-authority.js#githubGovernanceDigest",
20683
+ "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperClient",
20684
+ "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperProviderError",
20171
20685
  "packages/core/issue-reporting.js#GitHubIssueRequestError",
20172
20686
  "packages/core/release-tail-provider-adapters.js#githubReleaseAssetsTargetRoot",
20173
20687
  "packages/core/homebrew.js#HOMEBREW_TAP_CHECK_CONTRACT",
20174
20688
  "packages/core/homebrew.js#HOMEBREW_TAP_FACTS_CONTRACT",
20175
20689
  "packages/core/homebrew.js#HOMEBREW_TAP_MANIFEST_CONTRACT",
20690
+ "packages/core/engineering-housekeeper.js#HOUSEKEEPER_REASON_CODES",
20176
20691
  "packages/core/release-passport.js#IMPACT_LEDGER_CONTRACT",
20177
20692
  "packages/core/kfd-agent-hub.js#initKfdAgentHub",
20178
20693
  "packages/core/kfd-agent-hub.js#inspectKfdAgentHub",
@@ -20386,8 +20901,10 @@
20386
20901
  "packages/core/publication-artifact-candidate.js#resolvePublicationCandidateFile",
20387
20902
  "packages/core/buildchain-layout.js#resolveReleasePassportPath",
20388
20903
  "packages/core/release-propagation-work.js#resumeReleasePropagationWork",
20904
+ "packages/core/engineering-housekeeper.js#revalidateHousekeeperBranchAction",
20389
20905
  "packages/core/stable-candidate-ledger.js#revokeStableCandidate",
20390
20906
  "packages/core/release-activation-transaction.js#rollbackReleaseActivationTransaction",
20907
+ "packages/core/engineering-housekeeper-github.js#runGitHubHousekeeper",
20391
20908
  "packages/core/buildchain-config.js#runLifecycleStage",
20392
20909
  "packages/core/publication-authority.js#RUNNER_PROVENANCE_CLASSES",
20393
20910
  "packages/core/publication-authority.js#RUNNER_PROVENANCE_CONTRACT",
@@ -20593,7 +21110,7 @@
20593
21110
  "specifier": "@kungfu-tech/buildchain/artifact-signing",
20594
21111
  "export": "./artifact-signing",
20595
21112
  "target": "./packages/core/artifact-signing.js",
20596
- "digest": "sha256:7b4c88201125f08645092b121eeeab0390b4fdee665f0d6c949217cb6545d590",
21113
+ "digest": "sha256:4b6f1675af2aff8205329421a4e158a0ce5e6d2c07945d2208832fb68ca5b8ad",
20597
21114
  "summary": "Credential-free artifact signing declarations, source-bound requests, authority receipts, profile resolution, and fail-closed validation APIs.",
20598
21115
  "capabilityGroup": "reusable-build",
20599
21116
  "audience": [
@@ -20816,7 +21333,7 @@
20816
21333
  "specifier": "@kungfu-tech/buildchain/controller-evidence",
20817
21334
  "export": "./controller-evidence",
20818
21335
  "target": "./packages/core/controller-evidence.js",
20819
- "digest": "sha256:8a5070254b58cf2ea4e4851b29de4edfcf618a7d6acfb2235e705246ce40e22a",
21336
+ "digest": "sha256:482b124aefc9c829098f68967c6d942fa0731b77628e309767347a0aaaf8d456",
20820
21337
  "summary": "Project-independent controller descriptors, source/runtime-bound plans, receipts, aggregates, and validation APIs.",
20821
21338
  "capabilityGroup": "reusable-build",
20822
21339
  "audience": [
@@ -20852,7 +21369,7 @@
20852
21369
  "specifier": "@kungfu-tech/buildchain/diagnostics",
20853
21370
  "export": "./diagnostics",
20854
21371
  "target": "./packages/core/diagnostics.js",
20855
- "digest": "sha256:21d14194f9b876927c54b53cecf8265b23085b05f98d57c5526ef2a4a033962f",
21372
+ "digest": "sha256:f1f9ded9dbb022c930d21fa408c2b0f19ff164b6fcf047f3ee644fd183ff4584",
20856
21373
  "summary": "Native diagnostics collection, summarization, cache, compiler, and process-sampler APIs.",
20857
21374
  "capabilityGroup": "observability-diagnostics",
20858
21375
  "audience": [
@@ -20904,7 +21421,7 @@
20904
21421
  "specifier": "@kungfu-tech/buildchain/dev-delivery-warrant",
20905
21422
  "export": "./dev-delivery-warrant",
20906
21423
  "target": "./packages/core/dev-delivery-warrant.js",
20907
- "digest": "sha256:09a0b75d556d9722faab70a7e9113701f33edf51386d6c4d5f00c7a1d786e925",
21424
+ "digest": "sha256:084b586e798779c324b5fb68b6d2e9a9e2cc397daba1bd9f78a34d584c51f445",
20908
21425
  "summary": "Durable fair Dev Delivery Warrant queue, fenced lease, and split source and integration proof APIs.",
20909
21426
  "capabilityGroup": "governance-versioning",
20910
21427
  "audience": [
@@ -21594,7 +22111,7 @@
21594
22111
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
21595
22112
  "export": "./buildchain-publication-authority",
21596
22113
  "target": "./packages/core/buildchain-publication-authority.js",
21597
- "digest": "sha256:941c15fefd5ba161a5822c7e1de9e99cae4fc2768a610b2d2aa4a2a97b95705f",
22114
+ "digest": "sha256:c340301fb115c81b6cb382b6a563d3d3cc4ed45f070a631699358975db03d1c5",
21598
22115
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
21599
22116
  "capabilityGroup": "release-passport-trust",
21600
22117
  "audience": [
@@ -21658,11 +22175,72 @@
21658
22175
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
21659
22176
  "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
21660
22177
  },
22178
+ {
22179
+ "specifier": "@kungfu-tech/buildchain/engineering-housekeeper",
22180
+ "export": "./engineering-housekeeper",
22181
+ "target": "./packages/core/engineering-housekeeper.js",
22182
+ "digest": "sha256:8d2075a7a4836dc8b08bc72e3e08171e3f9bcdbc18e626db912e4048769c627b",
22183
+ "summary": "Provider-neutral repository hygiene classification, deterministic plan and receipt, apply-time revalidation, and replay APIs.",
22184
+ "capabilityGroup": "governance-versioning",
22185
+ "audience": [
22186
+ "developer",
22187
+ "agent"
22188
+ ],
22189
+ "symbolCount": 11,
22190
+ "symbolIds": [
22191
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperBranch",
22192
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperPullRequest",
22193
+ "packages/core/engineering-housekeeper.js#classifyHousekeeperReplay",
22194
+ "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperPlan",
22195
+ "packages/core/engineering-housekeeper.js#createEngineeringHousekeeperReceipt",
22196
+ "packages/core/engineering-housekeeper.js#DEFAULT_HOUSEKEEPER_POLICY",
22197
+ "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_CONTRACT",
22198
+ "packages/core/engineering-housekeeper.js#ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION",
22199
+ "packages/core/engineering-housekeeper.js#engineeringHousekeeperRoot",
22200
+ "packages/core/engineering-housekeeper.js#HOUSEKEEPER_REASON_CODES",
22201
+ "packages/core/engineering-housekeeper.js#revalidateHousekeeperBranchAction"
22202
+ ],
22203
+ "owner": "buildchain-core",
22204
+ "maturity": "stable",
22205
+ "introducedVersion": "pre-3.0.2-alpha.4",
22206
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
22207
+ "deprecationReplacement": "",
22208
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
22209
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
22210
+ },
22211
+ {
22212
+ "specifier": "@kungfu-tech/buildchain/engineering-housekeeper-github",
22213
+ "export": "./engineering-housekeeper-github",
22214
+ "target": "./packages/core/engineering-housekeeper-github.js",
22215
+ "digest": "sha256:fb9a9d15b284236cd4e09aedb238927d6ccd900ff011ad85eb184cecf7105750",
22216
+ "summary": "Paginated GitHub repository hygiene inventory, default-dry-run execution, exact-head mutation fences, and rooted provider receipts.",
22217
+ "capabilityGroup": "governance-versioning",
22218
+ "audience": [
22219
+ "developer",
22220
+ "agent"
22221
+ ],
22222
+ "symbolCount": 6,
22223
+ "symbolIds": [
22224
+ "packages/core/engineering-housekeeper-github.js#applyGitHubHousekeeperPlan",
22225
+ "packages/core/engineering-housekeeper-github.js#collectGitHubHousekeeperInventory",
22226
+ "packages/core/engineering-housekeeper-github.js#formatGitHubHousekeeperPlan",
22227
+ "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperClient",
22228
+ "packages/core/engineering-housekeeper-github-client.js#GitHubHousekeeperProviderError",
22229
+ "packages/core/engineering-housekeeper-github.js#runGitHubHousekeeper"
22230
+ ],
22231
+ "owner": "buildchain-core",
22232
+ "maturity": "stable",
22233
+ "introducedVersion": "pre-3.0.2-alpha.4",
22234
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
22235
+ "deprecationReplacement": "",
22236
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
22237
+ "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
22238
+ },
21661
22239
  {
21662
22240
  "specifier": "@kungfu-tech/buildchain/kfd-gate",
21663
22241
  "export": "./kfd-gate",
21664
22242
  "target": "./packages/core/kfd-gate.js",
21665
- "digest": "sha256:f31691f36f2a7930798805cb470aff7acd3503799cb72b954c7787b1d8b3eb31",
22243
+ "digest": "sha256:0ee7f76d04f9b77a63ec2cc12cec8e804da47b8ef81075982feb351346ac3d5b",
21666
22244
  "summary": "KFD-1/KFD-2/KFD-3 release gate evidence and validation APIs.",
21667
22245
  "capabilityGroup": "kfd-trust",
21668
22246
  "audience": [
@@ -21792,7 +22370,7 @@
21792
22370
  "specifier": "@kungfu-tech/buildchain/release-passport",
21793
22371
  "export": "./release-passport",
21794
22372
  "target": "./packages/core/release-passport.js",
21795
- "digest": "sha256:7d91592c518277646154ef5c7fde27d7101c87a0d7f69c90911ac0c7583c20ec",
22373
+ "digest": "sha256:dfebb115f842e83a189868c3ef06fa72e5e8043327e5f1c7d5d918f87cd2c74e",
21796
22374
  "summary": "Release passport collection, verification, explanation, and evidence APIs.",
21797
22375
  "capabilityGroup": "release-passport-trust",
21798
22376
  "audience": [
@@ -22057,7 +22635,7 @@
22057
22635
  "specifier": "@kungfu-tech/buildchain/publication-rehearsal-runtime",
22058
22636
  "export": "./publication-rehearsal-runtime",
22059
22637
  "target": "./packages/core/publication-rehearsal-runtime.js",
22060
- "digest": "sha256:9aa75e69b7635dddd5ce9ac89fa36fb6518f6a5cf336590eaca4ce6be472adbc",
22638
+ "digest": "sha256:e972ed649ab45d079ed598cc94587d35ab608ecb9a39a715eec55ae0d260f0eb",
22061
22639
  "summary": "Content-addressed local, replay, and provider-recording publication rehearsal over the shared release-tail core.",
22062
22640
  "capabilityGroup": "release-passport-trust",
22063
22641
  "audience": [
@@ -22188,7 +22766,7 @@
22188
22766
  {
22189
22767
  "id": "node-api-reference",
22190
22768
  "path": "docs/node-api-reference.md",
22191
- "digest": "sha256:6dd79b998f63cf996e5c76b4fe0c654d12ca603cd5db1277ef3347f489b96ef0"
22769
+ "digest": "sha256:ed843753964193ecb59610a54f0f23d76578228ebe6d31d1d6edce526729910c"
22192
22770
  },
22193
22771
  {
22194
22772
  "id": "build-facts",