@kungfu-tech/buildchain 3.0.6 → 3.0.7-alpha.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 (103) hide show
  1. package/README.md +4 -2
  2. package/actions/promote-buildchain-ref/README.md +10 -0
  3. package/actions/release-tail/README.md +17 -0
  4. package/bin/buildchain.mjs +11 -0
  5. package/bin/internal/command-registry.mjs +2 -0
  6. package/contracts/auditable-demo-scenario-v1.schema.json +1 -1
  7. package/contracts/engineering-housekeeper-v1.schema.json +143 -0
  8. package/contracts/fixtures/engineering-housekeeper-v1/cases.json +68 -0
  9. package/contracts/fixtures/release-tail-capabilities-v1/kungfu-alpha.json +273 -0
  10. package/contracts/publication-rehearsal-capsule-v1.schema.json +173 -0
  11. package/contracts/release-tail-capabilities-v1.schema.json +199 -0
  12. package/contracts/release-tail-provider-bindings-v1.schema.json +56 -0
  13. package/dist/site/agent-index.json +3 -0
  14. package/dist/site/artifact-schemas.json +6 -0
  15. package/dist/site/buildchain-contract.json +42 -27
  16. package/dist/site/buildchain-site.json +384 -33
  17. package/dist/site/capability-registry.json +15 -12
  18. package/dist/site/cli-registry.json +102 -0
  19. package/dist/site/controller-registry.json +19 -3
  20. package/dist/site/kfd-claims.json +359 -17
  21. package/dist/site/kfd-upstream-aggregate.json +1 -1
  22. package/dist/site/manual-registry.json +53 -7
  23. package/dist/site/node-api-registry.json +5882 -3605
  24. package/dist/site/page-registry.json +348 -21
  25. package/dist/site/public-surface-audit.json +396 -16
  26. package/dist/site/publication-authority-registry.json +106 -1
  27. package/dist/site/publication-registry.json +4 -4
  28. package/dist/site/release-provenance.json +7 -0
  29. package/dist/site/schemas/publication-rehearsal-capsule-v1.schema.json +269 -0
  30. package/dist/site/schemas/release-tail-capabilities-v1.schema.json +353 -0
  31. package/dist/site/schemas/release-tail-provider-bindings-v1.schema.json +94 -0
  32. package/dist/site/site-manifest.json +35 -11
  33. package/dist/site/workflow-registry.json +204 -10
  34. package/docs/MAP.md +6 -2
  35. package/docs/auditable-demo.md +2 -2
  36. package/docs/cli-reference.md +136 -0
  37. package/docs/dev-delivery-warrant.md +49 -4
  38. package/docs/engineering-housekeeper.md +138 -0
  39. package/docs/lifecycle-protocol.md +4 -2
  40. package/docs/node-api-reference.md +495 -281
  41. package/docs/publication-rehearsal.md +94 -0
  42. package/docs/release-governance.md +17 -2
  43. package/docs/release-tail-contract.md +160 -0
  44. package/docs/release-tail-provider-plane.md +120 -0
  45. package/docs/reusable-build-surface.md +11 -0
  46. package/package.json +11 -3
  47. package/packages/core/artifact-signing.js +61 -0
  48. package/packages/core/buildchain-agent-manuals.js +3 -0
  49. package/packages/core/buildchain-config.js +66 -6
  50. package/packages/core/buildchain-kfd-claims.js +1 -1
  51. package/packages/core/buildchain-publication-authority.js +5 -0
  52. package/packages/core/controller-evidence.js +2 -1
  53. package/packages/core/dev-delivery-warrant-cancellation.js +1 -0
  54. package/packages/core/dev-delivery-warrant-shadow.js +502 -0
  55. package/packages/core/dev-delivery-warrant.js +15 -6
  56. package/packages/core/diagnostics.js +8 -3
  57. package/packages/core/engineering-housekeeper-github-client.js +222 -0
  58. package/packages/core/engineering-housekeeper-github.js +501 -0
  59. package/packages/core/engineering-housekeeper.js +259 -0
  60. package/packages/core/index.js +42 -0
  61. package/packages/core/kfd-gate.js +45 -15
  62. package/packages/core/paper-agent-entry.js +11 -5
  63. package/packages/core/paper-repository.js +1 -0
  64. package/packages/core/paper-scaffold-content.js +21 -0
  65. package/packages/core/paper.js +28 -2
  66. package/packages/core/publication-rehearsal-projection.js +173 -0
  67. package/packages/core/publication-rehearsal-runtime.js +921 -0
  68. package/packages/core/release-passport.js +130 -20
  69. package/packages/core/release-tail-compatibility.js +60 -0
  70. package/packages/core/release-tail-provider-adapters.js +461 -0
  71. package/packages/core/release-tail-provider-plane.js +1228 -0
  72. package/scripts/assemble-publication-artifact-admission.mjs +1 -1
  73. package/scripts/assemble-self-publication-admission.mjs +2 -2
  74. package/scripts/audit-publication-control-plane.mjs +1 -1
  75. package/scripts/auditable-demo-bundle-verification.mjs +2 -3
  76. package/scripts/auditable-demo-platform.mjs +2 -2
  77. package/scripts/auditable-demo-renditions.mjs +1 -1
  78. package/scripts/auditable-demo.mjs +2 -2
  79. package/scripts/build-contract-core.mjs +8 -3
  80. package/scripts/build-standalone-binary.mjs +14 -3
  81. package/scripts/buildchain-cli-help.mjs +13 -0
  82. package/scripts/check-core-mechanism-inventory.mjs +347 -0
  83. package/scripts/check-inventory.mjs +10 -8
  84. package/scripts/check-maintainability.mjs +9 -2
  85. package/scripts/check-release-tail-contract.mjs +435 -0
  86. package/scripts/dev-delivery-warrant.mjs +31 -4
  87. package/scripts/dev-pr-auto-merge.mjs +30 -4
  88. package/scripts/dev-pr-delivery-warrant.mjs +50 -0
  89. package/scripts/engineering-housekeeper-workflow.mjs +394 -0
  90. package/scripts/generate-channel-promotion-workflow.mjs +10 -8
  91. package/scripts/generate-site-bundle.mjs +47 -4
  92. package/scripts/init-repo.mjs +26 -2
  93. package/scripts/inspect-artifact-signing-requests.mjs +6 -0
  94. package/scripts/materialize-self-release-candidate-version.mjs +137 -0
  95. package/scripts/publication-commit-evidence.mjs +69 -23
  96. package/scripts/release-candidate-resolver.mjs +16 -10
  97. package/scripts/release-tail.mjs +159 -0
  98. package/scripts/resume-from-candidate-run.mjs +123 -9
  99. package/scripts/seal-artifact-signing-requests.mjs +6 -0
  100. package/scripts/site-capability-metadata.mjs +13 -0
  101. package/scripts/v4-architecture.mjs +600 -0
  102. package/scripts/web-surface-core.mjs +8 -2
  103. package/scripts/workflow-call-contract.mjs +184 -5
