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

package/contracts/fixtures/next-development-transition-v1/anchored-manual-waiting.json

@@ -0,0 +1,47 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-next-development-transition/v1",
+  "idempotencyKey": "sha256:cf805c1933cbc3e571c21af3ae030139bebafb08e2436b3c479c411b2cd2d22c",
+  "repository": "example/widget",
+  "completedAlpha": {
+    "outcome": "succeeded",
+    "version": "1.4.2-alpha.7",
+    "exactTag": "v1.4.2-alpha.7",
+    "releaseSha": "1111111111111111111111111111111111111111",
+    "treeSha": "2222222222222222222222222222222222222222",
+    "publicationRoot": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "completedAt": "2026-08-11T01:00:00.000Z"
+  },
+  "completedAlphaRoot": "sha256:18e65c63aba0df789e0b0e68903733825d87e292b82bcb8fd3793ca45dca6266",
+  "alphaOutcome": "preserved-success",
+  "model": {
+    "strategy": "anchored",
+    "next": "manual"
+  },
+  "target": {
+    "version": null,
+    "anchor": null
+  },
+  "declaredPaths": ["package.json", "release.json"],
+  "adapter": {
+    "environmentVariable": "BUILDCHAIN_VERSION",
+    "sourcePaths": ["package.json"],
+    "derivedPaths": [],
+    "allowedChangePaths": ["package.json"],
+    "readOnlyPaths": ["release.json"],
+    "derivationStage": null,
+    "verificationStage": "lifecycle.verify"
+  },
+  "effectBounds": {
+    "allowedPaths": ["package.json"],
+    "refUpdates": [],
+    "forbiddenRefNamespaces": ["refs/heads/alpha/", "refs/tags/"]
+  },
+  "state": {
+    "status": "waiting-anchor",
+    "generation": 1,
+    "stateRoot": "sha256:4bbca86f960a7c1a10d76d01736422e3129f3f16d3e69e0800a0829201122dd4"
+  },
+  "materialization": null,
+  "transitions": []
+}

package/contracts/fixtures/next-development-transition-v1/semver-auto-planned.json

@@ -0,0 +1,47 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-next-development-transition/v1",
+  "idempotencyKey": "sha256:37ee52799584a989b059db060b7ce062feb56fbeff452033245046fdf3b21e78",
+  "repository": "example/widget",
+  "completedAlpha": {
+    "outcome": "succeeded",
+    "version": "1.4.2-alpha.7",
+    "exactTag": "v1.4.2-alpha.7",
+    "releaseSha": "1111111111111111111111111111111111111111",
+    "treeSha": "2222222222222222222222222222222222222222",
+    "publicationRoot": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "completedAt": "2026-08-11T01:00:00.000Z"
+  },
+  "completedAlphaRoot": "sha256:18e65c63aba0df789e0b0e68903733825d87e292b82bcb8fd3793ca45dca6266",
+  "alphaOutcome": "preserved-success",
+  "model": {
+    "strategy": "semver",
+    "next": "auto"
+  },
+  "target": {
+    "version": "1.4.2-alpha.8",
+    "anchor": null
+  },
+  "declaredPaths": ["package.json"],
+  "adapter": {
+    "environmentVariable": "BUILDCHAIN_VERSION",
+    "sourcePaths": ["package.json"],
+    "derivedPaths": [],
+    "allowedChangePaths": ["package.json"],
+    "readOnlyPaths": [],
+    "derivationStage": null,
+    "verificationStage": "lifecycle.verify"
+  },
+  "effectBounds": {
+    "allowedPaths": ["package.json"],
+    "refUpdates": [],
+    "forbiddenRefNamespaces": ["refs/heads/alpha/", "refs/tags/"]
+  },
+  "state": {
+    "status": "planned",
+    "generation": 1,
+    "stateRoot": "sha256:4ef8ac1ff07cb14633994625e65a340acb3130ae56bbc88ee81504f09df3fa0f"
+  },
+  "materialization": null,
+  "transitions": []
+}

