Add workflows and configuration for syncing and linting subtrees

- Created .github/subtrees.json to define subtree repositories.
- Added linting workflow for subtrees.json in .github/workflows/lint-subtrees.yml.
- Implemented sync workflow for subtrees in .github/workflows/subtree.yml.
- Created subtrees.json and superprojects.json files in database, examples/c, examples/com, and examples/fortran directories.
- Added linting workflows for subtrees.json and superprojects.json in respective directories.
- Established sync workflows for subtrees in examples/c, examples/com, examples/fortran, and src directories.
- Configured subtrees.json and superprojects.json for src and src/phreeqcpp directories.
- Implemented linting workflows for subtrees.json and superprojects.json in src and src/phreeqcpp directories.
- Added common superprojects.json in src/phreeqcpp/common directory.

.github/subtrees.json

@@ -0,0 +1,37 @@
+[
+  {
+    "prefix": "src",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/iphreeqc-src.git",
+    "repo": "usgs-coupled-subtrees/iphreeqc-src"
+  },
+  {
+    "prefix": "examples/c",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc-commanuscript-cgfinal-examples-c.git",
+    "repo": "usgs-coupled-subtrees/phreeqc-commanuscript-cgfinal-examples-c"
+  },
+  {
+    "prefix": "examples/com",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc-commanuscript-cgfinal-examples-com.git",
+    "repo": "usgs-coupled-subtrees/phreeqc-commanuscript-cgfinal-examples-com"
+  },
+  {
+    "prefix": "examples/fortran",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc-COMManuscript-CGfinal-examples-fortran.git",
+    "repo": "usgs-coupled-subtrees/phreeqc-COMManuscript-CGfinal-examples-fortran"
+  },
+  {
+    "prefix": "database",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc3-database.git",
+    "repo": "usgs-coupled-subtrees/phreeqc3-database"
+  },
+  {
+    "prefix": "phreeqc3-doc",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc3-doc.git",
+    "repo": "usgs-coupled-subtrees/phreeqc3-doc"
+  },
+  {
+    "prefix": "phreeqc3-examples",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc3-examples.git",
+    "repo": "usgs-coupled-subtrees/phreeqc3-examples"
+  }
+]

.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

database/.github/subtrees.json

@@ -0,0 +1 @@
+[]

database/.github/superprojects.json

@@ -0,0 +1,11 @@
+{
+  "usgs-coupled-subtrees/phreeqc3-database": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc",
+      "usgs-coupled-subtrees/iphreeqccom",
+      "usgs-coupled-subtrees/phreeqcrm",
+      "usgs-coupled-subtrees/phreeqc3",
+      "usgs-coupled-subtrees/wphast"
+    ]
+  }
+}

database/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

database/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,20 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+          # skip-repos: |
+          #   - usgs-coupled-subtrees/iphreeqccom
+          #   - usgs-coupled-subtrees/phreeqcrm-src
+

database/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/c/.github/subtrees.json

@@ -0,0 +1 @@
+[]

examples/c/.github/superprojects.json

@@ -0,0 +1,9 @@
+{
+  "usgs-coupled-subtrees/phreeqc-commanuscript-cgfinal-examples-c": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc",
+      "usgs-coupled-subtrees/iphreeqccom",
+      "usgs-coupled-subtrees/phreeqc"
+    ]
+  }
+}

examples/c/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/c/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,16 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/c/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/com/.github/subtrees.json

@@ -0,0 +1 @@
+[]

examples/com/.github/superprojects.json

@@ -0,0 +1,9 @@
+{
+  "usgs-coupled-subtrees/phreeqc-commanuscript-cgfinal-examples-com": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc",
+      "usgs-coupled-subtrees/iphreeqccom",
+      "usgs-coupled-subtrees/phreeqc"
+    ]
+  }
+}

examples/com/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/com/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,16 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/com/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/fortran/.github/subtrees.json

@@ -0,0 +1 @@
+[]

examples/fortran/.github/superprojects.json

@@ -0,0 +1,9 @@
+{
+  "usgs-coupled-subtrees/phreeqc-COMManuscript-CGfinal-examples-fortran": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc",
+      "usgs-coupled-subtrees/iphreeqccom",
+      "usgs-coupled-subtrees/phreeqc"
+    ]
+  }
+}

examples/fortran/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/fortran/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,16 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

examples/fortran/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

phreeqc3-doc/.github/subtrees.json

