@kungfu-tech/buildchain 4.0.1-alpha.2 → 4.0.1-alpha.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/architecture/decisions/0003-two-phase-delivery-warrant.md +152 -0
  2. package/architecture/internal-capabilities.json +94 -0
  3. package/architecture/maintainability-policy.json +75 -8
  4. package/architecture/v3-core-mechanism-inventory.json +2 -0
  5. package/architecture/v4-delivery-authority-parity.json +250 -0
  6. package/architecture/v4-delivery-warrant-shadow-fixtures.json +29 -6
  7. package/bin/buildchain.mjs +9 -1
  8. package/contracts/dev-delivery-authority-v2.schema.json +662 -0
  9. package/dist/site/agent-index.json +1 -0
  10. package/dist/site/artifact-schemas.json +2 -0
  11. package/dist/site/buildchain-contract.json +89 -6
  12. package/dist/site/buildchain-site.json +169 -18
  13. package/dist/site/capability-registry.json +2 -2
  14. package/dist/site/cli-registry.json +46 -2
  15. package/dist/site/kfd-claims.json +43 -9
  16. package/dist/site/kfd-upstream-aggregate.json +1 -1
  17. package/dist/site/manual-registry.json +3 -3
  18. package/dist/site/node-api-registry.json +1694 -165
  19. package/dist/site/page-registry.json +162 -11
  20. package/dist/site/public-surface-audit.json +367 -7
  21. package/dist/site/publication-registry.json +4 -4
  22. package/dist/site/release-provenance.json +2 -0
  23. package/dist/site/schemas/dev-delivery-authority-v2.schema.json +662 -0
  24. package/dist/site/site-manifest.json +7 -7
  25. package/dist/site/workflow-registry.json +22 -6
  26. package/docs/MAP.md +1 -0
  27. package/docs/cli-reference.md +211 -13
  28. package/docs/dev-delivery-qualification-landing-adr.md +251 -0
  29. package/docs/dev-delivery-warrant.md +326 -38
  30. package/docs/node-api-reference.md +113 -53
  31. package/package.json +5 -1
  32. package/packages/core/buildchain-contract.js +3 -2
  33. package/packages/core/dev-delivery-authority-candidate.js +270 -0
  34. package/packages/core/dev-delivery-authority-evidence.js +146 -0
  35. package/packages/core/dev-delivery-authority-landing.js +461 -0
  36. package/packages/core/dev-delivery-authority-observation.js +48 -0
  37. package/packages/core/dev-delivery-authority-qualification.js +591 -0
  38. package/packages/core/dev-delivery-authority-settlement.js +213 -0
  39. package/packages/core/dev-delivery-authority-state.js +583 -0
  40. package/packages/core/dev-delivery-candidate-identity.js +13 -0
  41. package/packages/core/dev-delivery-contract-surface.js +76 -0
  42. package/packages/core/dev-delivery-execution-failure.js +133 -0
  43. package/packages/core/dev-delivery-execution-transfer.js +572 -0
  44. package/packages/core/dev-delivery-landing-admission-core.js +119 -0
  45. package/packages/core/dev-delivery-landing-readback.js +598 -0
  46. package/packages/core/dev-delivery-landing-terminal-evidence.js +271 -0
  47. package/packages/core/dev-delivery-landing-testing-port.js +6 -0
  48. package/packages/core/dev-delivery-native-execution.js +110 -0
  49. package/packages/core/dev-delivery-native-proof.js +546 -0
  50. package/packages/core/dev-delivery-process-boundary.js +551 -0
  51. package/packages/core/dev-delivery-provider-attempt.js +127 -0
  52. package/packages/core/dev-delivery-provider-heartbeat.js +370 -0
  53. package/packages/core/dev-delivery-warrant-cancellation.js +1 -0
  54. package/packages/core/dev-delivery-warrant-qualification.js +145 -0
  55. package/packages/core/dev-delivery-warrant-settlement.js +237 -36
  56. package/packages/core/dev-delivery-warrant-state.js +565 -0
  57. package/packages/core/dev-delivery-warrant.js +320 -368
  58. package/scripts/buildchain-cli-help.mjs +11 -2
  59. package/scripts/dev-delivery-authority-command-adapters.mjs +206 -0
  60. package/scripts/dev-delivery-authority-provider.mjs +28 -0
  61. package/scripts/dev-delivery-authority.mjs +490 -0
  62. package/scripts/dev-delivery-native-run.mjs +177 -0
  63. package/scripts/dev-delivery-process-boundary.mjs +260 -0
  64. package/scripts/dev-delivery-proof.mjs +67 -2
  65. package/scripts/dev-delivery-provider-heartbeat.mjs +215 -0
  66. package/scripts/dev-delivery-two-phase-resume.mjs +345 -0
  67. package/scripts/dev-delivery-two-phase.mjs +573 -0
  68. package/scripts/dev-delivery-warrant-options.mjs +266 -0
  69. package/scripts/dev-delivery-warrant-store.mjs +227 -0
  70. package/scripts/dev-delivery-warrant.mjs +227 -193
  71. package/scripts/dev-pr-delivery-warrant.mjs +10 -0
  72. package/scripts/generate-site-bundle.mjs +26 -4
  73. package/scripts/npm-publish-transaction.mjs +2 -2
  74. package/scripts/site-capability-metadata.mjs +12 -0
  75. package/templates/native-dev-delivery.yml +141 -0
