diff --git a/DICTATION.md b/DICTATION.md index 1728a6953ab..fa0478b788f 100644 --- a/DICTATION.md +++ b/DICTATION.md @@ -11,262 +11,1034 @@ gh-aw (GitHub Agentic Workflows) is a CLI extension for GitHub that compiles mar ## Project Glossary +@copilot +ab-testing-advisor acceptEdits +ace-editor +action_required +actionlint +actions-lock.json activation actor add-comment +add-dir +add-host add-labels -add-wizard +add-mask +add-reviewer +add_comment +add_labels +AddCommentOutput +AddLabelsOutput +AddReviewerOutput agent +agent-output agent-output.json +agent-performance-analyzer +agent-persona-explorer +agent-stdio +agent-step-summary +agent_output.json agentic agentic-ops +agentic-token-audit +agentic-token-optimizer +agentic-token-trend-audit +agentic-workflow-usage-cache agentic-workflows +agentics-maintenance.yml AGENTS.md ai-credits +ai-moderator +aic +alert-number +allow-action-refs +allow-host-ports +allow-only +allow-team-members +allow-tool +allowed-branches allowed-domains allowed-files allowed-github-references allowed-repos +allowed_repositories +AllowedDomains +analysis_type +anthropic ANTHROPIC_API_KEY +antigravity +ANTIGRAVITY_API_KEY +any +api-consumption-report +api-proxy +api-proxy-logs api-target +api.github.com +api.githubcopilot.com +app-id append +append-only-comments +approach-validator approval-labels +arc-dind +archie +architecture-guardian artifact artifacts +artifacts-summary assign-milestone assign-to-agent +assignees +AssignMilestoneOutput +AssignToAgentOutput audit +audit-diff +audit-workflows +auto-merge +auto-merge-prs auto-triage-issues +autofix-code-scanning-alert +AutofixCodeScanningAlertOutput +avenger +aw-failure-investigator +aw-info aw-info.json +aw-prompts aw.json aw.yml +aw_context +aw_info.json +awf-config +awf-reflect +awmg-cli-proxy +awmg-mcpg +AZURE_CLIENT_ID +AZURE_CLIENT_SECRET +AZURE_TENANT_ID +base-branch +base_weighted_tokens bash batch-ops +bi-weekly blocked blocked-users +blog-auditor +bootstrap +bot-detection +branch-name +branch-prefix +branches-ignore +BRAVE_API_KEY +breaking-change-checker +built-in +BYOK bypassPermissions cache +cache-dependency-path +cache-hit +cache-matched-key cache-memory +cache.jsonl call-workflow -central-repo-ops +cancel-in-progress +CHANGELOG.md +changeset +chaos-pr-bundle-fuzzer chat-ops +chatgpt-image checkout +checkout-pr +ci-coach +ci-doctor claude +claude-code-user-docs-review +claude-opus +claude-sonnet CLAUDE.md +cli-consistency-checker +cli-proxy +cli-version-checker client-id +cloclo close-discussion +close-expired-entities close-issue +close-older-discussions +close-older-issues +close-older-key close-pull-request +close_discussion +close_issue +CloseDiscussionOutput +CloseIssueOutput +ClosePullRequestOutput +code-scanning +code-scanning-alert +code-scanning-fixer +code-simplifier codex +CODEX_API_KEY +coding +comment-id comment-memory +commit-title-suffix compilation compile +computer-use conclusion concurrency +config.json +config.schema.json +config.toml +container-workdir contents +CONTEXT7_API_KEY +continue-on-error +CONTRIBUTING.md +contribution-check +cool-down copilot +copilot-agent-analysis +copilot-centralization-drilldown +copilot-cli-deep-research +copilot-opt +copilot-pr-merged-report +copilot-requests +copilot-sdk +copilot-session-insights +copilot-setup-steps +copilot-setup-steps.yml +copilot-swe-agent +copilot/claude-opus-4.5 +copilot/gpt-5 +copilot/gpt-5.4 +COPILOT_API_KEY +COPILOT_CONNECTION_TOKEN COPILOT_GITHUB_TOKEN COPILOT_MODEL -correction-ops +COPILOT_PROVIDER_BASE_URL +COPILOT_SDK_SEND_TIMEOUT_MS +create-agent-session +create-agent-task +create-check-run +create-code-scanning-alert create-discussion create-issue create-pull-request create-pull-request-review-comment +create_check_run +create_discussion +create_issue +create_pull_request +create_pull_request_review_comment +CreateCodeScanningAlertOutput +CreateDiscussionOutput +CreateIssueOutput +CreatePullRequestOutput +CreatePullRequestReviewCommentOutput cron +cross-repo cross-repository -crush +crush.json custom-safe-outputs daily +daily-agentrx-trace-optimizer +daily-ambient-context-optimizer +daily-architecture-diagram +daily-assign-issue-to-user +daily-effective-workflow-guardrail +dangerously-disable-sandbox-agent +data.recoverable +DD_API_KEY +DD_APPLICATION_KEY +dead-code-remover +deep-report +deep-research +default_max_ai_credits +default_max_daily_ai_credits +default_max_turn_cache_misses +delight +deny-all +Dependabot +dependabot-burner +dependabot-go-checker +dependabot-repair dependencies +deployment-incident-monitor +design-decision-gate detection +detection.log deterministic-ops +developer-docs-consolidator +DEVGUIDE.md +DICTATION.md +difc-proxy +disable-builtin-mcps +disable-codemod +disable-xpia-prompt +disapproval-reactions discussion discussion-number +discussion-task-miner +discussion_comment +discussion_number discussions -dispatch-ops +dismiss-pull-request-review +DismissPullRequestReviewOutput +dispatch-repository dispatch-workflow +DispatchWorkflowOutput +docker-host +docker-host-path-prefix +DOCKER_HOST +DOCKER_SOCK_GID +DOCKER_SOCK_PATH +docs-noob-tester +domains download-artifact +draft-body +draft-pr-cleanup +draft-title +dry-run +duplicate-code-detector +duplicate_of edit effective-tokens +effective-workflow-guardrail end-date +endorsement-reactions endpoint engine +engine.api-target +engine.auth engine.bare +engine.driver engine.env +engine.harness +engine.id engine.mcp +engine.mcp.session-timeout +engine.mcp.tool-timeout engine.model engine.permission-mode +EngineConfig env -ephemerals +env-all +eslint-miner +eslint-monster +event_type +exclude-env +excluded-files experiment experiments expires +fable +fail-fast +fallback-as-issue fallback-to-issue feature-flags +fetch-depth +field_name +field_node_id +file-glob +file-summarizer +filter-test firewall firewall-audit-logs +firewall-escape +FirewallConfig footer +footer-workflow-recompile +forecast +FOUNDRY_API_KEY +FOUNDRY_OPENAI_ENDPOINT frontmatter +functional-pragmatist fuzzy-schedule +gateway-api-key +gateway-pid +gateway-port gemini +gemini-3-flash +gemini-3-pro +gemini-3.1-flash +gemini-3.1-pro +gemini-3.5-flash gemini-flash +gemini-flash-lite +gemini-omni gemini-pro GEMINI_API_KEY +gemma gh-aw +gh-aw-detection +gh-aw-firewall +gh-aw-manifest +gh-aw-mcpg +gh-aw-metadata +gh-aw-node +gh-aw-ref +gh-proxy +GH_AW_ACTION_FAILURE_ISSUE_EXPIRES_HOURS +GH_AW_AGENT_CONCLUSION +GH_AW_AGENT_FILES +GH_AW_AGENT_FOLDERS +GH_AW_AGENT_OUTPUT +GH_AW_AIC +GH_AW_ALLOWED_DOMAINS +GH_AW_ALLOWED_EXTENSIONS +GH_AW_AMBIENT_CONTEXT +GH_AW_ASSETS_ALLOWED_EXTS +GH_AW_ASSETS_BRANCH +GH_AW_ASSETS_MAX_SIZE_KB +GH_AW_BIN +GH_AW_CACHE_DIR +GH_AW_CI_TRIGGER_TOKEN +GH_AW_COMMENT_ID +GH_AW_CURRENT_WORKFLOW_REF +GH_AW_DEFAULT_DETECTION_MAX_AI_CREDITS GH_AW_DEFAULT_DETECTION_MODEL +GH_AW_DEFAULT_MAX_AI_CREDITS +GH_AW_DEFAULT_MAX_DAILY_AI_CREDITS GH_AW_DEFAULT_MAX_EFFECTIVE_TOKENS +GH_AW_DEFAULT_MAX_TURN_CACHE_MISSES +GH_AW_DEFAULT_MAX_TURNS +GH_AW_DEFAULT_MODEL_COPILOT +GH_AW_DEFAULT_TIMEOUT_MINUTES +GH_AW_DETECTION_CONCLUSION +GH_AW_DETECTION_CONTINUE_ON_ERROR +GH_AW_DETECTION_REASON +GH_AW_DOCKER_HOST +GH_AW_DOCKER_HOST_PATH_PREFIX_ARGS +GH_AW_EFFECTIVE_TOKENS +GH_AW_ENGINE +GH_AW_ENGINE_ID +GH_AW_ENGINE_MODEL +GH_AW_GITHUB_ACTOR +GH_AW_GITHUB_MCP_SERVER_TOKEN +GH_AW_GITHUB_REPOSITORY +GH_AW_GITHUB_RUN_ID +GH_AW_GITHUB_TOKEN +GH_AW_GITHUB_WORKSPACE +GH_AW_HAS_LABEL_COMMAND +GH_AW_HAS_SLASH_COMMAND +GH_AW_INFO_AWF_VERSION +GH_AW_INFO_ENGINE_ID +GH_AW_INFO_MODEL +GH_AW_INFO_STAGED +GH_AW_INFO_VERSION +GH_AW_IS_PR_COMMENT +GH_AW_LLM_PROVIDER +GH_AW_MAX_AI_CREDITS +GH_AW_MAX_DAILY_AI_CREDITS +GH_AW_MAX_TURNS +GH_AW_MCP_CLI_SERVERS_LIST +GH_AW_MCP_CONFIG +GH_AW_MCP_LOG_DIR +GH_AW_MODELS_JSON_PATH +GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED +GH_AW_NODE +GH_AW_NODE_BIN +GH_AW_NODE_EXEC +GH_AW_NPM_GLOBAL_ROOT +GH_AW_OTEL_GRAFANA_AUTHORIZATION +GH_AW_OTEL_GRAFANA_ENDPOINT +GH_AW_OTEL_SENTRY_AUTHORIZATION +GH_AW_OTEL_SENTRY_ENDPOINT +GH_AW_OTLP_ALL_HEADERS +GH_AW_OTLP_ENDPOINTS +GH_AW_PHASE +GH_AW_POLICY_ALLOW_CREATE_PULL_REQUEST +GH_AW_PROJECT_GITHUB_TOKEN +GH_AW_PROJECT_UTC +GH_AW_PROMPT +GH_AW_RUN_URL +GH_AW_RUNTIME_FEATURES +GH_AW_SAFE_OUTPUTS +GH_AW_SAFE_OUTPUTS_CONFIG_PATH +GH_AW_SAFE_OUTPUTS_HANDLER_CONFIG +GH_AW_SAFE_OUTPUTS_TOOLS_PATH +GH_AW_SETUP_WORKFLOW_NAME +GH_AW_SIDE_REPO_PAT +GH_AW_SKILL_DIR +GH_AW_SUB_AGENT_DIR +GH_AW_SUB_AGENT_EXT +GH_AW_THREAT_DETECTION_AIC +GH_AW_TIMEOUT_MINUTES +GH_AW_TOOL_CACHE +GH_AW_TOOL_CACHE_MOUNT +GH_AW_TOOLS_META_JSON +GH_AW_TRACKER_ID +GH_AW_VERSION +GH_AW_WORKFLOW_DISPATCH_AW_CONTEXT +GH_AW_WORKFLOW_FILE +GH_AW_WORKFLOW_ID +GH_AW_WORKFLOW_ID_SANITIZED +GH_AW_WORKFLOW_NAME +GH_AW_WORKFLOW_SOURCE_URL GH_HOST +GH_TOKEN +GHEC +GHES +ghes-host-config +git.commit +GIT_AUTHOR_EMAIL +GIT_AUTHOR_NAME +GIT_COMMITTER_EMAIL +GIT_COMMITTER_NAME github +github-actions github-app +github-cloud +github-context +github-env +github-mcp-server +github-mcp-structural-analysis +github-oidc +github-script github-token github-tools +github.actor +github.aw.context +github.event.comment.id +github.event.discussion.number +github.event.inputs +github.event.issue.number +github.event.repository +github.event_name +github.ref_name +github.run_attempt +github.run_id +github.run_number +github.sha +GITHUB_ACTOR +GITHUB_API_URL +GITHUB_AW +GITHUB_AW_OTEL_PARENT_SPAN_ID +GITHUB_AW_OTEL_TRACE_ID +GITHUB_BASE_REF +GITHUB_COPILOT_BASE_URL +GITHUB_COPILOT_INTEGRATION_ID +GITHUB_ENTERPRISE_HOST +GITHUB_EVENT_NAME +GITHUB_EVENT_PATH +GITHUB_GRAPHQL_URL +GITHUB_HEAD_REF +GITHUB_JOB +GITHUB_MCP_GUARD_MIN_INTEGRITY +GITHUB_MCP_GUARD_REPOS +GITHUB_MCP_SERVER_TOKEN +github_models +GITHUB_OUTPUT +GITHUB_REF +GITHUB_REF_NAME +GITHUB_REPOSITORY +GITHUB_RUN_ATTEMPT +GITHUB_RUN_ID +GITHUB_RUN_NUMBER +GITHUB_SERVER_URL +GITHUB_SHA +GITHUB_STEP_SUMMARY GITHUB_TOKEN +GITHUB_WORKFLOW +GITHUB_WORKFLOW_REF +GITHUB_WORKSPACE +glossary-maintainer +go-fan +go-logger +go-pattern-detector +go-version-file +go.mod +go.sum gpt-5 +gpt-5-codex gpt-5-mini +gpt-5-nano +gpt-5-pro +gpt-5.1 +gpt-5.2 +gpt-5.3 +gpt-5.4 +gpt-5.5 +gpt-5.6 +gpt-image +grafana +GRAFANA_SERVICE_ACCOUNT_TOKEN +group-add +grumpy-reviewer +guard-policies +guardrail_metrics haiku +hash-frontmatter headers +health hide-comment hide-older-comments +HideCommentOutput +hippo-embed +host-gateway +host.docker.internal +hourly +hourly-ci-cleaner id-token +if-no-changes +if-no-files-found +image-generation import-schema imports +in_progress +include-hidden-files +info.jsonl +inline-agents inline-sub-agents inlined-imports +inspect +install +instructions-janitor integrity +integrity-proxy integrity-reactions issue +issue-arborist issue-comment +issue-monster issue-number issue-ops +issue-triage-agent +issue_comment +issue_number issues +item_number +items.jsonl +job-discriminator +job-name +json-schema +jsonrpc +kimi +kiwi label-command label-ops +label_command labels +large link-sub-issue +LinkSubIssueOutput +lint +lint-monster +linter-miner +LLM +llm.model.multiplier +llm.token.base_weighted +llm.token.cached_input +llm.token.effective_total +llm.token.input +llm.token.output +lock.json lock.yml lockdown-mode +lockfile-stats +log-level +logical-repo +logs +lyria +macos-latest +mai-code +manifest-version +mark-pull-request-as-ready-for-review markdown +MarkPullRequestAsReadyForReviewOutput max-ai-credits +max-bot-mentions +max-calls max-continuations max-daily-ai-credits +max-file-count +max-file-size max-patch-size max-runs +max-runs-per-window +max-samples +max-tool-denials +max-turn-cache-misses max-turns +max-uploads mcp +mcp-cli +mcp-config mcp-gateway +mcp-inspect +mcp-inspector +mcp-logs +mcp-payloads mcp-scripts +mcp-server mcp-servers +MCP_GATEWAY_API_KEY +MCP_GATEWAY_DOCKER_COMMAND +MCP_GATEWAY_DOMAIN +MCP_GATEWAY_GID +MCP_GATEWAY_HOST_DOMAIN +MCP_GATEWAY_LOG_DIR +MCP_GATEWAY_PAYLOAD_DIR +MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD +MCP_GATEWAY_PORT MCP_GATEWAY_SESSION_TIMEOUT +MCP_GATEWAY_UID memory-ops merge merge-pull-request +mergefest +metadata +metrics-collector +milestone-number +milestone_number +milestone_title min-integrity min-samples min-version -model-alias +mini +missing-data +missing-tool +missing_data +missing_tool +MissingToolOutput +models.json monitor-ops +mounts multi-phase multi-repo-ops +nano-banana +necromancer network network.allowed +NetworkPermissions +no-ask-user +no-check-update +no-compile +no-gitattributes +no-op +no-security-scanner +no-stop-after +node-version +non-empty noop -opencode +noop-reminder +notion-issue-summary +notion-mcp +NOTION_API_TOKEN +npx +o3-deep-research +o4-mini-deep-research +observability.otlp +on.github-app +on.needs +on.skip-author-associations +openai +openai/gpt-5 OPENAI_API_KEY +opencode +opencode.jsonc +OPENROUTER_API_KEY opentelemetry opus +opusplan orchestration orchestrator-ops +org-health-report organization otel +otel.jsonl +OTEL_EXPORTER_OTLP_ENDPOINT +OTEL_EXPORTER_OTLP_HEADERS otlp +otlp.md +outcome-collector +outcomes +outputs.jsonl +override-test +p50_projected_effective_tokens +package-manager-cache +package.json +parent-issue-number +parent-span-id +parent_issue_number +PAT +patch-format +paths-ignore payloadDir permissions +PermissionScope +persist-credentials pi +pick-experiment +pick_experiment.cjs +pip playwright +poem-bot post-steps +poutine +pr-code-quality-reviewer +pr-sous-chef +pr-triage-agent pre-activation +pre-agent +pre-agent-audit +pre-agent-steps pre-steps +pre_activation prepend preserve-branch-name private-key projected-effective-tokens +projected_effective_tokens prompt.txt protected-files +proxy-args +pull-number pull-request pull-request-number +pull-request-review +pull-request-review-comment pull-request-target pull-requests +pull_number pull_request +pull_request_number +pull_request_review_comment pull_request_target +pull_requests push-to-pull-request-branch +PushToPullRequestBranchOutput +rate-limit rate-limiting +read-only README.md +reasoning +refactoring-cadence +refiner +reflect.json refusal-labels registry +reminder.md remove-labels replace -repo-memory +replay reply-to-pull-request-review-comment +ReplyToPullRequestReviewCommentOutput +repo-audit-analyzer +repo-memory +report-as-issue report-incomplete +repository_dispatch required-labels required-title-prefix +requirements.txt research-plan-assign-ops resolve-pull-request-review-thread +ResolvePullRequestReviewThreadOutput +resource-attributes +retention-days +review-id +review-thread +robotics +run-failure +run-install-scripts +run-name +run-started +run-success +run_id +run_summary.json +runner-guard runs-on runs-on-slim +runs_per_episode +runtime +runtime-import +safe-output +safe-output-artifact-client +safe-output-health +safe-output-tools safe-outputs +safe-outputs-items +safe-outputs.actions +safe-outputs.allowed-domains +safe-outputs.app +safe-outputs.create-pull-request +safe-outputs.github-app +safe-outputs.github-token +safe-outputs.jobs +safe-outputs.threat-detection.max-ai-credits safe-rollout +safe_outputs +SafeOutput +safeoutputs.jsonl +sampled_episodes sandbox +SandboxConfig schedule +schema-consistency-checker +schema-feature-coverage +scout +secret-masking +security-compliance +self-hosted +semantic-function-refactor +send-slack-message +sentry +SENTRY_ACCESS_TOKEN serena +sergo +servers.json +service.name sessionTimeout +set-issue-type +set_issue_field +settings.json +setup-go +setup-node +skillet +skip-archive +skip-bots skip-if-match +skip-if-no-match +skip-pull +skip-roles +SLACK_BOT_TOKEN slash-command +slash_command +small +small-agent +smoke-antigravity +smoke-claude +smoke-codex +smoke-copilot +smoke-gemini +smoke-opencode +smoke-pi sonnet +sonnet-6x +span-id spanId +sparse-checkout +sparse-checkout-cone-mode +spec-enforcer +spec-extractor +spec-librarian spec-ops staged +stale-pr-cleanup +stale-repo-identifier start-date +startup-timeout state.json state.runs +status-comment +stdio.log steps.sanitized.outputs.body steps.sanitized.outputs.text steps.sanitized.outputs.title stop-after sub-agent +sub-agents +sub-issue-closer +sub-issue-number sub-issues +sub_issue_number +submit-pull-request-review +submit_pull_request_review +SubmitPullRequestReviewOutput +summary.json +summary.md +super-linter target-repo +task-description +TAVILY_API_KEY +terminal-stylist +thread-id threat-detection +tidy +timed_out timeout-minutes timezone title-prefix +token-usage +TokenUsage +tool-timeout +tools.bash +tools.cli-proxy tools.github +tools.github.allowed-repos +tools.github.min-integrity +tools.json +tools.mcp-servers +tools.playwright tools.timeout toolsets +top-level total-effective-tokens +total_aic +trace-id traceId traceparent +tracker-id +tri-weekly trial-ops trusted-users trustedBots +typescript-language-server +typist +ubuntu-latest +ubuntu-slim unapproved +unassign-first +unbloat-docs +uninstall +update-astro update-discussion update-issue update-project update-pull-request +UpdateDiscussionOutput +UpdateIssueOutput +UpdateProjectOutput +UpdatePullRequestOutput +upload-artifact +upload-asset +usage.jsonl user-rate-limit +users.noreply.github.com +validate-images variants +veo +vision +visual-regression-checker +vulnerability-alerts web-fetch web-search weekly +weekly-blog-post-writer +weekly-editors-health-check +weekly-issue-summary weight workflow-call workflow-dispatch +workflow-generator +workflow-health-manager +workflow-logs +workflow-name +workflow-skill-extractor workflow_call workflow_dispatch +workflow_id +workflow_run +WorkflowRun +workflows-dir +working-directory workqueue-ops +write-sink YAML +zizmor ## Fix Speech-to-Text Errors @@ -313,7 +1085,6 @@ Common misrecognitions to correct: - "AI credits" → "ai-credits" (hyphenated) - "open code" → "opencode" (one word when used as engine name) - "open AI API key" → "OPENAI_API_KEY" (uppercase with underscores) -- "crush" → "crush" (CLI engine name, lowercase) - "anthropic API key" → "ANTHROPIC_API_KEY" (uppercase with underscores) - "gemini API key" → "GEMINI_API_KEY" (uppercase with underscores) - "close issue" → "close-issue" (hyphenated in YAML context) @@ -333,6 +1104,26 @@ Common misrecognitions to correct: - "inline sub agents" → "inline-sub-agents" (hyphenated) - "lockdown mode" → "lockdown-mode" (hyphenated) - "agentic ops" → "agentic-ops" (hyphenated) +- "at copilot" → "@copilot" (GitHub bot mention) +- "depend a bot" → "Dependabot" (one word, capital D) +- "dependabot" → "Dependabot" (capital D) +- "run time" → "runtime" (one word) +- "self hosted" → "self-hosted" (hyphenated) +- "gemini flash lite" → "gemini-flash-lite" (hyphenated) +- "gemini flash" → "gemini-flash" (hyphenated) +- "mai code" → "mai-code" (hyphenated) +- "nano banana" → "nano-banana" (hyphenated) +- "computer use" → "computer-use" (hyphenated) +- "deep research" → "deep-research" (hyphenated) +- "gpt 5 nano" → "gpt-5-nano" (hyphenated) +- "gpt 5 codex" → "gpt-5-codex" (hyphenated) +- "sonnet six x" → "sonnet-6x" +- "grumpy reviewer" → "grumpy-reviewer" (hyphenated workflow name) +- "aw failure investigator" → "aw-failure-investigator" (hyphenated workflow name) +- "smoke copilot" → "smoke-copilot" (hyphenated workflow name) +- "super linter" → "super-linter" (hyphenated) +- "action lint" → "actionlint" (one word, linter name) +- "fire wall" → "firewall" (one word) ## Clean Up and Improve Text