package/dist/site/manual-registry.json CHANGED
@@ -9,7 +9,7 @@
9
9
  "title": "Buildchain documentation map",
10
10
  "path": "docs/MAP.md",
11
11
  "plane": "use",
12
- "digest": "sha256:d76416d8cd04dcdb560b7d06fef287fa22d6b186a729cb92cd4cf71cebbac1e9",
12
+ "digest": "sha256:08cfae94c78776694736e81142e2d64480fdc3e67341b415340c03d3539531e7",
13
13
  "capabilityGroup": "getting-started",
14
14
  "audience": [
15
15
  "agent",
@@ -37,7 +37,7 @@
37
37
  "title": "Auditable demo artifact pipeline",
38
38
  "path": "docs/auditable-demo.md",
39
39
  "plane": "verify",
40
- "digest": "sha256:c49e734fdfe3b74d317e23a523e198f1194b2c7cd16cca87e8e3a3ffc7bf589f",
40
+ "digest": "sha256:43989b951667f5dd3bf352209ffe551add4f83d5d551f960aeb787b2220aa665",
41
41
  "capabilityGroup": "reusable-build",
42
42
  "audience": [
43
43
  "consumer",
@@ -317,7 +317,7 @@
317
317
  "title": "Generated CLI reference",
318
318
  "path": "docs/cli-reference.md",
319
319
  "plane": "use",
320
- "digest": "sha256:2365e125d38e43b68a4af277a91be7aca708a8bf785954ed4589dbd9a5d8db97",
320
+ "digest": "sha256:3b203848db87e68762417e768eb8a09a7e653eb30fb7cc21354e72678706b714",
321
321
  "capabilityGroup": "api-cli-reference",
322
322
  "audience": [
323
323
  "agent",
@@ -332,7 +332,7 @@
332
332
  "title": "Generated Node API reference",
333
333
  "path": "docs/node-api-reference.md",
334
334
  "plane": "use",
335
- "digest": "sha256:f5592359584e98ab4283d56b0262fdcf9c5da61f48033cecad1b0404aa95bd2e",
335
+ "digest": "sha256:ed843753964193ecb59610a54f0f23d76578228ebe6d31d1d6edce526729910c",
336
336
  "capabilityGroup": "api-cli-reference",
337
337
  "audience": [
338
338
  "agent",
@@ -389,7 +389,7 @@
389
389
  "title": "Lifecycle protocol",
390
390
  "path": "docs/lifecycle-protocol.md",
391
391
  "plane": "use",
392
- "digest": "sha256:4b7a8efe1d22751ded069f46a23490db70cda9e9e14641acab600ab781245b19",
392
+ "digest": "sha256:9fdab92b63eae0085d460a4ec78511fbb63999a311cd7693c669705bd9897eb2",
393
393
  "capabilityGroup": "reusable-build",
394
394
  "audience": [
395
395
  "consumer",
@@ -403,7 +403,7 @@
403
403
  "title": "Reusable build surface",
404
404
  "path": "docs/reusable-build-surface.md",
405
405
  "plane": "use",
406
- "digest": "sha256:7bc04f658d7e298872756278c60143d8edf5dfb841d0b0d3ea62af8028735b54",
406
+ "digest": "sha256:4741dc7661d40e14df8203d88a709b9becb08edc4313f5ad308c7e80bf672085",
407
407
  "capabilityGroup": "reusable-build",
408
408
  "audience": [
409
409
  "consumer",
@@ -425,12 +425,57 @@
425
425
  "maturity": "stable",
426
426
  "order": 120
427
427
  },
428
+ {
429
+ "id": "release-tail-contract",
430
+ "title": "Declarative release-tail contract",
431
+ "path": "docs/release-tail-contract.md",
432
+ "plane": "verify",
433
+ "digest": "sha256:1cfd927f30d71a359397a7177048b298269a8e665e67237187eb817e5d196b41",
434
+ "capabilityGroup": "release-passport-trust",
435
+ "audience": [
436
+ "release-operator",
437
+ "agent",
438
+ "maintainer"
439
+ ],
440
+ "maturity": "draft",
441
+ "order": 122
442
+ },
443
+ {
444
+ "id": "release-tail-provider-plane",
445
+ "title": "Declarative release-tail provider plane",
446
+ "path": "docs/release-tail-provider-plane.md",
447
+ "plane": "use",
448
+ "digest": "sha256:12f291124f51520b4f64c21d7fb249e89928b607a30bc00ba81eb1fc5acea5bd",
449
+ "capabilityGroup": "release-passport-trust",
450
+ "audience": [
451
+ "release-operator",
452
+ "agent",
453
+ "maintainer"
454
+ ],
455
+ "maturity": "preview",
456
+ "order": 123
457
+ },
458
+ {
459
+ "id": "publication-rehearsal",
460
+ "title": "Publication rehearsal",
461
+ "path": "docs/publication-rehearsal.md",
462
+ "plane": "use",
463
+ "digest": "sha256:b71c8be4a73078adae6efa838eeded0bfafef90f1e3873aad65d116f2481ae09",
464
+ "capabilityGroup": "release-passport-trust",
465
+ "audience": [
466
+ "release-operator",
467
+ "agent",
468
+ "maintainer"
469
+ ],
470
+ "maturity": "preview",
471
+ "order": 124
472
+ },
428
473
  {
429
474
  "id": "release-governance",
430
475
  "title": "Release governance",
431
476
  "path": "docs/release-governance.md",
432
477
  "plane": "why",
433
- "digest": "sha256:34fb81d1dd9f913cbed6ee76ac9f0bdb095669e55c1bee67389601fd494470cf",
478
+ "digest": "sha256:b37d4de1f1cf9155c0e3f42c8c20a0280a263f50173eb0cad2c5f1961954822e",
434
479
  "capabilityGroup": "governance-versioning",
435
480
  "audience": [
436
481
  "maintainer",
@@ -507,6 +552,7 @@
507
552
  "docs/dev-qualification-patrol.md",
508
553
  "docs/dev-alpha-candidate-patrol.md",
509
554
  "docs/observed-evidence-patrol.md",
555
+ "docs/engineering-housekeeper.md",
510
556
  "docs/release-governance.md",
511
557
  "docs/release-passport.md",
512
558
  "docs/controller-evidence.md",