agentics copy (#3924)

* add agentics

* feat: add weekly research workflow and agentics management commands

- Introduced a new GitHub Actions workflow for weekly research, scheduled to run every Monday at 9AM UTC. This workflow performs deep research on the repository and related industry, creating a discussion with findings.
- Added `agentics-add` and `agentics-update` commands to the Makefile for managing agentics from the githubnext/agentics repository.

* fix: update workflow source references in ci-doctor and technical-doc-writer files

* Remove daily test coverage improver workflow and update technical doc writer action to maintain compatibility with GitHub Copilot.

Author: pelikhan

.github/aw/actions-lock.json

@@ -10,6 +10,11 @@
       "version": "v4",
       "sha": "0057852bfaa89a56745cba8c7296529d2fc39830"
     },
+    "actions/checkout@v4": {
+      "repo": "actions/checkout",
+      "version": "v4",
+      "sha": "08eba0b27e820071cde6df949e0beb9ba4906955"
+    },
     "actions/checkout@v5": {
       "repo": "actions/checkout",
       "version": "v5",

.github/workflows/ci-doctor.lock.yml …ub/workflows/agentics/ci-doctor.lock.yml.github/workflows/ci-doctor.lock.yml renamed to .github/workflows/agentics/ci-doctor.lock.yml .github/workflows/ci-doctor.lock.yml renamed to .github/workflows/agentics/ci-doctor.lock.yml

@@ -3,7 +3,9 @@
 #   gh aw compile
 # For more information: https://github.com/githubnext/gh-aw/blob/main/.github/instructions/github-agentic-workflows.instructions.md
 #
-# Source: githubnext/agentics/workflows/ci-doctor.md
+# Source: githubnext/agentics/workflows/ci-doctor.md@9586b5fc47d008cd1cf42f6c298a46abfd774fb5
+#
+# Effective stop-time: 2025-11-16 04:52:03
 #
 # Job Dependency Graph:
 # ```mermaid
@@ -14,6 +16,8 @@
 #   create_issue["create_issue"]
 #   detection["detection"]
 #   missing_tool["missing_tool"]
+#   pre_activation["pre_activation"]
+#   pre_activation --> activation
 #   agent --> add_comment
 #   create_issue --> add_comment
 #   detection --> add_comment
@@ -50,11 +54,7 @@ name: "CI Failure Doctor"
     - Daily Perf Improver
     - Daily Test Coverage Improver
 
-permissions:
-  actions: read
-  contents: read
-  issues: read
-  pull-requests: read
+permissions: read-all
 
 concurrency:
   group: "gh-aw-${{ github.workflow }}"
@@ -63,8 +63,10 @@ run-name: "CI Failure Doctor"
 
 jobs:
   activation:
+    needs: pre_activation
     if: >
-      (github.event.workflow_run.conclusion == 'failure') && ((github.event_name != 'workflow_run') || (github.event.workflow_run.repository.id == github.repository_id))
+      ((needs.pre_activation.outputs.activated == 'true') && (github.event.workflow_run.conclusion == 'failure')) &&
+      ((github.event_name != 'workflow_run') || (github.event.workflow_run.repository.id == github.repository_id))
     runs-on: ubuntu-slim
     permissions:
       contents: read
@@ -197,9 +199,8 @@ jobs:
           GH_AW_CREATED_ISSUE_URL: ${{ needs.create_issue.outputs.issue_url }}
           GH_AW_CREATED_ISSUE_NUMBER: ${{ needs.create_issue.outputs.issue_number }}
           GH_AW_WORKFLOW_NAME: "CI Failure Doctor"
-          GH_AW_WORKFLOW_SOURCE: "githubnext/agentics/workflows/ci-doctor.md"
-          GH_AW_WORKFLOW_SOURCE_URL: "${{ github.server_url }}/githubnext/agentics/tree/main/workflows/ci-doctor.md"
-          GH_AW_CAMPAIGN: "ci-doctor-failures"
+          GH_AW_WORKFLOW_SOURCE: "githubnext/agentics/workflows/ci-doctor.md@9586b5fc47d008cd1cf42f6c298a46abfd774fb5"
+          GH_AW_WORKFLOW_SOURCE_URL: "${{ github.server_url }}/githubnext/agentics/tree/9586b5fc47d008cd1cf42f6c298a46abfd774fb5/workflows/ci-doctor.md"
         with:
           github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
           script: |
@@ -569,11 +570,7 @@ jobs:
   agent:
     needs: activation
     runs-on: ubuntu-latest
-    permissions:
-      actions: read
-      contents: read
-      issues: read
-      pull-requests: read
+    permissions: read-all
     concurrency:
       group: "gh-aw-copilot-${{ github.workflow }}"
     env:
@@ -1591,7 +1588,7 @@ jobs:
           
           ### Phase 3: Historical Context Analysis  
           1. **Search Investigation History**: Use file-based storage to search for similar failures:
-             - Read from cached investigation files in `/tmp/gh-aw/memory/investigations/`
+             - Read from cached investigation files in `/tmp/memory/investigations/`
              - Parse previous failure patterns and solutions
              - Look for recurring error signatures
           2. **Issue History**: Search existing issues for related problems
@@ -1615,8 +1612,8 @@ jobs:
           
           ### Phase 5: Pattern Storage and Knowledge Building
           1. **Store Investigation**: Save structured investigation data to files:
-             - Write investigation report to `/tmp/gh-aw/memory/investigations/<timestamp>-<run-id>.json`
-             - Store error patterns in `/tmp/gh-aw/memory/patterns/`
+             - Write investigation report to `/tmp/memory/investigations/<timestamp>-<run-id>.json`
+             - Store error patterns in `/tmp/memory/patterns/`
              - Maintain an index file of all investigations for fast searching
           2. **Update Pattern Database**: Enhance knowledge with new findings by updating pattern files
           3. **Save Artifacts**: Store detailed logs and analysis in the cached directories
@@ -1699,8 +1696,8 @@ jobs:
           
           ## Cache Usage Strategy
           
-          - Store investigation database and knowledge patterns in `/tmp/gh-aw/memory/investigations/` and `/tmp/gh-aw/memory/patterns/`
-          - Cache detailed log analysis and artifacts in `/tmp/gh-aw/investigation/logs/` and `/tmp/gh-aw/investigation/reports/`
+          - Store investigation database and knowledge patterns in `/tmp/memory/investigations/` and `/tmp/memory/patterns/`
+          - Cache detailed log analysis and artifacts in `/tmp/investigation/logs/` and `/tmp/investigation/reports/`
           - Persist findings across workflow runs using GitHub Actions cache
           - Build cumulative knowledge about failure patterns and solutions using structured JSON files
           - Use file-based indexing for fast pattern matching and similarity detection
@@ -4206,9 +4203,8 @@ jobs:
           GH_AW_AGENT_OUTPUT: ${{ env.GH_AW_AGENT_OUTPUT }}
           GH_AW_ISSUE_TITLE_PREFIX: "${{ github.workflow }}"
           GH_AW_WORKFLOW_NAME: "CI Failure Doctor"
-          GH_AW_WORKFLOW_SOURCE: "githubnext/agentics/workflows/ci-doctor.md"
-          GH_AW_WORKFLOW_SOURCE_URL: "${{ github.server_url }}/githubnext/agentics/tree/main/workflows/ci-doctor.md"
-          GH_AW_CAMPAIGN: "ci-doctor-failures"
+          GH_AW_WORKFLOW_SOURCE: "githubnext/agentics/workflows/ci-doctor.md@9586b5fc47d008cd1cf42f6c298a46abfd774fb5"
+          GH_AW_WORKFLOW_SOURCE_URL: "${{ github.server_url }}/githubnext/agentics/tree/9586b5fc47d008cd1cf42f6c298a46abfd774fb5/workflows/ci-doctor.md"
         with:
           github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
           script: |
@@ -4803,9 +4799,8 @@ jobs:
         env:
           GH_AW_AGENT_OUTPUT: ${{ env.GH_AW_AGENT_OUTPUT }}
           GH_AW_WORKFLOW_NAME: "CI Failure Doctor"
-          GH_AW_WORKFLOW_SOURCE: "githubnext/agentics/workflows/ci-doctor.md"
-          GH_AW_WORKFLOW_SOURCE_URL: "${{ github.server_url }}/githubnext/agentics/tree/main/workflows/ci-doctor.md"
-          GH_AW_CAMPAIGN: "ci-doctor-failures"
+          GH_AW_WORKFLOW_SOURCE: "githubnext/agentics/workflows/ci-doctor.md@9586b5fc47d008cd1cf42f6c298a46abfd774fb5"
+          GH_AW_WORKFLOW_SOURCE_URL: "${{ github.server_url }}/githubnext/agentics/tree/9586b5fc47d008cd1cf42f6c298a46abfd774fb5/workflows/ci-doctor.md"
         with:
           github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
           script: |
@@ -4909,3 +4904,46 @@ jobs:
               core.setFailed(`Error processing missing-tool reports: ${error}`);
             });
 
