diff --git a/docs/src/content/docs/agent-factory-status.mdx b/docs/src/content/docs/agent-factory-status.mdx index 16086b0063..91162f03b6 100644 --- a/docs/src/content/docs/agent-factory-status.mdx +++ b/docs/src/content/docs/agent-factory-status.mdx @@ -16,6 +16,7 @@ These are experimental agentic workflows used by the GitHub Next team to learn, | [Agent Performance Analyzer - Meta-Orchestrator](https://github.com/github/gh-aw/blob/main/.github/workflows/agent-performance-analyzer.md) | copilot | [![Agent Performance Analyzer - Meta-Orchestrator](https://github.com/github/gh-aw/actions/workflows/agent-performance-analyzer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agent-performance-analyzer.lock.yml) | - | - | | [Agent Persona Explorer](https://github.com/github/gh-aw/blob/main/.github/workflows/agent-persona-explorer.md) | copilot | [![Agent Persona Explorer](https://github.com/github/gh-aw/actions/workflows/agent-persona-explorer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agent-persona-explorer.lock.yml) | - | - | | [Agentic Observability Kit](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-observability-kit.md) | copilot | [![Agentic Observability Kit](https://github.com/github/gh-aw/actions/workflows/agentic-observability-kit.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-observability-kit.lock.yml) | - | - | +| [Agentic Optimization Kit](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-optimization-kit.md) | copilot | [![Agentic Optimization Kit](https://github.com/github/gh-aw/actions/workflows/agentic-optimization-kit.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-optimization-kit.lock.yml) | - | - | | [Agentic Workflow Audit Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/audit-workflows.md) | claude | [![Agentic Workflow Audit Agent](https://github.com/github/gh-aw/actions/workflows/audit-workflows.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/audit-workflows.lock.yml) | - | - | | [AI Moderator](https://github.com/github/gh-aw/blob/main/.github/workflows/ai-moderator.md) | codex | [![AI Moderator](https://github.com/github/gh-aw/actions/workflows/ai-moderator.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/ai-moderator.lock.yml) | - | - | | [Approach Validator](https://github.com/github/gh-aw/blob/main/.github/workflows/approach-validator.md) | claude | [![Approach Validator](https://github.com/github/gh-aw/actions/workflows/approach-validator.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/approach-validator.lock.yml) | - | - | @@ -85,10 +86,12 @@ These are experimental agentic workflows used by the GitHub Next team to learn, | [Daily Secrets Analysis Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-secrets-analysis.md) | copilot | [![Daily Secrets Analysis Agent](https://github.com/github/gh-aw/actions/workflows/daily-secrets-analysis.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-secrets-analysis.lock.yml) | - | - | | [Daily Security Red Team Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-security-red-team.md) | claude | [![Daily Security Red Team Agent](https://github.com/github/gh-aw/actions/workflows/daily-security-red-team.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-security-red-team.lock.yml) | - | - | | [Daily Semgrep Scan](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-semgrep-scan.md) | copilot | [![Daily Semgrep Scan](https://github.com/github/gh-aw/actions/workflows/daily-semgrep-scan.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-semgrep-scan.lock.yml) | - | - | +| [Daily Skill Optimizer Improvements](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-skill-optimizer.md) | copilot | [![Daily Skill Optimizer Improvements](https://github.com/github/gh-aw/actions/workflows/daily-skill-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-skill-optimizer.lock.yml) | - | - | | [Daily Syntax Error Quality Check](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-syntax-error-quality.md) | copilot | [![Daily Syntax Error Quality Check](https://github.com/github/gh-aw/actions/workflows/daily-syntax-error-quality.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-syntax-error-quality.lock.yml) | - | - | | [Daily Team Evolution Insights](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-team-evolution-insights.md) | claude | [![Daily Team Evolution Insights](https://github.com/github/gh-aw/actions/workflows/daily-team-evolution-insights.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-team-evolution-insights.lock.yml) | - | - | | [Daily Team Status](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-team-status.md) | copilot | [![Daily Team Status](https://github.com/github/gh-aw/actions/workflows/daily-team-status.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-team-status.lock.yml) | `daily around 9:00 on weekdays` | - | | [Daily Testify Uber Super Expert](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-testify-uber-super-expert.md) | copilot | [![Daily Testify Uber Super Expert](https://github.com/github/gh-aw/actions/workflows/daily-testify-uber-super-expert.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-testify-uber-super-expert.lock.yml) | - | - | +| [Daily Token Consumption Report (Sentry OTel)](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-token-consumption-report.md) | claude | [![Daily Token Consumption Report (Sentry OTel)](https://github.com/github/gh-aw/actions/workflows/daily-token-consumption-report.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-token-consumption-report.lock.yml) | - | - | | [Daily Workflow Updater](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-workflow-updater.md) | copilot | [![Daily Workflow Updater](https://github.com/github/gh-aw/actions/workflows/daily-workflow-updater.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-workflow-updater.lock.yml) | - | - | | [Dead Code Removal Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/dead-code-remover.md) | copilot | [![Dead Code Removal Agent](https://github.com/github/gh-aw/actions/workflows/dead-code-remover.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/dead-code-remover.lock.yml) | - | - | | [DeepReport - Intelligence Gathering Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/deep-report.md) | claude | [![DeepReport - Intelligence Gathering Agent](https://github.com/github/gh-aw/actions/workflows/deep-report.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/deep-report.lock.yml) | `daily around 15:00 on weekdays` | - | diff --git a/docs/src/content/docs/reference/frontmatter-full.md b/docs/src/content/docs/reference/frontmatter-full.md index c11bd3d257..e3405f2e3f 100644 --- a/docs/src/content/docs/reference/frontmatter-full.md +++ b/docs/src/content/docs/reference/frontmatter-full.md @@ -899,6 +899,12 @@ on: # Option 2: undefined + # Explicit additional custom workflow jobs that pre_activation and activation + # should depend on. + # (optional) + needs: [] + # Array of strings + # Steps to inject into the pre-activation job. These steps run after all built-in # checks (membership, stop-time, skip-if, etc.) and their results are exposed as # pre-activation outputs. Use 'id' on steps to reference their results via @@ -983,11 +989,6 @@ on: # (optional) statuses: "read" - # Explicit additional custom workflow jobs that pre_activation and activation - # should depend on. - # (optional) - needs: ["secrets_fetcher"] - # When set to false, disables the frontmatter hash check step in the activation # job. Default is true (check is enabled). Useful when the workflow source files # are managed outside the default GitHub repo context (e.g. cross-repo org @@ -1469,8 +1470,8 @@ pre-steps: pre-steps: [] # Array items: undefined -# Custom workflow steps to run before MCP gateway startup in the agent job, -# so prerequisite MCP installation/configuration can happen first. +# Custom workflow steps to run immediately before AI execution, after all +# initialization and setup steps in the agent job. # (optional) # This field supports multiple formats (oneOf): @@ -3488,6 +3489,13 @@ safe-outputs: assignees: [] # Array items: string + # Optional labels to apply to fallback issues created when pull request creation + # cannot proceed. When omitted, fallback issues reuse pull request labels. A + # managed label is always added for triage. + # (optional) + fallback-labels: [] + # Array of strings + # Whether to create pull request as draft (defaults to true). Accepts a boolean or # a GitHub Actions expression. # (optional) diff --git a/pkg/cli/logs_command.go b/pkg/cli/logs_command.go index a6eaf90ad4..7d745aa555 100644 --- a/pkg/cli/logs_command.go +++ b/pkg/cli/logs_command.go @@ -76,6 +76,7 @@ Examples: ` + string(constants.CLIExtensionPrefix) + ` logs --ref main # Filter logs by branch or tag ` + string(constants.CLIExtensionPrefix) + ` logs --ref feature-xyz # Filter logs by feature branch ` + string(constants.CLIExtensionPrefix) + ` logs --filtered-integrity # Filter logs with DIFC (data integrity flow control) integrity-filtered items in the gateway logs + ` + string(constants.CLIExtensionPrefix) + ` logs --no-staged # Exclude staged workflow runs from results # Run ID range filtering ` + string(constants.CLIExtensionPrefix) + ` logs --after-run-id 1000 # Filter runs after run ID 1000 @@ -91,6 +92,8 @@ Examples: ` + string(constants.CLIExtensionPrefix) + ` logs --format markdown # Generate cross-run security audit report in Markdown ` + string(constants.CLIExtensionPrefix) + ` logs --format pretty # Generate cross-run security audit report in console format ` + string(constants.CLIExtensionPrefix) + ` logs weekly-research --format markdown --last 10 # Cross-run report for last 10 runs + ` + string(constants.CLIExtensionPrefix) + ` logs --train # Train log pattern weights from last 10 runs + ` + string(constants.CLIExtensionPrefix) + ` logs my-workflow --train -c 50 # Train log pattern weights from up to 50 runs of a specific workflow # Cross-repository ` + string(constants.CLIExtensionPrefix) + ` logs weekly-research --repo owner/repo # Download logs from specific repository`, diff --git a/pkg/cli/mcp_server_command.go b/pkg/cli/mcp_server_command.go index 533b627b23..eb0a6a5480 100644 --- a/pkg/cli/mcp_server_command.go +++ b/pkg/cli/mcp_server_command.go @@ -58,7 +58,7 @@ Examples: gh aw mcp-server --port 8080 # Run HTTP server on port 8080 (for web-based clients) gh aw mcp-server --cmd ./gh-aw # Use custom gh-aw binary path GITHUB_ACTOR=octocat gh aw mcp-server # Set actor via environment variable for access control - DEBUG=mcp:* GITHUB_ACTOR=octocat gh aw mcp-server # Run with verbose logging and actor`, + DEBUG=mcp:* GITHUB_ACTOR=octocat gh aw mcp-server # Run with verbose debug logging and actor set via environment variable`, RunE: func(cmd *cobra.Command, args []string) error { return runMCPServer(port, cmdPath, validateActor) }, diff --git a/pkg/cli/pr_command.go b/pkg/cli/pr_command.go index e6f1c24fc9..026e1a9007 100644 --- a/pkg/cli/pr_command.go +++ b/pkg/cli/pr_command.go @@ -43,7 +43,7 @@ func NewPRCommand() *cobra.Command { Long: `Pull request management utilities for transferring PRs between repositories. This command provides tools for transferring pull requests from one repository -to another, including the code changes, title, and description. Useful for +to another, including the code changes, title, and body. Useful for migrating work from trial repositories to production repositories. Available subcommands: @@ -84,7 +84,7 @@ The command will: 1. Fetch the PR details (title, body, changes) 2. Apply changes as a single squashed commit 3. Create a new PR in the target repository -4. Copy the original title and description`, +4. Copy the original title and body`, Args: cobra.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { prURL := args[0] diff --git a/pkg/cli/trial_command.go b/pkg/cli/trial_command.go index 69dcb3155e..33793d0a4a 100644 --- a/pkg/cli/trial_command.go +++ b/pkg/cli/trial_command.go @@ -46,6 +46,7 @@ Auto-merge examples: Advanced examples: ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --host-repo . # Use current repo as host ` + string(constants.CLIExtensionPrefix) + ` trial ./local-workflow.md --clone-repo upstream/repo --repeat 2 + ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --trigger-context https://github.com/owner/repo/issues/123 # Provide issue context for issue-triggered workflows Repository modes: - Default mode (no flags): Creates a temporary trial repository and simulates execution as if running against the current repository (github.repository context points to current repo)