package/contracts/fixtures/next-development-transition-v1/version-model-cases.json

@@ -0,0 +1,40 @@
+{
+  "contract": "kungfu-buildchain-next-development-version-model-fixtures/v1",
+  "positive": [
+    {
+      "name": "semver-auto",
+      "model": { "strategy": "semver", "next": "auto" }
+    },
+    {
+      "name": "anchored-manual",
+      "model": { "strategy": "anchored", "next": "manual" }
+    }
+  ],
+  "negative": [
+    {
+      "name": "semver-manual",
+      "model": { "strategy": "semver", "next": "manual" },
+      "error": "version model must be semver/auto or anchored/manual"
+    },
+    {
+      "name": "anchored-auto",
+      "model": { "strategy": "anchored", "next": "auto" },
+      "error": "version model must be semver/auto or anchored/manual"
+    },
+    {
+      "name": "semver-auto-with-anchor",
+      "model": { "strategy": "semver", "next": "auto" },
+      "anchor": {
+        "manifestPath": "release.json",
+        "manifestRoot": "sha256:4444444444444444444444444444444444444444444444444444444444444444"
+      },
+      "error": "semver/auto must not declare an anchor"
+    },
+    {
+      "name": "anchored-manual-target-without-anchor",
+      "model": { "strategy": "anchored", "next": "manual" },
+      "targetVersion": "22.1.0",
+      "error": "anchored/manual targetVersion requires an anchor"
+    }
+  ]
+}

package/contracts/fixtures/v4-adopter-delivery-v1/archive-template.json

@@ -0,0 +1,19 @@
+{
+  "packages": {
+    "buildchain": {
+      "name": "@kungfu-tech/buildchain",
+      "version": "3.0.9-alpha.16",
+      "archivePath": ".buildchain/adopter-delivery-archives/kungfu-tech-buildchain-3.0.9-alpha.16.tgz",
+      "archiveRoot": "sha256:3f425e2c77d11f0bee8eb9aa2448566bca7a9d14672a7e528ced3e505b3f14a3",
+      "artifactRoot": "sha256:3f425e2c77d11f0bee8eb9aa2448566bca7a9d14672a7e528ced3e505b3f14a3"
+    },
+    "kfd": {
+      "name": "@kungfu-tech/kfd",
+      "version": "1.0.0-alpha.65",
+      "archivePath": ".buildchain/adopter-delivery-archives/kungfu-tech-kfd-1.0.0-alpha.65.tgz",
+      "archiveRoot": "sha256:c4dbd3f954910236d7f0823ea6887f4151e43b871df526ccdd599123421bced2",
+      "artifactRoot": "sha256:c0781bcaf191a58561ae32ee2fbedabbb48ed50b5725c356fbd83704089637f8"
+    }
+  },
+  "expectedAuthorityRoot": "sha256:9ba0cc6042b189ce749d01003617b57bcd03ea6ecf40e96d19e8ecbbfa347134"
+}

package/contracts/fixtures/v4-adopter-delivery-v1/bootstrap-positive.json