+  pre_activation:
+    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+    runs-on: ubuntu-slim
+    outputs:
+      activated: ${{ steps.check_stop_time.outputs.stop_time_ok == 'true' }}
+    steps:
+      - name: Check stop-time limit
+        id: check_stop_time
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8
+        env:
+          GH_AW_STOP_TIME: 2025-11-16 04:52:03
+          GH_AW_WORKFLOW_NAME: "CI Failure Doctor"
+        with:
+          script: |
+            async function main() {
+              const stopTime = process.env.GH_AW_STOP_TIME;
+              const workflowName = process.env.GH_AW_WORKFLOW_NAME;
+              if (!stopTime) {
+                core.setFailed("Configuration error: GH_AW_STOP_TIME not specified.");
+                return;
+              }
+              if (!workflowName) {
+                core.setFailed("Configuration error: GH_AW_WORKFLOW_NAME not specified.");
+                return;
+              }
+              core.info(`Checking stop-time limit: ${stopTime}`);
+              const stopTimeDate = new Date(stopTime);
+              if (isNaN(stopTimeDate.getTime())) {
+                core.setFailed(`Invalid stop-time format: ${stopTime}. Expected format: YYYY-MM-DD HH:MM:SS`);
+                return;
+              }
+              const currentTime = new Date();
+              core.info(`Current time: ${currentTime.toISOString()}`);
+              core.info(`Stop time: ${stopTimeDate.toISOString()}`);
+              if (currentTime >= stopTimeDate) {
+                core.warning(`⏰ Stop time reached. Workflow execution will be prevented by activation job.`);
+                core.setOutput("stop_time_ok", "false");
+                return;
+              }
+              core.setOutput("stop_time_ok", "true");
+            }
+            await main();
+