@@ -15,7 +15,7 @@
15
15
  "maturity": "stable",
16
16
  "counts": {
17
17
  "manualCount": 4,
18
- "pageCount": 14,
18
+ "pageCount": 15,
19
19
  "cliCommandCount": 9,
20
20
  "nodeApiCount": 0,
21
21
  "workflowCount": 0,
@@ -255,7 +255,7 @@
255
255
  "manualCount": 9,
256
256
  "pageCount": 15,
257
257
  "cliCommandCount": 12,
258
- "nodeApiCount": 10,
258
+ "nodeApiCount": 11,
259
259
  "workflowCount": 20,
260
260
  "actionCount": 0
261
261
  },
@@ -459,61 +459,105 @@
459
459
  "usage": "buildchain dev pr-admit --repository <owner/repo> --branch <dev/vN/vN.M>",
460
460
  "paths": [
461
461
  "dev",
462
+ "dev authority admit-merge-group",
463
+ "dev authority complete-qualification",
464
+ "dev authority heartbeat-landing",
465
+ "dev authority heartbeat-qualification",
466
+ "dev authority lease-landing",
467
+ "dev authority lease-qualification",
468
+ "dev authority migrate",
469
+ "dev authority observe",
470
+ "dev authority recover",
471
+ "dev authority settle",
472
+ "dev authority submit",
462
473
  "dev merge-queue",
463
474
  "dev pr-admit",
464
475
  "dev proof classify",
476
+ "dev proof classify-native",
465
477
  "dev proof integration",
478
+ "dev proof native",
466
479
  "dev proof replay",
467
480
  "dev proof source",
468
481
  "dev proof verify-integration",
482
+ "dev proof verify-native",
483
+ "dev proof verify-native-reuse",
469
484
  "dev proof verify-source",
485
+ "dev two-phase",
470
486
  "dev warrant cancel-queued",
471
487
  "dev warrant close",
472
488
  "dev warrant heartbeat",
473
489
  "dev warrant observe",
490
+ "dev warrant qualify",
474
491
  "dev warrant recover",
475
492
  "dev warrant select",
493
+ "dev warrant settle",
476
494
  "dev warrant submit"
477
495
  ],
