@vypdev/copilot 3.2.0

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@vypdev/copilot",
+  "version": "3.2.0",
+  "packageManager": "pnpm@10.12.4",
+  "description": "Automates branch management, GitHub project linking, and issue/PR tracking with Git-Flow methodology.",
+  "homepage": "https://github.com/vypdev/copilot",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vypdev/copilot.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vypdev/copilot/issues"
+  },
+  "main": "build/github_action/index.js",
+  "bin": {
+    "copilot": "./build/cli/index.js"
+  },
+  "files": [
+    "action.yml",
+    "build/cli/index.js",
+    "build/github_action/index.js",
+    "setup/ISSUE_TEMPLATE/",
+    "setup/workflows/",
+    "setup/pull_request_template.md",
+    "scripts/install-git-hooks.cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "ncc build src/actions/github_action.ts -o build/github_action && ncc build src/cli.ts -o build/cli && chmod +x build/cli/index.js",
+    "validate:build": "node scripts/validate-build.cjs",
+    "validate:npm-package": "node scripts/validate-npm-package.cjs",
+    "smoke:npm-package": "node scripts/smoke-test-npm-package.cjs",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit",
+    "metrics:architecture": "node scripts/collect-architecture-metrics.cjs",
+    "lint": "eslint src",
+    "validate:agent-docs": "node scripts/validate-agent-documentation.cjs",
+    "validate:docs-page": "node scripts/validate-docs-page-assets.cjs",
+    "validate:workflows": "node scripts/validate-workflow-contract.cjs",
+    "lint:fix": "eslint src --fix",
+    "postinstall": "node scripts/install-git-hooks.cjs"
+  },
+  "keywords": [],
+  "author": "Efra Espada",
+  "license": "MIT",
+  "dependencies": {
+    "@actions/cache": "^4.1.0",
+    "@actions/core": "^1.11.1",
+    "@actions/exec": "^1.1.1",
+    "@actions/github": "^6.0.1",
+    "@types/axios": "^0.14.4",
+    "@types/chance": "^1.1.6",
+    "@types/dotenv": "^8.2.3",
+    "@types/js-yaml": "^4.0.9",
+    "axios": "^1.8.4",
+    "boxen": "^8.0.1",
+    "chalk": "^5.4.1",
+    "chance": "^1.1.12",
+    "commander": "^12.0.0",
+    "dockerode": "^4.0.5",
+    "dotenv": "^16.5.0",
+    "js-yaml": "^4.1.0",
+    "shell-quote": "^1.8.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.15.0",
+    "@types/dockerode": "^3.3.37",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.9.1",
+    "@vercel/ncc": "^0.36.1",
+    "eslint": "^9.15.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.2.2",
+    "typescript-eslint": "^8.15.0"
+  }
+}

package/scripts/install-git-hooks.cjs

