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

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/next-development-request-v1.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.libkungfu.dev/schemas/next-development-request-v1.schema.json",
+  "title": "Buildchain Next-development Request v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contract", "repository", "completedAlpha", "recordedAt"],
+  "properties": {
+    "contract": {
+      "const": "kungfu-buildchain-next-development-request/v1"
+    },
+    "repository": {
+      "type": "string",
+      "pattern": "^[^/\\s]+/[^/\\s]+$"
+    },
+    "completedAlpha": { "$ref": "#/$defs/completedAlpha" },
+    "targetVersion": { "$ref": "#/$defs/semver" },
+    "anchor": { "$ref": "#/$defs/anchor" },
+    "recordedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "gitSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+    "root": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "semver": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"
+    },
+    "completedAlpha": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "version",
+        "exactTag",
+        "releaseSha",
+        "treeSha",
+        "publicationRoot",
+        "completedAt"
+      ],
+      "properties": {
+        "outcome": { "const": "succeeded" },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)-alpha\\.(0|[1-9][0-9]*)$"
+        },
+        "exactTag": { "type": "string", "minLength": 1 },
+        "releaseSha": { "$ref": "#/$defs/gitSha" },
+        "treeSha": { "$ref": "#/$defs/gitSha" },
+        "publicationRoot": { "$ref": "#/$defs/root" },
+        "completedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "anchor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["manifestPath", "manifestRoot"],
+      "properties": {
+        "manifestPath": {
+          "type": "string",
+          "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\s]+$"
+        },
+        "manifestRoot": { "$ref": "#/$defs/root" }
+      }
+    }
+  }
+}

package/contracts/next-development-transition-v1.schema.json

@@ -0,0 +1,292 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.libkungfu.dev/schemas/next-development-transition-v1.schema.json",
+  "title": "Buildchain Next-development Transition v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "contract",
+    "idempotencyKey",
+    "repository",
+    "completedAlpha",
+    "completedAlphaRoot",
+    "alphaOutcome",
+    "model",
+    "target",
+    "declaredPaths",
+    "adapter",
+    "effectBounds",
+    "state",
+    "materialization",
+    "transitions"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "contract": {
+      "const": "kungfu-buildchain-next-development-transition/v1"
+    },
+    "idempotencyKey": { "$ref": "#/$defs/root" },
+    "repository": {
+      "type": "string",
+      "pattern": "^[^/\\s]+/[^/\\s]+$"
+    },
+    "completedAlpha": { "$ref": "#/$defs/completedAlpha" },
+    "completedAlphaRoot": { "$ref": "#/$defs/root" },
+    "alphaOutcome": { "const": "preserved-success" },
+    "model": { "$ref": "#/$defs/model" },
+    "target": { "$ref": "#/$defs/target" },
+    "declaredPaths": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/path" }
+    },
+    "adapter": { "$ref": "#/$defs/adapter" },
+    "effectBounds": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowedPaths", "refUpdates", "forbiddenRefNamespaces"],
+      "properties": {
+        "allowedPaths": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/path" }
+        },
+        "refUpdates": { "type": "array", "maxItems": 0 },
+        "forbiddenRefNamespaces": {
+          "const": ["refs/heads/alpha/", "refs/tags/"]
+        }
+      }
+    },
+    "state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "generation", "stateRoot"],
+      "properties": {
+        "status": { "$ref": "#/$defs/state" },
+        "generation": { "type": "integer", "minimum": 1 },
+        "stateRoot": { "$ref": "#/$defs/root" }
+      }
+    },
+    "materialization": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/materialization" }]
+    },
+    "transitions": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/transition" }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "state": {
+            "properties": {
+              "status": {
+                "enum": ["materialized", "pr-pending", "merged", "verified"]
+              }
+            }
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "materialization": { "$ref": "#/$defs/materialization" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "gitSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+    "root": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "semver": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"
+    },
+    "path": {
+      "type": "string",
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\s]+$"
+    },
+    "state": {
+      "enum": [
+        "planned",
+        "waiting-anchor",
+        "materialized",
+        "pr-pending",
+        "merged",
+        "verified"
+      ]
+    },
+    "completedAlpha": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "version",
+        "exactTag",
+        "releaseSha",
+        "treeSha",
+        "publicationRoot",
+        "completedAt"
+      ],
+      "properties": {
+        "outcome": { "const": "succeeded" },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)-alpha\\.(0|[1-9][0-9]*)$"
+        },
+        "exactTag": { "type": "string", "minLength": 1 },
+        "releaseSha": { "$ref": "#/$defs/gitSha" },
+        "treeSha": { "$ref": "#/$defs/gitSha" },
+        "publicationRoot": { "$ref": "#/$defs/root" },
+        "completedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "model": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["strategy", "next"],
+          "properties": {
+            "strategy": { "const": "semver" },
+            "next": { "const": "auto" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["strategy", "next"],
+          "properties": {
+            "strategy": { "const": "anchored" },
+            "next": { "const": "manual" }
+          }
+        }
+      ]
+    },
+    "adapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "environmentVariable",
+        "sourcePaths",
+        "derivedPaths",
+        "allowedChangePaths",
+        "readOnlyPaths",
+        "derivationStage",
+        "verificationStage"
+      ],
+      "properties": {
+        "environmentVariable": { "const": "BUILDCHAIN_VERSION" },
+        "sourcePaths": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/path" }
+        },
+        "derivedPaths": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/path" }
+        },
+        "allowedChangePaths": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/path" }
+        },
+        "readOnlyPaths": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/path" }
+        },
+        "derivationStage": {
+          "oneOf": [{ "type": "null" }, { "const": "lifecycle.version-state" }]
+        },
+        "verificationStage": { "const": "lifecycle.verify" }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "anchor"],
+      "properties": {
+        "version": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/semver" }]
+        },
+        "anchor": {
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["manifestPath", "manifestRoot"],
+              "properties": {
+                "manifestPath": { "$ref": "#/$defs/path" },
+                "manifestRoot": { "$ref": "#/$defs/root" }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "materialization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "targetVersion",
+        "anchorRoot",
+        "paths",
+        "materializationRoot"
+      ],
+      "properties": {
+        "targetVersion": { "$ref": "#/$defs/semver" },
+        "anchorRoot": {
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/root" }]
+        },
+        "paths": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "beforeRoot", "afterRoot", "changed"],
+            "properties": {
+              "path": { "$ref": "#/$defs/path" },
+              "beforeRoot": { "$ref": "#/$defs/root" },
+              "afterRoot": { "$ref": "#/$defs/root" },
+              "changed": { "type": "boolean" }
+            }
+          }
+        },
+        "materializationRoot": { "$ref": "#/$defs/root" }
+      }
+    },
+    "transition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "expectedStateRoot",
+        "from",
+        "to",
+        "event",
+        "evidenceRoot",
+        "recordedAt",
+        "requestRoot",
+        "transitionRoot"
+      ],
+      "properties": {
+        "expectedStateRoot": { "$ref": "#/$defs/root" },
+        "from": { "$ref": "#/$defs/state" },
+        "to": { "$ref": "#/$defs/state" },
+        "event": { "type": "string", "minLength": 1 },
+        "evidenceRoot": { "$ref": "#/$defs/root" },
+        "recordedAt": { "type": "string", "format": "date-time" },
+        "requestRoot": { "$ref": "#/$defs/root" },
+        "transitionRoot": { "$ref": "#/$defs/root" }
+      }
+    }
+  }
+}

