@vfarcic/dot-ai 0.124.0 → 0.125.0

package/assets/project-setup/templates/.github/CODEOWNERS.hbs

@@ -0,0 +1,25 @@
+# CODEOWNERS
+#
+# Code owners are automatically requested for review when someone opens a pull request
+# that modifies code that they own. Code owners are not automatically requested to review
+# draft pull requests.
+#
+# See: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Global owners (default for everything in the repository)
+{{#isTrue useTeams}}
+# Using GitHub teams for code ownership
+* @{{githubOrg}}/{{defaultTeam}}
+{{else}}
+# Using individual maintainers for code ownership
+* {{#each maintainerUsernames}}@{{this}} {{/each}}
+{{/isTrue}}
+
+# Notes:
+# - Code owners are automatically requested for review when PRs modify their files
+# - You can define path-specific owners by adding lines like:
+#   /docs/ @docs-team
+#   /.github/ @devops-team
+#   /src/core/ @architecture-team
+# - Order matters: later matches take precedence over earlier ones
+# - Use teams (@org/team) for easier maintenance in larger projects

package/assets/project-setup/templates/.github/FUNDING.yml.hbs

@@ -0,0 +1,35 @@
+# Funding links for this project
+#
+# This file enables the "Sponsor" button in the GitHub repository UI.
+#
+# See: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository
+
+{{#if githubSponsors}}
+# GitHub Sponsors
+github: {{githubSponsors}}
+{{/if}}
+
+{{#if openCollective}}
+# Open Collective
+open_collective: {{openCollective}}
+{{/if}}
+
+{{#if patreon}}
+# Patreon
+patreon: {{patreon}}
+{{/if}}
+
+{{#if kofi}}
+# Ko-fi
+ko_fi: {{kofi}}
+{{/if}}
+
+{{#if tidelift}}
+# Tidelift
+tidelift: {{tidelift}}
+{{/if}}
+
+{{#if customFunding}}
+# Custom funding URL
+custom: ["{{customFunding}}"]
+{{/if}}

package/assets/project-setup/templates/.github/ISSUE_TEMPLATE/bug_report.yml.hbs

@@ -0,0 +1,175 @@
+name: Bug Report
+description: Report a bug to help us improve {{projectName}}
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report a bug! Please fill out the form below to help us diagnose and fix the issue.
+
+        **Before submitting:**
+        - Search existing issues to avoid duplicates
+{{#if docsSiteUrl}}
+        - Check the [documentation]({{docsSiteUrl}}) for solutions
+{{/if}}
+{{#if supportFilePath}}
+        - Review [SUPPORT.md](https://github.com/{{githubOrg}}/{{githubRepo}}/blob/main/{{supportFilePath}}) for help resources
+{{/if}}
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Run command '...'
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: Describe what you expected...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+      placeholder: Describe what actually happened...
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: "## Environment"
+
+  - type: input
+    id: version
+    attributes:
+      label: "{{projectName}} Version"
+      description: "What version are you running?"
+      placeholder: "e.g., v1.2.3 or commit SHA"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      description: "What OS are you using?"
+      placeholder: "e.g., Ubuntu 22.04, macOS 13.5, Windows 11"
+    validations:
+      required: true
+{{#isTrue isNodeProject}}
+
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js Version
+      description: "Output of `node --version`"
+      placeholder: "e.g., v18.17.0"
+    validations:
+      required: true
+
+  - type: input
+    id: npm-version
+    attributes:
+      label: npm/yarn Version
+      description: "Output of `npm --version` or `yarn --version`"
+      placeholder: "e.g., 9.6.7"
+{{/isTrue}}
+{{#isTrue isPythonProject}}
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: "Output of `python --version`"
+      placeholder: "e.g., 3.11.4"
+    validations:
+      required: true
+
+  - type: input
+    id: pip-version
+    attributes:
+      label: pip Version
+      description: "Output of `pip --version`"
+      placeholder: "e.g., 23.1.2"
+{{/isTrue}}
+{{#isTrue isGoProject}}
+
+  - type: input
+    id: go-version
+    attributes:
+      label: Go Version
+      description: "Output of `go version`"
+      placeholder: "e.g., go1.21.0"
+    validations:
+      required: true
+{{/isTrue}}
+{{#isTrue isKubernetesProject}}
+
+  - type: input
+    id: kubernetes-version
+    attributes:
+      label: Kubernetes Version
+      description: "Output of `kubectl version --short`"
+      placeholder: "e.g., v1.27.3"
+    validations:
+      required: true
+
+  - type: input
+    id: cloud-provider
+    attributes:
+      label: Cloud Provider / Platform
+      description: "Where is Kubernetes running?"
+      placeholder: "e.g., AWS EKS, Google GKE, Azure AKS, self-hosted, minikube, kind"
+{{/isTrue}}
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant Logs
+      description: "Paste any relevant log output here"
+      placeholder: |
+        Paste logs here...
+      render: shell
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: "Add any other context about the problem here (screenshots, configuration files, etc.)"
+      placeholder: |
+        Any additional information...
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues to ensure this bug hasn't been reported before
+          required: true
+        - label: I have included all relevant information above
+          required: true

package/assets/project-setup/templates/.github/ISSUE_TEMPLATE/config.yml.hbs

@@ -0,0 +1,32 @@
+blank_issues_enabled: {{blankIssuesEnabled}}
+contact_links:
+{{#isTrue hasDiscussions}}
+  - name: 💬 GitHub Discussions
+    url: https://github.com/{{githubOrg}}/{{githubRepo}}/discussions
+    about: Ask questions, share ideas, and discuss with the community
+{{/isTrue}}
+{{#if docsSiteUrl}}
+  - name: 📚 Documentation
+    url: {{docsSiteUrl}}
+    about: Read the documentation before reporting issues
+{{/if}}
+{{#if supportFilePath}}
+  - name: ❓ Support Resources
+    url: https://github.com/{{githubOrg}}/{{githubRepo}}/blob/main/{{supportFilePath}}
+    about: Learn how to get help and where to ask questions
+{{/if}}
+{{#if slackInviteUrl}}
+  - name: 💙 Slack Community
+    url: {{slackInviteUrl}}
+    about: Join our Slack workspace for real-time support and discussions
+{{/if}}
+{{#if discordInviteUrl}}
+  - name: 🎮 Discord Server
+    url: {{discordInviteUrl}}
+    about: Join our Discord community for support and discussions
+{{/if}}
+{{#if securityFilePath}}
+  - name: 🔒 Security Vulnerabilities
+    url: https://github.com/{{githubOrg}}/{{githubRepo}}/blob/main/{{securityFilePath}}
+    about: Report security vulnerabilities privately following our security policy
+{{/if}}

package/assets/project-setup/templates/.github/ISSUE_TEMPLATE/feature_request.yml.hbs

@@ -0,0 +1,134 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for {{projectName}}
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting a new feature! Please describe the problem you're trying to solve and your proposed solution.
+
+        **Before submitting:**
+        - Search existing issues and feature requests to avoid duplicates
+{{#if roadmapPath}}
+        - Review the [project roadmap](https://github.com/{{githubOrg}}/{{githubRepo}}/blob/main/{{roadmapPath}}) to see if this is already planned
+{{/if}}
+{{#isTrue hasDiscussions}}
+        - Consider starting a [discussion](https://github.com/{{githubOrg}}/{{githubRepo}}/discussions) first to gather feedback
+{{/isTrue}}
+
+        **Note:** "Nice to have" is not a strong use case. Please explain the specific problem this feature would solve.
+
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: What problem are you trying to solve? Why is it important?
+      placeholder: |
+        Describe the problem you're experiencing or the gap you've identified.
+        Focus on the problem, not the solution.
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: who-is-affected
+    attributes:
+      label: Who is affected by this problem?
+      description: Help us understand the impact and audience
+      options:
+        - label: End users
+        - label: Developers/contributors
+        - label: Platform engineers/operators
+        - label: Documentation users
+        - label: Other (please describe below)
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like to see
+      placeholder: |
+        How would this feature work? What would the user experience be?
+        Be as specific as possible.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What other approaches have you considered or tried?
+      placeholder: |
+        - Current workarounds you're using
+        - Other tools or features that solve similar problems
+        - Why those alternatives don't fully address the need
+    validations:
+      required: false
+
+  - type: textarea
+    id: use-cases
+    attributes:
+      label: Use Cases
+      description: Describe 1-3 specific scenarios where this feature would be valuable
+      placeholder: |
+        **Use Case 1:** [Describe a specific scenario]
+        **Use Case 2:** [Describe another scenario]
+      value: |
+        **Use Case 1:**
+
+        **Use Case 2:**
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context, screenshots, mockups, or examples
+      placeholder: |
+        - Links to relevant documentation
+        - Screenshots or mockups
+        - Examples from other projects
+        - Performance or scalability considerations
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - "Nice to have"
+        - "Important (workarounds exist but are painful)"
+        - "Critical (blocking my use of {{projectName}})"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: contribution
+    attributes:
+      label: Are you willing to contribute this feature?
+      description: Would you be interested in implementing this feature with guidance from maintainers?
+      options:
+        - "Yes, I'd like to implement this"
+        - "Yes, with help from maintainers"
+        - "Maybe, depending on complexity"
+        - "No, but I can help test it"
+        - "No, I'm just suggesting it"
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues and feature requests
+          required: true
+        - label: I have described the problem, not just the solution
+          required: true
+{{#if roadmapPath}}
+        - label: I have reviewed the project roadmap ({{roadmapPath}})
+          required: false
+{{/if}}

package/assets/project-setup/templates/.github/PULL_REQUEST_TEMPLATE.md.hbs

@@ -0,0 +1,172 @@
+<!--
+Thank you for contributing to {{projectName}}! Please fill out this template to help us review your changes.
+-->
+
+## Description
+<!-- Provide a clear and concise description of your changes -->
+
+**What does this PR do?**
+
+**Why is this change needed?**
+
+## Related Issues
+<!-- Link to related issues using keywords for automatic closure -->
+<!-- Examples: "Closes #123", "Fixes #456", "Resolves #789" -->
+
+- Related to: #
+
+## Type of Change
+<!-- Check all that apply -->
+
+- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
+- [ ] ✨ New feature (non-breaking change that adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] 📚 Documentation update
+- [ ] ♻️ Refactoring (no functional changes)
+- [ ] ✅ Test updates (adding or updating tests)
+- [ ] 🔧 Configuration changes
+- [ ] 🚀 Performance improvements
+- [ ] 🎨 Style changes (formatting, naming, etc.)
+- [ ] 📦 Dependency updates
+- [ ] 🔨 CI/CD changes
+
+{{#isTrue requiresConventionalCommits}}
+## Conventional Commit Format
+<!-- This project uses Conventional Commits for automated changelog generation -->
+
+**Your PR title should follow this format:**
+```
+<type>(<scope>): <description>
+
+Examples:
+  feat(auth): add OAuth2 authentication support
+  fix(api): resolve null pointer exception in user service
+  docs(readme): update installation instructions
+  chore(deps): bump typescript from 5.0.0 to 5.1.0
+```
+
+**Common types:**
+- `feat:` - New feature (minor version bump)
+- `fix:` - Bug fix (patch version bump)
+- `docs:` - Documentation changes
+- `refactor:` - Code refactoring (no functional changes)
+- `test:` - Adding/updating tests
+- `chore:` - Maintenance tasks (dependencies, build, CI/CD)
+- `perf:` - Performance improvements
+
+**Breaking changes:**
+```
+feat(api)!: remove deprecated v1 endpoints
+
+BREAKING CHANGE: v1 API endpoints have been removed.
+See MIGRATION.md for upgrade guide.
+```
+
+{{/isTrue}}
+## Testing Checklist
+<!-- Ensure all relevant tests have been completed -->
+
+- [ ] Tests added or updated
+- [ ] All existing tests pass locally
+- [ ] Manual testing performed
+- [ ] Test coverage maintained or improved
+
+**Test commands run:**
+```bash
+# Commands you ran locally to verify your changes
+# (Automated CI tests will run automatically on PR submission)
+```
+
+**Test results:**
+<!-- Describe test results, including any relevant output or screenshots -->
+
+## Documentation Checklist
+<!-- Ensure documentation is updated to reflect your changes -->
+
+- [ ] README.md updated (if user-facing changes)
+- [ ] Documentation updated (if applicable)
+- [ ] Code comments added for complex logic
+- [ ] API documentation updated (if API changes)
+{{#if contributingPath}}
+- [ ] [CONTRIBUTING.md]({{contributingPath}}) guidelines followed
+{{/if}}
+
+{{#isTrue includesSecurityChecklist}}
+## Security Checklist
+<!-- Complete if your changes affect security -->
+
+- [ ] No secrets or credentials committed
+- [ ] Input validation implemented where needed
+- [ ] Security implications considered and documented
+- [ ] Dependencies scanned for vulnerabilities
+- [ ] Authentication/authorization logic reviewed
+- [ ] Error messages don't leak sensitive information
+
+{{/isTrue}}
+{{#isTrue requiresScreenshots}}
+## Screenshots / Recordings
+<!-- For UI changes, provide before/after screenshots or recordings -->
+
+**Before:**
+<!-- Add screenshots or recordings showing the current behavior -->
+
+**After:**
+<!-- Add screenshots or recordings showing your changes -->
+
+{{/isTrue}}
+## Breaking Changes
+<!-- If this is a breaking change, describe the impact and provide migration guidance -->
+
+**Does this PR introduce breaking changes?**
+- [ ] Yes
+- [ ] No
+
+**If yes, describe the breaking changes and migration path:**
+
+{{#isTrue requiresDco}}
+## Developer Certificate of Origin
+<!-- This project requires DCO sign-off for all commits -->
+
+By submitting this pull request, I certify that:
+
+- The contribution was created in whole or in part by me and I have the right to submit it under the project's open source license.
+- I understand and agree that this project and my contribution are public and that a record of the contribution (including all personal information I submit with it) is maintained indefinitely.
+
+**DCO Sign-off:**
+All commits must include a `Signed-off-by` line:
+```bash
+git commit -s -m "Your commit message"
+```
+
+If you forgot to sign off your commits, you can amend them:
+```bash
+git commit --amend --signoff
+git push --force-with-lease
+```
+
+{{/isTrue}}
+## Checklist
+<!-- Final pre-submission checklist -->
+
+- [ ] My code follows the project's code style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] My changes generate no new warnings or errors
+- [ ] I have added tests that prove my fix is effective or my feature works
+- [ ] New and existing tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+{{#isTrue requiresDco}}
+- [ ] All commits are signed off (DCO)
+{{/isTrue}}
+{{#isTrue requiresConventionalCommits}}
+- [ ] PR title follows Conventional Commits format
+{{/isTrue}}
+
+## Additional Context
+<!-- Add any other context, considerations, or notes for reviewers -->
+
+**Reviewer Notes:**
+<!-- Anything specific you want reviewers to focus on? -->
+
+**Follow-up Work:**
+<!-- Any planned follow-up PRs or related work? -->

package/assets/project-setup/templates/.github/labeler.yml.hbs

@@ -0,0 +1,123 @@
+# This configuration automatically labels pull requests based on file paths.
+# Learn more: https://github.com/actions/labeler
+
+# Documentation changes
+documentation:
+- changed-files:
+  - any-glob-to-any-file:
+    - 'docs/**/*'
+    - '*.md'
+    - 'README*'
+
+{{#if sourceDirectory}}
+# Source code changes
+source:
+- changed-files:
+  - any-glob-to-any-file:
+    - '{{sourceDirectory}}/**/*'
+
+{{/if}}
+{{#if testDirectory}}
+# Test changes
+tests:
+- changed-files:
+  - any-glob-to-any-file:
+    - '{{testDirectory}}/**/*'
+    - '**/*.test.*'
+    - '**/*.spec.*'
+
+{{/if}}
+# CI/CD changes
+ci-cd:
+- changed-files:
+  - any-glob-to-any-file:
+    - '.github/workflows/**/*'
+    - '.github/actions/**/*'
+    - 'Dockerfile*'
+    - 'docker-compose*.yml'
+
+# Infrastructure changes
+infrastructure:
+- changed-files:
+  - any-glob-to-any-file:
+    {{#if infrastructureDirectory}}
+    - '{{infrastructureDirectory}}/**/*'
+    {{/if}}
+    # Terraform
+    - '*.tf'
+    - 'terraform/**/*'
+    - 'tf/**/*'
+    # Kubernetes
+    - 'k8s/**/*'
+    - 'kubernetes/**/*'
+    - 'manifests/**/*'
+    # Helm
+    - 'helm/**/*'
+    - 'Chart.yaml'
+    - 'values.yaml'
+    # Ansible
+    - 'ansible/**/*'
+    - '*.ansible.yml'
+    - 'playbook*.yml'
+    # CloudFormation
+    - '*.template'
+    - '*.cfn.yml'
+    - 'cloudformation/**/*'
+    # Crossplane
+    - 'crossplane/**/*'
+    # Pulumi
+    - 'Pulumi*.yaml'
+    - 'pulumi/**/*'
+
+# Dependencies
+dependencies:
+- changed-files:
+  - any-glob-to-any-file:
+    # JavaScript/Node.js
+    - 'package.json'
+    - 'package-lock.json'
+    - 'yarn.lock'
+    - 'pnpm-lock.yaml'
+    # Python
+    - 'requirements.txt'
+    - 'Pipfile*'
+    - 'poetry.lock'
+    - 'pyproject.toml'
+    # Go
+    - 'go.mod'
+    - 'go.sum'
+    # Rust
+    - 'Cargo.toml'
+    - 'Cargo.lock'
+    # Java
+    - 'pom.xml'
+    - 'build.gradle*'
+    - 'settings.gradle*'
+    # Ruby
+    - 'Gemfile'
+    - 'Gemfile.lock'
+    # PHP
+    - 'composer.json'
+    - 'composer.lock'
+    # .NET
+    - '*.csproj'
+    - '*.fsproj'
+    - '*.vbproj'
+    - 'packages.config'
+    # Swift
+    - 'Package.swift'
+    - 'Package.resolved'
+    # Elixir
+    - 'mix.exs'
+    - 'mix.lock'
+
+# Configuration changes
+config:
+- changed-files:
+  - any-glob-to-any-file:
+    - '*.config.*'
+    - '*.json'
+    - '*.yaml'
+    - '*.yml'
+    - '*.toml'
+    - '.env*'