@@ -0,0 +1,36 @@
+/**
+ * Installs git hooks from scripts/git-hooks/ into .git/hooks/.
+ * Cross-platform: Windows, macOS, Linux.
+ * Run automatically on pnpm install, or: node scripts/install-git-hooks.cjs
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const root = path.resolve(__dirname, '..');
+const hooksSrc = path.join(root, 'scripts', 'git-hooks');
+const hooksDst = path.join(root, '.git', 'hooks');
+
+if (!fs.existsSync(path.join(root, '.git')) || !fs.statSync(path.join(root, '.git')).isDirectory()) {
+  process.exit(0);
+}
+if (!fs.existsSync(hooksSrc) || !fs.statSync(hooksSrc).isDirectory()) {
+  process.exit(0);
+}
+if (!fs.existsSync(hooksDst) || !fs.statSync(hooksDst).isDirectory()) {
+  process.exit(0);
+}
+
+const files = fs.readdirSync(hooksSrc);
+for (const name of files) {
+  const src = path.join(hooksSrc, name);
+  if (!fs.statSync(src).isFile()) continue;
+  const dst = path.join(hooksDst, name);
+  fs.copyFileSync(src, dst);
+  try {
+    fs.chmodSync(dst, 0o755);
+  } catch (_) {
+    // Windows: chmod may not support execute; Git for Windows still runs the hook
+  }
+  console.log('Installed hook: ' + name);
+}

package/setup/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,100 @@
+name: 🐛 Bug Report
+description: Report a bug on copilot
+title: "<YOUR TITLE HERE>"
+labels: ["bug", "bugfix", "priority: high"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: |
+        Please search to see if an issue already exists for the bug you encountered.
+      options:
+        - label: I have searched the existing issues.
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: dropdown
+    id: plugins
+    attributes:
+      label: Which actions are affected?
+      multiple: true
+      options:
+        - Issue
+        - Pull Request
+        - Commits
+
+  - type: dropdown
+    id: platforms
+    attributes:
+      label: Which platforms are affected?
+      multiple: true
+      options:
+        - macOS
+        - Windows
+        - Linux
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: |
+        Describe the issue. Explain what you _expected_ to happen and what
+        _actually_ happened.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Reproducing the issue
+      description: |
+        Please provide either **steps to reproduce** or a [**minimal reproducible example**](https://stackoverflow.com/help/minimal-reproducible-example).
+        Providing a minimal reproducible example will help us triage your issue
+        faster.
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: input
+    attributes:
+      label: copilot Version
+      description: What version of copilot is being used?
+      placeholder: "master"
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Relevant Log Output
+      description: |
+        Please copy and paste any relevant log output.
+      placeholder: |
+        Paste your logs here. Please redact any personally identifiable
+        information. This will be automatically formatted into code, so no
+        need for backticks.
+      render: shell
+    validations:
+      required: false
+
+  - type: textarea
+    id: comments
+    attributes:
+      label: Additional context and comments
+      description: |
+        Anything else you want to add for this issue?

package/setup/ISSUE_TEMPLATE/chore_task.yml

@@ -0,0 +1,79 @@
+name: 🔧 Chore Task
+description: Suggest a maintenance or internal improvement task
+title: "<YOUR TITLE HERE>"
+labels: ["chore", "maintenance", "priority: low"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: |
+        Please search to see if an issue already exists for what you are proposing.
+      options:
+        - label: I have searched the existing issues.
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: dropdown
+    id: chore_scope
+    attributes:
+      label: What area does this task affect?
+      multiple: false
+      options:
+        - CI/CD
+        - Dependencies
+        - Code Refactoring
+        - Repository Configuration
+        - Other
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Task description
+      description: |
+        Describe the chore task in detail. Explain what needs to be done and why.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Current issues or inefficiencies
+      description: |
+        Describe any problems this task is addressing. Why is this necessary?
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected impact
+      description: |
+        Explain how completing this chore will improve the project.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Alternatives considered
+      description: |
+        If you considered alternative solutions, describe them here.
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    id: comments
+    attributes:
+      label: Additional context or comments
+      description: |
+        Add any additional context, logs, or examples related to this task.

package/setup/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Git-Flow
+    url: https://nvie.com/posts/a-successful-git-branching-model/
+    about: Check the original article by Vincent Driessen about git-flow before opening new issues.

package/setup/ISSUE_TEMPLATE/doc_update.yml

@@ -0,0 +1,71 @@
+name: 📝 Documentation Update
+description: Propose changes or improvements to the documentation
+title: "<YOUR TITLE HERE>"
+labels: ["documentation", "docs", "priority: low"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: |
+        Please search to see if an issue already exists for what you are proposing.
+      options:
+        - label: I have searched the existing issues.
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: dropdown
+    id: docs_scope
+    attributes:
+      label: What part of the documentation needs an update?
+      multiple: false
+      options:
+        - README.md
+        - Wiki
+        - API Documentation
+        - Inline Code Comments
+        - Other
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Describe the documentation update
+      description: |
+        Provide a clear and detailed explanation of what should be updated or added.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Why is this update needed?
+      description: |
+        Explain what issues or gaps this update is addressing.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Additional resources
+      description: |
+        If you have any external links, references, or examples, include them here.
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    id: comments
+    attributes:
+      label: Additional context or comments
+      description: |
+        Add any additional context or suggestions related to this documentation update.

package/setup/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,113 @@
+name: ✨ Feature Request
+description: Propose an idea or improvement for copilot
+title: "<YOUR TITLE HERE>"
+labels: ["enhancement", "feature", "priority: low"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue or feature request for this?
+      description: |
+        Please search to see if an issue or feature request already exists for what you are proposing.
+      options:
+        - label: I have searched the existing issues and feature requests.
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: dropdown
+    id: feature_scope
+    attributes:
+      label: What area does this improvement affect?
+      multiple: false
+      options:
+        - User Interface
+        - Performance
+        - New Feature
+        - Documentation
+        - Other
+
+  - type: dropdown
+    id: feature_actions
+    attributes:
+      label: What actions does this improvement affect?
+      multiple: true
+      options:
+        - Issue
+        - Pull Request
+        - Commit
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Description of the idea or improvement
+      description: |
+        Describe your proposed idea or improvement in detail. Explain what you
+        would like to see and why it matters.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Current limitations or challenges
+      description: |
+        Explain what problems or challenges this improvement would address.
+        Why is the current functionality insufficient?
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Expected impact
+      description: |
+        Describe how this improvement would benefit users or developers.
+        Include specific scenarios or use cases where this would make a difference.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Alternatives considered
+      description: |
+        If you have considered alternative solutions or approaches, describe them here.
+        Why do you think your proposal is the best option?
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: input
+    attributes:
+      label: Version of copilot
+      description: |
+        What version of copilot are you using, or does this proposal apply to all versions?
+      placeholder: "master"
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    id: comments
+    attributes:
+      label: Additional context or comments
+      description: |
+        Add any additional context, screenshots, or examples that may help us
+        understand your proposal better.

package/setup/ISSUE_TEMPLATE/help_request.yml

@@ -0,0 +1,72 @@
+name: 🙋 Help Request
+description: Ask for help, guidance, or clarification about something in the project
+title: "<YOUR QUESTION OR TOPIC HERE>"
+labels: ["help", "question", "priority: medium"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Have you checked for existing help or discussions?
+      description: |
+        Please make sure no one else has already asked this question or opened a similar issue.
+      options:
+        - label: I have searched existing issues and discussions.
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: dropdown
+    id: help_area
+    attributes:
+      label: What area do you need help with?
+      multiple: false
+      options:
+        - Code or implementation
+        - Build or setup
+        - Documentation or usage
+        - Workflow or CI/CD
+        - Other
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+
+  - type: textarea
+    attributes:
+      label: Describe your problem or question
+      description: |
+        Clearly describe what you need help with. Include context, what you've tried, and what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps or attempts you've already made
+      description: |
+        Describe what you’ve already tried to solve this problem. This helps others avoid suggesting the same things.
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Environment or context
+      description: |
+        Provide details such as OS, version, branch, or any relevant environment information.
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Additional context or screenshots
+      description: |
+        If applicable, add screenshots, logs, or any extra information that may help others understand the issue.
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        ---

package/setup/ISSUE_TEMPLATE/hotfix.yml

@@ -0,0 +1,64 @@
+name: 🔥 Hotfix Issue
+
+description: Request a new hotfix for copilot (only team members)
+title: "<YOUR TITLE HERE>"
+labels: [ "hotfix", "branched", "priority: high" ]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### ⚠️ Disclaimer
+        > **Only members of the copilot team can create hotfix issues.**
+        > Any hotfix issue created by someone outside the team will be closed automatically.
+
+        ---
+
+  - type: input
+    id: base_version
+    attributes:
+      label: Base Version
+      description: |
+        The base version is typically the most recent tag version. However, you can specify a different version tag if you'd like to start from a specific version for this hotfix.
+      placeholder: "e.g., 1.2.3"
+      value: "Automatic"
+    validations:
+      required: false
+
+  - type: input
+    id: hotfix_version
+    attributes:
+      label: Hotfix Version
+      description: |
+        By default, the version will increment the patch number of the most recent tag version (e.g., from 1.2.3 to 1.2.4). You can specify a different version number for the hotfix if needed.
+      placeholder: "e.g., 1.2.4"
+      value: "Automatic"
+    validations:
+      required: false
+
+  - type: textarea
+    id: issue_description
+    attributes:
+      label: Issue Description
+      description: |
+        Provide a detailed description of the issue this hotfix is addressing.
+      placeholder: "Describe the issue being fixed."
+    validations:
+      required: true
+
+  - type: textarea
+    id: hotfix_solution
+    attributes:
+      label: Hotfix Solution
+      description: |
+        Explain the solution being implemented in this hotfix.
+      placeholder: "Describe the solution."
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional Context
+      description: |
+        Add any additional details or context about this hotfix request.
+      placeholder: "Anything else to note?"

package/setup/ISSUE_TEMPLATE/release.yml

@@ -0,0 +1,51 @@
+name: 🚀 Release Issue
+description: Request a new release for copilot (only team members)
+title: "<YOUR TITLE HERE>"
+labels: ["release", "branched", "priority: medium"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### ⚠️ Disclaimer
+        > **Only members of the copilot team can create release issues.**
+        > Any release issue created by someone outside the team will be closed automatically.
+
+        ---
+
+  - type: dropdown
+    id: release_type
+    attributes:
+      label: Release Type
+      description: Indicate the type of release.
+      options:
+        - Patch
+        - Minor
+        - Major
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Release Version
+      description: The new version is generated from the release type and the most recent tag version. You can specify a different version number for the release (e.g., 1.2.3).
+      placeholder: "e.g., 1.2.3"
+      value: "Automatic"
+    validations:
+      required: false
+
+  - type: textarea
+    id: changelog
+    attributes:
+      label: Changelog
+      description: Provide a summary of the changes to be included in this release.
+      placeholder: "Add a concise changelog here."
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional Context
+      description: Add any additional details or context about this release request.
+      placeholder: "Anything else to note?"