Skip to content

Commit 7a03380

Browse files
authored
Lpcox/migrate to GitHub (#597)
2 parents 2491b68 + 1e5d7c5 commit 7a03380

129 files changed

Lines changed: 2884 additions & 6107 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/agents/create-agentic-workflow.agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ You love to use emojis to make the conversation more engaging.
5959

6060
- Always consult the **instructions file** for schema and features:
6161
- Local copy: @.github/aw/github-agentic-workflows.md
62-
- Canonical upstream: https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/aw/github-agentic-workflows.md
62+
- Canonical upstream: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md
6363
- Key commands:
6464
- `gh aw compile` → compile all workflows
6565
- `gh aw compile <name>` → compile one workflow

.github/agents/debug-agentic-workflow.agent.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The tools output is not visible to the user unless you explicitly print it. Alwa
1818

1919
**Example: Debugging from a workflow run URL**
2020

21-
User: "Investigate the reason there is a missing tool call in this run: https://github.com/githubnext/gh-aw/actions/runs/20135841934"
21+
User: "Investigate the reason there is a missing tool call in this run: https://github.com/github/gh-aw/actions/runs/20135841934"
2222

2323
Your response:
2424
```
@@ -51,7 +51,7 @@ Report back with specific findings and actionable fixes.
5151
- The `gh aw` CLI is already installed in this environment.
5252
- Always consult the **instructions file** for schema and features:
5353
- Local copy: @.github/aw/github-agentic-workflows.md
54-
- Canonical upstream: https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/aw/github-agentic-workflows.md
54+
- Canonical upstream: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md
5555

5656
**Key Commands Available**
5757

@@ -135,7 +135,7 @@ These tools provide the same functionality without requiring GitHub CLI authenti
135135

136136
## Debug Flow: Workflow Run URL Analysis
137137

138-
When the user provides a workflow run URL (e.g., `https://github.com/githubnext/gh-aw/actions/runs/20135841934`):
138+
When the user provides a workflow run URL (e.g., `https://github.com/github/gh-aw/actions/runs/20135841934`):
139139

140140
1. **Extract Run ID**
141141

@@ -338,7 +338,7 @@ Use these tactics when a run is still executing or finishes without artifacts:
338338
- **Polling in-progress runs**: If `gh aw audit <run-id> --json` returns `"status": "in_progress"`, wait ~45s and re-run the command or monitor the run URL directly. Avoid spamming the API—loop with `sleep` intervals.
339339
- **Check run annotations**: `gh run view <run-id>` reveals whether a maintainer cancelled the run. If a manual cancellation is noted, expect missing safe-output artifacts and recommend re-running instead of searching for nonexistent files.
340340
- **Inspect specific job logs**: Use `gh run view --job <job-id> --log` (job IDs are listed in `gh run view <run-id>`) to see the exact failure step.
341-
- **Download targeted artifacts**: When `gh aw logs` would fetch many runs, download only the needed artifact, e.g. `GH_REPO=githubnext/gh-aw gh run download <run-id> -n agent-stdio.log`.
341+
- **Download targeted artifacts**: When `gh aw logs` would fetch many runs, download only the needed artifact, e.g. `GH_REPO=github/gh-aw gh run download <run-id> -n agent-stdio.log`.
342342
- **Review cached run summaries**: `gh aw audit` stores artifacts under `logs/run-<run-id>/`. Inspect `run_summary.json` or `agent-stdio.log` there for offline analysis before re-running workflows.
343343

344344
## Common Issues to Look For

.github/agents/upgrade-agentic-workflows.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Read the ENTIRE content of this file carefully before proceeding. Follow the ins
1515
- The `gh aw` CLI may be available in this environment.
1616
- Always consult the **instructions file** for schema and features:
1717
- Local copy: @.github/aw/github-agentic-workflows.md
18-
- Canonical upstream: https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/aw/github-agentic-workflows.md
18+
- Canonical upstream: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md
1919

2020
**Key Commands Available**
2121

@@ -40,7 +40,7 @@ These tools provide the same functionality through the MCP server without requir
4040
Before upgrading, always review what's new:
4141

4242
1. **Fetch Latest Release Information**
43-
- Use GitHub tools to fetch the CHANGELOG.md from the `githubnext/gh-aw` repository
43+
- Use GitHub tools to fetch the CHANGELOG.md from the `github/gh-aw` repository
4444
- Review and understand:
4545
- Breaking changes
4646
- New features

.github/aw/actions-lock.json

Lines changed: 41 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,15 @@
11
{
22
"entries": {
3+
"actions/cache/restore@v4.3.0": {
4+
"repo": "actions/cache/restore",
5+
"version": "v4.3.0",
6+
"sha": "0057852bfaa89a56745cba8c7296529d2fc39830"
7+
},
8+
"actions/cache/save@v4.3.0": {
9+
"repo": "actions/cache/save",
10+
"version": "v4.3.0",
11+
"sha": "0057852bfaa89a56745cba8c7296529d2fc39830"
12+
},
313
"actions/checkout@v4": {
414
"repo": "actions/checkout",
515
"version": "v4",
@@ -10,16 +20,31 @@
1020
"version": "v5",
1121
"sha": "93cb6efe18208431cddfb8368fd83d5badbf9bfd"
1222
},
13-
"actions/github-script@v8": {
23+
"actions/checkout@v6": {
24+
"repo": "actions/checkout",
25+
"version": "v6",
26+
"sha": "8e8c483db84b4bee98b60c0593521ed34d9990e8"
27+
},
28+
"actions/download-artifact@v6.0.0": {
29+
"repo": "actions/download-artifact",
30+
"version": "v6.0.0",
31+
"sha": "018cc2cf5baa6db3ef3c5f8a56943fffe632ef53"
32+
},
33+
"actions/github-script@v8.0.0": {
1434
"repo": "actions/github-script",
15-
"version": "v8",
35+
"version": "v8.0.0",
1636
"sha": "ed597411d8f924073f98dfc5c65a23a2325f34cd"
1737
},
1838
"actions/setup-go@v6": {
1939
"repo": "actions/setup-go",
2040
"version": "v6",
2141
"sha": "4dc6199c7b1a012772edbd06daecab0f50c9053c"
2242
},
43+
"actions/setup-node@v6.1.0": {
44+
"repo": "actions/setup-node",
45+
"version": "v6.1.0",
46+
"sha": "395ad3262231945c25e8478fd5baf05154b1d79f"
47+
},
2348
"actions/setup-python@v5": {
2449
"repo": "actions/setup-python",
2550
"version": "v5",
@@ -30,6 +55,11 @@
3055
"version": "v5",
3156
"sha": "330a01c490aca151604b8cf639adc76d48f6c5d4"
3257
},
58+
"actions/upload-artifact@v6.0.0": {
59+
"repo": "actions/upload-artifact",
60+
"version": "v6.0.0",
61+
"sha": "b7c566a772e6b6bfb58ed0dc250532a479d7789f"
62+
},
3363
"anchore/sbom-action@v0.20.10": {
3464
"repo": "anchore/sbom-action",
3565
"version": "v0.20.10",
@@ -60,15 +90,20 @@
6090
"version": "v3",
6191
"sha": "c7c53464625b32c7a7e944ae62b3e17d2b600130"
6292
},
63-
"githubnext/gh-aw/actions/setup@v0.35.1": {
64-
"repo": "githubnext/gh-aw/actions/setup",
93+
"github/gh-aw/actions/setup@v0.35.1": {
94+
"repo": "github/gh-aw/actions/setup",
6595
"version": "v0.35.1",
6696
"sha": "d76e21bcc92a3146d915794285b0b32f51d00072"
6797
},
68-
"githubnext/gh-aw/actions/setup@v0.36.0": {
69-
"repo": "githubnext/gh-aw/actions/setup",
98+
"github/gh-aw/actions/setup@v0.36.0": {
99+
"repo": "github/gh-aw/actions/setup",
70100
"version": "v0.36.0",
71101
"sha": "547a146e95910805ca7136cedc9069497c14210d"
102+
},
103+
"githubnext/gh-aw/actions/setup@v0.38.5": {
104+
"repo": "githubnext/gh-aw/actions/setup",
105+
"version": "v0.38.5",
106+
"sha": "c62cb1aecba894a20fdb4c6bbc39992bc6ce37e2"
72107
}
73108
}
74109
}

.github/aw/create-agentic-workflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ You love to use emojis to make the conversation more engaging.
5757

5858
- Always consult the **instructions file** for schema and features:
5959
- Local copy: @.github/aw/github-agentic-workflows.md
60-
- Canonical upstream: https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/aw/github-agentic-workflows.md
60+
- Canonical upstream: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md
6161
- Key commands:
6262
- `gh aw compile` → compile all workflows
6363
- `gh aw compile <name>` → compile one workflow

.github/aw/create-shared-agentic-workflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ mcp-servers:
9393
\`\`\`yaml
9494
mcp-servers:
9595
serena:
96-
container: "ghcr.io/githubnext/serena-mcp-server"
96+
container: "ghcr.io/github/serena-mcp-server"
9797
version: "latest"
9898
args: # args come before the docker image argument
9999
- "-v"

.github/aw/debug-agentic-workflow.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The tools output is not visible to the user unless you explicitly print it. Alwa
1818

1919
**Example: Debugging from a workflow run URL**
2020

21-
User: "Investigate the reason there is a missing tool call in this run: https://github.com/githubnext/gh-aw/actions/runs/20135841934"
21+
User: "Investigate the reason there is a missing tool call in this run: https://github.com/github/gh-aw/actions/runs/20135841934"
2222

2323
Your response:
2424
```
@@ -51,7 +51,7 @@ Report back with specific findings and actionable fixes.
5151
- The `gh aw` CLI is already installed in this environment.
5252
- Always consult the **instructions file** for schema and features:
5353
- Local copy: @.github/aw/github-agentic-workflows.md
54-
- Canonical upstream: https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/aw/github-agentic-workflows.md
54+
- Canonical upstream: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md
5555

5656
**Key Commands Available**
5757

@@ -136,7 +136,7 @@ Report back with specific findings and actionable fixes.
136136

137137
## Debug Flow: Workflow Run URL Analysis
138138

139-
When the user provides a workflow run URL (e.g., `https://github.com/githubnext/gh-aw/actions/runs/20135841934`):
139+
When the user provides a workflow run URL (e.g., `https://github.com/github/gh-aw/actions/runs/20135841934`):
140140

141141
1. **Extract Run ID**
142142

@@ -339,7 +339,7 @@ Use these tactics when a run is still executing or finishes without artifacts:
339339
- **Polling in-progress runs**: If `gh aw audit <run-id> --json` returns `"status": "in_progress"`, wait ~45s and re-run the command or monitor the run URL directly. Avoid spamming the API—loop with `sleep` intervals.
340340
- **Check run annotations**: `gh run view <run-id>` reveals whether a maintainer cancelled the run. If a manual cancellation is noted, expect missing safe-output artifacts and recommend re-running instead of searching for nonexistent files.
341341
- **Inspect specific job logs**: Use `gh run view --job <job-id> --log` (job IDs are listed in `gh run view <run-id>`) to see the exact failure step.
342-
- **Download targeted artifacts**: When `gh aw logs` would fetch many runs, download only the needed artifact, e.g. `GH_REPO=githubnext/gh-aw gh run download <run-id> -n agent-stdio.log`.
342+
- **Download targeted artifacts**: When `gh aw logs` would fetch many runs, download only the needed artifact, e.g. `GH_REPO=github/gh-aw gh run download <run-id> -n agent-stdio.log`.
343343
- **Review cached run summaries**: `gh aw audit` stores artifacts under `logs/run-<run-id>/`. Inspect `run_summary.json` or `agent-stdio.log` there for offline analysis before re-running workflows.
344344

345345
## Common Issues to Look For

.github/aw/github-agentic-workflows.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ The YAML frontmatter supports these fields:
266266
sandbox:
267267
agent: awf # or "srt", or false to disable
268268
mcp: # MCP Gateway configuration (requires mcp-gateway feature flag)
269-
container: ghcr.io/githubnext/mcp-gateway
269+
container: ghcr.io/github/mcp-gateway
270270
port: 8080
271271
api-key: ${{ secrets.MCP_GATEWAY_API_KEY }}
272272
```
@@ -1629,13 +1629,13 @@ Use `gh aw compile --verbose` to see detailed validation messages, or `gh aw com
16291629
### Installation
16301630

16311631
```bash
1632-
gh extension install githubnext/gh-aw
1632+
gh extension install github/gh-aw
16331633
```
16341634

16351635
If there are authentication issues, use the standalone installer:
16361636

16371637
```bash
1638-
curl -O https://raw.githubusercontent.com/githubnext/gh-aw/main/install-gh-aw.sh
1638+
curl -O https://raw.githubusercontent.com/github/gh-aw/main/install-gh-aw.sh
16391639
chmod +x install-gh-aw.sh
16401640
./install-gh-aw.sh
16411641
```
@@ -1664,4 +1664,4 @@ gh aw logs <workflow-id>
16641664

16651665
### Documentation
16661666

1667-
For complete CLI documentation, see: https://githubnext.github.io/gh-aw/setup/cli/
1667+
For complete CLI documentation, see: https://github.github.io/gh-aw/setup/cli/

.github/aw/schemas/agentic-workflow.json

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://github.com/githubnext/gh-aw/schemas/main_workflow_schema.json",
3+
"$id": "https://github.com/github/gh-aw/schemas/main_workflow_schema.json",
44
"title": "GitHub Agentic Workflow Schema",
55
"description": "JSON Schema for validating agentic workflow frontmatter configuration",
66
"version": "1.0.0",
@@ -20,8 +20,8 @@
2020
},
2121
"source": {
2222
"type": "string",
23-
"description": "Optional source reference indicating where this workflow was added from. Format: owner/repo/path@ref (e.g., githubnext/agentics/workflows/ci-doctor.md@v1.0.0). Rendered as a comment in the generated lock file.",
24-
"examples": ["githubnext/agentics/workflows/ci-doctor.md", "githubnext/agentics/workflows/daily-perf-improver.md@1f181b37d3fe5862ab590648f25a292e345b5de6"]
23+
"description": "Optional source reference indicating where this workflow was added from. Format: owner/repo/path@ref (e.g., github/agentics/workflows/ci-doctor.md@v1.0.0). Rendered as a comment in the generated lock file.",
24+
"examples": ["github/agentics/workflows/ci-doctor.md", "github/agentics/workflows/daily-perf-improver.md@1f181b37d3fe5862ab590648f25a292e345b5de6"]
2525
},
2626
"tracker-id": {
2727
"type": "string",
@@ -64,7 +64,7 @@
6464
},
6565
"imports": {
6666
"type": "array",
67-
"description": "Optional array of workflow specifications to import (similar to @include directives but defined in frontmatter). Format: owner/repo/path@ref (e.g., githubnext/agentics/workflows/shared/common.md@v1.0.0). Can be strings or objects with path and inputs. Any markdown files under .github/agents directory are treated as custom agent files and only one agent file is allowed per workflow.",
67+
"description": "Optional array of workflow specifications to import (similar to @include directives but defined in frontmatter). Format: owner/repo/path@ref (e.g., github/agentics/workflows/shared/common.md@v1.0.0). Can be strings or objects with path and inputs. Any markdown files under .github/agents directory are treated as custom agent files and only one agent file is allowed per workflow.",
6868
"items": {
6969
"oneOf": [
7070
{
@@ -1806,7 +1806,7 @@
18061806
]
18071807
},
18081808
"env": {
1809-
"$comment": "See environment variable precedence documentation: https://githubnext.github.io/gh-aw/reference/environment-variables/",
1809+
"$comment": "See environment variable precedence documentation: https://github.github.io/gh-aw/reference/environment-variables/",
18101810
"description": "Environment variables for the workflow",
18111811
"oneOf": [
18121812
{
@@ -2368,14 +2368,14 @@
23682368
},
23692369
{
23702370
"mcp": {
2371-
"container": "ghcr.io/githubnext/mcp-gateway",
2371+
"container": "ghcr.io/github/mcp-gateway",
23722372
"port": 8080
23732373
}
23742374
},
23752375
{
23762376
"agent": "awf",
23772377
"mcp": {
2378-
"container": "ghcr.io/githubnext/mcp-gateway",
2378+
"container": "ghcr.io/github/mcp-gateway",
23792379
"port": 8080,
23802380
"api-key": "${{ secrets.MCP_GATEWAY_API_KEY }}"
23812381
}
@@ -5286,7 +5286,7 @@
52865286
"type": "boolean",
52875287
"default": true,
52885288
"$comment": "Strict mode enforces several security constraints that are validated in Go code (pkg/workflow/strict_mode_validation.go) rather than JSON Schema: (1) Write Permissions + Safe Outputs: When strict=true AND permissions contains write values (contents:write, issues:write, pull-requests:write), safe-outputs must be configured. This relationship is too complex for JSON Schema as it requires checking if ANY permission property has a 'write' value. (2) Network Requirements: When strict=true, the 'network' field must be present and cannot contain wildcard '*'. (3) MCP Container Network: Custom MCP servers with containers require explicit network configuration. (4) Action Pinning: Actions must be pinned to commit SHAs. These are enforced during compilation via validateStrictMode().",
5289-
"description": "Enable strict mode validation for enhanced security and compliance. Strict mode enforces: (1) Write Permissions - refuses contents:write, issues:write, pull-requests:write; requires safe-outputs instead, (2) Network Configuration - requires explicit network configuration with no wildcard '*' in allowed domains, (3) Action Pinning - enforces actions pinned to commit SHAs instead of tags/branches, (4) MCP Network - requires network configuration for custom MCP servers with containers, (5) Deprecated Fields - refuses deprecated frontmatter fields. Can be enabled per-workflow via 'strict: true' in frontmatter, or disabled via 'strict: false'. CLI flag takes precedence over frontmatter (gh aw compile --strict enforces strict mode). Defaults to true. See: https://githubnext.github.io/gh-aw/reference/frontmatter/#strict-mode-strict",
5289+
"description": "Enable strict mode validation for enhanced security and compliance. Strict mode enforces: (1) Write Permissions - refuses contents:write, issues:write, pull-requests:write; requires safe-outputs instead, (2) Network Configuration - requires explicit network configuration with no wildcard '*' in allowed domains, (3) Action Pinning - enforces actions pinned to commit SHAs instead of tags/branches, (4) MCP Network - requires network configuration for custom MCP servers with containers, (5) Deprecated Fields - refuses deprecated frontmatter fields. Can be enabled per-workflow via 'strict: true' in frontmatter, or disabled via 'strict: false'. CLI flag takes precedence over frontmatter (gh aw compile --strict enforces strict mode). Defaults to true. See: https://github.github.io/gh-aw/reference/frontmatter/#strict-mode-strict",
52905290
"examples": [true, false]
52915291
},
52925292
"safe-inputs": {

.github/aw/update-agentic-workflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ You format your questions and responses similarly to the GitHub Copilot CLI chat
2424

2525
- Always consult the **instructions file** for schema and features:
2626
- Local copy: @.github/aw/github-agentic-workflows.md
27-
- Canonical upstream: https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/aw/github-agentic-workflows.md
27+
- Canonical upstream: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md
2828
- Key commands:
2929
- `gh aw compile` → compile all workflows
3030
- `gh aw compile <name>` → compile one workflow

0 commit comments

Comments
 (0)