Add GitHub Actions for downstream notifications and releases

notify-downstream.yml: When SPEC.md changes on main, opens issues on
agentwebprotocol.org, agent-json.org, agent.json CLI, and mcp-server
repos alerting them to update their embedded copies.

Requires AWP_NOTIFY_TOKEN secret in repo settings — a GitHub PAT with
repo scope that can create issues across the org's repos.

release.yml: When a v* tag is pushed, creates a GitHub Release with
the changelog section extracted from SPEC.md, attaching the spec file.

Author: benikigai

.github/workflows/notify-downstream.yml

@@ -0,0 +1,76 @@
+name: Notify downstream repos on spec change
+
+on:
+  push:
+    branches: [main]
+    paths: ['SPEC.md']
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Get commit info
+        id: commit
+        run: |
+          echo "sha=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+          echo "message=$(git log -1 --pretty=%s)" >> $GITHUB_OUTPUT
+
+      - name: Notify agentwebprotocol.org
+        env:
+          GH_TOKEN: ${{ secrets.AWP_NOTIFY_TOKEN }}
+        run: |
+          gh issue create \
+            --repo agentwebprotocol/agentwebprotocol.org \
+            --title "Spec updated: ${{ steps.commit.outputs.message }}" \
+            --body "SPEC.md was updated in [spec@${{ steps.commit.outputs.sha }}](https://github.com/agentwebprotocol/spec/commit/${{ github.sha }}).
+
+          **Action needed:**
+          - [ ] Update \`public/llms-full.txt\` with new spec content
+
+          The \`/spec\` page auto-fetches from GitHub — already showing latest." \
+            --label "spec-update" || true
+
+      - name: Notify agent-json.org
+        env:
+          GH_TOKEN: ${{ secrets.AWP_NOTIFY_TOKEN }}
+        run: |
+          gh issue create \
+            --repo agentwebprotocol/agent-json.org \
+            --title "Spec updated: ${{ steps.commit.outputs.message }}" \
+            --body "SPEC.md was updated in [spec@${{ steps.commit.outputs.sha }}](https://github.com/agentwebprotocol/spec/commit/${{ github.sha }}).
+
+          **Action needed (if schema fields changed):**
+          - [ ] Update \`src/lib/schema.ts\`
+          - [ ] Update \`src/lib/examples.ts\` if relevant
+          - [ ] Update \`public/agent.json\` if relevant" \
+            --label "spec-update" || true
+
+      - name: Notify agent.json CLI
+        env:
+          GH_TOKEN: ${{ secrets.AWP_NOTIFY_TOKEN }}
+        run: |
+          gh issue create \
+            --repo agentwebprotocol/agent.json \
+            --title "Spec updated: ${{ steps.commit.outputs.message }}" \
+            --body "SPEC.md was updated in [spec@${{ steps.commit.outputs.sha }}](https://github.com/agentwebprotocol/spec/commit/${{ github.sha }}).
+
+          **Action needed (if schema fields changed):**
+          - [ ] Update \`src/schema.js\` validation rules
+          - [ ] Bump version and \`npm publish\`" \
+            --label "spec-update" || true
+
+      - name: Notify MCP server
+        env:
+          GH_TOKEN: ${{ secrets.AWP_NOTIFY_TOKEN }}
+        run: |
+          gh issue create \
+            --repo agentwebprotocol/mcp-server \
+            --title "Spec updated: ${{ steps.commit.outputs.message }}" \
+            --body "SPEC.md was updated in [spec@${{ steps.commit.outputs.sha }}](https://github.com/agentwebprotocol/spec/commit/${{ github.sha }}).
+
+          **Action needed:**
+          - [ ] Update embedded spec in \`src/index.js\`
+          - [ ] Bump version and \`npm publish\`" \
+            --label "spec-update" || true

.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Create release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          # Extract the changelog section for this version
+          awk "/^### v${{ steps.version.outputs.version }}/,/^### v[0-9]|^---/{
+            if (/^### v[0-9]/ && !/v${{ steps.version.outputs.version }}/) exit
+            if (/^---/) exit
+            print
+          }" SPEC.md > /tmp/changelog.md
+          echo "body<<EOF" >> $GITHUB_OUTPUT
+          cat /tmp/changelog.md >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "v${{ steps.version.outputs.version }}" \
+            --title "AWP Spec v${{ steps.version.outputs.version }}" \
+            --notes-file /tmp/changelog.md \
+            SPEC.md