feat(observability): add observability core module, TelemetryHook SPI and facade wiring

.gitattributes

@@ -0,0 +1,53 @@
+# Auto-detect text files; enable Git's built-in text normalization
+* text=auto
+
+# =====================
+# Java SDK source files
+# =====================
+*.java     text eol=lf
+*.xml      text eol=lf
+*.properties text eol=lf
+
+# =====================
+# Build & configuration
+# =====================
+*.yml      text eol=lf
+*.yaml     text eol=lf
+*.json     text eol=lf
+*.toml     text eol=lf
+*.env      text eol=lf
+*.example  text eol=lf
+
+# =====================
+# Documentation
+# =====================
+*.md       text eol=lf
+*.txt      text eol=lf
+*.html     text eol=lf
+*.css      text eol=lf
+*.js       text eol=lf
+
+# =====================
+# Python tooling
+# =====================
+*.py       text eol=lf
+
+# =====================
+# Others
+# =====================
+*.lock     text eol=lf
+*.svg      text eol=lf
+
+# =====================
+# Binary files — never normalize
+# =====================
+*.jar      binary
+*.class    binary
+*.png      binary
+*.jpg      binary
+*.jpeg     binary
+*.gif      binary
+*.ico      binary
+*.zip      binary
+*.tar      binary
+*.gz       binary

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, dev ]
+  pull_request:
+    branches: [ main, dev ]
+
+jobs:
+  build-and-test:
+    name: Build & Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+          cache: maven
+
+      - name: Set up Python for template lint
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Lint bundled A2A-T templates
+        run: python tools/template_lint.py --resource-root a2a-t-resources/src/main/resources/prompt_resources
+
+      - name: Build and run tests
+        # a2a-t-corpus is the accuracy-verification test module: it must run against a real LLM, which CI does not provide, so exclude it.
+        run: mvn -B clean verify -pl '!a2a-t-corpus'

.github/workflows/release.yml

@@ -0,0 +1,76 @@
+name: Release to Maven Central
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    name: Publish Maven artifacts
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Validate release secrets
+        shell: bash
+        env:
+          MAVEN_CENTRAL_USERNAME: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+          MAVEN_CENTRAL_PASSWORD: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+          GPG_KEY_CONTENTS: ${{ secrets.GPG_KEY_CONTENTS }}
+          SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+          SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }}
+        run: |
+          test -n "${MAVEN_CENTRAL_USERNAME}" || { echo "MAVEN_CENTRAL_USERNAME is not set"; exit 1; }
+          test -n "${MAVEN_CENTRAL_PASSWORD}" || { echo "MAVEN_CENTRAL_PASSWORD is not set"; exit 1; }
+          test -n "${GPG_KEY_CONTENTS}" || { echo "GPG_KEY_CONTENTS is not set"; exit 1; }
+          test -n "${SIGNING_KEY_ID}" || { echo "SIGNING_KEY_ID is not set"; exit 1; }
+          test -n "${SIGNING_PASSWORD}" || { echo "SIGNING_PASSWORD is not set"; exit 1; }
+
+      - name: Set up JDK
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+          cache: maven
+          gpg-private-key: ${{ secrets.GPG_KEY_CONTENTS }}
+          gpg-passphrase: SIGNING_PASSWORD
+        env:
+          SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }}
+
+      - name: Configure Maven servers
+        shell: bash
+        env:
+          MAVEN_CENTRAL_USERNAME: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+          MAVEN_CENTRAL_PASSWORD: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+        run: |
+          mkdir -p ~/.m2
+          cat > ~/.m2/settings.xml <<EOF
+          <settings>
+            <servers>
+              <server>
+                <id>central</id>
+                <username>${MAVEN_CENTRAL_USERNAME}</username>
+                <password>${MAVEN_CENTRAL_PASSWORD}</password>
+              </server>
+            </servers>
+          </settings>
+          EOF
+
+      - name: Verify
+        run: mvn -B verify -pl '!a2a-t-corpus'
+
+      - name: Publish
+        env:
+          SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+          MAVEN_GPG_PASSPHRASE: ${{ secrets.SIGNING_PASSWORD }}
+        run: >
+          mvn -B -Prelease deploy -pl '!a2a-t-corpus'
+          -Dgpg.executable=gpg
+          -Dgpg.keyname="${SIGNING_KEY_ID}"

.gitignore

@@ -1,3 +1,27 @@
 target/
 *target/
-.gitignore
+.gitignore
+.flattened-pom.xml
+*.env
+# Sample env templates carry no secrets (empty API key) and must ship with the sources.
+!a2a-t-sample/src/main/resources/**/negotiation.env
+!a2a-t-sample/src/main/resources/**/authz.env
+reference/
+findings.md
+progress.md
+task_plan.md
+
+.idea/
+
+.worktrees/
+eval-results/
+eval-run*.log
+eval-smoke.json
+.jqwik-database
+__pycache__/
+
+# Accuracy-verification corpus (a2a-t-corpus): transcripts written back into the scenario
+# directories by each run are regenerated artifacts, never committed.
+a2a-t-corpus/src/test/java/**/suites/*/resources/*/output_result_*.json
+
+.superpowers/

CODEOWNERS

@@ -0,0 +1,9 @@
+# Code owners for this repository.
+# Each line is a file pattern followed by one or more owners.
+# The last matching pattern takes precedence.
+# Reference: https://docs.github.com/articles/about-code-owners
+
+# The maintainers team owns all content in this repository,
+# including this file and MAINTAINERS.md, and is automatically
+# requested for review on every pull request.
+* @project-openan/maintainers-a2a-t-sdk

MAINTAINERS.md

@@ -0,0 +1,26 @@
+# Maintainers
+
+This file lists the maintainers of this repository. Maintainers have write access and are responsible for reviewing and merging contributions. Changes to this file are made by pull request and reviewed by the existing maintainers.
+
+| Organization | Name | GitHub Handle |
+| ------------ | ---- | ------------- |
+| Huawei  | Yonglong Wang | @wangyonglong12111 |
+| Huawei  | Wenjun Zhang | @zhangwenjun-huawei |
+| The Linux Foundation  | Casey Cain | @wrathwolf |
+
+## Emeritus Maintainers
+
+Maintainers who are no longer active but have made significant contributions to this repository.
+
+| Organization | Name | GitHub Handle |
+| ------------ | ---- | ------------- |
+| (none yet)   |      |               |
+
+## Becoming a Maintainer
+
+Maintainer status is granted by the existing maintainers of this repository, or by the TSC, based on a track record of sustained, quality contributions. To be considered, a contributor should demonstrate:
+
+- Consistent contributions over time (code, reviews, documentation)
+- Understanding of the component's goals and architecture
+- Constructive participation in community discussions
+- Adherence to the project's Code of Conduct and Contributing guidelines