feat: support NETLIFY_DEPLOY_SOURCE env var (#8183)

🎉 Thanks for submitting a pull request! 🎉

#### Summary

- Lets callers that embed the CLI (e.g. the Agent Runner orchestrator)
override the hardcoded `deploy_source: 'cli'` in create-deploy requests
by setting a `NETLIFY_DEPLOY_SOURCE` env var. Default behavior is
unchanged — when the var is unset, the CLI still sends `'cli'`.
- This unblocks the orchestrator from tagging AR-originated deploys as
`agent_runner` so the dashboard can show "Last deployed from Agent
Runners" instead of "CLI" / "API" on the site overview.
- Applied to both deploy paths in `src/commands/deploy/deploy.ts` (build
and `--no-build`), with a new integration test covering the override.
- Fixes:
https://linear.app/netlify/issue/EX-2032/last-deployed-from-ardrop-label-followup
- netlify/agent-runner-orchestrator#750

<!--
Explain the **motivation** for making this change. What existing problem
does the pull request solve and how?
-->

---

For us to review and ship your PR efficiently, please perform the
following steps:

- [ ] Open a
[bug/issue](https://github.com/netlify/cli/issues/new/choose) before
writing your code 🧑‍💻. This ensures we can discuss the changes and get
feedback from everyone that should be involved. If you\`re fixing a typo
or something that\`s on fire 🔥 (e.g. incident related), you can skip
this step.
- [ ] Read the [contribution guidelines](../CONTRIBUTING.md) 📖. This
ensures your code follows our style guide and
      passes our tests.
- [ ] Update or add tests (if any source code was changed or added) 🧪
- [ ] Update or add documentation (if features were changed or added) 📝
- [ ] Make sure the status checks below are successful ✅

**A picture of a cute animal (not mandatory, but encouraged)**

Author: amun-sihra

src/commands/deploy/deploy.ts

@@ -585,7 +585,7 @@ const runDeploy = async ({
         draft,
         branch: alias,
         include_upload_url: options.uploadSourceZip,
-        deploy_source: 'cli',
+        deploy_source: process.env.NETLIFY_DEPLOY_SOURCE || 'cli',
       }
 
       const createDeployResponse = await api.createSiteDeploy({ siteId, title, body: createDeployBody })
@@ -1363,7 +1363,12 @@ export const deploy = async (options: DeployOptionValues, command: BaseCommand)
     }
 
     const draft = options.draft || (!deployToProduction && !alias)
-    const createDeployBody = { draft, branch: alias, include_upload_url: options.uploadSourceZip, deploy_source: 'cli' }
+    const createDeployBody = {
+      draft,
+      branch: alias,
+      include_upload_url: options.uploadSourceZip,
+      deploy_source: process.env.NETLIFY_DEPLOY_SOURCE || 'cli',
+    }
 
     // TODO: Type this properly in `@netlify/api`.
     const deployMetadata = (await api.createSiteDeploy({

tests/integration/commands/deploy/deploy.test.ts

@@ -1507,6 +1507,34 @@ describe.concurrent('deploy command', () => {
     })
   })
 
+  test('should honor NETLIFY_DEPLOY_SOURCE env var in create deploy request', async (t) => {
+    await withMockDeploy(async (mockApi) => {
+      await withSiteBuilder(t, async (builder) => {
+        builder.withContentFile({
+          path: 'public/index.html',
+          content: '<h1>test</h1>',
+        })
+
+        await builder.build()
+
+        await callCli(
+          ['deploy', '--json', '--no-build', '--dir', 'public'],
+          getCLIOptions({
+            apiUrl: mockApi.apiUrl,
+            builder,
+            env: { NETLIFY_DEPLOY_SOURCE: 'agent_runner' },
+          }),
+        ).then(parseDeploy)
+
+        const createDeployRequest = mockApi.requests.find(
+          (req) => req.method === 'POST' && req.path === '/api/v1/sites/site_id/deploys',
+        )
+        expect(createDeployRequest).toBeDefined()
+        expect((createDeployRequest!.body as Record<string, unknown>).deploy_source).toBe('agent_runner')
+      })
+    })
+  })
+
   test('should include build_version in deploy body', async (t) => {
     await withMockDeploy(async (mockApi, deployState) => {
       await withSiteBuilder(t, async (builder) => {