ci(medium): Update manual trigger guide for Jules session invocations (#9508)

arii · google-labs-jules[bot] · web-flow · commit 4ec9a54868e9 · 2026-03-14T13:24:40.000-07:00
Co-authored-by: google-labs-jules[bot] &lt;161369871+google-labs-jules[bot]@users.noreply.github.com&gt;
Co-authored-by: arii &lt;342438+arii@users.noreply.github.com&gt;
diff --git a/.github/actions/setup-env/action.yml b/.github/actions/setup-env/action.yml
@@ -32,7 +32,6 @@ runs:
     - name: 'Setup pnpm'
       uses: pnpm/action-setup@v4
 
-
     - name: 'Setup Node.js'
       uses: actions/setup-node@v4
       with:
diff --git a/.github/automated-labels.json b/.github/automated-labels.json
@@ -1,5 +1,12 @@
 {
-  "review": ["approved", "not approved", "not reviewed", "changes-requested", "ai-reviewed", "ci-failure"],
+  "review": [
+    "approved",
+    "not approved",
+    "not reviewed",
+    "changes-requested",
+    "ai-reviewed",
+    "ci-failure"
+  ],
   "scope_prefix": "scope:",
   "obsolete": [
     "ready-for-approval",
diff --git a/.github/workflows/comment-ops.yml b/.github/workflows/comment-ops.yml
@@ -88,7 +88,7 @@ jobs:
     uses: ./.github/workflows/gemini-coder.yml
     with:
       task_description: ${{ needs.prepare-coder.outputs.task }}
-      branch_name: "ai/comment-task-${{ github.event.issue.number }}-${{ github.run_id }}"
+      branch_name: 'ai/comment-task-${{ github.event.issue.number }}-${{ github.run_id }}'
     secrets: inherit
 
   prepare-review-issues-manual:
@@ -189,6 +189,8 @@ jobs:
               '| `@gemini-triage` | Run Issue Triage |\n' +
               '| `@gemini-coder <task>` | Generate Code |\n' +
               '| `@create-review-issues` | Create issues from review (PR only) |\n' +
+              '| `@jules-new` | Create Jules Session (PR only) |\n' +
+              '| `@jules-delete` | Delete Jules Session (PR only) |\n' +
               '| `@gemini-help` | Show this help message |\n' +
               '| `@pr-squash` | Squash PR commits (PR only) |\n' +
               '| `@conflict-resolve` | Resolve merge conflicts (PR only) |\n\n' +
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -23,7 +23,6 @@ jobs:
       - name: 📦 Setup pnpm
         uses: pnpm/action-setup@v4
 
-
       - name: 🟢 Setup Node.js
         uses: actions/setup-node@v6
         with:
diff --git a/.github/workflows/gemini-coder.yml b/.github/workflows/gemini-coder.yml
@@ -91,7 +91,6 @@ jobs:
       (github.event_name == 'workflow_dispatch' || github.event_name == 'workflow_call') ||
       (vars.GEMINI_ENABLE_CODER != 'false' && github.event.label.name == 'auto-code')
     runs-on: self-hosted
-
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -332,7 +331,6 @@ jobs:
         if: env.AGENT_PROVIDER == 'gemini'
         uses: pnpm/action-setup@v4
 
-
       - name: 'Gemini: Setup Node.js'
         if: env.AGENT_PROVIDER == 'gemini'
         uses: actions/setup-node@v6
diff --git a/.github/workflows/jules-session-manager.yml b/.github/workflows/jules-session-manager.yml
@@ -7,7 +7,7 @@ on:
 
 permissions:
   contents: read
-  pull-requests: read
+  pull-requests: write
   issues: write
 
 jobs:
@@ -25,7 +25,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.10'
 
@@ -195,7 +195,7 @@ jobs:
 
       - name: 'Add Reaction to Comment'
         if: success()
-        uses: actions/github-script@v6
+        uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -207,15 +207,15 @@ jobs:
             })
       - name: 'Handle Failure'
         if: failure()
-        uses: actions/github-script@v6
+        uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
             const errorMessageNew = `${{ steps.jules_op_new.outputs.error_message || '' }}`;
             const errorMessageDelete = `${{ steps.jules_op_delete.outputs.error_message || '' }}`;
-            const errorMessage = errorMessageNew || errorMessageDelete || 'Unknown error occurred';
+            const errorMessage = errorMessageNew || errorMessageDelete || 'Unknown network or resolution error';
 
-            const body = `Jules operation failed with the following error:\n\n\`\`\`\n${errorMessage}\n\`\`\``;
+            const body = `### ❌ Jules Operation Failed\n\n**Error Details:**\n\`\`\`\n${errorMessage}\n\`\`\`\n\nPlease check the [Action Logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) for details.`;
 
             try {
               github.rest.reactions.createForIssueComment({
diff --git a/.github/workflows/manual-release-local.yml b/.github/workflows/manual-release-local.yml
@@ -33,7 +33,6 @@ jobs:
       - name: 📦 Setup pnpm
         uses: pnpm/action-setup@v4
 
-
       # Caching is disabled for self-hosted runners to improve performance.
       - name: 🟢 Setup Node.js
         uses: actions/setup-node@v6
diff --git a/.github/workflows/reusable-jules-command.yml b/.github/workflows/reusable-jules-command.yml
@@ -36,7 +36,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.10'
 
@@ -207,7 +207,7 @@ jobs:
 
       - name: 'Add Reaction to Comment'
         if: success()
-        uses: actions/github-script@v6
+        uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GH_TOKEN }}
           script: |
@@ -219,15 +219,15 @@ jobs:
             })
       - name: 'Handle Failure'
         if: failure()
