Add adapter E2E validation and prepare v0.2.0 release

a-a-k · a-a-k · commit 0dab42624c76 · 2026-03-15T11:14:28.000+03:00
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -27,6 +27,9 @@ jobs:
       - name: Validate repository
         run: make validate
 
+      - name: Adapter end-to-end contracts
+        run: make e2e-adapters
+
       - name: Package chart
         run: make chart-package
 
diff --git a/Makefile b/Makefile
@@ -1,6 +1,6 @@
 PYTHON ?= python
 
-.PHONY: lint validate smoke-generic e2e-generic k8s-smoke-generic smoke-otel-demo e2e-otel-demo package-assets chart-package release-dry-run stack-manifest
+.PHONY: lint validate smoke-generic e2e-generic k8s-smoke-generic e2e-adapters smoke-otel-demo e2e-otel-demo package-assets chart-package release-dry-run stack-manifest
 
 lint:
 	$(PYTHON) scripts/tasks.py lint
@@ -17,6 +17,9 @@ e2e-generic:
 k8s-smoke-generic:
 	$(PYTHON) scripts/tasks.py k8s-smoke-generic
 
+e2e-adapters:
+	$(PYTHON) scripts/tasks.py e2e-adapters
+
 smoke-otel-demo:
 	$(PYTHON) scripts/tasks.py smoke-otel-demo
 
diff --git a/README.md b/README.md
@@ -66,6 +66,7 @@ make validate
 make smoke-generic
 make e2e-generic
 make k8s-smoke-generic
+make e2e-adapters
 make smoke-otel-demo
 make e2e-otel-demo
 make stack-manifest
@@ -79,12 +80,13 @@ Direct Python equivalents are also available:
 ```bash
 python scripts/tasks.py validate
 python scripts/tasks.py e2e-generic
+python scripts/tasks.py e2e-adapters
 python scripts/tasks.py release-dry-run
 ```
 
 ## Compatibility Notes
 
-The compatibility files in `compat/` are the source of truth for stack-level assertions. The current `0.1.0` bundle is recorded as a `candidate` integration statement backed by upstream release manifests and Sheaft's published compatibility manifest, not as a broader verified operations guarantee. OpenTelemetry Demo remains one example profile and one acceptance scenario, not the design center of the core bundle.
+The compatibility files in `compat/` are the source of truth for stack-level assertions. The current `0.2.0` bundle is recorded as a `candidate` integration statement backed by upstream release manifests, live generic smoke evidence, and Sheaft's published compatibility manifest, not as a broader verified operations guarantee. OpenTelemetry Demo remains one example profile and one acceptance scenario, not the design center of the core bundle.
 
 ## License
 
diff --git a/VERSIONING.md b/VERSIONING.md
@@ -36,6 +36,6 @@ If a pin is unknown, keep it explicit with `TODO-*` placeholders and mark the co
 
 ## Tagging
 
-Repository tags should use `v<semver>`, for example `v0.1.0`.
+Repository tags should use `v<semver>`, for example `v0.2.0`.
 
-The initial bundle is `0.1.0`, which should be treated as pre-GA integration packaging.
+The current bundle line is still pre-GA integration packaging and remains conservative about formal maturity even as validation depth increases.
diff --git a/charts/mb3r-stack/Chart.yaml b/charts/mb3r-stack/Chart.yaml
@@ -2,8 +2,8 @@ apiVersion: v2
 name: mb3r-stack
 description: Generic integration bundle that wires upstream Bering and Sheaft into OTLP-based or artifact-based Kubernetes environments.
 type: application
-version: 0.1.0
-appVersion: "0.1.0"
+version: 0.2.0
+appVersion: "0.2.0"
 keywords:
   - mb3r
   - otlp