@@ -0,0 +1,93 @@
+{
+  "input": {
+    "authority": {
+      "version": "3.0.9-alpha.16",
+      "sourceCommit": "6b96bdad8d9f8ccf9275f27d9370a226a9c78465",
+      "packageRoot": "sha256:3f425e2c77d11f0bee8eb9aa2448566bca7a9d14672a7e528ced3e505b3f14a3",
+      "gateRoot": "sha256:cdcb54ea103fe62a94e2f0755fab5b105802f32e569f47e77d7a1f3ff0636cfc",
+      "protocol": {
+        "id": "buildchain.adopter/json-assertion",
+        "version": "1.0.0",
+        "root": "sha256:bcc9fc43402c50e11c68dfec5bba63ecc5b10f2f304921dec2ba95b44c43ad13"
+      },
+      "profile": {
+        "id": "buildchain.adopter/delivery-infrastructure",
+        "version": "1.0.0",
+        "root": "sha256:94dc2f34f76be8f4627fb84b753ad855492555111b37cbf3edcee68e2f30e126"
+      },
+      "protected": true,
+      "published": true
+    },
+    "candidate": {
+      "version": "4.0.1-alpha.4",
+      "sourceCommit": "e0342713c7447960c13bd73377282b2e93f4853d",
+      "packageRoot": "sha256:ca25e78191aedb60e999a12100b52caa2b075e29a46f0baa91722f018adb6609",
+      "gateRoot": "sha256:cdcb54ea103fe62a94e2f0755fab5b105802f32e569f47e77d7a1f3ff0636cfc",
+      "protocol": {
+        "id": "buildchain.adopter/json-assertion",
+        "version": "1.0.0",
+        "root": "sha256:bcc9fc43402c50e11c68dfec5bba63ecc5b10f2f304921dec2ba95b44c43ad13"
+      },
+      "profile": {
+        "id": "buildchain.adopter/delivery-infrastructure",
+        "version": "1.0.0",
+        "root": "sha256:94dc2f34f76be8f4627fb84b753ad855492555111b37cbf3edcee68e2f30e126"
+      },
+      "authorityVersion": "3.0.9-alpha.16"
+    },
+    "gateResult": {
+      "schemaVersion": 1,
+      "contract": "kungfu-buildchain-adopter-delivery-result",
+      "status": "passed",
+      "qualifying": false,
+      "selfCertified": false,
+      "project": {
+        "instanceId": "kungfu-systems/buildchain@4.0.1-alpha.4",
+        "adopterId": "kungfu-systems/buildchain"
+      },
+      "artifact": {
+        "kind": "package",
+        "coordinate": "@kungfu-tech/buildchain@4.0.1-alpha.4",
+        "root": "sha256:ca25e78191aedb60e999a12100b52caa2b075e29a46f0baa91722f018adb6609"
+      },
+      "protocol": {
+        "id": "buildchain.adopter/json-assertion",
+        "version": "1.0.0",
+        "loaded": true,
+        "reportRoot": "sha256:01b903f7315a51d0d26d8759194a82d7d45d0d05ad10480dbb6ebf7398445d5c"
+      },
+      "artifactProfile": {
+        "id": "buildchain.artifact/package",
+        "version": "1.0.0",
+        "loaded": true,
+        "valid": true
+      },
+      "semanticReport": {
+        "valid": true,
+        "qualifying": false,
+        "selfCertified": false,
+        "releaseAuthorized": false
+      },
+      "nonClaims": [
+        "A passing delivery gate does not grant runtime permission, release authorization, or independent certification.",
+        "Protocol semantics remain owned by the selected protocol driver and its published authority."
+      ],
+      "issues": [],
+      "gateRoot": "sha256:8f74b438d1b581c02704d3ff677b2be4dcb5a6d0dc4d9435ef42a368ff834ceb"
+    },
+    "warrant": {
+      "outcome": "merged",
+      "sourceHead": "e0342713c7447960c13bd73377282b2e93f4853d",
+      "sourceProofRoot": "sha256:2aeeaacaa4f2d136155ac2c478a7939772a162c284a3bfd0458dfb00cce872aa",
+      "nativeProofRoot": "sha256:d66669fff994b931c9f89f3c313f37ad625f5aae29af0f6528054b8782b607a5",
+      "integrationProofRoot": "sha256:e5623b4de65781d68a73401857d000fba970bdad62a94b5cd7b2d39fee176613"
+    }
+  },
+  "lineage": {
+    "schemaVersion": 1,
+    "contract": "kungfu-buildchain-v4-adopter-delivery-bootstrap-lineage/v1",
+    "sourceAuthorityCommit": "6b96bdad8d9f8ccf9275f27d9370a226a9c78465",
+    "targetBaseCommit": "e0342713c7447960c13bd73377282b2e93f4853d",
+    "authorityArchiveRoot": "sha256:3f425e2c77d11f0bee8eb9aa2448566bca7a9d14672a7e528ced3e505b3f14a3"
+  }
+}