478
496
  "syntaxes": [
479
497
  "buildchain dev",
498
+ "buildchain dev authority <migrate|submit|lease-qualification|heartbeat-qualification|complete-qualification|lease-landing|heartbeat-landing|recover|admit-merge-group|settle|observe> --repository <owner/repo> --branch <dev/vN/vN.M> [--environment-root <root>] [--qualification-domains <json>] [--provider-attempt <admitted-attempt.json>] [--execute] [--output <file>] [--json]",
480
499
  "buildchain dev merge-queue --repository <owner/repo> --branch <dev/vN/vN.M> [--from-config | --workflow <required-workflow.yml>...] [--cwd <dir>] [--check-response-timeout-minutes <n>] [--max-entries-to-build <n>] [--apply]",
481
500
  "buildchain dev pr-admit --repository <owner/repo> --branch <dev/vN/vN.M> --pull-request <n> --expected-head <sha> [--execute] [--output <file>] [--json]",
482
- "buildchain dev proof <source|verify-source|classify|replay|integration|verify-integration> [--output <file>] [--json]",
483
- "buildchain dev warrant <submit|select|heartbeat|recover|close|cancel-queued|observe> --repository <owner/repo> --branch <dev/vN/vN.M> [--execute] [--output <file>] [--json]"
501
+ "buildchain dev proof <source|verify-source|classify|native|verify-native|classify-native|verify-native-reuse|replay|integration|verify-integration> [--output <file>] [--json]",
502
+ "buildchain dev two-phase --repository <owner/repo> --branch <dev/vN/vN.M> --pull-request <n> --expected-head <sha> --warrant-result <file> --native-command <command> [--native-proof <file>] [--output <file>] [--json]",
503
+ "buildchain dev warrant <submit|select|heartbeat|qualify|recover|close|settle|cancel-queued|observe> --repository <owner/repo> --branch <dev/vN/vN.M> [--execute] [--output <file>] [--json]"
484
504
  ],
485
505
  "options": [
486
506
  "--apply",
487
507
  "--branch",
488
508
  "--check-response-timeout-minutes",
489
509
  "--cwd",
510
+ "--environment-root",
490
511
  "--execute",
491
512
  "--expected-head",
492
513
  "--from-config",
493
514
  "--json",
494
515
  "--max-entries-to-build",
516
+ "--native-command",
517
+ "--native-proof",
495
518
  "--output",
519
+ "--provider-attempt",
496
520
  "--pull-request",
521
+ "--qualification-domains",
497
522
  "--repository",
523
+ "--warrant-result",
498
524
  "--workflow"
499
525
  ],
500
526
  "aliases": [],
501
527
  "helpCommands": [
502
528
  "buildchain dev --help",
529
+ "buildchain dev authority admit-merge-group --help",
530
+ "buildchain dev authority complete-qualification --help",
531
+ "buildchain dev authority heartbeat-landing --help",
532
+ "buildchain dev authority heartbeat-qualification --help",
533
+ "buildchain dev authority lease-landing --help",
534
+ "buildchain dev authority lease-qualification --help",
535
+ "buildchain dev authority migrate --help",
536
+ "buildchain dev authority observe --help",
537
+ "buildchain dev authority recover --help",
538
+ "buildchain dev authority settle --help",
539
+ "buildchain dev authority submit --help",
503
540
  "buildchain dev merge-queue --help",
504
541
  "buildchain dev pr-admit --help",
505
542
  "buildchain dev proof classify --help",
543
+ "buildchain dev proof classify-native --help",
506
544
  "buildchain dev proof integration --help",
545
+ "buildchain dev proof native --help",
507
546
  "buildchain dev proof replay --help",
508
547
  "buildchain dev proof source --help",
509
548
  "buildchain dev proof verify-integration --help",
549
+ "buildchain dev proof verify-native --help",
550
+ "buildchain dev proof verify-native-reuse --help",
510
551
  "buildchain dev proof verify-source --help",
552
+ "buildchain dev two-phase --help",
511
553
  "buildchain dev warrant cancel-queued --help",
512
554
  "buildchain dev warrant close --help",
513
555
  "buildchain dev warrant heartbeat --help",
514
556
  "buildchain dev warrant observe --help",
557
+ "buildchain dev warrant qualify --help",
515
558
  "buildchain dev warrant recover --help",
516
559
  "buildchain dev warrant select --help",
560
+ "buildchain dev warrant settle --help",
517
561
  "buildchain dev warrant submit --help"
518
562
  ],
519
563
  "purpose": "Inspect protected development-channel governance command families.",
