@kungfu-tech/buildchain 3.0.9-alpha.9 → 4.0.0-alpha.1

package/contracts/fixtures/kfd-adopter-release-v1/kfd-4-replay.json

@@ -1,57 +0,0 @@
-{
-  "schemaVersion": 1,
-  "contract": "kfd-4-perspective-replay",
-  "standard": "kfd-4",
-  "replayId": "buildchain-release-product-contrast",
-  "mode": "contrastive",
-  "sourceViews": [
-    {
-      "id": "maintainer",
-      "kind": "observer-view",
-      "coordinate": "git://kungfu-systems/buildchain@{{SOURCE_SHA}}",
-      "observer": "buildchain-release-maintainer",
-      "perspective": "release-integrity",
-      "acceptedFactCut": "git://kungfu-systems/buildchain@{{SOURCE_SHA}}",
-      "naturalObjects": ["release"],
-      "consequences": ["published artifact"],
-      "knownGaps": []
-    },
-    {
-      "id": "consumer",
-      "kind": "observer-view",
-      "coordinate": "npm://@kungfu-tech/buildchain@{{SOURCE_SHA}}",
-      "observer": "buildchain-release-consumer",
-      "perspective": "artifact-consumption",
-      "acceptedFactCut": "artifact://published-package",
-      "naturalObjects": ["installed package"],
-      "consequences": ["local build execution"],
-      "knownGaps": ["consumer runtime state"]
-    }
-  ],
-  "replayObserver": {
-    "id": "buildchain",
-    "kind": "service",
-    "purpose": "retain source and artifact fact boundaries"
-  },
-  "reconstruction": {
-    "policyVersion": "1",
-    "sharedContext": "same source-bound release",
-    "preservedElements": ["observer", "accepted-fact-cut", "evidence-boundary"],
-    "declaredLoss": ["consumer runtime state"],
-    "degradedState": "none"
-  },
-  "contrast": {
-    "dimensions": ["evidence-boundary"],
-    "mismatches": [
-      {
-        "sourceViewIds": ["maintainer", "consumer"],
-        "observation": "source and installed artifact evidence have different custody",
-        "primitiveSignal": "inconclusive"
-      }
-    ]
-  },
-  "verification": {
-    "result": "pass",
-    "evidence": ["evidence/projection-fsck.json"]
-  }
-}

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

@@ -1,47 +0,0 @@
-{
-  "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

@@ -1,47 +0,0 @@
-{
-  "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

@@ -1,40 +0,0 @@
-{
-  "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

@@ -1,66 +0,0 @@
-{
-  "$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

@@ -1,292 +0,0 @@
-{
-  "$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" }
-      }
-    }
-  }
-}