package/contracts/fixtures/v4-adopter-delivery-v1/gate-positive.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-v4-adopter-delivery/v1",
+  "driverSelector": "json-assertion",
+  "artifactProfileSelector": "git-commit",
+  "request": {
+    "schemaVersion": 1,
+    "contract": "kungfu-buildchain-adopter-delivery-request",
+    "protocol": {
+      "id": "buildchain.adopter/json-assertion",
+      "version": "1.0.0"
+    },
+    "artifactProfile": {
+      "id": "buildchain.artifact/git-commit",
+      "version": "1.0.0"
+    },
+    "project": {
+      "instanceId": "example.org/adopter@1.0.0",
+      "adopterId": "example.org/adopter"
+    },
+    "artifact": {
+      "kind": "git-commit",
+      "coordinate": "example.org/adopter@1111111111111111111111111111111111111111",
+      "root": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+    },
+    "declaration": { "valid": true }
+  },
+  "context": {}
+}

package/contracts/fixtures/v4-adopter-delivery-v1/gate-unknown-selector.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-v4-adopter-delivery/v1",
+  "driverSelector": "private-buildchain-driver",
+  "artifactProfileSelector": "git-commit",
+  "request": {
+    "schemaVersion": 1,
+    "contract": "kungfu-buildchain-adopter-delivery-request",
+    "protocol": { "id": "private.buildchain/driver", "version": "1.0.0" },
+    "artifactProfile": {
+      "id": "buildchain.artifact/git-commit",
+      "version": "1.0.0"
+    },
+    "project": {
+      "instanceId": "example.org/adopter@1.0.0",
+      "adopterId": "example.org/adopter"
+    },
+    "artifact": {
+      "kind": "git-commit",
+      "coordinate": "example.org/adopter@1111111111111111111111111111111111111111",
+      "root": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+    },
+    "declaration": { "valid": true }
+  },
+  "context": {}
+}

package/contracts/fixtures/v4-adopter-delivery-v1/offline-vectors.json

@@ -0,0 +1,50 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-v4-adopter-delivery-offline-vectors/v1",
+  "sourceAuthority": {
+    "branch": "dev/v3/v3.0",
+    "commit": "6b96bdad8d9f8ccf9275f27d9370a226a9c78465",
+    "vectorSuiteRoot": "sha256:c978707556406ffda4ef4192032332c01c2da1cebb6ad8c4f0edfc65d5cef0c7"
+  },
+  "initialTargetBase": "e5611377efc03178f8687d99968cfdfa3ce2825b",
+  "targetBase": "e0342713c7447960c13bd73377282b2e93f4853d",
+  "cases": [
+    {
+      "id": "positive-public-driver",
+      "class": "positive",
+      "expected": "passed"
+    },
+    {
+      "id": "positive-n-minus-one-bootstrap",
+      "class": "positive",
+      "expected": "passed"
+    },
+    {
+      "id": "positive-published-archive",
+      "class": "positive",
+      "expected": "loaded"
+    },
+    {
+      "id": "negative-selector",
+      "class": "negative",
+      "expected": "fail-closed"
+    },
+    { "id": "negative-driver", "class": "negative", "expected": "fail-closed" },
+    {
+      "id": "negative-archive-identity",
+      "class": "negative",
+      "expected": "fail-closed"
+    },
+    {
+      "id": "negative-bootstrap-lineage",
+      "class": "negative",
+      "expected": "fail-closed"
+    },
+    {
+      "id": "negative-protocol-version",
+      "class": "negative",
+      "expected": "fail-closed"
+    },
+    { "id": "tamper-readback", "class": "tamper", "expected": "fail-closed" }
+  ]
+}