@kungfu-tech/buildchain 3.0.6 → 3.0.7-alpha.1

package/dist/site/kfd-claims.json

@@ -21,13 +21,13 @@
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "e37f94305762bde4ecad076297dedd212f015f12ffc5c0a524f1350969ad00d1",
+    "sha256": "03245581cd122f257e5effc9a87571c0941a2e597cd4fe35ed9d9eaf3c1cda8a",
     "summary": {
-      "cliCommandCount": 112,
-      "workflowCount": 64,
-      "actionCount": 6,
-      "sitePageCount": 65,
-      "docCommandRefCount": 881,
+      "cliCommandCount": 114,
+      "workflowCount": 69,
+      "actionCount": 7,
+      "sitePageCount": 70,
+      "docCommandRefCount": 924,
       "failureCount": 0
     },
     "auditBoundary": {
@@ -246,13 +246,13 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "e37f94305762bde4ecad076297dedd212f015f12ffc5c0a524f1350969ad00d1",
+      "sha256": "03245581cd122f257e5effc9a87571c0941a2e597cd4fe35ed9d9eaf3c1cda8a",
       "summary": {
-        "cliCommandCount": 112,
-        "workflowCount": 64,
-        "actionCount": 6,
-        "sitePageCount": 65,
-        "docCommandRefCount": 881,
+        "cliCommandCount": 114,
+        "workflowCount": 69,
+        "actionCount": 7,
+        "sitePageCount": 70,
+        "docCommandRefCount": 924,
         "failureCount": 0
       },
       "auditBoundary": {
@@ -332,6 +332,18 @@
           "public": true,
           "plane": "action"
         },
+        {
+          "id": "doc:actions/release-tail/README.md",
+          "name": "actions/release-tail/README.md",
+          "kind": "documentation",
+          "sourcePath": "actions/release-tail/README.md",
+          "evidencePath": "actions/release-tail/README.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "action"
+        },
         {
           "id": "doc:actions/report-buildchain-issue/README.md",
           "name": "actions/report-buildchain-issue/README.md",
@@ -632,6 +644,18 @@
           "public": true,
           "plane": "verify"
         },
+        {
+          "id": "doc:docs/publication-rehearsal.md",
+          "name": "Publication rehearsal",
+          "kind": "documentation",
+          "sourcePath": "docs/publication-rehearsal.md",
+          "evidencePath": "docs/publication-rehearsal.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "use"
+        },
         {
           "id": "doc:docs/publish-transaction.md",
           "name": "Publish transaction",
@@ -716,6 +740,30 @@
           "public": true,
           "plane": "use"
         },
+        {
+          "id": "doc:docs/release-tail-contract.md",
+          "name": "Declarative release-tail contract",
+          "kind": "documentation",
+          "sourcePath": "docs/release-tail-contract.md",
+          "evidencePath": "docs/release-tail-contract.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "verify"
+        },
+        {
+          "id": "doc:docs/release-tail-provider-plane.md",
+          "name": "Declarative release-tail provider plane",
+          "kind": "documentation",
+          "sourcePath": "docs/release-tail-provider-plane.md",
+          "evidencePath": "docs/release-tail-provider-plane.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "use"
+        },
         {
           "id": "doc:docs/reusable-build-surface.md",
           "name": "Reusable build surface",
@@ -1604,6 +1652,30 @@
           "public": true,
           "packageExport": "./github-governance-authority"
         },
+        {
+          "id": "export:./engineering-housekeeper",
+          "name": "@kungfu-tech/buildchain/engineering-housekeeper",
+          "kind": "package-export",
+          "sourcePath": "packages/core/engineering-housekeeper.js",
+          "evidencePath": "packages/core/engineering-housekeeper.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./engineering-housekeeper"
+        },
+        {
+          "id": "export:./engineering-housekeeper-github",
+          "name": "@kungfu-tech/buildchain/engineering-housekeeper-github",
+          "kind": "package-export",
+          "sourcePath": "packages/core/engineering-housekeeper-github.js",
+          "evidencePath": "packages/core/engineering-housekeeper-github.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./engineering-housekeeper-github"
+        },
         {
           "id": "export:./kfd-gate",
           "name": "@kungfu-tech/buildchain/kfd-gate",
@@ -1700,6 +1772,66 @@
           "public": true,
           "packageExport": "./release-activation-transaction"
         },
+        {
+          "id": "export:./release-tail-provider-plane",
+          "name": "@kungfu-tech/buildchain/release-tail-provider-plane",
+          "kind": "package-export",
+          "sourcePath": "packages/core/release-tail-provider-plane.js",
+          "evidencePath": "packages/core/release-tail-provider-plane.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./release-tail-provider-plane"
+        },
+        {
+          "id": "export:./release-tail-provider-adapters",
+          "name": "@kungfu-tech/buildchain/release-tail-provider-adapters",
+          "kind": "package-export",
+          "sourcePath": "packages/core/release-tail-provider-adapters.js",
+          "evidencePath": "packages/core/release-tail-provider-adapters.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./release-tail-provider-adapters"
+        },
+        {
+          "id": "export:./release-tail-compatibility",
+          "name": "@kungfu-tech/buildchain/release-tail-compatibility",
+          "kind": "package-export",
+          "sourcePath": "packages/core/release-tail-compatibility.js",
+          "evidencePath": "packages/core/release-tail-compatibility.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./release-tail-compatibility"
+        },
+        {
+          "id": "export:./publication-rehearsal-runtime",
+          "name": "@kungfu-tech/buildchain/publication-rehearsal-runtime",
+          "kind": "package-export",
+          "sourcePath": "packages/core/publication-rehearsal-runtime.js",
+          "evidencePath": "packages/core/publication-rehearsal-runtime.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./publication-rehearsal-runtime"
+        },
+        {
+          "id": "export:./publication-rehearsal-projection",
+          "name": "@kungfu-tech/buildchain/publication-rehearsal-projection",
+          "kind": "package-export",
+          "sourcePath": "packages/core/publication-rehearsal-projection.js",
+          "evidencePath": "packages/core/publication-rehearsal-projection.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./publication-rehearsal-projection"
+        },
         {
           "id": "export:./surface-manifest",
           "name": "@kungfu-tech/buildchain/surface-manifest",
@@ -1948,6 +2080,18 @@
         }
       ],
       "reverseEnumeratedSurfaces": [
+        {
+          "id": "cli:architecture",
+          "name": "buildchain architecture validate [--cwd <dir>] [--json]",
+          "kind": "cli-command",
+          "sourcePath": "bin/buildchain.mjs",
+          "evidencePath": "bin/buildchain.mjs",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "bin/buildchain.mjs"
+        },
         {
           "id": "cli:audit",
           "name": "buildchain audit publication-control-plane --repository <owner/repo> --branch <protected-branch>",
@@ -3100,6 +3244,18 @@
           "public": true,
           "reverseAuditSource": "bin/buildchain.mjs"
         },
+        {
+          "id": "cli:release-tail",
+          "name": "buildchain release-tail plan --declaration <json-or-path> [--output <path>]",
+          "kind": "cli-command",
+          "sourcePath": "bin/buildchain.mjs",
+          "evidencePath": "bin/buildchain.mjs",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "bin/buildchain.mjs"
+        },
         {
           "id": "cli:release-transaction",
           "name": "buildchain release <inspect|recover|finalize|abort> ...",
@@ -3597,7 +3753,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 107,
+          "inputCount": 110,
           "inputs": [
             "allow-repository",
             "artifact-name",
@@ -3611,6 +3767,7 @@
             "buildchain-ref",
             "buildchain-repository",
             "channel",
+            "declarative-release-tail",
             "dry-run",
             "github-artifact-attestation-environment",
             "github-artifact-attestation-policy-json",
@@ -3633,12 +3790,14 @@
             "promotion-shell-sha",
             "promotion-target-ref",
             "publication-admission-json",
+            "publication-authority-workflow-path",
             "publication-auto-admission",
             "publication-auto-no-gate",
             "publication-commit-command",
             "publication-commit-evidence-path",
             "publication-consumer-predicate-id",
             "publication-consumer-qualification-command",
+            "publication-consumer-qualification-controller-sha",
             "publication-control-plane-audit-json",
             "publication-expected-json",
             "publication-gate-aggregate-json",
@@ -4510,8 +4669,9 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 32,
+          "inputCount": 36,
           "inputs": [
+            "active-lease-context",
             "affected-paths-json",
             "allowed-head-prefixes",
             "assignment-root",
@@ -4527,6 +4687,7 @@
             "dry-run",
             "expected-head-sha",
             "expected-pr-number",
+            "handoff-workflow-id",
             "initiative-root",
             "landing-mode",
             "max-merges",
@@ -4541,6 +4702,8 @@
             "shard-evidence-roots-json",
             "source-identity-root",
             "source-patch-root",
+            "source-workflow-id",
+            "source-workflow-run-id",
             "target-branch",
             "toolchain-root",
             "warrant-lease-seconds"
@@ -4572,6 +4735,76 @@
           ],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:engineering-housekeeper-daily",
+          "name": "workflow:engineering-housekeeper-daily",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/engineering-housekeeper-daily.yml",
+          "evidencePath": ".github/workflows/engineering-housekeeper-daily.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 0,
+          "inputs": [],
+          "reverseAuditSource": ".github/workflows"
+        },
+        {
+          "id": "workflow:engineering-housekeeper-monthly",
+          "name": "workflow:engineering-housekeeper-monthly",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/engineering-housekeeper-monthly.yml",
+          "evidencePath": ".github/workflows/engineering-housekeeper-monthly.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 0,
+          "inputs": [],
+          "reverseAuditSource": ".github/workflows"
+        },
+        {
+          "id": "workflow:engineering-housekeeper-weekly",
+          "name": "workflow:engineering-housekeeper-weekly",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/engineering-housekeeper-weekly.yml",
+          "evidencePath": ".github/workflows/engineering-housekeeper-weekly.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 0,
+          "inputs": [],
+          "reverseAuditSource": ".github/workflows"
+        },
+        {
+          "id": "workflow:engineering-housekeeper",
+          "name": "workflow:engineering-housekeeper",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/engineering-housekeeper.yml",
+          "evidencePath": ".github/workflows/engineering-housekeeper.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 13,
+          "inputs": [
+            "apply-enabled",
+            "artifact-prefix",
+            "artifact-retention-days",
+            "buildchain-ref",
+            "buildchain-repository",
+            "max-actions",
+            "mode",
+            "protected-patterns",
+            "repository",
+            "retained-patterns",
+            "stale-days",
+            "stale-pull-request-label",
+            "target-branch"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:github-artifact-attestation",
           "name": "workflow:github-artifact-attestation",
@@ -4861,7 +5094,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 99,
+          "inputCount": 101,
           "inputs": [
             "allow-repository",
             "artifact-name",
@@ -4878,6 +5111,7 @@
             "buildchain-repository",
             "buildchain-stable-contract-lock-path",
             "channel",
+            "declarative-release-tail",
             "dry-run",
             "github-artifact-attestation-environment",
             "github-artifact-attestation-policy-json",
@@ -4895,6 +5129,7 @@
             "publication-commit-evidence-path",
             "publication-consumer-predicate-id",
             "publication-consumer-qualification-command",
+            "publication-consumer-qualification-controller-sha",
             "publication-control-plane-audit-json",
             "publication-expected-json",
             "publication-gate-aggregate-json",
@@ -5046,6 +5281,27 @@
           ],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:release-tail",
+          "name": "workflow:release-tail",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/release-tail.yml",
+          "evidencePath": ".github/workflows/release-tail.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 6,
+          "inputs": [
+            "buildchain-ref",
+            "capsule-contract",
+            "capsule-path",
+            "capsule-root",
+            "evidence-path",
+            "state-path"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:release-verify",
           "name": "workflow:release-verify",
@@ -5207,12 +5463,13 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 76,
+          "inputCount": 80,
           "inputs": [
             "allow-repository",
             "branch-protection-bypass-apps",
             "branch-protection-bypass-teams",
             "branch-protection-bypass-users",
+            "declarative-release-tail",
             "dry-run",
             "expected-publication-version",
             "generated-pull-request-token",
@@ -5222,6 +5479,7 @@
             "github-release-artifact-paths",
             "github-release-notes",
             "github-release-title",
+            "plan-before-target-advance",
             "promote-only-release-candidate",
             "publication-capability-json",
             "publication-gate-aggregate-json",
@@ -5236,6 +5494,7 @@
             "publish-package-set-order",
             "publish-rematerialize-on-resume",
             "publish-required-artifacts-json",
+            "publish-required-artifacts-path",
             "publish-sealed-bundle-manifest",
             "publish-sealed-bundle-root",
             "publish-source-locked",
@@ -5274,6 +5533,7 @@
             "release-passport-platform-manifest-paths",
             "release-passport-product-name",
             "release-passport-promotion-routing-json",
+            "release-tail-state-path",
             "require-governance",
             "require-publication-qualification",
             "require-publish-source-lock",
@@ -5288,6 +5548,28 @@
           ],
           "reverseAuditSource": "actions/*/action.yml"
         },
+        {
+          "id": "action:release-tail",
+          "name": "action:release-tail",
+          "kind": "action",
+          "sourcePath": "actions/release-tail/action.yml",
+          "evidencePath": "actions/release-tail/action.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 7,
+          "inputs": [
+            "capsule",
+            "capsule-contract",
+            "capsule-root",
+            "evidence-path",
+            "github-token",
+            "http-token",
+            "state-path"
+          ],
+          "reverseAuditSource": "actions/*/action.yml"
+        },
         {
           "id": "action:report-buildchain-issue",
           "name": "action:report-buildchain-issue",
@@ -5437,6 +5719,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:action:release-tail",
+          "name": "site-page:action:release-tail",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:action:report-buildchain-issue",
           "name": "site-page:action:report-buildchain-issue",
@@ -5773,6 +6067,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:engineering-housekeeper",
+          "name": "site-page:manual:engineering-housekeeper",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:getting-started",
           "name": "site-page:manual:getting-started",
@@ -5977,6 +6283,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:publication-rehearsal",
+          "name": "site-page:manual:publication-rehearsal",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:publish-transaction",
           "name": "site-page:manual:publish-transaction",
@@ -6073,6 +6391,30 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:release-tail-contract",
+          "name": "site-page:manual:release-tail-contract",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
+        {
+          "id": "site-page:manual:release-tail-provider-plane",
+          "name": "site-page:manual:release-tail-provider-plane",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:reusable-build-surface",
           "name": "site-page:manual:reusable-build-surface",
@@ -6352,6 +6694,6 @@
         }
       }
     ],
-    "publicSurfaceCount": 401
+    "publicSurfaceCount": 425
   }
 }

package/dist/site/kfd-upstream-aggregate.json

@@ -4,7 +4,7 @@
   "product": {
     "id": "kungfu-tech-buildchain",
     "name": "@kungfu-tech/buildchain",
-    "version": "3.0.6",
+    "version": "3.0.7-alpha.1",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "source": {