@@ -0,0 +1 @@
+[]

phreeqc3-doc/.github/superprojects.json

@@ -0,0 +1,10 @@
+{
+  "usgs-coupled-subtrees/phreeqc3-doc": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc",
+      "usgs-coupled-subtrees/iphreeqccom",
+      "usgs-coupled-subtrees/phast3-doc",
+      "usgs-coupled-subtrees/phreeqc3"
+    ]
+  }
+}

phreeqc3-doc/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

phreeqc3-doc/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,16 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

phreeqc3-doc/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

phreeqc3-examples/.github/subtrees.json

@@ -0,0 +1 @@
+[]

phreeqc3-examples/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,19 @@
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

phreeqc3-examples/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

src/.github/subtrees.json

@@ -0,0 +1,7 @@
+[
+  {
+    "prefix": "phreeqcpp",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc3-src.git",
+    "repo": "usgs-coupled-subtrees/phreeqc3-src"
+  }
+]

src/.github/superprojects.json

@@ -0,0 +1,9 @@
+{
+  "usgs-coupled-subtrees/iphreeqc-src": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc",
+      "usgs-coupled-subtrees/iphreeqccom",
+      "usgs-coupled-subtrees/phreeqcrm-src"
+    ]
+  }
+}

src/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,22 @@
+# This workflow lints the subtrees.json file to ensure it is valid and up-to-date.
+# It is triggered on pull requests that modify the subtrees.json file or can be run manually
+# via the GitHub Actions UI.
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

src/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,16 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

src/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

src/phreeqcpp/.github/subtrees.json

@@ -0,0 +1,7 @@
+[
+  {
+    "prefix": "common",
+    "url": "git@${CI_SERVER_HOST}:${GROUP}-subtrees/phreeqc3-src-common.git",
+    "repo": "usgs-coupled-subtrees/phreeqc3-src-common"
+  }
+]

src/phreeqcpp/.github/superprojects.json

@@ -0,0 +1,8 @@
+{
+  "usgs-coupled-subtrees/phreeqc3-src": {
+    "superprojects": [
+      "usgs-coupled-subtrees/iphreeqc-src",
+      "usgs-coupled-subtrees/phreeqc3"
+    ]
+  }
+}

src/phreeqcpp/.github/workflows/lint-subtrees.yml

@@ -0,0 +1,22 @@
+# This workflow lints the subtrees.json file to ensure it is valid and up-to-date.
+# It is triggered on pull requests that modify the subtrees.json file or can be run manually
+# via the GitHub Actions UI.
+name: Lint subtrees.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/subtrees.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-subtrees:
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-subtrees/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

src/phreeqcpp/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}

src/phreeqcpp/common/.github/superprojects.json

@@ -0,0 +1,7 @@
+{
+  "usgs-coupled-subtrees/phreeqc3-src-common": {
+    "superprojects": [
+      "usgs-coupled-subtrees/phreeqc3-src"
+    ]
+  }
+}

src/phreeqcpp/common/.github/workflows/lint-superprojects.yml

@@ -0,0 +1,16 @@
+name: Lint superprojects.json
+
+on:
+  pull_request:
+    paths:
+      - '.github/superprojects.json'
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  lint-superprojects:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: usgs-coupled-subtrees/sync-subtrees-action/lint-superprojects/@main
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

src/phreeqcpp/common/.github/workflows/subtree.yml

@@ -0,0 +1,37 @@
+name: Sync Subtrees
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+    inputs:
+      dryRun:
+        description: 'If true, don’t push any changes (for testing only).'
+        required: true
+        default: false
+        type: boolean
+      testMerge:
+        description: 'Run in test mode, pushing to a test branch.'
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  sync-subtrees:
+    if: startsWith(github.repository, 'usgs-coupled-subtrees/')
+    runs-on: ubuntu-latest
+    env:
+      CI_SERVER_HOST: github.com
+      GROUP: usgs-coupled
+      GH_TOKEN: ${{ secrets.WORKFLOW_PAT }}
+    steps:
+      - name: Run sync-subtrees-action
+        uses: usgs-coupled-subtrees/sync-subtrees-action@main
+        with:
+          dryRun: ${{ inputs.dryRun }}
+          testMerge: ${{ inputs.testMerge }}
+          repository_name: ${{ github.event.repository.name }}
+          default_branch: ${{ github.event.repository.default_branch }}
+          run_number: ${{ github.run_number }}
+          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}