diff --git a/compat/compatibility-matrix.json b/compat/compatibility-matrix.json
@@ -3,6 +3,29 @@
   "schemaVersion": "1.0.0",
   "generatedAt": "2026-03-15",
   "entries": [
+    {
+      "stackVersion": "0.2.0",
+      "beringVersion": "0.1.0",
+      "sheaftVersion": "0.1.1",
+      "chartVersion": "0.2.0",
+      "compatibilityState": "candidate",
+      "evidence": "Pinned to https://github.com/MB3R-Lab/Bering/releases/download/v0.1.0/release-manifest.json plus https://github.com/MB3R-Lab/Sheaft/releases/download/v0.1.1/release-manifest.json and https://github.com/MB3R-Lab/Sheaft/releases/download/v0.1.1/compatibility-manifest.json; verified by local generic smoke, local generic e2e, live kind-based generic smoke, OTel Demo profile smoke/e2e, and adapter end-to-end contract runs on 2026-03-15.",
+      "contracts": {
+        "collectorExport": "v1alpha1",
+        "discoveryReport": "v1alpha1",
+        "gateDecision": "v1alpha1",
+        "reportPayload": "v1alpha1"
+      },
+      "dashboards": {
+        "bering": "1.0.0",
+        "sheaft": "1.0.0"
+      },
+      "notes": [
+        "Bering v0.1.0 release contracts and Sheaft v0.1.1 compatibility pins align on io.mb3r.bering.model@1.0.0 and io.mb3r.bering.snapshot@1.0.0 digests.",
+        "This remains a candidate integration statement rather than a GA support claim.",
+        "Generic core validation is now demonstrated separately from the OpenTelemetry Demo profile and from CI adapter contract verification."
+      ]
+    },
     {
       "stackVersion": "0.1.0",
       "beringVersion": "0.1.0",
diff --git a/compat/stack-manifest.json b/compat/stack-manifest.json
@@ -3,25 +3,26 @@
   "schemaVersion": "1.0.0",
   "stack": {
     "name": "mb3r-stack",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "status": "candidate",
     "releaseDate": "2026-03-15",
     "notes": [
       "Generic integration and distribution layer only. No upstream Bering or Sheaft source code is vendored here.",
       "Candidate bundle pinned to released Bering v0.1.0 and Sheaft v0.1.1 artifacts with immutable GHCR digests.",
-      "Compatibility claims are limited to published contract alignment and packaged integration assets. OpenTelemetry Demo is packaged as an example profile, not as the core contract."
+      "OpenTelemetry Demo is packaged as an example profile, not as the core contract.",
+      "This release adds separate generic and profile-specific acceptance paths, including a live Kubernetes smoke for the generic synthetic profile and end-to-end adapter contract verification."
     ]
   },
   "artifacts": {
     "chart": {
       "name": "mb3r-stack",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "ociRepository": "oci://ghcr.io/mb3r-lab/charts",
-      "package": "mb3r-stack-0.1.0.tgz"
+      "package": "mb3r-stack-0.2.0.tgz"
     },
     "assetPack": {
-      "version": "0.1.0",
-      "archive": "mb3r-assets-0.1.0.tgz",
+      "version": "0.2.0",
+      "archive": "mb3r-assets-0.2.0.tgz",
       "includes": [
         "collector/",
         "dashboards/",
@@ -33,8 +34,8 @@
       "sheaft": "1.0.0"
     },
     "configPacks": {
-      "collector": "0.1.0",
-      "examples": "0.1.0"
+      "collector": "0.2.0",
+      "examples": "0.2.0"
     }
   },
   "components": {
diff --git a/docs/compatibility.md b/docs/compatibility.md
@@ -24,7 +24,7 @@ The machine-readable compatibility contract is split across:
 
 ## Current Bundle
 
-`mb3r-stack` `0.1.0` currently tracks:
+`mb3r-stack` `0.2.0` currently tracks:
 
 - Bering `0.1.0`
 - Sheaft `0.1.1`
diff --git a/docs/install-gitlab.md b/docs/install-gitlab.md
@@ -22,7 +22,7 @@ Use component references pinned by tag, for example:
 
 ```yaml
 include:
-  - component: $CI_SERVER_FQDN/group/mb3r-stack/bering-discover@v0.1.0
+  - component: $CI_SERVER_FQDN/group/mb3r-stack/bering-discover@v0.2.0
 ```
 
 Keep the tag aligned with the `mb3r-stack` integration bundle release, not with any upstream Bering or Sheaft release number.
diff --git a/docs/install-jenkins.md b/docs/install-jenkins.md
@@ -21,5 +21,5 @@ See `examples/jenkins/Jenkinsfile`.
 Use the library by tag:
 
 ```groovy
-@Library('mb3r-stack@v0.1.0') _
+@Library('mb3r-stack@v0.2.0') _
 ```
diff --git a/docs/verification/adapters-e2e.md b/docs/verification/adapters-e2e.md
@@ -0,0 +1,15 @@
+# Adapter E2E
+
+This verification path exercises the reusable GitHub, GitLab, and Jenkins adapter contracts against representative payloads.
+
+```bash
+make e2e-adapters
+```
+
+What it checks:
+
+- discovery, gate, and combined report artifacts for GitHub reusable workflows
+- discovery, gate, and combined report artifacts for GitLab catalog components
+- discovery, gate, and combined report artifacts for Jenkins shared-library semantics
+- example consumer files still point at the expected adapter entrypoints
+- generated artifacts keep the published `v1alpha1` contract shapes
diff --git a/examples/github/example-caller.yml b/examples/github/example-caller.yml
@@ -5,7 +5,7 @@ on:
 
 jobs:
   bering:
-    uses: ORG/mb3r-stack/.github/workflows/bering-discover.yml@v0.1.0
+    uses: ORG/mb3r-stack/.github/workflows/bering-discover.yml@v0.2.0
     with:
       command: |
         python - <<'PY'
@@ -20,7 +20,7 @@ jobs:
 
   sheaft:
     needs: bering
-    uses: ORG/mb3r-stack/.github/workflows/sheaft-gate.yml@v0.1.0
+    uses: ORG/mb3r-stack/.github/workflows/sheaft-gate.yml@v0.2.0
     with:
       discovery-artifact-name: ${{ needs.bering.outputs.artifact-name }}
       command: |
@@ -38,7 +38,7 @@ jobs:
     needs:
       - bering
       - sheaft
-    uses: ORG/mb3r-stack/.github/workflows/mb3r-report.yml@v0.1.0
+    uses: ORG/mb3r-stack/.github/workflows/mb3r-report.yml@v0.2.0
     with:
       discovery-artifact-name: ${{ needs.bering.outputs.artifact-name }}
       gate-artifact-name: ${{ needs.sheaft.outputs.artifact-name }}
diff --git a/examples/gitlab/.gitlab-ci.yml b/examples/gitlab/.gitlab-ci.yml
@@ -4,7 +4,7 @@ stages:
   - report
 
 include:
-  - component: $CI_SERVER_FQDN/group/mb3r-stack/bering-discover@v0.1.0
+  - component: $CI_SERVER_FQDN/group/mb3r-stack/bering-discover@v0.2.0
     inputs:
       stage: discover
       command: |
@@ -17,7 +17,7 @@ include:
             encoding="utf-8",
         )
         PY
-  - component: $CI_SERVER_FQDN/group/mb3r-stack/sheaft-gate@v0.1.0
+  - component: $CI_SERVER_FQDN/group/mb3r-stack/sheaft-gate@v0.2.0
     inputs:
       stage: gate
       command: |
@@ -30,6 +30,6 @@ include:
             encoding="utf-8",
         )
         PY
-  - component: $CI_SERVER_FQDN/group/mb3r-stack/mb3r-report@v0.1.0
+  - component: $CI_SERVER_FQDN/group/mb3r-stack/mb3r-report@v0.2.0
     inputs:
       stage: report
diff --git a/examples/jenkins/Jenkinsfile b/examples/jenkins/Jenkinsfile
@@ -1,4 +1,4 @@
-@Library('mb3r-stack@v0.1.0') _
+@Library('mb3r-stack@v0.2.0') _
 
 pipeline {
   agent any
diff --git a/release/v0.2.0.md b/release/v0.2.0.md
@@ -0,0 +1,22 @@
+## mb3r-stack v0.2.0
+
+Generic reusable stack release for the MB3R integration layer above released Bering and Sheaft artifacts.
+
+### What changed
+
+- chart identity moved to the generic `mb3r-stack` install surface
+- core assumptions are now separated from profile-specific OpenTelemetry Demo wiring
+- the repository now ships a smallest generic synthetic profile, a minimal production-style profile, and an OTel Demo profile
+- verification is split across generic smoke, generic end-to-end, live generic Kubernetes smoke, OTel Demo profile smoke/end-to-end, and CI adapter end-to-end contract checks
+
+### Upstream pins in this bundle
+
+- Bering `v0.1.0` pinned to `ghcr.io/mb3r-lab/bering@sha256:8e8ce6599b43477b0653617e829d41c62a3189d16b60ecb424cca718fc0e2674`
+- Sheaft `v0.1.1` pinned to `ghcr.io/mb3r-lab/sheaft@sha256:eb1ebf9d96c55c5bb29e226e07496d152eb3a66b52dd9d34ba799fa4aef70624`
+
+### Release posture
+
+- formal bundle maturity remains `candidate`
+- generic stack readiness is validated separately from the OpenTelemetry Demo profile
+- OpenTelemetry Demo remains an example profile and acceptance scenario, not the design center of the bundle
+- CI adapter contracts are now exercised end to end against representative payloads
diff --git a/scripts/adapter_cli.py b/scripts/adapter_cli.py
@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+from adapter_contracts import generate_discovery_report, generate_gate_report, generate_stack_report
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Generate MB3R adapter contract artifacts.")
+    subparsers = parser.add_subparsers(dest="command_name", required=True)
+
+    discovery = subparsers.add_parser("discovery")
+    discovery.add_argument("--adapter", required=True)
+    discovery.add_argument("--target-path", default=".")
+    discovery.add_argument("--output-dir", required=True)
+    discovery.add_argument("--command", default="")
+    discovery.add_argument("--image-ref", required=True)
+    discovery.add_argument("--artifact-name", default="mb3r-bering-discovery")
+    discovery.add_argument("--outputs-path")
+    discovery.add_argument("--env-path")
+
+    gate = subparsers.add_parser("gate")
+    gate.add_argument("--adapter", required=True)
+    gate.add_argument("--discovery-report", required=True)
+    gate.add_argument("--output-dir", required=True)
+    gate.add_argument("--command", default="")
+    gate.add_argument("--image-ref", required=True)
+    gate.add_argument("--artifact-name", default="mb3r-sheaft-gate")
+    gate.add_argument("--default-decision", default="review")
+    gate.add_argument("--outputs-path")
+    gate.add_argument("--env-path")
+
+    report = subparsers.add_parser("report")
+    report.add_argument("--adapter", required=True)
+    report.add_argument("--discovery-report", required=True)
+    report.add_argument("--gate-report", required=True)
+    report.add_argument("--output-dir", required=True)
+    report.add_argument("--artifact-name", default="mb3r-report")
+    report.add_argument("--outputs-path")
+    report.add_argument("--env-path")
+
+    args = parser.parse_args()
+
+    if args.command_name == "discovery":
+        result = generate_discovery_report(
+            adapter=args.adapter,
+            target_path=args.target_path,
+            output_dir=Path(args.output_dir),
+            command=args.command,
+            image_ref=args.image_ref,
+            artifact_name=args.artifact_name,
+            process_env=dict(os.environ),
+            outputs_path=Path(args.outputs_path) if args.outputs_path else None,
+            env_path=Path(args.env_path) if args.env_path else None,
+        )
+    elif args.command_name == "gate":
+        result = generate_gate_report(
+            adapter=args.adapter,
+            discovery_report=Path(args.discovery_report),
+            output_dir=Path(args.output_dir),
+            command=args.command,
+            image_ref=args.image_ref,
+            artifact_name=args.artifact_name,
+            default_decision=args.default_decision,
+            process_env=dict(os.environ),
+            outputs_path=Path(args.outputs_path) if args.outputs_path else None,
+            env_path=Path(args.env_path) if args.env_path else None,
+        )
+    else:
+        result = generate_stack_report(
+            adapter=args.adapter,
+            discovery_report=Path(args.discovery_report),
+            gate_report=Path(args.gate_report),
+            output_dir=Path(args.output_dir),
+            artifact_name=args.artifact_name,
+            outputs_path=Path(args.outputs_path) if args.outputs_path else None,
+            env_path=Path(args.env_path) if args.env_path else None,
+        )
+
+    print(json.dumps(result, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/scripts/adapter_contracts.py b/scripts/adapter_contracts.py
diff --git a/scripts/adapter_e2e.py b/scripts/adapter_e2e.py
diff --git a/scripts/tasks.py b/scripts/tasks.py
diff --git a/scripts/validate.py b/scripts/validate.py
