@kungfu-tech/buildchain 4.0.1-alpha.5 → 4.0.1-alpha.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/actions/release-tail/README.md +8 -0
  2. package/architecture/internal-capabilities.json +65 -5
  3. package/architecture/maintainability-policy.json +22 -16
  4. package/architecture/release-tail-contract-inventory.json +5 -2
  5. package/architecture/v4-adopter-delivery-parity.json +32 -5
  6. package/architecture/v4-publication-rehearsal-parity.json +84 -0
  7. package/bin/buildchain.mjs +7 -1
  8. package/bin/internal/adopter-delivery-cli.mjs +70 -0
  9. package/bin/internal/command-registry.mjs +1 -0
  10. package/contracts/fixtures/v4-adopter-delivery-v1/archive-template.json +19 -0
  11. package/contracts/fixtures/v4-adopter-delivery-v1/bootstrap-positive.json +93 -0
  12. package/contracts/fixtures/v4-adopter-delivery-v1/gate-positive.json +29 -0
  13. package/contracts/fixtures/v4-adopter-delivery-v1/gate-unknown-selector.json +26 -0
  14. package/contracts/fixtures/v4-adopter-delivery-v1/offline-vectors.json +50 -0
  15. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/artifacts/product.bin +1 -0
  16. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/config/buildchain.toml +5 -0
  17. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/documents/release-activation.json +1 -0
  18. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/documents/signed-channel.json +1 -0
  19. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/evidence/qualification.json +1 -0
  20. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/manifests/candidate.json +5 -0
  21. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/manifests/release-passport.json +1 -0
  22. package/contracts/fixtures/v4-publication-rehearsal-v1/capsule.json +707 -0
  23. package/contracts/fixtures/v4-publication-rehearsal-v1/offline-vectors.json +27 -0
  24. package/contracts/v4-adopter-delivery-v1.schema.json +81 -0
  25. package/contracts/v4-publication-rehearsal-capsule-v1.schema.json +233 -0
  26. package/dist/site/agent-index.json +3 -0
  27. package/dist/site/artifact-schemas.json +6 -0
  28. package/dist/site/buildchain-contract.json +14 -14
  29. package/dist/site/buildchain-site.json +219 -22
  30. package/dist/site/capability-registry.json +10 -9
  31. package/dist/site/cli-registry.json +53 -1
  32. package/dist/site/kfd-claims.json +253 -14
  33. package/dist/site/kfd-upstream-aggregate.json +1 -1
  34. package/dist/site/manual-registry.json +20 -5
  35. package/dist/site/node-api-registry.json +11501 -9312
  36. package/dist/site/page-registry.json +202 -13
  37. package/dist/site/public-surface-audit.json +195 -11
  38. package/dist/site/publication-authority-registry.json +17 -4
  39. package/dist/site/publication-registry.json +4 -4
  40. package/dist/site/release-provenance.json +14 -0
  41. package/dist/site/schemas/release-tail-capabilities-v1.schema.json +199 -0
  42. package/dist/site/schemas/v4-adopter-delivery-v1.schema.json +81 -0
  43. package/dist/site/schemas/v4-publication-rehearsal-capsule-v1.schema.json +233 -0
  44. package/dist/site/site-manifest.json +17 -9
  45. package/dist/site/workflow-registry.json +89 -8
  46. package/docs/MAP.md +3 -1
  47. package/docs/cli-reference.md +68 -0
  48. package/docs/cli.md +8 -0
  49. package/docs/node-api-reference.md +198 -51
  50. package/docs/release-tail-provider-plane.md +30 -0
  51. package/docs/v4-adopter-delivery.md +133 -0
  52. package/docs/v4-publication-rehearsal.md +130 -0
  53. package/package.json +17 -3
  54. package/packages/core/adopter-delivery-passport.js +259 -0
  55. package/packages/core/adopter-delivery-vectors.js +158 -0
  56. package/packages/core/adopter-delivery-vectors.json +77 -0
  57. package/packages/core/buildchain-agent-manuals.js +1 -0
  58. package/packages/core/buildchain-config.js +84 -0
  59. package/packages/core/buildchain-delivery-bootstrap.js +240 -0
  60. package/packages/core/buildchain-delivery-infrastructure.js +164 -0
  61. package/packages/core/buildchain-delivery-self-dogfood.js +395 -0
  62. package/packages/core/legacy-kfd-adopter-driver.js +167 -0
  63. package/packages/core/published-delivery-authority.js +266 -0
  64. package/packages/core/release-passport.js +26 -8
  65. package/packages/core/v4-adopter-delivery-parity.js +3 -3
  66. package/packages/core/v4-adopter-delivery.js +359 -0
  67. package/packages/core/v4-publication-rehearsal-capsule.js +468 -0
  68. package/packages/core/v4-publication-rehearsal-provider-bindings.js +212 -0
  69. package/packages/core/v4-publication-rehearsal.js +481 -0
  70. package/scripts/buildchain-cli-help.mjs +10 -0
  71. package/scripts/check-inventory.mjs +3 -3
  72. package/scripts/dev-delivery-source-proof-replay.mjs +153 -0
  73. package/scripts/dev-delivery-source-proof-reuse.mjs +13 -97
  74. package/scripts/generate-release-candidate-passport.mjs +152 -0
  75. package/scripts/generate-site-bundle.mjs +30 -0
  76. package/scripts/release-tail.mjs +51 -3
  77. package/scripts/resume-from-candidate-run.mjs +545 -15
  78. package/scripts/site-capability-metadata.mjs +16 -0
  79. package/scripts/v4-publication-rehearsal-fixture.mjs +144 -0
