.github/workflows/ci-workflow.yml

@@ -1,50 +1,51 @@
 name: Node Agent CI
 
-on: [push, pull_request, workflow_dispatch]
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
 
 env:
   # Enable versioned runner quiet mode to make CI output easier to read:
   OUTPUT_MODE: quiet
 
 jobs:
   should_run:
+    # We only want the test suites to run when code has changed, or when
+    # a dependency update has occurred.
     runs-on: ubuntu-latest
     permissions:
       pull-requests: read
     outputs:
-      javascript_changed: ${{ steps.filter.output.javascript }}
+      javascript_changed: ${{ steps.filter.outputs.javascript }}
+      deps_changed: ${{ steps.deps.outputs.divergent }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
       - uses: dorny/paths-filter@v3
         id: filter
         with:
           filters: |
             javascript:
-              - '**/*.js'
-              - '**/*.json'
-              - '**/*.mjs'
-              - '**/*.cjs'
-
-  skip_if_release:
-    runs-on: ubuntu-latest
-
-    outputs:
-      should_skip: ${{ steps.skip_check.outputs.should_skip }}
-
-    steps:
-      - id: skip_check
-        uses: fkirc/skip-duplicate-actions@v5
+              - 'api.js'
+              - 'esm-loader.mjs'
+              - 'index.js'
+              - 'stub_api.js'
+              - 'lib/**/*.{js,json,mjs,cjs}'
+              - 'test/**/*.{js,json,mjs,cjs}'
+      - uses: jsumners-nr/gha-node-deps-divergent@643628fe0da51ec025e984c4644f17fd9f9e93f6
+        id: deps
         with:
-          paths_ignore: '["NEWS.md", "changelog.json", "package.json", "package-lock.json"]'
-          skip_after_successful_duplicate: false
-          do_not_skip: '["workflow_dispatch", "pull_request"]'
+          base-sha: ${{ github.base_ref || 'main' }}
+          current-sha: ${{ github.sha }}
 
   lint:
     needs:
-      - skip_if_release
       - should_run
-    if: needs.skip_if_release.outputs.should_skip != 'true'
-      || needs.should_run.outputs.javascript_changed == 'true'
+    if: github.event_name == 'workflow_dispatch' ||
+      (needs.should_run.outputs.javascript_changed == 'true' ||
+      needs.should_run.outputs.deps_changed == 'true')
     runs-on: ubuntu-latest
 
     strategy:
@@ -58,18 +59,16 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Linting
       run: npm run lint
-    - name: Inspect Lockfile
-      run: npm run lint:lockfile
 
   ci:
     needs:
-      - skip_if_release
       - should_run
-    if: needs.skip_if_release.outputs.should_skip != 'true'
-      || needs.should_run.outputs.javascript_changed == 'true'
+    if: github.event_name == 'workflow_dispatch' ||
+      (needs.should_run.outputs.javascript_changed == 'true' ||
+      needs.should_run.outputs.deps_changed == 'true')
     runs-on: ubuntu-latest
 
     strategy:
@@ -84,16 +83,16 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run CI Script Unit Tests
       run: npm run unit:scripts
 
   unit:
     needs:
-      - skip_if_release
       - should_run
-    if: needs.skip_if_release.outputs.should_skip != 'true'
-      || needs.should_run.outputs.javascript_changed == 'true'
+    if: github.event_name == 'workflow_dispatch' ||
+      (needs.should_run.outputs.javascript_changed == 'true' ||
+      needs.should_run.outputs.deps_changed == 'true')
     runs-on: ubuntu-latest
 
     strategy:
@@ -108,7 +107,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Unit Tests
       run: npm run unit
     - name: Archive Unit Test Coverage
@@ -119,10 +118,10 @@ jobs:
 
   integration:
     needs:
-      - skip_if_release
       - should_run
-    if: needs.skip_if_release.outputs.should_skip != 'true'
-      || needs.should_run.outputs.javascript_changed == 'true'
+    if: github.event_name == 'workflow_dispatch' ||
+      (needs.should_run.outputs.javascript_changed == 'true' ||
+      needs.should_run.outputs.deps_changed == 'true')
     runs-on: ubuntu-latest
 
     env:
@@ -140,7 +139,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Docker Services
       run: npm run services
     - name: Run Integration Tests
@@ -160,10 +159,10 @@ jobs:
 
   versioned-internal:
     needs:
-      - skip_if_release
       - should_run
-    if: needs.skip_if_release.outputs.should_skip != 'true'
-      || needs.should_run.outputs.javascript_changed == 'true'
+    if: github.event_name == 'workflow_dispatch' ||
+      (needs.should_run.outputs.javascript_changed == 'true' ||
+      needs.should_run.outputs.deps_changed == 'true')
     runs-on: ${{ github.ref == 'refs/heads/main' && vars.NR_RUNNER || 'ubuntu-latest' }}
 
     strategy:
@@ -178,7 +177,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Docker Services
       run: npm run services
     - name: Run Versioned Tests
@@ -211,10 +210,10 @@ jobs:
   # There is no coverage for external as that's tracked in their respective repos
   versioned-external:
     needs:
-      - skip_if_release
       - should_run
-    if: needs.skip_if_release.outputs.should_skip != 'true'
-      || needs.should_run.outputs.javascript_changed == 'true'
+    if: github.event_name == 'workflow_dispatch' ||
+      (needs.should_run.outputs.javascript_changed == 'true' ||
+      needs.should_run.outputs.deps_changed == 'true')
     runs-on: ${{ github.ref == 'refs/heads/main' && vars.NR_RUNNER || 'ubuntu-latest' }}
 
     strategy:
@@ -229,7 +228,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Versioned Tests
       run: TEST_CHILD_TIMEOUT=600000 npm run versioned:external
       env:

.github/workflows/compatibility-report.yml

@@ -54,17 +54,64 @@ jobs:
           path: compatibility.md
 
       # Generate the new PR to update the doc in the repo.
-      - run: |
-          git config user.name $GITHUB_ACTOR
-          git config user.email gh-actions-${GITHUB_ACTOR}@github.com
       - run: |
           rm -f status.log
       - uses: peter-evans/create-pull-request@6d6857d36972b65feb161a90e484f2984215f83e
         with:
+          token: ${{ secrets.NODE_AGENT_GH_TOKEN || secrets.GITHUB_TOKEN }}
           title: "docs: Updated compatibility report"
           commit-message: "docs: Updated compatibility report"
           branch: "compatibility-report/auto-update"
           delete-branch: true
           base: main
           labels: "documentation"
 
+  docs:
+    runs-on: ubuntu-latest
+    if:
+      github.event_name == 'push' ||
+      (github.event.workflow_run && github.event.workflow_run.conclusion == 'success') ||
+      (github.event_name == 'workflow_dispatch' &&
+      (inputs.repo_target == 'docs' || inputs.repo_target == 'both'))
+    env:
+      DOCS_TARGET: src/content/docs/apm/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.mdx
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: agent
+      - uses: actions/checkout@v4
+        with:
+          repository: newrelic/docs-website
+          path: docs
+      - uses: jaxxstorm/action-install-gh-release@71d17cb091aa850acb2a1a4cf87258d183eb941b
+        with:
+          repo: newrelic/newrelic-node-versions
+          platform: linux
+          arch: amd64
+          cache: enable
+      - run: |
+          nrversions -v -r agent -R ./docs/${DOCS_TARGET} 2>docs-status.log
+
+      # Upload generated artifacts for potential debugging purposes.
+      - uses: actions/upload-artifact@v4
+        with:
+          name: docs-status.log
+          path: docs-status.log
+      - uses: actions/upload-artifact@v4
+        with:
+          name: compatibility-requirements-nodejs-agent.mdx
+          path: docs/${{ env.DOCS_TARGET }}
+
+      # Generate the new PR to update the doc in the repo.
+      - run: |
+          rm -f docs-status.log
+      - uses: peter-evans/create-pull-request@6d6857d36972b65feb161a90e484f2984215f83e
+        with:
+          token: ${{ secrets.NODE_AGENT_GH_TOKEN || secrets.GITHUB_TOKEN }}
+          title: "docs: Updated Node.js agent compatibility report"
+          commit-message: "docs: Updated Node.js agent compatibility report"
+          branch: "nodejs-compatibility-report/auto-update"
+          delete-branch: true
+          base: develop
+          path: docs
+          labels: "documentation"

.github/workflows/notify-release.yml

@@ -15,7 +15,7 @@ jobs:
       with:
         node-version: lts/*
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Check for PRs not yet released
       run: node ./bin/pending-prs.js --repos $NR_REPOS --ignore-labels $IGNORE_LABELS
       env:

.github/workflows/post-release.yml

@@ -28,7 +28,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Setup GitHub Credentials
       run: |
         git config user.name $GITHUB_ACTOR

.github/workflows/prep-release.yml

@@ -15,7 +15,7 @@ on:
         default: NEWS.md
       changelog_json:
         description: Whether or not it should generate a changelog.json (should only be for node-newrelic)
-        type: boolean 
+        type: boolean
         required: false
 
 jobs:
@@ -41,7 +41,7 @@ jobs:
         node-version: ${{ matrix.node-version }}
     # Only need to install deps in agent-repo because of the bin scripts
     - name: Install Dependencies
-      run: npm ci --prefix agent-repo
+      run: npm install --prefix agent-repo
     - name: Setup GitHub Credentials
       run: |
         git config user.name $GITHUB_ACTOR

.github/workflows/publish-branch.yml

@@ -19,7 +19,7 @@ jobs:
         node-version: ${{ matrix.node-version }}
         registry-url: 'https://registry.npmjs.org'
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - run: npm publish
       env:
         NODE_AUTH_TOKEN: ${{ secrets.NODE_AGENT_NPM_TOKEN }}

.github/workflows/release-creation.yml

@@ -45,9 +45,9 @@ jobs:
     - name: Install Dependencies
       run: |
         # Install deps in caller repo
-        npm ci
+        npm install
         # Install deps in agent repo
-        npm ci --prefix agent-repo
+        npm install --prefix agent-repo
     - name: Setup GitHub Credentials
       run: |
         git config user.name $GITHUB_ACTOR

.github/workflows/smoke-test-workflow.yml

@@ -25,7 +25,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Smoke Tests
       run: npm run smoke
       env:

.github/workflows/update-snyk-prs.yml

@@ -11,15 +11,15 @@ jobs:
     permissions:
       pull-requests: write
     runs-on: ubuntu-latest
-    if:  ${{ github.event.sender.login == 'snyk-bot' }} 
+    if:  ${{ github.event.sender.login == 'snyk-bot' }}
     steps:
       - uses: actions/checkout@v3
       - name: Use Node.js LTS
         uses: actions/setup-node@v3
         with:
           node-version: lts/*
       - name: Install Dependencies
-        run: npm ci
+        run: npm install
       - name: Update Snyk PR Title
         run: node ./bin/update-snyk-pr.js'
         env:

.github/workflows/versioned-coverage.yml

@@ -27,7 +27,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Run Docker Services
       run: npm run services
     - name: Run Legacy Context Versioned Tests

.github/workflows/versioned-security-agent.yml

@@ -82,7 +82,7 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
     - name: Install Dependencies
-      run: npm ci
+      run: npm install
     - name: Install Version ${{ inputs.version }} of security agent
       if: ${{ inputs.version }}
       run: npm install @newrelic/security-agent@${{ inputs.version }}

.gitignore

@@ -1,3 +1,4 @@
+package-lock.json
 node_modules
 newrelic_agent.log
 .coverage_data

.npmrc

@@ -0,0 +1 @@
+package-lock=false

CONTRIBUTING.md

@@ -37,13 +37,6 @@ For more information about CLAs, please check out Alex Russell’s excellent
 post, [“Why Do I Need to Sign
 This?”](https://infrequently.org/2008/06/why-do-i-need-to-sign-this/).
 
-### Slack
-
-We host a public Slack with a dedicated channel for contributors and
-maintainers of open source projects hosted by New Relic. If you are
-contributing to this project, you're welcome to request access to the
-\#oss-contributors channel in the newrelicusers.slack.com workspace. To request access, please use this [link](https://join.slack.com/t/newrelicusers/shared_invite/zt-1ayj69rzm-~go~Eo1whIQGYnu3qi15ng).
-
 ## PR Guidelines
 
 ### Version Support