@@ -14,20 +14,20 @@
14
14
  },
15
15
  "runtimeContract": {
16
16
  "contract": "kungfu-buildchain-runtime-contract-world",
17
- "compatibilityDigest": "sha256:7234ed200c568b1fea0e469de61ec7a67da48ede0af6290fb49b93a9e62e0b65",
17
+ "compatibilityDigest": "sha256:c8407195cafe42cb62ac2a4f5ff5b2c3f9b8aa65c27cc678efd46240cb3f0ecc",
18
18
  "majorLine": "v4"
19
19
  },
20
20
  "publicSurfaceReverseAudit": {
21
21
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
22
22
  "path": "dist/site/public-surface-audit.json",
23
23
  "status": "passed",
24
- "sha256": "7fd7a202bd4b653265adb3ac4ac149816a74eb3b7aa1c637ca94f08965340418",
24
+ "sha256": "b923b56ff204e56808dbb5a2f6f3647803fdc55d2968a2c09cbad13d532188e7",
25
25
  "summary": {
26
26
  "cliCommandCount": 114,
27
27
  "workflowCount": 71,
28
28
  "actionCount": 7,
29
- "sitePageCount": 76,
30
- "docCommandRefCount": 919,
29
+ "sitePageCount": 77,
30
+ "docCommandRefCount": 987,
31
31
  "failureCount": 0
32
32
  },
33
33
  "auditBoundary": {
@@ -246,13 +246,13 @@
246
246
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
247
247
  "path": "dist/site/public-surface-audit.json",
248
248
  "status": "passed",
249
- "sha256": "7fd7a202bd4b653265adb3ac4ac149816a74eb3b7aa1c637ca94f08965340418",
249
+ "sha256": "b923b56ff204e56808dbb5a2f6f3647803fdc55d2968a2c09cbad13d532188e7",
250
250
  "summary": {
251
251
  "cliCommandCount": 114,
252
252
  "workflowCount": 71,
253
253
  "actionCount": 7,
254
- "sitePageCount": 76,
255
- "docCommandRefCount": 919,
254
+ "sitePageCount": 77,
255
+ "docCommandRefCount": 987,
256
256
  "failureCount": 0
257
257
  },
258
258
  "auditBoundary": {
@@ -1400,6 +1400,18 @@
1400
1400
  "public": true,
1401
1401
  "packageExport": "./diagnostics"
1402
1402
  },
1403
+ {
1404
+ "id": "export:./dev-delivery-authority",
1405
+ "name": "@kungfu-tech/buildchain/dev-delivery-authority",
1406
+ "kind": "package-export",
1407
+ "sourcePath": "packages/core/dev-delivery-authority-landing.js",
1408
+ "evidencePath": "packages/core/dev-delivery-authority-landing.js",
1409
+ "availability": "shipped",
1410
+ "visibility": "public",
1411
+ "participantFacing": true,
1412
+ "public": true,
1413
+ "packageExport": "./dev-delivery-authority"
1414
+ },
1403
1415
  {
1404
1416
  "id": "export:./dev-delivery-warrant",
1405
1417
  "name": "@kungfu-tech/buildchain/dev-delivery-warrant",
@@ -4728,7 +4740,7 @@
4728
4740
  "visibility": "public",
4729
4741
  "participantFacing": true,
4730
4742
  "public": true,
4731
- "inputCount": 33,
4743
+ "inputCount": 43,
4732
4744
  "inputs": [
4733
4745
  "active-lease-context",
4734
4746
  "affected-paths-json",
@@ -4744,22 +4756,32 @@
4744
4756
  "dependency-root",
4745
4757
  "diagnostic-context",
4746
4758
  "dry-run",
4759
+ "environment-root",
4747
4760
  "expected-head-sha",
4748
4761
  "expected-pr-number",
4762
+ "handoff-workflow-id",
4749
4763
  "initiative-root",
4750
4764
  "landing-mode",
4765
+ "legacy-active-owner-binding-json",
4751
4766
  "max-merges",
4752
4767
  "merge-method",
4768
+ "native-command",
4769
+ "native-command-root",
4770
+ "native-heartbeat-seconds",
4771
+ "native-proof-json",
4753
4772
  "plan-root",
4754
4773
  "project-cut-proof-json",
4755
4774
  "queue-admission-context",
4756
4775
  "ready-label",
4776
+ "release-blocker-priority-json",
4757
4777
  "require-approval",
4758
4778
  "required-status-checks",
4759
4779
  "same-repository-only",
4760
4780
  "shard-evidence-roots-json",
4761
4781
  "source-identity-root",
4762
4782
  "source-patch-root",
4783
+ "source-workflow-id",
4784
+ "source-workflow-run-id",
4763
4785
  "target-branch",
4764
4786
  "toolchain-root",
4765
4787
  "warrant-lease-seconds"
@@ -6140,6 +6162,18 @@
6140
6162
  "public": true,
6141
6163
  "reverseAuditSource": "dist/site/page-registry.json"
6142
6164
  },
6165
+ {
6166
+ "id": "site-page:manual:dev-delivery-qualification-landing-adr",
6167
+ "name": "site-page:manual:dev-delivery-qualification-landing-adr",
6168
+ "kind": "site-page",
6169
+ "sourcePath": "dist/site/page-registry.json",
6170
+ "evidencePath": "dist/site/page-registry.json",
6171
+ "availability": "shipped",
6172
+ "visibility": "public",
6173
+ "participantFacing": true,
6174
+ "public": true,
6175
+ "reverseAuditSource": "dist/site/page-registry.json"
6176
+ },
6143
6177
  {
6144
6178
  "id": "site-page:manual:dev-delivery-warrant",
6145
6179
  "name": "site-page:manual:dev-delivery-warrant",
@@ -6863,6 +6897,6 @@
6863
6897
  }
6864
6898
  }
6865
6899
  ],
6866
- "publicSurfaceCount": 436
6900
+ "publicSurfaceCount": 438
6867
6901
  }
