action.yml

name: "Copilot - GitHub with super powers"
description: "Automates branch management, GitHub project linking, and issue/PR tracking with Git-Flow methodology."
author: "Efra Espada"
inputs:
  debug:
    description: "Enable debug mode."
    default: "false"
  pr-approval-observer:
    description: "Run the isolated, trusted-default-branch pull-request approval observer."
    default: "false"
  pr-approval-pr-number:
    description: "Positive pull-request number for an authorized manual approval recheck."
    default: ""
  pr-approval-policy:
    description: "Versioned PR approval policy forwarded by the observer workflow; runtime rereads the Variable before a review write."
    default: ""
  single-action:
    description: "Launch single actions."
    default: ""
  single-action-issue:
    description: "Issue target for executing single action."
    default: ""
  single-action-version:
    description: "Version target for executing single action."
    default: ""
  single-action-title:
    description: "Durable release/hotfix title for prepare_deployment_action."
    default: ""
  single-action-changelog:
    description: "Durable release/hotfix changelog for prepare_deployment_action."
    default: ""
  single-action-message:
    description: "Markdown message for the publish_issue_comment single action."
    default: ""
  single-action-operation-id:
    description: "Expected durable deployment operation ID for trusted continuation actions."
    default: ""
  single-action-comment-id:
    description: "Optional issue comment ID to replace or append to."
    default: ""
  single-action-comment-mode:
    description: "Comment publication mode: create, replace, or append. Defaults to create without an ID and replace with an ID."
    default: ""
  inactivity-threshold-hours:
    description: "Hours without issue activity before the scheduled inactivity action closes a waiting issue."
    default: "168"
  emoji-labeled-title:
    description: "Enable titles with emojis based on issue labels."
    default: "true"
  issue-managed-branches:
    description: "Let the Action create linked branches after an authorized in-progress start."
    default: "true"
  pre-branch-sdd:
    description: "Require a validated SDD first commit for started feature and contract-change issues. Requires issue-managed-branches."
    default: "false"
  issue-workflow-profile:
    description: "JSON profile of enabled issue workflows."
    default: ""
  branch-management-emoji:
    description: "Emoji to indicate branched issues. It will be ignored if emoji-labeled-title is false."
    default: "🧑‍💻"
  docs-label:
    description: "Label to manage docs branches."
    default: "docs"
  documentation-label:
    description: "Label to manage docs branches."
    default: "documentation"
  chore-label:
    description: "Label to manage chore branches."
    default: "chore"
  maintenance-label:
    description: "Label to manage chore branches."
    default: "maintenance"
  hotfix-label:
    description: "Label to manage hotfix branches."
    default: "hotfix"
  release-label:
    description: "Label to manage release branches."
    default: "release"
  bug-label:
    description: "Label to indicate a bug type."
    default: "bug"
  bugfix-label:
    description: "Label to manage bugfix branches."
    default: "bugfix"
  feature-label:
    description: "Label to manage feature branches."
    default: "feature"
  enhancement-label:
    description: "Label to indicate a enhancement type."
    default: "enhancement"
  question-label:
    description: "Label to detect issues marked as questions."
    default: "question"
  help-label:
    description: "Label to detect help request issues."
    default: "help"
  deploy-label:
    description: "Label to detect deploy actions."
    default: "deploy"
  deployed-label:
    description: "Label to detect the deployed was."
    default: "deployed"
  priority-high-label:
    description: "Label to indicate a priority high."
    default: "priority: high"
  priority-medium-label:
    description: "Label to indicate a priority medium."
    default: "priority: medium"
  priority-low-label:
    description: "Label to indicate a priority low."
    default: "priority: low"
  priority-none-label:
    description: "Label to indicate no priority."
    default: "priority: none"
  size-xxl-label:
    description: "Label to indicate a task of size XXL."
    default: "size: XXL"
  size-xl-label:
    description: "Label to indicate a task of size XL."
    default: "size: XL"
  size-l-label:
    description: "Label to indicate a task of size L."
    default: "size: L"
  size-m-label:
    description: "Label to indicate a task of size M."
    default: "size: M"
  size-s-label:
    description: "Label to indicate a task of size S."
    default: "size: S"
  size-xs-label:
    description: "Label to indicate a task of size XS."
    default: "size: XS"
  state-ai-processing-label:
    description: "Temporary label while a Copilot agent is analyzing or working."
    default: "state:ai-processing"
  state-planned-label:
    description: "Label for the Copilot lifecycle state: planned."
    default: "state:planned"
  state-working-label:
    description: "Label for work ready on a branch or branchless help."
    default: "state:working"
  state-specifying-label:
    description: "Label for active SDD clarification and drafting."
    default: "state:specifying"
  state-reviewing-label:
    description: "Label for the Copilot lifecycle state: reviewing."
    default: "state:reviewing"
  state-changes-requested-label:
    description: "Label for the Copilot lifecycle state: changes requested."
    default: "state:changes-requested"
  state-verified-label:
    description: "Label for the Copilot lifecycle state: verified."
    default: "state:verified"
  state-ready-label:
    description: "Label for the Copilot lifecycle state: ready."
    default: "state:ready"
  state-blocked-label:
    description: "Label for the Copilot lifecycle state: blocked."
    default: "state:blocked"
  state-awaiting-maintainer-label:
    description: "Label for work waiting on a maintainer response or approval."
    default: "state:awaiting-maintainer"
  state-awaiting-issue-author-label:
    description: "Label for work waiting on more information or changes from the issue author."
    default: "state:awaiting-issue-author"
  size-xxl-threshold-lines:
    description: "Threshold for size XXL in lines."
    default: "1000"
  size-xxl-threshold-files:
    description: "Threshold for size XXL in files."
    default: "20"
  size-xxl-threshold-commits:
    description: "Threshold for size XXL in commits."
    default: "10"
  size-xl-threshold-lines:
    description: "Threshold for size XL in lines."
    default: "500"
  size-xl-threshold-files:
    description: "Threshold for size XL in files."
    default: "10"
  size-xl-threshold-commits:
    description: "Threshold for size XL in commits."
    default: "5"
  size-l-threshold-lines:
    description: "Threshold for size L in lines."
    default: "250"
  size-l-threshold-files:
    description: "Threshold for size L in files."
    default: "5"
  size-l-threshold-commits:
    description: "Threshold for size L in commits."
    default: "3"
  size-m-threshold-lines:
    description: "Threshold for size M in lines."
    default: "100"
  size-m-threshold-files:
    description: "Threshold for size M in files."
    default: "3"
  size-m-threshold-commits:
    description: "Threshold for size M in commits."
    default: "2"
  size-s-threshold-lines:
    description: "Threshold for size S in lines."
    default: "50"
  size-s-threshold-files:
    description: "Threshold for size S in files."
    default: "2"
  size-s-threshold-commits:
    description: "Threshold for size S in commits."
    default: "1"
  size-xs-threshold-lines:
    description: "Threshold for size XS in lines."
    default: "25"
  size-xs-threshold-files:
    description: "Threshold for size XS in files."
    default: "1"
  size-xs-threshold-commits:
    description: "Threshold for size XS in commits."
    default: "1"
  project-ids:
    description: "Comma-separated list of project IDs to link issues and pull requests."
    default: ""
  project-column-issue-created:
    description: "Name of the project column for new issues."
    default: "Todo"
  project-column-pull-request-created:
    description: "Name of the project column for new pull requests."
    default: "In Progress"
  project-column-issue-in-progress:
    description: "Name of the project column for in progress issues."
    default: "In Progress"
  project-column-pull-request-in-progress:
    description: "Name of the project column for in progress pull requests."
    default: "In Progress"

  issue-type-task:
    description: "Name of the issue type for tasks."
    default: "Task"
  issue-type-task-description:
    description: "Description of the issue type for tasks."
    default: "A specific piece of work or activity that needs to be completed to achieve project goals."
  issue-type-task-color:
    description: "Color of the issue type for tasks."
    default: "blue"

  issue-type-bug:
    description: "Name of the issue type for bugs."
    default: "Bug"
  issue-type-bug-description:
    description: "Description of the issue type for bugs."
    default: "An issue indicating a defect, error, or malfunction that needs to be investigated and fixed."
  issue-type-bug-color:
    description: "Color of the issue type for bugs."
    default: "orange"

  issue-type-feature:
    description: "Name of the issue type for features."
    default: "Feature"
  issue-type-feature-description:
    description: "Description of the issue type for features."
    default: "A new functionality, enhancement, or improvement requested for the project."
  issue-type-feature-color:
    description: "Color of the issue type for features."
    default: "green"

  issue-type-documentation:
    description: "Name of the issue type for documentation."
    default: "Documentation"
  issue-type-documentation-description:
    description: "Description of the issue type for documentation."
    default: "An update, addition, or correction needed in the project's documentation."
  issue-type-documentation-color:
    description: "Color of the issue type for documentation."
    default: "pink"

  issue-type-maintenance:
    description: "Name of the issue type for maintenance."
    default: "Maintenance"
  issue-type-maintenance-description:
    description: "Description of the issue type for maintenance."
    default: "A task related to refactoring, dependency updates, or other technical maintenance work."
  issue-type-maintenance-color:
    description: "Color of the issue type for maintenance."
    default: "purple"

  issue-type-hotfix:
    description: "Name of the issue type for hotfixes."
    default: "Hotfix"
  issue-type-hotfix-description:
    description: "Description of the issue type for hotfixes."
    default: "A quick and urgent fix applied to resolve a critical issue in production."
  issue-type-hotfix-color:
    description: "Color of the issue type for hotfixes."
    default: "red"

  issue-type-release:
    description: "Name of the issue type for releases."
    default: "Release"
  issue-type-release-description:
    description: "Description of the issue type for releases."
    default: "An issue representing a deployment or version release of the project."
  issue-type-release-color:
    description: "Color of the issue type for releases."
    default: "yellow"

  issue-type-question:
    description: "Name of the issue type for questions."
    default: "Question"
  issue-type-question-description:
    description: "Description of the issue type for questions."
    default: "A question or clarification request related to the project or its implementation."
  issue-type-question-color:
    description: "Color of the issue type for questions."
    default: "gray"

  issue-type-help:
    description: "Name of the issue type for help."
    default: "Help"
  issue-type-help-description:
    description: "Description of the issue type for help."
    default: "A request for support, guidance, or assistance regarding the project."
  issue-type-help-color:
    description: "Color of the issue type for help."
    default: "purple"

  repository-locale:
    description: "BCP-47 locale for repository-facing messages. Issue and pull-request locales inherit it."
    default: "en-US"
  issues-locale:
    description: "Optional BCP-47 locale override for issue-facing messages. Empty inherits repository-locale."
    default: ""
  pull-requests-locale:
    description: "Optional BCP-47 locale override for pull-request-facing messages. Empty inherits repository-locale."
    default: ""
  main-branch:
    description: "Name of the main branch (e.g., master)."
    default: "master"
  development-branch:
    description: "Name of the development branch (e.g., develop)."
    default: "develop"
  docs-tree:
    description: "Naming convention for docs branches."
    default: "docs"
  chore-tree:
    description: "Naming convention for chore branches."
    default: "chore"
  feature-tree:
    description: "Naming convention for feature branches."
    default: "feature"
  bugfix-tree:
    description: "Naming convention for bugfix branches."
    default: "bugfix"
  hotfix-tree:
    description: "Naming convention for hotfix branches."
    default: "hotfix"
  release-tree:
    description: "Naming convention for release branches."
    default: "release"
  commit-prefix-transforms:
    description: "List of transformations to apply sequentially for commit prefix generation. Options: replace-slash, replace-all, lowercase, uppercase, kebab-case, snake-case, camel-case, trim, remove-numbers, clean-dashes, etc."
    default: "replace-slash"
  reopen-issue-on-push:
    description: "Reopens a closed issue when changes are pushed to the branch associated with the issue."
    default: "true"
  release-workflow:
    description: "Release workflow for running release deploys."
    default: "release_workflow.yml"
  hotfix-workflow:
    description: "Hotfix workflow for running hotfix deploys."
    default: "hotfix_workflow.yml"
  release-reconciliation-strategy:
    description: "Release reconciliation source after production publication: production-lineage, canonical-gitflow, or manual."
    default: "production-lineage"
  hotfix-reconciliation-strategy:
    description: "Hotfix reconciliation source after production publication: production-lineage, canonical-gitflow, or manual."
    default: "production-lineage"
  reconciliation-pr-mode:
    description: "Managed PR behavior: auto, auto-merge, merge-queue, or create-only."
    default: "auto"
  merge-queue-check-attestations:
    description: "JSON array of exact required-check attestations for merge queue targets; unknown checks block by default."
    default: "[]"
  reconciliation-backmerge-mode:
    description: "Back-merge branch shape: auto, direct, or sync-branch."
    default: "auto"
  hotfix-active-release-policy:
    description: "Hotfix reconciliation target policy: prefer-release, development, or both."
    default: "prefer-release"
  reconciliation-tree:
    description: "Safe prefix for ephemeral reconciliation branches."
    default: "sync"
  reconciliation-cleanup:
    description: "Branch cleanup after reconciliation: all, source-only, sync-only, or none."
    default: "all"
  reconciliation-issue-completion:
    description: "Launcher issue behavior after completion: close or keep-open."
    default: "close"
  orchestration-presentation-mode:
    description: "Release control-center detail: guided, compact, or quiet."
    default: "guided"
  orchestration-diagrams:
    description: "Render fixed-label Mermaid diagrams with a textual equivalent in guided mode."
    default: "true"
  orchestration-comment-mode:
    description: "Issue notification policy: update or milestones."
    default: "update"
  desired-assignees-count:
    description: "The number of assignees desired for the issue or pull request. If set to 0, no assignees will be added. If the number exceeds the available members, all members will be assigned. Max 10."
    default: "1"
  desired-reviewers-count:
    description: "The number of reviewers desired for the pull request. If set to 0, no reviewers will be added. If the number exceeds the available members, all members will be reviewers. Max 15."
    default: "1"
  token:
    description: "Fine-grained personal access token for branch and project operations"
    required: true
  agent-provider:
    description: "Single agent provider used by findings and fixer tasks: codex, opencode, or cursor. A provider failure is terminal; no fallback provider is attempted."
    default: "codex"
  agent-model-provider:
    description: "Provider that supplies the selected model, for example openai, opencode, openrouter, anthropic, or a local provider."
    default: "openai"
  agent-effort:
    description: "Optional reasoning effort or provider-specific model variant. Codex and OpenCode map this to their native CLI options."
    default: ""

  agent-model:
    description: "Selected model name without the provider prefix. The provider is configured separately with agent-model-provider."
    default: "gpt-6-luna"
  agent-executable:
    description: "Optional exact CLI basename or absolute executable path. Arguments, wrappers, and alternate basenames are rejected."
    default: ""
  findings-provider:
    description: "Optional provider override for findings."
    default: ""
  findings-model-provider:
    description: "Optional model-provider override for findings."
    default: ""
  findings-effort:
    description: "Optional reasoning effort or model variant override for findings."
    default: ""

  findings-model:
    description: "Optional model override for findings."
    default: ""
  findings-executable:
    description: "Optional validated executable override for findings."
    default: ""
  fixer-provider:
    description: "Optional provider override for fixer."
    default: ""
  fixer-model-provider:
    description: "Optional model-provider override for fixer."
    default: ""
  fixer-effort:
    description: "Optional reasoning effort or model variant override for fixer."
    default: ""

  fixer-model:
    description: "Optional model override for fixer."
    default: ""
  fixer-executable:
    description: "Optional validated executable override for fixer."
    default: ""
  planner-provider:
    description: "Optional provider override for planning and conversational commands."
    default: ""
  planner-model-provider:
    description: "Optional model-provider override for planning and conversational commands."
    default: ""
  planner-effort:
    description: "Optional reasoning effort or model variant override for planning."
    default: ""
  planner-model:
    description: "Optional model override for planning and conversational commands."
    default: ""
  planner-executable:
    description: "Optional validated executable override for planning."
    default: ""
  reviewer-provider:
    description: "Optional provider override for pull-request review."
    default: ""
  reviewer-model-provider:
    description: "Optional model-provider override for pull-request review."
    default: ""
  reviewer-effort:
    description: "Optional reasoning effort or model variant override for pull-request review."
    default: ""
  reviewer-model:
    description: "Optional model override for pull-request review."
    default: ""
  reviewer-executable:
    description: "Optional validated executable override for pull-request review."
    default: ""
  tester-provider:
    description: "Optional provider override for future test-planning and verification tasks."
    default: ""
  tester-model-provider:
    description: "Optional model-provider override for future test-planning and verification tasks."
    default: ""
  tester-effort:
    description: "Optional reasoning effort or model variant override for test tasks."
    default: ""
  tester-model:
    description: "Optional model override for test tasks."
    default: ""
  tester-executable:
    description: "Optional validated executable override for test tasks."
    default: ""
  ai-pull-request-description-mode:
    description: "PR description policy: replace (full ownership), append (preserve human text), preserve (only explicit /copilot description), or disabled."
    default: "replace"
  ai-ignore-files:
    description: "Comma-separated list of files to ignore for AI operations."
    default: ""
  ai-members-only:
    description: "Restrict AI features to only organization/project members."
    default: "false"
  ai-include-reasoning:
    description: "Include concise provider-supplied explanation metadata when available; never requests hidden chain-of-thought."
    default: "false"
  bugbot-severity:
    description: "Minimum severity for potential-problem detections to be published (info, low, medium, high). Findings below this are not posted as comments."
    default: "low"
  bugbot-comment-limit:
    description: "Maximum number of potential-problem findings to publish as individual comments on the issue and PR. Extra findings are summarized in a single overflow comment."
    default: "20"
  bugbot-fix-verify-commands:
    description: "Comma-separated commands to run after bugbot autofix (e.g. pnpm run build, pnpm test, pnpm run lint). The selected agent runtime runs these in its workspace; the runner can re-run them before commit. If empty, no additional verification commands are requested."
    default: ""
  bugbot-dry-run:
    description: "Analyze and return findings without publishing comments, resolving threads, updating checks, or performing autofix."
    default: "false"
  bugbot-effort:
    description: "Review effort policy: low, default, high, or smart (selected from diff complexity)."
    default: "default"
  bugbot-review-drafts:
    description: "Review draft pull requests when true."
    default: "false"
  bugbot-trace-rules:
    description: "Include the ordered rule sources used by the review in its summary."
    default: "false"
  bugbot-suggested-changes:
    description: "Allow safe line-local suggestions to be rendered as GitHub suggested changes."
    default: "true"
  bugbot-telemetry:
    description: "Emit redacted structured review telemetry and include it in the action result."
    default: "true"
  bugbot-fail-on-unresolved:
    description: "Fail this action invocation when the latest Bugbot result still contains open or reopened findings. Disabled by default."
    default: "false"
  bugbot-organization-rules:
    description: "Semicolon- or newline-separated organization rules applied before repository and path-scoped rules."
    default: ""
outputs:
  bugbot-telemetry:
    description: "JSON array of content-free Bugbot telemetry snapshots for this action run."
runs:
  using: "node24"
  main: "build/github_action/index.js"
branding:
  icon: "cpu"
  color: "blue"