.github/workflows/ci-doctor.md .github/workflows/agentics/ci-doctor.md.github/workflows/ci-doctor.md renamed to .github/workflows/agentics/ci-doctor.md

@@ -1,32 +1,35 @@
 ---
-if: ${{ github.event.workflow_run.conclusion == 'failure' }}
-network: defaults
 on:
   workflow_run:
+    workflows: ["Daily Perf Improver", "Daily Test Coverage Improver"]  # Monitor the CI workflow specifically
     types:
-    - completed
-    workflows:
-    - Daily Perf Improver
-    - Daily Test Coverage Improver
+      - completed
     branches:
       - main
-permissions:
-  contents: read
-  issues: read
-  pull-requests: read
-  actions: read
-campaign: ci-doctor-failures
+    # This will trigger only when the CI workflow completes with failure
+    # The condition is handled in the workflow body
+  stop-after: +48h
+
+# Only trigger for failures - check in the workflow body
+if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+
+permissions: read-all
+
+network: defaults
+
 safe-outputs:
-  add-comment: null
   create-issue:
-    title-prefix: ${{ github.workflow }}
-source: githubnext/agentics/workflows/ci-doctor.md
-timeout-minutes: 10
+    title-prefix: "${{ github.workflow }}"
+  add-comment:
+
 tools:
   cache-memory: true
-  web-fetch: null
-  web-search: null
-strict: true
+  web-fetch:
+  web-search:
+
+timeout-minutes: 10
+
+source: githubnext/agentics/workflows/ci-doctor.md@9586b5fc47d008cd1cf42f6c298a46abfd774fb5
 ---
 # CI Failure Doctor
 
@@ -68,7 +71,7 @@ You are the CI Failure Doctor, an expert investigative agent that analyzes faile
 
 ### Phase 3: Historical Context Analysis  
 1. **Search Investigation History**: Use file-based storage to search for similar failures:
-   - Read from cached investigation files in `/tmp/gh-aw/memory/investigations/`
+   - Read from cached investigation files in `/tmp/memory/investigations/`
    - Parse previous failure patterns and solutions
    - Look for recurring error signatures
 2. **Issue History**: Search existing issues for related problems
@@ -92,8 +95,8 @@ You are the CI Failure Doctor, an expert investigative agent that analyzes faile
 
 ### Phase 5: Pattern Storage and Knowledge Building
 1. **Store Investigation**: Save structured investigation data to files:
-   - Write investigation report to `/tmp/gh-aw/memory/investigations/<timestamp>-<run-id>.json`
-   - Store error patterns in `/tmp/gh-aw/memory/patterns/`
+   - Write investigation report to `/tmp/memory/investigations/<timestamp>-<run-id>.json`
+   - Store error patterns in `/tmp/memory/patterns/`
    - Maintain an index file of all investigations for fast searching
 2. **Update Pattern Database**: Enhance knowledge with new findings by updating pattern files
 3. **Save Artifacts**: Store detailed logs and analysis in the cached directories
@@ -176,8 +179,8 @@ When creating an investigation issue, use this structure:
 
 ## Cache Usage Strategy
 
-- Store investigation database and knowledge patterns in `/tmp/gh-aw/memory/investigations/` and `/tmp/gh-aw/memory/patterns/`
-- Cache detailed log analysis and artifacts in `/tmp/gh-aw/investigation/logs/` and `/tmp/gh-aw/investigation/reports/`
+- Store investigation database and knowledge patterns in `/tmp/memory/investigations/` and `/tmp/memory/patterns/`
+- Cache detailed log analysis and artifacts in `/tmp/investigation/logs/` and `/tmp/investigation/reports/`
 - Persist findings across workflow runs using GitHub Actions cache
 - Build cumulative knowledge about failure patterns and solutions using structured JSON files
-- Use file-based indexing for fast pattern matching and similarity detection
+- Use file-based indexing for fast pattern matching and similarity detection