6868
6902
  }
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "id": "kungfu-tech-buildchain",
6
6
  "name": "@kungfu-tech/buildchain",
7
- "version": "4.0.1-alpha.2",
7
+ "version": "4.0.1-alpha.3",
8
8
  "repository": "https://github.com/kungfu-systems/buildchain"
9
9
  },
10
10
  "source": {
@@ -9,7 +9,7 @@
9
9
  "title": "Buildchain documentation map",
10
10
  "path": "docs/MAP.md",
11
11
  "plane": "use",
12
- "digest": "sha256:c6be6076530f21d1a81f4f3d64f7aa2a9e5e8fb35a02f79a895814a85cad4838",
12
+ "digest": "sha256:16120e34c1a178b00309887d7903c2c8acb95815326091cf46a608d375435b99",
13
13
  "capabilityGroup": "getting-started",
14
14
  "audience": [
15
15
  "agent",
@@ -332,7 +332,7 @@
332
332
  "title": "Generated CLI reference",
333
333
  "path": "docs/cli-reference.md",
334
334
  "plane": "use",
335
- "digest": "sha256:0aa0c937ca4f3f239f67c10a3e656ca0934cd3618bf84639525ea1fbd685c055",
335
+ "digest": "sha256:82b5d7afa63fc4cfa29ffb813f1830b30eeee3d9b0da821f77240a9ddb25584e",
336
336
  "capabilityGroup": "api-cli-reference",
337
337
  "audience": [
338
338
  "agent",
@@ -347,7 +347,7 @@
347
347
  "title": "Generated Node API reference",
348
348
  "path": "docs/node-api-reference.md",
349
349
  "plane": "use",
350
- "digest": "sha256:1771331eea141e17dc27d19ccd6ccdf2d3a7d2ecdb98fb9e0d0d563b1e61b438",
350
+ "digest": "sha256:8f0c42d4453003d9bff861392c890f557a54608662e1cc380ed9aaa6635df016",
351
351
  "capabilityGroup": "api-cli-reference",
352
352
  "audience": [
353
353
  "agent",