package/dist/site/buildchain-contract.json

@@ -4,7 +4,7 @@
   "product": {
     "name": "Buildchain",
     "package": "@kungfu-tech/buildchain",
-    "version": "3.0.9-alpha.2",
+    "version": "3.0.9-alpha.3",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "majorLine": "v3",
@@ -1071,7 +1071,7 @@
         "manual entries carry source file digests so downstream sites and agents can detect stale hand-written documentation"
       ],
       "breakingDigest": "sha256:7d0d2819e3a3e72989d9c57b5efe9d0bc0a79bc0f2c82a0c7b9d6c5a211a91f2",
-      "auditDigest": "sha256:ee79f1dc576cef9003060e7c0498ddb10fd0a2660d2c58831ddc1fdd104b0792"
+      "auditDigest": "sha256:2ded8b4a4ffe678bbe413f83125f3a3fbe361f832cda583c134ddfc352173cd4"
     },
     {
       "contractVersion": 1,
@@ -1093,7 +1093,7 @@
         "agents can discover supported Node APIs without importing internal file paths"
       ],
       "breakingDigest": "sha256:48f925608d3e2131d90936b07dc2a30341204cae3e6e785c0f77d61ad755c945",
-      "auditDigest": "sha256:60c34924e258b72687367422f5d9afa890535a2e3e0b80a29d90551bab6ebfd9"
+      "auditDigest": "sha256:c45a569ad6f4bf1fe3a339845adb338f7b538a89f0c9b186823e7664ab0ce880"
     },
     {
       "contractVersion": 1,
@@ -4024,5 +4024,5 @@
   ],
   "compatibilityProofRegistryRoot": "sha256:f11b62ce69cfb0ff25b66861474b99a75148192c0474c9d1cc2067e347b05abd",
   "compatibilityDigest": "sha256:80f65cc191b1f771475184edf8a1bf9c10dd69bb58060aa09313d0e1e57f508a",
-  "contractDigest": "sha256:a67cf7f6bcfe9c0afb1969735a09d77225ad1252ff161fa156da8deaf5863a0e"
+  "contractDigest": "sha256:31527e77065b64d46fc36df119b388208cbc47c5915f6566759f34427f7ce118"
 }