-        uses: actions/github-script@v6
+        uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GH_TOKEN }}
           script: |
             const errorMessageNew = `${{ steps.jules_op_new.outputs.error_message || '' }}`;
             const errorMessageDelete = `${{ steps.jules_op_delete.outputs.error_message || '' }}`;
-            const errorMessage = errorMessageNew || errorMessageDelete || 'Unknown error occurred';
+            const errorMessage = errorMessageNew || errorMessageDelete || 'Unknown network or resolution error';
 
-            const body = `Jules operation failed with the following error:\n\n\`\`\`\n${errorMessage}\n\`\`\``;
+            const body = `### ❌ Jules Operation Failed\n\n**Error Details:**\n\`\`\`\n${errorMessage}\n\`\`\`\n\nPlease check the [Action Logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) for details.`;
 
             try {
               github.rest.reactions.createForIssueComment({
diff --git a/README.md b/README.md
@@ -324,16 +324,17 @@ Playwright tests live in `tests/playwright/core-functionality.spec.ts`; baseline
 
 You can interact with the project's automation workflows by using the following commands in pull request or issue comments.
 
-| Command             | Description                                                                                  | Example              |
-| ------------------- | -------------------------------------------------------------------------------------------- | -------------------- |
-| `@pr-squash`        | Squashes all commits in a pull request into a single commit.                                 | `@pr-squash`         |
-| `@pr-squash-rebase`      | Squashes all commits and rebases the pull request on top of the base branch.        | `@pr-squash-rebase`           |
-| `@create-review-issues`  | Creates follow-up issues based on the content of a pull request review.             | `@create-review-issues`       |
-| `@gemini-bot`            | Invokes the Gemini AI to perform tasks like code review or code generation.         | `@gemini-bot`                 |
-| `@gemini-triage`         | Invokes the Gemini AI to perform issue triage (labels, priority, etc.).             | `@gemini-triage`              |
-| `@gemini-coder <task>`   | Invokes the Gemini AI to generate code based on the task description.               | `@gemini-coder add unit test` |
-| `@jules fix`             | (Legacy) Invokes the Jules AI to perform a code review.                             | `@jules fix`                  |
-| `@gemini-update-pr`      | Triggers a workflow to update the pull request with the latest changes from the base. | `@gemini-update-pr`           |
+| Command                 | Description                                                                           | Example                       |
+| ----------------------- | ------------------------------------------------------------------------------------- | ----------------------------- |
+| `@pr-squash`            | Squashes all commits in a pull request into a single commit.                          | `@pr-squash`                  |
+| `@pr-squash-rebase`     | Squashes all commits and rebases the pull request on top of the base branch.          | `@pr-squash-rebase`           |
+| `@create-review-issues` | Creates follow-up issues based on the content of a pull request review.               | `@create-review-issues`       |
+| `@gemini-bot`           | Invokes the Gemini AI to perform tasks like code review or code generation.           | `@gemini-bot`                 |
+| `@gemini-triage`        | Invokes the Gemini AI to perform issue triage (labels, priority, etc.).               | `@gemini-triage`              |
+| `@gemini-coder <task>`  | Invokes the Gemini AI to generate code based on the task description.                 | `@gemini-coder add unit test` |
+| `@jules-new`            | Initializes a Jules coding session for the pull request.                              | `@jules-new`                  |
+| `@jules-delete`         | Terminates the active Jules coding session.                                           | `@jules-delete`               |
+| `@gemini-update-pr`     | Triggers a workflow to update the pull request with the latest changes from the base. | `@gemini-update-pr`           |
 
 For more details on manual triggers and CLI commands, see the [Manual Trigger Reference](docs/workflows/MANUAL_TRIGGERS.md).
 
diff --git a/deploy/runner/.env.runner.example b/deploy/runner/.env.runner.example
@@ -25,3 +25,6 @@ RUNNER_MEMORY_LIMIT=
 
 # CPU limit (e.g., 2 for 2 CPUs, 0.5 for half a CPU)
 RUNNER_CPU_LIMIT=
+
+# Optional: Set to true to use the host's network stack (resolves DNS/isolation issues)
+RUNNER_NETWORK_HOST=false
diff --git a/deploy/runner/deploy-runner.sh b/deploy/runner/deploy-runner.sh
@@ -203,9 +203,16 @@ fi
 DOCKER_ARGS+=(
   "-e" "REPO_URL=$REPO_URL"
   "-e" "RUNNER_TOKEN=$RUNNER_TOKEN"
-  "hrm-actions-runner"
 )
 
+# Use host network for DNS resolution if configured
+if [ "${RUNNER_NETWORK_HOST:-false}" = "true" ]; then
+  echo "Using host network for runner container..."
+  DOCKER_ARGS+=("--network=host")
+fi
+
+DOCKER_ARGS+=("hrm-actions-runner")
+
 # Execute the command
 docker run "${DOCKER_ARGS[@]}"
 
diff --git a/docs/workflows/MANUAL_TRIGGERS.md b/docs/workflows/MANUAL_TRIGGERS.md
@@ -4,14 +4,16 @@ This document provides a comprehensive guide for manually invoking Gemini AI wor
 
 ## Summary Table
 
-| Workflow | Comment Command | Workflow Dispatch Input | CLI Command |
-| :--- | :--- | :--- | :--- |
-| **PR Review** | `@gemini-bot` | `pr_number` (string) | `gh workflow run reusable-gemini-review.yml -f pr_number=123` |
-| **Issue Triage** | `@gemini-triage` | `issue_number` (number) | `gh workflow run gemini-triage.yml -f issue_number=456` |
-| **Code Generation** | `@gemini-coder <task>` | `task_description` (string) | `gh workflow run gemini-coder.yml -f task_description="..."` |
-| **Create Issues** | `@create-review-issues` | `pr_number` (string), `run_id` (string) | `gh workflow run reusable-create-review-issues.yml -f pr_number=123 -f run_id=...` |
-| **PR Squash** | `@pr-squash` | N/A | N/A |
-| **Conflict Resolve** | `@conflict-resolve` | N/A | N/A |
+| Workflow                 | Comment Command         | Workflow Dispatch Input                 | CLI Command                                                                        |
+| :----------------------- | :---------------------- | :-------------------------------------- | :--------------------------------------------------------------------------------- |
+| **PR Review**            | `@gemini-bot`           | `pr_number` (string)                    | `gh workflow run reusable-gemini-review.yml -f pr_number=123`                      |
+| **Issue Triage**         | `@gemini-triage`        | `issue_number` (number)                 | `gh workflow run gemini-triage.yml -f issue_number=456`                            |
+| **Code Generation**      | `@gemini-coder <task>`  | `task_description` (string)             | `gh workflow run gemini-coder.yml -f task_description="..."`                       |
+| **Create Issues**        | `@create-review-issues` | `pr_number` (string), `run_id` (string) | `gh workflow run reusable-create-review-issues.yml -f pr_number=123 -f run_id=...` |
+| **PR Squash**            | `@pr-squash`            | N/A                                     | N/A                                                                                |
+| **Conflict Resolve**     | `@conflict-resolve`     | N/A                                     | N/A                                                                                |
+| **Create Jules Session** | `@jules-new`            | N/A                                     | N/A                                                                                |
+| **Delete Jules Session** | `@jules-delete`         | N/A                                     | N/A                                                                                |
 
 ---
 
@@ -20,12 +22,15 @@ This document provides a comprehensive guide for manually invoking Gemini AI wor
 Automated triage analyzes new issues, applies labels, assesses priority, and suggests improved titles/descriptions.
 
 ### Triggering via Comment
+
 Post a comment on any issue:
+
 ```
 @gemini-triage
 ```
 
 ### Triggering via GitHub Actions UI
+
 1. Navigate to **Actions** -> **Gemini Smart Triage**.
 2. Click **Run workflow**.
 3. Enter the **Issue number** to triage.
@@ -37,12 +42,15 @@ Post a comment on any issue:
 Generates an AI-powered code review for a pull request.
 
 ### Triggering via Comment
+
 Post a comment on a pull request:
+
 ```
 @gemini-bot
 ```
 
 ### Triggering via GitHub Actions UI
+
 1. Navigate to **Actions** -> **Reusable Gemini Review**.
 2. Click **Run workflow**.
 3. Enter the **PR number**.
@@ -55,12 +63,15 @@ Post a comment on a pull request:
 Generates a patch and creates a pull request based on a task description.
 
 ### Triggering via Comment
+
 Post a comment on an issue or PR:
+
 ```
 @gemini-coder Implement a new utility for date formatting in lib/utils.ts
 ```
 
 ### Triggering via GitHub Actions UI
+
 1. Navigate to **Actions** -> **Gemini Coder**.
 2. Click **Run workflow**.
 3. Enter the **Task description**.
@@ -73,21 +84,51 @@ Post a comment on an issue or PR:
 Creates follow-up issues for bugs or technical debt identified during an AI review.
 
 ### Triggering via Comment
+
 Post a comment on a pull request:
+
 ```
 @create-review-issues
 ```
-*Note: This command uses the artifacts from the current workflow run.*
+
+_Note: This command uses the artifacts from the current workflow run._
 
 ### Triggering via GitHub Actions UI
+
 1. Navigate to **Actions** -> **Reusable Create Review Issues**.
 2. Click **Run workflow**.
 3. Enter the **PR number**.
 4. Enter the **Workflow run ID** containing the `review-result` artifact.
 
 ---
 
-## 5. Cost and Control Guidelines
+## 5. Jules Session Management
+
+Jules coding sessions can be initialized or terminated via pull request comments.
+
+### Creating a Session
+
+Post a comment on a pull request:
+
+```
+@jules-new
+```
+
+This command initializes a new coding session by analyzing the pull request context, including the title, body, comments, reviews, and recent git logs.
+
+### Deleting a Session
+
+Post a comment on a pull request:
+
+```
+@jules-delete
+```
+
+This command terminates the active Jules session. It automatically identifies the session to delete by locating the session ID stored in hidden metadata within the pull request's comment history.
+
+---
+
+## 6. Cost and Control Guidelines
 
 If automatic workflows are disabled via repository variables (e.g., `GEMINI_ENABLE_TRIAGE=false`), manual triggers **will still work**. This allows the team to save costs on routine events while retaining the ability to use AI for specific, high-value tasks.
 
diff --git a/tests/playwright/lib/README.md b/tests/playwright/lib/README.md
@@ -246,6 +246,7 @@ For complex scenarios requiring direct interaction with the application's intern
 
 - **Production Only**: Always wrap the `window.__TEST_CONTROLS__` assignment in a `process.env.NODE_ENV !== 'production'` check to ensure these controls are not exposed in the production build.
 - **TypeScript Definitions**: To ensure type safety, you can extend the `Window` interface in a global declaration file (e.g., `types/global.d.ts`):
+
   ```typescript
   export interface TestControls {
     dispatch?: (message: ServerMessage) => void
@@ -258,6 +259,7 @@ For complex scenarios requiring direct interaction with the application's intern
     }
   }
   ```
+
 - **Centralize**: Keep the `__TEST_CONTROLS__` logic in a single, well-defined place within the application to make it easy to manage and discover.
 
 ## Backward Compatibility