package/docs/cli-reference.md CHANGED
@@ -22,6 +22,63 @@ ai_provenance:
22
22
 
23
23
  Every listed help command is intercepted before dispatch, exits zero, and performs no command side effects.
24
24
 
25
+ ## `adopter-delivery`
26
+
27
+ ### `buildchain adopter-delivery`
28
+
29
+ - Help: `buildchain adopter-delivery --help`
30
+ - Canonical id: `adopter-delivery`
31
+ - Options: none declared
32
+ - Syntax:
33
+
34
+ ```text
35
+ buildchain adopter-delivery
36
+ ```
37
+
38
+ ### `buildchain adopter-delivery archive`
39
+
40
+ - Help: `buildchain adopter-delivery archive --help`
41
+ - Canonical id: `adopter-delivery`
42
+ - Options: `--input`, `--output`
43
+ - Syntax:
44
+
45
+ ```text
46
+ buildchain adopter-delivery archive --input <json-or-path> [--output <path>]
47
+ ```
48
+
49
+ ### `buildchain adopter-delivery bootstrap`
50
+
51
+ - Help: `buildchain adopter-delivery bootstrap --help`
52
+ - Canonical id: `adopter-delivery`
53
+ - Options: `--input`, `--output`
54
+ - Syntax:
55
+
56
+ ```text
57
+ buildchain adopter-delivery bootstrap --input <json-or-path> [--output <path>]
58
+ ```
59
+
60
+ ### `buildchain adopter-delivery run`
61
+
62
+ - Help: `buildchain adopter-delivery run --help`
63
+ - Canonical id: `adopter-delivery`
64
+ - Options: `--input`, `--output`
65
+ - Syntax:
66
+
67
+ ```text
68
+ buildchain adopter-delivery run --input <json-or-path> [--output <path>]
69
+ ```
70
+
71
+ ### `buildchain adopter-delivery verify`
72
+
73
+ - Help: `buildchain adopter-delivery verify --help`
74
+ - Canonical id: `adopter-delivery`
75
+ - Options: `--input`, `--output`, `--readback`
76
+ - Syntax:
77
+
78
+ ```text
79
+ buildchain adopter-delivery verify --input <json-or-path> --readback <json-or-path> [--output <path>]
80
+ ```
81
+
25
82
  ## `architecture`
26
83
 
27
84
  ### `buildchain architecture`
@@ -2246,6 +2303,17 @@ buildchain release-tail init --declaration <json-or-path> [--state <path>]
2246
2303
  buildchain release-tail plan --declaration <json-or-path> [--output <path>]
2247
2304
  ```
2248
2305
 
2306
+ ### `buildchain release-tail rehearse`
2307
+
2308
+ - Help: `buildchain release-tail rehearse --help`
2309
+ - Canonical id: `release-tail`
2310
+ - Options: `--candidate-root`, `--capsule`, `--evidence`, `--mode`, `--state`
2311
+ - Syntax:
2312
+
2313
+ ```text
2314
+ buildchain release-tail rehearse --capsule <absolute-path> --candidate-root <absolute-path> --mode <simulate|replay> --state <absolute-path> --evidence <absolute-path>
2315
+ ```
2316
+
2249
2317
  ### `buildchain release-tail status`
2250
2318
 
2251
2319
  - Help: `buildchain release-tail status --help`
package/docs/cli.md CHANGED
@@ -1033,6 +1033,14 @@ The command validates `package.json`, infers the exact release tag
1033
1033
  `npm publish --dry-run --access public --tag <alpha|latest>` unless
1034
1034
  `--skip-npm-publish-dry-run` is passed. It never performs a real publish.
1035
1035
 
1036
+ ## V4 Adopter Delivery
1037
+
1038
+ `buildchain adopter-delivery` exposes the public v4 driver gate, exact
1039
+ readback, N-1 bootstrap lineage, and published archive loader. `run` emits a
1040
+ rooted non-authoritative readback, `verify` recomputes it, `bootstrap` binds the
1041
+ exact v3 authority and v4 base, and `archive` verifies public npm archive bytes
1042
+ and package identity. See [`v4-adopter-delivery.md`](v4-adopter-delivery.md).
1043
+
1036
1044
  ## npm Publish Gate
1037
1045
 
1038
1046
  Buildchain's own npm package is published from