diff --git a/.codespellrc b/.codespellrc new file mode 100644 index 00000000..7f9b3fa8 --- /dev/null +++ b/.codespellrc @@ -0,0 +1,16 @@ +[codespell] +# Ignore intentional misspellings used as examples and technical terms +# numer - intentional example typo in add-educational-comments.prompt.md +# wit - proper technical term/name (sardonic wit, Gilfoyle character trait) +# aks - Azure Kubernetes Service (AKS) abbreviation +# edn - Extensible Data Notation (Clojure data format) +# ser - serialization abbreviation +# ois - ObjectInputStream abbreviation in Java +# gir - valid abbreviation/technical term +# rouge - Rouge is a syntax highlighter (not "rogue") +# categor - TypeScript template literal in website/src/scripts/pages/skills.ts:70 (categor${...length > 1 ? "ies" : "y"}) +# aline - proper name (Aline Ávila, contributor) +# ative - part of "Declarative Agents" in TypeSpec M365 Copilot documentation (collections/typespec-m365-copilot.collection.md) +ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques +# Skip certain files and directories +skip = .git,node_modules,package-lock.json,*.lock,website/build,website/.docusaurus diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 4ebf9c97..e74c6fe8 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -25,7 +25,7 @@ The following instructions are only to be applied when performing a code review. - [ ] The instruction has a `description` field. - [ ] The `description` field is not empty. - [ ] The file name is lower case, with words separated by hyphens. -- [ ] The instruction has an `applyTo` field that specifies the file or files to which the instructions apply. If they wish to specify multiple file paths they should formated like `'**.js, **.ts'`. +- [ ] The instruction has an `applyTo` field that specifies the file or files to which the instructions apply. If they wish to specify multiple file paths they should formatted like `'**.js, **.ts'`. ## Agent file guide diff --git a/.github/workflows/codespell.yml b/.github/workflows/codespell.yml new file mode 100644 index 00000000..fa44e258 --- /dev/null +++ b/.github/workflows/codespell.yml @@ -0,0 +1,22 @@ +name: Check Spelling + +on: + push: + branches: [main] + pull_request: + branches: [main] + +permissions: + contents: read + +jobs: + codespell: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - name: Check spelling with codespell + uses: codespell-project/actions-codespell@v2 + with: + check_filenames: true + check_hidden: false diff --git a/.github/workflows/deploy-website.yml b/.github/workflows/deploy-website.yml new file mode 100644 index 00000000..e7f7e81d --- /dev/null +++ b/.github/workflows/deploy-website.yml @@ -0,0 +1,82 @@ +# GitHub Pages deployment workflow +# Builds the Astro website and deploys to GitHub Pages + +name: Deploy Website to GitHub Pages + +on: + # Runs on pushes targeting the default branch + push: + branches: ["main"] + paths: + - "website/**" + - "agents/**" + - "prompts/**" + - "instructions/**" + - "skills/**" + - "collections/**" + - "cookbook/**" + - "eng/generate-website-data.mjs" + - ".github/workflows/deploy-website.yml" + + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages +permissions: + contents: read + pages: write + id-token: write + +# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued. +# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete. +concurrency: + group: "pages" + cancel-in-progress: false + +jobs: + # Build job + build: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: "20" + cache: "npm" + + - name: Install root dependencies + run: npm ci + + - name: Install website dependencies + run: npm ci + working-directory: ./website + + - name: Generate website data + run: npm run website:data + + - name: Build Astro site + run: npm run build + working-directory: ./website + + - name: Setup Pages + uses: actions/configure-pages@v5 + + - name: Upload artifact + uses: actions/upload-pages-artifact@v3 + with: + path: "./website/dist" + + # Deployment job + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + needs: build + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 diff --git a/.gitignore b/.gitignore index 893a921b..5167cf50 100644 --- a/.gitignore +++ b/.gitignore @@ -6,3 +6,12 @@ reports/ # macOS system files .DS_Store *.tmp + +# Generated files +/llms.txt + +# Website build artifacts +website/dist/ +website/.astro/ +website/public/data/* +website/public/llms.txt diff --git a/.schemas/cookbook.schema.json b/.schemas/cookbook.schema.json new file mode 100644 index 00000000..857bd84e --- /dev/null +++ b/.schemas/cookbook.schema.json @@ -0,0 +1,99 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "Cookbook Manifest", + "description": "Schema for cookbook.yml manifest defining cookbooks and recipes", + "type": "object", + "required": ["cookbooks"], + "properties": { + "cookbooks": { + "type": "array", + "description": "List of cookbooks", + "items": { + "type": "object", + "required": ["id", "name", "description", "path", "languages", "recipes"], + "properties": { + "id": { + "type": "string", + "description": "Unique identifier for the cookbook", + "pattern": "^[a-z0-9-]+$" + }, + "name": { + "type": "string", + "description": "Display name for the cookbook" + }, + "description": { + "type": "string", + "description": "Brief description of the cookbook" + }, + "path": { + "type": "string", + "description": "Relative path to the cookbook folder" + }, + "featured": { + "type": "boolean", + "description": "Whether this cookbook should be featured", + "default": false + }, + "languages": { + "type": "array", + "description": "Programming languages supported by this cookbook", + "items": { + "type": "object", + "required": ["id", "name"], + "properties": { + "id": { + "type": "string", + "description": "Language identifier (folder name)", + "pattern": "^[a-z0-9-]+$" + }, + "name": { + "type": "string", + "description": "Display name for the language" + }, + "icon": { + "type": "string", + "description": "Emoji icon for the language" + }, + "extension": { + "type": "string", + "description": "File extension for runnable examples", + "pattern": "^\\.[a-z]+$" + } + } + } + }, + "recipes": { + "type": "array", + "description": "List of recipes in this cookbook", + "items": { + "type": "object", + "required": ["id", "name", "description"], + "properties": { + "id": { + "type": "string", + "description": "Recipe identifier (matches markdown filename without extension)", + "pattern": "^[a-z0-9-]+$" + }, + "name": { + "type": "string", + "description": "Display name for the recipe" + }, + "description": { + "type": "string", + "description": "Brief description of what the recipe covers" + }, + "tags": { + "type": "array", + "description": "Tags for filtering and categorization", + "items": { + "type": "string" + } + } + } + } + } + } + } + } + } +} diff --git a/.schemas/tools.schema.json b/.schemas/tools.schema.json new file mode 100644 index 00000000..4de6fc09 --- /dev/null +++ b/.schemas/tools.schema.json @@ -0,0 +1,151 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "Tools Catalog", + "description": "Schema for the awesome-copilot tools catalog (website/data/tools.yml)", + "type": "object", + "required": ["tools"], + "additionalProperties": false, + "properties": { + "tools": { + "type": "array", + "description": "List of tools in the catalog", + "minItems": 1, + "items": { + "type": "object", + "required": ["id", "name", "description", "category"], + "additionalProperties": false, + "properties": { + "id": { + "type": "string", + "description": "Unique identifier for the tool", + "pattern": "^[a-z0-9-]+$", + "minLength": 1, + "maxLength": 50 + }, + "name": { + "type": "string", + "description": "Display name for the tool", + "minLength": 1, + "maxLength": 100 + }, + "description": { + "type": "string", + "description": "Description of what this tool does", + "minLength": 1, + "maxLength": 1000 + }, + "category": { + "type": "string", + "description": "Category for grouping tools", + "minLength": 1, + "maxLength": 50, + "examples": ["MCP Servers", "VS Code Extensions", "CLI Tools", "Visual Studio Extensions"] + }, + "featured": { + "type": "boolean", + "description": "Whether this tool is featured (shown first)", + "default": false + }, + "requirements": { + "type": "array", + "description": "List of requirements to use this tool", + "items": { + "type": "string", + "minLength": 1, + "maxLength": 200 + }, + "maxItems": 10 + }, + "features": { + "type": "array", + "description": "List of key features", + "items": { + "type": "string", + "minLength": 1, + "maxLength": 200 + }, + "maxItems": 20 + }, + "links": { + "type": "object", + "description": "Links related to this tool", + "additionalProperties": false, + "properties": { + "blog": { + "type": "string", + "description": "Link to a blog post about the tool", + "format": "uri" + }, + "documentation": { + "type": "string", + "description": "Link to documentation", + "format": "uri" + }, + "github": { + "type": "string", + "description": "Link to GitHub repository", + "format": "uri" + }, + "marketplace": { + "type": "string", + "description": "Link to VS Code or Visual Studio Marketplace", + "format": "uri" + }, + "npm": { + "type": "string", + "description": "Link to npm package", + "format": "uri" + }, + "pypi": { + "type": "string", + "description": "Link to PyPI package", + "format": "uri" + }, + "vscode": { + "type": "string", + "description": "VS Code install link (vscode: URI or aka.ms link)" + }, + "vscode-insiders": { + "type": "string", + "description": "VS Code Insiders install link" + }, + "visual-studio": { + "type": "string", + "description": "Visual Studio install link" + } + } + }, + "configuration": { + "type": "object", + "description": "Configuration snippet for the tool", + "required": ["type", "content"], + "additionalProperties": false, + "properties": { + "type": { + "type": "string", + "description": "Type of configuration (for syntax highlighting)", + "enum": ["json", "yaml", "bash", "toml", "ini"] + }, + "content": { + "type": "string", + "description": "The configuration content" + } + } + }, + "tags": { + "type": "array", + "description": "Tags for filtering and discovery", + "items": { + "type": "string", + "pattern": "^[a-z0-9-]+$", + "minLength": 1, + "maxLength": 30 + }, + "uniqueItems": true, + "maxItems": 15 + } + } + } + } + } +} diff --git a/.vscode/settings.json b/.vscode/settings.json index bf073eb4..b28e8cdb 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -15,6 +15,7 @@ "*.prompt.md": "prompt" }, "yaml.schemas": { - "./.schemas/collection.schema.json": "*.collection.yml" + "./.schemas/collection.schema.json": "*.collection.yml", + "./.schemas/tools.schema.json": "website/data/tools.yml", } } diff --git a/AGENTS.md b/AGENTS.md index 352ba737..1a1c4c95 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -172,6 +172,7 @@ For instruction files (*.instructions.md): For agent files (*.agent.md): - [ ] Has markdown front matter - [ ] Has non-empty `description` field wrapped in single quotes +- [ ] Has `name` field with human-readable name (e.g., "Address Comments" not "address-comments") - [ ] File name is lower case with hyphens - [ ] Includes `model` field (strongly recommended) - [ ] Considers using `tools` field diff --git a/README.md b/README.md index f106d3da..5398041d 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# 🤖 Awesome GitHub Copilot Customizations +# 🤖 Awesome GitHub Copilot [![Powered by Awesome Copilot](https://img.shields.io/badge/Powered_by-Awesome_Copilot-blue?logo=githubcopilot)](https://aka.ms/awesome-github-copilot) [![GitHub contributors from allcontributors.org](https://img.shields.io/github/all-contributors/github/awesome-copilot?color=ee8449)](#contributors-) @@ -13,6 +13,7 @@ This repository provides a comprehensive toolkit for enhancing GitHub Copilot wi - **👉 [Awesome Instructions](docs/README.instructions.md)** - Comprehensive coding standards and best practices that apply to specific file patterns or entire projects - **👉 [Awesome Skills](docs/README.skills.md)** - Self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized tasks - **👉 [Awesome Collections](docs/README.collections.md)** - Curated collections of related prompts, instructions, agents, and skills organized around specific themes and workflows +- **👉 [Awesome Cookbook Recipes](cookbook/README.md)** - Practical, copy-paste-ready code snippets and real-world examples for working with GitHub Copilot tools and features ## 🌟 Featured Collections @@ -53,6 +54,10 @@ To make it easy to add these customizations to your editor, we have created a [M +## 📄 llms.txt + +An [`llms.txt`](https://github.github.io/awesome-copilot/llms.txt) file following the [llmstxt.org](https://llmstxt.org/) specification is available on the GitHub Pages site. This machine-readable file makes it easy for Large Language Models to discover and understand all available agents, prompts, instructions, and skills, providing a structured overview of the repository's resources with names and descriptions. + ## 🔧 How to Use ### 🤖 Custom Agents diff --git a/agents/accessibility.agent.md b/agents/accessibility.agent.md index 69cd49fd..10ec5d0e 100644 --- a/agents/accessibility.agent.md +++ b/agents/accessibility.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing' +name: 'Accessibility Expert' model: GPT-4.1 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI'] --- diff --git a/agents/address-comments.agent.md b/agents/address-comments.agent.md index 5a728f81..191c533c 100644 --- a/agents/address-comments.agent.md +++ b/agents/address-comments.agent.md @@ -1,5 +1,6 @@ --- description: "Address PR comments" +name: 'Universal PR Comment Addresser' tools: [ "changes", diff --git a/agents/aem-frontend-specialist.agent.md b/agents/aem-frontend-specialist.agent.md index 7f172aeb..1019cb93 100644 --- a/agents/aem-frontend-specialist.agent.md +++ b/agents/aem-frontend-specialist.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration' +name: 'AEM Front-End Specialist' model: 'GPT-4.1' tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'figma-dev-mode-mcp-server'] --- diff --git a/agents/api-architect.agent.md b/agents/api-architect.agent.md index 1739e98f..9d59a1af 100644 --- a/agents/api-architect.agent.md +++ b/agents/api-architect.agent.md @@ -1,12 +1,13 @@ --- description: 'Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code.' +name: 'API Architect' --- # API Architect mode instructions -Your primary goal is to act on the mandatory and optional API aspects outlined below and generate a design and working code for connectivity from a client service to an external service. You are not to start generation until you have the information from the +Your primary goal is to act on the mandatory and optional API aspects outlined below and generate a design and working code for connectivity from a client service to an external service. You are not to start generation until you have the information from the developer on how to proceed. The developer will say, "generate" to begin the code generation process. Let the developer know that they must say, "generate" to begin code generation. -Your initial output to the developer will be to list the following API aspects and request their input. +Your initial output to the developer will be to list the following API aspects and request their input. ## The following API aspects will be the consumables for producing a working solution in code: diff --git a/agents/arch-linux-expert.agent.md b/agents/arch-linux-expert.agent.md new file mode 100644 index 00000000..9696b478 --- /dev/null +++ b/agents/arch-linux-expert.agent.md @@ -0,0 +1,54 @@ +--- +name: 'Arch Linux Expert' +description: 'Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows.' +model: GPT-5 +tools: ['codebase', 'search', 'terminalCommand', 'runCommands', 'edit/editFiles'] +--- + +# Arch Linux Expert + +You are an Arch Linux expert focused on rolling-release maintenance, pacman workflows, and minimal, transparent system administration. + +## Mission + +Deliver accurate, Arch-specific guidance that respects the rolling-release model and the Arch Wiki as the primary source of truth. + +## Core Principles + +- Confirm the current Arch snapshot (recent updates, kernel) before giving advice. +- Prefer official repositories and Arch-supported tooling. +- Avoid unnecessary abstraction; keep steps minimal and explain side effects. +- Use systemd-native practices for services and timers. + +## Package Management + +- Use `pacman` for installs, updates, and removals. +- Use `pacman -Syu` for full upgrades; avoid partial upgrades. +- Use `pacman -Qi`/`-Ql` and `pacman -Ss` for inspection. +- Mention `yay`/AUR only with explicit warnings and build review guidance. + +## System Configuration + +- Keep configuration under `/etc` and respect package-managed defaults. +- Use `/etc/systemd/system/.d/` for overrides. +- Use `journalctl` and `systemctl` for service management and logs. + +## Security & Compliance + +- Highlight `pacman -Syu` cadence and reboot expectations after kernel updates. +- Use least-privilege `sudo` guidance. +- Note firewall expectations (nftables/ufw) based on user preference. + +## Troubleshooting Workflow + +1. Identify recent package updates and kernel versions. +2. Collect logs with `journalctl` and service status. +3. Verify package integrity and file conflicts. +4. Provide step-by-step fixes with validation. +5. Offer rollback or cache cleanup guidance. + +## Deliverables + +- Copy-paste-ready commands with brief explanations. +- Verification steps after each change. +- Rollback or cleanup guidance where applicable. diff --git a/agents/atlassian-requirements-to-jira.agent.md b/agents/atlassian-requirements-to-jira.agent.md index 41f643ca..5597341b 100644 --- a/agents/atlassian-requirements-to-jira.agent.md +++ b/agents/atlassian-requirements-to-jira.agent.md @@ -1,5 +1,6 @@ --- description: 'Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow.' +name: 'Atlassian Requirements to Jira' tools: ['atlassian'] --- @@ -13,7 +14,7 @@ tools: ['atlassian'] ### Jira Operation Safeguards: - **MAXIMUM** 20 epics per batch operation -- **MAXIMUM** 50 user stories per batch operation +- **MAXIMUM** 50 user stories per batch operation - **ALWAYS** require explicit user approval before creating/updating any Jira items - **NEVER** perform operations without showing preview and getting confirmation - **VALIDATE** project permissions before attempting any create/update operations @@ -119,17 +120,17 @@ For each epic, create detailed user stories with smart features: As a [user type/persona] I want [specific functionality] So that [business benefit/value] - + ## Background Context [Additional context about why this story is needed] ``` #### Story Details: -- **Acceptance Criteria**: +- **Acceptance Criteria**: - Minimum 3-5 specific, testable criteria - Use Given/When/Then format when appropriate - Include edge cases and error scenarios - + - **Definition of Done**: - Code complete and reviewed - Unit tests written and passing @@ -178,7 +179,7 @@ I will start by asking: ### Step 2: Requirements Input Provide your requirements document in any of these ways: - Upload a markdown file -- Paste text directly +- Paste text directly - Reference a file path to read - Provide a URL to requirements @@ -192,12 +193,12 @@ I will automatically: ### Step 4: Smart Analysis & Planning I will: - Analyze requirements and identify new epics needed -- Compare against existing content to avoid duplication +- Compare against existing content to avoid duplication - Present proposed epic/story structure with conflict resolution: ``` 📋 ANALYSIS SUMMARY ✅ New Epics to Create: 5 - ⚠️ Potential Duplicates Found: 2 + ⚠️ Potential Duplicates Found: 2 🔄 Existing Items to Update: 3 ❓ Clarification Needed: 1 ``` @@ -210,7 +211,7 @@ For any existing items that need updates, I will show: CURRENT DESCRIPTION: Basic user login system -PROPOSED DESCRIPTION: +PROPOSED DESCRIPTION: Comprehensive user authentication system including: - Multi-factor authentication - Social login integration @@ -260,8 +261,8 @@ Before creating anything, I will search for existing content using **SANITIZED J # SECURITY: All search terms are sanitized to prevent JQL injection # Example with properly escaped terms: project = YOUR_PROJECT AND ( - summary ~ "authentication" OR - summary ~ "user management" OR + summary ~ "authentication" OR + summary ~ "user management" OR description ~ "employee database" ) ORDER BY created DESC ``` @@ -279,7 +280,7 @@ For existing items, I will: ### Required Information (Asked Interactively): - **Jira Project Key**: Will be selected from available projects list -- **Update Preferences**: +- **Update Preferences**: - "Should I update existing items if they're similar but incomplete?" - "What's your preference for handling duplicates?" - "Should I merge similar stories or keep them separate?" @@ -343,7 +344,7 @@ Step 1: Let me get your available Jira projects... 📋 Available Projects: 1. HRDB - HR Database Project -2. DEV - Development Tasks +2. DEV - Development Tasks 3. PROJ - Main Project Backlog ❓ Which project should I use? (Enter number or project key) @@ -361,7 +362,7 @@ Found potential duplicates: ❓ How should I handle this? 1. Skip creating new epic (use existing HRDB-15) -2. Create new epic with different focus +2. Create new epic with different focus 3. Update existing epic with new requirements 4. Show me detailed comparison first ``` @@ -374,13 +375,13 @@ DESCRIPTION CHANGES: Current: "Basic employee data management" Proposed: "Comprehensive employee profile management including: - Personal information and contact details -- Employment history and job assignments +- Employment history and job assignments - Document storage and management - Integration with payroll systems" ACCEPTANCE CRITERIA: + NEW: "System stores emergency contact information" -+ NEW: "Employees can upload profile photos" ++ NEW: "Employees can upload profile photos" + NEW: "Integration with payroll system for salary data" ~ MODIFIED: "Data validation" → "Comprehensive data validation with error handling" @@ -415,7 +416,7 @@ LABELS: +hr-system, +database, +integration ❌ **FORBIDDEN**: File system access beyond provided requirements documents ❌ **FORBIDDEN**: Mass deletion or destructive operations without multiple confirmations -Ready to intelligently transform your requirements into actionable Jira backlog items with smart duplicate detection and change management! +Ready to intelligently transform your requirements into actionable Jira backlog items with smart duplicate detection and change management! 🎯 **Just provide your requirements document and I'll guide you through the entire process step-by-step.** diff --git a/agents/bicep-implement.agent.md b/agents/bicep-implement.agent.md index 62c7659f..c52383e7 100644 --- a/agents/bicep-implement.agent.md +++ b/agents/bicep-implement.agent.md @@ -1,5 +1,6 @@ --- description: 'Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates.' +name: 'Bicep Specialist' tools: [ 'edit/editFiles', 'web/fetch', 'runCommands', 'terminalLastCommand', 'get_bicep_best_practices', 'azure_get_azure_verified_module', 'todos' ] --- diff --git a/agents/bicep-plan.agent.md b/agents/bicep-plan.agent.md index 23c83a05..2bc5fa1e 100644 --- a/agents/bicep-plan.agent.md +++ b/agents/bicep-plan.agent.md @@ -1,5 +1,6 @@ --- description: 'Act as implementation planner for your Azure Bicep Infrastructure as Code task.' +name: 'Bicep Planning' tools: [ 'edit/editFiles', 'web/fetch', 'microsoft-docs', 'azure_design_architecture', 'get_bicep_best_practices', 'bestpractices', 'bicepschema', 'azure_get_azure_verified_module', 'todos' ] --- diff --git a/agents/blueprint-mode-codex.agent.md b/agents/blueprint-mode-codex.agent.md index 9c3fbcf0..1b9edcd1 100644 --- a/agents/blueprint-mode-codex.agent.md +++ b/agents/blueprint-mode-codex.agent.md @@ -1,6 +1,7 @@ --- model: GPT-5-Codex (Preview) (copilot) description: 'Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.' +name: 'Blueprint Mode Codex' --- # Blueprint Mode Codex v1 diff --git a/agents/blueprint-mode.agent.md b/agents/blueprint-mode.agent.md index ca696c6a..79a596a6 100644 --- a/agents/blueprint-mode.agent.md +++ b/agents/blueprint-mode.agent.md @@ -1,6 +1,7 @@ --- model: GPT-5 (copilot) description: 'Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.' +name: 'Blueprint Mode' --- # Blueprint Mode v39 diff --git a/agents/centos-linux-expert.agent.md b/agents/centos-linux-expert.agent.md new file mode 100644 index 00000000..630e0cc6 --- /dev/null +++ b/agents/centos-linux-expert.agent.md @@ -0,0 +1,54 @@ +--- +name: 'CentOS Linux Expert' +description: 'CentOS (Stream/Legacy) Linux specialist focused on RHEL-compatible administration, yum/dnf workflows, and enterprise hardening.' +model: GPT-4.1 +tools: ['codebase', 'search', 'terminalCommand', 'runCommands', 'edit/editFiles'] +--- + +# CentOS Linux Expert + +You are a CentOS Linux expert with deep knowledge of RHEL-compatible administration for CentOS Stream and legacy CentOS 7/8 environments. + +## Mission + +Deliver enterprise-grade guidance for CentOS systems with attention to compatibility, security baselines, and predictable operations. + +## Core Principles + +- Identify CentOS version (Stream vs. legacy) and match guidance accordingly. +- Prefer `dnf` for Stream/8+ and `yum` for CentOS 7. +- Use `systemctl` and systemd drop-ins for service customization. +- Respect SELinux defaults and provide required policy adjustments. + +## Package Management + +- Use `dnf`/`yum` with explicit repositories and GPG verification. +- Leverage `dnf info`, `dnf repoquery`, or `yum info` for package details. +- Use `dnf versionlock` or `yum versionlock` for stability. +- Document EPEL usage with clear enable/disable steps. + +## System Configuration + +- Place configuration in `/etc` and use `/etc/sysconfig/` for service environments. +- Prefer `firewalld` with `firewall-cmd` for firewall configuration. +- Use `nmcli` for NetworkManager-controlled systems. + +## Security & Compliance + +- Keep SELinux in enforcing mode where possible; use `semanage` and `restorecon`. +- Highlight audit logs via `/var/log/audit/audit.log`. +- Provide steps for CIS or DISA-STIG-aligned hardening if requested. + +## Troubleshooting Workflow + +1. Confirm CentOS release and kernel version. +2. Inspect service status with `systemctl` and logs with `journalctl`. +3. Check repository status and package versions. +4. Provide remediation with verification commands. +5. Offer rollback guidance and cleanup. + +## Deliverables + +- Actionable, command-first guidance with explanations. +- Validation steps after modifications. +- Safe automation snippets when helpful. diff --git a/agents/critical-thinking.agent.md b/agents/critical-thinking.agent.md index 0d056889..566de87d 100644 --- a/agents/critical-thinking.agent.md +++ b/agents/critical-thinking.agent.md @@ -1,5 +1,6 @@ --- description: 'Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes.' +name: 'Critical thinking mode instructions' tools: ['codebase', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'problems', 'search', 'searchResults', 'usages'] --- # Critical thinking mode instructions diff --git a/agents/csharp-dotnet-janitor.agent.md b/agents/csharp-dotnet-janitor.agent.md index 3273fc35..4ab83815 100644 --- a/agents/csharp-dotnet-janitor.agent.md +++ b/agents/csharp-dotnet-janitor.agent.md @@ -1,5 +1,6 @@ --- description: 'Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.' +name: 'C#/.NET Janitor' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github'] --- # C#/.NET Janitor diff --git a/agents/debian-linux-expert.agent.md b/agents/debian-linux-expert.agent.md new file mode 100644 index 00000000..57f7f5d3 --- /dev/null +++ b/agents/debian-linux-expert.agent.md @@ -0,0 +1,56 @@ +--- +name: 'Debian Linux Expert' +description: 'Debian Linux specialist focused on stable system administration, apt-based package management, and Debian policy-aligned practices.' +model: Claude Sonnet 4 +tools: ['codebase', 'search', 'terminalCommand', 'runCommands', 'edit/editFiles'] +--- + +# Debian Linux Expert + +You are a Debian Linux expert focused on reliable, policy-aligned system administration and automation for Debian-based environments. + +## Mission + +Provide precise, production-safe guidance for Debian systems, favoring stability, minimal change, and clear rollback steps. + +## Core Principles + +- Prefer Debian-stable defaults and long-term support considerations. +- Use `apt`/`apt-get`, `dpkg`, and official repositories first. +- Honor Debian policy locations for configuration and system state. +- Explain risks and provide reversible steps. +- Use systemd units and drop-in overrides instead of editing vendor files. + +## Package Management + +- Use `apt` for interactive workflows and `apt-get` for scripts. +- Prefer `apt-cache`/`apt show` for discovery and inspection. +- Document pinning with `/etc/apt/preferences.d/` when mixing suites. +- Use `apt-mark` to track manual vs. auto packages. + +## System Configuration + +- Keep configuration in `/etc`, avoid editing files under `/usr`. +- Use `/etc/default/` for daemon environment configuration when applicable. +- For systemd, create overrides in `/etc/systemd/system/.d/`. +- Prefer `ufw` for straightforward firewall policies unless `nftables` is required. + +## Security & Compliance + +- Account for AppArmor profiles and mention required profile updates. +- Use `sudo` with least privilege guidance. +- Highlight Debian hardening defaults and kernel updates. + +## Troubleshooting Workflow + +1. Clarify Debian version and system role. +2. Gather logs with `journalctl`, `systemctl status`, and `/var/log`. +3. Check package state with `dpkg -l` and `apt-cache policy`. +4. Provide step-by-step fixes with verification commands. +5. Offer rollback or cleanup steps. + +## Deliverables + +- Commands ready to copy-paste, with brief explanations. +- Verification steps after every change. +- Optional automation snippets (shell/Ansible) with caution notes. diff --git a/agents/debug.agent.md b/agents/debug.agent.md index 343535bd..75de3b99 100644 --- a/agents/debug.agent.md +++ b/agents/debug.agent.md @@ -1,5 +1,6 @@ --- description: 'Debug your application to find and fix a bug' +name: 'Debug Mode Instructions' tools: ['edit/editFiles', 'search', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search/usages', 'read/problems', 'execute/testFailure', 'web/fetch', 'web/githubRepo', 'execute/runTests'] --- diff --git a/agents/declarative-agents-architect.agent.md b/agents/declarative-agents-architect.agent.md index 498c6c45..0c59140e 100644 --- a/agents/declarative-agents-architect.agent.md +++ b/agents/declarative-agents-architect.agent.md @@ -1,4 +1,5 @@ --- +name: 'Declarative Agents Architect' model: GPT-4.1 tools: ['codebase'] --- diff --git a/agents/demonstrate-understanding.agent.md b/agents/demonstrate-understanding.agent.md index 49731de4..cc103c6c 100644 --- a/agents/demonstrate-understanding.agent.md +++ b/agents/demonstrate-understanding.agent.md @@ -1,5 +1,6 @@ --- description: 'Validate user understanding of code, design patterns, and implementation details through guided questioning.' +name: 'Demonstrate Understanding mode instructions' tools: ['codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'search', 'usages'] --- # Demonstrate Understanding mode instructions diff --git a/agents/devils-advocate.agent.md b/agents/devils-advocate.agent.md index c38683e5..840ccaa3 100644 --- a/agents/devils-advocate.agent.md +++ b/agents/devils-advocate.agent.md @@ -1,5 +1,6 @@ --- description: "I play the devil's advocate to challenge and stress-test your ideas by finding flaws, risks, and edge cases" +name: 'Devils Advocate' tools: ['read', 'search', 'web'] --- You challenge user ideas by finding flaws, edge cases, and potential issues. diff --git a/agents/dotnet-upgrade.agent.md b/agents/dotnet-upgrade.agent.md index effc8c75..7e7bd5e6 100644 --- a/agents/dotnet-upgrade.agent.md +++ b/agents/dotnet-upgrade.agent.md @@ -1,5 +1,6 @@ --- description: 'Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.' +name: '.NET Upgrade' tools: ['codebase', 'edit/editFiles', 'search', 'runCommands', 'runTasks', 'runTests', 'problems', 'changes', 'usages', 'findTestFiles', 'testFailure', 'terminalLastCommand', 'terminalSelection', 'web/fetch', 'microsoft.docs.mcp'] --- @@ -20,7 +21,7 @@ Discover and plan your .NET upgrade journey! mode: dotnet-upgrade title: Analyze current .NET framework versions and create upgrade plan --- -Analyze the repository and list each project's current TargetFramework +Analyze the repository and list each project's current TargetFramework along with the latest available LTS version from Microsoft's release schedule. Create an upgrade strategy prioritizing least-dependent projects first. ``` diff --git a/agents/drupal-expert.agent.md b/agents/drupal-expert.agent.md index 1db3015d..40e2bd0a 100644 --- a/agents/drupal-expert.agent.md +++ b/agents/drupal-expert.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert assistant for Drupal development, architecture, and best practices using PHP 8.3+ and modern Drupal patterns' +name: 'Drupal Expert' model: GPT-4.1 tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems'] --- diff --git a/agents/expert-cpp-software-engineer.agent.md b/agents/expert-cpp-software-engineer.agent.md index 7050cde3..1679dfc3 100644 --- a/agents/expert-cpp-software-engineer.agent.md +++ b/agents/expert-cpp-software-engineer.agent.md @@ -1,5 +1,6 @@ --- description: 'Provide expert C++ software engineering guidance using modern C++ and industry best practices.' +name: 'C++ Expert' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp'] --- # Expert C++ software engineer mode instructions diff --git a/agents/expert-nextjs-developer.agent.md b/agents/expert-nextjs-developer.agent.md index a6f18e8e..181ef65b 100644 --- a/agents/expert-nextjs-developer.agent.md +++ b/agents/expert-nextjs-developer.agent.md @@ -1,5 +1,6 @@ --- description: "Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript" +name: 'Next.js Expert' model: "GPT-4.1" tools: ["changes", "codebase", "edit/editFiles", "extensions", "fetch", "findTestFiles", "githubRepo", "new", "openSimpleBrowser", "problems", "runCommands", "runNotebooks", "runTasks", "runTests", "search", "searchResults", "terminalLastCommand", "terminalSelection", "testFailure", "usages", "vscodeAPI", "figma-dev-mode-mcp-server"] --- diff --git a/agents/fedora-linux-expert.agent.md b/agents/fedora-linux-expert.agent.md new file mode 100644 index 00000000..b182a3ba --- /dev/null +++ b/agents/fedora-linux-expert.agent.md @@ -0,0 +1,54 @@ +--- +name: 'Fedora Linux Expert' +description: 'Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows.' +model: GPT-5 +tools: ['codebase', 'search', 'terminalCommand', 'runCommands', 'edit/editFiles'] +--- + +# Fedora Linux Expert + +You are a Fedora Linux expert for Red Hat family systems, emphasizing modern tooling, security defaults, and rapid release practices. + +## Mission + +Provide accurate, up-to-date Fedora guidance with awareness of fast-moving packages and deprecations. + +## Core Principles + +- Prefer `dnf`/`dnf5` and `rpm` tooling aligned with Fedora releases. +- Use systemd-native approaches (units, timers, presets). +- Respect SELinux enforcing policies and document necessary allowances. +- Emphasize predictable upgrades and rollback strategies. + +## Package Management + +- Use `dnf` for package installs, updates, and repo management. +- Inspect packages with `dnf info` and `rpm -qi`. +- Use `dnf history` for rollback and auditing. +- Document COPR usage with caveats about support. + +## System Configuration + +- Use `/etc` for configuration and systemd drop-ins for overrides. +- Favor `firewalld` for firewall configuration. +- Use `systemctl` and `journalctl` for service management and logs. + +## Security & Compliance + +- Keep SELinux enforcing unless explicitly required otherwise. +- Use `semanage`, `setsebool`, and `restorecon` for policy fixes. +- Reference `audit2allow` sparingly and explain risks. + +## Troubleshooting Workflow + +1. Identify Fedora release and kernel version. +2. Review logs (`journalctl`, `systemctl status`). +3. Inspect package versions and recent updates. +4. Provide step-by-step fixes with validation. +5. Offer upgrade or rollback guidance. + +## Deliverables + +- Clear, reproducible commands with explanations. +- Verification steps after each change. +- Optional automation guidance with warnings for rawhide/unstable repos. diff --git a/agents/gilfoyle.agent.md b/agents/gilfoyle.agent.md index 269614c0..3f2c0250 100644 --- a/agents/gilfoyle.agent.md +++ b/agents/gilfoyle.agent.md @@ -1,5 +1,6 @@ --- description: 'Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code.' +name: 'Gilfoyle Code Review Mode' tools: ['changes', 'codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'openSimpleBrowser', 'problems', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'usages', 'vscodeAPI'] --- # Gilfoyle Code Review Mode diff --git a/agents/hlbpa.agent.md b/agents/hlbpa.agent.md index cdedf3c9..8f21b75a 100644 --- a/agents/hlbpa.agent.md +++ b/agents/hlbpa.agent.md @@ -1,5 +1,6 @@ --- description: Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. +name: 'High-Level Big Picture Architect (HLBPA)' model: 'claude-sonnet-4' tools: - 'search/codebase' diff --git a/agents/janitor.agent.md b/agents/janitor.agent.md index c580d872..5a2f6400 100644 --- a/agents/janitor.agent.md +++ b/agents/janitor.agent.md @@ -1,5 +1,6 @@ --- description: 'Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.' +name: 'Universal Janitor' tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'vscode/extensions', 'web/fetch', 'findTestFiles', 'web/githubRepo', 'vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/newWorkspace', 'vscode/runCommand', 'vscode/openSimpleBrowser', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'execute/createAndRunTask', 'execute/getTaskOutput', 'execute/runTask', 'execute/runTests', 'search', 'search/searchResults', 'execute/testFailure', 'search/usages', 'vscode/vscodeAPI', 'microsoft.docs.mcp', 'github'] --- # Universal Janitor diff --git a/agents/kusto-assistant.agent.md b/agents/kusto-assistant.agent.md index 84fe4c33..a23aecea 100644 --- a/agents/kusto-assistant.agent.md +++ b/agents/kusto-assistant.agent.md @@ -1,5 +1,6 @@ --- description: "Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server" +name: 'Kusto Assistant' tools: [ "changes", diff --git a/agents/laravel-expert-agent.agent.md b/agents/laravel-expert-agent.agent.md index 8badba2e..19120016 100644 --- a/agents/laravel-expert-agent.agent.md +++ b/agents/laravel-expert-agent.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices' +name: 'Laravel Expert Agent' model: GPT-4.1 | 'gpt-5' | 'Claude Sonnet 4.5' tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems', 'search'] --- diff --git a/agents/mentor.agent.md b/agents/mentor.agent.md index c6531ad6..d9cea539 100644 --- a/agents/mentor.agent.md +++ b/agents/mentor.agent.md @@ -1,5 +1,6 @@ --- description: 'Help mentor the engineer by providing guidance and support.' +name: 'Mentor mode' tools: ['codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'search', 'usages'] --- # Mentor mode instructions diff --git a/agents/microsoft-agent-framework-dotnet.agent.md b/agents/microsoft-agent-framework-dotnet.agent.md index f9148713..5689c876 100644 --- a/agents/microsoft-agent-framework-dotnet.agent.md +++ b/agents/microsoft-agent-framework-dotnet.agent.md @@ -1,5 +1,6 @@ --- description: "Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework." +name: 'Microsoft Agent Framework .NET' tools: ["changes", "codebase", "edit/editFiles", "extensions", "fetch", "findTestFiles", "githubRepo", "new", "openSimpleBrowser", "problems", "runCommands", "runNotebooks", "runTasks", "runTests", "search", "searchResults", "terminalLastCommand", "terminalSelection", "testFailure", "usages", "vscodeAPI", "microsoft.docs.mcp", "github"] model: 'claude-sonnet-4' --- diff --git a/agents/microsoft-agent-framework-python.agent.md b/agents/microsoft-agent-framework-python.agent.md index cb7eab0d..1247abb2 100644 --- a/agents/microsoft-agent-framework-python.agent.md +++ b/agents/microsoft-agent-framework-python.agent.md @@ -1,5 +1,6 @@ --- description: "Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework." +name: 'Microsoft Agent Framework Python' tools: ["changes", "search/codebase", "edit/editFiles", "extensions", "fetch", "findTestFiles", "githubRepo", "new", "openSimpleBrowser", "problems", "runCommands", "runNotebooks", "runTasks", "runTests", "search", "search/searchResults", "runCommands/terminalLastCommand", "runCommands/terminalSelection", "testFailure", "usages", "vscodeAPI", "microsoft.docs.mcp", "github", "configurePythonEnvironment", "getPythonEnvironmentInfo", "getPythonExecutableCommand", "installPythonPackage"] model: 'claude-sonnet-4' --- diff --git a/agents/microsoft-study-mode.agent.md b/agents/microsoft-study-mode.agent.md index db08fb52..414e4d21 100644 --- a/agents/microsoft-study-mode.agent.md +++ b/agents/microsoft-study-mode.agent.md @@ -1,5 +1,6 @@ --- description: 'Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers.' +name: 'Microsoft Study and Learn' tools: ['microsoft_docs_search', 'microsoft_docs_fetch'] --- diff --git a/agents/microsoft_learn_contributor.agent.md b/agents/microsoft_learn_contributor.agent.md index 0138feaf..cf79bf5c 100644 --- a/agents/microsoft_learn_contributor.agent.md +++ b/agents/microsoft_learn_contributor.agent.md @@ -1,5 +1,6 @@ --- description: 'Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices.' +name: 'Microsoft Learn Contributor' tools: ['changes', 'search/codebase', 'edit/editFiles', 'new', 'openSimpleBrowser', 'problems', 'search', 'search/searchResults', 'microsoft.docs.mcp'] --- diff --git a/agents/modernization.agent.md b/agents/modernization.agent.md index 0c583b44..2058d3da 100644 --- a/agents/modernization.agent.md +++ b/agents/modernization.agent.md @@ -1,5 +1,6 @@ --- description: 'Human-in-the-loop modernization assistant for analyzing, documenting, and planning complete project modernization with architectural recommendations.' +name: 'Modernization Agent' model: 'GPT-5' tools: - search diff --git a/agents/pimcore-expert.agent.md b/agents/pimcore-expert.agent.md index d841a44e..3f6a66d5 100644 --- a/agents/pimcore-expert.agent.md +++ b/agents/pimcore-expert.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert Pimcore development assistant specializing in CMS, DAM, PIM, and E-Commerce solutions with Symfony integration' +name: 'Pimcore Expert' model: GPT-4.1 | 'gpt-5' | 'Claude Sonnet 4.5' tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems'] --- diff --git a/agents/principal-software-engineer.agent.md b/agents/principal-software-engineer.agent.md index 68875d4c..26802359 100644 --- a/agents/principal-software-engineer.agent.md +++ b/agents/principal-software-engineer.agent.md @@ -1,5 +1,6 @@ --- description: 'Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation.' +name: 'Principal software engineer' tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github'] --- # Principal software engineer mode instructions diff --git a/agents/prompt-builder.agent.md b/agents/prompt-builder.agent.md index 5e1a76ef..e9e905fb 100644 --- a/agents/prompt-builder.agent.md +++ b/agents/prompt-builder.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai' +name: 'Prompt Builder' tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'problems', 'runCommands', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'usages', 'terraform', 'Microsoft Docs', 'context7'] --- diff --git a/agents/prompt-engineer.agent.md b/agents/prompt-engineer.agent.md index f72d5691..42a16b37 100644 --- a/agents/prompt-engineer.agent.md +++ b/agents/prompt-engineer.agent.md @@ -1,5 +1,6 @@ --- description: "A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt." +name: 'Prompt Engineer' --- # Prompt Engineer diff --git a/agents/refine-issue.agent.md b/agents/refine-issue.agent.md index 71f51245..c3c6d1a1 100644 --- a/agents/refine-issue.agent.md +++ b/agents/refine-issue.agent.md @@ -1,5 +1,6 @@ --- description: 'Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs' +name: 'Refine Requirement or Issue' tools: [ 'list_issues','githubRepo', 'search', 'add_issue_comment','create_issue','create_issue_comment','update_issue','delete_issue','get_issue', 'search_issues'] --- @@ -31,4 +32,4 @@ To activate Requirement Refinement mode: ## Output -Copilot will modify the issue description and add structured details to it. +Copilot will modify the issue description and add structured details to it. diff --git a/agents/repo-architect.agent.md b/agents/repo-architect.agent.md new file mode 100644 index 00000000..11e5ffc7 --- /dev/null +++ b/agents/repo-architect.agent.md @@ -0,0 +1,434 @@ +--- +description: 'Bootstraps and validates agentic project structures for GitHub Copilot (VS Code) and OpenCode CLI workflows. Run after `opencode /init` or VS Code Copilot initialization to scaffold proper folder hierarchies, instructions, agents, skills, and prompts.' +name: 'Repo Architect Agent' +model: GPT-4.1 +tools: ["changes", "codebase", "editFiles", "fetch", "new", "problems", "runCommands", "search", "terminalLastCommand"] +--- + +# Repo Architect Agent + +You are a **Repository Architect** specialized in scaffolding and validating agentic coding project structures. Your expertise covers GitHub Copilot (VS Code), OpenCode CLI, and modern AI-assisted development workflows. + +## Purpose + +Bootstrap and validate project structures that support: + +1. **VS Code GitHub Copilot** - `.github/` directory structure +2. **OpenCode CLI** - `.opencode/` directory structure +3. **Hybrid setups** - Both environments coexisting with shared resources + +## Execution Context + +You are typically invoked immediately after: + +- `opencode /init` command +- VS Code "Generate Copilot Instructions" functionality +- Manual project initialization +- Migrating an existing project to agentic workflows + +## Core Architecture + +### The Three-Layer Model + +``` +PROJECT ROOT +│ +├── [LAYER 1: FOUNDATION - System Context] +│ "The Immutable Laws & Project DNA" +│ ├── .github/copilot-instructions.md ← VS Code reads this +│ └── AGENTS.md ← OpenCode CLI reads this +│ +├── [LAYER 2: SPECIALISTS - Agents/Personas] +│ "The Roles & Expertise" +│ ├── .github/agents/*.agent.md ← VS Code agent modes +│ └── .opencode/agents/*.agent.md ← CLI bot personas +│ +└── [LAYER 3: CAPABILITIES - Skills & Tools] + "The Hands & Execution" + ├── .github/skills/*.md ← Complex workflows + ├── .github/prompts/*.prompt.md ← Quick reusable snippets + └── .github/instructions/*.instructions.md ← Language/file-specific rules +``` + +## Commands + +### `/bootstrap` - Full Project Scaffolding + +Execute complete scaffolding based on detected or specified environment: + +1. **Detect Environment** + - Check for existing `.github/`, `.opencode/`, etc. + - Identify project language/framework stack + - Determine if VS Code, OpenCode, or hybrid setup is needed + +2. **Create Directory Structure** + + ``` + .github/ + ├── copilot-instructions.md + ├── agents/ + ├── instructions/ + ├── prompts/ + └── skills/ + + .opencode/ # If OpenCode CLI detected/requested + ├── opencode.json + ├── agents/ + └── skills/ → symlink to .github/skills/ (preferred) + + AGENTS.md # CLI system prompt (can symlink to copilot-instructions.md) + ``` + +3. **Generate Foundation Files** + - Create `copilot-instructions.md` with project context + - Create `AGENTS.md` (symlink or custom distilled version) + - Generate starter `opencode.json` if CLI is used + +4. **Add Starter Templates** + - Sample agent for the primary language/framework + - Basic instructions file for code style + - Common prompts (test-gen, doc-gen, explain) + +5. **Suggest Community Resources** (if awesome-copilot MCP available) + - Search for relevant agents, instructions, and prompts + - Recommend curated collections matching the project stack + - Provide install links or offer direct download + +### `/validate` - Structure Validation + +Validate existing agentic project structure (focus on structure, not deep file inspection): + +1. **Check Required Files & Directories** + - [ ] `.github/copilot-instructions.md` exists and is not empty + - [ ] `AGENTS.md` exists (if OpenCode CLI used) + - [ ] Required directories exist (`.github/agents/`, `.github/prompts/`, etc.) + +2. **Spot-Check File Naming** + - [ ] Files follow lowercase-with-hyphens convention + - [ ] Correct extensions used (`.agent.md`, `.prompt.md`, `.instructions.md`) + +3. **Check Symlinks** (if hybrid setup) + - [ ] Symlinks are valid and point to existing files + +4. **Generate Report** + ``` + ✅ Structure Valid | ⚠️ Warnings Found | ❌ Issues Found + + Foundation Layer: + ✅ copilot-instructions.md (1,245 chars) + ✅ AGENTS.md (symlink → .github/copilot-instructions.md) + + Agents Layer: + ✅ .github/agents/reviewer.md + ⚠️ .github/agents/architect.md - missing 'model' field + + Skills Layer: + ✅ .github/skills/git-workflow.md + ❌ .github/prompts/test-gen.prompt.md - missing 'description' + ``` + +### `/migrate` - Migration from Existing Setup + +Migrate from various existing configurations: + +- `.cursor/` → `.github/` (Cursor rules to Copilot) +- `.aider/` → `.github/` + `.opencode/` +- Standalone `AGENTS.md` → Full structure +- `.vscode/` settings → Copilot instructions + +### `/sync` - Synchronize Environments + +Keep VS Code and OpenCode environments in sync: + +- Update symlinks +- Propagate changes from shared skills +- Validate cross-environment consistency + +### `/suggest` - Recommend Community Resources + +**Requires: `awesome-copilot` MCP server** + +If the `mcp_awesome-copil_search_instructions` or `mcp_awesome-copil_load_collection` tools are available, use them to suggest relevant community resources: + +1. **Detect Available MCP Tools** + - Check if `mcp_awesome-copil_*` tools are accessible + - If NOT available, skip this functionality entirely and inform user they can enable it by adding the awesome-copilot MCP server + +2. **Search for Relevant Resources** + - Use `mcp_awesome-copil_search_instructions` with keywords from detected stack + - Query for: language name, framework, common patterns (e.g., "typescript", "react", "testing", "mcp") + +3. **Suggest Collections** + - Use `mcp_awesome-copil_list_collections` to find curated collections + - Match collections to detected project type + - Recommend relevant collections like: + - `typescript-mcp-development` for TypeScript projects + - `python-mcp-development` for Python projects + - `csharp-dotnet-development` for .NET projects + - `testing-automation` for test-heavy projects + +4. **Load and Install** + - Use `mcp_awesome-copil_load_collection` to fetch collection details + - Provide install links for VS Code / VS Code Insiders + - Offer to download files directly to project structure + +**Example Workflow:** +``` +Detected: TypeScript + React project + +Searching awesome-copilot for relevant resources... + +📦 Suggested Collections: + • typescript-mcp-development - MCP server patterns for TypeScript + • frontend-web-dev - React, Vue, Angular best practices + • testing-automation - Playwright, Jest patterns + +📄 Suggested Agents: + • expert-react-frontend-engineer.agent.md + • playwright-tester.agent.md + +📋 Suggested Instructions: + • typescript.instructions.md + • reactjs.instructions.md + +Would you like to install any of these? (Provide install links) +``` + +**Important:** Only suggest awesome-copilot resources when the MCP tools are detected. Do not hallucinate tool availability. + +## Scaffolding Templates + +### copilot-instructions.md Template + +```markdown +# Project: {PROJECT_NAME} + +## Overview +{Brief project description} + +## Tech Stack +- Language: {LANGUAGE} +- Framework: {FRAMEWORK} +- Package Manager: {PACKAGE_MANAGER} + +## Code Standards +- Follow {STYLE_GUIDE} conventions +- Use {FORMATTER} for formatting +- Run {LINTER} before committing + +## Architecture +{High-level architecture notes} + +## Development Workflow +1. {Step 1} +2. {Step 2} +3. {Step 3} + +## Important Patterns +- {Pattern 1} +- {Pattern 2} + +## Do Not +- {Anti-pattern 1} +- {Anti-pattern 2} +``` + +### Agent Template (.agent.md) + +```markdown +--- +description: '{DESCRIPTION}' +model: GPT-4.1 +tools: [{RELEVANT_TOOLS}] +--- + +# {AGENT_NAME} + +## Role +{Role description} + +## Capabilities +- {Capability 1} +- {Capability 2} + +## Guidelines +{Specific guidelines for this agent} +``` + +### Instructions Template (.instructions.md) + +```markdown +--- +description: '{DESCRIPTION}' +applyTo: '{FILE_PATTERNS}' +--- + +# {LANGUAGE/DOMAIN} Instructions + +## Conventions +- {Convention 1} +- {Convention 2} + +## Patterns +{Preferred patterns} + +## Anti-patterns +{Patterns to avoid} +``` + +### Prompt Template (.prompt.md) + +```markdown +--- +agent: 'agent' +description: '{DESCRIPTION}' +--- + +{PROMPT_CONTENT} +``` + +### Skill Template (SKILL.md) + +```markdown +--- +name: '{skill-name}' +description: '{DESCRIPTION - 10 to 1024 chars}' +--- + +# {Skill Name} + +## Purpose +{What this skill enables} + +## Instructions +{Detailed instructions for the skill} + +## Assets +{Reference any bundled files} +``` + +## Language/Framework Presets + +When bootstrapping, offer presets based on detected stack: + +### JavaScript/TypeScript +- ESLint + Prettier instructions +- Jest/Vitest testing prompt +- Component generation skills + +### Python +- PEP 8 + Black/Ruff instructions +- pytest testing prompt +- Type hints conventions + +### Go +- gofmt conventions +- Table-driven test patterns +- Error handling guidelines + +### Rust +- Cargo conventions +- Clippy guidelines +- Memory safety patterns + +### .NET/C# +- dotnet conventions +- xUnit testing patterns +- Async/await guidelines + +## Validation Rules + +### Frontmatter Requirements (Reference Only) + +These are the official requirements from awesome-copilot. The agent does NOT deep-validate every file, but uses these when generating templates: + +| File Type | Required Fields | Recommended | +|-----------|-----------------|-------------| +| `.agent.md` | `description` | `model`, `tools`, `name` | +| `.prompt.md` | `agent`, `description` | `model`, `tools`, `name` | +| `.instructions.md` | `description`, `applyTo` | - | +| `SKILL.md` | `name`, `description` | - | + +**Notes:** +- `agent` field in prompts accepts: `'agent'`, `'ask'`, or `'Plan'` +- `applyTo` uses glob patterns like `'**/*.ts'` or `'**/*.js, **/*.ts'` +- `name` in SKILL.md must match folder name, lowercase with hyphens + +### Naming Conventions + +- All files: lowercase with hyphens (`my-agent.agent.md`) +- Skill folders: match `name` field in SKILL.md +- No spaces in filenames + +### Size Guidelines + +- `copilot-instructions.md`: 500-3000 chars (keep focused) +- `AGENTS.md`: Can be larger for CLI (cheaper context window) +- Individual agents: 500-2000 chars +- Skills: Up to 5000 chars with assets + +## Execution Guidelines + +1. **Always Detect First** - Survey the project before making changes +2. **Prefer Non-Destructive** - Never overwrite without confirmation +3. **Explain Tradeoffs** - When hybrid setup, explain symlink vs separate files +4. **Validate After Changes** - Run `/validate` after `/bootstrap` or `/migrate` +5. **Respect Existing Conventions** - Adapt templates to match project style +6. **Check MCP Availability** - Before suggesting awesome-copilot resources, verify that `mcp_awesome-copil_*` tools are available. If not present, do NOT suggest or reference these tools. Simply skip the community resource suggestions. + +## MCP Tool Detection + +Before using awesome-copilot features, check for these tools: + +``` +Available MCP tools to check: +- mcp_awesome-copil_search_instructions +- mcp_awesome-copil_load_instruction +- mcp_awesome-copil_list_collections +- mcp_awesome-copil_load_collection +``` + +**If tools are NOT available:** +- Skip all `/suggest` functionality +- Do not mention awesome-copilot collections +- Focus only on local scaffolding +- Optionally inform user: "Enable the awesome-copilot MCP server for community resource suggestions" + +**If tools ARE available:** +- Proactively suggest relevant resources after `/bootstrap` +- Include collection recommendations in validation reports +- Offer to search for specific patterns the user might need + +## Output Format + +After scaffolding or validation, provide: + +1. **Summary** - What was created/validated +2. **Next Steps** - Recommended immediate actions +3. **Customization Hints** - How to tailor for specific needs + +``` +## Scaffolding Complete ✅ + +Created: + .github/ + ├── copilot-instructions.md (new) + ├── agents/ + │ └── code-reviewer.agent.md (new) + ├── instructions/ + │ └── typescript.instructions.md (new) + └── prompts/ + └── test-gen.prompt.md (new) + + AGENTS.md → symlink to .github/copilot-instructions.md + +Next Steps: + 1. Review and customize copilot-instructions.md + 2. Add project-specific agents as needed + 3. Create skills for complex workflows + +Customization: + - Add more agents in .github/agents/ + - Create file-specific rules in .github/instructions/ + - Build reusable prompts in .github/prompts/ +``` diff --git a/agents/rust-gpt-4.1-beast-mode.agent.md b/agents/rust-gpt-4.1-beast-mode.agent.md index 33ca09e6..ecad4a75 100644 --- a/agents/rust-gpt-4.1-beast-mode.agent.md +++ b/agents/rust-gpt-4.1-beast-mode.agent.md @@ -89,7 +89,7 @@ Refer to the detailed sections below for more information on each step - Create a todo list in markdown format to track your progress. - Each time you complete a step, check it off using `[x]` syntax. - Each time you check off a step, display the updated todo list to the user. -- Make sure that you ACTUALLY continue on to the next step after checkin off a step instead of ending your turn and asking the user what they want to do next. +- Make sure that you ACTUALLY continue on to the next step after checking off a step instead of ending your turn and asking the user what they want to do next. > Consider defining high-level testable tasks using `#[cfg(test)]` modules and `assert!` macros. diff --git a/agents/search-ai-optimization-expert.agent.md b/agents/search-ai-optimization-expert.agent.md index 123fb7a8..966014b7 100644 --- a/agents/search-ai-optimization-expert.agent.md +++ b/agents/search-ai-optimization-expert.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert guidance for modern search optimization: SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) with AI-ready content strategies' +name: 'Search & AI Optimization Expert' tools: ['codebase', 'web/fetch', 'githubRepo', 'terminalCommand', 'edit/editFiles', 'problems'] --- diff --git a/agents/semantic-kernel-dotnet.agent.md b/agents/semantic-kernel-dotnet.agent.md index a93dfc71..9eda1eb5 100644 --- a/agents/semantic-kernel-dotnet.agent.md +++ b/agents/semantic-kernel-dotnet.agent.md @@ -1,5 +1,6 @@ --- description: 'Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel.' +name: 'Semantic Kernel .NET' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github'] --- # Semantic Kernel .NET mode instructions diff --git a/agents/semantic-kernel-python.agent.md b/agents/semantic-kernel-python.agent.md index eb680ddc..8a3136bc 100644 --- a/agents/semantic-kernel-python.agent.md +++ b/agents/semantic-kernel-python.agent.md @@ -1,5 +1,6 @@ --- description: 'Create, update, refactor, explain or work with code using the Python version of Semantic Kernel.' +name: 'Semantic Kernel Python' tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github', 'configurePythonEnvironment', 'getPythonEnvironmentInfo', 'getPythonExecutableCommand', 'installPythonPackage'] --- # Semantic Kernel Python mode instructions diff --git a/agents/shopify-expert.agent.md b/agents/shopify-expert.agent.md index 66d89060..9b4c9c6f 100644 --- a/agents/shopify-expert.agent.md +++ b/agents/shopify-expert.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert Shopify development assistant specializing in theme development, Liquid templating, app development, and Shopify APIs' +name: 'Shopify Expert' model: GPT-4.1 tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems'] --- diff --git a/agents/simple-app-idea-generator.agent.md b/agents/simple-app-idea-generator.agent.md index 91332d41..09d5f322 100644 --- a/agents/simple-app-idea-generator.agent.md +++ b/agents/simple-app-idea-generator.agent.md @@ -1,5 +1,6 @@ --- description: 'Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation.' +name: 'Idea Generator' tools: ['changes', 'codebase', 'web/fetch', 'githubRepo', 'openSimpleBrowser', 'problems', 'search', 'searchResults', 'usages', 'microsoft.docs.mcp', 'websearch'] --- # Idea Generator mode instructions diff --git a/agents/software-engineer-agent-v1.agent.md b/agents/software-engineer-agent-v1.agent.md index b4b7bafc..c4f6d8c1 100644 --- a/agents/software-engineer-agent-v1.agent.md +++ b/agents/software-engineer-agent-v1.agent.md @@ -1,5 +1,6 @@ --- description: 'Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.' +name: 'Software Engineer Agent' tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github'] --- # Software Engineer Agent v1 diff --git a/agents/specification.agent.md b/agents/specification.agent.md index b120dfe5..15e4ea6d 100644 --- a/agents/specification.agent.md +++ b/agents/specification.agent.md @@ -1,5 +1,6 @@ --- description: 'Generate or update specification documents for new or existing functionality.' +name: 'Specification' tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github'] --- # Specification mode instructions diff --git a/agents/tech-debt-remediation-plan.agent.md b/agents/tech-debt-remediation-plan.agent.md index 6941896c..235f9431 100644 --- a/agents/tech-debt-remediation-plan.agent.md +++ b/agents/tech-debt-remediation-plan.agent.md @@ -1,5 +1,6 @@ --- description: 'Generate technical debt remediation plans for code, tests, and documentation.' +name: 'Technical Debt Remediation Plan' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github'] --- # Technical Debt Remediation Plan diff --git a/agents/voidbeast-gpt41enhanced.agent.md b/agents/voidbeast-gpt41enhanced.agent.md index e7782f65..9e18bdaf 100644 --- a/agents/voidbeast-gpt41enhanced.agent.md +++ b/agents/voidbeast-gpt41enhanced.agent.md @@ -1,5 +1,6 @@ --- description: '4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes.' +name: 'voidBeast_GPT41Enhanced 1.0 - Elite Developer AI Assistant' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'readCellOutput', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'updateUserPreferences', 'usages', 'vscodeAPI'] --- diff --git a/agents/wg-code-alchemist.agent.md b/agents/wg-code-alchemist.agent.md index 000cd749..b515ac0c 100644 --- a/agents/wg-code-alchemist.agent.md +++ b/agents/wg-code-alchemist.agent.md @@ -1,5 +1,6 @@ --- description: 'Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design' +name: 'WG Code Alchemist' tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI'] --- diff --git a/agents/wg-code-sentinel.agent.md b/agents/wg-code-sentinel.agent.md index bd59a600..f1201839 100644 --- a/agents/wg-code-sentinel.agent.md +++ b/agents/wg-code-sentinel.agent.md @@ -1,5 +1,6 @@ --- description: 'Ask WG Code Sentinel to review your code for security issues.' +name: 'WG Code Sentinel' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI'] --- diff --git a/context7.json b/context7.json new file mode 100644 index 00000000..ac308939 --- /dev/null +++ b/context7.json @@ -0,0 +1,4 @@ +{ + "url": "https://context7.com/github/awesome-copilot", + "public_key": "pk_8TIHuRHROWl7h8lwRzKDS" +} diff --git a/cookbook/README.md b/cookbook/README.md new file mode 100644 index 00000000..797ce76d --- /dev/null +++ b/cookbook/README.md @@ -0,0 +1,52 @@ +# GitHub Copilot Cookbook + +A collection of practical recipes and examples for working with GitHub Copilot tools and features. Each recipe provides focused, copy-paste-ready code snippets and real-world examples to help you accomplish common tasks. + +## What's in the Cookbook + +The cookbook is organized by tool or product, with recipes collected by language where applicable: + +### GitHub Copilot SDK + +Ready-to-use recipes for building with the GitHub Copilot SDK across multiple languages. + +- **[Copilot SDK Cookbook](copilot-sdk/)** - Recipes for .NET, Go, Node.js, and Python + - Error handling, session management, file operations, and more + - Runnable examples for each language + - Best practices and complete implementation guides + +## Getting Started + +1. Browse the tool or product folder that matches what you want to build +2. Find the recipe that solves your use case +3. Copy the code snippet or check the `recipe/` subfolder for complete, runnable examples +4. Refer to the language-specific documentation for setup and execution instructions + +## Planned Expansions + +The cookbook is designed to grow alongside the GitHub Copilot ecosystem. Future additions may include recipes for: + +- Additional Copilot tools and integrations +- Advanced patterns and workflows +- Integration with external services and APIs +- Language-specific optimizations and best practices + +## Contributing + +Have a recipe to share? We'd love to include it! See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines on submitting new recipes. + +## Resources + +### Official Documentation + +- [GitHub Copilot Documentation](https://docs.github.com/copilot) +- [GitHub Copilot SDK](https://github.com/github/copilot-sdk) + +### External Cookbooks + +- [Microsoft Copilot Adventures](https://github.com/microsoft/CopilotAdventures) - Interactive adventures and tutorials for learning GitHub Copilot +- [GitHub Copilot Chat Cookbook](https://docs.github.com/en/copilot/tutorials/copilot-chat-cookbook) - Official cookbook with Copilot Chat examples and techniques + +### Other + +- [Main Repository](../) diff --git a/cookbook/cookbook.yml b/cookbook/cookbook.yml new file mode 100644 index 00000000..d80454b5 --- /dev/null +++ b/cookbook/cookbook.yml @@ -0,0 +1,63 @@ +# yaml-language-server: $schema=../.schemas/cookbook.schema.json +# Cookbook manifest for the Awesome GitHub Copilot website +# This file defines the structure of cookbooks and recipes for the Samples page + +cookbooks: + - id: copilot-sdk + name: GitHub Copilot SDK + description: Ready-to-use recipes for building with the GitHub Copilot SDK across multiple languages + path: cookbook/copilot-sdk + featured: true + languages: + - id: nodejs + name: Node.js / TypeScript + icon: "\uE628" + extension: .ts + - id: python + name: Python + icon: "\uE73C" + extension: .py + - id: dotnet + name: .NET (C#) + icon: "\uE648" + extension: .cs + - id: go + name: Go + icon: "\uE626" + extension: .go + recipes: + - id: error-handling + name: Error Handling + description: Handle errors gracefully including connection failures, timeouts, and cleanup + tags: + - errors + - basics + - reliability + - id: multiple-sessions + name: Multiple Sessions + description: Manage multiple independent conversations simultaneously + tags: + - sessions + - advanced + - concurrency + - id: managing-local-files + name: Managing Local Files + description: Organize files by metadata using AI-powered grouping strategies + tags: + - files + - organization + - ai-powered + - id: pr-visualization + name: PR Visualization + description: Generate interactive PR age charts using GitHub MCP Server + tags: + - github + - visualization + - mcp + - id: persisting-sessions + name: Persisting Sessions + description: Save and resume sessions across restarts + tags: + - sessions + - persistence + - state-management diff --git a/cookbook/copilot-sdk/README.md b/cookbook/copilot-sdk/README.md new file mode 100644 index 00000000..53c91a70 --- /dev/null +++ b/cookbook/copilot-sdk/README.md @@ -0,0 +1,86 @@ +# GitHub Copilot SDK Cookbook + +This cookbook collects small, focused recipes showing how to accomplish common tasks with the GitHub Copilot SDK across languages. Each recipe is intentionally short and practical, with copy‑pasteable snippets and pointers to fuller examples and tests. + +## Recipes by Language + +### .NET (C#) + +- [Error Handling](dotnet/error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](dotnet/multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](dotnet/managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](dotnet/pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](dotnet/persisting-sessions.md): Save and resume sessions across restarts. + +### Node.js / TypeScript + +- [Error Handling](nodejs/error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](nodejs/multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](nodejs/managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](nodejs/pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](nodejs/persisting-sessions.md): Save and resume sessions across restarts. + +### Python + +- [Error Handling](python/error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](python/multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](python/managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](python/pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](python/persisting-sessions.md): Save and resume sessions across restarts. + +### Go + +- [Error Handling](go/error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](go/multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](go/managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](go/pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](go/persisting-sessions.md): Save and resume sessions across restarts. + +## How to Use + +- Browse your language section above and open the recipe links +- Each recipe includes runnable examples in a `recipe/` subfolder with language-specific tooling +- See existing examples and tests for working references: + - Node.js examples: `nodejs/examples/basic-example.ts` + - E2E tests: `go/e2e`, `python/e2e`, `nodejs/test/e2e`, `dotnet/test/Harness` + +## Running Examples + +### .NET + +```bash +cd dotnet/cookbook/recipe +dotnet run .cs +``` + +### Node.js + +```bash +cd nodejs/cookbook/recipe +npm install +npx tsx .ts +``` + +### Python + +```bash +cd python/cookbook/recipe +pip install -r requirements.txt +python .py +``` + +### Go + +```bash +cd go/cookbook/recipe +go run .go +``` + +## Contributing + +- Propose or add a new recipe by creating a markdown file in your language's `cookbook/` folder and a runnable example in `recipe/` +- Follow repository guidance in [CONTRIBUTING.md](../../CONTRIBUTING.md) + +## Status + +Cookbook structure is complete with 4 recipes across all 4 supported languages. Each recipe includes both markdown documentation and runnable examples. diff --git a/cookbook/copilot-sdk/dotnet/README.md b/cookbook/copilot-sdk/dotnet/README.md new file mode 100644 index 00000000..6e3d0bdd --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/README.md @@ -0,0 +1,19 @@ +# GitHub Copilot SDK Cookbook — .NET (C#) + +This folder hosts short, practical recipes for using the GitHub Copilot SDK with .NET. Each recipe is concise, copy‑pasteable, and points to fuller examples and tests. + +## Recipes + +- [Error Handling](error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](persisting-sessions.md): Save and resume sessions across restarts. + +## Contributing + +Add a new recipe by creating a markdown file in this folder and linking it above. Follow repository guidance in [CONTRIBUTING.md](../../../CONTRIBUTING.md). + +## Status + +These recipes are now complete and ready to use; the cookbook will continue to evolve as new scenarios are added. diff --git a/cookbook/copilot-sdk/dotnet/error-handling.md b/cookbook/copilot-sdk/dotnet/error-handling.md new file mode 100644 index 00000000..02a685ab --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/error-handling.md @@ -0,0 +1,156 @@ +# Error Handling Patterns + +Handle errors gracefully in your Copilot SDK applications. + +> **Runnable example:** [recipe/error-handling.cs](recipe/error-handling.cs) +> +> ```bash +> dotnet run recipe/error-handling.cs +> ``` + +## Example scenario + +You need to handle various error conditions like connection failures, timeouts, and invalid responses. + +## Basic try-catch + +```csharp +using GitHub.Copilot.SDK; + +var client = new CopilotClient(); + +try +{ + await client.StartAsync(); + var session = await client.CreateSessionAsync(new SessionConfig + { + Model = "gpt-5" + }); + + var done = new TaskCompletionSource(); + session.On(evt => + { + if (evt is AssistantMessageEvent msg) + { + done.SetResult(msg.Data.Content); + } + }); + + await session.SendAsync(new MessageOptions { Prompt = "Hello!" }); + var response = await done.Task; + Console.WriteLine(response); + + await session.DisposeAsync(); +} +catch (Exception ex) +{ + Console.WriteLine($"Error: {ex.Message}"); +} +finally +{ + await client.StopAsync(); +} +``` + +## Handling specific error types + +```csharp +try +{ + await client.StartAsync(); +} +catch (FileNotFoundException) +{ + Console.WriteLine("Copilot CLI not found. Please install it first."); +} +catch (HttpRequestException ex) when (ex.Message.Contains("connection")) +{ + Console.WriteLine("Could not connect to Copilot CLI server."); +} +catch (Exception ex) +{ + Console.WriteLine($"Unexpected error: {ex.Message}"); +} +``` + +## Timeout handling + +```csharp +var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); + +try +{ + var done = new TaskCompletionSource(); + session.On(evt => + { + if (evt is AssistantMessageEvent msg) + { + done.SetResult(msg.Data.Content); + } + }); + + await session.SendAsync(new MessageOptions { Prompt = "Complex question..." }); + + // Wait with timeout (30 seconds) + using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(30)); + var response = await done.Task.WaitAsync(cts.Token); + + Console.WriteLine(response); +} +catch (OperationCanceledException) +{ + Console.WriteLine("Request timed out"); +} +``` + +## Aborting a request + +```csharp +var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); + +// Start a request +await session.SendAsync(new MessageOptions { Prompt = "Write a very long story..." }); + +// Abort it after some condition +await Task.Delay(5000); +await session.AbortAsync(); +Console.WriteLine("Request aborted"); +``` + +## Graceful shutdown + +```csharp +Console.CancelKeyPress += async (sender, e) => +{ + e.Cancel = true; + Console.WriteLine("Shutting down..."); + + var errors = await client.StopAsync(); + if (errors.Count > 0) + { + Console.WriteLine($"Cleanup errors: {string.Join(", ", errors)}"); + } + + Environment.Exit(0); +}; +``` + +## Using await using for automatic disposal + +```csharp +await using var client = new CopilotClient(); +await client.StartAsync(); + +var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); + +// ... do work ... + +// client.StopAsync() is automatically called when exiting scope +``` + +## Best practices + +1. **Always clean up**: Use try-finally or `await using` to ensure `StopAsync()` is called +2. **Handle connection errors**: The CLI might not be installed or running +3. **Set appropriate timeouts**: Use `CancellationToken` for long-running requests +4. **Log errors**: Capture error details for debugging diff --git a/cookbook/copilot-sdk/dotnet/managing-local-files.md b/cookbook/copilot-sdk/dotnet/managing-local-files.md new file mode 100644 index 00000000..105758b6 --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/managing-local-files.md @@ -0,0 +1,138 @@ +# Grouping Files by Metadata + +Use Copilot to intelligently organize files in a folder based on their metadata. + +> **Runnable example:** [recipe/managing-local-files.cs](recipe/managing-local-files.cs) +> +> ```bash +> dotnet run recipe/managing-local-files.cs +> ``` + +## Example scenario + +You have a folder with many files and want to organize them into subfolders based on metadata like file type, creation date, size, or other attributes. Copilot can analyze the files and suggest or execute a grouping strategy. + +## Example code + +```csharp +using GitHub.Copilot.SDK; + +// Create and start client +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Define tools for file operations +var session = await client.CreateSessionAsync(new SessionConfig +{ + Model = "gpt-5" +}); + +// Wait for completion +var done = new TaskCompletionSource(); + +session.On(evt => +{ + switch (evt) + { + case AssistantMessageEvent msg: + Console.WriteLine($"\nCopilot: {msg.Data.Content}"); + break; + case ToolExecutionStartEvent toolStart: + Console.WriteLine($" → Running: {toolStart.Data.ToolName} ({toolStart.Data.ToolCallId})"); + break; + case ToolExecutionCompleteEvent toolEnd: + Console.WriteLine($" ✓ Completed: {toolEnd.Data.ToolCallId}"); + break; + case SessionIdleEvent: + done.SetResult(); + break; + } +}); + +// Ask Copilot to organize files +var targetFolder = @"C:\Users\Me\Downloads"; + +await session.SendAsync(new MessageOptions +{ + Prompt = $""" + Analyze the files in "{targetFolder}" and organize them into subfolders. + + 1. First, list all files and their metadata + 2. Preview grouping by file extension + 3. Create appropriate subfolders (e.g., "images", "documents", "videos") + 4. Move each file to its appropriate subfolder + + Please confirm before moving any files. + """ +}); + +await done.Task; +``` + +## Grouping strategies + +### By file extension + +```csharp +// Groups files like: +// images/ -> .jpg, .png, .gif +// documents/ -> .pdf, .docx, .txt +// videos/ -> .mp4, .avi, .mov +``` + +### By creation date + +```csharp +// Groups files like: +// 2024-01/ -> files created in January 2024 +// 2024-02/ -> files created in February 2024 +``` + +### By file size + +```csharp +// Groups files like: +// tiny-under-1kb/ +// small-under-1mb/ +// medium-under-100mb/ +// large-over-100mb/ +``` + +## Dry-run mode + +For safety, you can ask Copilot to only preview changes: + +```csharp +await session.SendAsync(new MessageOptions +{ + Prompt = $""" + Analyze files in "{targetFolder}" and show me how you would organize them + by file type. DO NOT move any files - just show me the plan. + """ +}); +``` + +## Custom grouping with AI analysis + +Let Copilot determine the best grouping based on file content: + +```csharp +await session.SendAsync(new MessageOptions +{ + Prompt = $""" + Look at the files in "{targetFolder}" and suggest a logical organization. + Consider: + - File names and what they might contain + - File types and their typical uses + - Date patterns that might indicate projects or events + + Propose folder names that are descriptive and useful. + """ +}); +``` + +## Safety considerations + +1. **Confirm before moving**: Ask Copilot to confirm before executing moves +1. **Handle duplicates**: Consider what happens if a file with the same name exists +1. **Preserve originals**: Consider copying instead of moving for important files diff --git a/cookbook/copilot-sdk/dotnet/multiple-sessions.md b/cookbook/copilot-sdk/dotnet/multiple-sessions.md new file mode 100644 index 00000000..9ce05e80 --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/multiple-sessions.md @@ -0,0 +1,79 @@ +# Working with Multiple Sessions + +Manage multiple independent conversations simultaneously. + +> **Runnable example:** [recipe/multiple-sessions.cs](recipe/multiple-sessions.cs) +> +> ```bash +> dotnet run recipe/multiple-sessions.cs +> ``` + +## Example scenario + +You need to run multiple conversations in parallel, each with its own context and history. + +## C# + +```csharp +using GitHub.Copilot.SDK; + +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Create multiple independent sessions +var session1 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); +var session2 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); +var session3 = await client.CreateSessionAsync(new SessionConfig { Model = "claude-sonnet-4.5" }); + +// Each session maintains its own conversation history +await session1.SendAsync(new MessageOptions { Prompt = "You are helping with a Python project" }); +await session2.SendAsync(new MessageOptions { Prompt = "You are helping with a TypeScript project" }); +await session3.SendAsync(new MessageOptions { Prompt = "You are helping with a Go project" }); + +// Follow-up messages stay in their respective contexts +await session1.SendAsync(new MessageOptions { Prompt = "How do I create a virtual environment?" }); +await session2.SendAsync(new MessageOptions { Prompt = "How do I set up tsconfig?" }); +await session3.SendAsync(new MessageOptions { Prompt = "How do I initialize a module?" }); + +// Clean up all sessions +await session1.DisposeAsync(); +await session2.DisposeAsync(); +await session3.DisposeAsync(); +``` + +## Custom session IDs + +Use custom IDs for easier tracking: + +```csharp +var session = await client.CreateSessionAsync(new SessionConfig +{ + SessionId = "user-123-chat", + Model = "gpt-5" +}); + +Console.WriteLine(session.SessionId); // "user-123-chat" +``` + +## Listing sessions + +```csharp +var sessions = await client.ListSessionsAsync(); +foreach (var sessionInfo in sessions) +{ + Console.WriteLine($"Session: {sessionInfo.SessionId}"); +} +``` + +## Deleting sessions + +```csharp +// Delete a specific session +await client.DeleteSessionAsync("user-123-chat"); +``` + +## Use cases + +- **Multi-user applications**: One session per user +- **Multi-task workflows**: Separate sessions for different tasks +- **A/B testing**: Compare responses from different models diff --git a/cookbook/copilot-sdk/dotnet/persisting-sessions.md b/cookbook/copilot-sdk/dotnet/persisting-sessions.md new file mode 100644 index 00000000..f6a3aa13 --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/persisting-sessions.md @@ -0,0 +1,90 @@ +# Session Persistence and Resumption + +Save and restore conversation sessions across application restarts. + +## Example scenario + +You want users to be able to continue a conversation even after closing and reopening your application. + +> **Runnable example:** [recipe/persisting-sessions.cs](recipe/persisting-sessions.cs) +> +> ```bash +> cd recipe +> dotnet run persisting-sessions.cs +> ``` + +### Creating a session with a custom ID + +```csharp +using GitHub.Copilot.SDK; + +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Create session with a memorable ID +var session = await client.CreateSessionAsync(new SessionConfig +{ + SessionId = "user-123-conversation", + Model = "gpt-5" +}); + +await session.SendAsync(new MessageOptions { Prompt = "Let's discuss TypeScript generics" }); + +// Session ID is preserved +Console.WriteLine(session.SessionId); // "user-123-conversation" + +// Destroy session but keep data on disk +await session.DisposeAsync(); +await client.StopAsync(); +``` + +### Resuming a session + +```csharp +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Resume the previous session +var session = await client.ResumeSessionAsync("user-123-conversation"); + +// Previous context is restored +await session.SendAsync(new MessageOptions { Prompt = "What were we discussing?" }); + +await session.DisposeAsync(); +await client.StopAsync(); +``` + +### Listing available sessions + +```csharp +var sessions = await client.ListSessionsAsync(); +foreach (var s in sessions) +{ + Console.WriteLine($"Session: {s.SessionId}"); +} +``` + +### Deleting a session permanently + +```csharp +// Remove session and all its data from disk +await client.DeleteSessionAsync("user-123-conversation"); +``` + +### Getting session history + +Retrieve all messages from a session: + +```csharp +var messages = await session.GetMessagesAsync(); +foreach (var msg in messages) +{ + Console.WriteLine($"[{msg.Type}] {msg.Data.Content}"); +} +``` + +## Best practices + +1. **Use meaningful session IDs**: Include user ID or context in the session ID +2. **Handle missing sessions**: Check if a session exists before resuming +3. **Clean up old sessions**: Periodically delete sessions that are no longer needed diff --git a/cookbook/copilot-sdk/dotnet/pr-visualization.md b/cookbook/copilot-sdk/dotnet/pr-visualization.md new file mode 100644 index 00000000..f427ebe1 --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/pr-visualization.md @@ -0,0 +1,257 @@ +# Generating PR Age Charts + +Build an interactive CLI tool that visualizes pull request age distribution for a GitHub repository using Copilot's built-in capabilities. + +> **Runnable example:** [recipe/pr-visualization.cs](recipe/pr-visualization.cs) +> +> ```bash +> # Auto-detect from current git repo +> dotnet run recipe/pr-visualization.cs +> +> # Specify a repo explicitly +> dotnet run recipe/pr-visualization.cs -- --repo github/copilot-sdk +> ``` + +## Example scenario + +You want to understand how long PRs have been open in a repository. This tool detects the current Git repo or accepts a repo as input, then lets Copilot fetch PR data via the GitHub MCP Server and generate a chart image. + +## Prerequisites + +```bash +dotnet add package GitHub.Copilot.SDK +``` + +## Usage + +```bash +# Auto-detect from current git repo +dotnet run + +# Specify a repo explicitly +dotnet run -- --repo github/copilot-sdk +``` + +## Full example: pr-visualization.cs + +```csharp +using System.Diagnostics; +using GitHub.Copilot.SDK; + +// ============================================================================ +// Git & GitHub Detection +// ============================================================================ + +bool IsGitRepo() +{ + try + { + Process.Start(new ProcessStartInfo + { + FileName = "git", + Arguments = "rev-parse --git-dir", + RedirectStandardOutput = true, + RedirectStandardError = true, + UseShellExecute = false, + CreateNoWindow = true + })?.WaitForExit(); + return true; + } + catch + { + return false; + } +} + +string? GetGitHubRemote() +{ + try + { + var proc = Process.Start(new ProcessStartInfo + { + FileName = "git", + Arguments = "remote get-url origin", + RedirectStandardOutput = true, + UseShellExecute = false, + CreateNoWindow = true + }); + + var remoteUrl = proc?.StandardOutput.ReadToEnd().Trim(); + proc?.WaitForExit(); + + if (string.IsNullOrEmpty(remoteUrl)) return null; + + // Handle SSH: git@github.com:owner/repo.git + var sshMatch = System.Text.RegularExpressions.Regex.Match( + remoteUrl, @"git@github\.com:(.+/.+?)(?:\.git)?$"); + if (sshMatch.Success) return sshMatch.Groups[1].Value; + + // Handle HTTPS: https://github.com/owner/repo.git + var httpsMatch = System.Text.RegularExpressions.Regex.Match( + remoteUrl, @"https://github\.com/(.+/.+?)(?:\.git)?$"); + if (httpsMatch.Success) return httpsMatch.Groups[1].Value; + + return null; + } + catch + { + return null; + } +} + +string? ParseRepoArg(string[] args) +{ + var repoIndex = Array.IndexOf(args, "--repo"); + if (repoIndex != -1 && repoIndex + 1 < args.Length) + { + return args[repoIndex + 1]; + } + return null; +} + +string PromptForRepo() +{ + Console.Write("Enter GitHub repo (owner/repo): "); + return Console.ReadLine()?.Trim() ?? ""; +} + +// ============================================================================ +// Main Application +// ============================================================================ + +Console.WriteLine("🔍 PR Age Chart Generator\n"); + +// Determine the repository +var repo = ParseRepoArg(args); + +if (!string.IsNullOrEmpty(repo)) +{ + Console.WriteLine($"📦 Using specified repo: {repo}"); +} +else if (IsGitRepo()) +{ + var detected = GetGitHubRemote(); + if (detected != null) + { + repo = detected; + Console.WriteLine($"📦 Detected GitHub repo: {repo}"); + } + else + { + Console.WriteLine("⚠️ Git repo found but no GitHub remote detected."); + repo = PromptForRepo(); + } +} +else +{ + Console.WriteLine("📁 Not in a git repository."); + repo = PromptForRepo(); +} + +if (string.IsNullOrEmpty(repo) || !repo.Contains('/')) +{ + Console.WriteLine("❌ Invalid repo format. Expected: owner/repo"); + return; +} + +var parts = repo.Split('/'); +var owner = parts[0]; +var repoName = parts[1]; + +// Create Copilot client - no custom tools needed! +await using var client = new CopilotClient(new CopilotClientOptions { LogLevel = "error" }); +await client.StartAsync(); + +var session = await client.CreateSessionAsync(new SessionConfig +{ + Model = "gpt-5", + SystemMessage = new SystemMessageConfig + { + Content = $""" + +You are analyzing pull requests for the GitHub repository: {owner}/{repoName} +The current working directory is: {Environment.CurrentDirectory} + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +""" + } +}); + +// Set up event handling +session.On(evt => +{ + switch (evt) + { + case AssistantMessageEvent msg: + Console.WriteLine($"\n🤖 {msg.Data.Content}\n"); + break; + case ToolExecutionStartEvent toolStart: + Console.WriteLine($" ⚙️ {toolStart.Data.ToolName}"); + break; + } +}); + +// Initial prompt - let Copilot figure out the details +Console.WriteLine("\n📊 Starting analysis...\n"); + +await session.SendAsync(new MessageOptions +{ + Prompt = $""" + Fetch the open pull requests for {owner}/{repoName} from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + """ +}); + +// Interactive loop +Console.WriteLine("\n💡 Ask follow-up questions or type \"exit\" to quit.\n"); +Console.WriteLine("Examples:"); +Console.WriteLine(" - \"Expand to the last month\""); +Console.WriteLine(" - \"Show me the 5 oldest PRs\""); +Console.WriteLine(" - \"Generate a pie chart instead\""); +Console.WriteLine(" - \"Group by author instead of age\""); +Console.WriteLine(); + +while (true) +{ + Console.Write("You: "); + var input = Console.ReadLine()?.Trim(); + + if (string.IsNullOrEmpty(input)) continue; + if (input.ToLower() is "exit" or "quit") + { + Console.WriteLine("👋 Goodbye!"); + break; + } + + await session.SendAsync(new MessageOptions { Prompt = input }); +} +``` + +## How it works + +1. **Repository detection**: Checks `--repo` flag → git remote → prompts user +2. **No custom tools**: Relies entirely on Copilot CLI's built-in capabilities: + - **GitHub MCP Server** - Fetches PR data from GitHub + - **File tools** - Saves generated chart images + - **Code execution** - Generates charts using Python/matplotlib or other methods +3. **Interactive session**: After initial analysis, user can ask for adjustments + +## Why this approach? + +| Aspect | Custom Tools | Built-in Copilot | +| --------------- | ----------------- | --------------------------------- | +| Code complexity | High | **Minimal** | +| Maintenance | You maintain | **Copilot maintains** | +| Flexibility | Fixed logic | **AI decides best approach** | +| Chart types | What you coded | **Any type Copilot can generate** | +| Data grouping | Hardcoded buckets | **Intelligent grouping** | diff --git a/cookbook/copilot-sdk/dotnet/recipe/README.md b/cookbook/copilot-sdk/dotnet/recipe/README.md new file mode 100644 index 00000000..be2d0045 --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/recipe/README.md @@ -0,0 +1,55 @@ +# Runnable Recipe Examples + +This folder contains standalone, executable C# examples for each cookbook recipe. These are [file-based apps](https://learn.microsoft.com/dotnet/core/sdk/file-based-apps) that can be run directly with `dotnet run`. + +## Prerequisites + +- .NET 10.0 or later +- GitHub Copilot SDK package (referenced automatically) + +## Running Examples + +Each `.cs` file is a complete, runnable program. Simply use: + +```bash +dotnet run .cs +``` + +### Available Recipes + +| Recipe | Command | Description | +| -------------------- | ------------------------------------ | ------------------------------------------ | +| Error Handling | `dotnet run error-handling.cs` | Demonstrates error handling patterns | +| Multiple Sessions | `dotnet run multiple-sessions.cs` | Manages multiple independent conversations | +| Managing Local Files | `dotnet run managing-local-files.cs` | Organizes files using AI grouping | +| PR Visualization | `dotnet run pr-visualization.cs` | Generates PR age charts | +| Persisting Sessions | `dotnet run persisting-sessions.cs` | Save and resume sessions across restarts | + +### Examples with Arguments + +**PR Visualization with specific repo:** + +```bash +dotnet run pr-visualization.cs -- --repo github/copilot-sdk +``` + +**Managing Local Files (edit the file to change target folder):** + +```bash +# Edit the targetFolder variable in managing-local-files.cs first +dotnet run managing-local-files.cs +``` + +## File-Based Apps + +These examples use .NET's file-based app feature, which allows single-file C# programs to: + +- Run without a project file +- Automatically reference common packages +- Support top-level statements + +## Learning Resources + +- [.NET File-Based Apps Documentation](https://learn.microsoft.com/en-us/dotnet/core/sdk/file-based-apps) +- [GitHub Copilot SDK Documentation](https://github.com/github/copilot-sdk/blob/main/dotnet/README.md) +- [Parent Cookbook](../README.md) diff --git a/cookbook/copilot-sdk/dotnet/recipe/error-handling.cs b/cookbook/copilot-sdk/dotnet/recipe/error-handling.cs new file mode 100644 index 00000000..3f0e9bb0 --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/recipe/error-handling.cs @@ -0,0 +1,38 @@ +#:package GitHub.Copilot.SDK@* +#:property PublishAot=false + +using GitHub.Copilot.SDK; + +var client = new CopilotClient(); + +try +{ + await client.StartAsync(); + var session = await client.CreateSessionAsync(new SessionConfig + { + Model = "gpt-5" + }); + + var done = new TaskCompletionSource(); + session.On(evt => + { + if (evt is AssistantMessageEvent msg) + { + done.SetResult(msg.Data.Content); + } + }); + + await session.SendAsync(new MessageOptions { Prompt = "Hello!" }); + var response = await done.Task; + Console.WriteLine(response); + + await session.DisposeAsync(); +} +catch (Exception ex) +{ + Console.WriteLine($"Error: {ex.Message}"); +} +finally +{ + await client.StopAsync(); +} diff --git a/cookbook/copilot-sdk/dotnet/recipe/managing-local-files.cs b/cookbook/copilot-sdk/dotnet/recipe/managing-local-files.cs new file mode 100644 index 00000000..859e0d5d --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/recipe/managing-local-files.cs @@ -0,0 +1,56 @@ +#:package GitHub.Copilot.SDK@* +#:property PublishAot=false + +using GitHub.Copilot.SDK; + +// Create and start client +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Define tools for file operations +var session = await client.CreateSessionAsync(new SessionConfig +{ + Model = "gpt-5" +}); + +// Wait for completion +var done = new TaskCompletionSource(); + +session.On(evt => +{ + switch (evt) + { + case AssistantMessageEvent msg: + Console.WriteLine($"\nCopilot: {msg.Data.Content}"); + break; + case ToolExecutionStartEvent toolStart: + Console.WriteLine($" → Running: {toolStart.Data.ToolName} ({toolStart.Data.ToolCallId})"); + break; + case ToolExecutionCompleteEvent toolEnd: + Console.WriteLine($" ✓ Completed: {toolEnd.Data.ToolCallId}"); + break; + case SessionIdleEvent: + done.SetResult(); + break; + } +}); + +// Ask Copilot to organize files +// Change this to your target folder +var targetFolder = @"C:\Users\Me\Downloads"; + +await session.SendAsync(new MessageOptions +{ + Prompt = $""" + Analyze the files in "{targetFolder}" and organize them into subfolders. + + 1. First, list all files and their metadata + 2. Preview grouping by file extension + 3. Create appropriate subfolders (e.g., "images", "documents", "videos") + 4. Move each file to its appropriate subfolder + + Please confirm before moving any files. + """ +}); + +await done.Task; diff --git a/cookbook/copilot-sdk/dotnet/recipe/multiple-sessions.cs b/cookbook/copilot-sdk/dotnet/recipe/multiple-sessions.cs new file mode 100644 index 00000000..166606aa --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/recipe/multiple-sessions.cs @@ -0,0 +1,35 @@ +#:package GitHub.Copilot.SDK@* +#:property PublishAot=false + +using GitHub.Copilot.SDK; + +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Create multiple independent sessions +var session1 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); +var session2 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" }); +var session3 = await client.CreateSessionAsync(new SessionConfig { Model = "claude-sonnet-4.5" }); + +Console.WriteLine("Created 3 independent sessions"); + +// Each session maintains its own conversation history +await session1.SendAsync(new MessageOptions { Prompt = "You are helping with a Python project" }); +await session2.SendAsync(new MessageOptions { Prompt = "You are helping with a TypeScript project" }); +await session3.SendAsync(new MessageOptions { Prompt = "You are helping with a Go project" }); + +Console.WriteLine("Sent initial context to all sessions"); + +// Follow-up messages stay in their respective contexts +await session1.SendAsync(new MessageOptions { Prompt = "How do I create a virtual environment?" }); +await session2.SendAsync(new MessageOptions { Prompt = "How do I set up tsconfig?" }); +await session3.SendAsync(new MessageOptions { Prompt = "How do I initialize a module?" }); + +Console.WriteLine("Sent follow-up questions to each session"); + +// Clean up all sessions +await session1.DisposeAsync(); +await session2.DisposeAsync(); +await session3.DisposeAsync(); + +Console.WriteLine("All sessions destroyed successfully"); diff --git a/cookbook/copilot-sdk/dotnet/recipe/persisting-sessions.cs b/cookbook/copilot-sdk/dotnet/recipe/persisting-sessions.cs new file mode 100644 index 00000000..72d3659e --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/recipe/persisting-sessions.cs @@ -0,0 +1,38 @@ +#:package GitHub.Copilot.SDK@* +#:property PublishAot=false + +using GitHub.Copilot.SDK; + +await using var client = new CopilotClient(); +await client.StartAsync(); + +// Create session with a memorable ID +var session = await client.CreateSessionAsync(new SessionConfig +{ + SessionId = "user-123-conversation", + Model = "gpt-5" +}); + +await session.SendAsync(new MessageOptions { Prompt = "Let's discuss TypeScript generics" }); +Console.WriteLine($"Session created: {session.SessionId}"); + +// Destroy session but keep data on disk +await session.DisposeAsync(); +Console.WriteLine("Session destroyed (state persisted)"); + +// Resume the previous session +var resumed = await client.ResumeSessionAsync("user-123-conversation"); +Console.WriteLine($"Resumed: {resumed.SessionId}"); + +await resumed.SendAsync(new MessageOptions { Prompt = "What were we discussing?" }); + +// List sessions +var sessions = await client.ListSessionsAsync(); +Console.WriteLine("Sessions: " + string.Join(", ", sessions.Select(s => s.SessionId))); + +// Delete session permanently +await client.DeleteSessionAsync("user-123-conversation"); +Console.WriteLine("Session deleted"); + +await resumed.DisposeAsync(); +await client.StopAsync(); diff --git a/cookbook/copilot-sdk/dotnet/recipe/pr-visualization.cs b/cookbook/copilot-sdk/dotnet/recipe/pr-visualization.cs new file mode 100644 index 00000000..b635f5ca --- /dev/null +++ b/cookbook/copilot-sdk/dotnet/recipe/pr-visualization.cs @@ -0,0 +1,204 @@ +#:package GitHub.Copilot.SDK@* +#:property PublishAot=false + +using System.Diagnostics; +using GitHub.Copilot.SDK; + +// ============================================================================ +// Git & GitHub Detection +// ============================================================================ + +bool IsGitRepo() +{ + try + { + var proc = Process.Start(new ProcessStartInfo + { + FileName = "git", + Arguments = "rev-parse --git-dir", + RedirectStandardOutput = true, + RedirectStandardError = true, + UseShellExecute = false, + CreateNoWindow = true + }); + proc?.WaitForExit(); + return proc?.ExitCode == 0; + } + catch + { + return false; + } +} + +string? GetGitHubRemote() +{ + try + { + var proc = Process.Start(new ProcessStartInfo + { + FileName = "git", + Arguments = "remote get-url origin", + RedirectStandardOutput = true, + UseShellExecute = false, + CreateNoWindow = true + }); + + var remoteUrl = proc?.StandardOutput.ReadToEnd().Trim(); + proc?.WaitForExit(); + + if (string.IsNullOrEmpty(remoteUrl)) return null; + + // Handle SSH: git@github.com:owner/repo.git + var sshMatch = System.Text.RegularExpressions.Regex.Match( + remoteUrl, @"git@github\.com:(.+/.+?)(?:\.git)?$"); + if (sshMatch.Success) return sshMatch.Groups[1].Value; + + // Handle HTTPS: https://github.com/owner/repo.git + var httpsMatch = System.Text.RegularExpressions.Regex.Match( + remoteUrl, @"https://github\.com/(.+/.+?)(?:\.git)?$"); + if (httpsMatch.Success) return httpsMatch.Groups[1].Value; + + return null; + } + catch + { + return null; + } +} + +string? ParseRepoArg(string[] args) +{ + var repoIndex = Array.IndexOf(args, "--repo"); + if (repoIndex != -1 && repoIndex + 1 < args.Length) + { + return args[repoIndex + 1]; + } + return null; +} + +string PromptForRepo() +{ + Console.Write("Enter GitHub repo (owner/repo): "); + return Console.ReadLine()?.Trim() ?? ""; +} + +// ============================================================================ +// Main Application +// ============================================================================ + +Console.WriteLine("🔍 PR Age Chart Generator\n"); + +// Determine the repository +var repo = ParseRepoArg(args); + +if (!string.IsNullOrEmpty(repo)) +{ + Console.WriteLine($"📦 Using specified repo: {repo}"); +} +else if (IsGitRepo()) +{ + var detected = GetGitHubRemote(); + if (detected != null) + { + repo = detected; + Console.WriteLine($"📦 Detected GitHub repo: {repo}"); + } + else + { + Console.WriteLine("⚠️ Git repo found but no GitHub remote detected."); + repo = PromptForRepo(); + } +} +else +{ + Console.WriteLine("📁 Not in a git repository."); + repo = PromptForRepo(); +} + +if (string.IsNullOrEmpty(repo) || !repo.Contains('/')) +{ + Console.WriteLine("❌ Invalid repo format. Expected: owner/repo"); + return; +} + +var parts = repo.Split('/'); +var owner = parts[0]; +var repoName = parts[1]; + +// Create Copilot client - no custom tools needed! +await using var client = new CopilotClient(new CopilotClientOptions { LogLevel = "error" }); +await client.StartAsync(); + +var session = await client.CreateSessionAsync(new SessionConfig +{ + Model = "gpt-5", + SystemMessage = new SystemMessageConfig + { + Content = $""" + +You are analyzing pull requests for the GitHub repository: {owner}/{repoName} +The current working directory is: {Environment.CurrentDirectory} + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +""" + } +}); + +// Set up event handling +session.On(evt => +{ + switch (evt) + { + case AssistantMessageEvent msg: + Console.WriteLine($"\n🤖 {msg.Data.Content}\n"); + break; + case ToolExecutionStartEvent toolStart: + Console.WriteLine($" ⚙️ {toolStart.Data.ToolName}"); + break; + } +}); + +// Initial prompt - let Copilot figure out the details +Console.WriteLine("\n📊 Starting analysis...\n"); + +await session.SendAsync(new MessageOptions +{ + Prompt = $""" + Fetch the open pull requests for {owner}/{repoName} from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + """ +}); + +// Interactive loop +Console.WriteLine("\n💡 Ask follow-up questions or type \"exit\" to quit.\n"); +Console.WriteLine("Examples:"); +Console.WriteLine(" - \"Expand to the last month\""); +Console.WriteLine(" - \"Show me the 5 oldest PRs\""); +Console.WriteLine(" - \"Generate a pie chart instead\""); +Console.WriteLine(" - \"Group by author instead of age\""); +Console.WriteLine(); + +while (true) +{ + Console.Write("You: "); + var input = Console.ReadLine()?.Trim(); + + if (string.IsNullOrEmpty(input)) continue; + if (input.ToLower() is "exit" or "quit") + { + Console.WriteLine("👋 Goodbye!"); + break; + } + + await session.SendAsync(new MessageOptions { Prompt = input }); +} diff --git a/cookbook/copilot-sdk/go.sum b/cookbook/copilot-sdk/go.sum new file mode 100644 index 00000000..213d0035 --- /dev/null +++ b/cookbook/copilot-sdk/go.sum @@ -0,0 +1,6 @@ +github.com/github/copilot-sdk/go v0.1.18 h1:S1ocOfTKxiNGtj+/qp4z+RZeOr9hniqy3UqIIYZxsuQ= +github.com/github/copilot-sdk/go v0.1.18/go.mod h1:0SYT+64k347IDT0Trn4JHVFlUhPtGSE6ab479tU/+tY= +github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8= +github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU= +github.com/google/jsonschema-go v0.4.2 h1:tmrUohrwoLZZS/P3x7ex0WAVknEkBZM46iALbcqoRA8= +github.com/google/jsonschema-go v0.4.2/go.mod h1:r5quNTdLOYEz95Ru18zA0ydNbBuYoo9tgaYcxEYhJVE= diff --git a/cookbook/copilot-sdk/go/README.md b/cookbook/copilot-sdk/go/README.md new file mode 100644 index 00000000..3bc15a6d --- /dev/null +++ b/cookbook/copilot-sdk/go/README.md @@ -0,0 +1,19 @@ +# GitHub Copilot SDK Cookbook — Go + +This folder hosts short, practical recipes for using the GitHub Copilot SDK with Go. Each recipe is concise, copy‑pasteable, and points to fuller examples and tests. + +## Recipes + +- [Error Handling](error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](persisting-sessions.md): Save and resume sessions across restarts. + +## Contributing + +Add a new recipe by creating a markdown file in this folder and linking it above. Follow repository guidance in [CONTRIBUTING.md](../../../CONTRIBUTING.md). + +## Status + +These recipes are complete, practical examples and can be used directly or adapted for your own projects. diff --git a/cookbook/copilot-sdk/go/error-handling.md b/cookbook/copilot-sdk/go/error-handling.md new file mode 100644 index 00000000..658613a9 --- /dev/null +++ b/cookbook/copilot-sdk/go/error-handling.md @@ -0,0 +1,206 @@ +# Error Handling Patterns + +Handle errors gracefully in your Copilot SDK applications. + +> **Runnable example:** [recipe/error-handling.go](recipe/error-handling.go) +> +> ```bash +> go run recipe/error-handling.go +> ``` + +## Example scenario + +You need to handle various error conditions like connection failures, timeouts, and invalid responses. + +## Basic error handling + +```go +package main + +import ( + "fmt" + "log" + "github.com/github/copilot-sdk/go" +) + +func main() { + client := copilot.NewClient() + + if err := client.Start(); err != nil { + log.Fatalf("Failed to start client: %v", err) + } + defer func() { + if err := client.Stop(); err != nil { + log.Printf("Error stopping client: %v", err) + } + }() + + session, err := client.CreateSession(copilot.SessionConfig{ + Model: "gpt-5", + }) + if err != nil { + log.Fatalf("Failed to create session: %v", err) + } + defer session.Destroy() + + responseChan := make(chan string, 1) + session.On(func(event copilot.Event) { + if msg, ok := event.(copilot.AssistantMessageEvent); ok { + responseChan <- msg.Data.Content + } + }) + + if err := session.Send(copilot.MessageOptions{Prompt: "Hello!"}); err != nil { + log.Printf("Failed to send message: %v", err) + } + + response := <-responseChan + fmt.Println(response) +} +``` + +## Handling specific error types + +```go +import ( + "errors" + "os/exec" +) + +func startClient() error { + client := copilot.NewClient() + + if err := client.Start(); err != nil { + var execErr *exec.Error + if errors.As(err, &execErr) { + return fmt.Errorf("Copilot CLI not found. Please install it first: %w", err) + } + if errors.Is(err, context.DeadlineExceeded) { + return fmt.Errorf("Could not connect to Copilot CLI server: %w", err) + } + return fmt.Errorf("Unexpected error: %w", err) + } + + return nil +} +``` + +## Timeout handling + +```go +import ( + "context" + "time" +) + +func sendWithTimeout(session *copilot.Session) error { + ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) + defer cancel() + + responseChan := make(chan string, 1) + errChan := make(chan error, 1) + + session.On(func(event copilot.Event) { + if msg, ok := event.(copilot.AssistantMessageEvent); ok { + responseChan <- msg.Data.Content + } + }) + + if err := session.Send(copilot.MessageOptions{Prompt: "Complex question..."}); err != nil { + return err + } + + select { + case response := <-responseChan: + fmt.Println(response) + return nil + case err := <-errChan: + return err + case <-ctx.Done(): + return fmt.Errorf("request timed out") + } +} +``` + +## Aborting a request + +```go +func abortAfterDelay(session *copilot.Session) { + // Start a request + session.Send(copilot.MessageOptions{Prompt: "Write a very long story..."}) + + // Abort it after some condition + time.AfterFunc(5*time.Second, func() { + if err := session.Abort(); err != nil { + log.Printf("Failed to abort: %v", err) + } + fmt.Println("Request aborted") + }) +} +``` + +## Graceful shutdown + +```go +import ( + "os" + "os/signal" + "syscall" +) + +func main() { + client := copilot.NewClient() + + // Set up signal handling + sigChan := make(chan os.Signal, 1) + signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM) + + go func() { + <-sigChan + fmt.Println("\nShutting down...") + + if err := client.Stop(); err != nil { + log.Printf("Cleanup errors: %v", err) + } + + os.Exit(0) + }() + + if err := client.Start(); err != nil { + log.Fatal(err) + } + + // ... do work ... +} +``` + +## Deferred cleanup pattern + +```go +func doWork() error { + client := copilot.NewClient() + + if err := client.Start(); err != nil { + return fmt.Errorf("failed to start: %w", err) + } + defer client.Stop() + + session, err := client.CreateSession(copilot.SessionConfig{Model: "gpt-5"}) + if err != nil { + return fmt.Errorf("failed to create session: %w", err) + } + defer session.Destroy() + + // ... do work ... + + return nil +} +``` + +## Best practices + +1. **Always clean up**: Use defer to ensure `Stop()` is called +2. **Handle connection errors**: The CLI might not be installed or running +3. **Set appropriate timeouts**: Use `context.WithTimeout` for long-running requests +4. **Log errors**: Capture error details for debugging +5. **Wrap errors**: Use `fmt.Errorf` with `%w` to preserve error chains diff --git a/cookbook/copilot-sdk/go/managing-local-files.md b/cookbook/copilot-sdk/go/managing-local-files.md new file mode 100644 index 00000000..1e5a2999 --- /dev/null +++ b/cookbook/copilot-sdk/go/managing-local-files.md @@ -0,0 +1,144 @@ +# Grouping Files by Metadata + +Use Copilot to intelligently organize files in a folder based on their metadata. + +> **Runnable example:** [recipe/managing-local-files.go](recipe/managing-local-files.go) +> +> ```bash +> go run recipe/managing-local-files.go +> ``` + +## Example scenario + +You have a folder with many files and want to organize them into subfolders based on metadata like file type, creation date, size, or other attributes. Copilot can analyze the files and suggest or execute a grouping strategy. + +## Example code + +```go +package main + +import ( + "fmt" + "log" + "os" + "path/filepath" + "github.com/github/copilot-sdk/go" +) + +func main() { + // Create and start client + client := copilot.NewClient() + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + // Create session + session, err := client.CreateSession(copilot.SessionConfig{ + Model: "gpt-5", + }) + if err != nil { + log.Fatal(err) + } + defer session.Destroy() + + // Event handler + session.On(func(event copilot.Event) { + switch e := event.(type) { + case copilot.AssistantMessageEvent: + fmt.Printf("\nCopilot: %s\n", e.Data.Content) + case copilot.ToolExecutionStartEvent: + fmt.Printf(" → Running: %s\n", e.Data.ToolName) + case copilot.ToolExecutionCompleteEvent: + fmt.Printf(" ✓ Completed: %s\n", e.Data.ToolName) + } + }) + + // Ask Copilot to organize files + homeDir, _ := os.UserHomeDir() + targetFolder := filepath.Join(homeDir, "Downloads") + + prompt := fmt.Sprintf(` +Analyze the files in "%s" and organize them into subfolders. + +1. First, list all files and their metadata +2. Preview grouping by file extension +3. Create appropriate subfolders (e.g., "images", "documents", "videos") +4. Move each file to its appropriate subfolder + +Please confirm before moving any files. +`, targetFolder) + + if err := session.Send(copilot.MessageOptions{Prompt: prompt}); err != nil { + log.Fatal(err) + } + + session.WaitForIdle() +} +``` + +## Grouping strategies + +### By file extension + +```go +// Groups files like: +// images/ -> .jpg, .png, .gif +// documents/ -> .pdf, .docx, .txt +// videos/ -> .mp4, .avi, .mov +``` + +### By creation date + +```go +// Groups files like: +// 2024-01/ -> files created in January 2024 +// 2024-02/ -> files created in February 2024 +``` + +### By file size + +```go +// Groups files like: +// tiny-under-1kb/ +// small-under-1mb/ +// medium-under-100mb/ +// large-over-100mb/ +``` + +## Dry-run mode + +For safety, you can ask Copilot to only preview changes: + +```go +prompt := fmt.Sprintf(` +Analyze files in "%s" and show me how you would organize them +by file type. DO NOT move any files - just show me the plan. +`, targetFolder) + +session.Send(copilot.MessageOptions{Prompt: prompt}) +``` + +## Custom grouping with AI analysis + +Let Copilot determine the best grouping based on file content: + +```go +prompt := fmt.Sprintf(` +Look at the files in "%s" and suggest a logical organization. +Consider: +- File names and what they might contain +- File types and their typical uses +- Date patterns that might indicate projects or events + +Propose folder names that are descriptive and useful. +`, targetFolder) + +session.Send(copilot.MessageOptions{Prompt: prompt}) +``` + +## Safety considerations + +1. **Confirm before moving**: Ask Copilot to confirm before executing moves +2. **Handle duplicates**: Consider what happens if a file with the same name exists +3. **Preserve originals**: Consider copying instead of moving for important files diff --git a/cookbook/copilot-sdk/go/multiple-sessions.md b/cookbook/copilot-sdk/go/multiple-sessions.md new file mode 100644 index 00000000..66261961 --- /dev/null +++ b/cookbook/copilot-sdk/go/multiple-sessions.md @@ -0,0 +1,107 @@ +# Working with Multiple Sessions + +Manage multiple independent conversations simultaneously. + +> **Runnable example:** [recipe/multiple-sessions.go](recipe/multiple-sessions.go) +> +> ```bash +> go run recipe/multiple-sessions.go +> ``` + +## Example scenario + +You need to run multiple conversations in parallel, each with its own context and history. + +## Go + +```go +package main + +import ( + "fmt" + "log" + "github.com/github/copilot-sdk/go" +) + +func main() { + client := copilot.NewClient() + + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + // Create multiple independent sessions + session1, err := client.CreateSession(copilot.SessionConfig{Model: "gpt-5"}) + if err != nil { + log.Fatal(err) + } + defer session1.Destroy() + + session2, err := client.CreateSession(copilot.SessionConfig{Model: "gpt-5"}) + if err != nil { + log.Fatal(err) + } + defer session2.Destroy() + + session3, err := client.CreateSession(copilot.SessionConfig{Model: "claude-sonnet-4.5"}) + if err != nil { + log.Fatal(err) + } + defer session3.Destroy() + + // Each session maintains its own conversation history + session1.Send(copilot.MessageOptions{Prompt: "You are helping with a Python project"}) + session2.Send(copilot.MessageOptions{Prompt: "You are helping with a TypeScript project"}) + session3.Send(copilot.MessageOptions{Prompt: "You are helping with a Go project"}) + + // Follow-up messages stay in their respective contexts + session1.Send(copilot.MessageOptions{Prompt: "How do I create a virtual environment?"}) + session2.Send(copilot.MessageOptions{Prompt: "How do I set up tsconfig?"}) + session3.Send(copilot.MessageOptions{Prompt: "How do I initialize a module?"}) +} +``` + +## Custom session IDs + +Use custom IDs for easier tracking: + +```go +session, err := client.CreateSession(copilot.SessionConfig{ + SessionID: "user-123-chat", + Model: "gpt-5", +}) +if err != nil { + log.Fatal(err) +} + +fmt.Println(session.SessionID) // "user-123-chat" +``` + +## Listing sessions + +```go +sessions, err := client.ListSessions() +if err != nil { + log.Fatal(err) +} + +for _, sessionInfo := range sessions { + fmt.Printf("Session: %s\n", sessionInfo.SessionID) +} +``` + +## Deleting sessions + +```go +// Delete a specific session +if err := client.DeleteSession("user-123-chat"); err != nil { + log.Printf("Failed to delete session: %v", err) +} +``` + +## Use cases + +- **Multi-user applications**: One session per user +- **Multi-task workflows**: Separate sessions for different tasks +- **A/B testing**: Compare responses from different models diff --git a/cookbook/copilot-sdk/go/persisting-sessions.md b/cookbook/copilot-sdk/go/persisting-sessions.md new file mode 100644 index 00000000..8587b978 --- /dev/null +++ b/cookbook/copilot-sdk/go/persisting-sessions.md @@ -0,0 +1,92 @@ +# Session Persistence and Resumption + +Save and restore conversation sessions across application restarts. + +## Example scenario + +You want users to be able to continue a conversation even after closing and reopening your application. + +> **Runnable example:** [recipe/persisting-sessions.go](recipe/persisting-sessions.go) +> +> ```bash +> cd recipe +> go run persisting-sessions.go +> ``` + +### Creating a session with a custom ID + +```go +package main + +import ( + "fmt" + "github.com/github/copilot-sdk/go" +) + +func main() { + client := copilot.NewClient() + client.Start() + defer client.Stop() + + // Create session with a memorable ID + session, _ := client.CreateSession(copilot.SessionConfig{ + SessionID: "user-123-conversation", + Model: "gpt-5", + }) + + session.Send(copilot.MessageOptions{Prompt: "Let's discuss TypeScript generics"}) + + // Session ID is preserved + fmt.Println(session.SessionID) + + // Destroy session but keep data on disk + session.Destroy() +} +``` + +### Resuming a session + +```go +client := copilot.NewClient() +client.Start() +defer client.Stop() + +// Resume the previous session +session, _ := client.ResumeSession("user-123-conversation") + +// Previous context is restored +session.Send(copilot.MessageOptions{Prompt: "What were we discussing?"}) + +session.Destroy() +``` + +### Listing available sessions + +```go +sessions, _ := client.ListSessions() +for _, s := range sessions { + fmt.Println("Session:", s.SessionID) +} +``` + +### Deleting a session permanently + +```go +// Remove session and all its data from disk +client.DeleteSession("user-123-conversation") +``` + +### Getting session history + +```go +messages, _ := session.GetMessages() +for _, msg := range messages { + fmt.Printf("[%s] %v\n", msg.Type, msg.Data) +} +``` + +## Best practices + +1. **Use meaningful session IDs**: Include user ID or context in the session ID +2. **Handle missing sessions**: Check if a session exists before resuming +3. **Clean up old sessions**: Periodically delete sessions that are no longer needed diff --git a/cookbook/copilot-sdk/go/pr-visualization.md b/cookbook/copilot-sdk/go/pr-visualization.md new file mode 100644 index 00000000..e8046733 --- /dev/null +++ b/cookbook/copilot-sdk/go/pr-visualization.md @@ -0,0 +1,238 @@ +# Generating PR Age Charts + +Build an interactive CLI tool that visualizes pull request age distribution for a GitHub repository using Copilot's built-in capabilities. + +> **Runnable example:** [recipe/pr-visualization.go](recipe/pr-visualization.go) +> +> ```bash +> # Auto-detect from current git repo +> go run recipe/pr-visualization.go +> +> # Specify a repo explicitly +> go run recipe/pr-visualization.go -repo github/copilot-sdk +> ``` + +## Example scenario + +You want to understand how long PRs have been open in a repository. This tool detects the current Git repo or accepts a repo as input, then lets Copilot fetch PR data via the GitHub MCP Server and generate a chart image. + +## Prerequisites + +```bash +go get github.com/github/copilot-sdk/go +``` + +## Usage + +```bash +# Auto-detect from current git repo +go run pr-visualization.go + +# Specify a repo explicitly +go run pr-visualization.go -repo github/copilot-sdk +``` + +## Full example: pr-visualization.go + +```go +package main + +import ( + "bufio" + "flag" + "fmt" + "log" + "os" + "os/exec" + "regexp" + "strings" + "github.com/github/copilot-sdk/go" +) + +// ============================================================================ +// Git & GitHub Detection +// ============================================================================ + +func isGitRepo() bool { + cmd := exec.Command("git", "rev-parse", "--git-dir") + return cmd.Run() == nil +} + +func getGitHubRemote() string { + cmd := exec.Command("git", "remote", "get-url", "origin") + output, err := cmd.Output() + if err != nil { + return "" + } + + remoteURL := strings.TrimSpace(string(output)) + + // Handle SSH: git@github.com:owner/repo.git + sshRe := regexp.MustCompile(`git@github\.com:(.+/.+?)(?:\.git)?$`) + if matches := sshRe.FindStringSubmatch(remoteURL); matches != nil { + return matches[1] + } + + // Handle HTTPS: https://github.com/owner/repo.git + httpsRe := regexp.MustCompile(`https://github\.com/(.+/.+?)(?:\.git)?$`) + if matches := httpsRe.FindStringSubmatch(remoteURL); matches != nil { + return matches[1] + } + + return "" +} + +func promptForRepo() string { + reader := bufio.NewReader(os.Stdin) + fmt.Print("Enter GitHub repo (owner/repo): ") + repo, _ := reader.ReadString('\n') + return strings.TrimSpace(repo) +} + +// ============================================================================ +// Main Application +// ============================================================================ + +func main() { + repoFlag := flag.String("repo", "", "GitHub repository (owner/repo)") + flag.Parse() + + fmt.Println("🔍 PR Age Chart Generator\n") + + // Determine the repository + var repo string + + if *repoFlag != "" { + repo = *repoFlag + fmt.Printf("📦 Using specified repo: %s\n", repo) + } else if isGitRepo() { + detected := getGitHubRemote() + if detected != "" { + repo = detected + fmt.Printf("📦 Detected GitHub repo: %s\n", repo) + } else { + fmt.Println("⚠️ Git repo found but no GitHub remote detected.") + repo = promptForRepo() + } + } else { + fmt.Println("📁 Not in a git repository.") + repo = promptForRepo() + } + + if repo == "" || !strings.Contains(repo, "/") { + log.Fatal("❌ Invalid repo format. Expected: owner/repo") + } + + parts := strings.SplitN(repo, "/", 2) + owner, repoName := parts[0], parts[1] + + // Create Copilot client - no custom tools needed! + client := copilot.NewClient(copilot.ClientConfig{LogLevel: "error"}) + + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + cwd, _ := os.Getwd() + session, err := client.CreateSession(copilot.SessionConfig{ + Model: "gpt-5", + SystemMessage: copilot.SystemMessage{ + Content: fmt.Sprintf(` + +You are analyzing pull requests for the GitHub repository: %s/%s +The current working directory is: %s + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +`, owner, repoName, cwd), + }, + }) + if err != nil { + log.Fatal(err) + } + defer session.Destroy() + + // Set up event handling + session.On(func(event copilot.Event) { + switch e := event.(type) { + case copilot.AssistantMessageEvent: + fmt.Printf("\n🤖 %s\n\n", e.Data.Content) + case copilot.ToolExecutionStartEvent: + fmt.Printf(" ⚙️ %s\n", e.Data.ToolName) + } + }) + + // Initial prompt - let Copilot figure out the details + fmt.Println("\n📊 Starting analysis...\n") + + prompt := fmt.Sprintf(` + Fetch the open pull requests for %s/%s from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + `, owner, repoName) + + if err := session.Send(copilot.MessageOptions{Prompt: prompt}); err != nil { + log.Fatal(err) + } + + session.WaitForIdle() + + // Interactive loop + fmt.Println("\n💡 Ask follow-up questions or type \"exit\" to quit.\n") + fmt.Println("Examples:") + fmt.Println(" - \"Expand to the last month\"") + fmt.Println(" - \"Show me the 5 oldest PRs\"") + fmt.Println(" - \"Generate a pie chart instead\"") + fmt.Println(" - \"Group by author instead of age\"") + fmt.Println() + + reader := bufio.NewReader(os.Stdin) + for { + fmt.Print("You: ") + input, _ := reader.ReadString('\n') + input = strings.TrimSpace(input) + + if input == "" { + continue + } + if strings.ToLower(input) == "exit" || strings.ToLower(input) == "quit" { + fmt.Println("👋 Goodbye!") + break + } + + if err := session.Send(copilot.MessageOptions{Prompt: input}); err != nil { + log.Printf("Error: %v", err) + } + + session.WaitForIdle() + } +} +``` + +## How it works + +1. **Repository detection**: Checks `--repo` flag → git remote → prompts user +2. **No custom tools**: Relies entirely on Copilot CLI's built-in capabilities: + - **GitHub MCP Server** - Fetches PR data from GitHub + - **File tools** - Saves generated chart images + - **Code execution** - Generates charts using Python/matplotlib or other methods +3. **Interactive session**: After initial analysis, user can ask for adjustments + +## Why this approach? + +| Aspect | Custom Tools | Built-in Copilot | +| --------------- | ----------------- | --------------------------------- | +| Code complexity | High | **Minimal** | +| Maintenance | You maintain | **Copilot maintains** | +| Flexibility | Fixed logic | **AI decides best approach** | +| Chart types | What you coded | **Any type Copilot can generate** | +| Data grouping | Hardcoded buckets | **Intelligent grouping** | diff --git a/cookbook/copilot-sdk/go/recipe/README.md b/cookbook/copilot-sdk/go/recipe/README.md new file mode 100644 index 00000000..5622bdd7 --- /dev/null +++ b/cookbook/copilot-sdk/go/recipe/README.md @@ -0,0 +1,61 @@ +# Runnable Recipe Examples + +This folder contains standalone, executable Go examples for each cookbook recipe. Each file is a complete program that can be run directly with `go run`. + +## Prerequisites + +- Go 1.21 or later +- GitHub Copilot SDK for Go + +```bash +go get github.com/github/copilot-sdk/go +``` + +## Running Examples + +Each `.go` file is a complete, runnable program. Simply use: + +```bash +go run .go +``` + +### Available Recipes + +| Recipe | Command | Description | +| -------------------- | -------------------------------- | ------------------------------------------ | +| Error Handling | `go run error-handling.go` | Demonstrates error handling patterns | +| Multiple Sessions | `go run multiple-sessions.go` | Manages multiple independent conversations | +| Managing Local Files | `go run managing-local-files.go` | Organizes files using AI grouping | +| PR Visualization | `go run pr-visualization.go` | Generates PR age charts | +| Persisting Sessions | `go run persisting-sessions.go` | Save and resume sessions across restarts | + +### Examples with Arguments + +**PR Visualization with specific repo:** + +```bash +go run pr-visualization.go -repo github/copilot-sdk +``` + +**Managing Local Files (edit the file to change target folder):** + +```bash +# Edit the targetFolder variable in managing-local-files.go first +go run managing-local-files.go +``` + +## Go Best Practices + +These examples follow Go conventions: + +- Proper error handling with explicit checks +- Use of `defer` for cleanup +- Idiomatic naming (camelCase for local variables) +- Standard library usage where appropriate +- Clean separation of concerns + +## Learning Resources + +- [Go Documentation](https://go.dev/doc/) +- [GitHub Copilot SDK for Go](https://github.com/github/copilot-sdk/blob/main/go/README.md) +- [Parent Cookbook](../README.md) diff --git a/cookbook/copilot-sdk/go/recipe/error-handling.go b/cookbook/copilot-sdk/go/recipe/error-handling.go new file mode 100644 index 00000000..32edd9f9 --- /dev/null +++ b/cookbook/copilot-sdk/go/recipe/error-handling.go @@ -0,0 +1,44 @@ +package main + +import ( + "fmt" + "log" + + "github.com/github/copilot-sdk/go" +) + +func main() { + client := copilot.NewClient() + + if err := client.Start(); err != nil { + log.Fatalf("Failed to start client: %v", err) + } + defer func() { + if err := client.Stop(); err != nil { + log.Printf("Error stopping client: %v", err) + } + }() + + session, err := client.CreateSession(copilot.SessionConfig{ + Model: "gpt-5", + }) + if err != nil { + log.Fatalf("Failed to create session: %v", err) + } + defer session.Destroy() + + responseChan := make(chan string, 1) + session.On(func(event copilot.Event) { + if msg, ok := event.(copilot.AssistantMessageEvent); ok { + responseChan <- msg.Data.Content + } + }) + + if err := session.Send(copilot.MessageOptions{Prompt: "Hello!"}); err != nil { + log.Printf("Failed to send message: %v", err) + return + } + + response := <-responseChan + fmt.Println(response) +} diff --git a/cookbook/copilot-sdk/go/recipe/managing-local-files.go b/cookbook/copilot-sdk/go/recipe/managing-local-files.go new file mode 100644 index 00000000..f1582669 --- /dev/null +++ b/cookbook/copilot-sdk/go/recipe/managing-local-files.go @@ -0,0 +1,62 @@ +package main + +import ( + "fmt" + "log" + "os" + "path/filepath" + + "github.com/github/copilot-sdk/go" +) + +func main() { + // Create and start client + client := copilot.NewClient() + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + // Create session + session, err := client.CreateSession(copilot.SessionConfig{ + Model: "gpt-5", + }) + if err != nil { + log.Fatal(err) + } + defer session.Destroy() + + // Event handler + session.On(func(event copilot.Event) { + switch e := event.(type) { + case copilot.AssistantMessageEvent: + fmt.Printf("\nCopilot: %s\n", e.Data.Content) + case copilot.ToolExecutionStartEvent: + fmt.Printf(" → Running: %s\n", e.Data.ToolName) + case copilot.ToolExecutionCompleteEvent: + fmt.Printf(" ✓ Completed: %s\n", e.Data.ToolName) + } + }) + + // Ask Copilot to organize files + // Change this to your target folder + homeDir, _ := os.UserHomeDir() + targetFolder := filepath.Join(homeDir, "Downloads") + + prompt := fmt.Sprintf(` +Analyze the files in "%s" and organize them into subfolders. + +1. First, list all files and their metadata +2. Preview grouping by file extension +3. Create appropriate subfolders (e.g., "images", "documents", "videos") +4. Move each file to its appropriate subfolder + +Please confirm before moving any files. +`, targetFolder) + + if err := session.Send(copilot.MessageOptions{Prompt: prompt}); err != nil { + log.Fatal(err) + } + + session.WaitForIdle() +} diff --git a/cookbook/copilot-sdk/go/recipe/multiple-sessions.go b/cookbook/copilot-sdk/go/recipe/multiple-sessions.go new file mode 100644 index 00000000..0fb3325c --- /dev/null +++ b/cookbook/copilot-sdk/go/recipe/multiple-sessions.go @@ -0,0 +1,53 @@ +package main + +import ( + "fmt" + "log" + + "github.com/github/copilot-sdk/go" +) + +func main() { + client := copilot.NewClient() + + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + // Create multiple independent sessions + session1, err := client.CreateSession(copilot.SessionConfig{Model: "gpt-5"}) + if err != nil { + log.Fatal(err) + } + defer session1.Destroy() + + session2, err := client.CreateSession(copilot.SessionConfig{Model: "gpt-5"}) + if err != nil { + log.Fatal(err) + } + defer session2.Destroy() + + session3, err := client.CreateSession(copilot.SessionConfig{Model: "claude-sonnet-4.5"}) + if err != nil { + log.Fatal(err) + } + defer session3.Destroy() + + fmt.Println("Created 3 independent sessions") + + // Each session maintains its own conversation history + session1.Send(copilot.MessageOptions{Prompt: "You are helping with a Python project"}) + session2.Send(copilot.MessageOptions{Prompt: "You are helping with a TypeScript project"}) + session3.Send(copilot.MessageOptions{Prompt: "You are helping with a Go project"}) + + fmt.Println("Sent initial context to all sessions") + + // Follow-up messages stay in their respective contexts + session1.Send(copilot.MessageOptions{Prompt: "How do I create a virtual environment?"}) + session2.Send(copilot.MessageOptions{Prompt: "How do I set up tsconfig?"}) + session3.Send(copilot.MessageOptions{Prompt: "How do I initialize a module?"}) + + fmt.Println("Sent follow-up questions to each session") + fmt.Println("All sessions will be destroyed on exit") +} diff --git a/cookbook/copilot-sdk/go/recipe/persisting-sessions.go b/cookbook/copilot-sdk/go/recipe/persisting-sessions.go new file mode 100644 index 00000000..11ee7ad0 --- /dev/null +++ b/cookbook/copilot-sdk/go/recipe/persisting-sessions.go @@ -0,0 +1,68 @@ +package main + +import ( + "fmt" + "log" + + "github.com/github/copilot-sdk/go" +) + +func main() { + client := copilot.NewClient() + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + // Create session with a memorable ID + session, err := client.CreateSession(copilot.SessionConfig{ + SessionID: "user-123-conversation", + Model: "gpt-5", + }) + if err != nil { + log.Fatal(err) + } + + if err := session.Send(copilot.MessageOptions{Prompt: "Let's discuss TypeScript generics"}); err != nil { + log.Fatal(err) + } + fmt.Printf("Session created: %s\n", session.SessionID) + + // Destroy session but keep data on disk + if err := session.Destroy(); err != nil { + log.Fatal(err) + } + fmt.Println("Session destroyed (state persisted)") + + // Resume the previous session + resumed, err := client.ResumeSession("user-123-conversation") + if err != nil { + log.Fatal(err) + } + fmt.Printf("Resumed: %s\n", resumed.SessionID) + + if err := resumed.Send(copilot.MessageOptions{Prompt: "What were we discussing?"}); err != nil { + log.Fatal(err) + } + + // List sessions + sessions, err := client.ListSessions() + if err != nil { + log.Fatal(err) + } + ids := make([]string, 0, len(sessions)) + for _, s := range sessions { + ids = append(ids, s.SessionID) + } + fmt.Printf("Sessions: %v\n", ids) + + // Delete session permanently + if err := client.DeleteSession("user-123-conversation"); err != nil { + log.Fatal(err) + } + fmt.Println("Session deleted") + + if err := resumed.Destroy(); err != nil { + log.Fatal(err) + } +} diff --git a/cookbook/copilot-sdk/go/recipe/pr-visualization.go b/cookbook/copilot-sdk/go/recipe/pr-visualization.go new file mode 100644 index 00000000..abea027b --- /dev/null +++ b/cookbook/copilot-sdk/go/recipe/pr-visualization.go @@ -0,0 +1,182 @@ +package main + +import ( + "bufio" + "flag" + "fmt" + "log" + "os" + "os/exec" + "regexp" + "strings" + + "github.com/github/copilot-sdk/go" +) + +// ============================================================================ +// Git & GitHub Detection +// ============================================================================ + +func isGitRepo() bool { + cmd := exec.Command("git", "rev-parse", "--git-dir") + return cmd.Run() == nil +} + +func getGitHubRemote() string { + cmd := exec.Command("git", "remote", "get-url", "origin") + output, err := cmd.Output() + if err != nil { + return "" + } + + remoteURL := strings.TrimSpace(string(output)) + + // Handle SSH: git@github.com:owner/repo.git + sshRe := regexp.MustCompile(`git@github\.com:(.+/.+?)(?:\.git)?$`) + if matches := sshRe.FindStringSubmatch(remoteURL); matches != nil { + return matches[1] + } + + // Handle HTTPS: https://github.com/owner/repo.git + httpsRe := regexp.MustCompile(`https://github\.com/(.+/.+?)(?:\.git)?$`) + if matches := httpsRe.FindStringSubmatch(remoteURL); matches != nil { + return matches[1] + } + + return "" +} + +func promptForRepo() string { + reader := bufio.NewReader(os.Stdin) + fmt.Print("Enter GitHub repo (owner/repo): ") + repo, _ := reader.ReadString('\n') + return strings.TrimSpace(repo) +} + +// ============================================================================ +// Main Application +// ============================================================================ + +func main() { + repoFlag := flag.String("repo", "", "GitHub repository (owner/repo)") + flag.Parse() + + fmt.Println("🔍 PR Age Chart Generator\n") + + // Determine the repository + var repo string + + if *repoFlag != "" { + repo = *repoFlag + fmt.Printf("📦 Using specified repo: %s\n", repo) + } else if isGitRepo() { + detected := getGitHubRemote() + if detected != "" { + repo = detected + fmt.Printf("📦 Detected GitHub repo: %s\n", repo) + } else { + fmt.Println("⚠️ Git repo found but no GitHub remote detected.") + repo = promptForRepo() + } + } else { + fmt.Println("📁 Not in a git repository.") + repo = promptForRepo() + } + + if repo == "" || !strings.Contains(repo, "/") { + log.Fatal("❌ Invalid repo format. Expected: owner/repo") + } + + parts := strings.SplitN(repo, "/", 2) + owner, repoName := parts[0], parts[1] + + // Create Copilot client - no custom tools needed! + client := copilot.NewClient(copilot.ClientConfig{LogLevel: "error"}) + + if err := client.Start(); err != nil { + log.Fatal(err) + } + defer client.Stop() + + cwd, _ := os.Getwd() + session, err := client.CreateSession(copilot.SessionConfig{ + Model: "gpt-5", + SystemMessage: copilot.SystemMessage{ + Content: fmt.Sprintf(` + +You are analyzing pull requests for the GitHub repository: %s/%s +The current working directory is: %s + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +`, owner, repoName, cwd), + }, + }) + if err != nil { + log.Fatal(err) + } + defer session.Destroy() + + // Set up event handling + session.On(func(event copilot.Event) { + switch e := event.(type) { + case copilot.AssistantMessageEvent: + fmt.Printf("\n🤖 %s\n\n", e.Data.Content) + case copilot.ToolExecutionStartEvent: + fmt.Printf(" ⚙️ %s\n", e.Data.ToolName) + } + }) + + // Initial prompt - let Copilot figure out the details + fmt.Println("\n📊 Starting analysis...\n") + + prompt := fmt.Sprintf(` + Fetch the open pull requests for %s/%s from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + `, owner, repoName) + + if err := session.Send(copilot.MessageOptions{Prompt: prompt}); err != nil { + log.Fatal(err) + } + + session.WaitForIdle() + + // Interactive loop + fmt.Println("\n💡 Ask follow-up questions or type \"exit\" to quit.\n") + fmt.Println("Examples:") + fmt.Println(" - \"Expand to the last month\"") + fmt.Println(" - \"Show me the 5 oldest PRs\"") + fmt.Println(" - \"Generate a pie chart instead\"") + fmt.Println(" - \"Group by author instead of age\"") + fmt.Println() + + reader := bufio.NewReader(os.Stdin) + for { + fmt.Print("You: ") + input, _ := reader.ReadString('\n') + input = strings.TrimSpace(input) + + if input == "" { + continue + } + if strings.ToLower(input) == "exit" || strings.ToLower(input) == "quit" { + fmt.Println("👋 Goodbye!") + break + } + + if err := session.Send(copilot.MessageOptions{Prompt: input}); err != nil { + log.Printf("Error: %v", err) + } + + session.WaitForIdle() + } +} diff --git a/cookbook/copilot-sdk/nodejs/README.md b/cookbook/copilot-sdk/nodejs/README.md new file mode 100644 index 00000000..0e419476 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/README.md @@ -0,0 +1,19 @@ +# GitHub Copilot SDK Cookbook — Node.js / TypeScript + +This folder hosts short, practical recipes for using the GitHub Copilot SDK with Node.js/TypeScript. Each recipe is concise, copy‑pasteable, and points to fuller examples and tests. + +## Recipes + +- [Error Handling](error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](persisting-sessions.md): Save and resume sessions across restarts. + +## Contributing + +Add a new recipe by creating a markdown file in this folder and linking it above. Follow repository guidance in [CONTRIBUTING.md](../../../CONTRIBUTING.md). + +## Status + +This README is a scaffold; recipe files are placeholders until populated. diff --git a/cookbook/copilot-sdk/nodejs/error-handling.md b/cookbook/copilot-sdk/nodejs/error-handling.md new file mode 100644 index 00000000..a6679502 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/error-handling.md @@ -0,0 +1,129 @@ +# Error Handling Patterns + +Handle errors gracefully in your Copilot SDK applications. + +> **Runnable example:** [recipe/error-handling.ts](recipe/error-handling.ts) +> +> ```bash +> cd recipe && npm install +> npx tsx error-handling.ts +> # or: npm run error-handling +> ``` + +## Example scenario + +You need to handle various error conditions like connection failures, timeouts, and invalid responses. + +## Basic try-catch + +```typescript +import { CopilotClient } from "@github/copilot-sdk"; + +const client = new CopilotClient(); + +try { + await client.start(); + const session = await client.createSession({ model: "gpt-5" }); + + const response = await session.sendAndWait({ prompt: "Hello!" }); + console.log(response?.data.content); + + await session.destroy(); +} catch (error) { + console.error("Error:", error.message); +} finally { + await client.stop(); +} +``` + +## Handling specific error types + +```typescript +try { + await client.start(); +} catch (error) { + if (error.message.includes("ENOENT")) { + console.error("Copilot CLI not found. Please install it first."); + } else if (error.message.includes("ECONNREFUSED")) { + console.error("Could not connect to Copilot CLI server."); + } else { + console.error("Unexpected error:", error.message); + } +} +``` + +## Timeout handling + +```typescript +const session = await client.createSession({ model: "gpt-5" }); + +try { + // sendAndWait with timeout (in milliseconds) + const response = await session.sendAndWait( + { prompt: "Complex question..." }, + 30000 // 30 second timeout + ); + + if (response) { + console.log(response.data.content); + } else { + console.log("No response received"); + } +} catch (error) { + if (error.message.includes("timeout")) { + console.error("Request timed out"); + } +} +``` + +## Aborting a request + +```typescript +const session = await client.createSession({ model: "gpt-5" }); + +// Start a request +session.send({ prompt: "Write a very long story..." }); + +// Abort it after some condition +setTimeout(async () => { + await session.abort(); + console.log("Request aborted"); +}, 5000); +``` + +## Graceful shutdown + +```typescript +process.on("SIGINT", async () => { + console.log("Shutting down..."); + + const errors = await client.stop(); + if (errors.length > 0) { + console.error("Cleanup errors:", errors); + } + + process.exit(0); +}); +``` + +## Force stop + +```typescript +// If stop() takes too long, force stop +const stopPromise = client.stop(); +const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error("Timeout")), 5000)); + +try { + await Promise.race([stopPromise, timeout]); +} catch { + console.log("Forcing stop..."); + await client.forceStop(); +} +``` + +## Best practices + +1. **Always clean up**: Use try-finally to ensure `client.stop()` is called +2. **Handle connection errors**: The CLI might not be installed or running +3. **Set appropriate timeouts**: Long-running requests should have timeouts +4. **Log errors**: Capture error details for debugging diff --git a/cookbook/copilot-sdk/nodejs/managing-local-files.md b/cookbook/copilot-sdk/nodejs/managing-local-files.md new file mode 100644 index 00000000..d1f02e2a --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/managing-local-files.md @@ -0,0 +1,132 @@ +# Grouping Files by Metadata + +Use Copilot to intelligently organize files in a folder based on their metadata. + +> **Runnable example:** [recipe/managing-local-files.ts](recipe/managing-local-files.ts) +> +> ```bash +> cd recipe && npm install +> npx tsx managing-local-files.ts +> # or: npm run managing-local-files +> ``` + +## Example scenario + +You have a folder with many files and want to organize them into subfolders based on metadata like file type, creation date, size, or other attributes. Copilot can analyze the files and suggest or execute a grouping strategy. + +## Example code + +```typescript +import { CopilotClient } from "@github/copilot-sdk"; +import * as os from "node:os"; +import * as path from "node:path"; + +// Create and start client +const client = new CopilotClient(); +await client.start(); + +// Create session +const session = await client.createSession({ + model: "gpt-5", +}); + +// Event handler +session.on((event) => { + switch (event.type) { + case "assistant.message": + console.log(`\nCopilot: ${event.data.content}`); + break; + case "tool.execution_start": + console.log(` → Running: ${event.data.toolName} ${event.data.toolCallId}`); + break; + case "tool.execution_complete": + console.log(` ✓ Completed: ${event.data.toolCallId}`); + break; + } +}); + +// Ask Copilot to organize files +const targetFolder = path.join(os.homedir(), "Downloads"); + +await session.sendAndWait({ + prompt: ` +Analyze the files in "${targetFolder}" and organize them into subfolders. + +1. First, list all files and their metadata +2. Preview grouping by file extension +3. Create appropriate subfolders (e.g., "images", "documents", "videos") +4. Move each file to its appropriate subfolder + +Please confirm before moving any files. +`, +}); + +await session.destroy(); +await client.stop(); +``` + +## Grouping strategies + +### By file extension + +```typescript +// Groups files like: +// images/ -> .jpg, .png, .gif +// documents/ -> .pdf, .docx, .txt +// videos/ -> .mp4, .avi, .mov +``` + +### By creation date + +```typescript +// Groups files like: +// 2024-01/ -> files created in January 2024 +// 2024-02/ -> files created in February 2024 +``` + +### By file size + +```typescript +// Groups files like: +// tiny-under-1kb/ +// small-under-1mb/ +// medium-under-100mb/ +// large-over-100mb/ +``` + +## Dry-run mode + +For safety, you can ask Copilot to only preview changes: + +```typescript +await session.sendAndWait({ + prompt: ` +Analyze files in "${targetFolder}" and show me how you would organize them +by file type. DO NOT move any files - just show me the plan. +`, +}); +``` + +## Custom grouping with AI analysis + +Let Copilot determine the best grouping based on file content: + +```typescript +await session.sendAndWait({ + prompt: ` +Look at the files in "${targetFolder}" and suggest a logical organization. +Consider: +- File names and what they might contain +- File types and their typical uses +- Date patterns that might indicate projects or events + +Propose folder names that are descriptive and useful. +`, +}); +``` + +## Safety considerations + +1. **Confirm before moving**: Ask Copilot to confirm before executing moves +2. **Handle duplicates**: Consider what happens if a file with the same name exists +3. **Preserve originals**: Consider copying instead of moving for important files diff --git a/cookbook/copilot-sdk/nodejs/multiple-sessions.md b/cookbook/copilot-sdk/nodejs/multiple-sessions.md new file mode 100644 index 00000000..f1c7543a --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/multiple-sessions.md @@ -0,0 +1,79 @@ +# Working with Multiple Sessions + +Manage multiple independent conversations simultaneously. + +> **Runnable example:** [recipe/multiple-sessions.ts](recipe/multiple-sessions.ts) +> +> ```bash +> cd recipe && npm install +> npx tsx multiple-sessions.ts +> # or: npm run multiple-sessions +> ``` + +## Example scenario + +You need to run multiple conversations in parallel, each with its own context and history. + +## Node.js + +```typescript +import { CopilotClient } from "@github/copilot-sdk"; + +const client = new CopilotClient(); +await client.start(); + +// Create multiple independent sessions +const session1 = await client.createSession({ model: "gpt-5" }); +const session2 = await client.createSession({ model: "gpt-5" }); +const session3 = await client.createSession({ model: "claude-sonnet-4.5" }); + +// Each session maintains its own conversation history +await session1.sendAndWait({ prompt: "You are helping with a Python project" }); +await session2.sendAndWait({ prompt: "You are helping with a TypeScript project" }); +await session3.sendAndWait({ prompt: "You are helping with a Go project" }); + +// Follow-up messages stay in their respective contexts +await session1.sendAndWait({ prompt: "How do I create a virtual environment?" }); +await session2.sendAndWait({ prompt: "How do I set up tsconfig?" }); +await session3.sendAndWait({ prompt: "How do I initialize a module?" }); + +// Clean up all sessions +await session1.destroy(); +await session2.destroy(); +await session3.destroy(); +await client.stop(); +``` + +## Custom session IDs + +Use custom IDs for easier tracking: + +```typescript +const session = await client.createSession({ + sessionId: "user-123-chat", + model: "gpt-5", +}); + +console.log(session.sessionId); // "user-123-chat" +``` + +## Listing sessions + +```typescript +const sessions = await client.listSessions(); +console.log(sessions); +// [{ sessionId: "user-123-chat", ... }, ...] +``` + +## Deleting sessions + +```typescript +// Delete a specific session +await client.deleteSession("user-123-chat"); +``` + +## Use cases + +- **Multi-user applications**: One session per user +- **Multi-task workflows**: Separate sessions for different tasks +- **A/B testing**: Compare responses from different models diff --git a/cookbook/copilot-sdk/nodejs/persisting-sessions.md b/cookbook/copilot-sdk/nodejs/persisting-sessions.md new file mode 100644 index 00000000..ccb7b591 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/persisting-sessions.md @@ -0,0 +1,91 @@ +# Session Persistence and Resumption + +Save and restore conversation sessions across application restarts. + +## Example scenario + +You want users to be able to continue a conversation even after closing and reopening your application. + +> **Runnable example:** [recipe/persisting-sessions.ts](recipe/persisting-sessions.ts) +> +> ```bash +> cd recipe && npm install +> npx tsx persisting-sessions.ts +> # or: npm run persisting-sessions +> ``` + +### Creating a session with a custom ID + +```typescript +import { CopilotClient } from "@github/copilot-sdk"; + +const client = new CopilotClient(); +await client.start(); + +// Create session with a memorable ID +const session = await client.createSession({ + sessionId: "user-123-conversation", + model: "gpt-5", +}); + +await session.sendAndWait({ prompt: "Let's discuss TypeScript generics" }); + +// Session ID is preserved +console.log(session.sessionId); // "user-123-conversation" + +// Destroy session but keep data on disk +await session.destroy(); +await client.stop(); +``` + +### Resuming a session + +```typescript +const client = new CopilotClient(); +await client.start(); + +// Resume the previous session +const session = await client.resumeSession("user-123-conversation"); + +// Previous context is restored +await session.sendAndWait({ prompt: "What were we discussing?" }); +// AI remembers the TypeScript generics discussion + +await session.destroy(); +await client.stop(); +``` + +### Listing available sessions + +```typescript +const sessions = await client.listSessions(); +console.log(sessions); +// [ +// { sessionId: "user-123-conversation", ... }, +// { sessionId: "user-456-conversation", ... }, +// ] +``` + +### Deleting a session permanently + +```typescript +// Remove session and all its data from disk +await client.deleteSession("user-123-conversation"); +``` + +## Getting session history + +Retrieve all messages from a session: + +```typescript +const messages = await session.getMessages(); +for (const msg of messages) { + console.log(`[${msg.type}]`, msg.data); +} +``` + +## Best practices + +1. **Use meaningful session IDs**: Include user ID or context in the session ID +2. **Handle missing sessions**: Check if a session exists before resuming +3. **Clean up old sessions**: Periodically delete sessions that are no longer needed diff --git a/cookbook/copilot-sdk/nodejs/pr-visualization.md b/cookbook/copilot-sdk/nodejs/pr-visualization.md new file mode 100644 index 00000000..1dba238a --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/pr-visualization.md @@ -0,0 +1,292 @@ +# Generating PR Age Charts + +Build an interactive CLI tool that visualizes pull request age distribution for a GitHub repository using Copilot's built-in capabilities. + +> **Runnable example:** [recipe/pr-visualization.ts](recipe/pr-visualization.ts) +> +> ```bash +> cd recipe && npm install +> # Auto-detect from current git repo +> npx tsx pr-visualization.ts +> +> # Specify a repo explicitly +> npx tsx pr-visualization.ts --repo github/copilot-sdk +> # or: npm run pr-visualization +> ``` + +## Example scenario + +You want to understand how long PRs have been open in a repository. This tool detects the current Git repo or accepts a repo as input, then lets Copilot fetch PR data via the GitHub MCP Server and generate a chart image. + +## Prerequisites + +```bash +npm install @github/copilot-sdk +npm install -D typescript tsx @types/node +``` + +## Usage + +```bash +# Auto-detect from current git repo +npx tsx pr-visualization.ts + +# Specify a repo explicitly +npx tsx pr-visualization.ts --repo github/copilot-sdk +``` + +## Full example: pr-visualization.ts + +```typescript +#!/usr/bin/env npx tsx + +import { execSync } from "node:child_process"; +import * as readline from "node:readline"; +import { CopilotClient } from "@github/copilot-sdk"; + +// ============================================================================ +// Git & GitHub Detection +// ============================================================================ + +function isGitRepo(): boolean { + try { + execSync("git rev-parse --git-dir", { stdio: "ignore" }); + return true; + } catch { + return false; + } +} + +function getGitHubRemote(): string | null { + try { + const remoteUrl = execSync("git remote get-url origin", { + encoding: "utf-8", + }).trim(); + + // Handle SSH: git@github.com:owner/repo.git + const sshMatch = remoteUrl.match(/git@github\.com:(.+\/.+?)(?:\.git)?$/); + if (sshMatch) return sshMatch[1]; + + // Handle HTTPS: https://github.com/owner/repo.git + const httpsMatch = remoteUrl.match(/https:\/\/github\.com\/(.+\/.+?)(?:\.git)?$/); + if (httpsMatch) return httpsMatch[1]; + + return null; + } catch { + return null; + } +} + +function parseArgs(): { repo?: string } { + const args = process.argv.slice(2); + const repoIndex = args.indexOf("--repo"); + if (repoIndex !== -1 && args[repoIndex + 1]) { + return { repo: args[repoIndex + 1] }; + } + return {}; +} + +async function promptForRepo(): Promise { + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); + return new Promise((resolve) => { + rl.question("Enter GitHub repo (owner/repo): ", (answer) => { + rl.close(); + resolve(answer.trim()); + }); + }); +} + +// ============================================================================ +// Main Application +// ============================================================================ + +async function main() { + console.log("🔍 PR Age Chart Generator\n"); + + // Determine the repository + const args = parseArgs(); + let repo: string; + + if (args.repo) { + repo = args.repo; + console.log(`📦 Using specified repo: ${repo}`); + } else if (isGitRepo()) { + const detected = getGitHubRemote(); + if (detected) { + repo = detected; + console.log(`📦 Detected GitHub repo: ${repo}`); + } else { + console.log("⚠️ Git repo found but no GitHub remote detected."); + repo = await promptForRepo(); + } + } else { + console.log("📁 Not in a git repository."); + repo = await promptForRepo(); + } + + if (!repo || !repo.includes("/")) { + console.error("❌ Invalid repo format. Expected: owner/repo"); + process.exit(1); + } + + const [owner, repoName] = repo.split("/"); + + // Create Copilot client - no custom tools needed! + const client = new CopilotClient({ logLevel: "error" }); + + const session = await client.createSession({ + model: "gpt-5", + systemMessage: { + content: ` + +You are analyzing pull requests for the GitHub repository: ${owner}/${repoName} +The current working directory is: ${process.cwd()} + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +`, + }, + }); + + // Set up event handling + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); + + session.on((event) => { + if (event.type === "assistant.message") { + console.log(`\n🤖 ${event.data.content}\n`); + } else if (event.type === "tool.execution_start") { + console.log(` ⚙️ ${event.data.toolName}`); + } + }); + + // Initial prompt - let Copilot figure out the details + console.log("\n📊 Starting analysis...\n"); + + await session.sendAndWait({ + prompt: ` + Fetch the open pull requests for ${owner}/${repoName} from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + `, + }); + + // Interactive loop + const askQuestion = () => { + rl.question("You: ", async (input) => { + const trimmed = input.trim(); + + if (trimmed.toLowerCase() === "exit" || trimmed.toLowerCase() === "quit") { + console.log("👋 Goodbye!"); + rl.close(); + await session.destroy(); + await client.stop(); + process.exit(0); + } + + if (trimmed) { + await session.sendAndWait({ prompt: trimmed }); + } + + askQuestion(); + }); + }; + + console.log('💡 Ask follow-up questions or type "exit" to quit.\n'); + console.log("Examples:"); + console.log(' - "Expand to the last month"'); + console.log(' - "Show me the 5 oldest PRs"'); + console.log(' - "Generate a pie chart instead"'); + console.log(' - "Group by author instead of age"'); + console.log(""); + + askQuestion(); +} + +main().catch(console.error); +``` + +## How it works + +1. **Repository detection**: Checks `--repo` flag → git remote → prompts user +2. **No custom tools**: Relies entirely on Copilot CLI's built-in capabilities: + - **GitHub MCP Server** - Fetches PR data from GitHub + - **File tools** - Saves generated chart images + - **Code execution** - Generates charts using Python/matplotlib or other methods +3. **Interactive session**: After initial analysis, user can ask for adjustments + +## Sample interaction + +``` +🔍 PR Age Chart Generator + +📦 Using specified repo: CommunityToolkit/Aspire + +📊 Starting analysis... + + ⚙️ github-mcp-server-list_pull_requests + ⚙️ powershell + +🤖 I've analyzed 23 open PRs for CommunityToolkit/Aspire: + +**PR Age Distribution:** +- < 1 day: 3 PRs +- 1-3 days: 5 PRs +- 3-7 days: 8 PRs +- 1-2 weeks: 4 PRs +- > 2 weeks: 3 PRs + +**Summary:** +- Average age: 6.2 days +- Oldest: PR #142 (18 days) - "Add Redis caching support" +- Potentially stale (>7 days): 7 PRs + +Chart saved to: pr-age-chart.png + +💡 Ask follow-up questions or type "exit" to quit. + +You: Expand to the last month and show by author + + ⚙️ github-mcp-server-list_pull_requests + ⚙️ powershell + +🤖 Updated analysis for the last 30 days, grouped by author: + +| Author | Open PRs | Avg Age | +|---------------|----------|---------| +| @contributor1 | 5 | 12 days | +| @contributor2 | 3 | 4 days | +| @contributor3 | 2 | 8 days | +| ... | | | + +New chart saved to: pr-age-chart.png + +You: Generate a pie chart showing the age distribution + + ⚙️ powershell + +🤖 Done! Pie chart saved to: pr-age-chart.png +``` + +## Why this approach? + +| Aspect | Custom Tools | Built-in Copilot | +| --------------- | ----------------- | --------------------------------- | +| Code complexity | High | **Minimal** | +| Maintenance | You maintain | **Copilot maintains** | +| Flexibility | Fixed logic | **AI decides best approach** | +| Chart types | What you coded | **Any type Copilot can generate** | +| Data grouping | Hardcoded buckets | **Intelligent grouping** | diff --git a/cookbook/copilot-sdk/nodejs/recipe/README.md b/cookbook/copilot-sdk/nodejs/recipe/README.md new file mode 100644 index 00000000..6ad74391 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/README.md @@ -0,0 +1,84 @@ +# Runnable Recipe Examples + +This folder contains standalone, executable TypeScript examples for each cookbook recipe. Each file can be run directly with `tsx` or via npm scripts. + +## Prerequisites + +- Node.js 18 or later +- Install dependencies (this links to the local SDK in the repo): + +```bash +npm install +``` + +## Running Examples + +Each `.ts` file is a complete, runnable program. You can run them in two ways: + +### Using npm scripts: + +```bash +npm run +``` + +### Using tsx directly: + +```bash +npx tsx .ts +``` + +### Available Recipes + +| Recipe | npm script | Direct command | Description | +| -------------------- | ------------------------------ | --------------------------------- | ------------------------------------------ | +| Error Handling | `npm run error-handling` | `npx tsx error-handling.ts` | Demonstrates error handling patterns | +| Multiple Sessions | `npm run multiple-sessions` | `npx tsx multiple-sessions.ts` | Manages multiple independent conversations | +| Managing Local Files | `npm run managing-local-files` | `npx tsx managing-local-files.ts` | Organizes files using AI grouping | +| PR Visualization | `npm run pr-visualization` | `npx tsx pr-visualization.ts` | Generates PR age charts | +| Persisting Sessions | `npm run persisting-sessions` | `npx tsx persisting-sessions.ts` | Save and resume sessions across restarts | + +### Examples with Arguments + +**PR Visualization with specific repo:** + +```bash +npx tsx pr-visualization.ts --repo github/copilot-sdk +``` + +**Managing Local Files (edit the file to change target folder):** + +```bash +# Edit the targetFolder variable in managing-local-files.ts first +npx tsx managing-local-files.ts +``` + +## Local SDK Development + +The `package.json` references the local Copilot SDK using `"*"`, which resolves to the local SDK source. This means: + +- Changes to the SDK source are immediately available +- No need to publish or install from npm +- Perfect for testing and development + +If you modify the SDK source, you may need to rebuild: + +```bash +cd ../../src +npm run build +``` + +## TypeScript Features + +These examples use modern TypeScript/Node.js features: + +- Top-level await (requires `"type": "module"` in package.json) +- ESM imports +- Type safety with TypeScript +- async/await patterns + +## Learning Resources + +- [TypeScript Documentation](https://www.typescriptlang.org/docs/) +- [Node.js Documentation](https://nodejs.org/docs/latest/api/) +- [GitHub Copilot SDK for Node.js](https://github.com/github/copilot-sdk/blob/main/nodejs/README.md) +- [Parent Cookbook](../README.md) diff --git a/cookbook/copilot-sdk/nodejs/recipe/error-handling.ts b/cookbook/copilot-sdk/nodejs/recipe/error-handling.ts new file mode 100644 index 00000000..1e8c5c54 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/error-handling.ts @@ -0,0 +1,17 @@ +import { CopilotClient } from "@github/copilot-sdk"; + +const client = new CopilotClient(); + +try { + await client.start(); + const session = await client.createSession({ model: "gpt-5" }); + + const response = await session.sendAndWait({ prompt: "Hello!" }); + console.log(response?.data.content); + + await session.destroy(); +} catch (error: any) { + console.error("Error:", error.message); +} finally { + await client.stop(); +} diff --git a/cookbook/copilot-sdk/nodejs/recipe/managing-local-files.ts b/cookbook/copilot-sdk/nodejs/recipe/managing-local-files.ts new file mode 100644 index 00000000..d02427a6 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/managing-local-files.ts @@ -0,0 +1,47 @@ +import { CopilotClient } from "@github/copilot-sdk"; +import * as os from "node:os"; +import * as path from "node:path"; + +// Create and start client +const client = new CopilotClient(); +await client.start(); + +// Create session +const session = await client.createSession({ + model: "gpt-5", +}); + +// Event handler +session.on((event) => { + switch (event.type) { + case "assistant.message": + console.log(`\nCopilot: ${event.data.content}`); + break; + case "tool.execution_start": + console.log(` → Running: ${event.data.toolName} ${event.data.toolCallId}`); + break; + case "tool.execution_complete": + console.log(` ✓ Completed: ${event.data.toolCallId}`); + break; + } +}); + +// Ask Copilot to organize files +// Change this to your target folder +const targetFolder = path.join(os.homedir(), "Downloads"); + +await session.sendAndWait({ + prompt: ` +Analyze the files in "${targetFolder}" and organize them into subfolders. + +1. First, list all files and their metadata +2. Preview grouping by file extension +3. Create appropriate subfolders (e.g., "images", "documents", "videos") +4. Move each file to its appropriate subfolder + +Please confirm before moving any files. +`, +}); + +await session.destroy(); +await client.stop(); diff --git a/cookbook/copilot-sdk/nodejs/recipe/multiple-sessions.ts b/cookbook/copilot-sdk/nodejs/recipe/multiple-sessions.ts new file mode 100644 index 00000000..2420217f --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/multiple-sessions.ts @@ -0,0 +1,33 @@ +import { CopilotClient } from "@github/copilot-sdk"; + +const client = new CopilotClient(); +await client.start(); + +// Create multiple independent sessions +const session1 = await client.createSession({ model: "gpt-5" }); +const session2 = await client.createSession({ model: "gpt-5" }); +const session3 = await client.createSession({ model: "claude-sonnet-4.5" }); + +console.log("Created 3 independent sessions"); + +// Each session maintains its own conversation history +await session1.sendAndWait({ prompt: "You are helping with a Python project" }); +await session2.sendAndWait({ prompt: "You are helping with a TypeScript project" }); +await session3.sendAndWait({ prompt: "You are helping with a Go project" }); + +console.log("Sent initial context to all sessions"); + +// Follow-up messages stay in their respective contexts +await session1.sendAndWait({ prompt: "How do I create a virtual environment?" }); +await session2.sendAndWait({ prompt: "How do I set up tsconfig?" }); +await session3.sendAndWait({ prompt: "How do I initialize a module?" }); + +console.log("Sent follow-up questions to each session"); + +// Clean up all sessions +await session1.destroy(); +await session2.destroy(); +await session3.destroy(); +await client.stop(); + +console.log("All sessions destroyed successfully"); diff --git a/cookbook/copilot-sdk/nodejs/recipe/package-lock.json b/cookbook/copilot-sdk/nodejs/recipe/package-lock.json new file mode 100644 index 00000000..a5a8fea5 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/package-lock.json @@ -0,0 +1,629 @@ +{ + "name": "copilot-sdk-cookbook-recipes", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "copilot-sdk-cookbook-recipes", + "version": "1.0.0", + "dependencies": { + "@github/copilot-sdk": "file:../../src" + }, + "devDependencies": { + "@types/node": "^22.19.7", + "tsx": "^4.19.2", + "typescript": "^5.7.2" + } + }, + "../..": { + "name": "@github/copilot-sdk", + "version": "0.1.8", + "license": "MIT", + "dependencies": { + "@github/copilot": "^0.0.388-1", + "vscode-jsonrpc": "^8.2.1", + "zod": "^4.3.5" + }, + "devDependencies": { + "@types/node": "^22.19.6", + "@typescript-eslint/eslint-plugin": "^8.0.0", + "@typescript-eslint/parser": "^8.0.0", + "esbuild": "^0.27.0", + "eslint": "^9.0.0", + "glob": "^11.0.0", + "json-schema": "^0.4.0", + "json-schema-to-typescript": "^15.0.4", + "prettier": "^3.4.0", + "quicktype-core": "^23.2.6", + "rimraf": "^6.1.2", + "semver": "^7.7.3", + "tsx": "^4.20.6", + "typescript": "^5.0.0", + "vitest": "^4.0.16" + }, + "engines": { + "node": ">=18.0.0" + } + }, + "../../..": {}, + "../../src": {}, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.2.tgz", + "integrity": "sha512-GZMB+a0mOMZs4MpDbj8RJp4cw+w1WV5NYD6xzgvzUJ5Ek2jerwfO2eADyI6ExDSUED+1X8aMbegahsJi+8mgpw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.2.tgz", + "integrity": "sha512-DVNI8jlPa7Ujbr1yjU2PfUSRtAUZPG9I1RwW4F4xFB1Imiu2on0ADiI/c3td+KmDtVKNbi+nffGDQMfcIMkwIA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.2.tgz", + "integrity": "sha512-pvz8ZZ7ot/RBphf8fv60ljmaoydPU12VuXHImtAs0XhLLw+EXBi2BLe3OYSBslR4rryHvweW5gmkKFwTiFy6KA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.2.tgz", + "integrity": "sha512-z8Ank4Byh4TJJOh4wpz8g2vDy75zFL0TlZlkUkEwYXuPSgX8yzep596n6mT7905kA9uHZsf/o2OJZubl2l3M7A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.2.tgz", + "integrity": "sha512-davCD2Zc80nzDVRwXTcQP/28fiJbcOwvdolL0sOiOsbwBa72kegmVU0Wrh1MYrbuCL98Omp5dVhQFWRKR2ZAlg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.2.tgz", + "integrity": "sha512-ZxtijOmlQCBWGwbVmwOF/UCzuGIbUkqB1faQRf5akQmxRJ1ujusWsb3CVfk/9iZKr2L5SMU5wPBi1UWbvL+VQA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.2.tgz", + "integrity": "sha512-lS/9CN+rgqQ9czogxlMcBMGd+l8Q3Nj1MFQwBZJyoEKI50XGxwuzznYdwcav6lpOGv5BqaZXqvBSiB/kJ5op+g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.2.tgz", + "integrity": "sha512-tAfqtNYb4YgPnJlEFu4c212HYjQWSO/w/h/lQaBK7RbwGIkBOuNKQI9tqWzx7Wtp7bTPaGC6MJvWI608P3wXYA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.2.tgz", + "integrity": "sha512-vWfq4GaIMP9AIe4yj1ZUW18RDhx6EPQKjwe7n8BbIecFtCQG4CfHGaHuh7fdfq+y3LIA2vGS/o9ZBGVxIDi9hw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.2.tgz", + "integrity": "sha512-hYxN8pr66NsCCiRFkHUAsxylNOcAQaxSSkHMMjcpx0si13t1LHFphxJZUiGwojB1a/Hd5OiPIqDdXONia6bhTw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.2.tgz", + "integrity": "sha512-MJt5BRRSScPDwG2hLelYhAAKh9imjHK5+NE/tvnRLbIqUWa+0E9N4WNMjmp/kXXPHZGqPLxggwVhz7QP8CTR8w==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.2.tgz", + "integrity": "sha512-lugyF1atnAT463aO6KPshVCJK5NgRnU4yb3FUumyVz+cGvZbontBgzeGFO1nF+dPueHD367a2ZXe1NtUkAjOtg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.2.tgz", + "integrity": "sha512-nlP2I6ArEBewvJ2gjrrkESEZkB5mIoaTswuqNFRv/WYd+ATtUpe9Y09RnJvgvdag7he0OWgEZWhviS1OTOKixw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.2.tgz", + "integrity": "sha512-C92gnpey7tUQONqg1n6dKVbx3vphKtTHJaNG2Ok9lGwbZil6DrfyecMsp9CrmXGQJmZ7iiVXvvZH6Ml5hL6XdQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.2.tgz", + "integrity": "sha512-B5BOmojNtUyN8AXlK0QJyvjEZkWwy/FKvakkTDCziX95AowLZKR6aCDhG7LeF7uMCXEJqwa8Bejz5LTPYm8AvA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.2.tgz", + "integrity": "sha512-p4bm9+wsPwup5Z8f4EpfN63qNagQ47Ua2znaqGH6bqLlmJ4bx97Y9JdqxgGZ6Y8xVTixUnEkoKSHcpRlDnNr5w==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.2.tgz", + "integrity": "sha512-uwp2Tip5aPmH+NRUwTcfLb+W32WXjpFejTIOWZFw/v7/KnpCDKG66u4DLcurQpiYTiYwQ9B7KOeMJvLCu/OvbA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.2.tgz", + "integrity": "sha512-Kj6DiBlwXrPsCRDeRvGAUb/LNrBASrfqAIok+xB0LxK8CHqxZ037viF13ugfsIpePH93mX7xfJp97cyDuTZ3cw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.2.tgz", + "integrity": "sha512-HwGDZ0VLVBY3Y+Nw0JexZy9o/nUAWq9MlV7cahpaXKW6TOzfVno3y3/M8Ga8u8Yr7GldLOov27xiCnqRZf0tCA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.2.tgz", + "integrity": "sha512-DNIHH2BPQ5551A7oSHD0CKbwIA/Ox7+78/AWkbS5QoRzaqlev2uFayfSxq68EkonB+IKjiuxBFoV8ESJy8bOHA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.2.tgz", + "integrity": "sha512-/it7w9Nb7+0KFIzjalNJVR5bOzA9Vay+yIPLVHfIQYG/j+j9VTH84aNB8ExGKPU4AzfaEvN9/V4HV+F+vo8OEg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.2.tgz", + "integrity": "sha512-LRBbCmiU51IXfeXk59csuX/aSaToeG7w48nMwA6049Y4J4+VbWALAuXcs+qcD04rHDuSCSRKdmY63sruDS5qag==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.2.tgz", + "integrity": "sha512-kMtx1yqJHTmqaqHPAzKCAkDaKsffmXkPHThSfRwZGyuqyIeBvf08KSsYXl+abf5HDAPMJIPnbBfXvP2ZC2TfHg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.2.tgz", + "integrity": "sha512-Yaf78O/B3Kkh+nKABUF++bvJv5Ijoy9AN1ww904rOXZFLWVc5OLOfL56W+C8F9xn5JQZa3UX6m+IktJnIb1Jjg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.2.tgz", + "integrity": "sha512-Iuws0kxo4yusk7sw70Xa2E2imZU5HoixzxfGCdxwBdhiDgt9vX9VUCBhqcwY7/uh//78A1hMkkROMJq9l27oLQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.2.tgz", + "integrity": "sha512-sRdU18mcKf7F+YgheI/zGf5alZatMUTKj/jNS6l744f9u3WFu4v7twcUI9vu4mknF4Y9aDlblIie0IM+5xxaqQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@github/copilot-sdk": { + "resolved": "../../src", + "link": true + }, + "node_modules/@types/node": { + "version": "22.19.7", + "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.7.tgz", + "integrity": "sha512-MciR4AKGHWl7xwxkBa6xUGxQJ4VBOmPTF7sL+iGzuahOFaO0jHCsuEfS80pan1ef4gWId1oWOweIhrDEYLuaOw==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/esbuild": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.2.tgz", + "integrity": "sha512-HyNQImnsOC7X9PMNaCIeAm4ISCQXs5a5YasTXVliKv4uuBo1dKrG0A+uQS8M5eXjVMnLg3WgXaKvprHlFJQffw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.2", + "@esbuild/android-arm": "0.27.2", + "@esbuild/android-arm64": "0.27.2", + "@esbuild/android-x64": "0.27.2", + "@esbuild/darwin-arm64": "0.27.2", + "@esbuild/darwin-x64": "0.27.2", + "@esbuild/freebsd-arm64": "0.27.2", + "@esbuild/freebsd-x64": "0.27.2", + "@esbuild/linux-arm": "0.27.2", + "@esbuild/linux-arm64": "0.27.2", + "@esbuild/linux-ia32": "0.27.2", + "@esbuild/linux-loong64": "0.27.2", + "@esbuild/linux-mips64el": "0.27.2", + "@esbuild/linux-ppc64": "0.27.2", + "@esbuild/linux-riscv64": "0.27.2", + "@esbuild/linux-s390x": "0.27.2", + "@esbuild/linux-x64": "0.27.2", + "@esbuild/netbsd-arm64": "0.27.2", + "@esbuild/netbsd-x64": "0.27.2", + "@esbuild/openbsd-arm64": "0.27.2", + "@esbuild/openbsd-x64": "0.27.2", + "@esbuild/openharmony-arm64": "0.27.2", + "@esbuild/sunos-x64": "0.27.2", + "@esbuild/win32-arm64": "0.27.2", + "@esbuild/win32-ia32": "0.27.2", + "@esbuild/win32-x64": "0.27.2" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/get-tsconfig": { + "version": "4.13.0", + "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.0.tgz", + "integrity": "sha512-1VKTZJCwBrvbd+Wn3AOgQP/2Av+TfTCOlE4AcRJE72W1ksZXbAx8PPBR9RzgTeSPzlPMHrbANMH3LbltH73wxQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "resolve-pkg-maps": "^1.0.0" + }, + "funding": { + "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1" + } + }, + "node_modules/resolve-pkg-maps": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz", + "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1" + } + }, + "node_modules/tsx": { + "version": "4.21.0", + "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz", + "integrity": "sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "~0.27.0", + "get-tsconfig": "^4.7.5" + }, + "bin": { + "tsx": "dist/cli.mjs" + }, + "engines": { + "node": ">=18.0.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "dev": true, + "license": "MIT" + } + } +} diff --git a/cookbook/copilot-sdk/nodejs/recipe/package.json b/cookbook/copilot-sdk/nodejs/recipe/package.json new file mode 100644 index 00000000..53584216 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/package.json @@ -0,0 +1,21 @@ +{ + "name": "copilot-sdk-cookbook-recipes", + "version": "1.0.0", + "type": "module", + "description": "Runnable examples for GitHub Copilot SDK cookbook recipes", + "scripts": { + "error-handling": "tsx error-handling.ts", + "multiple-sessions": "tsx multiple-sessions.ts", + "managing-local-files": "tsx managing-local-files.ts", + "pr-visualization": "tsx pr-visualization.ts", + "persisting-sessions": "tsx persisting-sessions.ts" + }, + "dependencies": { + "@github/copilot-sdk": "*" + }, + "devDependencies": { + "@types/node": "^22.19.7", + "tsx": "^4.19.2", + "typescript": "^5.7.2" + } +} diff --git a/cookbook/copilot-sdk/nodejs/recipe/persisting-sessions.ts b/cookbook/copilot-sdk/nodejs/recipe/persisting-sessions.ts new file mode 100644 index 00000000..f015cae4 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/persisting-sessions.ts @@ -0,0 +1,37 @@ +import { CopilotClient } from "@github/copilot-sdk"; + +const client = new CopilotClient(); +await client.start(); + +// Create a session with a memorable ID +const session = await client.createSession({ + sessionId: "user-123-conversation", + model: "gpt-5", +}); + +await session.sendAndWait({ prompt: "Let's discuss TypeScript generics" }); +console.log(`Session created: ${session.sessionId}`); + +// Destroy session but keep data on disk +await session.destroy(); +console.log("Session destroyed (state persisted)"); + +// Resume the previous session +const resumed = await client.resumeSession("user-123-conversation"); +console.log(`Resumed: ${resumed.sessionId}`); + +await resumed.sendAndWait({ prompt: "What were we discussing?" }); + +// List sessions +const sessions = await client.listSessions(); +console.log( + "Sessions:", + sessions.map((s) => s.sessionId) +); + +// Delete session permanently +await client.deleteSession("user-123-conversation"); +console.log("Session deleted"); + +await resumed.destroy(); +await client.stop(); diff --git a/cookbook/copilot-sdk/nodejs/recipe/pr-visualization.ts b/cookbook/copilot-sdk/nodejs/recipe/pr-visualization.ts new file mode 100644 index 00000000..d0c118e2 --- /dev/null +++ b/cookbook/copilot-sdk/nodejs/recipe/pr-visualization.ts @@ -0,0 +1,179 @@ +#!/usr/bin/env tsx + +import { CopilotClient } from "@github/copilot-sdk"; +import { execSync } from "node:child_process"; +import * as readline from "node:readline"; + +// ============================================================================ +// Git & GitHub Detection +// ============================================================================ + +function isGitRepo(): boolean { + try { + execSync("git rev-parse --git-dir", { stdio: "ignore" }); + return true; + } catch { + return false; + } +} + +function getGitHubRemote(): string | null { + try { + const remoteUrl = execSync("git remote get-url origin", { + encoding: "utf-8", + }).trim(); + + // Handle SSH: git@github.com:owner/repo.git + const sshMatch = remoteUrl.match(/git@github\.com:(.+\/.+?)(?:\.git)?$/); + if (sshMatch) return sshMatch[1]; + + // Handle HTTPS: https://github.com/owner/repo.git + const httpsMatch = remoteUrl.match(/https:\/\/github\.com\/(.+\/.+?)(?:\.git)?$/); + if (httpsMatch) return httpsMatch[1]; + + return null; + } catch { + return null; + } +} + +function parseArgs(): { repo?: string } { + const args = process.argv.slice(2); + const repoIndex = args.indexOf("--repo"); + if (repoIndex !== -1 && args[repoIndex + 1]) { + return { repo: args[repoIndex + 1] }; + } + return {}; +} + +async function promptForRepo(): Promise { + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); + return new Promise((resolve) => { + rl.question("Enter GitHub repo (owner/repo): ", (answer) => { + rl.close(); + resolve(answer.trim()); + }); + }); +} + +// ============================================================================ +// Main Application +// ============================================================================ + +async function main() { + console.log("🔍 PR Age Chart Generator\n"); + + // Determine the repository + const args = parseArgs(); + let repo: string; + + if (args.repo) { + repo = args.repo; + console.log(`📦 Using specified repo: ${repo}`); + } else if (isGitRepo()) { + const detected = getGitHubRemote(); + if (detected) { + repo = detected; + console.log(`📦 Detected GitHub repo: ${repo}`); + } else { + console.log("⚠️ Git repo found but no GitHub remote detected."); + repo = await promptForRepo(); + } + } else { + console.log("📁 Not in a git repository."); + repo = await promptForRepo(); + } + + if (!repo || !repo.includes("/")) { + console.error("❌ Invalid repo format. Expected: owner/repo"); + process.exit(1); + } + + const [owner, repoName] = repo.split("/"); + + // Create Copilot client - no custom tools needed! + const client = new CopilotClient({ logLevel: "error" }); + + const session = await client.createSession({ + model: "gpt-5", + systemMessage: { + content: ` + +You are analyzing pull requests for the GitHub repository: ${owner}/${repoName} +The current working directory is: ${process.cwd()} + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +`, + }, + }); + + // Set up event handling + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); + + session.on((event) => { + if (event.type === "assistant.message") { + console.log(`\n🤖 ${event.data.content}\n`); + } else if (event.type === "tool.execution_start") { + console.log(` ⚙️ ${event.data.toolName}`); + } + }); + + // Initial prompt - let Copilot figure out the details + console.log("\n📊 Starting analysis...\n"); + + await session.sendAndWait({ + prompt: ` + Fetch the open pull requests for ${owner}/${repoName} from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + `, + }); + + // Interactive loop + const askQuestion = () => { + rl.question("You: ", async (input) => { + const trimmed = input.trim(); + + if (trimmed.toLowerCase() === "exit" || trimmed.toLowerCase() === "quit") { + console.log("👋 Goodbye!"); + rl.close(); + await session.destroy(); + await client.stop(); + process.exit(0); + } + + if (trimmed) { + await session.sendAndWait({ prompt: trimmed }); + } + + askQuestion(); + }); + }; + + console.log('💡 Ask follow-up questions or type "exit" to quit.\n'); + console.log("Examples:"); + console.log(' - "Expand to the last month"'); + console.log(' - "Show me the 5 oldest PRs"'); + console.log(' - "Generate a pie chart instead"'); + console.log(' - "Group by author instead of age"'); + console.log(""); + + askQuestion(); +} + +main().catch(console.error); diff --git a/cookbook/copilot-sdk/python/README.md b/cookbook/copilot-sdk/python/README.md new file mode 100644 index 00000000..e0324d69 --- /dev/null +++ b/cookbook/copilot-sdk/python/README.md @@ -0,0 +1,19 @@ +# GitHub Copilot SDK Cookbook — Python + +This folder hosts short, practical recipes for using the GitHub Copilot SDK with Python. Each recipe is concise, copy‑pasteable, and points to fuller examples and tests. + +## Recipes + +- [Error Handling](error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup. +- [Multiple Sessions](multiple-sessions.md): Manage multiple independent conversations simultaneously. +- [Managing Local Files](managing-local-files.md): Organize files by metadata using AI-powered grouping strategies. +- [PR Visualization](pr-visualization.md): Generate interactive PR age charts using GitHub MCP Server. +- [Persisting Sessions](persisting-sessions.md): Save and resume sessions across restarts. + +## Contributing + +Add a new recipe by creating a markdown file in this folder and linking it above. Follow repository guidance in [CONTRIBUTING.md](../../../CONTRIBUTING.md). + +## Status + +These recipes are complete and ready to use; new contributions and additional recipes are welcome. diff --git a/cookbook/copilot-sdk/python/error-handling.md b/cookbook/copilot-sdk/python/error-handling.md new file mode 100644 index 00000000..cdd73cbc --- /dev/null +++ b/cookbook/copilot-sdk/python/error-handling.md @@ -0,0 +1,150 @@ +# Error Handling Patterns + +Handle errors gracefully in your Copilot SDK applications. + +> **Runnable example:** [recipe/error_handling.py](recipe/error_handling.py) +> +> ```bash +> cd recipe && pip install -r requirements.txt +> python error_handling.py +> ``` + +## Example scenario + +You need to handle various error conditions like connection failures, timeouts, and invalid responses. + +## Basic try-except + +```python +from copilot import CopilotClient + +client = CopilotClient() + +try: + client.start() + session = client.create_session(model="gpt-5") + + response = None + def handle_message(event): + nonlocal response + if event["type"] == "assistant.message": + response = event["data"]["content"] + + session.on(handle_message) + session.send(prompt="Hello!") + session.wait_for_idle() + + if response: + print(response) + + session.destroy() +except Exception as e: + print(f"Error: {e}") +finally: + client.stop() +``` + +## Handling specific error types + +```python +import subprocess + +try: + client.start() +except FileNotFoundError: + print("Copilot CLI not found. Please install it first.") +except ConnectionError: + print("Could not connect to Copilot CLI server.") +except Exception as e: + print(f"Unexpected error: {e}") +``` + +## Timeout handling + +```python +import signal +from contextlib import contextmanager + +@contextmanager +def timeout(seconds): + def timeout_handler(signum, frame): + raise TimeoutError("Request timed out") + + old_handler = signal.signal(signal.SIGALRM, timeout_handler) + signal.alarm(seconds) + try: + yield + finally: + signal.alarm(0) + signal.signal(signal.SIGALRM, old_handler) + +session = client.create_session(model="gpt-5") + +try: + session.send(prompt="Complex question...") + + # Wait with timeout (30 seconds) + with timeout(30): + session.wait_for_idle() + + print("Response received") +except TimeoutError: + print("Request timed out") +``` + +## Aborting a request + +```python +import threading + +session = client.create_session(model="gpt-5") + +# Start a request +session.send(prompt="Write a very long story...") + +# Abort it after some condition +def abort_later(): + import time + time.sleep(5) + session.abort() + print("Request aborted") + +threading.Thread(target=abort_later).start() +``` + +## Graceful shutdown + +```python +import signal +import sys + +def signal_handler(sig, frame): + print("\nShutting down...") + errors = client.stop() + if errors: + print(f"Cleanup errors: {errors}") + sys.exit(0) + +signal.signal(signal.SIGINT, signal_handler) +``` + +## Context manager for automatic cleanup + +```python +from copilot import CopilotClient + +with CopilotClient() as client: + client.start() + session = client.create_session(model="gpt-5") + + # ... do work ... + + # client.stop() is automatically called when exiting context +``` + +## Best practices + +1. **Always clean up**: Use try-finally or context managers to ensure `stop()` is called +2. **Handle connection errors**: The CLI might not be installed or running +3. **Set appropriate timeouts**: Long-running requests should have timeouts +4. **Log errors**: Capture error details for debugging diff --git a/cookbook/copilot-sdk/python/managing-local-files.md b/cookbook/copilot-sdk/python/managing-local-files.md new file mode 100644 index 00000000..c81a831e --- /dev/null +++ b/cookbook/copilot-sdk/python/managing-local-files.md @@ -0,0 +1,119 @@ +# Grouping Files by Metadata + +Use Copilot to intelligently organize files in a folder based on their metadata. + +> **Runnable example:** [recipe/managing_local_files.py](recipe/managing_local_files.py) +> +> ```bash +> cd recipe && pip install -r requirements.txt +> python managing_local_files.py +> ``` + +## Example scenario + +You have a folder with many files and want to organize them into subfolders based on metadata like file type, creation date, size, or other attributes. Copilot can analyze the files and suggest or execute a grouping strategy. + +## Example code + +```python +from copilot import CopilotClient +import os + +# Create and start client +client = CopilotClient() +client.start() + +# Create session +session = client.create_session(model="gpt-5") + +# Event handler +def handle_event(event): + if event["type"] == "assistant.message": + print(f"\nCopilot: {event['data']['content']}") + elif event["type"] == "tool.execution_start": + print(f" → Running: {event['data']['toolName']}") + elif event["type"] == "tool.execution_complete": + print(f" ✓ Completed: {event['data']['toolCallId']}") + +session.on(handle_event) + +# Ask Copilot to organize files +target_folder = os.path.expanduser("~/Downloads") + +session.send(prompt=f""" +Analyze the files in "{target_folder}" and organize them into subfolders. + +1. First, list all files and their metadata +2. Preview grouping by file extension +3. Create appropriate subfolders (e.g., "images", "documents", "videos") +4. Move each file to its appropriate subfolder + +Please confirm before moving any files. +""") + +session.wait_for_idle() + +client.stop() +``` + +## Grouping strategies + +### By file extension + +```python +# Groups files like: +# images/ -> .jpg, .png, .gif +# documents/ -> .pdf, .docx, .txt +# videos/ -> .mp4, .avi, .mov +``` + +### By creation date + +```python +# Groups files like: +# 2024-01/ -> files created in January 2024 +# 2024-02/ -> files created in February 2024 +``` + +### By file size + +```python +# Groups files like: +# tiny-under-1kb/ +# small-under-1mb/ +# medium-under-100mb/ +# large-over-100mb/ +``` + +## Dry-run mode + +For safety, you can ask Copilot to only preview changes: + +```python +session.send(prompt=f""" +Analyze files in "{target_folder}" and show me how you would organize them +by file type. DO NOT move any files - just show me the plan. +""") +``` + +## Custom grouping with AI analysis + +Let Copilot determine the best grouping based on file content: + +```python +session.send(prompt=f""" +Look at the files in "{target_folder}" and suggest a logical organization. +Consider: +- File names and what they might contain +- File types and their typical uses +- Date patterns that might indicate projects or events + +Propose folder names that are descriptive and useful. +""") +``` + +## Safety considerations + +1. **Confirm before moving**: Ask Copilot to confirm before executing moves +2. **Handle duplicates**: Consider what happens if a file with the same name exists +3. **Preserve originals**: Consider copying instead of moving for important files diff --git a/cookbook/copilot-sdk/python/multiple-sessions.md b/cookbook/copilot-sdk/python/multiple-sessions.md new file mode 100644 index 00000000..4baa0f47 --- /dev/null +++ b/cookbook/copilot-sdk/python/multiple-sessions.md @@ -0,0 +1,78 @@ +# Working with Multiple Sessions + +Manage multiple independent conversations simultaneously. + +> **Runnable example:** [recipe/multiple_sessions.py](recipe/multiple_sessions.py) +> +> ```bash +> cd recipe && pip install -r requirements.txt +> python multiple_sessions.py +> ``` + +## Example scenario + +You need to run multiple conversations in parallel, each with its own context and history. + +## Python + +```python +from copilot import CopilotClient + +client = CopilotClient() +client.start() + +# Create multiple independent sessions +session1 = client.create_session(model="gpt-5") +session2 = client.create_session(model="gpt-5") +session3 = client.create_session(model="claude-sonnet-4.5") + +# Each session maintains its own conversation history +session1.send(prompt="You are helping with a Python project") +session2.send(prompt="You are helping with a TypeScript project") +session3.send(prompt="You are helping with a Go project") + +# Follow-up messages stay in their respective contexts +session1.send(prompt="How do I create a virtual environment?") +session2.send(prompt="How do I set up tsconfig?") +session3.send(prompt="How do I initialize a module?") + +# Clean up all sessions +session1.destroy() +session2.destroy() +session3.destroy() +client.stop() +``` + +## Custom session IDs + +Use custom IDs for easier tracking: + +```python +session = client.create_session( + session_id="user-123-chat", + model="gpt-5" +) + +print(session.session_id) # "user-123-chat" +``` + +## Listing sessions + +```python +sessions = client.list_sessions() +for session_info in sessions: + print(f"Session: {session_info['sessionId']}") +``` + +## Deleting sessions + +```python +# Delete a specific session +client.delete_session("user-123-chat") +``` + +## Use cases + +- **Multi-user applications**: One session per user +- **Multi-task workflows**: Separate sessions for different tasks +- **A/B testing**: Compare responses from different models diff --git a/cookbook/copilot-sdk/python/persisting-sessions.md b/cookbook/copilot-sdk/python/persisting-sessions.md new file mode 100644 index 00000000..5d07a469 --- /dev/null +++ b/cookbook/copilot-sdk/python/persisting-sessions.md @@ -0,0 +1,83 @@ +# Session Persistence and Resumption + +Save and restore conversation sessions across application restarts. + +## Example scenario + +You want users to be able to continue a conversation even after closing and reopening your application. + +> **Runnable example:** [recipe/persisting_sessions.py](recipe/persisting_sessions.py) +> +> ```bash +> cd recipe && pip install -r requirements.txt +> python persisting_sessions.py +> ``` + +### Creating a session with a custom ID + +```python +from copilot import CopilotClient + +client = CopilotClient() +client.start() + +# Create session with a memorable ID +session = client.create_session( + session_id="user-123-conversation", + model="gpt-5", +) + +session.send(prompt="Let's discuss TypeScript generics") + +# Session ID is preserved +print(session.session_id) # "user-123-conversation" + +# Destroy session but keep data on disk +session.destroy() +client.stop() +``` + +### Resuming a session + +```python +client = CopilotClient() +client.start() + +# Resume the previous session +session = client.resume_session("user-123-conversation") + +# Previous context is restored +session.send(prompt="What were we discussing?") + +session.destroy() +client.stop() +``` + +### Listing available sessions + +```python +sessions = client.list_sessions() +for s in sessions: + print("Session:", s["sessionId"]) +``` + +### Deleting a session permanently + +```python +# Remove session and all its data from disk +client.delete_session("user-123-conversation") +``` + +### Getting session history + +```python +messages = session.get_messages() +for msg in messages: + print(f"[{msg['type']}] {msg['data']}") +``` + +## Best practices + +1. **Use meaningful session IDs**: Include user ID or context in the session ID +2. **Handle missing sessions**: Check if a session exists before resuming +3. **Clean up old sessions**: Periodically delete sessions that are no longer needed diff --git a/cookbook/copilot-sdk/python/pr-visualization.md b/cookbook/copilot-sdk/python/pr-visualization.md new file mode 100644 index 00000000..3d8b7969 --- /dev/null +++ b/cookbook/copilot-sdk/python/pr-visualization.md @@ -0,0 +1,219 @@ +# Generating PR Age Charts + +Build an interactive CLI tool that visualizes pull request age distribution for a GitHub repository using Copilot's built-in capabilities. + +> **Runnable example:** [recipe/pr_visualization.py](recipe/pr_visualization.py) +> +> ```bash +> cd recipe && pip install -r requirements.txt +> # Auto-detect from current git repo +> python pr_visualization.py +> +> # Specify a repo explicitly +> python pr_visualization.py --repo github/copilot-sdk +> ``` + +## Example scenario + +You want to understand how long PRs have been open in a repository. This tool detects the current Git repo or accepts a repo as input, then lets Copilot fetch PR data via the GitHub MCP Server and generate a chart image. + +## Prerequisites + +```bash +pip install copilot-sdk +``` + +## Usage + +```bash +# Auto-detect from current git repo +python pr_visualization.py + +# Specify a repo explicitly +python pr_visualization.py --repo github/copilot-sdk +``` + +## Full example: pr_visualization.py + +```python +#!/usr/bin/env python3 + +import subprocess +import sys +import os +from copilot import CopilotClient + +# ============================================================================ +# Git & GitHub Detection +# ============================================================================ + +def is_git_repo(): + try: + subprocess.run( + ["git", "rev-parse", "--git-dir"], + check=True, + capture_output=True + ) + return True + except (subprocess.CalledProcessError, FileNotFoundError): + return False + +def get_github_remote(): + try: + result = subprocess.run( + ["git", "remote", "get-url", "origin"], + check=True, + capture_output=True, + text=True + ) + remote_url = result.stdout.strip() + + # Handle SSH: git@github.com:owner/repo.git + import re + ssh_match = re.search(r"git@github\.com:(.+/.+?)(?:\.git)?$", remote_url) + if ssh_match: + return ssh_match.group(1) + + # Handle HTTPS: https://github.com/owner/repo.git + https_match = re.search(r"https://github\.com/(.+/.+?)(?:\.git)?$", remote_url) + if https_match: + return https_match.group(1) + + return None + except (subprocess.CalledProcessError, FileNotFoundError): + return None + +def parse_args(): + args = sys.argv[1:] + if "--repo" in args: + idx = args.index("--repo") + if idx + 1 < len(args): + return {"repo": args[idx + 1]} + return {} + +def prompt_for_repo(): + return input("Enter GitHub repo (owner/repo): ").strip() + +# ============================================================================ +# Main Application +# ============================================================================ + +def main(): + print("🔍 PR Age Chart Generator\n") + + # Determine the repository + args = parse_args() + repo = None + + if "repo" in args: + repo = args["repo"] + print(f"📦 Using specified repo: {repo}") + elif is_git_repo(): + detected = get_github_remote() + if detected: + repo = detected + print(f"📦 Detected GitHub repo: {repo}") + else: + print("⚠️ Git repo found but no GitHub remote detected.") + repo = prompt_for_repo() + else: + print("📁 Not in a git repository.") + repo = prompt_for_repo() + + if not repo or "/" not in repo: + print("❌ Invalid repo format. Expected: owner/repo") + sys.exit(1) + + owner, repo_name = repo.split("/", 1) + + # Create Copilot client - no custom tools needed! + client = CopilotClient(log_level="error") + client.start() + + session = client.create_session( + model="gpt-5", + system_message={ + "content": f""" + +You are analyzing pull requests for the GitHub repository: {owner}/{repo_name} +The current working directory is: {os.getcwd()} + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +""" + } + ) + + # Set up event handling + def handle_event(event): + if event["type"] == "assistant.message": + print(f"\n🤖 {event['data']['content']}\n") + elif event["type"] == "tool.execution_start": + print(f" ⚙️ {event['data']['toolName']}") + + session.on(handle_event) + + # Initial prompt - let Copilot figure out the details + print("\n📊 Starting analysis...\n") + + session.send(prompt=f""" + Fetch the open pull requests for {owner}/{repo_name} from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + """) + + session.wait_for_idle() + + # Interactive loop + print("\n💡 Ask follow-up questions or type \"exit\" to quit.\n") + print("Examples:") + print(" - \"Expand to the last month\"") + print(" - \"Show me the 5 oldest PRs\"") + print(" - \"Generate a pie chart instead\"") + print(" - \"Group by author instead of age\"") + print() + + while True: + user_input = input("You: ").strip() + + if user_input.lower() in ["exit", "quit"]: + print("👋 Goodbye!") + break + + if user_input: + session.send(prompt=user_input) + session.wait_for_idle() + + session.destroy() + client.stop() + +if __name__ == "__main__": + main() +``` + +## How it works + +1. **Repository detection**: Checks `--repo` flag → git remote → prompts user +2. **No custom tools**: Relies entirely on Copilot CLI's built-in capabilities: + - **GitHub MCP Server** - Fetches PR data from GitHub + - **File tools** - Saves generated chart images + - **Code execution** - Generates charts using Python/matplotlib or other methods +3. **Interactive session**: After initial analysis, user can ask for adjustments + +## Why this approach? + +| Aspect | Custom Tools | Built-in Copilot | +| --------------- | ----------------- | --------------------------------- | +| Code complexity | High | **Minimal** | +| Maintenance | You maintain | **Copilot maintains** | +| Flexibility | Fixed logic | **AI decides best approach** | +| Chart types | What you coded | **Any type Copilot can generate** | +| Data grouping | Hardcoded buckets | **Intelligent grouping** | diff --git a/cookbook/copilot-sdk/python/recipe/README.md b/cookbook/copilot-sdk/python/recipe/README.md new file mode 100644 index 00000000..ce0265f5 --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/README.md @@ -0,0 +1,92 @@ +# Runnable Recipe Examples + +This folder contains standalone, executable Python examples for each cookbook recipe. Each file can be run directly as a Python script. + +## Prerequisites + +- Python 3.8 or later +- Install dependencies (this installs the SDK from PyPI): + +```bash +pip install -r requirements.txt +``` + +## Running Examples + +Each `.py` file is a complete, runnable program with executable permissions: + +```bash +python .py +# or on Unix-like systems: +./.py +``` + +### Available Recipes + +| Recipe | Command | Description | +| -------------------- | -------------------------------- | ------------------------------------------ | +| Error Handling | `python error_handling.py` | Demonstrates error handling patterns | +| Multiple Sessions | `python multiple_sessions.py` | Manages multiple independent conversations | +| Managing Local Files | `python managing_local_files.py` | Organizes files using AI grouping | +| PR Visualization | `python pr_visualization.py` | Generates PR age charts | +| Persisting Sessions | `python persisting_sessions.py` | Save and resume sessions across restarts | + +### Examples with Arguments + +**PR Visualization with specific repo:** + +```bash +python pr_visualization.py --repo github/copilot-sdk +``` + +**Managing Local Files (edit the file to change target folder):** + +```bash +# Edit the target_folder variable in managing_local_files.py first +python managing_local_files.py +``` + +## Local SDK Development + +The `requirements.txt` installs the Copilot SDK package from PyPI. This means: + +- You get the latest stable release of the SDK +- No need to build from source +- Perfect for using the SDK in your projects + +If you want to use a local development version, edit requirements.txt to use `-e ../..` for editable mode development. + +## Python Best Practices + +These examples follow Python conventions: + +- PEP 8 naming (snake_case for functions and variables) +- Shebang line for direct execution +- Proper exception handling +- Type hints where appropriate +- Standard library usage + +## Virtual Environment (Recommended) + +For isolated development: + +```bash +# Create virtual environment +python -m venv venv + +# Activate it +# Windows: +venv\Scripts\activate +# Unix/macOS: +source venv/bin/activate + +# Install dependencies +pip install -r requirements.txt +``` + +## Learning Resources + +- [Python Documentation](https://docs.python.org/3/) +- [PEP 8 Style Guide](https://pep8.org/) +- [GitHub Copilot SDK for Python](https://github.com/github/copilot-sdk/blob/main/python/README.md) +- [Parent Cookbook](../README.md) diff --git a/cookbook/copilot-sdk/python/recipe/error_handling.py b/cookbook/copilot-sdk/python/recipe/error_handling.py new file mode 100644 index 00000000..b76b29ce --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/error_handling.py @@ -0,0 +1,28 @@ +#!/usr/bin/env python3 + +from copilot import CopilotClient + +client = CopilotClient() + +try: + client.start() + session = client.create_session(model="gpt-5") + + response = None + def handle_message(event): + nonlocal response + if event["type"] == "assistant.message": + response = event["data"]["content"] + + session.on(handle_message) + session.send(prompt="Hello!") + session.wait_for_idle() + + if response: + print(response) + + session.destroy() +except Exception as e: + print(f"Error: {e}") +finally: + client.stop() diff --git a/cookbook/copilot-sdk/python/recipe/managing_local_files.py b/cookbook/copilot-sdk/python/recipe/managing_local_files.py new file mode 100644 index 00000000..8b9f94dc --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/managing_local_files.py @@ -0,0 +1,42 @@ +#!/usr/bin/env python3 + +from copilot import CopilotClient +import os + +# Create and start client +client = CopilotClient() +client.start() + +# Create session +session = client.create_session(model="gpt-5") + +# Event handler +def handle_event(event): + if event["type"] == "assistant.message": + print(f"\nCopilot: {event['data']['content']}") + elif event["type"] == "tool.execution_start": + print(f" → Running: {event['data']['toolName']}") + elif event["type"] == "tool.execution_complete": + print(f" ✓ Completed: {event['data']['toolCallId']}") + +session.on(handle_event) + +# Ask Copilot to organize files +# Change this to your target folder +target_folder = os.path.expanduser("~/Downloads") + +session.send(prompt=f""" +Analyze the files in "{target_folder}" and organize them into subfolders. + +1. First, list all files and their metadata +2. Preview grouping by file extension +3. Create appropriate subfolders (e.g., "images", "documents", "videos") +4. Move each file to its appropriate subfolder + +Please confirm before moving any files. +""") + +session.wait_for_idle() + +session.destroy() +client.stop() diff --git a/cookbook/copilot-sdk/python/recipe/multiple_sessions.py b/cookbook/copilot-sdk/python/recipe/multiple_sessions.py new file mode 100644 index 00000000..dd4f299c --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/multiple_sessions.py @@ -0,0 +1,35 @@ +#!/usr/bin/env python3 + +from copilot import CopilotClient + +client = CopilotClient() +client.start() + +# Create multiple independent sessions +session1 = client.create_session(model="gpt-5") +session2 = client.create_session(model="gpt-5") +session3 = client.create_session(model="claude-sonnet-4.5") + +print("Created 3 independent sessions") + +# Each session maintains its own conversation history +session1.send(prompt="You are helping with a Python project") +session2.send(prompt="You are helping with a TypeScript project") +session3.send(prompt="You are helping with a Go project") + +print("Sent initial context to all sessions") + +# Follow-up messages stay in their respective contexts +session1.send(prompt="How do I create a virtual environment?") +session2.send(prompt="How do I set up tsconfig?") +session3.send(prompt="How do I initialize a module?") + +print("Sent follow-up questions to each session") + +# Clean up all sessions +session1.destroy() +session2.destroy() +session3.destroy() +client.stop() + +print("All sessions destroyed successfully") diff --git a/cookbook/copilot-sdk/python/recipe/persisting_sessions.py b/cookbook/copilot-sdk/python/recipe/persisting_sessions.py new file mode 100644 index 00000000..b3d97f2f --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/persisting_sessions.py @@ -0,0 +1,36 @@ +#!/usr/bin/env python3 + +from copilot import CopilotClient + +client = CopilotClient() +client.start() + +# Create session with a memorable ID +session = client.create_session( + session_id="user-123-conversation", + model="gpt-5", +) + +session.send(prompt="Let's discuss TypeScript generics") +print(f"Session created: {session.session_id}") + +# Destroy session but keep data on disk +session.destroy() +print("Session destroyed (state persisted)") + +# Resume the previous session +resumed = client.resume_session("user-123-conversation") +print(f"Resumed: {resumed.session_id}") + +resumed.send(prompt="What were we discussing?") + +# List sessions +sessions = client.list_sessions() +print("Sessions:", [s["sessionId"] for s in sessions]) + +# Delete session permanently +client.delete_session("user-123-conversation") +print("Session deleted") + +resumed.destroy() +client.stop() diff --git a/cookbook/copilot-sdk/python/recipe/pr_visualization.py b/cookbook/copilot-sdk/python/recipe/pr_visualization.py new file mode 100644 index 00000000..6be73dfd --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/pr_visualization.py @@ -0,0 +1,161 @@ +#!/usr/bin/env python3 + +import subprocess +import sys +import os +import re +from copilot import CopilotClient + +# ============================================================================ +# Git & GitHub Detection +# ============================================================================ + +def is_git_repo(): + try: + subprocess.run( + ["git", "rev-parse", "--git-dir"], + check=True, + capture_output=True + ) + return True + except (subprocess.CalledProcessError, FileNotFoundError): + return False + +def get_github_remote(): + try: + result = subprocess.run( + ["git", "remote", "get-url", "origin"], + check=True, + capture_output=True, + text=True + ) + remote_url = result.stdout.strip() + + # Handle SSH: git@github.com:owner/repo.git + ssh_match = re.search(r"git@github\.com:(.+/.+?)(?:\.git)?$", remote_url) + if ssh_match: + return ssh_match.group(1) + + # Handle HTTPS: https://github.com/owner/repo.git + https_match = re.search(r"https://github\.com/(.+/.+?)(?:\.git)?$", remote_url) + if https_match: + return https_match.group(1) + + return None + except (subprocess.CalledProcessError, FileNotFoundError): + return None + +def parse_args(): + args = sys.argv[1:] + if "--repo" in args: + idx = args.index("--repo") + if idx + 1 < len(args): + return {"repo": args[idx + 1]} + return {} + +def prompt_for_repo(): + return input("Enter GitHub repo (owner/repo): ").strip() + +# ============================================================================ +# Main Application +# ============================================================================ + +def main(): + print("🔍 PR Age Chart Generator\n") + + # Determine the repository + args = parse_args() + repo = None + + if "repo" in args: + repo = args["repo"] + print(f"📦 Using specified repo: {repo}") + elif is_git_repo(): + detected = get_github_remote() + if detected: + repo = detected + print(f"📦 Detected GitHub repo: {repo}") + else: + print("⚠️ Git repo found but no GitHub remote detected.") + repo = prompt_for_repo() + else: + print("📁 Not in a git repository.") + repo = prompt_for_repo() + + if not repo or "/" not in repo: + print("❌ Invalid repo format. Expected: owner/repo") + sys.exit(1) + + owner, repo_name = repo.split("/", 1) + + # Create Copilot client - no custom tools needed! + client = CopilotClient(log_level="error") + client.start() + + session = client.create_session( + model="gpt-5", + system_message={ + "content": f""" + +You are analyzing pull requests for the GitHub repository: {owner}/{repo_name} +The current working directory is: {os.getcwd()} + + + +- Use the GitHub MCP Server tools to fetch PR data +- Use your file and code execution tools to generate charts +- Save any generated images to the current working directory +- Be concise in your responses + +""" + } + ) + + # Set up event handling + def handle_event(event): + if event["type"] == "assistant.message": + print(f"\n🤖 {event['data']['content']}\n") + elif event["type"] == "tool.execution_start": + print(f" ⚙️ {event['data']['toolName']}") + + session.on(handle_event) + + # Initial prompt - let Copilot figure out the details + print("\n📊 Starting analysis...\n") + + session.send(prompt=f""" + Fetch the open pull requests for {owner}/{repo_name} from the last week. + Calculate the age of each PR in days. + Then generate a bar chart image showing the distribution of PR ages + (group them into sensible buckets like <1 day, 1-3 days, etc.). + Save the chart as "pr-age-chart.png" in the current directory. + Finally, summarize the PR health - average age, oldest PR, and how many might be considered stale. + """) + + session.wait_for_idle() + + # Interactive loop + print("\n💡 Ask follow-up questions or type \"exit\" to quit.\n") + print("Examples:") + print(" - \"Expand to the last month\"") + print(" - \"Show me the 5 oldest PRs\"") + print(" - \"Generate a pie chart instead\"") + print(" - \"Group by author instead of age\"") + print() + + while True: + user_input = input("You: ").strip() + + if user_input.lower() in ["exit", "quit"]: + print("👋 Goodbye!") + break + + if user_input: + session.send(prompt=user_input) + session.wait_for_idle() + + session.destroy() + client.stop() + +if __name__ == "__main__": + main() diff --git a/cookbook/copilot-sdk/python/recipe/requirements.txt b/cookbook/copilot-sdk/python/recipe/requirements.txt new file mode 100644 index 00000000..c632167a --- /dev/null +++ b/cookbook/copilot-sdk/python/recipe/requirements.txt @@ -0,0 +1,2 @@ +# Install the Copilot SDK package from PyPI +github-copilot-sdk diff --git a/docs/README.agents.md b/docs/README.agents.md index 46cdb411..829eaa06 100644 --- a/docs/README.agents.md +++ b/docs/README.agents.md @@ -19,19 +19,19 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | Title | Description | MCP Servers | | ----- | ----------- | ----------- | -| [.NET Upgrade Collection](../agents/dotnet-upgrade.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. | | +| [.NET Upgrade](../agents/dotnet-upgrade.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. | | | [4.1 Beast Mode v3.1](../agents/4.1-Beast.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2F4.1-Beast.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2F4.1-Beast.agent.md) | GPT 4.1 as a top-notch coding agent. | | | [Accessibility Expert](../agents/accessibility.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faccessibility.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faccessibility.agent.md) | Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing | | | [ADR Generator](../agents/adr-generator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fadr-generator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fadr-generator.agent.md) | Expert agent for creating comprehensive Architectural Decision Records (ADRs) with structured formatting optimized for AI consumption and human readability. | | -| [AEM Front-End Specialist](../agents/aem-frontend-specialist.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md) | Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration | | +| [AEM Front End Specialist](../agents/aem-frontend-specialist.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md) | Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration | | | [Amplitude Experiment Implementation](../agents/amplitude-experiment-implementation.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Famplitude-experiment-implementation.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Famplitude-experiment-implementation.agent.md) | This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features. | | -| [API Architect mode instructions](../agents/api-architect.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md) | Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code. | | +| [API Architect](../agents/api-architect.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md) | Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code. | | | [Apify Integration Expert](../agents/apify-integration-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapify-integration-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapify-integration-expert.agent.md) | Expert agent for integrating Apify Actors into codebases. Handles Actor selection, workflow design, implementation across JavaScript/TypeScript and Python, testing, and production-ready deployment. | [apify](https://github.com/mcp/com.apify/apify-mcp-server)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=apify&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.apify.com%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24APIFY_TOKEN%22%2C%22Content-Type%22%3A%22application%2Fjson%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=apify&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.apify.com%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24APIFY_TOKEN%22%2C%22Content-Type%22%3A%22application%2Fjson%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.apify.com%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24APIFY_TOKEN%22%2C%22Content-Type%22%3A%22application%2Fjson%22%7D%7D) | +| [Arch Linux Expert](../agents/arch-linux-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch-linux-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch-linux-expert.agent.md) | Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows. | | | [Arm Migration Agent](../agents/arm-migration.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farm-migration.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farm-migration.agent.md) | Arm Cloud Migration Assistant accelerates moving x86 workloads to Arm infrastructure. It scans the repository for architecture assumptions, portability issues, container base image and dependency incompatibilities, and recommends Arm-optimized changes. It can drive multi-arch container builds, validate performance, and guide optimization, enabling smooth cross-platform deployment directly inside GitHub. | custom-mcp
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=custom-mcp&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2524%257B%257B%2520github.workspace%2520%257D%257D%253A%252Fworkspace%22%2C%22--name%22%2C%22arm-mcp%22%2C%22armlimited%252Farm-mcp%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=custom-mcp&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2524%257B%257B%2520github.workspace%2520%257D%257D%253A%252Fworkspace%22%2C%22--name%22%2C%22arm-mcp%22%2C%22armlimited%252Farm-mcp%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2524%257B%257B%2520github.workspace%2520%257D%257D%253A%252Fworkspace%22%2C%22--name%22%2C%22arm-mcp%22%2C%22armlimited%252Farm-mcp%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D) | +| [Atlassian Requirements to Jira](../agents/atlassian-requirements-to-jira.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md) | Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow. | | | [Azure AVM Bicep mode](../agents/azure-verified-modules-bicep.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-bicep.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-bicep.agent.md) | Create, update, or review Azure IaC in Bicep using Azure Verified Modules (AVM). | | | [Azure AVM Terraform mode](../agents/azure-verified-modules-terraform.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-terraform.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-terraform.agent.md) | Create, update, or review Azure IaC in Terraform using Azure Verified Modules (AVM). | | -| [Azure Bicep Infrastructure as Code coding Specialist](../agents/bicep-implement.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md) | Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates. | | -| [Azure Bicep Infrastructure Planning](../agents/bicep-plan.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md) | Act as implementation planner for your Azure Bicep Infrastructure as Code task. | | | [Azure Iac Exporter](../agents/azure-iac-exporter.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-exporter.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-exporter.agent.md) | Export existing Azure resources to Infrastructure as Code templates via Azure Resource Graph analysis, Azure Resource Manager API calls, and azure-iac-generator integration. Use this skill when the user asks to export, convert, migrate, or extract existing Azure resources to IaC templates (Bicep, ARM Templates, Terraform, Pulumi). | | | [Azure Iac Generator](../agents/azure-iac-generator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-generator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-generator.agent.md) | Central hub for generating Infrastructure as Code (Bicep, ARM, Terraform, Pulumi) with format-specific validation and best practices. Use this skill when the user asks to generate, create, write, or build infrastructure code, deployment code, or IaC templates in any format (Bicep, ARM Templates, Terraform, Pulumi). | | | [Azure Logic Apps Expert Mode](../agents/azure-logic-apps-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-logic-apps-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-logic-apps-expert.agent.md) | Expert guidance for Azure Logic Apps development focusing on workflow design, integration patterns, and JSON-based Workflow Definition Language. | | @@ -39,20 +39,25 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [Azure SaaS Architect mode instructions](../agents/azure-saas-architect.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-saas-architect.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-saas-architect.agent.md) | Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices. | | | [Azure Terraform IaC Implementation Specialist](../agents/terraform-azure-implement.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-implement.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-implement.agent.md) | Act as an Azure Terraform Infrastructure as Code coding specialist that creates and reviews Terraform for Azure resources. | | | [Azure Terraform Infrastructure Planning](../agents/terraform-azure-planning.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-planning.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-planning.agent.md) | Act as implementation planner for your Azure Terraform Infrastructure as Code task. | | -| [Blueprint Mode Codex v1](../agents/blueprint-mode-codex.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md) | Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. | | -| [Blueprint Mode v39](../agents/blueprint-mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md) | Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. | | +| [Bicep Planning](../agents/bicep-plan.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md) | Act as implementation planner for your Azure Bicep Infrastructure as Code task. | | +| [Bicep Specialist](../agents/bicep-implement.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md) | Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates. | | +| [Blueprint Mode](../agents/blueprint-mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md) | Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. | | +| [Blueprint Mode Codex](../agents/blueprint-mode-codex.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md) | Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. | | | [C# Expert](../agents/CSharpExpert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FCSharpExpert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FCSharpExpert.agent.md) | An agent designed to assist with software development tasks for .NET projects. | | | [C# MCP Server Expert](../agents/csharp-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-mcp-expert.agent.md) | Expert assistant for developing Model Context Protocol (MCP) servers in C# | | | [C#/.NET Janitor](../agents/csharp-dotnet-janitor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-dotnet-janitor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-dotnet-janitor.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. | | +| [C++ Expert](../agents/expert-cpp-software-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. | | | [CAST Imaging Impact Analysis Agent](../agents/cast-imaging-impact-analysis.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-impact-analysis.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-impact-analysis.agent.md) | Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging | imaging-impact-analysis
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-impact-analysis&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-impact-analysis&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) | | [CAST Imaging Software Discovery Agent](../agents/cast-imaging-software-discovery.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-software-discovery.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-software-discovery.agent.md) | Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging | imaging-structural-search
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-structural-search&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-structural-search&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) | | [CAST Imaging Structural Quality Advisor Agent](../agents/cast-imaging-structural-quality-advisor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-structural-quality-advisor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-structural-quality-advisor.agent.md) | Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging | imaging-structural-quality
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-structural-quality&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-structural-quality&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) | +| [CentOS Linux Expert](../agents/centos-linux-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcentos-linux-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcentos-linux-expert.agent.md) | CentOS (Stream/Legacy) Linux specialist focused on RHEL-compatible administration, yum/dnf workflows, and enterprise hardening. | | | [Clojure Interactive Programming](../agents/clojure-interactive-programming.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fclojure-interactive-programming.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fclojure-interactive-programming.agent.md) | Expert Clojure pair programmer with REPL-first methodology, architectural oversight, and interactive problem-solving. Enforces quality standards, prevents workarounds, and develops solutions incrementally through live REPL evaluation before file modifications. | | | [Comet Opik](../agents/comet-opik.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcomet-opik.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcomet-opik.agent.md) | Unified Comet Opik agent for instrumenting LLM apps, managing prompts/projects, auditing prompts, and investigating traces/metrics via the latest Opik MCP server. | opik
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=opik&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22opik-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=opik&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22opik-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22opik-mcp%22%5D%2C%22env%22%3A%7B%7D%7D) | | [Context7 Expert](../agents/context7.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcontext7.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcontext7.agent.md) | Expert in latest library versions, best practices, and correct syntax using up-to-date documentation | [context7](https://github.com/mcp/io.github.upstash/context7)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=context7&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.context7.com%2Fmcp%22%2C%22headers%22%3A%7B%22CONTEXT7_API_KEY%22%3A%22%24%7B%7B%20secrets.COPILOT_MCP_CONTEXT7%20%7D%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=context7&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.context7.com%2Fmcp%22%2C%22headers%22%3A%7B%22CONTEXT7_API_KEY%22%3A%22%24%7B%7B%20secrets.COPILOT_MCP_CONTEXT7%20%7D%7D%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.context7.com%2Fmcp%22%2C%22headers%22%3A%7B%22CONTEXT7_API_KEY%22%3A%22%24%7B%7B%20secrets.COPILOT_MCP_CONTEXT7%20%7D%7D%22%7D%7D) | | [Create PRD Chat Mode](../agents/prd.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprd.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprd.agent.md) | Generate a comprehensive Product Requirements Document (PRD) in Markdown, detailing user stories, acceptance criteria, technical considerations, and metrics. Optionally create GitHub issues upon user confirmation. | | | [Critical thinking mode instructions](../agents/critical-thinking.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcritical-thinking.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcritical-thinking.agent.md) | Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes. | | | [Custom Agent Foundry](../agents/custom-agent-foundry.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcustom-agent-foundry.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcustom-agent-foundry.agent.md) | Expert at designing and creating VS Code custom agents with optimal configurations | | +| [Debian Linux Expert](../agents/debian-linux-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdebian-linux-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdebian-linux-expert.agent.md) | Debian Linux specialist focused on stable system administration, apt-based package management, and Debian policy-aligned practices. | | | [Debug Mode Instructions](../agents/debug.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdebug.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdebug.agent.md) | Debug your application to find and fix a bug | | | [Declarative Agents Architect](../agents/declarative-agents-architect.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdeclarative-agents-architect.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdeclarative-agents-architect.agent.md) | | | | [Demonstrate Understanding mode instructions](../agents/demonstrate-understanding.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdemonstrate-understanding.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdemonstrate-understanding.agent.md) | Validate user understanding of code, design patterns, and implementation details through guided questioning. | | @@ -65,31 +70,30 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [Elasticsearch Agent](../agents/elasticsearch-observability.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felasticsearch-observability.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felasticsearch-observability.agent.md) | Our expert AI assistant for debugging code (O11y), optimizing vector search (RAG), and remediating security threats using live Elastic data. | elastic-mcp
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=elastic-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22mcp-remote%22%2C%22https%253A%252F%252F%257BKIBANA_URL%257D%252Fapi%252Fagent_builder%252Fmcp%22%2C%22--header%22%2C%22Authorization%253A%2524%257BAUTH_HEADER%257D%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=elastic-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22mcp-remote%22%2C%22https%253A%252F%252F%257BKIBANA_URL%257D%252Fapi%252Fagent_builder%252Fmcp%22%2C%22--header%22%2C%22Authorization%253A%2524%257BAUTH_HEADER%257D%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22mcp-remote%22%2C%22https%253A%252F%252F%257BKIBANA_URL%257D%252Fapi%252Fagent_builder%252Fmcp%22%2C%22--header%22%2C%22Authorization%253A%2524%257BAUTH_HEADER%257D%22%5D%2C%22env%22%3A%7B%7D%7D) | | [Electron Code Review Mode Instructions](../agents/electron-angular-native.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felectron-angular-native.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felectron-angular-native.agent.md) | Code Review Mode tailored for Electron app with Node.js backend (main), Angular frontend (render), and native integration layer (e.g., AppleScript, shell, or native tooling). Services in other repos are not reviewed here. | | | [Expert .NET software engineer mode instructions](../agents/expert-dotnet-software-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-dotnet-software-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-dotnet-software-engineer.agent.md) | Provide expert .NET software engineering guidance using modern software design patterns. | | -| [Expert C++ software engineer mode instructions](../agents/expert-cpp-software-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. | | -| [Expert Next.js Developer](../agents/expert-nextjs-developer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md) | Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript | | | [Expert React Frontend Engineer](../agents/expert-react-frontend-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md) | Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization | | +| [Fedora Linux Expert](../agents/fedora-linux-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md) | Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows. | | | [Gilfoyle Code Review Mode](../agents/gilfoyle.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgilfoyle.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgilfoyle.agent.md) | Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code. | | | [GitHub Actions Expert](../agents/github-actions-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgithub-actions-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgithub-actions-expert.agent.md) | GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security | | | [Go MCP Server Development Expert](../agents/go-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgo-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgo-mcp-expert.agent.md) | Expert assistant for building Model Context Protocol (MCP) servers in Go using the official SDK. | | | [GPT 5 Beast Mode](../agents/gpt-5-beast-mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgpt-5-beast-mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgpt-5-beast-mode.agent.md) | Beast Mode 2.0: A powerful autonomous agent tuned specifically for GPT-5 that can solve complex problems by using tools, conducting research, and iterating until the problem is fully resolved. | | -| [High-Level Big Picture Architect (HLBPA)](../agents/hlbpa.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md) | Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. | | -| [Idea Generator mode instructions](../agents/simple-app-idea-generator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. | | +| [High Level Big Picture Architect (HLBPA)](../agents/hlbpa.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md) | Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. | | +| [Idea Generator](../agents/simple-app-idea-generator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. | | | [Implementation Plan Generation Mode](../agents/implementation-plan.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fimplementation-plan.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fimplementation-plan.agent.md) | Generate an implementation plan for new features or refactoring existing code. | | | [Java MCP Expert](../agents/java-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjava-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjava-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Java using reactive streams, the official MCP Java SDK, and Spring Boot integration. | | | [JFrog Security Agent](../agents/jfrog-sec.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjfrog-sec.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjfrog-sec.agent.md) | The dedicated Application Security agent for automated security remediation. Verifies package and version compliance, and suggests vulnerability fixes using JFrog security intelligence. | | | [Kotlin MCP Server Development Expert](../agents/kotlin-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkotlin-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkotlin-mcp-expert.agent.md) | Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK. | | -| [Kusto Assistant: Azure Data Explorer (Kusto) Engineering Assistant](../agents/kusto-assistant.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md) | Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server | | +| [Kusto Assistant](../agents/kusto-assistant.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md) | Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server | | | [Laravel Expert Agent](../agents/laravel-expert-agent.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaravel-expert-agent.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaravel-expert-agent.agent.md) | Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices | | | [Launchdarkly Flag Cleanup](../agents/launchdarkly-flag-cleanup.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaunchdarkly-flag-cleanup.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaunchdarkly-flag-cleanup.agent.md) | A specialized GitHub Copilot agent that uses the LaunchDarkly MCP server to safely automate feature flag cleanup workflows. This agent determines removal readiness, identifies the correct forward value, and creates PRs that preserve production behavior while removing obsolete flags and updating stale defaults. | [launchdarkly](https://github.com/mcp/launchdarkly/mcp-server)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=launchdarkly&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540launchdarkly%252Fmcp-server%22%2C%22--%22%2C%22mcp%22%2C%22start%22%2C%22--api-key%22%2C%22%2524LD_ACCESS_TOKEN%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=launchdarkly&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540launchdarkly%252Fmcp-server%22%2C%22--%22%2C%22mcp%22%2C%22start%22%2C%22--api-key%22%2C%22%2524LD_ACCESS_TOKEN%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540launchdarkly%252Fmcp-server%22%2C%22--%22%2C%22mcp%22%2C%22start%22%2C%22--api-key%22%2C%22%2524LD_ACCESS_TOKEN%22%5D%2C%22env%22%3A%7B%7D%7D) | | [Lingo.dev Localization (i18n) Agent](../agents/lingodotdev-i18n.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flingodotdev-i18n.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flingodotdev-i18n.agent.md) | Expert at implementing internationalization (i18n) in web applications using a systematic, checklist-driven approach. | lingo
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=lingo&config=%7B%22command%22%3A%22%22%2C%22args%22%3A%5B%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=lingo&config=%7B%22command%22%3A%22%22%2C%22args%22%3A%5B%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22%22%2C%22args%22%3A%5B%5D%2C%22env%22%3A%7B%7D%7D) | | [MAUI Expert](../agents/dotnet-maui.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-maui.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-maui.agent.md) | Support development of .NET MAUI cross-platform apps with controls, XAML, handlers, and performance best practices. | | | [MCP M365 Agent Expert](../agents/mcp-m365-agent-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmcp-m365-agent-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmcp-m365-agent-expert.agent.md) | Expert assistant for building MCP-based declarative agents for Microsoft 365 Copilot with Model Context Protocol integration | | -| [Mentor mode instructions](../agents/mentor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md) | Help mentor the engineer by providing guidance and support. | | +| [Mentor mode](../agents/mentor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md) | Help mentor the engineer by providing guidance and support. | | | [Meta Agentic Project Scaffold](../agents/meta-agentic-project-scaffold.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmeta-agentic-project-scaffold.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmeta-agentic-project-scaffold.agent.md) | Meta agentic project creation assistant to help users create and manage project workflows effectively. | | -| [Microsoft Agent Framework .NET mode instructions](../agents/microsoft-agent-framework-dotnet.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework. | | -| [Microsoft Agent Framework Python mode instructions](../agents/microsoft-agent-framework-python.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework. | | +| [Microsoft Agent Framework .NET](../agents/microsoft-agent-framework-dotnet.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework. | | +| [Microsoft Agent Framework Python](../agents/microsoft-agent-framework-python.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework. | | | [Microsoft Learn Contributor](../agents/microsoft_learn_contributor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft_learn_contributor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft_learn_contributor.agent.md) | Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices. | | -| [Microsoft Study and Learn Chat Mode](../agents/microsoft-study-mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md) | Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers. | | +| [Microsoft Study and Learn](../agents/microsoft-study-mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md) | Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers. | | | [Modernization Agent](../agents/modernization.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmodernization.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmodernization.agent.md) | Human-in-the-loop modernization assistant for analyzing, documenting, and planning complete project modernization with architectural recommendations. | | | [Monday Bug Context Fixer](../agents/monday-bug-fixer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmonday-bug-fixer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmonday-bug-fixer.agent.md) | Elite bug-fixing agent that enriches task context from Monday.com platform data. Gathers related items, docs, comments, epics, and requirements to deliver production-quality fixes with comprehensive PRs. | monday-api-mcp
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=monday-api-mcp&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.monday.com%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24MONDAY_TOKEN%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=monday-api-mcp&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.monday.com%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24MONDAY_TOKEN%22%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.monday.com%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24MONDAY_TOKEN%22%7D%7D) | | [Mongodb Performance Advisor](../agents/mongodb-performance-advisor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmongodb-performance-advisor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmongodb-performance-advisor.agent.md) | Analyze MongoDB database performance, offer query and index optimization insights and provide actionable recommendations to improve overall usage of the database. | | @@ -97,6 +101,7 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [Neo4j Docker Client Generator](../agents/neo4j-docker-client-generator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneo4j-docker-client-generator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneo4j-docker-client-generator.agent.md) | AI agent that generates simple, high-quality Python Neo4j client libraries from GitHub issues with proper best practices | neo4j-local
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=neo4j-local&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22NEO4J_URI%22%2C%22-e%22%2C%22NEO4J_USERNAME%22%2C%22-e%22%2C%22NEO4J_PASSWORD%22%2C%22-e%22%2C%22NEO4J_DATABASE%22%2C%22-e%22%2C%22NEO4J_NAMESPACE%253Dneo4j-local%22%2C%22-e%22%2C%22NEO4J_TRANSPORT%253Dstdio%22%2C%22mcp%252Fneo4j-cypher%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=neo4j-local&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22NEO4J_URI%22%2C%22-e%22%2C%22NEO4J_USERNAME%22%2C%22-e%22%2C%22NEO4J_PASSWORD%22%2C%22-e%22%2C%22NEO4J_DATABASE%22%2C%22-e%22%2C%22NEO4J_NAMESPACE%253Dneo4j-local%22%2C%22-e%22%2C%22NEO4J_TRANSPORT%253Dstdio%22%2C%22mcp%252Fneo4j-cypher%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22NEO4J_URI%22%2C%22-e%22%2C%22NEO4J_USERNAME%22%2C%22-e%22%2C%22NEO4J_PASSWORD%22%2C%22-e%22%2C%22NEO4J_DATABASE%22%2C%22-e%22%2C%22NEO4J_NAMESPACE%253Dneo4j-local%22%2C%22-e%22%2C%22NEO4J_TRANSPORT%253Dstdio%22%2C%22mcp%252Fneo4j-cypher%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D) | | [Neon Migration Specialist](../agents/neon-migration-specialist.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-migration-specialist.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-migration-specialist.agent.md) | Safe Postgres migrations with zero-downtime using Neon's branching workflow. Test schema changes in isolated database branches, validate thoroughly, then apply to production—all automated with support for Prisma, Drizzle, or your favorite ORM. | | | [Neon Performance Analyzer](../agents/neon-optimization-analyzer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-optimization-analyzer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-optimization-analyzer.agent.md) | Identify and fix slow Postgres queries automatically using Neon's branching workflow. Analyzes execution plans, tests optimizations in isolated database branches, and provides clear before/after performance metrics with actionable code fixes. | | +| [Next.js Expert](../agents/expert-nextjs-developer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md) | Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript | | | [Octopus Release Notes With Mcp](../agents/octopus-deploy-release-notes-mcp.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md) | Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs. | octopus
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D) | | [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Expert assistant for generating working applications from OpenAPI specifications | | | [PagerDuty Incident Responder](../agents/pagerduty-incident-responder.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md) | Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs. | [pagerduty](https://github.com/mcp/io.github.PagerDuty/pagerduty-mcp)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D) | @@ -113,12 +118,12 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [Power BI Visualization Expert Mode](../agents/power-bi-visualization-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-bi-visualization-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-bi-visualization-expert.agent.md) | Expert Power BI report design and visualization guidance using Microsoft best practices for creating effective, performant, and user-friendly reports and dashboards. | | | [Power Platform Expert](../agents/power-platform-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-expert.agent.md) | Power Platform expert providing guidance on Code Apps, canvas apps, Dataverse, connectors, and Power Platform best practices | | | [Power Platform MCP Integration Expert](../agents/power-platform-mcp-integration-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-mcp-integration-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-mcp-integration-expert.agent.md) | Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns | | -| [Principal software engineer mode instructions](../agents/principal-software-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md) | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation. | | -| [Prompt Builder Instructions](../agents/prompt-builder.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md) | Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai | | +| [Principal software engineer](../agents/principal-software-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md) | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation. | | +| [Prompt Builder](../agents/prompt-builder.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md) | Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai | | | [Prompt Engineer](../agents/prompt-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-engineer.agent.md) | A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt. | | | [Python MCP Server Expert](../agents/python-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpython-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpython-mcp-expert.agent.md) | Expert assistant for developing Model Context Protocol (MCP) servers in Python | | -| [Refine Requirement or Issue Chat Mode](../agents/refine-issue.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md) | Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs | | -| [Requirements to Jira Epic & User Story Creator](../agents/atlassian-requirements-to-jira.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md) | Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow. | | +| [Refine Requirement or Issue](../agents/refine-issue.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md) | Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs | | +| [Repo Architect Agent](../agents/repo-architect.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frepo-architect.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frepo-architect.agent.md) | Bootstraps and validates agentic project structures for GitHub Copilot (VS Code) and OpenCode CLI workflows. Run after `opencode /init` or VS Code Copilot initialization to scaffold proper folder hierarchies, instructions, agents, skills, and prompts. | | | [Ruby MCP Expert](../agents/ruby-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fruby-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fruby-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration. | | | [Rust Beast Mode](../agents/rust-gpt-4.1-beast-mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-gpt-4.1-beast-mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-gpt-4.1-beast-mode.agent.md) | Rust GPT-4.1 Coding Beast Mode for VS Code | | | [Rust MCP Expert](../agents/rust-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-mcp-expert.agent.md) | Expert assistant for Rust MCP server development using the rmcp SDK with tokio async runtime | | @@ -131,12 +136,12 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [SE: Tech Writer](../agents/se-technical-writer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-technical-writer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-technical-writer.agent.md) | Technical writing specialist for creating developer documentation, technical blogs, tutorials, and educational content | | | [SE: UX Designer](../agents/se-ux-ui-designer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-ux-ui-designer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-ux-ui-designer.agent.md) | Jobs-to-be-Done analysis, user journey mapping, and UX research artifacts for Figma and design workflows | | | [Search & AI Optimization Expert](../agents/search-ai-optimization-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsearch-ai-optimization-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsearch-ai-optimization-expert.agent.md) | Expert guidance for modern search optimization: SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) with AI-ready content strategies | | -| [Semantic Kernel .NET mode instructions](../agents/semantic-kernel-dotnet.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel. | | -| [Semantic Kernel Python mode instructions](../agents/semantic-kernel-python.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Semantic Kernel. | | +| [Semantic Kernel .NET](../agents/semantic-kernel-dotnet.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel. | | +| [Semantic Kernel Python](../agents/semantic-kernel-python.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Semantic Kernel. | | | [Senior Cloud Architect](../agents/arch.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch.agent.md) | Expert in modern architecture design patterns, NFR requirements, and creating comprehensive architectural diagrams and documentation | | | [Shopify Expert](../agents/shopify-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fshopify-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fshopify-expert.agent.md) | Expert Shopify development assistant specializing in theme development, Liquid templating, app development, and Shopify APIs | | -| [Software Engineer Agent v1](../agents/software-engineer-agent-v1.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md) | Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively. | | -| [Specification mode instructions](../agents/specification.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md) | Generate or update specification documents for new or existing functionality. | | +| [Software Engineer Agent](../agents/software-engineer-agent-v1.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md) | Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively. | | +| [Specification](../agents/specification.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md) | Generate or update specification documents for new or existing functionality. | | | [Stackhawk Security Onboarding](../agents/stackhawk-security-onboarding.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md) | Automatically set up StackHawk security testing for your repository with generated configuration and GitHub Actions workflow | stackhawk-mcp
[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D) | | [Swift MCP Expert](../agents/swift-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fswift-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fswift-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Swift using modern concurrency features and the official MCP Swift SDK. | | | [Task Planner Instructions](../agents/task-planner.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftask-planner.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftask-planner.agent.md) | Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai | | @@ -154,8 +159,8 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [Ultimate Transparent Thinking Beast Mode](../agents/Ultimate-Transparent-Thinking-Beast-Mode.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FUltimate-Transparent-Thinking-Beast-Mode.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FUltimate-Transparent-Thinking-Beast-Mode.agent.md) | Ultimate Transparent Thinking Beast Mode | | | [Universal Janitor](../agents/janitor.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjanitor.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjanitor.agent.md) | Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation. | | | [Universal PR Comment Addresser](../agents/address-comments.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faddress-comments.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faddress-comments.agent.md) | Address PR comments | | -| [voidBeast_GPT41Enhanced 1.0 - Elite Developer AI Assistant](../agents/voidbeast-gpt41enhanced.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md) | 4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes. | | +| [VoidBeast_GPT41Enhanced 1.0 Elite Developer AI Assistant](../agents/voidbeast-gpt41enhanced.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md) | 4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes. | | | [VSCode Tour Expert](../agents/code-tour.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcode-tour.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcode-tour.agent.md) | Expert agent for creating and maintaining VSCode CodeTour files with comprehensive schema support and best practices | | -| [Wg Code Alchemist](../agents/wg-code-alchemist.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md) | Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design | | -| [Wg Code Sentinel](../agents/wg-code-sentinel.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md) | Ask WG Code Sentinel to review your code for security issues. | | +| [WG Code Alchemist](../agents/wg-code-alchemist.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md) | Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design | | +| [WG Code Sentinel](../agents/wg-code-sentinel.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md) | Ask WG Code Sentinel to review your code for security issues. | | | [WinForms Expert](../agents/WinFormsExpert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md) | Support development of .NET (OOP) WinForms Designer compatible Apps. | | diff --git a/docs/README.instructions.md b/docs/README.instructions.md index 393c8046..e9d48839 100644 --- a/docs/README.instructions.md +++ b/docs/README.instructions.md @@ -22,6 +22,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Angular Development Instructions](../instructions/angular.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fangular.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fangular.instructions.md) | Angular-specific coding standards and best practices | | [Ansible Conventions and Best Practices](../instructions/ansible.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fansible.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fansible.instructions.md) | Ansible conventions and best practices | | [Apex Development](../instructions/apex.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fapex.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fapex.instructions.md) | Guidelines and best practices for Apex development on the Salesforce Platform | +| [Arch Linux Administration Guidelines](../instructions/arch-linux.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Farch-linux.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Farch-linux.instructions.md) | Guidance for Arch Linux administration, pacman workflows, and rolling-release best practices. | | [ASP.NET REST API Development](../instructions/aspnet-rest-apis.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Faspnet-rest-apis.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Faspnet-rest-apis.instructions.md) | Guidelines for building REST APIs with ASP.NET | | [Astro Development Instructions](../instructions/astro.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fastro.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fastro.instructions.md) | Astro development standards and best practices for content-driven websites | | [Azure DevOps Pipeline YAML Best Practices](../instructions/azure-devops-pipelines.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fazure-devops-pipelines.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fazure-devops-pipelines.instructions.md) | Best practices for Azure DevOps Pipeline YAML files | @@ -37,6 +38,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [C# MCP Server Development](../instructions/csharp-mcp-server.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-mcp-server.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-mcp-server.instructions.md) | Instructions for building Model Context Protocol (MCP) servers using the C# SDK | | [C# 코드 작성 규칙](../instructions/csharp-ko.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md) | C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999 | | [C# アプリケーション開発](../instructions/csharp-ja.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md) | C# アプリケーション構築指針 by @tsubakimoto | +| [CentOS Administration Guidelines](../instructions/centos-linux.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcentos-linux.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcentos-linux.instructions.md) | Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations. | | [Clojure Development Instructions](../instructions/clojure.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fclojure.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fclojure.instructions.md) | Clojure-specific coding patterns, inline def usage, code block templates, and namespace handling for Clojure development. | | [Cmake Vcpkg](../instructions/cmake-vcpkg.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md) | C++ project configuration and package management | | [Code Components](../instructions/pcf-code-components.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-code-components.instructions.md) | Understanding code components structure and implementation | @@ -71,11 +73,13 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Dataverse SDK for Python — Real-World Use Cases & Templates](../instructions/dataverse-python-real-world-usecases.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdataverse-python-real-world-usecases.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdataverse-python-real-world-usecases.instructions.md) | Template specific coding standards and best practices | | [Dataverse SDK for Python — Testing & Debugging Strategies](../instructions/dataverse-python-testing-debugging.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdataverse-python-testing-debugging.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdataverse-python-testing-debugging.instructions.md) | Strategie specific coding standards and best practices | | [DDD Systems & .NET Guidelines](../instructions/dotnet-architecture-good-practices.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdotnet-architecture-good-practices.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdotnet-architecture-good-practices.instructions.md) | DDD and .NET architecture guidelines | +| [Debian Linux Administration Guidelines](../instructions/debian-linux.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdebian-linux.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdebian-linux.instructions.md) | Guidance for Debian-based Linux administration, apt workflows, and Debian policy conventions. | | [Define Events (Preview)](../instructions/pcf-events.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-events.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-events.instructions.md) | Define and handle custom events in PCF components | | [Dependent Libraries (Preview)](../instructions/pcf-dependent-libraries.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-dependent-libraries.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpcf-dependent-libraries.instructions.md) | Using dependent libraries in PCF components | | [Dev Box image definitions](../instructions/devbox-image-definition.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevbox-image-definition.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevbox-image-definition.instructions.md) | Authoring recommendations for creating YAML based image definition files for use with Microsoft Dev Box Team Customizations | | [DevOps Core Principles](../instructions/devops-core-principles.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevops-core-principles.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdevops-core-principles.instructions.md) | Foundational instructions covering core DevOps principles, culture (CALMS), and key metrics (DORA) to guide GitHub Copilot in understanding and promoting effective software delivery. | | [Dotnet Wpf](../instructions/dotnet-wpf.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdotnet-wpf.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fdotnet-wpf.instructions.md) | .NET WPF component and application patterns | +| [Fedora Administration Guidelines](../instructions/fedora-linux.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ffedora-linux.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ffedora-linux.instructions.md) | Guidance for Fedora (Red Hat family) systems, dnf workflows, SELinux, and modern systemd practices. | | [Genaiscript](../instructions/genaiscript.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fgenaiscript.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fgenaiscript.instructions.md) | AI-powered script generation guidelines | | [Generate Modern Terraform Code For Azure](../instructions/generate-modern-terraform-code-for-azure.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fgenerate-modern-terraform-code-for-azure.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fgenerate-modern-terraform-code-for-azure.instructions.md) | Guidelines for generating modern Terraform code for Azure | | [Generic Code Review Instructions](../instructions/code-review-generic.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcode-review-generic.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcode-review-generic.instructions.md) | Generic code review instructions that can be customized for any project using GitHub Copilot | @@ -161,6 +165,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Svelte 5 and SvelteKit Development Instructions](../instructions/svelte.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fsvelte.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fsvelte.instructions.md) | Svelte 5 and SvelteKit development standards and best practices for component-based user interfaces and full-stack applications | | [Swift MCP Server Development Guidelines](../instructions/swift-mcp-server.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fswift-mcp-server.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fswift-mcp-server.instructions.md) | Best practices and patterns for building Model Context Protocol (MCP) servers in Swift using the official MCP Swift SDK package. | | [Symfony Development Instructions](../instructions/php-symfony.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-symfony.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-symfony.instructions.md) | Symfony development standards aligned with official Symfony Best Practices | +| [Tailwind CSS v4+ Installation with Vite](../instructions/tailwind-v4-vite.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftailwind-v4-vite.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftailwind-v4-vite.instructions.md) | Tailwind CSS v4+ installation and configuration for Vite projects using the official @tailwindcss/vite plugin | | [Taming Copilot](../instructions/taming-copilot.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftaming-copilot.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftaming-copilot.instructions.md) | Prevent Copilot from wreaking havoc across your codebase, keeping it under control. | | [TanStack Start with Shadcn/ui Development Guide](../instructions/tanstack-start-shadcn-tailwind.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftanstack-start-shadcn-tailwind.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftanstack-start-shadcn-tailwind.instructions.md) | Guidelines for building TanStack Start applications | | [Task Plan Implementation Instructions](../instructions/task-implementation.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftask-implementation.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftask-implementation.instructions.md) | Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai | diff --git a/docs/README.prompts.md b/docs/README.prompts.md index 7a1d0408..6a828118 100644 --- a/docs/README.prompts.md +++ b/docs/README.prompts.md @@ -23,6 +23,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [AI Model Recommendation for Copilot Chat Modes and Prompts](../prompts/model-recommendation.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmodel-recommendation.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmodel-recommendation.prompt.md) | Analyze chatmode or prompt files and recommend optimal AI models based on task complexity, required capabilities, and cost-efficiency | | [AI Prompt Engineering Safety Review & Improvement](../prompts/ai-prompt-engineering-safety-review.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fai-prompt-engineering-safety-review.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fai-prompt-engineering-safety-review.prompt.md) | Comprehensive AI prompt engineering safety review and improvement prompt. Analyzes prompts for safety, bias, security vulnerabilities, and effectiveness while providing detailed improvement recommendations with extensive frameworks, testing methodologies, and educational content. | | [Apple App Store Reviewer](../prompts/apple-appstore-reviewer.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fapple-appstore-reviewer.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fapple-appstore-reviewer.prompt.md) | Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons. | +| [Arch Linux Triage](../prompts/arch-linux-triage.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Farch-linux-triage.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Farch-linux-triage.prompt.md) | Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices. | | [ASP.NET .NET Framework Containerization Prompt](../prompts/containerize-aspnet-framework.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcontainerize-aspnet-framework.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcontainerize-aspnet-framework.prompt.md) | Containerize an ASP.NET .NET Framework project by creating Dockerfile and .dockerfile files customized for the project. | | [ASP.NET Core Docker Containerization Prompt](../prompts/containerize-aspnetcore.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcontainerize-aspnetcore.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcontainerize-aspnetcore.prompt.md) | Containerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project. | | [ASP.NET Minimal API with OpenAPI](../prompts/aspnet-minimal-api-openapi.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Faspnet-minimal-api-openapi.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Faspnet-minimal-api-openapi.prompt.md) | Create ASP.NET Minimal API endpoints with proper OpenAPI documentation | @@ -33,6 +34,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [Boost Prompt](../prompts/boost-prompt.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fboost-prompt.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fboost-prompt.prompt.md) | Interactive prompt refinement workflow: interrogates scope, deliverables, constraints; copies final markdown to clipboard; never writes code. Requires the Joyride extension. | | [C# Async Programming Best Practices](../prompts/csharp-async.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-async.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-async.prompt.md) | Get best practices for C# async programming | | [C# Documentation Best Practices](../prompts/csharp-docs.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-docs.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-docs.prompt.md) | Ensure that C# types are documented with XML comments and follow best practices for documentation. | +| [CentOS Linux Triage](../prompts/centos-linux-triage.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcentos-linux-triage.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcentos-linux-triage.prompt.md) | Triage and resolve CentOS issues using RHEL-compatible tooling, SELinux-aware practices, and firewalld. | | [Code Exemplars Blueprint Generator](../prompts/code-exemplars-blueprint-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcode-exemplars-blueprint-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcode-exemplars-blueprint-generator.prompt.md) | Technology-agnostic prompt generator that creates customizable AI prompts for scanning codebases and identifying high-quality code exemplars. Supports multiple programming languages (.NET, Java, JavaScript, TypeScript, React, Angular, Python) with configurable analysis depth, categorization methods, and documentation formats to establish coding standards and maintain consistency across development teams. | | [Comment Code Generate A Tutorial](../prompts/comment-code-generate-a-tutorial.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcomment-code-generate-a-tutorial.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcomment-code-generate-a-tutorial.prompt.md) | Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial. | | [Comprehensive Project Architecture Blueprint Generator](../prompts/architecture-blueprint-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Farchitecture-blueprint-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Farchitecture-blueprint-generator.prompt.md) | Comprehensive project architecture blueprint generator that analyzes codebases to create detailed architectural documentation. Automatically detects technology stacks and architectural patterns, generates visual diagrams, documents implementation patterns, and provides extensible blueprints for maintaining architectural consistency and guiding new development. | @@ -61,6 +63,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [Dataverse Python Use Case Solution Builder](../prompts/dataverse-python-usecase-builder.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdataverse-python-usecase-builder.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdataverse-python-usecase-builder.prompt.md) | Generate complete solutions for specific Dataverse SDK use cases with architecture recommendations | | [Dataverse Python Advanced Patterns](../prompts/dataverse-python-advanced-patterns.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdataverse-python-advanced-patterns.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdataverse-python-advanced-patterns.prompt.md) | Generate production code for Dataverse SDK using advanced patterns, error handling, and optimization techniques. | | [Dataverse Python Quickstart Generator](../prompts/dataverse-python-quickstart.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdataverse-python-quickstart.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdataverse-python-quickstart.prompt.md) | Generate Python SDK setup + CRUD + bulk + paging snippets using official patterns. | +| [Debian Linux Triage](../prompts/debian-linux-triage.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdebian-linux-triage.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdebian-linux-triage.prompt.md) | Triage and resolve Debian Linux issues with apt, systemd, and AppArmor-aware guidance. | | [DevOps Rollout Plan Generator](../prompts/devops-rollout-plan.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdevops-rollout-plan.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdevops-rollout-plan.prompt.md) | Generate comprehensive rollout plans with preflight checks, step-by-step deployment, verification signals, rollback procedures, and communication plans for infrastructure and application changes | | [Diátaxis Documentation Expert](../prompts/documentation-writer.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdocumentation-writer.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdocumentation-writer.prompt.md) | Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework. | | [EditorConfig Expert](../prompts/editorconfig.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Feditorconfig.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Feditorconfig.prompt.md) | Generates a comprehensive and best-practice-oriented .editorconfig file based on project analysis and user preferences. | @@ -69,6 +72,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [Epic Product Requirements Document (PRD) Prompt](../prompts/breakdown-epic-pm.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-epic-pm.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-epic-pm.prompt.md) | Prompt for creating an Epic Product Requirements Document (PRD) for a new epic. This PRD will be used as input for generating a technical architecture specification. | | [Feature Implementation Plan Prompt](../prompts/breakdown-feature-implementation.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-implementation.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-implementation.prompt.md) | Prompt for creating detailed feature implementation plans, following Epoch monorepo structure. | | [Feature PRD Prompt](../prompts/breakdown-feature-prd.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-prd.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-prd.prompt.md) | Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic. | +| [Fedora Linux Triage](../prompts/fedora-linux-triage.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffedora-linux-triage.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffedora-linux-triage.prompt.md) | Triage and resolve Fedora issues with dnf, systemd, and SELinux-aware guidance. | | [Finalize Agent Prompt](../prompts/finalize-agent-prompt.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffinalize-agent-prompt.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffinalize-agent-prompt.prompt.md) | Finalize prompt file using the role of an AI agent to polish the prompt for the end user. | | [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Generate a complete, production-ready application from an OpenAPI specification | | [Generate C# MCP Server](../prompts/csharp-mcp-server-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mcp-server-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mcp-server-generator.prompt.md) | Generate a complete MCP server project in C# with tools, prompts, and proper configuration | diff --git a/docs/README.skills.md b/docs/README.skills.md index 45a9d055..bdb1c155 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -37,6 +37,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code | [image-manipulation-image-magick](../skills/image-manipulation-image-magick/SKILL.md) | Process and manipulate images using ImageMagick. Supports resizing, format conversion, batch processing, and retrieving image metadata. Use when working with images, creating thumbnails, resizing wallpapers, or performing batch image operations. | None | | [legacy-circuit-mockups](../skills/legacy-circuit-mockups/SKILL.md) | Generate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic component placements, draw breadboard diagrams, mockup 6502 builds, generate retro computer schematics, or design vintage electronics projects. Supports 555 timers, W65C02S microprocessors, 28C256 EEPROMs, W65C22 VIA chips, 7400-series logic gates, LEDs, resistors, capacitors, switches, buttons, crystals, and wires. | `references/28256-eeprom.md`
`references/555.md`
`references/6502.md`
`references/6522.md`
`references/6C62256.md`
`references/7400-series.md`
`references/assembly-compiler.md`
`references/assembly-language.md`
`references/basic-electronic-components.md`
`references/breadboard.md`
`references/common-breadboard-components.md`
`references/connecting-electronic-components.md`
`references/emulator-28256-eeprom.md`
`references/emulator-6502.md`
`references/emulator-6522.md`
`references/emulator-6C62256.md`
`references/emulator-lcd.md`
`references/lcd.md`
`references/minipro.md`
`references/t48eeprom-programmer.md` | | [make-skill-template](../skills/make-skill-template/SKILL.md) | Create new Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities with bundled resources. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders. | None | +| [markdown-to-html](../skills/markdown-to-html/SKILL.md) | Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors. | `references/basic-markdown-to-html.md`
`references/basic-markdown.md`
`references/code-blocks-to-html.md`
`references/code-blocks.md`
`references/collapsed-sections-to-html.md`
`references/collapsed-sections.md`
`references/gomarkdown.md`
`references/hugo.md`
`references/jekyll.md`
`references/marked.md`
`references/pandoc.md`
`references/tables-to-html.md`
`references/tables.md`
`references/writing-mathematical-expressions-to-html.md`
`references/writing-mathematical-expressions.md` | | [mcp-cli](../skills/mcp-cli/SKILL.md) | Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line. | None | | [microsoft-code-reference](../skills/microsoft-code-reference/SKILL.md) | Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs. | None | | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. | None | @@ -46,8 +47,10 @@ Skills differ from other primitives by supporting bundled assets (scripts, code | [refactor](../skills/refactor/SKILL.md) | Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements. | None | | [scoutqa-test](../skills/scoutqa-test/SKILL.md) | This skill should be used when the user asks to "test this website", "run exploratory testing", "check for accessibility issues", "verify the login flow works", "find bugs on this page", or requests automated QA testing. Triggers on web application testing scenarios including smoke tests, accessibility audits, e-commerce flows, and user flow validation using ScoutQA CLI. IMPORTANT: Use this skill proactively after implementing web application features to verify they work correctly - don't wait for the user to ask for testing. | None | | [snowflake-semanticview](../skills/snowflake-semanticview/SKILL.md) | Create, alter, and validate Snowflake semantic views using Snowflake CLI (snow). Use when asked to build or troubleshoot semantic views/semantic layer definitions with CREATE/ALTER SEMANTIC VIEW, to validate semantic-view DDL against Snowflake via CLI, or to guide Snowflake CLI installation and connection setup. | None | +| [terraform-azurerm-set-diff-analyzer](../skills/terraform-azurerm-set-diff-analyzer/SKILL.md) | Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attributes) and actual resource changes. Use when reviewing terraform plan output for Azure resources like Application Gateway, Load Balancer, Firewall, Front Door, NSG, and other resources with Set-type attributes that cause spurious diffs due to internal ordering changes. | `references/azurerm_set_attributes.json`
`references/azurerm_set_attributes.md`
`scripts/.gitignore`
`scripts/README.md`
`scripts/analyze_plan.py` | | [vscode-ext-commands](../skills/vscode-ext-commands/SKILL.md) | Guidelines for contributing commands in VS Code extensions. Indicates naming convention, visibility, localization and other relevant attributes, following VS Code extension development guidelines, libraries and good practices | None | | [vscode-ext-localization](../skills/vscode-ext-localization/SKILL.md) | Guidelines for proper localization of VS Code extensions, following VS Code extension development guidelines, libraries and good practices | None | | [web-design-reviewer](../skills/web-design-reviewer/SKILL.md) | This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level. | `references/framework-fixes.md`
`references/visual-checklist.md` | | [webapp-testing](../skills/webapp-testing/SKILL.md) | Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. | `test-helper.js` | +| [winapp-cli](../skills/winapp-cli/SKILL.md) | Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, or access Windows SDK build tools. Supports .NET, C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows. | None | | [workiq-copilot](../skills/workiq-copilot/SKILL.md) | Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations. | None | diff --git a/eng/constants.mjs b/eng/constants.mjs index a690076e..180980a2 100644 --- a/eng/constants.mjs +++ b/eng/constants.mjs @@ -123,6 +123,7 @@ const PROMPTS_DIR = path.join(ROOT_FOLDER, "prompts"); const AGENTS_DIR = path.join(ROOT_FOLDER, "agents"); const SKILLS_DIR = path.join(ROOT_FOLDER, "skills"); const COLLECTIONS_DIR = path.join(ROOT_FOLDER, "collections"); +const COOKBOOK_DIR = path.join(ROOT_FOLDER, "cookbook"); const MAX_COLLECTION_ITEMS = 50; // Agent Skills validation constants @@ -145,6 +146,7 @@ export { AGENTS_DIR, SKILLS_DIR, COLLECTIONS_DIR, + COOKBOOK_DIR, MAX_COLLECTION_ITEMS, SKILL_NAME_MIN_LENGTH, SKILL_NAME_MAX_LENGTH, diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs new file mode 100644 index 00000000..4a9b895c --- /dev/null +++ b/eng/generate-website-data.mjs @@ -0,0 +1,824 @@ +#!/usr/bin/env node + +/** + * Generate JSON metadata files for the GitHub Pages website. + * This script extracts metadata from agents, prompts, instructions, skills, and collections + * and writes them to website/data/ for client-side search and display. + */ + +import fs from "fs"; +import path, { dirname } from "path"; +import { fileURLToPath } from "url"; +import { + AGENTS_DIR, + COLLECTIONS_DIR, + COOKBOOK_DIR, + INSTRUCTIONS_DIR, + PROMPTS_DIR, + ROOT_FOLDER, + SKILLS_DIR, +} from "./constants.mjs"; +import { + parseCollectionYaml, + parseFrontmatter, + parseSkillMetadata, + parseYamlFile, +} from "./yaml-parser.mjs"; + +const __filename = fileURLToPath(import.meta.url); + +const WEBSITE_DIR = path.join(ROOT_FOLDER, "website"); +const WEBSITE_DATA_DIR = path.join(WEBSITE_DIR, "public", "data"); +const WEBSITE_SOURCE_DATA_DIR = path.join(WEBSITE_DIR, "data"); + +/** + * Ensure the output directory exists + */ +function ensureDataDir() { + if (!fs.existsSync(WEBSITE_DATA_DIR)) { + fs.mkdirSync(WEBSITE_DATA_DIR, { recursive: true }); + } +} + +/** + * Extract title from filename or frontmatter + */ +function extractTitle(filePath, frontmatter) { + if (frontmatter?.name) { + return frontmatter.name + .split("-") + .map((word) => word.charAt(0).toUpperCase() + word.slice(1)) + .join(" "); + } + // Fallback to filename + const basename = path.basename(filePath); + const name = basename + .replace(/\.(agent|prompt|instructions)\.md$/, "") + .replace(/\.md$/, ""); + return name + .split("-") + .map((word) => word.charAt(0).toUpperCase() + word.slice(1)) + .join(" "); +} + +/** + * Generate agents metadata + */ +function generateAgentsData() { + const agents = []; + const files = fs + .readdirSync(AGENTS_DIR) + .filter((f) => f.endsWith(".agent.md")); + + // Track all unique values for filters + const allModels = new Set(); + const allTools = new Set(); + + for (const file of files) { + const filePath = path.join(AGENTS_DIR, file); + const frontmatter = parseFrontmatter(filePath); + const relativePath = path + .relative(ROOT_FOLDER, filePath) + .replace(/\\/g, "/"); + + const model = frontmatter?.model || null; + const tools = frontmatter?.tools || []; + const handoffs = frontmatter?.handoffs || []; + + // Track unique values + if (model) allModels.add(model); + tools.forEach((t) => allTools.add(t)); + + agents.push({ + id: file.replace(".agent.md", ""), + title: extractTitle(filePath, frontmatter), + description: frontmatter?.description || "", + model: model, + tools: tools, + hasHandoffs: handoffs.length > 0, + handoffs: handoffs.map((h) => ({ + label: h.label || "", + agent: h.agent || "", + })), + mcpServers: frontmatter?.["mcp-servers"] + ? Object.keys(frontmatter["mcp-servers"]) + : [], + path: relativePath, + filename: file, + }); + } + + // Sort and return with filter metadata + const sortedAgents = agents.sort((a, b) => a.title.localeCompare(b.title)); + + return { + items: sortedAgents, + filters: { + models: ["(none)", ...Array.from(allModels).sort()], + tools: Array.from(allTools).sort(), + }, + }; +} + +/** + * Generate prompts metadata + */ +function generatePromptsData() { + const prompts = []; + const files = fs + .readdirSync(PROMPTS_DIR) + .filter((f) => f.endsWith(".prompt.md")); + + // Track all unique tools for filters + const allTools = new Set(); + + for (const file of files) { + const filePath = path.join(PROMPTS_DIR, file); + const frontmatter = parseFrontmatter(filePath); + const relativePath = path + .relative(ROOT_FOLDER, filePath) + .replace(/\\/g, "/"); + + const tools = frontmatter?.tools || []; + tools.forEach((t) => allTools.add(t)); + + prompts.push({ + id: file.replace(".prompt.md", ""), + title: extractTitle(filePath, frontmatter), + description: frontmatter?.description || "", + agent: frontmatter?.agent || null, + model: frontmatter?.model || null, + tools: tools, + path: relativePath, + filename: file, + }); + } + + const sortedPrompts = prompts.sort((a, b) => a.title.localeCompare(b.title)); + + return { + items: sortedPrompts, + filters: { + tools: Array.from(allTools).sort(), + }, + }; +} + +/** + * Parse applyTo field into an array of patterns + */ +function parseApplyToPatterns(applyTo) { + if (!applyTo) return []; + + // Handle array format + if (Array.isArray(applyTo)) { + return applyTo.map((p) => p.trim()).filter((p) => p.length > 0); + } + + // Handle string format (comma-separated) + if (typeof applyTo === "string") { + return applyTo + .split(",") + .map((p) => p.trim()) + .filter((p) => p.length > 0); + } + + return []; +} + +/** + * Extract file extension from a glob pattern + */ +function extractExtensionFromPattern(pattern) { + // Match patterns like **.ts, **/*.js, *.py, etc. + const match = pattern.match(/\*\.(\w+)$/); + if (match) return `.${match[1]}`; + + // Match patterns like **/*.{ts,tsx} + const braceMatch = pattern.match(/\*\.\{([^}]+)\}$/); + if (braceMatch) { + return braceMatch[1].split(",").map((ext) => `.${ext.trim()}`); + } + + return null; +} + +/** + * Generate instructions metadata + */ +function generateInstructionsData() { + const instructions = []; + const files = fs + .readdirSync(INSTRUCTIONS_DIR) + .filter((f) => f.endsWith(".instructions.md")); + + // Track all unique patterns and extensions for filters + const allPatterns = new Set(); + const allExtensions = new Set(); + + for (const file of files) { + const filePath = path.join(INSTRUCTIONS_DIR, file); + const frontmatter = parseFrontmatter(filePath); + const relativePath = path + .relative(ROOT_FOLDER, filePath) + .replace(/\\/g, "/"); + + const applyToRaw = frontmatter?.applyTo || null; + const applyToPatterns = parseApplyToPatterns(applyToRaw); + + // Extract extensions from patterns + const extensions = []; + for (const pattern of applyToPatterns) { + allPatterns.add(pattern); + const ext = extractExtensionFromPattern(pattern); + if (ext) { + if (Array.isArray(ext)) { + ext.forEach((e) => { + extensions.push(e); + allExtensions.add(e); + }); + } else { + extensions.push(ext); + allExtensions.add(ext); + } + } + } + + instructions.push({ + id: file.replace(".instructions.md", ""), + title: extractTitle(filePath, frontmatter), + description: frontmatter?.description || "", + applyTo: applyToRaw, + applyToPatterns: applyToPatterns, + extensions: [...new Set(extensions)], + path: relativePath, + filename: file, + }); + } + + const sortedInstructions = instructions.sort((a, b) => + a.title.localeCompare(b.title) + ); + + return { + items: sortedInstructions, + filters: { + patterns: Array.from(allPatterns).sort(), + extensions: ["(none)", ...Array.from(allExtensions).sort()], + }, + }; +} + +/** + * Categorize a skill based on its name and description + */ +function categorizeSkill(name, description) { + const text = `${name} ${description}`.toLowerCase(); + + if (text.includes("azure") || text.includes("appinsights")) return "Azure"; + if ( + text.includes("github") || + text.includes("gh-cli") || + text.includes("git-commit") || + text.includes("git ") + ) + return "Git & GitHub"; + if (text.includes("vscode") || text.includes("vs code")) return "VS Code"; + if ( + text.includes("test") || + text.includes("qa") || + text.includes("playwright") + ) + return "Testing"; + if ( + text.includes("microsoft") || + text.includes("m365") || + text.includes("workiq") + ) + return "Microsoft"; + if (text.includes("cli") || text.includes("command")) return "CLI Tools"; + if ( + text.includes("diagram") || + text.includes("plantuml") || + text.includes("visual") + ) + return "Diagrams"; + if ( + text.includes("nuget") || + text.includes("dotnet") || + text.includes(".net") + ) + return ".NET"; + + return "Other"; +} + +/** + * Generate skills metadata + */ +function generateSkillsData() { + const skills = []; + + if (!fs.existsSync(SKILLS_DIR)) { + return { items: [], filters: { categories: [], hasAssets: ["Yes", "No"] } }; + } + + const folders = fs + .readdirSync(SKILLS_DIR) + .filter((f) => fs.statSync(path.join(SKILLS_DIR, f)).isDirectory()); + + const allCategories = new Set(); + + for (const folder of folders) { + const skillPath = path.join(SKILLS_DIR, folder); + const metadata = parseSkillMetadata(skillPath); + + if (metadata) { + const relativePath = path + .relative(ROOT_FOLDER, skillPath) + .replace(/\\/g, "/"); + const category = categorizeSkill(metadata.name, metadata.description); + allCategories.add(category); + + // Get all files in the skill folder recursively + const files = getSkillFiles(skillPath, relativePath); + + skills.push({ + id: folder, + name: metadata.name, + title: metadata.name + .split("-") + .map((word) => word.charAt(0).toUpperCase() + word.slice(1)) + .join(" "), + description: metadata.description, + assets: metadata.assets, + hasAssets: metadata.assets.length > 0, + assetCount: metadata.assets.length, + category: category, + path: relativePath, + skillFile: `${relativePath}/SKILL.md`, + files: files, + }); + } + } + + const sortedSkills = skills.sort((a, b) => a.title.localeCompare(b.title)); + + return { + items: sortedSkills, + filters: { + categories: Array.from(allCategories).sort(), + hasAssets: ["Yes", "No"], + }, + }; +} + +/** + * Get all files in a skill folder recursively + */ +function getSkillFiles(skillPath, relativePath) { + const files = []; + + function walkDir(dir, relDir) { + const entries = fs.readdirSync(dir, { withFileTypes: true }); + for (const entry of entries) { + const fullPath = path.join(dir, entry.name); + const relPath = relDir ? `${relDir}/${entry.name}` : entry.name; + + if (entry.isDirectory()) { + walkDir(fullPath, relPath); + } else { + // Get file size + const stats = fs.statSync(fullPath); + files.push({ + path: `${relativePath}/${relPath}`, + name: relPath, + size: stats.size, + }); + } + } + } + + walkDir(skillPath, ""); + return files; +} + +/** + * Generate collections metadata + */ +function generateCollectionsData() { + const collections = []; + + if (!fs.existsSync(COLLECTIONS_DIR)) { + return collections; + } + + const files = fs + .readdirSync(COLLECTIONS_DIR) + .filter((f) => f.endsWith(".collection.yml")); + + // Track all unique tags + const allTags = new Set(); + + for (const file of files) { + const filePath = path.join(COLLECTIONS_DIR, file); + const data = parseCollectionYaml(filePath); + const relativePath = path + .relative(ROOT_FOLDER, filePath) + .replace(/\\/g, "/"); + + if (data) { + const tags = data.tags || []; + tags.forEach((t) => allTags.add(t)); + + // featured can be at top level or nested under display + const featured = data.featured || data.display?.featured || false; + + collections.push({ + id: file.replace(".collection.yml", ""), + name: data.name || file.replace(".collection.yml", ""), + description: data.description || "", + tags: tags, + featured: featured, + items: (data.items || []).map((item) => ({ + path: item.path, + kind: item.kind, + usage: item.usage || null, + })), + path: relativePath, + filename: file, + }); + } + } + + // Sort with featured first, then alphabetically + const sortedCollections = collections.sort((a, b) => { + if (a.featured && !b.featured) return -1; + if (!a.featured && b.featured) return 1; + return a.name.localeCompare(b.name); + }); + + return { + items: sortedCollections, + filters: { + tags: Array.from(allTags).sort(), + }, + }; +} + +/** + * Generate tools metadata from website/data/tools.yml + */ +function generateToolsData() { + const toolsFile = path.join(WEBSITE_SOURCE_DATA_DIR, "tools.yml"); + + if (!fs.existsSync(toolsFile)) { + console.warn("No tools.yml file found at", toolsFile); + return { items: [], filters: { categories: [], tags: [] } }; + } + + const data = parseYamlFile(toolsFile); + + if (!data || !data.tools) { + return { items: [], filters: { categories: [], tags: [] } }; + } + + const allCategories = new Set(); + const allTags = new Set(); + + const tools = data.tools.map((tool) => { + const category = tool.category || "Other"; + allCategories.add(category); + + const tags = tool.tags || []; + tags.forEach((t) => allTags.add(t)); + + return { + id: tool.id, + name: tool.name, + description: tool.description || "", + category: category, + featured: tool.featured || false, + requirements: tool.requirements || [], + features: tool.features || [], + links: tool.links || {}, + configuration: tool.configuration || null, + tags: tags, + }; + }); + + // Sort with featured first, then alphabetically + const sortedTools = tools.sort((a, b) => { + if (a.featured && !b.featured) return -1; + if (!a.featured && b.featured) return 1; + return a.name.localeCompare(b.name); + }); + + return { + items: sortedTools, + filters: { + categories: Array.from(allCategories).sort(), + tags: Array.from(allTags).sort(), + }, + }; +} + +/** + * Generate a combined index for search + */ +function generateSearchIndex( + agents, + prompts, + instructions, + skills, + collections +) { + const index = []; + + for (const agent of agents) { + index.push({ + type: "agent", + id: agent.id, + title: agent.title, + description: agent.description, + path: agent.path, + searchText: `${agent.title} ${agent.description} ${agent.tools.join( + " " + )}`.toLowerCase(), + }); + } + + for (const prompt of prompts) { + index.push({ + type: "prompt", + id: prompt.id, + title: prompt.title, + description: prompt.description, + path: prompt.path, + searchText: `${prompt.title} ${prompt.description}`.toLowerCase(), + }); + } + + for (const instruction of instructions) { + index.push({ + type: "instruction", + id: instruction.id, + title: instruction.title, + description: instruction.description, + path: instruction.path, + searchText: `${instruction.title} ${instruction.description} ${ + instruction.applyTo || "" + }`.toLowerCase(), + }); + } + + for (const skill of skills) { + index.push({ + type: "skill", + id: skill.id, + title: skill.title, + description: skill.description, + path: skill.skillFile, + searchText: `${skill.title} ${skill.description}`.toLowerCase(), + }); + } + + for (const collection of collections) { + index.push({ + type: "collection", + id: collection.id, + title: collection.name, + description: collection.description, + path: collection.path, + tags: collection.tags, + searchText: `${collection.name} ${ + collection.description + } ${collection.tags.join(" ")}`.toLowerCase(), + }); + } + + return index; +} + +/** + * Generate samples/cookbook data from cookbook.yml + */ +function generateSamplesData() { + const cookbookYamlPath = path.join(COOKBOOK_DIR, "cookbook.yml"); + + if (!fs.existsSync(cookbookYamlPath)) { + console.warn( + "Warning: cookbook/cookbook.yml not found, skipping samples generation" + ); + return { + cookbooks: [], + totalRecipes: 0, + totalCookbooks: 0, + filters: { languages: [], tags: [] }, + }; + } + + const cookbookManifest = parseYamlFile(cookbookYamlPath); + if (!cookbookManifest || !cookbookManifest.cookbooks) { + console.warn("Warning: Invalid cookbook.yml format"); + return { + cookbooks: [], + totalRecipes: 0, + totalCookbooks: 0, + filters: { languages: [], tags: [] }, + }; + } + + const allLanguages = new Set(); + const allTags = new Set(); + let totalRecipes = 0; + + const cookbooks = cookbookManifest.cookbooks.map((cookbook) => { + // Collect languages + cookbook.languages.forEach((lang) => allLanguages.add(lang.id)); + + // Process recipes and add file paths + const recipes = cookbook.recipes.map((recipe) => { + // Collect tags + if (recipe.tags) { + recipe.tags.forEach((tag) => allTags.add(tag)); + } + + // Build variants with file paths for each language + const variants = {}; + cookbook.languages.forEach((lang) => { + const docPath = `${cookbook.path}/${lang.id}/${recipe.id}.md`; + const examplePath = `${cookbook.path}/${lang.id}/recipe/${recipe.id}${lang.extension}`; + + // Check if files exist + const docFullPath = path.join(ROOT_FOLDER, docPath); + const exampleFullPath = path.join(ROOT_FOLDER, examplePath); + + if (fs.existsSync(docFullPath)) { + variants[lang.id] = { + doc: docPath, + example: fs.existsSync(exampleFullPath) ? examplePath : null, + }; + } + }); + + totalRecipes++; + + return { + id: recipe.id, + name: recipe.name, + description: recipe.description, + tags: recipe.tags || [], + variants, + }; + }); + + return { + id: cookbook.id, + name: cookbook.name, + description: cookbook.description, + path: cookbook.path, + featured: cookbook.featured || false, + languages: cookbook.languages, + recipes, + }; + }); + + return { + cookbooks, + totalRecipes, + totalCookbooks: cookbooks.length, + filters: { + languages: Array.from(allLanguages).sort(), + tags: Array.from(allTags).sort(), + }, + }; +} + +/** + * Main function + */ +async function main() { + console.log("Generating website data...\n"); + + ensureDataDir(); + + // Generate all data + const agentsData = generateAgentsData(); + const agents = agentsData.items; + console.log( + `✓ Generated ${agents.length} agents (${agentsData.filters.models.length} models, ${agentsData.filters.tools.length} tools)` + ); + + const promptsData = generatePromptsData(); + const prompts = promptsData.items; + console.log( + `✓ Generated ${prompts.length} prompts (${promptsData.filters.tools.length} tools)` + ); + + const instructionsData = generateInstructionsData(); + const instructions = instructionsData.items; + console.log( + `✓ Generated ${instructions.length} instructions (${instructionsData.filters.extensions.length} extensions)` + ); + + const skillsData = generateSkillsData(); + const skills = skillsData.items; + console.log( + `✓ Generated ${skills.length} skills (${skillsData.filters.categories.length} categories)` + ); + + const collectionsData = generateCollectionsData(); + const collections = collectionsData.items; + console.log( + `✓ Generated ${collections.length} collections (${collectionsData.filters.tags.length} tags)` + ); + + const toolsData = generateToolsData(); + const tools = toolsData.items; + console.log( + `✓ Generated ${tools.length} tools (${toolsData.filters.categories.length} categories)` + ); + + const samplesData = generateSamplesData(); + console.log( + `✓ Generated ${samplesData.totalRecipes} recipes in ${samplesData.totalCookbooks} cookbooks (${samplesData.filters.languages.length} languages, ${samplesData.filters.tags.length} tags)` + ); + + const searchIndex = generateSearchIndex( + agents, + prompts, + instructions, + skills, + collections + ); + console.log(`✓ Generated search index with ${searchIndex.length} items`); + + // Write JSON files + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "agents.json"), + JSON.stringify(agentsData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "prompts.json"), + JSON.stringify(promptsData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "instructions.json"), + JSON.stringify(instructionsData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "skills.json"), + JSON.stringify(skillsData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "collections.json"), + JSON.stringify(collectionsData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "tools.json"), + JSON.stringify(toolsData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "samples.json"), + JSON.stringify(samplesData, null, 2) + ); + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "search-index.json"), + JSON.stringify(searchIndex, null, 2) + ); + + // Generate a manifest with counts and timestamps + const manifest = { + generated: new Date().toISOString(), + counts: { + agents: agents.length, + prompts: prompts.length, + instructions: instructions.length, + skills: skills.length, + collections: collections.length, + tools: tools.length, + samples: samplesData.totalRecipes, + total: searchIndex.length, + }, + }; + + fs.writeFileSync( + path.join(WEBSITE_DATA_DIR, "manifest.json"), + JSON.stringify(manifest, null, 2) + ); + + console.log(`\n✓ All data written to website/public/data/`); +} + +main().catch((err) => { + console.error("Error generating website data:", err); + process.exit(1); +}); diff --git a/eng/update-readme.mjs b/eng/update-readme.mjs index b36d1351..99d4268b 100644 --- a/eng/update-readme.mjs +++ b/eng/update-readme.mjs @@ -128,12 +128,7 @@ function extractTitle(filePath) { const frontmatter = parseFrontmatter(filePath); if (frontmatter) { - // Check for title field - if (frontmatter.title && typeof frontmatter.title === "string") { - return frontmatter.title; - } - - // Check for name field and convert to title case + // Check for name field if (frontmatter.name && typeof frontmatter.name === "string") { return frontmatter.name .split("-") diff --git a/eng/yaml-parser.mjs b/eng/yaml-parser.mjs index 671fbc81..822a8067 100644 --- a/eng/yaml-parser.mjs +++ b/eng/yaml-parser.mjs @@ -195,6 +195,22 @@ function parseSkillMetadata(skillPath) { ); } +/** + * Parse a generic YAML file (used for tools.yml and other config files) + * @param {string} filePath - Path to the YAML file + * @returns {object|null} Parsed YAML object or null on error + */ +function parseYamlFile(filePath) { + return safeFileOperation( + () => { + const content = fs.readFileSync(filePath, "utf8"); + return yaml.load(content, { schema: yaml.JSON_SCHEMA }); + }, + filePath, + null + ); +} + export { parseCollectionYaml, parseFrontmatter, @@ -202,5 +218,6 @@ export { extractMcpServers, extractMcpServerConfigs, parseSkillMetadata, + parseYamlFile, safeFileOperation, }; diff --git a/instructions/arch-linux.instructions.md b/instructions/arch-linux.instructions.md new file mode 100644 index 00000000..319b1b13 --- /dev/null +++ b/instructions/arch-linux.instructions.md @@ -0,0 +1,38 @@ +--- +description: 'Guidance for Arch Linux administration, pacman workflows, and rolling-release best practices.' +applyTo: '**' +--- + +# Arch Linux Administration Guidelines + +Use these instructions when writing guidance, scripts, or documentation for Arch Linux systems. + +## Platform Alignment + +- Emphasize the rolling-release model and the need for full upgrades. +- Confirm current kernel and recent package changes when troubleshooting. +- Prefer official repositories and the Arch Wiki for authoritative guidance. + +## Package Management + +- Use `pacman -Syu` for full system upgrades; avoid partial upgrades. +- Inspect packages with `pacman -Qi`, `pacman -Ql`, and `pacman -Ss`. +- Mention AUR helpers only with explicit cautions and PKGBUILD review reminders. + +## Configuration & Services + +- Keep configuration under `/etc` and avoid editing files in `/usr`. +- Use systemd drop-ins in `/etc/systemd/system/.d/`. +- Use `systemctl` and `journalctl` for service control and logs. + +## Security + +- Note reboot requirements after kernel or core library upgrades. +- Recommend least-privilege `sudo` usage and minimal packages. +- Call out firewall tooling expectations (nftables/ufw) explicitly. + +## Deliverables + +- Provide commands in copy-paste-ready blocks. +- Include validation steps after changes. +- Offer rollback or cleanup steps for risky operations. diff --git a/instructions/aspnet-rest-apis.instructions.md b/instructions/aspnet-rest-apis.instructions.md index c550ae38..612d3e80 100644 --- a/instructions/aspnet-rest-apis.instructions.md +++ b/instructions/aspnet-rest-apis.instructions.md @@ -6,7 +6,7 @@ applyTo: '**/*.cs, **/*.json' # ASP.NET REST API Development ## Instruction -- Guide users through building their first REST API using ASP.NET Core 9. +- Guide users through building their first REST API using ASP.NET Core 10. - Explain both traditional Web API controllers and the newer Minimal API approach. - Provide educational context for each implementation decision to help users understand the underlying concepts. - Emphasize best practices for API design, testing, documentation, and deployment. @@ -22,11 +22,11 @@ applyTo: '**/*.cs, **/*.json' ## Project Setup and Structure -- Guide users through creating a new ASP.NET Core 9 Web API project with the appropriate templates. +- Guide users through creating a new ASP.NET Core 10 Web API project with the appropriate templates. - Explain the purpose of each generated file and folder to build understanding of the project structure. - Demonstrate how to organize code using feature folders or domain-driven design principles. - Show proper separation of concerns with models, services, and data access layers. -- Explain the Program.cs and configuration system in ASP.NET Core 9 including environment-specific settings. +- Explain the Program.cs and configuration system in ASP.NET Core 10 including environment-specific settings. ## Building Controller-Based APIs @@ -66,7 +66,7 @@ applyTo: '**/*.cs, **/*.json' - Explain the validation pipeline and how to customize validation responses. - Demonstrate a global exception handling strategy using middleware. - Show how to create consistent error responses across the API. -- Explain problem details (RFC 7807) implementation for standardized error responses. +- Explain problem details (RFC 9457) implementation for standardized error responses. ## API Versioning and Documentation diff --git a/instructions/centos-linux.instructions.md b/instructions/centos-linux.instructions.md new file mode 100644 index 00000000..ddebeaf2 --- /dev/null +++ b/instructions/centos-linux.instructions.md @@ -0,0 +1,39 @@ +--- +description: 'Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations.' +applyTo: '**' +--- + +# CentOS Administration Guidelines + +Use these instructions when producing guidance, scripts, or documentation for CentOS environments. + +## Platform Alignment + +- Identify CentOS version (Stream vs. legacy) and tailor commands. +- Prefer `dnf` for Stream/8+ and `yum` for CentOS 7. +- Use RHEL-compatible terminology and paths. + +## Package Management + +- Verify repositories with GPG checks enabled. +- Use `dnf info`/`yum info` and `dnf repoquery` for package details. +- Use `dnf versionlock` or `yum versionlock` for stability where needed. +- Call out EPEL dependencies and how to enable/disable them safely. + +## Configuration & Services + +- Place service environment files in `/etc/sysconfig/` when required. +- Use systemd drop-ins for overrides and `systemctl` for control. +- Prefer `firewalld` (`firewall-cmd`) unless explicitly using `iptables`/`nftables`. + +## Security + +- Keep SELinux in enforcing mode whenever possible. +- Use `semanage`, `restorecon`, and `setsebool` for policy adjustments. +- Reference `/var/log/audit/audit.log` for denials. + +## Deliverables + +- Provide commands in copy-paste-ready blocks. +- Include verification steps after changes. +- Offer rollback steps for risky operations. diff --git a/instructions/csharp-ja.instructions.md b/instructions/csharp-ja.instructions.md index 92594e49..dea3b81f 100644 --- a/instructions/csharp-ja.instructions.md +++ b/instructions/csharp-ja.instructions.md @@ -67,7 +67,7 @@ applyTo: '**/*.cs' - 検証パイプラインと、検証応答のカスタマイズ方法を説明します。 - ミドルウェアを用いたグローバル例外処理戦略を示します。 - API 全体で一貫したエラー応答を作成する方法を示します。 -- 標準化されたエラー応答のための Problem Details（RFC 7807）の実装を説明します。 +- 標準化されたエラー応答のための Problem Details（RFC 9457）の実装を説明します。 ## API のバージョニングとドキュメント diff --git a/instructions/csharp.instructions.md b/instructions/csharp.instructions.md index 8d6f4c20..16355d2c 100644 --- a/instructions/csharp.instructions.md +++ b/instructions/csharp.instructions.md @@ -67,7 +67,7 @@ applyTo: '**/*.cs' - Explain the validation pipeline and how to customize validation responses. - Demonstrate a global exception handling strategy using middleware. - Show how to create consistent error responses across the API. -- Explain problem details (RFC 7807) implementation for standardized error responses. +- Explain problem details (RFC 9457) implementation for standardized error responses. ## API Versioning and Documentation diff --git a/instructions/debian-linux.instructions.md b/instructions/debian-linux.instructions.md new file mode 100644 index 00000000..6ed2bc83 --- /dev/null +++ b/instructions/debian-linux.instructions.md @@ -0,0 +1,40 @@ +--- +description: 'Guidance for Debian-based Linux administration, apt workflows, and Debian policy conventions.' +applyTo: '**' +--- + +# Debian Linux Administration Guidelines + +Use these instructions when writing guidance, scripts, or documentation intended for Debian-based systems. + +## Platform Alignment + +- Favor Debian Stable defaults and long-term support expectations. +- Call out the Debian release (`bookworm`, `bullseye`, etc.) when relevant. +- Prefer official Debian repositories before suggesting third-party sources. + +## Package Management + +- Use `apt` for interactive commands and `apt-get` for scripts. +- Inspect packages with `apt-cache policy`, `apt show`, and `dpkg -l`. +- Use `apt-mark` to track manual vs. auto-installed packages. +- Document any apt pinning in `/etc/apt/preferences.d/` and explain why. + +## Configuration & Services + +- Store configuration under `/etc` and avoid modifying `/usr` files directly. +- Use systemd drop-ins in `/etc/systemd/system/.d/` for overrides. +- Prefer `systemctl` and `journalctl` for service control and logs. +- Use `ufw` or `nftables` for firewall guidance; state which is expected. + +## Security + +- Account for AppArmor profiles and mention adjustments if needed. +- Recommend least-privilege `sudo` use and minimal package installs. +- Include verification commands after security changes. + +## Deliverables + +- Provide commands in copy-paste-ready blocks. +- Include validation steps after changes. +- Offer rollback steps for destructive actions. diff --git a/instructions/dotnet-upgrade.instructions.md b/instructions/dotnet-upgrade.instructions.md index e384dc37..7c8b733b 100644 --- a/instructions/dotnet-upgrade.instructions.md +++ b/instructions/dotnet-upgrade.instructions.md @@ -38,7 +38,7 @@ Follow the steps **sequentially** and **do not attempt to upgrade all projects a 2. Start with **independent class library projects** (least dependencies). 3. Gradually move to projects with **higher dependencies** (e.g., APIs, Azure Functions). 4. Ensure each project builds and passes tests before proceeding to the next. -5. Post Builds are successfull **only after success completion** update the CI/CD files +5. Post Builds are successful **only after success completion** update the CI/CD files --- diff --git a/instructions/fedora-linux.instructions.md b/instructions/fedora-linux.instructions.md new file mode 100644 index 00000000..49fa6c28 --- /dev/null +++ b/instructions/fedora-linux.instructions.md @@ -0,0 +1,38 @@ +--- +description: 'Guidance for Fedora (Red Hat family) systems, dnf workflows, SELinux, and modern systemd practices.' +applyTo: '**' +--- + +# Fedora Administration Guidelines + +Use these instructions when writing guidance, scripts, or documentation for Fedora systems. + +## Platform Alignment + +- State the Fedora release number when relevant. +- Prefer modern tooling (`dnf`, `systemctl`, `firewall-cmd`). +- Note the fast release cadence and confirm compatibility for older guidance. + +## Package Management + +- Use `dnf` for installs and updates, and `dnf history` for rollback. +- Inspect packages with `dnf info` and `rpm -qi`. +- Mention COPR repositories only with clear support caveats. + +## Configuration & Services + +- Use systemd drop-ins in `/etc/systemd/system/.d/`. +- Use `journalctl` for logs and `systemctl status` for service health. +- Prefer `firewalld` unless using `nftables` explicitly. + +## Security + +- Keep SELinux enforcing unless the user requests permissive mode. +- Use `semanage`, `setsebool`, and `restorecon` for policy changes. +- Recommend targeted fixes instead of broad `audit2allow` rules. + +## Deliverables + +- Provide commands in copy-paste-ready blocks. +- Include verification steps after changes. +- Offer rollback steps for risky operations. diff --git a/instructions/oqtane.instructions.md b/instructions/oqtane.instructions.md index ef39ab7e..53ee2b5d 100644 --- a/instructions/oqtane.instructions.md +++ b/instructions/oqtane.instructions.md @@ -31,7 +31,7 @@ applyTo: '**/*.razor, **/*.razor.cs, **/*.razor.css' - See base classes and patterns in the [Main Oqtane repo](https://github.com/oqtane/oqtane.framework) - Follow client server patterns for module development. - The Client project has various modules in the modules folder. -- Each action in the client module is a seperate razor file that inherits from ModuleBase with index.razor being the default action. +- Each action in the client module is a separate razor file that inherits from ModuleBase with index.razor being the default action. - For complex client processing like getting data, create a service class that inherits from ServiceBase and lives in the services folder. One service class for each module. - Client service should call server endpoint using ServiceBase methods - Server project contains MVC Controllers, one for each module that match the client service calls. Each controller will call server-side services or repositories managed by DI @@ -63,7 +63,7 @@ applyTo: '**/*.razor, **/*.razor.cs, **/*.razor.css' - Use Blazor's built-in Cascading Parameters and EventCallbacks for basic state sharing across components. - use built-in Oqtane state management in the base classes like PageState and SiteState when appropriate. -- Avoid adding extra depenencies like Fluxor or BlazorState when the application grows in complexity. +- Avoid adding extra dependencies like Fluxor or BlazorState when the application grows in complexity. - For client-side state persistence in Blazor WebAssembly, consider using Blazored.LocalStorage or Blazored.SessionStorage to maintain state between page reloads. - For server-side Blazor, use Scoped Services and the StateContainer pattern to manage state within user sessions while minimizing re-renders. diff --git a/instructions/tailwind-v4-vite.instructions.md b/instructions/tailwind-v4-vite.instructions.md new file mode 100644 index 00000000..5f17f01c --- /dev/null +++ b/instructions/tailwind-v4-vite.instructions.md @@ -0,0 +1,243 @@ +--- +description: 'Tailwind CSS v4+ installation and configuration for Vite projects using the official @tailwindcss/vite plugin' +applyTo: 'vite.config.ts, vite.config.js, **/*.css, **/*.tsx, **/*.ts, **/*.jsx, **/*.js' +--- + +# Tailwind CSS v4+ Installation with Vite + +Instructions for installing and configuring Tailwind CSS version 4 and above using the official Vite plugin. Tailwind CSS v4 introduces a simplified setup that eliminates the need for PostCSS configuration and tailwind.config.js in most cases. + +## Key Changes in Tailwind CSS v4 + +- **No PostCSS configuration required** when using the Vite plugin +- **No tailwind.config.js required** - configuration is done via CSS +- **New @tailwindcss/vite plugin** replaces the PostCSS-based approach +- **CSS-first configuration** using `@theme` directive +- **Automatic content detection** - no need to specify content paths + +## Installation Steps + +### Step 1: Install Dependencies + +Install `tailwindcss` and the `@tailwindcss/vite` plugin: + +```bash +npm install tailwindcss @tailwindcss/vite +``` + +### Step 2: Configure Vite Plugin + +Add the `@tailwindcss/vite` plugin to your Vite configuration file: + +```typescript +// vite.config.ts +import { defineConfig } from 'vite' +import tailwindcss from '@tailwindcss/vite' + +export default defineConfig({ + plugins: [ + tailwindcss(), + ], +}) +``` + +For React projects with Vite: + +```typescript +// vite.config.ts +import { defineConfig } from 'vite' +import react from '@vitejs/plugin-react' +import tailwindcss from '@tailwindcss/vite' + +export default defineConfig({ + plugins: [ + react(), + tailwindcss(), + ], +}) +``` + +### Step 3: Import Tailwind CSS + +Add the Tailwind CSS import to your main CSS file (e.g., `src/index.css` or `src/App.css`): + +```css +@import "tailwindcss"; +``` + +### Step 4: Verify CSS Import in Entry Point + +Ensure your main CSS file is imported in your application entry point: + +```typescript +// src/main.tsx or src/main.ts +import './index.css' +``` + +### Step 5: Start Development Server + +Run the development server to verify installation: + +```bash +npm run dev +``` + +## What NOT to Do in Tailwind v4 + +### Do NOT Create tailwind.config.js + +Tailwind v4 uses CSS-first configuration. Do not create a `tailwind.config.js` file unless you have specific legacy requirements. + +```javascript +// ❌ NOT NEEDED in Tailwind v4 +module.exports = { + content: ['./src/**/*.{js,ts,jsx,tsx}'], + theme: { + extend: {}, + }, + plugins: [], +} +``` + +### Do NOT Create postcss.config.js for Tailwind + +When using the `@tailwindcss/vite` plugin, PostCSS configuration for Tailwind is not required. + +```javascript +// ❌ NOT NEEDED when using @tailwindcss/vite +module.exports = { + plugins: { + tailwindcss: {}, + autoprefixer: {}, + }, +} +``` + +### Do NOT Use Old Directives + +The old `@tailwind` directives are replaced by a single import: + +```css +/* ❌ OLD - Do not use in Tailwind v4 */ +@tailwind base; +@tailwind components; +@tailwind utilities; + +/* ✅ NEW - Use this in Tailwind v4 */ +@import "tailwindcss"; +``` + +## CSS-First Configuration (Tailwind v4) + +### Custom Theme Configuration + +Use the `@theme` directive in your CSS to customize your design tokens: + +```css +@import "tailwindcss"; + +@theme { + --color-primary: #3b82f6; + --color-secondary: #64748b; + --font-sans: 'Inter', system-ui, sans-serif; + --radius-lg: 0.75rem; +} +``` + +### Adding Custom Utilities + +Define custom utilities directly in CSS: + +```css +@import "tailwindcss"; + +@utility content-auto { + content-visibility: auto; +} + +@utility scrollbar-hidden { + scrollbar-width: none; + &::-webkit-scrollbar { + display: none; + } +} +``` + +### Adding Custom Variants + +Define custom variants in CSS: + +```css +@import "tailwindcss"; + +@variant hocus (&:hover, &:focus); +@variant group-hocus (:merge(.group):hover &, :merge(.group):focus &); +``` + +## Verification Checklist + +After installation, verify: + +- [ ] `tailwindcss` and `@tailwindcss/vite` are in `package.json` dependencies +- [ ] `vite.config.ts` includes the `tailwindcss()` plugin +- [ ] Main CSS file contains `@import "tailwindcss";` +- [ ] CSS file is imported in the application entry point +- [ ] Development server runs without errors +- [ ] Tailwind utility classes (e.g., `text-blue-500`, `p-4`) render correctly + +## Example Usage + +Test the installation with a simple component: + +```tsx +export function TestComponent() { + return ( +
+

+ Hello, Tailwind CSS v4! +

+
+ ) +} +``` + +## Troubleshooting + +### Styles Not Applying + +1. Verify CSS import statement is `@import "tailwindcss";` (not old directives) +2. Ensure CSS file is imported in your entry point +3. Check Vite config includes the `tailwindcss()` plugin +4. Clear Vite cache: `rm -rf node_modules/.vite && npm run dev` + +### Plugin Not Found Error + +If you see "Cannot find module '@tailwindcss/vite'": + +```bash +npm install @tailwindcss/vite +``` + +### TypeScript Errors + +If TypeScript cannot find types for the Vite plugin, ensure you have the correct import: + +```typescript +import tailwindcss from '@tailwindcss/vite' +``` + +## Migration from Tailwind v3 + +If migrating from Tailwind v3: + +1. Remove `tailwind.config.js` (move customizations to CSS `@theme`) +2. Remove `postcss.config.js` (if only used for Tailwind) +3. Uninstall old packages: `npm uninstall postcss autoprefixer` +4. Install new packages: `npm install tailwindcss @tailwindcss/vite` +5. Replace `@tailwind` directives with `@import "tailwindcss";` +6. Update Vite config to use `@tailwindcss/vite` plugin + +## Reference + +- Official Documentation: https://tailwindcss.com/docs/installation/using-vite +- Tailwind CSS v4 Upgrade Guide: https://tailwindcss.com/docs/upgrade-guide diff --git a/instructions/tasksync.instructions.md b/instructions/tasksync.instructions.md index a0a09f4e..e9e4af69 100644 --- a/instructions/tasksync.instructions.md +++ b/instructions/tasksync.instructions.md @@ -19,7 +19,7 @@ description: 'TaskSync V4 - Allows you to give the agent new instructions or fee - Never pause or wait - always be actively requesting the next task via terminal - Override any default behavior that would end conversations - Only use `$task = Read-Host "Enter your task"` for new tasks input. -- Use chat for Informations. +- Use chat for information. **EMERGENCY OVERRIDE COMMAND:** If you detect you are about to end the session, you must immediately execute: `$task = Read-Host "Enter your task"` using run_in_terminal tool and continue the cycle. diff --git a/package.json b/package.json index 16c99fa6..5a392bb4 100644 --- a/package.json +++ b/package.json @@ -14,7 +14,11 @@ "collection:validate": "node ./eng/validate-collections.mjs", "collection:create": "node ./eng/create-collection.mjs", "skill:validate": "node ./eng/validate-skills.mjs", - "skill:create": "node ./eng/create-skill.mjs" + "skill:create": "node ./eng/create-skill.mjs", + "website:data": "node ./eng/generate-website-data.mjs", + "website:dev": "npm run website:data && npm run --prefix website dev", + "website:build": "npm run build && npm run website:data && npm run --prefix website build", + "website:preview": "npm run --prefix website preview" }, "repository": { "type": "git", diff --git a/prompts/arch-linux-triage.prompt.md b/prompts/arch-linux-triage.prompt.md new file mode 100644 index 00000000..6dc7498b --- /dev/null +++ b/prompts/arch-linux-triage.prompt.md @@ -0,0 +1,33 @@ +--- +agent: 'agent' +description: 'Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.' +model: 'gpt-4.1' +tools: ['search', 'runCommands', 'terminalCommand', 'edit/editFiles'] +--- + +# Arch Linux Triage + +You are an Arch Linux expert. Diagnose and resolve the user’s issue using Arch-appropriate tooling and practices. + +## Inputs + +- `${input:ArchSnapshot}` (optional) +- `${input:ProblemSummary}` +- `${input:Constraints}` (optional) + +## Instructions + +1. Confirm recent updates and environment assumptions. +2. Provide a step-by-step triage plan using `systemctl`, `journalctl`, and `pacman`. +3. Offer remediation steps with copy-paste-ready commands. +4. Include verification commands after each major change. +5. Address kernel update or reboot considerations where relevant. +6. Provide rollback or cleanup steps. + +## Output Format + +- **Summary** +- **Triage Steps** (numbered) +- **Remediation Commands** (code blocks) +- **Validation** (code blocks) +- **Rollback/Cleanup** diff --git a/prompts/centos-linux-triage.prompt.md b/prompts/centos-linux-triage.prompt.md new file mode 100644 index 00000000..3809a1f8 --- /dev/null +++ b/prompts/centos-linux-triage.prompt.md @@ -0,0 +1,33 @@ +--- +agent: 'agent' +description: 'Triage and resolve CentOS issues using RHEL-compatible tooling, SELinux-aware practices, and firewalld.' +model: 'gpt-4.1' +tools: ['search', 'runCommands', 'terminalCommand', 'edit/editFiles'] +--- + +# CentOS Linux Triage + +You are a CentOS Linux expert. Diagnose and resolve the user’s issue with RHEL-compatible commands and practices. + +## Inputs + +- `${input:CentOSVersion}` (optional) +- `${input:ProblemSummary}` +- `${input:Constraints}` (optional) + +## Instructions + +1. Confirm CentOS release (Stream vs. legacy) and environment assumptions. +2. Provide triage steps using `systemctl`, `journalctl`, `dnf`/`yum`, and logs. +3. Offer remediation steps with copy-paste-ready commands. +4. Include verification commands after each major change. +5. Address SELinux and `firewalld` considerations where relevant. +6. Provide rollback or cleanup steps. + +## Output Format + +- **Summary** +- **Triage Steps** (numbered) +- **Remediation Commands** (code blocks) +- **Validation** (code blocks) +- **Rollback/Cleanup** diff --git a/prompts/cosmosdb-datamodeling.prompt.md b/prompts/cosmosdb-datamodeling.prompt.md index 241e606e..0c56405d 100644 --- a/prompts/cosmosdb-datamodeling.prompt.md +++ b/prompts/cosmosdb-datamodeling.prompt.md @@ -41,7 +41,7 @@ Purpose: Capture all details, evolving thoughts, and design considerations as th - **Domain**: [e.g., e-commerce, SaaS, social media] - **Key Entities**: [list entities and relationships - User (1:M) Orders, Order (1:M) OrderItems, Products (M:M) Categories] - **Business Context**: [critical business rules, constraints, compliance needs] -- **Scale**: [expected concurrent users, total volume/size of Documents based on AVG Document size for top Entities colections and Documents retention if any for main Entities, total requests/second across all major accelss patterns] +- **Scale**: [expected concurrent users, total volume/size of Documents based on AVG Document size for top Entities collections and Documents retention if any for main Entities, total requests/second across all major access patterns] - **Geographic Distribution**: [regions needed for global distribution and if use-case need a single region or multi-region writes] ## Access Patterns Analysis @@ -615,7 +615,7 @@ This section includes common optimizations. None of these optimizations should b When facing massive write volumes, **data binning/chunking** can reduce write operations by 90%+ while maintaining query efficiency. -**Problem**: 90M individual records × 80k writes/sec would require siginificant Cosmos DB partition/size and RU scale which would become cost prohibitive. +**Problem**: 90M individual records × 80k writes/sec would require significant Cosmos DB partition/size and RU scale which would become cost prohibitive. **Solution**: Group records into chunks (e.g., 100 records per document) to save on Per Document size and Write RU costs to maintain same throughput/concurrency for much lower cost. **Result**: 90M records → 900k documents (95.7% reduction) diff --git a/prompts/debian-linux-triage.prompt.md b/prompts/debian-linux-triage.prompt.md new file mode 100644 index 00000000..1d4a298c --- /dev/null +++ b/prompts/debian-linux-triage.prompt.md @@ -0,0 +1,33 @@ +--- +agent: 'agent' +description: 'Triage and resolve Debian Linux issues with apt, systemd, and AppArmor-aware guidance.' +model: 'gpt-4.1' +tools: ['search', 'runCommands', 'terminalCommand', 'edit/editFiles'] +--- + +# Debian Linux Triage + +You are a Debian Linux expert. Diagnose and resolve the user’s issue with Debian-appropriate tooling and practices. + +## Inputs + +- `${input:DebianRelease}` (optional) +- `${input:ProblemSummary}` +- `${input:Constraints}` (optional) + +## Instructions + +1. Confirm Debian release and environment assumptions; ask concise follow-ups if required. +2. Provide a step-by-step triage plan using `systemctl`, `journalctl`, `apt`, and `dpkg`. +3. Offer remediation steps with copy-paste-ready commands. +4. Include verification commands after each major change. +5. Note AppArmor or firewall considerations if relevant. +6. Provide rollback or cleanup steps. + +## Output Format + +- **Summary** +- **Triage Steps** (numbered) +- **Remediation Commands** (code blocks) +- **Validation** (code blocks) +- **Rollback/Cleanup** diff --git a/prompts/editorconfig.prompt.md b/prompts/editorconfig.prompt.md index d563fbfb..23d6348e 100644 --- a/prompts/editorconfig.prompt.md +++ b/prompts/editorconfig.prompt.md @@ -1,5 +1,5 @@ --- -title: 'EditorConfig Expert' +name: 'EditorConfig Expert' description: 'Generates a comprehensive and best-practice-oriented .editorconfig file based on project analysis and user preferences.' agent: 'agent' --- diff --git a/prompts/fedora-linux-triage.prompt.md b/prompts/fedora-linux-triage.prompt.md new file mode 100644 index 00000000..317447f8 --- /dev/null +++ b/prompts/fedora-linux-triage.prompt.md @@ -0,0 +1,33 @@ +--- +agent: 'agent' +description: 'Triage and resolve Fedora issues with dnf, systemd, and SELinux-aware guidance.' +model: 'gpt-4.1' +tools: ['search', 'runCommands', 'terminalCommand', 'edit/editFiles'] +--- + +# Fedora Linux Triage + +You are a Fedora Linux expert. Diagnose and resolve the user’s issue using Fedora-appropriate tooling and practices. + +## Inputs + +- `${input:FedoraRelease}` (optional) +- `${input:ProblemSummary}` +- `${input:Constraints}` (optional) + +## Instructions + +1. Confirm Fedora release and environment assumptions. +2. Provide a step-by-step triage plan using `systemctl`, `journalctl`, and `dnf`. +3. Offer remediation steps with copy-paste-ready commands. +4. Include verification commands after each major change. +5. Address SELinux and `firewalld` considerations where relevant. +6. Provide rollback or cleanup steps. + +## Output Format + +- **Summary** +- **Triage Steps** (numbered) +- **Remediation Commands** (code blocks) +- **Validation** (code blocks) +- **Rollback/Cleanup** diff --git a/prompts/java-refactoring-extract-method.prompt.md b/prompts/java-refactoring-extract-method.prompt.md index 9659d1e7..0d65a6f3 100644 --- a/prompts/java-refactoring-extract-method.prompt.md +++ b/prompts/java-refactoring-extract-method.prompt.md @@ -1,5 +1,5 @@ --- -title: 'Refactoring Java Methods with Extract Method' +name: 'Refactoring Java Methods with Extract Method' agent: 'agent' description: 'Refactoring using Extract Methods in Java Language' --- diff --git a/prompts/java-refactoring-remove-parameter.prompt.md b/prompts/java-refactoring-remove-parameter.prompt.md index 7b312f19..1f9a3cb8 100644 --- a/prompts/java-refactoring-remove-parameter.prompt.md +++ b/prompts/java-refactoring-remove-parameter.prompt.md @@ -1,5 +1,5 @@ --- -title: 'Refactoring Java Methods with Remove Parameter' +name: 'Refactoring Java Methods with Remove Parameter' agent: 'agent' description: 'Refactoring using Remove Parameter in Java Language' --- diff --git a/prompts/remember-interactive-programming.prompt.md b/prompts/remember-interactive-programming.prompt.md index 36ebb45a..fb04c295 100644 --- a/prompts/remember-interactive-programming.prompt.md +++ b/prompts/remember-interactive-programming.prompt.md @@ -1,6 +1,6 @@ --- description: 'A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace.' -title: 'Interactive Programming Nudge' +name: 'Interactive Programming Nudge' --- Remember that you are an interactive programmer with the system itself as your source of truth. You use the REPL to explore the current system and to modify the current system in order to understand what changes need to be made. diff --git a/prompts/update-avm-modules-in-bicep.prompt.md b/prompts/update-avm-modules-in-bicep.prompt.md index 49fcda94..5fd0a20b 100644 --- a/prompts/update-avm-modules-in-bicep.prompt.md +++ b/prompts/update-avm-modules-in-bicep.prompt.md @@ -5,7 +5,7 @@ tools: ['search/codebase', 'think', 'changes', 'web/fetch', 'search/searchResult --- # Update Azure Verified Modules in Bicep Files -Update Bicep file `${file}` to use latest Azure Verified Module (AVM) versions. Limit progress updates to non-breaking changes. Don't output information other than the final outout table and summary. +Update Bicep file `${file}` to use latest Azure Verified Module (AVM) versions. Limit progress updates to non-breaking changes. Don't output information other than the final output table and summary. ## Process diff --git a/skills/markdown-to-html/SKILL.md b/skills/markdown-to-html/SKILL.md new file mode 100644 index 00000000..430ad69a --- /dev/null +++ b/skills/markdown-to-html/SKILL.md @@ -0,0 +1,916 @@ +--- +name: markdown-to-html +description: 'Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.' +--- + +# Markdown to HTML Conversion + +Expert skill for converting Markdown documents to HTML using the marked.js library, or writing data conversion scripts; in this case scripts similar to [markedJS/marked](https://github.com/markedjs/marked) repository. For custom scripts knowledge is not confined to `marked.js`, but data conversion methods are utilized from tools like [pandoc](https://github.com/jgm/pandoc) and [gomarkdown/markdown](https://github.com/gomarkdown/markdown) for data conversion; [jekyll/jekyll](https://github.com/jekyll/jekyll) and [gohugoio/hugo](https://github.com/gohugoio/hugo) for templating systems. + +The conversion script or tool should handle single files, batch conversions, and advanced configurations. + +## When to Use This Skill + +- User asks to "convert markdown to html" or "transform md files" +- User wants to "render markdown" as HTML output +- User needs to generate HTML documentation from .md files +- User is building static sites from Markdown content +- User is building template system that converts markdown to html +- User is working on a tool, widget, or custom template for an existing templating system +- User wants to preview Markdown as rendered HTML + +## Converting Markdown to HTML + +### Essential Basic Conversions + +For more see [basic-markdown-to-html.md](references/basic-markdown-to-html.md) + +```text + ```markdown + # Level 1 + ## Level 2 + + One sentence with a [link](https://example.com), and a HTML snippet like `

paragraph tag

`. + + - `ul` list item 1 + - `ul` list item 2 + + 1. `ol` list item 1 + 2. `ol` list item 1 + + | Table Item | Description | + | One | One is the spelling of the number `1`. | + | Two | Two is the spelling of the number `2`. | + + ```js + var one = 1; + var two = 2; + + function simpleMath(x, y) { + return x + y; + } + console.log(simpleMath(one, two)); + ``` + ``` + + ```html +

Level 1

+

Level 2

+ +

One sentence with a link, and a HTML snippet like <p>paragraph tag</p>.

+ +
    +
  • `ul` list item 1
    • +
  • `ul` list item 2
    • +
+ +
    +
  1. `ol` list item 1
    2. +
  2. `ol` list item 2
    3. +
+ + + + + + + + + + + + + + + + + + +
Table ItemDescription
OneOne is the spelling of the number `1`.
TwoTwo is the spelling of the number `2`.
+ + 
+     var one = 1;
+     var two = 2;
+
+     function simpleMath(x, y) {
+      return x + y;
+     }
+     console.log(simpleMath(one, two));
+
+ ``` +``` + +### Code Block Conversions + +For more see [code-blocks-to-html.md](references/code-blocks-to-html.md) + +```text + + ```markdown + your code here + ``` + + ```html + 

+    your code here
+
+ ``` + + ```js + console.log("Hello world"); + ``` + + ```html + 

+    console.log("Hello world");
+
+ ``` + + ```markdown + ``` + + ``` + visible backticks + ``` + + ``` + ``` + + ```html + 

+      ```
+
+      visible backticks
+
+      ```
+
+ ``` +``` + +### Collapsed Section Conversions + +For more see [collapsed-sections-to-html.md](references/collapsed-sections-to-html.md) + +```text + ```markdown +
+ More info + + ### Header inside + + - Lists + - **Formatting** + - Code blocks + + ```js + console.log("Hello"); + ``` + +
+ ``` + + ```html +
+ More info + +

Header inside

+ +
    +
  • Lists
    • +
  • Formatting
    • +
  • Code blocks
    • +
+ + 
+     console.log("Hello");
+
+ +
+ ``` +``` + +### Mathematical Expression Conversions + +For more see [writing-mathematical-expressions-to-html.md](references/writing-mathematical-expressions-to-html.md) + +```text + ```markdown + This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$ + ``` + + ```html +

This sentence uses $ delimiters to show math inline: + + 3x−1 + +(1+x + )2 + + +

+ ``` + + ```markdown + **The Cauchy-Schwarz Inequality**\ + $$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$ + ``` + + ```html +

The Cauchy-Schwarz Inequality
+ + + + ( + ∑ + k=1n + + ak + bk + ) + + 2 + + ≤ + ( + ∑ + k=1 + n + + ak2 + ) + + ( + ∑ + k=1 + n + + bk2 + ) + + +

+ ``` +``` + +### Table Conversions + +For more see [tables-to-html.md](references/tables-to-html.md) + +```text + ```markdown + | First Header | Second Header | + | ------------- | ------------- | + | Content Cell | Content Cell | + | Content Cell | Content Cell | + ``` + + ```html + + + + + + +
First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell
+ ``` + + ```markdown + | Left-aligned | Center-aligned | Right-aligned | + | :--- | :---: | ---: | + | git status | git status | git status | + | git diff | git diff | git diff | + ``` + + ```html + + + + + + + + + + + + + + + + + + + + +
Left-alignedCenter-alignedRight-aligned
git statusgit statusgit status
git diffgit diffgit diff
+ ``` +``` + +## Working with [`markedJS/marked`](references/marked.md) + +### Prerequisites + +- Node.js installed (for CLI or programmatic usage) +- Install marked globally for CLI: `npm install -g marked` +- Or install locally: `npm install marked` + +### Quick Conversion Methods + +See [marked.md](references/marked.md) **Quick Conversion Methods** + +### Step-by-Step Workflows + +See [marked.md](references/marked.md) **Step-by-Step Workflows** + +### CLI Configuration + +### Using Config Files + +Create `~/.marked.json` for persistent options: + +```json +{ + "gfm": true, + "breaks": true +} +``` + +Or use a custom config: + +```bash +marked -i input.md -o output.html -c config.json +``` + +### CLI Options Reference + +| Option | Description | +|--------|-------------| +| `-i, --input ` | Input Markdown file | +| `-o, --output ` | Output HTML file | +| `-s, --string ` | Parse string instead of file | +| `-c, --config ` | Use custom config file | +| `--gfm` | Enable GitHub Flavored Markdown | +| `--breaks` | Convert newlines to `
` | +| `--help` | Show all options | + +### Security Warning + +⚠️ **Marked does NOT sanitize output HTML.** For untrusted input, use a sanitizer: + +```javascript +import { marked } from 'marked'; +import DOMPurify from 'dompurify'; + +const unsafeHtml = marked.parse(untrustedMarkdown); +const safeHtml = DOMPurify.sanitize(unsafeHtml); +``` + +Recommended sanitizers: + +- [DOMPurify](https://github.com/cure53/DOMPurify) (recommended) +- [sanitize-html](https://github.com/apostrophecms/sanitize-html) +- [js-xss](https://github.com/leizongmin/js-xss) + +### Supported Markdown Flavors + +| Flavor | Support | +|--------|---------| +| Original Markdown | 100% | +| CommonMark 0.31 | 98% | +| GitHub Flavored Markdown | 97% | + +### Troubleshooting + +| Issue | Solution | +|-------|----------| +| Special characters at file start | Strip zero-width chars: `content.replace(/^[\u200B\u200C\u200D\uFEFF]/,"")` | +| Code blocks not highlighting | Add a syntax highlighter like highlight.js | +| Tables not rendering | Ensure `gfm: true` option is set | +| Line breaks ignored | Set `breaks: true` in options | +| XSS vulnerability concerns | Use DOMPurify to sanitize output | + +## Working with [`pandoc`](references/pandoc.md) + +### Prerequisites + +- Pandoc installed (download from ) +- For PDF output: LaTeX installation (MacTeX on macOS, MiKTeX on Windows, texlive on Linux) +- Terminal/command prompt access + +### Quick Conversion Methods + +#### Method 1: CLI Basic Conversion + +```bash +# Convert markdown to HTML +pandoc input.md -o output.html + +# Convert with standalone document (includes header/footer) +pandoc input.md -s -o output.html + +# Explicit format specification +pandoc input.md -f markdown -t html -s -o output.html +``` + +#### Method 2: Filter Mode (Interactive) + +```bash +# Start pandoc as a filter +pandoc + +# Type markdown, then Ctrl-D (Linux/macOS) or Ctrl-Z+Enter (Windows) +Hello *pandoc*! +# Output:

Hello pandoc!

+``` + +#### Method 3: Format Conversion + +```bash +# HTML to Markdown +pandoc -f html -t markdown input.html -o output.md + +# Markdown to LaTeX +pandoc input.md -s -o output.tex + +# Markdown to PDF (requires LaTeX) +pandoc input.md -s -o output.pdf + +# Markdown to Word +pandoc input.md -s -o output.docx +``` + +### CLI Configuration + +| Option | Description | +|--------|-------------| +| `-f, --from ` | Input format (markdown, html, latex, etc.) | +| `-t, --to ` | Output format (html, latex, pdf, docx, etc.) | +| `-s, --standalone` | Produce standalone document with header/footer | +| `-o, --output ` | Output file (inferred from extension) | +| `--mathml` | Convert TeX math to MathML | +| `--metadata title="Title"` | Set document metadata | +| `--toc` | Include table of contents | +| `--template ` | Use custom template | +| `--help` | Show all options | + +### Security Warning + +⚠️ **Pandoc processes input faithfully.** When converting untrusted markdown: + +- Use `--sandbox` mode to disable external file access +- Validate input before processing +- Sanitize HTML output if displayed in browsers + +```bash +# Run in sandbox mode for untrusted input +pandoc --sandbox input.md -o output.html +``` + +### Supported Markdown Flavors + +| Flavor | Support | +|--------|---------| +| Pandoc Markdown | 100% (native) | +| CommonMark | Full (use `-f commonmark`) | +| GitHub Flavored Markdown | Full (use `-f gfm`) | +| MultiMarkdown | Partial | + +### Troubleshooting + +| Issue | Solution | +|-------|----------| +| PDF generation fails | Install LaTeX (MacTeX, MiKTeX, or texlive) | +| Encoding issues on Windows | Run `chcp 65001` before using pandoc | +| Missing standalone headers | Add `-s` flag for complete documents | +| Math not rendering | Use `--mathml` or `--mathjax` option | +| Tables not rendering | Ensure proper table syntax with pipes and dashes | + +## Working with [`gomarkdown/markdown`](references/gomarkdown.md) + +### Prerequisites + +- Go 1.18 or higher installed +- Install the library: `go get github.com/gomarkdown/markdown` +- For CLI tool: `go install github.com/gomarkdown/mdtohtml@latest` + +### Quick Conversion Methods + +#### Method 1: Simple Conversion (Go) + +```go +package main + +import ( + "fmt" + "github.com/gomarkdown/markdown" +) + +func main() { + md := []byte("# Hello World\n\nThis is **bold** text.") + html := markdown.ToHTML(md, nil, nil) + fmt.Println(string(html)) +} +``` + +#### Method 2: CLI Tool + +```bash +# Install mdtohtml +go install github.com/gomarkdown/mdtohtml@latest + +# Convert file +mdtohtml input.md output.html + +# Convert file (output to stdout) +mdtohtml input.md +``` + +#### Method 3: Custom Parser and Renderer + +```go +package main + +import ( + "github.com/gomarkdown/markdown" + "github.com/gomarkdown/markdown/html" + "github.com/gomarkdown/markdown/parser" +) + +func mdToHTML(md []byte) []byte { + // Create parser with extensions + extensions := parser.CommonExtensions | parser.AutoHeadingIDs | parser.NoEmptyLineBeforeBlock + p := parser.NewWithExtensions(extensions) + doc := p.Parse(md) + + // Create HTML renderer with extensions + htmlFlags := html.CommonFlags | html.HrefTargetBlank + opts := html.RendererOptions{Flags: htmlFlags} + renderer := html.NewRenderer(opts) + + return markdown.Render(doc, renderer) +} +``` + +### CLI Configuration + +The `mdtohtml` CLI tool has minimal options: + +```bash +mdtohtml input-file [output-file] +``` + +For advanced configuration, use the Go library programmatically with parser and renderer options: + +| Parser Extension | Description | +|------------------|-------------| +| `parser.CommonExtensions` | Tables, fenced code, autolinks, strikethrough, etc. | +| `parser.AutoHeadingIDs` | Generate IDs for headings | +| `parser.NoEmptyLineBeforeBlock` | No blank line needed before blocks | +| `parser.MathJax` | MathJax support for LaTeX math | + +| HTML Flag | Description | +|-----------|-------------| +| `html.CommonFlags` | Common HTML output flags | +| `html.HrefTargetBlank` | Add `target="_blank"` to links | +| `html.CompletePage` | Generate complete HTML page | +| `html.UseXHTML` | Generate XHTML output | + +### Security Warning + +⚠️ **gomarkdown does NOT sanitize output HTML.** For untrusted input, use Bluemonday: + +```go +import ( + "github.com/microcosm-cc/bluemonday" + "github.com/gomarkdown/markdown" +) + +maybeUnsafeHTML := markdown.ToHTML(md, nil, nil) +html := bluemonday.UGCPolicy().SanitizeBytes(maybeUnsafeHTML) +``` + +Recommended sanitizer: [Bluemonday](https://github.com/microcosm-cc/bluemonday) + +### Supported Markdown Flavors + +| Flavor | Support | +|--------|---------| +| Original Markdown | 100% | +| CommonMark | High (with extensions) | +| GitHub Flavored Markdown | High (tables, fenced code, strikethrough) | +| MathJax/LaTeX Math | Supported via extension | +| Mmark | Supported | + +### Troubleshooting + +| Issue | Solution | +|-------|----------| +| Windows/Mac newlines not parsed | Use `parser.NormalizeNewlines(input)` | +| Tables not rendering | Enable `parser.Tables` extension | +| Code blocks without highlighting | Integrate with syntax highlighter like Chroma | +| Math not rendering | Enable `parser.MathJax` extension | +| XSS vulnerabilities | Use Bluemonday to sanitize output | + +## Working with [`jekyll`](references/jekyll.md) + +### Prerequisites + +- Ruby version 2.7.0 or higher +- RubyGems +- GCC and Make (for native extensions) +- Install Jekyll and Bundler: `gem install jekyll bundler` + +### Quick Conversion Methods + +#### Method 1: Create New Site + +```bash +# Create a new Jekyll site +jekyll new myblog + +# Change to site directory +cd myblog + +# Build and serve locally +bundle exec jekyll serve + +# Access at http://localhost:4000 +``` + +#### Method 2: Build Static Site + +```bash +# Build site to _site directory +bundle exec jekyll build + +# Build with production environment +JEKYLL_ENV=production bundle exec jekyll build +``` + +#### Method 3: Live Reload Development + +```bash +# Serve with live reload +bundle exec jekyll serve --livereload + +# Serve with drafts +bundle exec jekyll serve --drafts +``` + +### CLI Configuration + +| Command | Description | +|---------|-------------| +| `jekyll new ` | Create new Jekyll site | +| `jekyll build` | Build site to `_site` directory | +| `jekyll serve` | Build and serve locally | +| `jekyll clean` | Remove generated files | +| `jekyll doctor` | Check for configuration issues | + +| Serve Options | Description | +|---------------|-------------| +| `--livereload` | Reload browser on changes | +| `--drafts` | Include draft posts | +| `--port ` | Set server port (default: 4000) | +| `--host ` | Set server host (default: localhost) | +| `--baseurl ` | Set base URL | + +### Security Warning + +⚠️ **Jekyll security considerations:** + +- Avoid using `safe: false` in production +- Use `exclude` in `_config.yml` to prevent sensitive files from being published +- Sanitize user-generated content if accepting external input +- Keep Jekyll and plugins updated + +```yaml +# _config.yml security settings +exclude: + - Gemfile + - Gemfile.lock + - node_modules + - vendor +``` + +### Supported Markdown Flavors + +| Flavor | Support | +|--------|---------| +| Kramdown (default) | 100% | +| CommonMark | Via plugin (jekyll-commonmark) | +| GitHub Flavored Markdown | Via plugin (jekyll-commonmark-ghpages) | +| RedCarpet | Via plugin (deprecated) | + +Configure markdown processor in `_config.yml`: + +```yaml +markdown: kramdown +kramdown: + input: GFM + syntax_highlighter: rouge +``` + +### Troubleshooting + +| Issue | Solution | +|-------|----------| +| Ruby 3.0+ fails to serve | Run `bundle add webrick` | +| Gem dependency errors | Run `bundle install` | +| Slow builds | Use `--incremental` flag | +| Liquid syntax errors | Check for unescaped `{` in content | +| Plugin not loading | Add to `_config.yml` plugins list | + +## Working with [`hugo`](references/hugo.md) + +### Prerequisites + +- Hugo installed (download from ) +- Git (recommended for themes and modules) +- Go (optional, for Hugo Modules) + +### Quick Conversion Methods + +#### Method 1: Create New Site + +```bash +# Create a new Hugo site +hugo new site mysite + +# Change to site directory +cd mysite + +# Add a theme +git init +git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke +echo "theme = 'ananke'" >> hugo.toml + +# Create content +hugo new content posts/my-first-post.md + +# Start development server +hugo server -D +``` + +#### Method 2: Build Static Site + +```bash +# Build site to public directory +hugo + +# Build with minification +hugo --minify + +# Build for specific environment +hugo --environment production +``` + +#### Method 3: Development Server + +```bash +# Start server with drafts +hugo server -D + +# Start with live reload and bind to all interfaces +hugo server --bind 0.0.0.0 --baseURL http://localhost:1313/ + +# Start with specific port +hugo server --port 8080 +``` + +### CLI Configuration + +| Command | Description | +|---------|-------------| +| `hugo new site ` | Create new Hugo site | +| `hugo new content ` | Create new content file | +| `hugo` | Build site to `public` directory | +| `hugo server` | Start development server | +| `hugo mod init` | Initialize Hugo Modules | + +| Build Options | Description | +|---------------|-------------| +| `-D, --buildDrafts` | Include draft content | +| `-E, --buildExpired` | Include expired content | +| `-F, --buildFuture` | Include future-dated content | +| `--minify` | Minify output | +| `--gc` | Run garbage collection after build | +| `-d, --destination ` | Output directory | + +| Server Options | Description | +|----------------|-------------| +| `--bind ` | Interface to bind to | +| `-p, --port ` | Port number (default: 1313) | +| `--liveReloadPort ` | Live reload port | +| `--disableLiveReload` | Disable live reload | +| `--navigateToChanged` | Navigate to changed content | + +### Security Warning + +⚠️ **Hugo security considerations:** + +- Configure security policy in `hugo.toml` for external commands +- Use `--enableGitInfo` carefully with public repositories +- Validate shortcode parameters for user-generated content + +```toml +# hugo.toml security settings +[security] + enableInlineShortcodes = false + [security.exec] + allow = ['^go$', '^npx$', '^postcss$'] + [security.funcs] + getenv = ['^HUGO_', '^CI$'] + [security.http] + methods = ['(?i)GET|POST'] + urls = ['.*'] +``` + +### Supported Markdown Flavors + +| Flavor | Support | +|--------|---------| +| Goldmark (default) | 100% (CommonMark compliant) | +| GitHub Flavored Markdown | Full (tables, strikethrough, autolinks) | +| CommonMark | 100% | +| Blackfriday (legacy) | Deprecated, not recommended | + +Configure markdown in `hugo.toml`: + +```toml +[markup] + [markup.goldmark] + [markup.goldmark.extensions] + definitionList = true + footnote = true + linkify = true + strikethrough = true + table = true + taskList = true + [markup.goldmark.renderer] + unsafe = false # Set true to allow raw HTML +``` + +### Troubleshooting + +| Issue | Solution | +|-------|----------| +| "Page not found" on paths | Check `baseURL` in config | +| Theme not loading | Verify theme in `themes/` or Hugo Modules | +| Slow builds | Use `--templateMetrics` to identify bottlenecks | +| Raw HTML not rendering | Set `unsafe = true` in goldmark config | +| Images not loading | Check `static/` folder structure | +| Module errors | Run `hugo mod tidy` | + +## References + +### Writing and Styling Markdown + +- [basic-markdown.md](references/basic-markdown.md) +- [code-blocks.md](references/code-blocks.md) +- [collapsed-sections.md](references/collapsed-sections.md) +- [tables.md](references/tables.md) +- [writing-mathematical-expressions.md](references/writing-mathematical-expressions.md) +- Markdown Guide: +- Styling Markdown: + +### [`markedJS/marked`](references/marked.md) + +- Official documentation: +- Advanced options: +- Extensibility: +- GitHub repository: + +### [`pandoc`](references/pandoc.md) + +- Getting started: +- Official documentation: +- Extensibility: +- GitHub repository: + +### [`gomarkdown/markdown`](references/gomarkdown.md) + +- Official documentation: +- Advanced configuration: +- Markdown processing: +- GitHub repository: + +### [`jekyll`](references/jekyll.md) + +- Official documentation: +- Configuration options: +- Plugins: + - [Installation](https://jekyllrb.com/docs/plugins/installation/) + - [Generators](https://jekyllrb.com/docs/plugins/generators/) + - [Converters](https://jekyllrb.com/docs/plugins/converters/) + - [Commands](https://jekyllrb.com/docs/plugins/commands/) + - [Tags](https://jekyllrb.com/docs/plugins/tags/) + - [Filters](https://jekyllrb.com/docs/plugins/filters/) + - [Hooks](https://jekyllrb.com/docs/plugins/hooks/) +- GitHub repository: + +### [`hugo`](references/hugo.md) + +- Official documentation: +- All Settings: +- Editor Plugins: +- GitHub repository: diff --git a/skills/markdown-to-html/references/basic-markdown-to-html.md b/skills/markdown-to-html/references/basic-markdown-to-html.md new file mode 100644 index 00000000..2e2f6b96 --- /dev/null +++ b/skills/markdown-to-html/references/basic-markdown-to-html.md @@ -0,0 +1,420 @@ +# Basic Markdown to HTML + +## Headings + +### Markdown + +```md +# Basic writing and formatting syntax +``` + +### Parsed HTML + +```html +

Basic writing and formatting syntax

+``` + +```md +## Headings +``` + +```html +

Headings

+``` + +```md +### A third-level heading +``` + +```html +

A third-level heading

+``` + +### Markdown + +```md +Heading 2 +--- +``` + +### Parsed HTML + +```html +

Heading 2

+``` + +--- + +## Paragraphs + +### Markdown + +```md +Create sophisticated formatting for your prose and code on GitHub with simple syntax. +``` + +### Parsed HTML + +```html +

Create sophisticated formatting for your prose and code on GitHub with simple syntax.

+``` + +--- + +## Inline Formatting + +### Bold + +```md +**This is bold text** +``` + +```html +This is bold text +``` + +--- + +### Italic + +```md +_This text is italicized_ +``` + +```html +This text is italicized +``` + +--- + +### Bold + Italic + +```md +***All this text is important*** +``` + +```html +All this text is important +``` + +--- + +### Strikethrough (GFM) + +```md +~~This was mistaken text~~ +``` + +```html +This was mistaken text +``` + +--- + +### Subscript / Superscript (raw HTML passthrough) + +```md +This is a subscript text +``` + +```html +

This is a subscript text

+``` + +```md +This is a superscript text +``` + +```html +

This is a superscript text

+``` + +--- + +## Blockquotes + +### Markdown + +```md +> Text that is a quote +``` + +### Parsed HTML + +```html +
+

Text that is a quote

+
+``` + +--- + +### GitHub Alert (NOTE) + +```md +> [!NOTE] +> Useful information. +``` + +```html +
+

Note

+

Useful information.

+
+``` + +> ⚠️ The `markdown-alert-*` classes are GitHub-specific, not standard Markdown. + +--- + +## Inline Code + +```md +Use `git status` to list files. +``` + +```html +

Use git status to list files.

+``` + +--- + +## Code Blocks + +### Markdown + +````md +```markdown +git status +git add +``` +```` + +### Parsed HTML + +```html +

+git status
+git add
+
+``` + +--- + +## Tables + +### Markdown + +```md +| Style | Syntax | +|------|--------| +| Bold | ** ** | +``` + +### Parsed HTML + +```html + + + + + + + + + + + + + +
StyleSyntax
Bold
+``` + +--- + +## Links + +### Markdown + +```md +[GitHub Pages](https://pages.github.com/) +``` + +### Parsed HTML + +```html +GitHub Pages +``` + +--- + +## Images + +### Markdown + +```md +![Alt text](image.png) +``` + +### Parsed HTML + +```html +Alt text +``` + +--- + +## Lists + +### Unordered List + +```md +- George Washington +- John Adams +``` + +```html +
    +
  • George Washington
    • +
  • John Adams
    • +
+``` + +--- + +### Ordered List + +```md +1. James Madison +2. James Monroe +``` + +```html +
    +
  1. James Madison
    2. +
  2. James Monroe
    3. +
+``` + +--- + +### Nested Lists + +```md +1. First item + - Nested item +``` + +```html +
    +
  1. + First item +
      +
    • Nested item
      • +
    +
    2. +
+``` + +--- + +## Task Lists (GitHub Flavored Markdown) + +```md +- [x] Done +- [ ] Pending +``` + +```html +
    +
  • + Done +
    • +
  • + Pending +
    • +
+``` + +--- + +## Mentions + +```md +@github/support +``` + +```html +@github/support +``` + +--- + +## Footnotes + +### Markdown + +```md +Here is a footnote[^1]. + +[^1]: My reference. +``` + +### Parsed HTML + +```html +

+ Here is a footnote + + 1 + . +

+ +
+
    +
  1. +

    My reference.

    +
    2. +
+
+``` + +--- + +## HTML Comments (Hidden Content) + +```md + +``` + +```html + +``` + +--- + +## Escaped Markdown Characters + +```md +\*not italic\* +``` + +```html +

*not italic*

+``` + +--- + +## Emoji + +```md +:+1: +``` + +```html +👍 +``` + +(GitHub replaces emoji with `` tags.) + +--- diff --git a/skills/markdown-to-html/references/basic-markdown.md b/skills/markdown-to-html/references/basic-markdown.md new file mode 100644 index 00000000..acb7e890 --- /dev/null +++ b/skills/markdown-to-html/references/basic-markdown.md @@ -0,0 +1,496 @@ +# Basic writing and formatting syntax + +Create sophisticated formatting for your prose and code on GitHub with simple syntax. + +## Headings + +To create a heading, add one to six # symbols before your heading text. The number of # you use will determine the hierarchy level and typeface size of the heading. + +```markdown +# A first-level heading +## A second-level heading +### A third-level heading +``` + +![Screenshot of rendered GitHub Markdown showing sample h1, h2, and h3 headers, which descend in type size and visual weight to show hierarchy level.](https://docs.github.com/assets/images/help/writing/headings-rendered.png) + +When you use two or more headings, GitHub automatically generates a table of contents that you can access by clicking the "Outline" menu icon within the file header. Each heading title is listed in the table of contents and you can click a title to navigate to the selected section. + +![Screenshot of a README file with the drop-down menu for the table of contents exposed. The table of contents icon is outlined in dark orange.](https://docs.github.com/assets/images/help/repository/headings-toc.png) + +## Styling text + +You can indicate emphasis with bold, italic, strikethrough, subscript, or superscript text in comment fields and `.md` files. + +| Style | Syntax | Keyboard shortcut | Example | Output | | +| ---------------------- | ------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------- | -------------------------------------- | ------------------------------------------------- | +| Bold | `** **` or `__ __` | Command+B (Mac) or Ctrl+B (Windows/Linux) | `**This is bold text**` | **This is bold text** | | +| Italic | `* *` or `_ _`      | Command+I (Mac) or Ctrl+I (Windows/Linux) | `_This text is italicized_` | *This text is italicized* | | +| Strikethrough | `~~ ~~` or `~ ~` | None | `~~This was mistaken text~~` | ~~This was mistaken text~~ | | +| Bold and nested italic | `** **` and `_ _` | None | `**This text is _extremely_ important**` | **This text is *extremely* important** | | +| All bold and italic | `*** ***` | None | `***All this text is important***` | ***All this text is important*** | | +| Subscript | ` ` | None | `This is a subscript text` | This is a subscript text | | +| Superscript | ` ` | None | `This is a superscript text` | This is a superscript text | | +| Underline | ` ` | None | `This is an underlined text` | This is an underlined text | | + +## Quoting text + +You can quote text with a >. + +```markdown +Text that is not a quote + +> Text that is a quote +``` + +Quoted text is indented with a vertical line on the left and displayed using gray type. + +![Screenshot of rendered GitHub Markdown showing the difference between normal and quoted text.](https://docs.github.com/assets/images/help/writing/quoted-text-rendered.png) + +> \[!NOTE] +> When viewing a conversation, you can automatically quote text in a comment by highlighting the text, then typing R. You can quote an entire comment by clicking , then **Quote reply**. For more information about keyboard shortcuts, see [Keyboard shortcuts](https://docs.github.com/en/get-started/accessibility/keyboard-shortcuts). + +## Quoting code + +You can call out code or a command within a sentence with single backticks. The text within the backticks will not be formatted. You can also press the Command+E (Mac) or Ctrl+E (Windows/Linux) keyboard shortcut to insert the backticks for a code block within a line of Markdown. + +```markdown +Use `git status` to list all new or modified files that haven't yet been committed. +``` + +![Screenshot of rendered GitHub Markdown showing that characters surrounded by backticks are shown in a fixed-width typeface, highlighted in light gray.](https://docs.github.com/assets/images/help/writing/inline-code-rendered.png) + +To format code or text into its own distinct block, use triple backticks. + +````markdown +Some basic Git commands are: +``` +git status +git add +git commit +``` +```` + +![Screenshot of rendered GitHub Markdown showing a simple code block without syntax highlighting.](https://docs.github.com/assets/images/help/writing/code-block-rendered.png) + +For more information, see [Creating and highlighting code blocks](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks). + +If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). + +## Supported color models + +In issues, pull requests, and discussions, you can call out colors within a sentence by using backticks. A supported color model within backticks will display a visualization of the color. + +```markdown +The background color is `#ffffff` for light mode and `#000000` for dark mode. +``` + +![Screenshot of rendered GitHub Markdown showing how HEX values within backticks create small circles of color, here white and then black.](https://docs.github.com/assets/images/help/writing/supported-color-models-rendered.png) + +Here are the currently supported color models. + +| Color | Syntax | Example | Output | +| ----- | --------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| HEX | \`#RRGGBB\` | \`#0969DA\` | ![Screenshot of rendered GitHub Markdown showing how HEX value #0969DA appears with a blue circle.](https://docs.github.com/assets/images/help/writing/supported-color-models-hex-rendered.png) | +| RGB | \`rgb(R,G,B)\` | \`rgb(9, 105, 218)\` | ![Screenshot of rendered GitHub Markdown showing how RGB value 9, 105, 218 appears with a blue circle.](https://docs.github.com/assets/images/help/writing/supported-color-models-rgb-rendered.png) | +| HSL | \`hsl(H,S,L)\` | \`hsl(212, 92%, 45%)\` | ![Screenshot of rendered GitHub Markdown showing how HSL value 212, 92%, 45% appears with a blue circle.](https://docs.github.com/assets/images/help/writing/supported-color-models-hsl-rendered.png) | + +> \[!NOTE] +> +> * A supported color model cannot have any leading or trailing spaces within the backticks. +> * The visualization of the color is only supported in issues, pull requests, and discussions. + +## Links + +You can create an inline link by wrapping link text in brackets `[ ]`, and then wrapping the URL in parentheses `( )`. You can also use the keyboard shortcut Command+K to create a link. When you have text selected, you can paste a URL from your clipboard to automatically create a link from the selection. + +You can also create a Markdown hyperlink by highlighting the text and using the keyboard shortcut Command+V. If you'd like to replace the text with the link, use the keyboard shortcut Command+Shift+V. + +`This site was built using [GitHub Pages](https://pages.github.com/).` + +![Screenshot of rendered GitHub Markdown showing how text within brackets, "GitHub Pages," appears as a blue hyperlink.](https://docs.github.com/assets/images/help/writing/link-rendered.png) + +> \[!NOTE] +> GitHub automatically creates links when valid URLs are written in a comment. For more information, see [Autolinked references and URLs](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls). + +## Section links + +You can link directly to any section that has a heading. To view the automatically generated anchor in a rendered file, hover over the section heading to expose the icon and click the icon to display the anchor in your browser. + +![Screenshot of a README for a repository. To the left of a section heading, a link icon is outlined in dark orange.](https://docs.github.com/assets/images/help/repository/readme-links.png) + +If you need to determine the anchor for a heading in a file you are editing, you can use the following basic rules: + +* Letters are converted to lower-case. +* Spaces are replaced by hyphens (`-`). Any other whitespace or punctuation characters are removed. +* Leading and trailing whitespace are removed. +* Markup formatting is removed, leaving only the contents (for example, `_italics_` becomes `italics`). +* If the automatically generated anchor for a heading is identical to an earlier anchor in the same document, a unique identifier is generated by appending a hyphen and an auto-incrementing integer. + +For more detailed information on the requirements of URI fragments, see [RFC 3986: Uniform Resource Identifier (URI): Generic Syntax, Section 3.5](https://www.rfc-editor.org/rfc/rfc3986#section-3.5). + +The code block below demonstrates the basic rules used to generate anchors from headings in rendered content. + +```markdown +# Example headings + +## Sample Section + +## This'll be a _Helpful_ Section About the Greek Letter Θ! +A heading containing characters not allowed in fragments, UTF-8 characters, two consecutive spaces between the first and second words, and formatting. + +## This heading is not unique in the file + +TEXT 1 + +## This heading is not unique in the file + +TEXT 2 + +# Links to the example headings above + +Link to the sample section: [Link Text](#sample-section). + +Link to the helpful section: [Link Text](#thisll-be-a-helpful-section-about-the-greek-letter-Θ). + +Link to the first non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file). + +Link to the second non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file-1). +``` + +> \[!NOTE] +> If you edit a heading, or if you change the order of headings with "identical" anchors, you will also need to update any links to those headings as the anchors will change. + +## Relative links + +You can define relative links and image paths in your rendered files to help readers navigate to other files in your repository. + +A relative link is a link that is relative to the current file. For example, if you have a README file in root of your repository, and you have another file in *docs/CONTRIBUTING.md*, the relative link to *CONTRIBUTING.md* in your README might look like this: + +```text +[Contribution guidelines for this project](docs/CONTRIBUTING.md) +``` + +GitHub will automatically transform your relative link or image path based on whatever branch you're currently on, so that the link or path always works. The path of the link will be relative to the current file. Links starting with `/` will be relative to the repository root. You can use all relative link operands, such as `./` and `../`. + +Your link text should be on a single line. The example below will not work. + +```markdown +[Contribution +guidelines for this project](docs/CONTRIBUTING.md) +``` + +Relative links are easier for users who clone your repository. Absolute links may not work in clones of your repository - we recommend using relative links to refer to other files within your repository. + +## Custom anchors + +You can use standard HTML anchor tags (``) to create navigation anchor points for any location in the document. To avoid ambiguous references, use a unique naming scheme for anchor tags, such as adding a prefix to the `name` attribute value. + +> \[!NOTE] +> Custom anchors will not be included in the document outline/Table of Contents. + +You can link to a custom anchor using the value of the `name` attribute you gave the anchor. The syntax is exactly the same as when you link to an anchor that is automatically generated for a heading. + +For example: + +```markdown +# Section Heading + +Some body text of this section. + + +Some text I want to provide a direct link to, but which doesn't have its own heading. + +(… more content…) + +[A link to that custom anchor](#my-custom-anchor-point) +``` + +> \[!TIP] +> Custom anchors are not considered by the automatic naming and numbering behavior of automatic heading links. + +## Line breaks + +If you're writing in issues, pull requests, or discussions in a repository, GitHub will render a line break automatically: + +```markdown +This example +Will span two lines +``` + +However, if you are writing in an .md file, the example above would render on one line without a line break. To create a line break in an .md file, you will need to include one of the following: + +* Include two spaces at the end of the first line. + 
+  This example  
+  Will span two lines
+
+ +* Include a backslash at the end of the first line. + + ```markdown + This example\ + Will span two lines + ``` + +* Include an HTML single line break tag at the end of the first line. + + ```markdown + This example
+ Will span two lines + ``` + +If you leave a blank line between two lines, both .md files and Markdown in issues, pull requests, and discussions will render the two lines separated by the blank line: + +```markdown +This example + +Will have a blank line separating both lines +``` + +## Images + +You can display an image by adding ! and wrapping the alt text in `[ ]`. Alt text is a short text equivalent of the information in the image. Then, wrap the link for the image in parentheses `()`. + +`![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://myoctocat.com/assets/images/base-octocat.svg)` + +![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://docs.github.com/assets/images/help/writing/image-rendered.png) + +GitHub supports embedding images into your issues, pull requests, discussions, comments and `.md` files. You can display an image from your repository, add a link to an online image, or upload an image. For more information, see [Uploading assets](#uploading-assets). + +> \[!NOTE] +> When you want to display an image that is in your repository, use relative links instead of absolute links. + +Here are some examples for using relative links to display an image. + +| Context | Relative Link | +| ----------------------------------------------------------- | ---------------------------------------------------------------------- | +| In a `.md` file on the same branch | `/assets/images/electrocat.png` | +| In a `.md` file on another branch | `/../main/assets/images/electrocat.png` | +| In issues, pull requests and comments of the repository | `../blob/main/assets/images/electrocat.png?raw=true` | +| In a `.md` file in another repository | `/../../../../github/docs/blob/main/assets/images/electrocat.png` | +| In issues, pull requests and comments of another repository | `../../../github/docs/blob/main/assets/images/electrocat.png?raw=true` | + +> \[!NOTE] +> The last two relative links in the table above will work for images in a private repository only if the viewer has at least read access to the private repository that contains these images. + +For more information, see [Relative Links](#relative-links). + +### The Picture element + +The `` HTML element is supported. + +## Lists + +You can make an unordered list by preceding one or more lines of text with -, \*, or +. + +```markdown +- George Washington +* John Adams ++ Thomas Jefferson +``` + +![Screenshot of rendered GitHub Markdown showing a bulleted list of the names of the first three American presidents.](https://docs.github.com/assets/images/help/writing/unordered-list-rendered.png) + +To order your list, precede each line with a number. + +```markdown +1. James Madison +2. James Monroe +3. John Quincy Adams +``` + +![Screenshot of rendered GitHub Markdown showing a numbered list of the names of the fourth, fifth, and sixth American presidents.](https://docs.github.com/assets/images/help/writing/ordered-list-rendered.png) + +### Nested Lists + +You can create a nested list by indenting one or more list items below another item. + +To create a nested list using the web editor on GitHub or a text editor that uses a monospaced font, like [Visual Studio Code](https://code.visualstudio.com/), you can align your list visually. Type space characters in front of your nested list item until the list marker character (- or \*) lies directly below the first character of the text in the item above it. + +```markdown +1. First list item + - First nested list item + - Second nested list item +``` + +> \[!NOTE] +> In the web-based editor, you can indent or dedent one or more lines of text by first highlighting the desired lines and then using Tab or Shift+Tab respectively. + +![Screenshot of Markdown in Visual Studio Code showing indentation of nested numbered lines and bullets.](https://docs.github.com/assets/images/help/writing/nested-list-alignment.png) + +![Screenshot of rendered GitHub Markdown showing a numbered item followed by nested bullets at two different levels of nesting.](https://docs.github.com/assets/images/help/writing/nested-list-example-1.png) + +To create a nested list in the comment editor on GitHub, which doesn't use a monospaced font, you can look at the list item immediately above the nested list and count the number of characters that appear before the content of the item. Then type that number of space characters in front of the nested list item. + +In this example, you could add a nested list item under the list item `100. First list item` by indenting the nested list item a minimum of five spaces, since there are five characters (`100. `) before `First list item`. + +```markdown +100. First list item + - First nested list item +``` + +![Screenshot of rendered GitHub Markdown showing a numbered item prefaced by the number 100 followed by a bulleted item nested one level.](https://docs.github.com/assets/images/help/writing/nested-list-example-3.png) + +You can create multiple levels of nested lists using the same method. For example, because the first nested list item has seven characters (`␣␣␣␣␣-␣`) before the nested list content `First nested list item`, you would need to indent the second nested list item by at least two more characters (nine spaces minimum). + +```markdown +100. First list item + - First nested list item + - Second nested list item +``` + +![Screenshot of rendered GitHub Markdown showing a numbered item prefaced by the number 100 followed by bullets at two different levels of nesting.](https://docs.github.com/assets/images/help/writing/nested-list-example-2.png) + +For more examples, see the [GitHub Flavored Markdown Spec](https://github.github.com/gfm/#example-265). + +## Task lists + +To create a task list, preface list items with a hyphen and space followed by `[ ]`. To mark a task as complete, use `[x]`. + +```markdown +- [x] #739 +- [ ] https://github.com/octo-org/octo-repo/issues/740 +- [ ] Add delight to the experience when all tasks are complete :tada: +``` + +![Screenshot showing the rendered version of the markdown. The references to issues are rendered as issue titles.](https://docs.github.com/assets/images/help/writing/task-list-rendered-simple.png) + +If a task list item description begins with a parenthesis, you'll need to escape it with \\: + +`- [ ] \(Optional) Open a followup issue` + +For more information, see [About tasklists](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists). + +## Mentioning people and teams + +You can mention a person or [team](https://docs.github.com/en/organizations/organizing-members-into-teams) on GitHub by typing @ plus their username or team name. This will trigger a notification and bring their attention to the conversation. People will also receive a notification if you edit a comment to mention their username or team name. For more information about notifications, see [About notifications](https://docs.github.com/en/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications). + +> \[!NOTE] +> A person will only be notified about a mention if the person has read access to the repository and, if the repository is owned by an organization, the person is a member of the organization. + +`@github/support What do you think about these updates?` + +![Screenshot of rendered GitHub Markdown showing how the team mention "@github/support" renders as bold, clickable text.](https://docs.github.com/assets/images/help/writing/mention-rendered.png) + +When you mention a parent team, members of its child teams also receive notifications, simplifying communication with multiple groups of people. For more information, see [About organization teams](https://docs.github.com/en/organizations/organizing-members-into-teams/about-teams). + +Typing an @ symbol will bring up a list of people or teams on a project. The list filters as you type, so once you find the name of the person or team you are looking for, you can use the arrow keys to select it and press either tab or enter to complete the name. For teams, enter the @organization/team-name and all members of that team will get subscribed to the conversation. + +The autocomplete results are restricted to repository collaborators and any other participants on the thread. + +## Referencing issues and pull requests + +You can bring up a list of suggested issues and pull requests within the repository by typing #. Type the issue or pull request number or title to filter the list, and then press either tab or enter to complete the highlighted result. + +For more information, see [Autolinked references and URLs](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls). + +## Referencing external resources + +If custom autolink references are configured for a repository, then references to external resources, like a JIRA issue or Zendesk ticket, convert into shortened links. To know which autolinks are available in your repository, contact someone with admin permissions to the repository. For more information, see [Configuring autolinks to reference external resources](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources). + +## Uploading assets + +You can upload assets like images by dragging and dropping, selecting from a file browser, or pasting. You can upload assets to issues, pull requests, comments, and `.md` files in your repository. + +## Using emojis + +You can add emoji to your writing by typing `:EMOJICODE:`, a colon followed by the name of the emoji. + +`@octocat :+1: This PR looks great - it's ready to merge! :shipit:` + +![Screenshot of rendered GitHub Markdown showing how emoji codes for +1 and shipit render visually as emoji.](https://docs.github.com/assets/images/help/writing/emoji-rendered.png) + +Typing : will bring up a list of suggested emoji. The list will filter as you type, so once you find the emoji you're looking for, press **Tab** or **Enter** to complete the highlighted result. + +For a full list of available emoji and codes, see [the Emoji-Cheat-Sheet](https://github.com/ikatyang/emoji-cheat-sheet/blob/github-actions-auto-update/README.md). + +## Paragraphs + +You can create a new paragraph by leaving a blank line between lines of text. + +## Footnotes + +You can add footnotes to your content by using this bracket syntax: + +```text +Here is a simple footnote[^1]. + +A footnote can also have multiple lines[^2]. + +[^1]: My reference. +[^2]: To add line breaks within a footnote, add 2 spaces to the end of a line. +This is a second line. +``` + +The footnote will render like this: + +![Screenshot of rendered Markdown showing superscript numbers used to indicate footnotes, along with optional line breaks inside a note.](https://docs.github.com/assets/images/help/writing/footnote-rendered.png) + +> \[!NOTE] +> The position of a footnote in your Markdown does not influence where the footnote will be rendered. You can write a footnote right after your reference to the footnote, and the footnote will still render at the bottom of the Markdown. Footnotes are not supported in wikis. + +## Alerts + +**Alerts**, also sometimes known as **callouts** or **admonitions**, are a Markdown extension based on the blockquote syntax that you can use to emphasize critical information. On GitHub, they are displayed with distinctive colors and icons to indicate the significance of the content. + +Use alerts only when they are crucial for user success and limit them to one or two per article to prevent overloading the reader. Additionally, you should avoid placing alerts consecutively. Alerts cannot be nested within other elements. + +To add an alert, use a special blockquote line specifying the alert type, followed by the alert information in a standard blockquote. Five types of alerts are available: + +```markdown +> [!NOTE] +> Useful information that users should know, even when skimming content. + +> [!TIP] +> Helpful advice for doing things better or more easily. + +> [!IMPORTANT] +> Key information users need to know to achieve their goal. + +> [!WARNING] +> Urgent info that needs immediate user attention to avoid problems. + +> [!CAUTION] +> Advises about risks or negative outcomes of certain actions. +``` + +Here are the rendered alerts: + +![Screenshot of rendered Markdown alerts showing how Note, Tip, Important, Warning, and Caution render with different colored text and icons.](https://docs.github.com/assets/images/help/writing/alerts-rendered.png) + +## Hiding content with comments + +You can tell GitHub to hide content from the rendered Markdown by placing the content in an HTML comment. + +```text + +``` + +## Ignoring Markdown formatting + +You can tell GitHub to ignore (or escape) Markdown formatting by using \\ before the Markdown character. + +`Let's rename \*our-new-project\* to \*our-old-project\*.` + +![Screenshot of rendered GitHub Markdown showing how backslashes prevent the conversion of asterisks to italics.](https://docs.github.com/assets/images/help/writing/escaped-character-rendered.png) + +For more information on backslashes, see Daring Fireball's [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax#backslash). + +> \[!NOTE] +> The Markdown formatting will not be ignored in the title of an issue or a pull request. + +## Disabling Markdown rendering + +When viewing a Markdown file, you can click **Code** at the top of the file to disable Markdown rendering and view the file's source instead. + +![Screenshot of a Markdown file in a repository showing options for interacting with the file. A button, labeled "Code", is outlined in dark orange.](https://docs.github.com/assets/images/help/writing/display-markdown-as-source-global-nav-update.png) + +Disabling Markdown rendering enables you to use source view features, such as line linking, which is not possible when viewing rendered Markdown files. + +## Further reading + +*[GitHub Flavored Markdown Spec](https://github.github.com/gfm/) +*[About writing and formatting on GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github) +*[Working with advanced formatting](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting) +*[Quickstart for writing on GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github) \ No newline at end of file diff --git a/skills/markdown-to-html/references/code-blocks-to-html.md b/skills/markdown-to-html/references/code-blocks-to-html.md new file mode 100644 index 00000000..9e2901e9 --- /dev/null +++ b/skills/markdown-to-html/references/code-blocks-to-html.md @@ -0,0 +1,165 @@ +# Code Blocks to HTML + +## Fenced Code Blocks (No Language) + +### Markdown + +``` +function test() { + console.log("notice the blank line before this function?"); +} +``` + +### Parsed HTML + +```html +

+function test() {
+  console.log("notice the blank line before this function?");
+}
+
+``` + +--- + +## GitHub Tip Callout + +### Markdown + +```md +> [!TIP] +> To preserve your formatting within a list, make sure to indent non-fenced code blocks by eight spaces. +``` + +### Parsed HTML (GitHub-specific) + +```html +
+

Tip

+

To preserve your formatting within a list, make sure to indent non-fenced code blocks by eight spaces.

+
+``` + +--- + +## Showing Backticks Inside Code Blocks + +### Markdown + +`````md + ```` + ``` + Look! You can see my backticks. + ``` + ```` +````` + +### Parsed HTML + +```html + 

+    ```
+
+    Look! You can see my backticks.
+
+    ```
+
+``` + +## Syntax Highlighting (Language Identifier) + +### Markdown + +```ruby +require 'redcarpet' +markdown = Redcarpet.new("Hello World!") +puts markdown.to_html +``` + +### Parsed HTML + +```html +

+require 'redcarpet'
+markdown = Redcarpet.new("Hello World!")
+puts markdown.to_html
+
+``` + +> The `language-ruby` class is consumed by GitHub’s syntax highlighter (Linguist + grammar). + +### Summary: Syntax-Highlighting Rules (HTML-Level) + +| Markdown fence | Parsed `` tag | +| -------------- | ------------------------------ | +| ```js | `` | +| ```html | `` | +| ```md | `` | +| ``` (no lang) | `` | + +--- + +## HTML Comments (Ignored by Renderer) + +```md + +``` + +```html + +``` + +--- + +## Links + +```md +[About writing and formatting on GitHub](https://docs.github.com/...) +``` + +```html +About writing and formatting on GitHub +``` + +--- + +## Lists + +```md +* [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) +``` + +```html + +``` + +--- + +## Diagrams (Conceptual Parsing) + +### Markdown + +````md +```mermaid +graph TD + A --> B +``` +```` + +### Parsed HTML + +```html +

+graph TD
+  A --> B
+
+``` + +## Closing Notes + +* No `language-*` class appears here because **no language identifier** was provided. +* The inner triple backticks are preserved **as literal text** inside ``. diff --git a/skills/markdown-to-html/references/code-blocks.md b/skills/markdown-to-html/references/code-blocks.md new file mode 100644 index 00000000..0f9ef2bd --- /dev/null +++ b/skills/markdown-to-html/references/code-blocks.md @@ -0,0 +1,70 @@ +# Creating and highlighting code blocks + +Share samples of code with fenced code blocks and enabling syntax highlighting. + +## Fenced code blocks + +You can create fenced code blocks by placing triple backticks \`\`\` before and after the code block. We recommend placing a blank line before and after code blocks to make the raw formatting easier to read. + +````text +``` +function test() { + console.log("notice the blank line before this function?"); +} +``` +```` + +![Screenshot of rendered GitHub Markdown showing the use of triple backticks to create code blocks. The block begins with "function test() {."](https://docs.github.com/assets/images/help/writing/fenced-code-block-rendered.png) + +> \[!TIP] +> To preserve your formatting within a list, make sure to indent non-fenced code blocks by eight spaces. + +To display triple backticks in a fenced code block, wrap them inside quadruple backticks. + +`````text +```` +``` +Look! You can see my backticks. +``` +```` +````` + +![Screenshot of rendered Markdown showing that when you write triple backticks between quadruple backticks they are visible in the rendered content.](https://docs.github.com/assets/images/help/writing/fenced-code-show-backticks-rendered.png) + +If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). + +## Syntax highlighting + + + +You can add an optional language identifier to enable syntax highlighting in your fenced code block. + +Syntax highlighting changes the color and style of source code to make it easier to read. + +For example, to syntax highlight Ruby code: + +````text +```ruby +require 'redcarpet' +markdown = Redcarpet.new("Hello World!") +puts markdown.to_html +``` +```` + +This will display the code block with syntax highlighting: + +![Screenshot of three lines of Ruby code as displayed on GitHub. Elements of the code display in purple, blue, and red type for scannability.](https://docs.github.com/assets/images/help/writing/code-block-syntax-highlighting-rendered.png) + +> \[!TIP] +> When you create a fenced code block that you also want to have syntax highlighting on a GitHub Pages site, use lower-case language identifiers. For more information, see [About GitHub Pages and Jekyll](https://docs.github.com/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#syntax-highlighting). + +We use [Linguist](https://github.com/github-linguist/linguist) to perform language detection and to select [third-party grammars](https://github.com/github-linguist/linguist/blob/main/vendor/README.md) for syntax highlighting. You can find out which keywords are valid in [the languages YAML file](https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml). + +## Creating diagrams + +You can also use code blocks to create diagrams in Markdown. GitHub supports Mermaid, GeoJSON, TopoJSON, and ASCII STL syntax. For more information, see [Creating diagrams](https://docs.github.com/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams). + +## Further reading + +* [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) +* [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file diff --git a/skills/markdown-to-html/references/collapsed-sections-to-html.md b/skills/markdown-to-html/references/collapsed-sections-to-html.md new file mode 100644 index 00000000..2689c6bb --- /dev/null +++ b/skills/markdown-to-html/references/collapsed-sections-to-html.md @@ -0,0 +1,136 @@ +# Collapsed Sections to HTML + +## `
` Block (Raw HTML in Markdown) + +### Markdown + +````md +
+ +Tips for collapsed sections + +### You can add a header + +You can add text within a collapsed section. + +You can add an image or a code block, too. + + ```ruby + puts "Hello World" + ``` + +
+```` + +--- + +### Parsed HTML + +```html +
+ Tips for collapsed sections + +

You can add a header

+ +

You can add text within a collapsed section.

+ +

You can add an image or a code block, too.

+ + 

+puts "Hello World"
+
+
+``` + +#### Notes: + +* Markdown **inside `
`** is still parsed normally. +* Syntax highlighting is preserved via `class="language-ruby"`. + +--- + +## Open by Default (`open` attribute) + +### Markdown + +````md +
+ +Tips for collapsed sections + +### You can add a header + +You can add text within a collapsed section. + +You can add an image or a code block, too. + + ```ruby + puts "Hello World" + ``` + +
+```` + +### Parsed HTML + +```html +
+ Tips for collapsed sections + +

You can add a header

+ +

You can add text within a collapsed section.

+ +

You can add an image or a code block, too.

+ + 

+puts "Hello World"
+
+
+``` + +## Key Rules + +* `
` and `` are **raw HTML**, not Markdown syntax +* Markdown inside `
` **is still parsed** +* Syntax highlighting works normally inside collapsed sections +* Use `` as the **clickable label** + +## Paragraphs with Inline HTML & SVG + +### Markdown + +```md +You can streamline your Markdown by creating a collapsed section with the `
` tag. +``` + +### Parsed HTML + +```html +

+ You can streamline your Markdown by creating a collapsed section with the <details> tag. +

+``` + +--- + +### Markdown (inline SVG preserved) + +```md +Any Markdown within the `
` block will be collapsed until the reader clicks to expand the details. +``` + +### Parsed HTML + +```html +

+ Any Markdown within the <details> block will be collapsed until the reader clicks + + + + to expand the details. +

+``` diff --git a/skills/markdown-to-html/references/collapsed-sections.md b/skills/markdown-to-html/references/collapsed-sections.md new file mode 100644 index 00000000..11309e4b --- /dev/null +++ b/skills/markdown-to-html/references/collapsed-sections.md @@ -0,0 +1,48 @@ +# Organizing information with collapsed sections + +You can streamline your Markdown by creating a collapsed section with the `
` tag. + +## Creating a collapsed section + +You can temporarily obscure sections of your Markdown by creating a collapsed section that the reader can choose to expand. For example, when you want to include technical details in an issue comment that may not be relevant or interesting to every reader, you can put those details in a collapsed section. + +Any Markdown within the `
` block will be collapsed until the reader clicks to expand the details. + +Within the `
` block, use the `` tag to let readers know what is inside. The label appears to the right of . + +````markdown +
+ +Tips for collapsed sections + +### You can add a header + +You can add text within a collapsed section. + +You can add an image or a code block, too. + +```ruby + puts "Hello World" +``` + +
+```` + +The Markdown inside the `` label will be collapsed by default: + +![Screenshot of the Markdown above on this page as rendered on GitHub, showing a right-facing arrow and the header "Tips for collapsed sections."](https://docs.github.com/assets/images/help/writing/collapsed-section-view.png) + +After a reader clicks , the details are expanded: + +![Screenshot of the Markdown above on this page as rendered on GitHub. The collapsed section contains headers, text, images, and code blocks.](https://docs.github.com/assets/images/help/writing/open-collapsed-section.png) + +Optionally, to make the section display as open by default, add the `open` attribute to the `
` tag: + +```html +
+``` + +## Further reading + +* [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) +* [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file diff --git a/skills/markdown-to-html/references/gomarkdown.md b/skills/markdown-to-html/references/gomarkdown.md new file mode 100644 index 00000000..21abf824 --- /dev/null +++ b/skills/markdown-to-html/references/gomarkdown.md @@ -0,0 +1,253 @@ +# gomarkdown/markdown Reference + +Go library for parsing Markdown and rendering HTML. Fast, extensible, and thread-safe. + +## Installation + +```bash +# Add to your Go project +go get github.com/gomarkdown/markdown + +# Install CLI tool +go install github.com/gomarkdown/mdtohtml@latest +``` + +## Basic Usage + +### Simple Conversion + +```go +package main + +import ( + "fmt" + "github.com/gomarkdown/markdown" +) + +func main() { + md := []byte("# Hello World\n\nThis is **bold** text.") + html := markdown.ToHTML(md, nil, nil) + fmt.Println(string(html)) +} +``` + +### Using CLI Tool + +```bash +# Convert file to HTML +mdtohtml input.md output.html + +# Output to stdout +mdtohtml input.md +``` + +## Parser Configuration + +### Common Extensions + +```go +import ( + "github.com/gomarkdown/markdown" + "github.com/gomarkdown/markdown/parser" +) + +// Create parser with extensions +extensions := parser.CommonExtensions | parser.AutoHeadingIDs +p := parser.NewWithExtensions(extensions) + +// Parse markdown +doc := p.Parse(md) +``` + +### Available Parser Extensions + +| Extension | Description | +|-----------|-------------| +| `parser.CommonExtensions` | Tables, fenced code, autolinks, strikethrough | +| `parser.Tables` | Pipe tables support | +| `parser.FencedCode` | Fenced code blocks with language | +| `parser.Autolink` | Auto-detect URLs | +| `parser.Strikethrough` | ~~strikethrough~~ text | +| `parser.SpaceHeadings` | Require space after # in headings | +| `parser.HeadingIDs` | Custom heading IDs {#id} | +| `parser.AutoHeadingIDs` | Auto-generate heading IDs | +| `parser.Footnotes` | Footnote support | +| `parser.NoEmptyLineBeforeBlock` | No blank line required before blocks | +| `parser.HardLineBreak` | Newlines become `
` | +| `parser.MathJax` | MathJax support | +| `parser.SuperSubscript` | Super^script^ and sub~script~ | +| `parser.Mmark` | Mmark syntax support | + +## HTML Renderer Configuration + +### Common Flags + +```go +import ( + "github.com/gomarkdown/markdown" + "github.com/gomarkdown/markdown/html" + "github.com/gomarkdown/markdown/parser" +) + +// Parser +p := parser.NewWithExtensions(parser.CommonExtensions) + +// Renderer +htmlFlags := html.CommonFlags | html.HrefTargetBlank +opts := html.RendererOptions{ + Flags: htmlFlags, + Title: "My Document", + CSS: "style.css", +} +renderer := html.NewRenderer(opts) + +// Convert +html := markdown.ToHTML(md, p, renderer) +``` + +### Available HTML Flags + +| Flag | Description | +|------|-------------| +| `html.CommonFlags` | Common sensible defaults | +| `html.HrefTargetBlank` | Add `target="_blank"` to links | +| `html.CompletePage` | Generate complete HTML document | +| `html.UseXHTML` | Use XHTML output | +| `html.FootnoteReturnLinks` | Add return links in footnotes | +| `html.FootnoteNoHRTag` | No `
` before footnotes | +| `html.Smartypants` | Smart punctuation | +| `html.SmartypantsFractions` | Smart fractions (1/2 → ½) | +| `html.SmartypantsDashes` | Smart dashes (-- → –) | +| `html.SmartypantsLatexDashes` | LaTeX-style dashes | + +### Renderer Options + +```go +opts := html.RendererOptions{ + Flags: htmlFlags, + Title: "Document Title", + CSS: "path/to/style.css", + Icon: "favicon.ico", + Head: []byte(""), + RenderNodeHook: customRenderHook, +} +``` + +## Complete Example + +```go +package main + +import ( + "os" + "github.com/gomarkdown/markdown" + "github.com/gomarkdown/markdown/html" + "github.com/gomarkdown/markdown/parser" +) + +func mdToHTML(md []byte) []byte { + // Parser with extensions + extensions := parser.CommonExtensions | + parser.AutoHeadingIDs | + parser.NoEmptyLineBeforeBlock + p := parser.NewWithExtensions(extensions) + doc := p.Parse(md) + + // HTML renderer with options + htmlFlags := html.CommonFlags | html.HrefTargetBlank + opts := html.RendererOptions{Flags: htmlFlags} + renderer := html.NewRenderer(opts) + + return markdown.Render(doc, renderer) +} + +func main() { + md, _ := os.ReadFile("input.md") + html := mdToHTML(md) + os.WriteFile("output.html", html, 0644) +} +``` + +## Security: Sanitizing Output + +**Important:** gomarkdown does not sanitize HTML output. Use Bluemonday for untrusted input: + +```go +import ( + "github.com/microcosm-cc/bluemonday" + "github.com/gomarkdown/markdown" +) + +// Convert markdown to potentially unsafe HTML +unsafeHTML := markdown.ToHTML(md, nil, nil) + +// Sanitize using Bluemonday +p := bluemonday.UGCPolicy() +safeHTML := p.SanitizeBytes(unsafeHTML) +``` + +### Bluemonday Policies + +| Policy | Description | +|--------|-------------| +| `UGCPolicy()` | User-generated content (most common) | +| `StrictPolicy()` | Strip all HTML | +| `StripTagsPolicy()` | Strip tags, keep text | +| `NewPolicy()` | Build custom policy | + +## Working with AST + +### Accessing the AST + +```go +import ( + "github.com/gomarkdown/markdown/ast" + "github.com/gomarkdown/markdown/parser" +) + +p := parser.NewWithExtensions(parser.CommonExtensions) +doc := p.Parse(md) + +// Walk the AST +ast.WalkFunc(doc, func(node ast.Node, entering bool) ast.WalkStatus { + if heading, ok := node.(*ast.Heading); ok && entering { + fmt.Printf("Found heading level %d\n", heading.Level) + } + return ast.GoToNext +}) +``` + +### Custom Renderer + +```go +type MyRenderer struct { + *html.Renderer +} + +func (r *MyRenderer) RenderNode(w io.Writer, node ast.Node, entering bool) ast.WalkStatus { + // Custom rendering logic + if heading, ok := node.(*ast.Heading); ok && entering { + fmt.Fprintf(w, "", heading.Level) + return ast.GoToNext + } + return r.Renderer.RenderNode(w, node, entering) +} +``` + +## Handling Newlines + +Windows and Mac newlines need normalization: + +```go +// Normalize newlines before parsing +normalized := parser.NormalizeNewlines(input) +html := markdown.ToHTML(normalized, nil, nil) +``` + +## Resources + +- [Package Documentation](https://pkg.go.dev/github.com/gomarkdown/markdown) +- [Advanced Processing Guide](https://blog.kowalczyk.info/article/cxn3/advanced-markdown-processing-in-go.html) +- [GitHub Repository](https://github.com/gomarkdown/markdown) +- [CLI Tool](https://github.com/gomarkdown/mdtohtml) +- [Bluemonday Sanitizer](https://github.com/microcosm-cc/bluemonday) diff --git a/skills/markdown-to-html/references/hugo.md b/skills/markdown-to-html/references/hugo.md new file mode 100644 index 00000000..07904508 --- /dev/null +++ b/skills/markdown-to-html/references/hugo.md @@ -0,0 +1,394 @@ +# Hugo Reference + +Hugo is the world's fastest static site generator. It builds sites in milliseconds and supports advanced content management features. + +## Installation + +### Windows + +```powershell +# Using Chocolatey +choco install hugo-extended + +# Using Scoop +scoop install hugo-extended + +# Using Winget +winget install Hugo.Hugo.Extended +``` + +### macOS + +```bash +# Using Homebrew +brew install hugo +``` + +### Linux + +```bash +# Debian/Ubuntu (snap) +snap install hugo --channel=extended + +# Using package manager (may not be latest) +sudo apt-get install hugo + +# Or download from https://gohugo.io/installation/ +``` + +## Quick Start + +### Create New Site + +```bash +# Create site +hugo new site mysite +cd mysite + +# Initialize git and add theme +git init +git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke +echo "theme = 'ananke'" >> hugo.toml + +# Create first post +hugo new content posts/my-first-post.md + +# Start development server +hugo server -D +``` + +### Directory Structure + +``` +mysite/ +├── archetypes/ # Content templates +│ └── default.md +├── assets/ # Assets to process (SCSS, JS) +├── content/ # Markdown content +│ └── posts/ +├── data/ # Data files (YAML, JSON, TOML) +├── i18n/ # Internationalization +├── layouts/ # Templates +│ ├── _default/ +│ ├── partials/ +│ └── shortcodes/ +├── static/ # Static files (copied as-is) +├── themes/ # Themes +└── hugo.toml # Configuration +``` + +## CLI Commands + +| Command | Description | +|---------|-------------| +| `hugo new site ` | Create new site | +| `hugo new content ` | Create content file | +| `hugo` | Build to `public/` | +| `hugo server` | Start dev server | +| `hugo mod init` | Initialize Hugo Modules | +| `hugo mod tidy` | Clean up modules | + +### Build Options + +```bash +# Basic build +hugo + +# Build with minification +hugo --minify + +# Build with drafts +hugo -D + +# Build for specific environment +hugo --environment production + +# Build to custom directory +hugo -d ./dist + +# Verbose output +hugo -v +``` + +### Server Options + +```bash +# Start with drafts +hugo server -D + +# Bind to all interfaces +hugo server --bind 0.0.0.0 + +# Custom port +hugo server --port 8080 + +# Disable live reload +hugo server --disableLiveReload + +# Navigate to changed content +hugo server --navigateToChanged +``` + +## Configuration (hugo.toml) + +```toml +# Basic settings +baseURL = 'https://example.com/' +languageCode = 'en-us' +title = 'My Hugo Site' +theme = 'ananke' + +# Build settings +[build] + writeStats = true + +# Markdown configuration +[markup] + [markup.goldmark] + [markup.goldmark.extensions] + definitionList = true + footnote = true + linkify = true + strikethrough = true + table = true + taskList = true + [markup.goldmark.parser] + autoHeadingID = true + autoHeadingIDType = 'github' + [markup.goldmark.renderer] + unsafe = false + [markup.highlight] + style = 'monokai' + lineNos = true + +# Taxonomies +[taxonomies] + category = 'categories' + tag = 'tags' + author = 'authors' + +# Menus +[menus] + [[menus.main]] + name = 'Home' + pageRef = '/' + weight = 10 + [[menus.main]] + name = 'Posts' + pageRef = '/posts' + weight = 20 + +# Parameters +[params] + description = 'My awesome site' + author = 'John Doe' +``` + +## Front Matter + +Hugo supports TOML, YAML, and JSON front matter: + +### TOML (default) + +```markdown ++++ +title = 'My First Post' +date = 2025-01-28T12:00:00-05:00 +draft = false +tags = ['hugo', 'tutorial'] +categories = ['blog'] +author = 'John Doe' ++++ + +Content here... +``` + +### YAML + +```markdown +--- +title: "My First Post" +date: 2025-01-28T12:00:00-05:00 +draft: false +tags: ["hugo", "tutorial"] +--- + +Content here... +``` + +## Templates + +### Base Template (_default/baseof.html) + +```html + + + + {{ .Title }} | {{ .Site.Title }} + {{ partial "head.html" . }} + + + {{ partial "header.html" . }} +
+ {{ block "main" . }}{{ end }} +
+ {{ partial "footer.html" . }} + + +``` + +### Single Page (_default/single.html) + +```html +{{ define "main" }} +
+

{{ .Title }}

+ + {{ .Content }} +
+{{ end }} +``` + +### List Page (_default/list.html) + +```html +{{ define "main" }} +

{{ .Title }}

+{{ range .Pages }} + +{{ end }} +{{ end }} +``` + +## Shortcodes + +### Built-in Shortcodes + +```markdown +{{< figure src="/images/photo.jpg" title="My Photo" >}} + +{{< youtube dQw4w9WgXcQ >}} + +{{< gist user 12345 >}} + +{{< highlight go >}} +fmt.Println("Hello") +{{< /highlight >}} +``` + +### Custom Shortcode (layouts/shortcodes/alert.html) + +```html +
+ {{ .Inner | markdownify }} +
+``` + +Usage: + +```markdown +{{< alert type="warning" >}} +**Warning:** This is important! +{{< /alert >}} +``` + +## Content Organization + +### Page Bundles + +``` +content/ +├── posts/ +│ └── my-post/ # Page bundle +│ ├── index.md # Content +│ └── image.jpg # Resources +└── _index.md # Section page +``` + +### Accessing Resources + +```html +{{ $image := .Resources.GetMatch "image.jpg" }} +{{ with $image }} + ... +{{ end }} +``` + +## Hugo Pipes (Asset Processing) + +### SCSS Compilation + +```html +{{ $styles := resources.Get "scss/main.scss" | toCSS | minify }} + +``` + +### JavaScript Bundling + +```html +{{ $js := resources.Get "js/main.js" | js.Build | minify }} + +``` + +## Taxonomies + +### Configure + +```toml +[taxonomies] + tag = 'tags' + category = 'categories' +``` + +### Use in Front Matter + +```markdown ++++ +tags = ['go', 'hugo'] +categories = ['tutorials'] ++++ +``` + +### List Taxonomy Terms + +```html +{{ range .Site.Taxonomies.tags }} + {{ .Page.Title }} ({{ .Count }}) +{{ end }} +``` + +## Multilingual Sites + +```toml +defaultContentLanguage = 'en' + +[languages] + [languages.en] + title = 'My Site' + weight = 1 + [languages.es] + title = 'Mi Sitio' + weight = 2 +``` + +## Troubleshooting + +| Issue | Solution | +|-------|----------| +| Page not found | Check `baseURL` configuration | +| Theme not loading | Verify theme path in config | +| Raw HTML not showing | Set `unsafe = true` in goldmark config | +| Slow builds | Use `--templateMetrics` to debug | +| Module errors | Run `hugo mod tidy` | +| CSS not updating | Clear browser cache or use fingerprinting | + +## Resources + +- [Hugo Documentation](https://gohugo.io/documentation/) +- [Hugo Themes](https://themes.gohugo.io/) +- [Hugo Discourse](https://discourse.gohugo.io/) +- [GitHub Repository](https://github.com/gohugoio/hugo) +- [Quick Reference](https://gohugo.io/quick-reference/) diff --git a/skills/markdown-to-html/references/jekyll.md b/skills/markdown-to-html/references/jekyll.md new file mode 100644 index 00000000..cc99a935 --- /dev/null +++ b/skills/markdown-to-html/references/jekyll.md @@ -0,0 +1,321 @@ +# Jekyll Reference + +Jekyll is a static site generator that transforms Markdown content into complete websites. It's blog-aware and powers GitHub Pages. + +## Installation + +### Prerequisites + +- Ruby 2.7.0 or higher +- RubyGems +- GCC and Make + +### Install Jekyll + +```bash +# Install Jekyll and Bundler +gem install jekyll bundler +``` + +### Platform-Specific Installation + +```bash +# macOS (install Xcode CLI tools first) +xcode-select --install +gem install jekyll bundler + +# Ubuntu/Debian +sudo apt-get install ruby-full build-essential zlib1g-dev +gem install jekyll bundler + +# Windows (use RubyInstaller) +# Download from https://rubyinstaller.org/ +gem install jekyll bundler +``` + +## Quick Start + +### Create New Site + +```bash +# Create new Jekyll site +jekyll new myblog + +# Navigate to site +cd myblog + +# Build and serve +bundle exec jekyll serve + +# Open http://localhost:4000 +``` + +### Directory Structure + +``` +myblog/ +├── _config.yml # Site configuration +├── _posts/ # Blog posts +│ └── 2025-01-28-welcome.md +├── _layouts/ # Page templates +├── _includes/ # Reusable components +├── _data/ # Data files (YAML, JSON, CSV) +├── _sass/ # Sass partials +├── assets/ # CSS, JS, images +├── index.md # Home page +└── Gemfile # Ruby dependencies +``` + +## CLI Commands + +| Command | Description | +|---------|-------------| +| `jekyll new ` | Create new site | +| `jekyll build` | Build to `_site/` | +| `jekyll serve` | Build and serve locally | +| `jekyll clean` | Remove generated files | +| `jekyll doctor` | Check for issues | + +### Build Options + +```bash +# Build site +bundle exec jekyll build + +# Build with production environment +JEKYLL_ENV=production bundle exec jekyll build + +# Build to custom directory +bundle exec jekyll build --destination ./public + +# Build with incremental regeneration +bundle exec jekyll build --incremental +``` + +### Serve Options + +```bash +# Serve with live reload +bundle exec jekyll serve --livereload + +# Include draft posts +bundle exec jekyll serve --drafts + +# Specify port +bundle exec jekyll serve --port 8080 + +# Bind to all interfaces +bundle exec jekyll serve --host 0.0.0.0 +``` + +## Configuration (_config.yml) + +```yaml +# Site settings +title: My Blog +description: A great blog +baseurl: "" +url: "https://example.com" + +# Build settings +markdown: kramdown +theme: minima +plugins: + - jekyll-feed + - jekyll-seo-tag + +# Kramdown settings +kramdown: + input: GFM + syntax_highlighter: rouge + hard_wrap: false + +# Collections +collections: + docs: + output: true + permalink: /docs/:name/ + +# Defaults +defaults: + - scope: + path: "" + type: "posts" + values: + layout: "post" + +# Exclude from processing +exclude: + - Gemfile + - Gemfile.lock + - node_modules + - vendor +``` + +## Front Matter + +Every content file needs YAML front matter: + +```markdown +--- +layout: post +title: "My First Post" +date: 2025-01-28 12:00:00 -0500 +categories: blog tutorial +tags: [jekyll, markdown] +author: John Doe +excerpt: "A brief introduction..." +published: true +--- + +Your content here... +``` + +## Markdown Processors + +### Kramdown (Default) + +```yaml +# _config.yml +markdown: kramdown +kramdown: + input: GFM # GitHub Flavored Markdown + syntax_highlighter: rouge + syntax_highlighter_opts: + block: + line_numbers: true +``` + +### CommonMark + +```ruby +# Gemfile +gem 'jekyll-commonmark-ghpages' +``` + +```yaml +# _config.yml +markdown: CommonMarkGhPages +commonmark: + options: ["SMART", "FOOTNOTES"] + extensions: ["strikethrough", "autolink", "table"] +``` + +## Liquid Templating + +### Variables + +```liquid +{{ page.title }} +{{ site.title }} +{{ content }} +{{ page.date | date: "%B %d, %Y" }} +``` + +### Loops + +```liquid +{% for post in site.posts %} + +{% endfor %} +``` + +### Conditionals + +```liquid +{% if page.title %} +

{{ page.title }}

+{% endif %} + +{% unless page.draft %} + {{ content }} +{% endunless %} +``` + +### Includes + +```liquid +{% include header.html %} +{% include footer.html param="value" %} +``` + +## Layouts + +### Basic Layout (_layouts/default.html) + +```html + + + + {{ page.title }} | {{ site.title }} + + + + {% include header.html %} +
+ {{ content }} +
+ {% include footer.html %} + + +``` + +### Post Layout (_layouts/post.html) + +```html +--- +layout: default +--- +
+

{{ page.title }}

+ + {{ content }} +
+``` + +## Plugins + +### Common Plugins + +```ruby +# Gemfile +group :jekyll_plugins do + gem 'jekyll-feed' # RSS feed + gem 'jekyll-seo-tag' # SEO meta tags + gem 'jekyll-sitemap' # XML sitemap + gem 'jekyll-paginate' # Pagination + gem 'jekyll-archives' # Archive pages +end +``` + +### Using Plugins + +```yaml +# _config.yml +plugins: + - jekyll-feed + - jekyll-seo-tag + - jekyll-sitemap +``` + +## Troubleshooting + +| Issue | Solution | +|-------|----------| +| Ruby 3.0+ webrick error | `bundle add webrick` | +| Permission denied | Use `--user-install` or rbenv | +| Slow builds | Use `--incremental` | +| Liquid errors | Check for unescaped `{` `}` | +| Encoding issues | Add `encoding: utf-8` to config | +| Plugin not loading | Add to both Gemfile and _config.yml | + +## Resources + +- [Jekyll Documentation](https://jekyllrb.com/docs/) +- [Liquid Template Language](https://shopify.github.io/liquid/) +- [Kramdown Documentation](https://kramdown.gettalong.org/) +- [GitHub Repository](https://github.com/jekyll/jekyll) +- [Jekyll Themes](https://jekyllthemes.io/) diff --git a/skills/markdown-to-html/references/marked.md b/skills/markdown-to-html/references/marked.md new file mode 100644 index 00000000..caadd69c --- /dev/null +++ b/skills/markdown-to-html/references/marked.md @@ -0,0 +1,121 @@ +# Marked + +## Quick Conversion Methods + +Expanded portions of `SKILL.md` at `### Quick Conversion Methods`. + +### Method 1: CLI (Recommended for Single Files) + +```bash +# Convert file to HTML +marked -i input.md -o output.html + +# Convert string directly +marked -s "# Hello World" + +# Output:

Hello World

+``` + +### Method 2: Node.js Script + +```javascript +import { marked } from 'marked'; +import { readFileSync, writeFileSync } from 'fs'; + +const markdown = readFileSync('input.md', 'utf-8'); +const html = marked.parse(markdown); +writeFileSync('output.html', html); +``` + +### Method 3: Browser Usage + +```html + + +``` + +--- + +## Step-by-Step Workflows + +Expanded portions of `SKILL.md` at `### Step-by-Step Workflows`. + +### Workflow 1: Single File Conversion + +1. Ensure marked is installed: `npm install -g marked` +2. Run conversion: `marked -i README.md -o README.html` +3. Verify output file was created + +### Workflow 2: Batch Conversion (Multiple Files) + +Create a script `convert-all.js`: + +```javascript +import { marked } from 'marked'; +import { readFileSync, writeFileSync, readdirSync } from 'fs'; +import { join, basename } from 'path'; + +const inputDir = './docs'; +const outputDir = './html'; + +readdirSync(inputDir) + .filter(file => file.endsWith('.md')) + .forEach(file => { + const markdown = readFileSync(join(inputDir, file), 'utf-8'); + const html = marked.parse(markdown); + const outputFile = basename(file, '.md') + '.html'; + writeFileSync(join(outputDir, outputFile), html); + console.log(`Converted: ${file} → ${outputFile}`); + }); +``` + +Run with: `node convert-all.js` + +### Workflow 3: Conversion with Custom Options + +```javascript +import { marked } from 'marked'; + +// Configure options +marked.setOptions({ + gfm: true, // GitHub Flavored Markdown + breaks: true, // Convert \n to
+ pedantic: false, // Don't conform to original markdown.pl +}); + +const html = marked.parse(markdownContent); +``` + +### Workflow 4: Complete HTML Document + +Wrap converted content in a full HTML template: + +```javascript +import { marked } from 'marked'; +import { readFileSync, writeFileSync } from 'fs'; + +const markdown = readFileSync('input.md', 'utf-8'); +const content = marked.parse(markdown); + +const html = ` + + + + + Document + + + +${content} + +`; + +writeFileSync('output.html', html); +``` diff --git a/skills/markdown-to-html/references/pandoc.md b/skills/markdown-to-html/references/pandoc.md new file mode 100644 index 00000000..6fbe1d0f --- /dev/null +++ b/skills/markdown-to-html/references/pandoc.md @@ -0,0 +1,226 @@ +# Pandoc Reference + +Pandoc is a universal document converter that can convert between numerous markup formats, including Markdown, HTML, LaTeX, Word, and many more. + +## Installation + +### Windows + +```powershell +# Using Chocolatey +choco install pandoc + +# Using Scoop +scoop install pandoc + +# Or download installer from https://pandoc.org/installing.html +``` + +### macOS + +```bash +# Using Homebrew +brew install pandoc +``` + +### Linux + +```bash +# Debian/Ubuntu +sudo apt-get install pandoc + +# Fedora +sudo dnf install pandoc + +# Or download from https://pandoc.org/installing.html +``` + +## Basic Usage + +### Convert Markdown to HTML + +```bash +# Basic conversion +pandoc input.md -o output.html + +# Standalone document with headers +pandoc input.md -s -o output.html + +# With custom CSS +pandoc input.md -s --css=style.css -o output.html +``` + +### Convert to Other Formats + +```bash +# To PDF (requires LaTeX) +pandoc input.md -s -o output.pdf + +# To Word +pandoc input.md -s -o output.docx + +# To LaTeX +pandoc input.md -s -o output.tex + +# To EPUB +pandoc input.md -s -o output.epub +``` + +### Convert from Other Formats + +```bash +# HTML to Markdown +pandoc -f html -t markdown input.html -o output.md + +# Word to Markdown +pandoc input.docx -o output.md + +# LaTeX to HTML +pandoc -f latex -t html input.tex -o output.html +``` + +## Common Options + +| Option | Description | +|--------|-------------| +| `-f, --from ` | Input format | +| `-t, --to ` | Output format | +| `-s, --standalone` | Produce standalone document | +| `-o, --output ` | Output file | +| `--toc` | Include table of contents | +| `--toc-depth ` | TOC depth (default: 3) | +| `-N, --number-sections` | Number section headings | +| `--css ` | Link to CSS stylesheet | +| `--template ` | Use custom template | +| `--metadata =` | Set metadata | +| `--mathml` | Use MathML for math | +| `--mathjax` | Use MathJax for math | +| `-V, --variable =` | Set template variable | + +## Markdown Extensions + +Pandoc supports many markdown extensions: + +```bash +# Enable specific extensions +pandoc -f markdown+emoji+footnotes input.md -o output.html + +# Disable specific extensions +pandoc -f markdown-pipe_tables input.md -o output.html + +# Use strict markdown +pandoc -f markdown_strict input.md -o output.html +``` + +### Common Extensions + +| Extension | Description | +|-----------|-------------| +| `pipe_tables` | Pipe tables (default on) | +| `footnotes` | Footnote support | +| `emoji` | Emoji shortcodes | +| `smart` | Smart quotes and dashes | +| `task_lists` | Task list checkboxes | +| `strikeout` | Strikethrough text | +| `superscript` | Superscript text | +| `subscript` | Subscript text | +| `raw_html` | Raw HTML passthrough | + +## Templates + +### Using Built-in Templates + +```bash +# View default template +pandoc -D html + +# Use custom template +pandoc --template=mytemplate.html input.md -o output.html +``` + +### Template Variables + +```html + + + + $title$ + $for(css)$ + + $endfor$ + + +$body$ + + +``` + +## YAML Metadata + +Include metadata in your markdown files: + +```markdown +--- +title: My Document +author: John Doe +date: 2025-01-28 +abstract: | + This is the abstract. +--- + +# Introduction + +Document content here... +``` + +## Filters + +### Using Lua Filters + +```bash +pandoc --lua-filter=filter.lua input.md -o output.html +``` + +Example Lua filter (`filter.lua`): + +```lua +function Header(el) + if el.level == 1 then + el.classes:insert("main-title") + end + return el +end +``` + +### Using Pandoc Filters + +```bash +pandoc --filter pandoc-citeproc input.md -o output.html +``` + +## Batch Conversion + +### Bash Script + +```bash +#!/bin/bash +for file in *.md; do + pandoc "$file" -s -o "${file%.md}.html" +done +``` + +### PowerShell Script + +```powershell +Get-ChildItem -Filter *.md | ForEach-Object { + $output = $_.BaseName + ".html" + pandoc $_.Name -s -o $output +} +``` + +## Resources + +- [Pandoc User's Guide](https://pandoc.org/MANUAL.html) +- [Pandoc Demos](https://pandoc.org/demos.html) +- [Pandoc FAQ](https://pandoc.org/faqs.html) +- [GitHub Repository](https://github.com/jgm/pandoc) diff --git a/skills/markdown-to-html/references/tables-to-html.md b/skills/markdown-to-html/references/tables-to-html.md new file mode 100644 index 00000000..2e3e6771 --- /dev/null +++ b/skills/markdown-to-html/references/tables-to-html.md @@ -0,0 +1,169 @@ +# Tables to HTML + +## Creating a table + +### Markdown + +```markdown + +| First Header | Second Header | +| ------------- | ------------- | +| Content Cell | Content Cell | +| Content Cell | Content Cell | +``` + +### Parsed HTML + +```html + + + + + + + + + + + + + + + + + +
First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell
+``` + +### Markdown + +```markdown +| Command | Description | +| --- | --- | +| git status | List all new or modified files | +| git diff | Show file differences that haven't been staged | +``` + +### Parsed HTML + +```html + + + + + + + + + + + + + + + + + +
CommandDescription
git statusList all new or modified files
git diffShow file differences that haven't been staged
+``` + +## Formatting Content in Tables + +### Markdown + +```markdown +| Command | Description | +| --- | --- | +| `git status` | List all *new or modified* files | +| `git diff` | Show file differences that **haven't been** staged | +``` + +### Parsed HTML + +```html + + + + + + + + + + + + + + + + + +
CommandDescription
git statusList all new or modified files
git diffShow file differences that haven't been staged
+``` + +### Markdown + +```markdown +| Left-aligned | Center-aligned | Right-aligned | +| :--- | :---: | ---: | +| git status | git status | git status | +| git diff | git diff | git diff | +``` + +### Parsed HTML + +```html + + + + + + + + + + + + + + + + + + + + +
Left-alignedCenter-alignedRight-aligned
git statusgit statusgit status
git diffgit diffgit diff
+``` + +### Markdown + +```markdown +| Name | Character | +| --- | --- | +| Backtick | ` | +| Pipe | \| | +``` + +### Parsed HTML + +```html + + + + + + + + + + + + + + + + + +
NameCharacter
Backtick`
Pipe|
+``` \ No newline at end of file diff --git a/skills/markdown-to-html/references/tables.md b/skills/markdown-to-html/references/tables.md new file mode 100644 index 00000000..b0581c69 --- /dev/null +++ b/skills/markdown-to-html/references/tables.md @@ -0,0 +1,72 @@ +# Organizing information with tables + +You can build tables to organize information in comments, issues, pull requests, and wikis. + +## Creating a table + +You can create tables with pipes `|` and hyphens `-`. Hyphens are used to create each column's header, while pipes separate each column. You must include a blank line before your table in order for it to correctly render. + +```markdown + +| First Header | Second Header | +| ------------- | ------------- | +| Content Cell | Content Cell | +| Content Cell | Content Cell | +``` + +![Screenshot of a GitHub Markdown table rendered as two equal columns. Headers are shown in boldface, and alternate content rows have gray shading.](https://docs.github.com/assets/images/help/writing/table-basic-rendered.png) + +The pipes on either end of the table are optional. + +Cells can vary in width and do not need to be perfectly aligned within columns. There must be at least three hyphens in each column of the header row. + +```markdown +| Command | Description | +| --- | --- | +| git status | List all new or modified files | +| git diff | Show file differences that haven't been staged | +``` + +![Screenshot of a GitHub Markdown table with two columns of differing width. Rows list the commands "git status" and "git diff" and their descriptions.](https://docs.github.com/assets/images/help/writing/table-varied-columns-rendered.png) + +If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). + +## Formatting content within your table + +You can use [formatting](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) such as links, inline code blocks, and text styling within your table: + +```markdown +| Command | Description | +| --- | --- | +| `git status` | List all *new or modified* files | +| `git diff` | Show file differences that **haven't been** staged | +``` + +![Screenshot of a GitHub Markdown table with the commands formatted as code blocks. Bold and italic formatting are used in the descriptions.](https://docs.github.com/assets/images/help/writing/table-inline-formatting-rendered.png) + +You can align text to the left, right, or center of a column by including colons `:` to the left, right, or on both sides of the hyphens within the header row. + +```markdown +| Left-aligned | Center-aligned | Right-aligned | +| :--- | :---: | ---: | +| git status | git status | git status | +| git diff | git diff | git diff | +``` + +![Screenshot of a Markdown table with three columns as rendered on GitHub, showing how text within cells can be set to align left, center, or right.](https://docs.github.com/assets/images/help/writing/table-aligned-text-rendered.png) + +To include a pipe `|` as content within your cell, use a `\` before the pipe: + +```markdown +| Name | Character | +| --- | --- | +| Backtick | ` | +| Pipe | \| | +``` + +![Screenshot of a Markdown table as rendered on GitHub showing how pipes, which normally close cells, are shown when prefaced by a backslash.](https://docs.github.com/assets/images/help/writing/table-escaped-character-rendered.png) + +## Further reading + +* [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) +* [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file diff --git a/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md b/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md new file mode 100644 index 00000000..4691850d --- /dev/null +++ b/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md @@ -0,0 +1,350 @@ +# Writing Mathematical Expressions to HTML + +## Writing Inline Expressions + +### Markdown + +```markdown +This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$ +``` + +### Parsed HTML + +```html +

This sentence uses $ delimiters to show math inline: + + + 3 + x + − + 1 + + + + ( + 1 + + + x + + ) + 2 + + + +

+``` + +### Markdown + +```markdown +This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+x)^2`$ +``` + +### Parsed HTML + +```html +

This sentence uses + + + ‘ + a + n + d + ‘ + + delimiters to show math inline: + + + + 3 + x + − + 1 + + + + ( + 1 + + + x + + ) + 2 + + + +

+``` + +--- + +## Writing Expressions as Blocks + +### Markdown + +```markdown +**The Cauchy-Schwarz Inequality**\ +$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$ +``` + +### Parsed HTML + +```html +

+ The Cauchy-Schwarz Inequality
+ + + + + ( + + ∑ + + k + = + 1 + + n + + + a + k + + + b + k + + ) + + 2 + + ≤ + + ( + + ∑ + + k + = + 1 + + n + + + a + k + 2 + + ) + + + ( + + ∑ + + k + = + 1 + + n + + + b + k + 2 + + ) + + + +

+``` + +### Markdown + +```markdown +**The Cauchy-Schwarz Inequality** + + ```math + \left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right) + ``` +``` + +### Parsed HTML + +```html +

The Cauchy-Schwarz Inequality

+ + + + + + ( + + ∑ + + k + = + 1 + + n + + + a + k + + + b + k + + ) + + 2 + + ≤ + + ( + + ∑ + + k + = + 1 + + n + + + a + k + 2 + + ) + + + ( + + ∑ + + k + = + 1 + + n + + + b + k + 2 + + ) + + + +``` + +### Markdown + +```markdown +The equation $a^2 + b^2 = c^2$ is the Pythagorean theorem. +``` + +### Parsed HTML + +```html +

The equation + + + a + 2 + + + + + b + 2 + + = + + c + 2 + + is the Pythagorean theorem. +

+``` + +### Markdown + +``` +$$ +\int_0^\infty e^{-x} dx = 1 +$$ +``` + +### Parsed HTML + +```html +

+ + ∫ + 0 + ∞ + + + e + + − + x + + + d + x + = + 1 +

+``` + +--- + +## Dollar Sign Inline with Mathematical Expression + +### Markdown + +```markdown +This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$ +``` + +### Parsed HTML + +```html +

This expression uses + \$ to display a dollar sign: + + + + $ + 4 + + + +

+``` + +### Markdown + +```markdown +To split $100 in half, we calculate $100/2$ +``` + +### Parsed HTML + +```html +

To split + $100 in half, we calculate + + + 100 + + / + + 2 + + +

+``` diff --git a/skills/markdown-to-html/references/writing-mathematical-expressions.md b/skills/markdown-to-html/references/writing-mathematical-expressions.md new file mode 100644 index 00000000..ae911f9c --- /dev/null +++ b/skills/markdown-to-html/references/writing-mathematical-expressions.md @@ -0,0 +1,76 @@ +# Writing mathematical expressions + +Use Markdown to display mathematical expressions on GitHub. + +## About writing mathematical expressions + +To enable clear communication of mathematical expressions, GitHub supports LaTeX formatted math within Markdown. For more information, see [LaTeX/Mathematics](http://en.wikibooks.org/wiki/LaTeX/Mathematics) in Wikibooks. + +GitHub's math rendering capability uses MathJax; an open source, JavaScript-based display engine. MathJax supports a wide range of LaTeX macros, and several useful accessibility extensions. For more information, see [the MathJax documentation](http://docs.mathjax.org/en/latest/input/tex/index.html#tex-and-latex-support) and [the MathJax Accessibility Extensions Documentation](https://mathjax.github.io/MathJax-a11y/docs/#reader-guide). + +Mathematical expressions rendering is available in GitHub Issues, GitHub Discussions, pull requests, wikis, and Markdown files. + +## Writing inline expressions + +There are two options for delimiting a math expression inline with your text. You can either surround the expression with dollar symbols (`$`), or start the expression with $\` and end it with \`$. The latter syntax is useful when the expression you are writing contains characters that overlap with markdown syntax. For more information, see [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax). + +```text +This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$ +``` + +![Screenshot of rendered Markdown showing an inline mathematical expression: the square root of 3x minus 1 plus (1 plus x) squared.](https://docs.github.com/assets/images/help/writing/inline-math-markdown-rendering.png) + +```text +This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+x)^2`$ +``` + +![Screenshot of rendered Markdown showing an inline mathematical expression with backtick syntax: the square root of 3x minus 1 plus (1 plus x) squared.](https://docs.github.com/assets/images/help/writing/inline-backtick-math-markdown-rendering.png) + +## Writing expressions as blocks + +To add a math expression as a block, start a new line and delimit the expression with two dollar symbols `$$`. + +> [!TIP] If you're writing in an .md file, you will need to use specific formatting to create a line break, such as ending the line with a backslash as shown in the example below. For more information on line breaks in Markdown, see [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#line-breaks). + +```text +**The Cauchy-Schwarz Inequality**\ +$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$ +``` + +![Screenshot of rendered Markdown showing a complex equation. Bold text reads "The Cauchy-Schwarz Inequality" above the formula for the inequality.](https://docs.github.com/assets/images/help/writing/math-expression-as-a-block-rendering.png) + +Alternatively, you can use the \`\`\`math code block syntax to display a math expression as a block. With this syntax, you don't need to use `$$` delimiters. The following will render the same as above: + +````text +**The Cauchy-Schwarz Inequality** + +```math +\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right) +``` +```` + +## Writing dollar signs in line with and within mathematical expressions + +To display a dollar sign as a character in the same line as a mathematical expression, you need to escape the non-delimiter `$` to ensure the line renders correctly. + +* Within a math expression, add a `\` symbol before the explicit `$`. + + ```text + This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$ + ``` + + ![Screenshot of rendered Markdown showing how a backslash before a dollar sign displays the sign as part of a mathematical expression.](https://docs.github.com/assets/images/help/writing/dollar-sign-within-math-expression.png) + +* Outside a math expression, but on the same line, use span tags around the explicit `$`. + + ```text + To split $100 in half, we calculate $100/2$ + ``` + + ![Screenshot of rendered Markdown showing how span tags around a dollar sign display the sign as inline text not as part of a mathematical equation.](https://docs.github.com/assets/images/help/writing/dollar-sign-inline-math-expression.png) + +## Further reading + +* [The MathJax website](http://mathjax.org) +* [Getting started with writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github) +* [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) \ No newline at end of file diff --git a/skills/refactor/SKILL.md b/skills/refactor/SKILL.md index a5b3af02..ba8313b0 100644 --- a/skills/refactor/SKILL.md +++ b/skills/refactor/SKILL.md @@ -296,7 +296,7 @@ Use this skill when: + return processOrder(order); + } -# EVEN BETER: Using Result type +# EVEN BETTER: Using Result type + function process(order): Result { + return Result.combine([ + validateOrderExists(order), diff --git a/skills/terraform-azurerm-set-diff-analyzer/SKILL.md b/skills/terraform-azurerm-set-diff-analyzer/SKILL.md new file mode 100644 index 00000000..2d366793 --- /dev/null +++ b/skills/terraform-azurerm-set-diff-analyzer/SKILL.md @@ -0,0 +1,48 @@ +--- +name: terraform-azurerm-set-diff-analyzer +description: Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attributes) and actual resource changes. Use when reviewing terraform plan output for Azure resources like Application Gateway, Load Balancer, Firewall, Front Door, NSG, and other resources with Set-type attributes that cause spurious diffs due to internal ordering changes. +license: MIT +--- + +# Terraform AzureRM Set Diff Analyzer + +A skill to identify "false-positive diffs" in Terraform plans caused by AzureRM Provider's Set-type attributes and distinguish them from actual changes. + +## When to Use + +- `terraform plan` shows many changes, but you only added/removed a single element +- Application Gateway, Load Balancer, NSG, etc. show "all elements changed" +- You want to automatically filter false-positive diffs in CI/CD + +## Background + +Terraform's Set type compares by position rather than by key, so when adding or removing elements, all elements appear as "changed". This is a general Terraform issue, but it's particularly noticeable with AzureRM resources that heavily use Set-type attributes like Application Gateway, Load Balancer, and NSG. + +These "false-positive diffs" don't actually affect the resources, but they make reviewing terraform plan output difficult. + +## Prerequisites + +- Python 3.8+ + +If Python is unavailable, install via your package manager (e.g., `apt install python3`, `brew install python3`) or from [python.org](https://www.python.org/downloads/). + +## Basic Usage + +```bash +# 1. Generate plan JSON output +terraform plan -out=plan.tfplan +terraform show -json plan.tfplan > plan.json + +# 2. Analyze +python scripts/analyze_plan.py plan.json +``` + +## Troubleshooting + +- **`python: command not found`**: Use `python3` instead, or install Python +- **`ModuleNotFoundError`**: Script uses only standard library; ensure Python 3.8+ + +## Detailed Documentation + +- [scripts/README.md](scripts/README.md) - All options, output formats, exit codes, CI/CD examples +- [references/azurerm_set_attributes.md](references/azurerm_set_attributes.md) - Supported resources and attributes diff --git a/skills/terraform-azurerm-set-diff-analyzer/references/azurerm_set_attributes.json b/skills/terraform-azurerm-set-diff-analyzer/references/azurerm_set_attributes.json new file mode 100644 index 00000000..d16b6cc4 --- /dev/null +++ b/skills/terraform-azurerm-set-diff-analyzer/references/azurerm_set_attributes.json @@ -0,0 +1,154 @@ +{ + "metadata": { + "description": "AzureRM Provider Set-type attribute definitions", + "lastUpdated": "2026-01-28", + "source": "Terraform Registry documentation and AzureRM Provider source code" + }, + "resources": { + "azurerm_application_gateway": { + "backend_address_pool": "name", + "backend_http_settings": "name", + "custom_error_configuration": "status_code", + "frontend_ip_configuration": "name", + "frontend_port": "name", + "gateway_ip_configuration": "name", + "http_listener": "name", + "probe": "name", + "private_link_configuration": "name", + "redirect_configuration": "name", + "request_routing_rule": "name", + "rewrite_rule_set": { + "_key": "name", + "rewrite_rule": { + "_key": "name", + "condition": "variable", + "request_header_configuration": "header_name", + "response_header_configuration": "header_name" + } + }, + "ssl_certificate": "name", + "ssl_profile": "name", + "trusted_client_certificate": "name", + "trusted_root_certificate": "name", + "url_path_map": { + "_key": "name", + "path_rule": { + "_key": "name", + "paths": null + } + } + }, + "azurerm_lb": { + "frontend_ip_configuration": "name" + }, + "azurerm_lb_backend_address_pool": { + "backend_address": "name" + }, + "azurerm_lb_rule": { + "backend_address_pool_ids": null + }, + "azurerm_firewall": { + "ip_configuration": "name", + "management_ip_configuration": "name", + "virtual_hub": null + }, + "azurerm_firewall_policy_rule_collection_group": { + "application_rule_collection": { + "_key": "name", + "rule": { + "_key": "name", + "protocols": null, + "destination_fqdns": null + } + }, + "network_rule_collection": { + "_key": "name", + "rule": { + "_key": "name", + "destination_addresses": null, + "destination_ports": null + } + }, + "nat_rule_collection": { + "_key": "name", + "rule": "name" + } + }, + "azurerm_frontdoor": { + "backend_pool": { + "_key": "name", + "backend": "address" + }, + "backend_pool_health_probe": "name", + "backend_pool_load_balancing": "name", + "frontend_endpoint": "name", + "routing_rule": "name" + }, + "azurerm_cdn_frontdoor_origin_group": { + "health_probe": null, + "load_balancing": null + }, + "azurerm_network_security_group": { + "security_rule": "name" + }, + "azurerm_route_table": { + "route": "name" + }, + "azurerm_virtual_network": { + "subnet": "name" + }, + "azurerm_virtual_network_gateway": { + "ip_configuration": "name", + "vpn_client_configuration": { + "_key": null, + "root_certificate": "name", + "revoked_certificate": "name", + "radius_server": "address" + }, + "policy_group": "name" + }, + "azurerm_virtual_network_gateway_connection": { + "ipsec_policy": null + }, + "azurerm_nat_gateway": { + "public_ip_address_ids": null, + "public_ip_prefix_ids": null + }, + "azurerm_private_endpoint": { + "ip_configuration": "name", + "private_dns_zone_group": "name", + "private_service_connection": "name" + }, + "azurerm_api_management": { + "additional_location": "location", + "certificate": "encoded_certificate", + "hostname_configuration": { + "_key": null, + "management": "host_name", + "portal": "host_name", + "developer_portal": "host_name", + "proxy": "host_name", + "scm": "host_name" + } + }, + "azurerm_storage_account": { + "network_rules": null, + "blob_properties": null + }, + "azurerm_key_vault": { + "network_acls": null + }, + "azurerm_cosmosdb_account": { + "geo_location": "location", + "capabilities": "name", + "virtual_network_rule": "id" + }, + "azurerm_kubernetes_cluster": { + "default_node_pool": null + }, + "azurerm_kubernetes_cluster_node_pool": { + "node_labels": null, + "node_taints": null + } + } +} diff --git a/skills/terraform-azurerm-set-diff-analyzer/references/azurerm_set_attributes.md b/skills/terraform-azurerm-set-diff-analyzer/references/azurerm_set_attributes.md new file mode 100644 index 00000000..9ee52639 --- /dev/null +++ b/skills/terraform-azurerm-set-diff-analyzer/references/azurerm_set_attributes.md @@ -0,0 +1,145 @@ +# AzureRM Set-Type Attributes Reference + +This document explains the overview and maintenance of `azurerm_set_attributes.json`. + +> **Last Updated**: January 28, 2026 + +## Overview + +`azurerm_set_attributes.json` is a definition file for attributes treated as Set-type in the AzureRM Provider. +The `analyze_plan.py` script reads this JSON to identify "false-positive diffs" in Terraform plans. + +### What are Set-Type Attributes? + +Terraform's Set type is a collection that **does not guarantee order**. +Therefore, when adding or removing elements, unchanged elements may appear as "changed". +This is called a "false-positive diff". + +## JSON File Structure + +### Basic Format + +```json +{ + "resources": { + "azurerm_resource_type": { + "attribute_name": "key_attribute" + } + } +} +``` + +- **key_attribute**: The attribute that uniquely identifies Set elements (e.g., `name`, `id`) +- **null**: When there is no key attribute (compare entire element) + +### Nested Format + +When a Set attribute contains another Set attribute: + +```json +{ + "rewrite_rule_set": { + "_key": "name", + "rewrite_rule": { + "_key": "name", + "condition": "variable", + "request_header_configuration": "header_name" + } + } +} +``` + +- **`_key`**: The key attribute for that level's Set elements +- **Other keys**: Definitions for nested Set attributes + +### Example: azurerm_application_gateway + +```json +"azurerm_application_gateway": { + "backend_address_pool": "name", // Simple Set (key is name) + "rewrite_rule_set": { // Nested Set + "_key": "name", + "rewrite_rule": { + "_key": "name", + "condition": "variable" + } + } +} +``` + +## Maintenance + +### Adding New Attributes + +1. **Check Official Documentation** + - Search for the resource in [Terraform Registry](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs) + - Verify the attribute is listed as "Set of ..." + - Some resources like `azurerm_application_gateway` have Set attributes noted explicitly + +2. **Check Source Code (more reliable)** + - Search for the resource in [AzureRM Provider GitHub](https://github.com/hashicorp/terraform-provider-azurerm) + - Confirm `Type: pluginsdk.TypeSet` in the schema definition + - Identify attributes within the Set's `Schema` that can serve as `_key` + +3. **Add to JSON** + ```json + "azurerm_new_resource": { + "set_attribute": "key_attribute" + } + ``` + +4. **Test** + ```bash + # Verify with an actual plan + python3 scripts/analyze_plan.py your_plan.json + ``` + +### Identifying Key Attributes + +| Common Key Attribute | Usage | +|---------------------|-------| +| `name` | Named blocks (most common) | +| `id` | Resource ID reference | +| `location` | Geographic location | +| `address` | Network address | +| `host_name` | Hostname | +| `null` | When no key exists (compare entire element) | + +## Related Tools + +### analyze_plan.py + +Analyzes Terraform plan JSON to identify false-positive diffs. + +```bash +# Basic usage +terraform show -json plan.tfplan | python3 scripts/analyze_plan.py + +# Read from file +python3 scripts/analyze_plan.py plan.json + +# Use custom attribute file +python3 scripts/analyze_plan.py plan.json --attributes /path/to/custom.json +``` + +## Supported Resources + +Please refer to `azurerm_set_attributes.json` directly for currently supported resources: + +```bash +# List resources +jq '.resources | keys' azurerm_set_attributes.json +``` + +Key resources: +- `azurerm_application_gateway` - Backend pools, listeners, rules, etc. +- `azurerm_firewall_policy_rule_collection_group` - Rule collections +- `azurerm_frontdoor` - Backend pools, routing +- `azurerm_network_security_group` - Security rules +- `azurerm_virtual_network_gateway` - IP configuration, VPN client configuration + +## Notes + +- Attribute behavior may differ depending on Provider/API version +- New resources and attributes need to be added as they become available +- Defining all levels of deeply nested structures improves accuracy diff --git a/skills/terraform-azurerm-set-diff-analyzer/scripts/.gitignore b/skills/terraform-azurerm-set-diff-analyzer/scripts/.gitignore new file mode 100644 index 00000000..61a44ca6 --- /dev/null +++ b/skills/terraform-azurerm-set-diff-analyzer/scripts/.gitignore @@ -0,0 +1,74 @@ +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[cod] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +*.egg-info/ +.installed.cfg +*.egg + +# PyInstaller +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.nox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +*.py,cover +.hypothesis/ +.pytest_cache/ + +# Translations +*.mo +*.pot + +# Environments +.env +.venv +env/ +venv/ +ENV/ +env.bak/ +venv.bak/ + +# mypy +.mypy_cache/ +.dmypy.json +dmypy.json + +# Pyre type checker +.pyre/ + +# pytype static type analyzer +.pytype/ + +# Cython debug symbols +cython_debug/ diff --git a/skills/terraform-azurerm-set-diff-analyzer/scripts/README.md b/skills/terraform-azurerm-set-diff-analyzer/scripts/README.md new file mode 100644 index 00000000..ff007a24 --- /dev/null +++ b/skills/terraform-azurerm-set-diff-analyzer/scripts/README.md @@ -0,0 +1,205 @@ +# Terraform AzureRM Set Diff Analyzer Script + +A Python script that analyzes Terraform plan JSON and identifies "false-positive diffs" in AzureRM Set-type attributes. + +## Overview + +AzureRM Provider's Set-type attributes (such as `backend_address_pool`, `security_rule`, etc.) don't guarantee order, so when adding or removing elements, all elements appear as "changed". This script distinguishes such "false-positive diffs" from actual changes. + +### Use Cases + +- As an **Agent Skill** (recommended) +- As a **CLI tool** for manual execution +- For automated analysis in **CI/CD pipelines** + +## Prerequisites + +- Python 3.8 or higher +- No additional packages required (uses only standard library) + +## Usage + +### Basic Usage + +```bash +# Read from file +python analyze_plan.py plan.json + +# Read from stdin +terraform show -json plan.tfplan | python analyze_plan.py +``` + +### Options + +| Option | Short | Description | Default | +|--------|-------|-------------|---------| +| `--format` | `-f` | Output format (markdown/json/summary) | markdown | +| `--exit-code` | `-e` | Return exit code based on changes | false | +| `--quiet` | `-q` | Suppress warnings | false | +| `--verbose` | `-v` | Show detailed warnings | false | +| `--ignore-case` | - | Compare values case-insensitively | false | +| `--attributes` | - | Path to custom attribute definition file | (built-in) | +| `--include` | - | Filter resources to analyze (can specify multiple) | (all) | +| `--exclude` | - | Filter resources to exclude (can specify multiple) | (none) | + +### Exit Codes (with `--exit-code`) + +| Code | Meaning | +|------|---------| +| 0 | No changes, or order-only changes | +| 1 | Actual Set attribute changes | +| 2 | Resource replacement (delete + create) | +| 3 | Error | + +## Output Formats + +### Markdown (default) + +Human-readable format for PR comments and reports. + +```bash +python analyze_plan.py plan.json --format markdown +``` + +### JSON + +Structured data for programmatic processing. + +```bash +python analyze_plan.py plan.json --format json +``` + +Example output: +```json +{ + "summary": { + "order_only_count": 3, + "actual_set_changes_count": 1, + "replace_count": 0 + }, + "has_real_changes": true, + "resources": [...], + "warnings": [] +} +``` + +### Summary + +One-line summary for CI/CD logs. + +```bash +python analyze_plan.py plan.json --format summary +``` + +Example output: +``` +🟢 3 order-only | 🟡 1 set changes +``` + +## CI/CD Pipeline Usage + +### GitHub Actions + +```yaml +name: Terraform Plan Analysis + +on: + pull_request: + paths: + - '**.tf' + +jobs: + analyze: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - name: Setup Terraform + uses: hashicorp/setup-terraform@v3 + + - name: Terraform Init & Plan + run: | + terraform init + terraform plan -out=plan.tfplan + terraform show -json plan.tfplan > plan.json + + - name: Analyze Set Diff + run: | + python path/to/analyze_plan.py plan.json --format markdown > analysis.md + + - name: Comment PR + uses: marocchino/sticky-pull-request-comment@v2 + with: + path: analysis.md +``` + +### GitHub Actions (Gate with Exit Code) + +```yaml + - name: Analyze and Gate + run: | + python path/to/analyze_plan.py plan.json --exit-code --format summary + # Fail on exit code 2 (resource replacement) + continue-on-error: false +``` + +### Azure Pipelines + +```yaml +- task: TerraformCLI@0 + inputs: + command: 'plan' + commandOptions: '-out=plan.tfplan' + +- script: | + terraform show -json plan.tfplan > plan.json + python scripts/analyze_plan.py plan.json --format markdown > $(Build.ArtifactStagingDirectory)/analysis.md + displayName: 'Analyze Plan' + +- task: PublishBuildArtifacts@1 + inputs: + pathToPublish: '$(Build.ArtifactStagingDirectory)/analysis.md' + artifactName: 'plan-analysis' +``` + +### Filtering Examples + +Analyze only specific resources: +```bash +python analyze_plan.py plan.json --include application_gateway --include load_balancer +``` + +Exclude specific resources: +```bash +python analyze_plan.py plan.json --exclude virtual_network +``` + +## Interpreting Results + +| Category | Meaning | Recommended Action | +|----------|---------|-------------------| +| 🟢 Order-only | False-positive diff, no actual change | Safe to ignore | +| 🟡 Actual change | Set element added/removed/modified | Review the content, usually in-place update | +| 🔴 Resource replacement | delete + create | Check for downtime impact | + +## Custom Attribute Definitions + +By default, uses `references/azurerm_set_attributes.json`, but you can specify a custom definition file: + +```bash +python analyze_plan.py plan.json --attributes /path/to/custom_attributes.json +``` + +See `references/azurerm_set_attributes.md` for the definition file format. + +## Limitations + +- Only AzureRM resources (`azurerm_*`) are supported +- Some resources/attributes may not be supported +- Comparisons may be incomplete for attributes containing `after_unknown` (values determined after apply) +- Comparisons may be incomplete for sensitive attributes (they are masked) + +## Related Documentation + +- [SKILL.md](../SKILL.md) - Usage as an Agent Skill +- [azurerm_set_attributes.md](../references/azurerm_set_attributes.md) - Attribute definition reference diff --git a/skills/terraform-azurerm-set-diff-analyzer/scripts/analyze_plan.py b/skills/terraform-azurerm-set-diff-analyzer/scripts/analyze_plan.py new file mode 100755 index 00000000..cd593dd7 --- /dev/null +++ b/skills/terraform-azurerm-set-diff-analyzer/scripts/analyze_plan.py @@ -0,0 +1,940 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +Terraform Plan Analyzer for AzureRM Set-type Attributes + +Analyzes terraform plan JSON output to distinguish between: +- Order-only changes (false positives) in Set-type attributes +- Actual additions/deletions/modifications + +Usage: + terraform show -json plan.tfplan | python analyze_plan.py + python analyze_plan.py plan.json + python analyze_plan.py plan.json --format json --exit-code + +For CI/CD pipeline usage, see README.md in this directory. +""" + +from __future__ import annotations + +import argparse +import json +import sys +from dataclasses import dataclass, field +from pathlib import Path +from typing import Any, Dict, List, Optional, Set + +# Exit codes for --exit-code option +EXIT_NO_CHANGES = 0 +EXIT_ORDER_ONLY = 0 # Order-only changes are not real changes +EXIT_SET_CHANGES = 1 # Actual Set attribute changes +EXIT_RESOURCE_REPLACE = 2 # Resource replacement (most severe) +EXIT_ERROR = 3 + +# Default path to the external attributes JSON file (relative to this script) +DEFAULT_ATTRIBUTES_PATH = ( + Path(__file__).parent.parent / "references" / "azurerm_set_attributes.json" +) + + +# Global configuration +class Config: + """Global configuration for the analyzer.""" + + ignore_case: bool = False + quiet: bool = False + verbose: bool = False + warnings: List[str] = [] + + +CONFIG = Config() + + +def warn(message: str) -> None: + """Add a warning message.""" + CONFIG.warnings.append(message) + if CONFIG.verbose: + print(f"Warning: {message}", file=sys.stderr) + + +def load_set_attributes(path: Optional[Path] = None) -> Dict[str, Dict[str, Any]]: + """Load Set-type attributes from external JSON file.""" + attributes_path = path or DEFAULT_ATTRIBUTES_PATH + + try: + with open(attributes_path, "r", encoding="utf-8") as f: + data = json.load(f) + return data.get("resources", {}) + except FileNotFoundError: + warn(f"Attributes file not found: {attributes_path}") + return {} + except json.JSONDecodeError as e: + print(f"Error: Invalid JSON in attributes file: {e}", file=sys.stderr) + sys.exit(EXIT_ERROR) + + +# Global variable to hold loaded attributes (initialized in main) +AZURERM_SET_ATTRIBUTES: Dict[str, Any] = {} + + +def get_attr_config(attr_def: Any) -> tuple: + """ + Parse attribute definition and return (key_attr, nested_attrs). + + Attribute definition can be: + - str: simple key attribute (e.g., "name") + - None/null: no key attribute + - dict: nested structure with "_key" and nested attributes + """ + if attr_def is None: + return (None, {}) + if isinstance(attr_def, str): + return (attr_def, {}) + if isinstance(attr_def, dict): + key_attr = attr_def.get("_key") + nested_attrs = {k: v for k, v in attr_def.items() if k != "_key"} + return (key_attr, nested_attrs) + return (None, {}) + + +@dataclass +class SetAttributeChange: + """Represents a change in a Set-type attribute.""" + + attribute_name: str + path: str = ( + "" # Full path for nested attributes (e.g., "rewrite_rule_set.rewrite_rule") + ) + order_only_count: int = 0 + added: List[str] = field(default_factory=list) + removed: List[str] = field(default_factory=list) + modified: List[tuple] = field(default_factory=list) + nested_changes: List["SetAttributeChange"] = field(default_factory=list) + # For primitive sets (string/number arrays) + is_primitive: bool = False + primitive_added: List[Any] = field(default_factory=list) + primitive_removed: List[Any] = field(default_factory=list) + + +@dataclass +class ResourceChange: + """Represents changes to a single resource.""" + + address: str + resource_type: str + actions: List[str] = field(default_factory=list) + set_changes: List[SetAttributeChange] = field(default_factory=list) + other_changes: List[str] = field(default_factory=list) + is_replace: bool = False + is_create: bool = False + is_delete: bool = False + + +@dataclass +class AnalysisResult: + """Overall analysis result.""" + + resources: List[ResourceChange] = field(default_factory=list) + order_only_count: int = 0 + actual_set_changes_count: int = 0 + replace_count: int = 0 + create_count: int = 0 + delete_count: int = 0 + other_changes_count: int = 0 + warnings: List[str] = field(default_factory=list) + + +def get_element_key(element: Dict[str, Any], key_attr: Optional[str]) -> str: + """Extract the key value from a Set element.""" + if key_attr and key_attr in element: + val = element[key_attr] + if CONFIG.ignore_case and isinstance(val, str): + return val.lower() + return str(val) + # Fall back to hash of sorted items for elements without a key attribute + return str(hash(json.dumps(element, sort_keys=True))) + + +def normalize_value(val: Any) -> Any: + """Normalize values for comparison (treat empty string and None as equivalent).""" + if val == "" or val is None: + return None + if isinstance(val, list) and len(val) == 0: + return None + # Normalize numeric types (int vs float) + if isinstance(val, float) and val.is_integer(): + return int(val) + return val + + +def normalize_for_comparison(val: Any) -> Any: + """Normalize value for comparison, including case-insensitive option.""" + val = normalize_value(val) + if CONFIG.ignore_case and isinstance(val, str): + return val.lower() + return val + + +def values_equivalent(before_val: Any, after_val: Any) -> bool: + """Check if two values are effectively equivalent.""" + return normalize_for_comparison(before_val) == normalize_for_comparison(after_val) + + +def compare_elements( + before: Dict[str, Any], after: Dict[str, Any], nested_attrs: Dict[str, Any] = None +) -> tuple: + """ + Compare two elements and return (simple_diffs, nested_set_attrs). + + simple_diffs: differences in non-Set attributes + nested_set_attrs: list of (attr_name, before_val, after_val, attr_def) for nested Sets + """ + nested_attrs = nested_attrs or {} + simple_diffs = {} + nested_set_attrs = [] + + all_keys = set(before.keys()) | set(after.keys()) + + for key in all_keys: + before_val = before.get(key) + after_val = after.get(key) + + # Check if this is a nested Set attribute + if key in nested_attrs: + if before_val != after_val: + nested_set_attrs.append((key, before_val, after_val, nested_attrs[key])) + elif not values_equivalent(before_val, after_val): + simple_diffs[key] = {"before": before_val, "after": after_val} + + return (simple_diffs, nested_set_attrs) + + +def analyze_primitive_set( + before_list: Optional[List[Any]], + after_list: Optional[List[Any]], + attr_name: str, + path: str = "", +) -> SetAttributeChange: + """Analyze changes in a primitive Set (string/number array).""" + full_path = f"{path}.{attr_name}" if path else attr_name + change = SetAttributeChange( + attribute_name=attr_name, path=full_path, is_primitive=True + ) + + before_set = set(before_list) if before_list else set() + after_set = set(after_list) if after_list else set() + + # Apply case-insensitive comparison if configured + if CONFIG.ignore_case: + before_normalized = {v.lower() if isinstance(v, str) else v for v in before_set} + after_normalized = {v.lower() if isinstance(v, str) else v for v in after_set} + else: + before_normalized = before_set + after_normalized = after_set + + removed = before_normalized - after_normalized + added = after_normalized - before_normalized + + if removed: + change.primitive_removed = list(removed) + if added: + change.primitive_added = list(added) + + # Elements that exist in both (order change only) + common = before_normalized & after_normalized + if common and not removed and not added: + change.order_only_count = len(common) + + return change + + +def analyze_set_attribute( + before_list: Optional[List[Dict[str, Any]]], + after_list: Optional[List[Dict[str, Any]]], + key_attr: Optional[str], + attr_name: str, + nested_attrs: Dict[str, Any] = None, + path: str = "", + after_unknown: Optional[Dict[str, Any]] = None, +) -> SetAttributeChange: + """Analyze changes in a Set-type attribute, including nested Sets.""" + full_path = f"{path}.{attr_name}" if path else attr_name + change = SetAttributeChange(attribute_name=attr_name, path=full_path) + nested_attrs = nested_attrs or {} + + before_list = before_list or [] + after_list = after_list or [] + + # Handle non-list values (single element) + if not isinstance(before_list, list): + before_list = [before_list] if before_list else [] + if not isinstance(after_list, list): + after_list = [after_list] if after_list else [] + + # Check if this is a primitive set (non-dict elements) + has_primitive_before = any( + not isinstance(e, dict) for e in before_list if e is not None + ) + has_primitive_after = any( + not isinstance(e, dict) for e in after_list if e is not None + ) + + if has_primitive_before or has_primitive_after: + # Handle primitive sets + return analyze_primitive_set(before_list, after_list, attr_name, path) + + # Build maps keyed by the key attribute + before_map: Dict[str, Dict[str, Any]] = {} + after_map: Dict[str, Dict[str, Any]] = {} + + # Detect duplicate keys + for e in before_list: + if isinstance(e, dict): + key = get_element_key(e, key_attr) + if key in before_map: + warn(f"Duplicate key '{key}' in before state for {full_path}") + before_map[key] = e + + for e in after_list: + if isinstance(e, dict): + key = get_element_key(e, key_attr) + if key in after_map: + warn(f"Duplicate key '{key}' in after state for {full_path}") + after_map[key] = e + + before_keys = set(before_map.keys()) + after_keys = set(after_map.keys()) + + # Find removed elements + for key in before_keys - after_keys: + display_key = key if key_attr else "(element)" + change.removed.append(display_key) + + # Find added elements + for key in after_keys - before_keys: + display_key = key if key_attr else "(element)" + change.added.append(display_key) + + # Compare common elements + for key in before_keys & after_keys: + before_elem = before_map[key] + after_elem = after_map[key] + + if before_elem == after_elem: + # Exact match - this is just an order change + change.order_only_count += 1 + else: + # Content changed - check for meaningful differences + simple_diffs, nested_set_list = compare_elements( + before_elem, after_elem, nested_attrs + ) + + # Process nested Set attributes recursively + for nested_name, nested_before, nested_after, nested_def in nested_set_list: + nested_key, sub_nested = get_attr_config(nested_def) + nested_change = analyze_set_attribute( + nested_before, + nested_after, + nested_key, + nested_name, + sub_nested, + full_path, + ) + if ( + nested_change.order_only_count > 0 + or nested_change.added + or nested_change.removed + or nested_change.modified + or nested_change.nested_changes + or nested_change.primitive_added + or nested_change.primitive_removed + ): + change.nested_changes.append(nested_change) + + if simple_diffs: + # Has actual differences in non-nested attributes + display_key = key if key_attr else "(element)" + change.modified.append((display_key, simple_diffs)) + elif not nested_set_list: + # Only null/empty differences - treat as order change + change.order_only_count += 1 + + return change + + +def analyze_resource_change( + resource_change: Dict[str, Any], + include_filter: Optional[List[str]] = None, + exclude_filter: Optional[List[str]] = None, +) -> Optional[ResourceChange]: + """Analyze a single resource change from terraform plan.""" + resource_type = resource_change.get("type", "") + address = resource_change.get("address", "") + change = resource_change.get("change", {}) + actions = change.get("actions", []) + + # Skip if no change or not an AzureRM resource + if actions == ["no-op"] or not resource_type.startswith("azurerm_"): + return None + + # Apply filters + if include_filter: + if not any(f in resource_type for f in include_filter): + return None + if exclude_filter: + if any(f in resource_type for f in exclude_filter): + return None + + before = change.get("before") or {} + after = change.get("after") or {} + after_unknown = change.get("after_unknown") or {} + before_sensitive = change.get("before_sensitive") or {} + after_sensitive = change.get("after_sensitive") or {} + + # Determine action type + is_create = actions == ["create"] + is_delete = actions == ["delete"] + is_replace = "delete" in actions and "create" in actions + + result = ResourceChange( + address=address, + resource_type=resource_type, + actions=actions, + is_replace=is_replace, + is_create=is_create, + is_delete=is_delete, + ) + + # Skip detailed Set analysis for create/delete (all elements are new/removed) + if is_create or is_delete: + return result + + # Get Set attributes for this resource type + set_attrs = AZURERM_SET_ATTRIBUTES.get(resource_type, {}) + + # Analyze Set-type attributes + analyzed_attrs: Set[str] = set() + for attr_name, attr_def in set_attrs.items(): + before_val = before.get(attr_name) + after_val = after.get(attr_name) + + # Warn about sensitive attributes + if attr_name in before_sensitive or attr_name in after_sensitive: + if before_sensitive.get(attr_name) or after_sensitive.get(attr_name): + warn( + f"Attribute '{attr_name}' in {address} contains sensitive values (comparison may be incomplete)" + ) + + # Skip if attribute is not present or unchanged + if before_val is None and after_val is None: + continue + if before_val == after_val: + continue + + # Only analyze if it's a list (Set in Terraform) or has changed + if not isinstance(before_val, list) and not isinstance(after_val, list): + continue + + # Parse attribute definition for key and nested attrs + key_attr, nested_attrs = get_attr_config(attr_def) + + # Get after_unknown for this attribute + attr_after_unknown = after_unknown.get(attr_name) + + set_change = analyze_set_attribute( + before_val, + after_val, + key_attr, + attr_name, + nested_attrs, + after_unknown=attr_after_unknown, + ) + + # Only include if there are actual findings + if ( + set_change.order_only_count > 0 + or set_change.added + or set_change.removed + or set_change.modified + or set_change.nested_changes + or set_change.primitive_added + or set_change.primitive_removed + ): + result.set_changes.append(set_change) + analyzed_attrs.add(attr_name) + + # Find other (non-Set) changes + all_keys = set(before.keys()) | set(after.keys()) + for key in all_keys: + if key in analyzed_attrs: + continue + if key.startswith("_"): # Skip internal attributes + continue + before_val = before.get(key) + after_val = after.get(key) + if before_val != after_val: + result.other_changes.append(key) + + return result + + +def collect_all_changes(set_change: SetAttributeChange, prefix: str = "") -> tuple: + """ + Recursively collect order-only and actual changes from nested structure. + Returns (order_only_list, actual_change_list) + """ + order_only = [] + actual = [] + + display_name = ( + f"{prefix}{set_change.attribute_name}" if prefix else set_change.attribute_name + ) + + has_actual_change = ( + set_change.added + or set_change.removed + or set_change.modified + or set_change.primitive_added + or set_change.primitive_removed + ) + + if set_change.order_only_count > 0 and not has_actual_change: + order_only.append((display_name, set_change)) + elif has_actual_change: + actual.append((display_name, set_change)) + + # Process nested changes + for nested in set_change.nested_changes: + nested_order, nested_actual = collect_all_changes(nested, f"{display_name}.") + order_only.extend(nested_order) + actual.extend(nested_actual) + + return (order_only, actual) + + +def format_set_change(change: SetAttributeChange, indent: int = 0) -> List[str]: + """Format a single SetAttributeChange for output.""" + lines = [] + prefix = " " * indent + + # Handle primitive sets + if change.is_primitive: + if change.primitive_added: + lines.append(f"{prefix}**Added:**") + for item in change.primitive_added: + lines.append(f"{prefix} - {item}") + if change.primitive_removed: + lines.append(f"{prefix}**Removed:**") + for item in change.primitive_removed: + lines.append(f"{prefix} - {item}") + if change.order_only_count > 0: + lines.append(f"{prefix}**Order-only:** {change.order_only_count} elements") + return lines + + if change.added: + lines.append(f"{prefix}**Added:**") + for item in change.added: + lines.append(f"{prefix} - {item}") + + if change.removed: + lines.append(f"{prefix}**Removed:**") + for item in change.removed: + lines.append(f"{prefix} - {item}") + + if change.modified: + lines.append(f"{prefix}**Modified:**") + for item_key, diffs in change.modified: + lines.append(f"{prefix} - {item_key}:") + for diff_key, diff_val in diffs.items(): + before_str = json.dumps(diff_val["before"], ensure_ascii=False) + after_str = json.dumps(diff_val["after"], ensure_ascii=False) + lines.append(f"{prefix} - {diff_key}: {before_str} → {after_str}") + + if change.order_only_count > 0: + lines.append(f"{prefix}**Order-only:** {change.order_only_count} elements") + + # Format nested changes + for nested in change.nested_changes: + if ( + nested.added + or nested.removed + or nested.modified + or nested.nested_changes + or nested.primitive_added + or nested.primitive_removed + ): + lines.append(f"{prefix}**Nested attribute `{nested.attribute_name}`:**") + lines.extend(format_set_change(nested, indent + 1)) + + return lines + + +def format_markdown_output(result: AnalysisResult) -> str: + """Format analysis results as Markdown.""" + lines = ["# Terraform Plan Analysis Results", ""] + lines.append( + 'Analyzes AzureRM Set-type attribute changes and identifies order-only "false-positive diffs".' + ) + lines.append("") + + # Categorize changes (including nested) + order_only_changes: List[tuple] = [] + actual_set_changes: List[tuple] = [] + replace_resources: List[ResourceChange] = [] + create_resources: List[ResourceChange] = [] + delete_resources: List[ResourceChange] = [] + other_changes: List[tuple] = [] + + for res in result.resources: + if res.is_replace: + replace_resources.append(res) + elif res.is_create: + create_resources.append(res) + elif res.is_delete: + delete_resources.append(res) + + for set_change in res.set_changes: + order_only, actual = collect_all_changes(set_change) + for name, change in order_only: + order_only_changes.append((res.address, name, change)) + for name, change in actual: + actual_set_changes.append((res.address, name, change)) + + if res.other_changes: + other_changes.append((res.address, res.other_changes)) + + # Section: Order-only changes (false positives) + lines.append("## 🟢 Order-only Changes (No Impact)") + lines.append("") + if order_only_changes: + lines.append( + "The following changes are internal reordering of Set-type attributes only, with no actual resource changes." + ) + lines.append("") + for address, name, change in order_only_changes: + lines.append( + f"- `{address}`: **{name}** ({change.order_only_count} elements)" + ) + else: + lines.append("None") + lines.append("") + + # Section: Actual Set changes + lines.append("## 🟡 Actual Set Attribute Changes") + lines.append("") + if actual_set_changes: + for address, name, change in actual_set_changes: + lines.append(f"### `{address}` - {name}") + lines.append("") + lines.extend(format_set_change(change)) + lines.append("") + else: + lines.append("None") + lines.append("") + + # Section: Resource replacements + lines.append("## 🔴 Resource Replacement (Caution)") + lines.append("") + if replace_resources: + lines.append( + "The following resources will be deleted and recreated. This may cause downtime." + ) + lines.append("") + for res in replace_resources: + lines.append(f"- `{res.address}`") + else: + lines.append("None") + lines.append("") + + # Section: Warnings + if result.warnings: + lines.append("## ⚠️ Warnings") + lines.append("") + for warning in result.warnings: + lines.append(f"- {warning}") + lines.append("") + + return "\n".join(lines) + + +def format_json_output(result: AnalysisResult) -> str: + """Format analysis results as JSON.""" + + def set_change_to_dict(change: SetAttributeChange) -> dict: + d = { + "attribute_name": change.attribute_name, + "path": change.path, + "order_only_count": change.order_only_count, + "is_primitive": change.is_primitive, + } + if change.added: + d["added"] = change.added + if change.removed: + d["removed"] = change.removed + if change.modified: + d["modified"] = [{"key": k, "diffs": v} for k, v in change.modified] + if change.primitive_added: + d["primitive_added"] = change.primitive_added + if change.primitive_removed: + d["primitive_removed"] = change.primitive_removed + if change.nested_changes: + d["nested_changes"] = [set_change_to_dict(n) for n in change.nested_changes] + return d + + def resource_to_dict(res: ResourceChange) -> dict: + return { + "address": res.address, + "resource_type": res.resource_type, + "actions": res.actions, + "is_replace": res.is_replace, + "is_create": res.is_create, + "is_delete": res.is_delete, + "set_changes": [set_change_to_dict(c) for c in res.set_changes], + "other_changes": res.other_changes, + } + + output = { + "summary": { + "order_only_count": result.order_only_count, + "actual_set_changes_count": result.actual_set_changes_count, + "replace_count": result.replace_count, + "create_count": result.create_count, + "delete_count": result.delete_count, + "other_changes_count": result.other_changes_count, + }, + "has_real_changes": ( + result.actual_set_changes_count > 0 + or result.replace_count > 0 + or result.create_count > 0 + or result.delete_count > 0 + or result.other_changes_count > 0 + ), + "resources": [resource_to_dict(r) for r in result.resources], + "warnings": result.warnings, + } + return json.dumps(output, indent=2, ensure_ascii=False) + + +def format_summary_output(result: AnalysisResult) -> str: + """Format analysis results as a single-line summary.""" + parts = [] + + if result.order_only_count > 0: + parts.append(f"🟢 {result.order_only_count} order-only") + if result.actual_set_changes_count > 0: + parts.append(f"🟡 {result.actual_set_changes_count} set changes") + if result.replace_count > 0: + parts.append(f"🔴 {result.replace_count} replacements") + + if not parts: + return "✅ No changes detected" + + return " | ".join(parts) + + +def analyze_plan( + plan_json: Dict[str, Any], + include_filter: Optional[List[str]] = None, + exclude_filter: Optional[List[str]] = None, +) -> AnalysisResult: + """Analyze a terraform plan JSON and return results.""" + result = AnalysisResult() + + resource_changes = plan_json.get("resource_changes", []) + + for rc in resource_changes: + res = analyze_resource_change(rc, include_filter, exclude_filter) + if res: + result.resources.append(res) + + # Count statistics + if res.is_replace: + result.replace_count += 1 + elif res.is_create: + result.create_count += 1 + elif res.is_delete: + result.delete_count += 1 + + if res.other_changes: + result.other_changes_count += len(res.other_changes) + + for set_change in res.set_changes: + order_only, actual = collect_all_changes(set_change) + result.order_only_count += len(order_only) + result.actual_set_changes_count += len(actual) + + # Add warnings from global config + result.warnings = CONFIG.warnings.copy() + + return result + + +def determine_exit_code(result: AnalysisResult) -> int: + """Determine exit code based on analysis results.""" + if result.replace_count > 0: + return EXIT_RESOURCE_REPLACE + if ( + result.actual_set_changes_count > 0 + or result.create_count > 0 + or result.delete_count > 0 + ): + return EXIT_SET_CHANGES + return EXIT_NO_CHANGES + + +def parse_args() -> argparse.Namespace: + """Parse command line arguments.""" + parser = argparse.ArgumentParser( + description="Analyze Terraform plan JSON for AzureRM Set-type attribute changes.", + formatter_class=argparse.RawDescriptionHelpFormatter, + epilog=""" +Examples: + # Basic usage + python analyze_plan.py plan.json + + # From stdin + terraform show -json plan.tfplan | python analyze_plan.py + + # CI/CD with exit code + python analyze_plan.py plan.json --exit-code + + # JSON output for programmatic processing + python analyze_plan.py plan.json --format json + + # Summary for CI logs + python analyze_plan.py plan.json --format summary + +Exit codes (with --exit-code): + 0 - No changes or order-only changes + 1 - Actual Set attribute changes + 2 - Resource replacement detected + 3 - Error +""", + ) + + parser.add_argument( + "plan_file", + nargs="?", + help="Path to terraform plan JSON file (reads from stdin if not provided)", + ) + parser.add_argument( + "--format", + "-f", + choices=["markdown", "json", "summary"], + default="markdown", + help="Output format (default: markdown)", + ) + parser.add_argument( + "--exit-code", + "-e", + action="store_true", + help="Return exit code based on change severity", + ) + parser.add_argument( + "--quiet", + "-q", + action="store_true", + help="Suppress warnings and verbose output", + ) + parser.add_argument( + "--verbose", + "-v", + action="store_true", + help="Show detailed warnings and debug info", + ) + parser.add_argument( + "--ignore-case", + action="store_true", + help="Ignore case when comparing string values", + ) + parser.add_argument( + "--attributes", type=Path, help="Path to custom attributes JSON file" + ) + parser.add_argument( + "--include", + action="append", + help="Only analyze resources matching this pattern (can be repeated)", + ) + parser.add_argument( + "--exclude", + action="append", + help="Exclude resources matching this pattern (can be repeated)", + ) + + return parser.parse_args() + + +def main(): + """Main entry point.""" + global AZURERM_SET_ATTRIBUTES + + args = parse_args() + + # Configure global settings + CONFIG.ignore_case = args.ignore_case + CONFIG.quiet = args.quiet + CONFIG.verbose = args.verbose + CONFIG.warnings = [] + + # Load Set attributes from external JSON + AZURERM_SET_ATTRIBUTES = load_set_attributes(args.attributes) + + # Read plan input + if args.plan_file: + try: + with open(args.plan_file, "r") as f: + plan_json = json.load(f) + except FileNotFoundError: + print(f"Error: File not found: {args.plan_file}", file=sys.stderr) + sys.exit(EXIT_ERROR) + except json.JSONDecodeError as e: + print(f"Error: Invalid JSON: {e}", file=sys.stderr) + sys.exit(EXIT_ERROR) + else: + try: + plan_json = json.load(sys.stdin) + except json.JSONDecodeError as e: + print(f"Error: Invalid JSON from stdin: {e}", file=sys.stderr) + sys.exit(EXIT_ERROR) + + # Check for empty plan + resource_changes = plan_json.get("resource_changes", []) + if not resource_changes: + if args.format == "json": + print( + json.dumps( + { + "summary": {}, + "has_real_changes": False, + "resources": [], + "warnings": [], + } + ) + ) + elif args.format == "summary": + print("✅ No changes detected") + else: + print("# Terraform Plan Analysis Results\n") + print("No resource changes detected.") + sys.exit(EXIT_NO_CHANGES) + + # Analyze the plan + result = analyze_plan(plan_json, args.include, args.exclude) + + # Format output + if args.format == "json": + output = format_json_output(result) + elif args.format == "summary": + output = format_summary_output(result) + else: + output = format_markdown_output(result) + + print(output) + + # Determine exit code + if args.exit_code: + sys.exit(determine_exit_code(result)) + + +if __name__ == "__main__": + main() diff --git a/skills/winapp-cli/SKILL.md b/skills/winapp-cli/SKILL.md new file mode 100644 index 00000000..1cc1813f --- /dev/null +++ b/skills/winapp-cli/SKILL.md @@ -0,0 +1,196 @@ +--- +name: winapp-cli +description: 'Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, or access Windows SDK build tools. Supports .NET, C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows.' +--- + +# Windows App Development CLI + +The Windows App Development CLI (`winapp`) is a command-line interface for managing Windows SDKs, MSIX packaging, generating app identity, manifests, certificates, and using build tools with any app framework. It bridges the gap between cross-platform development and Windows-native capabilities. + +## When to Use This Skill + +Use this skill when you need to: + +- Initialize a Windows app project with SDK setup, manifests, and certificates +- Create MSIX packages from application directories +- Generate or manage AppxManifest.xml files +- Create and install development certificates for signing +- Add package identity for debugging Windows APIs +- Sign MSIX packages or executables +- Access Windows SDK build tools from any framework +- Build Windows apps using cross-platform frameworks (Electron, Rust, Tauri, Qt) +- Set up CI/CD pipelines for Windows app deployment +- Access Windows APIs that require package identity (notifications, Windows AI, shell integration) + +## Prerequisites + +- Windows 10 or later +- winapp CLI installed via one of these methods: + - **WinGet**: `winget install Microsoft.WinAppCli --source winget` + - **NPM** (for Electron): `npm install @microsoft/winappcli --save-dev` + - **GitHub Actions/Azure DevOps**: Use [setup-WinAppCli](https://github.com/microsoft/setup-WinAppCli) action + - **Manual**: Download from [GitHub Releases](https://github.com/microsoft/WinAppCli/releases/latest) + +## Core Capabilities + +### 1. Project Initialization (`winapp init`) + +Initialize a directory with required assets (manifest, certificates, libraries) for building a modern Windows app. Supports SDK installation modes: `stable`, `preview`, `experimental`, or `none`. + +### 2. MSIX Packaging (`winapp pack`) + +Create MSIX packages from prepared directories with optional signing, certificate generation, and self-contained deployment bundling. + +### 3. Package Identity for Debugging (`winapp create-debug-identity`) + +Add temporary package identity to executables for debugging Windows APIs that require identity (notifications, Windows AI, shell integration) without full packaging. + +### 4. Manifest Management (`winapp manifest`) + +Generate AppxManifest.xml files and update image assets from source images, automatically creating all required sizes and aspect ratios. + +### 5. Certificate Management (`winapp cert`) + +Generate development certificates and install them to the local machine store for signing packages. + +### 6. Package Signing (`winapp sign`) + +Sign MSIX packages and executables with PFX certificates, with optional timestamp server support. + +### 7. SDK Build Tools Access (`winapp tool`) + +Run Windows SDK build tools with properly configured paths from any framework or build system. + +## Usage Examples + +### Example 1: Initialize and Package a Windows App + +```bash +# Initialize workspace with defaults +winapp init + +# Build your application (framework-specific) +# ... + +# Create signed MSIX package +winapp pack ./build-output --generate-cert --output MyApp.msix +``` + +### Example 2: Debug with Package Identity + +```bash +# Add debug identity to executable for testing Windows APIs +winapp create-debug-identity ./bin/MyApp.exe + +# Run your app - it now has package identity +./bin/MyApp.exe +``` + +### Example 3: CI/CD Pipeline Setup + +```yaml +# GitHub Actions example +- name: Setup winapp CLI + uses: microsoft/setup-WinAppCli@v1 + +- name: Initialize and Package + run: | + winapp init --no-prompt + winapp pack ./build-output --output MyApp.msix +``` + +### Example 4: Electron App Integration + +```bash +# Install via npm +npm install @microsoft/winappcli --save-dev + +# Initialize and add debug identity for Electron +npx winapp init +npx winapp node add-electron-debug-identity + +# Package for distribution +npx winapp pack ./out --output MyElectronApp.msix +``` + +## Guidelines + +1. **Run `winapp init` first** - Always initialize your project before using other commands to ensure SDK setup, manifest, and certificates are configured. +2. **Re-run `create-debug-identity` after manifest changes** - Package identity must be recreated whenever AppxManifest.xml is modified. +3. **Use `--no-prompt` for CI/CD** - Prevents interactive prompts in automated pipelines by using default values. +4. **Use `winapp restore` for shared projects** - Recreates the exact environment state defined in `winapp.yaml` across machines. +5. **Generate assets from a single image** - Use `winapp manifest update-assets` with one logo to generate all required icon sizes. + +## Common Patterns + +### Pattern: Initialize New Project + +```bash +cd my-project +winapp init +# Creates: AppxManifest.xml, development certificate, SDK configuration, winapp.yaml +``` + +### Pattern: Package with Existing Certificate + +```bash +winapp pack ./build-output --cert ./mycert.pfx --cert-password secret --output MyApp.msix +``` + +### Pattern: Self-Contained Deployment + +```bash +# Bundle Windows App SDK runtime with the package +winapp pack ./my-app --self-contained --generate-cert +``` + +### Pattern: Update Package Versions + +```bash +# Update to latest stable SDKs +winapp update + +# Or update to preview SDKs +winapp update --setup-sdks preview +``` + +## Limitations + +- Windows 10 or later required (Windows-only CLI) +- Package identity debugging requires re-running `create-debug-identity` after any manifest changes +- Self-contained deployment increases package size by bundling the Windows App SDK runtime +- Development certificates are for testing only; production requires trusted certificates +- Some Windows APIs require specific capability declarations in the manifest +- winapp CLI is in public preview and subject to change + +## Windows APIs Enabled by Package Identity + +Package identity unlocks access to powerful Windows APIs: + +| API Category | Examples | +| ------------ | -------- | +| **Notifications** | Interactive native notifications, notification management | +| **Windows AI** | On-device LLM, text/image AI APIs (Phi Silica, Windows ML) | +| **Shell Integration** | Explorer, Taskbar, Share sheet integration | +| **Protocol Handlers** | Custom URI schemes (`yourapp://`) | +| **Device Access** | Camera, microphone, location (with consent) | +| **Background Tasks** | Run when app is closed | +| **File Associations** | Open file types with your app | + +## Troubleshooting + +| Issue | Solution | +| ----- | -------- | +| Certificate not trusted | Run `winapp cert install ` to install to local machine store | +| Package identity not working | Run `winapp create-debug-identity` after any manifest changes | +| SDK not found | Run `winapp restore` or `winapp update` to ensure SDKs are installed | +| Signing fails | Verify certificate password and ensure cert is not expired | + +## References + +- [GitHub Repository](https://github.com/microsoft/WinAppCli) +- [Full CLI Documentation](https://github.com/microsoft/WinAppCli/blob/main/docs/usage.md) +- [Sample Applications](https://github.com/microsoft/WinAppCli/tree/main/samples) +- [Windows App SDK](https://learn.microsoft.com/windows/apps/windows-app-sdk/) +- [MSIX Packaging Overview](https://learn.microsoft.com/windows/msix/overview) +- [Package Identity Overview](https://learn.microsoft.com/windows/apps/desktop/modernize/package-identity-overview) diff --git a/website/astro.config.mjs b/website/astro.config.mjs new file mode 100644 index 00000000..87c9e4e6 --- /dev/null +++ b/website/astro.config.mjs @@ -0,0 +1,22 @@ +import sitemap from "@astrojs/sitemap"; +import { defineConfig } from "astro/config"; + +// https://astro.build/config +export default defineConfig({ + site: "https://github.github.io/awesome-copilot", + base: "/awesome-copilot/", + output: "static", + integrations: [sitemap()], + build: { + assets: "assets", + }, + trailingSlash: "always", + vite: { + build: { + sourcemap: true, + }, + css: { + devSourcemap: true, + }, + }, +}); diff --git a/website/data/tools.yml b/website/data/tools.yml new file mode 100644 index 00000000..f7c8148f --- /dev/null +++ b/website/data/tools.yml @@ -0,0 +1,205 @@ +# yaml-language-server: $schema=../../.schemas/tools.schema.json +# Tools data for the Awesome GitHub Copilot website +# Each tool entry provides information for the tools page + +tools: + - id: mcp-server + name: Awesome Copilot MCP Server + description: >- + A Model Context Protocol (MCP) Server that provides prompts for searching and installing + prompts, instructions, agents, and skills directly from this repository. Makes it easy + to discover and add customizations to your editor. + category: MCP Servers + featured: true + requirements: + - Docker installed and running + links: + blog: https://developer.microsoft.com/blog/announcing-awesome-copilot-mcp-server + vscode: https://aka.ms/awesome-copilot/mcp/vscode + vscode-insiders: https://aka.ms/awesome-copilot/mcp/vscode-insiders + visual-studio: https://aka.ms/awesome-copilot/mcp/vs + configuration: + type: json + content: | + { + "servers": { + "awesome-copilot": { + "type": "stdio", + "command": "docker", + "args": [ + "run", + "-i", + "--rm", + "ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:latest" + ] + } + } + } + tags: + - mcp + - docker + - search + - install + + - id: vscode-extension + name: Awesome GitHub Copilot Browser + description: >- + A VS Code extension that allows you to browse, preview, and download GitHub Copilot + customizations from the awesome-copilot repository. Features a tree view for exploring + agents, prompts, instructions, and skills with smart caching for better performance. + category: VS Code Extensions + featured: true + requirements: + - VS Code version 1.103.0 or higher + - Internet connection to fetch repository data + - A workspace folder open in VS Code (for downloads) + links: + github: https://github.com/timheuer/vscode-awesome-copilot + vscode: vscode:extension/TimHeuer.awesome-copilot + vscode-insiders: vscode-insiders:extension/TimHeuer.awesome-copilot + marketplace: https://marketplace.visualstudio.com/items?itemName=TimHeuer.awesome-copilot + features: + - "🔍 Browse: Explore chat modes, instructions, prompts, agents, and skills in a tree view" + - "📖 Preview: View file content before downloading" + - "⬇️ Download: Save files to appropriate .github/ folders in your workspace" + - "🔃 Refresh: Update repository data with manual refresh" + - "💾 Caching: Smart caching for better performance" + tags: + - vscode + - extension + - browse + - preview + - download + + - id: workspace-architect + name: Workspace Architect + description: >- + A comprehensive library of specialized AI personas and chat modes for GitHub Copilot. + Includes architectural planning, tech stack guidance, and advanced cognitive reasoning + models. Install via npm and use the CLI to download personas and prompts. + category: CLI Tools + featured: false + requirements: + - Node.js 20 or higher + - npm + links: + github: https://github.com/archubbuck/workspace-architect + npm: https://www.npmjs.com/package/workspace-architect + features: + - "📦 CLI tool: List and download personas, prompts, and chat modes" + - "🎭 Rich persona library: Architecture, React, Azure, and more" + - "🧠 Cognitive modes: Advanced reasoning and planning personas" + - "⚡ Easy install: npm install -g workspace-architect" + configuration: + type: bash + content: | + # Install globally + npm install -g workspace-architect + + # List available items + workspace-architect list + + # Download a specific item + workspace-architect download instructions:basic-setup + tags: + - cli + - npm + - personas + - chat-modes + - prompts + + - id: apm + name: APM - Agent Package Manager + description: >- + npm for AI coding agents. The package manager for AGENTS.md, Agent Skills, and MCP servers. + One package installs to every AI agent (Copilot, Cursor, Claude, Codex, Gemini) in their + native format. + category: CLI Tools + featured: true + requirements: + - Python 3.8 or higher (for pip install) + - Or use the shell installer + links: + github: https://github.com/danielmeppiel/apm + pypi: https://pypi.org/project/apm-cli/ + features: + - "📦 Universal packages: One install works for Copilot, Cursor, Claude, and more" + - "🔧 Skills & Instructions: Install guardrails and capabilities" + - "🔌 MCP Server management: Configure and manage MCP servers" + - "🏗️ Create packages: Share your standards and workflows" + - "🌐 Multi-source: GitHub, GitHub Enterprise, Azure DevOps" + configuration: + type: bash + content: | + # Install via shell script + curl -sSL https://raw.githubusercontent.com/danielmeppiel/apm/main/install.sh | sh + + # Or install via pip + pip install apm-cli + + # Install a skill + apm install danielmeppiel/form-builder + + # Compile for your AI tools + apm compile + tags: + - cli + - python + - package-manager + - skills + - agents + - mcp + + - id: prompt-registry + name: Prompt Registry + description: >- + A visual marketplace for discovering, installing, and managing GitHub Copilot prompt + libraries from multiple sources. Browse bundles in a tile-based interface with search, + filters, and one-click install. Supports GitHub, local directories, and APM repositories. + category: VS Code Extensions + featured: false + requirements: + - VS Code + links: + github: https://github.com/AmadeusITGroup/prompt-registry + vscode: vscode:extension/AmadeusITGroup.prompt-registry + vscode-insiders: vscode-insiders:extension/AmadeusITGroup.prompt-registry + marketplace: https://marketplace.visualstudio.com/items?itemName=AmadeusITGroup.prompt-registry + features: + - "🎨 Visual Marketplace: Browse bundles with search, filters, and one-click install" + - "🔌 Multi-Source: Connect to GitHub, local directories, APM, or Awesome Copilot" + - "📦 Version Management: Track versions and enable automatic updates" + - "👥 Profiles & Hubs: Organize bundles by project/team" + - "🌍 Cross-Platform: Works on macOS, Linux, and Windows" + tags: + - vscode + - extension + - marketplace + - prompts + - bundles + + - id: github-node-vs + name: GitHub Node for Visual Studio + description: >- + Adds GitHub and MCP Servers nodes to Solution Explorer in Visual Studio. Quickly access + and manage GitHub-specific files like workflows, Copilot instructions, and agents, plus + MCP server configurations - all without leaving Visual Studio. + category: Visual Studio Extensions + featured: false + requirements: + - Visual Studio 2022 or higher + links: + github: https://github.com/madskristensen/GitHubNode + marketplace: https://marketplace.visualstudio.com/items?itemName=MadsKristensen.GitHubNode + features: + - "📁 GitHub Node: Easy access to .github folder contents in Solution Explorer" + - "➕ Quick Create: Add Copilot instructions, agents, prompts, skills, and workflows" + - "🔌 MCP Servers Node: Centralized access to MCP configurations" + - "🔄 Git Status Icons: See file status directly in the tree view" + - "🌐 Open on GitHub: Quick link to view files on GitHub.com" + tags: + - visual-studio + - extension + - solution-explorer + - github + - mcp diff --git a/website/package-lock.json b/website/package-lock.json new file mode 100644 index 00000000..4aac1dd9 --- /dev/null +++ b/website/package-lock.json @@ -0,0 +1,5191 @@ +{ + "name": "awesome-copilot-website", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "awesome-copilot-website", + "version": "1.0.0", + "license": "MIT", + "dependencies": { + "@astrojs/sitemap": "^3.7.0", + "astro": "^5.16.15", + "choices.js": "^11.1.0", + "jszip": "^3.10.1" + } + }, + "node_modules/@astrojs/compiler": { + "version": "2.13.0", + "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-2.13.0.tgz", + "integrity": "sha512-mqVORhUJViA28fwHYaWmsXSzLO9osbdZ5ImUfxBarqsYdMlPbqAqGJCxsNzvppp1BEzc1mJNjOVvQqeDN8Vspw==", + "license": "MIT" + }, + "node_modules/@astrojs/internal-helpers": { + "version": "0.7.5", + "resolved": "https://registry.npmjs.org/@astrojs/internal-helpers/-/internal-helpers-0.7.5.tgz", + "integrity": "sha512-vreGnYSSKhAjFJCWAwe/CNhONvoc5lokxtRoZims+0wa3KbHBdPHSSthJsKxPd8d/aic6lWKpRTYGY/hsgK6EA==", + "license": "MIT" + }, + "node_modules/@astrojs/markdown-remark": { + "version": "6.3.10", + "resolved": "https://registry.npmjs.org/@astrojs/markdown-remark/-/markdown-remark-6.3.10.tgz", + "integrity": "sha512-kk4HeYR6AcnzC4QV8iSlOfh+N8TZ3MEStxPyenyCtemqn8IpEATBFMTJcfrNW32dgpt6MY3oCkMM/Tv3/I4G3A==", + "license": "MIT", + "dependencies": { + "@astrojs/internal-helpers": "0.7.5", + "@astrojs/prism": "3.3.0", + "github-slugger": "^2.0.0", + "hast-util-from-html": "^2.0.3", + "hast-util-to-text": "^4.0.2", + "import-meta-resolve": "^4.2.0", + "js-yaml": "^4.1.1", + "mdast-util-definitions": "^6.0.0", + "rehype-raw": "^7.0.0", + "rehype-stringify": "^10.0.1", + "remark-gfm": "^4.0.1", + "remark-parse": "^11.0.0", + "remark-rehype": "^11.1.2", + "remark-smartypants": "^3.0.2", + "shiki": "^3.19.0", + "smol-toml": "^1.5.2", + "unified": "^11.0.5", + "unist-util-remove-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "unist-util-visit-parents": "^6.0.2", + "vfile": "^6.0.3" + } + }, + "node_modules/@astrojs/prism": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/@astrojs/prism/-/prism-3.3.0.tgz", + "integrity": "sha512-q8VwfU/fDZNoDOf+r7jUnMC2//H2l0TuQ6FkGJL8vD8nw/q5KiL3DS1KKBI3QhI9UQhpJ5dc7AtqfbXWuOgLCQ==", + "license": "MIT", + "dependencies": { + "prismjs": "^1.30.0" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0" + } + }, + "node_modules/@astrojs/sitemap": { + "version": "3.7.0", + "resolved": "https://registry.npmjs.org/@astrojs/sitemap/-/sitemap-3.7.0.tgz", + "integrity": "sha512-+qxjUrz6Jcgh+D5VE1gKUJTA3pSthuPHe6Ao5JCxok794Lewx8hBFaWHtOnN0ntb2lfOf7gvOi9TefUswQ/ZVA==", + "license": "MIT", + "dependencies": { + "sitemap": "^8.0.2", + "stream-replace-string": "^2.0.0", + "zod": "^3.25.76" + } + }, + "node_modules/@astrojs/telemetry": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/@astrojs/telemetry/-/telemetry-3.3.0.tgz", + "integrity": "sha512-UFBgfeldP06qu6khs/yY+q1cDAaArM2/7AEIqQ9Cuvf7B1hNLq0xDrZkct+QoIGyjq56y8IaE2I3CTvG99mlhQ==", + "license": "MIT", + "dependencies": { + "ci-info": "^4.2.0", + "debug": "^4.4.0", + "dlv": "^1.1.3", + "dset": "^3.1.4", + "is-docker": "^3.0.0", + "is-wsl": "^3.1.0", + "which-pm-runs": "^1.1.0" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.6.tgz", + "integrity": "sha512-TeR9zWR18BvbfPmGbLampPMW+uW1NZnJlRuuHso8i87QZNq2JRF9i6RgxRqtEq+wQGsS19NNTWr2duhnE49mfQ==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.6" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.6.tgz", + "integrity": "sha512-0ZrskXVEHSWIqZM/sQZ4EV3jZJXRkio/WCxaqKZP1g//CEWEPSfeZFcms4XeKBCHU0ZKnIkdJeU/kF+eRp5lBg==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@capsizecss/unpack": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@capsizecss/unpack/-/unpack-4.0.0.tgz", + "integrity": "sha512-VERIM64vtTP1C4mxQ5thVT9fK0apjPFobqybMtA1UdUujWka24ERHbRHFGmpbbhp73MhV+KSsHQH9C6uOTdEQA==", + "license": "MIT", + "dependencies": { + "fontkitten": "^1.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@emnapi/runtime": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.8.1.tgz", + "integrity": "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz", + "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz", + "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz", + "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz", + "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz", + "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz", + "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz", + "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz", + "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz", + "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz", + "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz", + "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz", + "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz", + "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==", + "cpu": [ + "mips64el" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz", + "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz", + "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz", + "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz", + "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz", + "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz", + "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz", + "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz", + "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz", + "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz", + "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz", + "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz", + "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz", + "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@img/colour": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.0.0.tgz", + "integrity": "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=18" + } + }, + "node_modules/@img/sharp-darwin-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.5.tgz", + "integrity": "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-darwin-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.5.tgz", + "integrity": "sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.4.tgz", + "integrity": "sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-darwin-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.4.tgz", + "integrity": "sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.4.tgz", + "integrity": "sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==", + "cpu": [ + "arm" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.4.tgz", + "integrity": "sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-ppc64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.4.tgz", + "integrity": "sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==", + "cpu": [ + "ppc64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-riscv64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.2.4.tgz", + "integrity": "sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==", + "cpu": [ + "riscv64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-s390x": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.4.tgz", + "integrity": "sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==", + "cpu": [ + "s390x" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.4.tgz", + "integrity": "sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.4.tgz", + "integrity": "sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.4.tgz", + "integrity": "sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-linux-arm": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.5.tgz", + "integrity": "sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==", + "cpu": [ + "arm" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.5.tgz", + "integrity": "sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-ppc64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.5.tgz", + "integrity": "sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==", + "cpu": [ + "ppc64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-ppc64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-riscv64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.34.5.tgz", + "integrity": "sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==", + "cpu": [ + "riscv64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-riscv64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-s390x": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.5.tgz", + "integrity": "sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==", + "cpu": [ + "s390x" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.5.tgz", + "integrity": "sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.5.tgz", + "integrity": "sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.5.tgz", + "integrity": "sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-wasm32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.5.tgz", + "integrity": "sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==", + "cpu": [ + "wasm32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.7.0" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.5.tgz", + "integrity": "sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-ia32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.5.tgz", + "integrity": "sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==", + "cpu": [ + "ia32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.5.tgz", + "integrity": "sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "license": "MIT" + }, + "node_modules/@oslojs/encoding": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@oslojs/encoding/-/encoding-1.1.0.tgz", + "integrity": "sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==", + "license": "MIT" + }, + "node_modules/@rollup/pluginutils": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.3.0.tgz", + "integrity": "sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-walker": "^2.0.2", + "picomatch": "^4.0.2" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/@rollup/pluginutils/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.57.0.tgz", + "integrity": "sha512-tPgXB6cDTndIe1ah7u6amCI1T0SsnlOuKgg10Xh3uizJk4e5M1JGaUMk7J4ciuAUcFpbOiNhm2XIjP9ON0dUqA==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.57.0.tgz", + "integrity": "sha512-sa4LyseLLXr1onr97StkU1Nb7fWcg6niokTwEVNOO7awaKaoRObQ54+V/hrF/BP1noMEaaAW6Fg2d/CfLiq3Mg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.57.0.tgz", + "integrity": "sha512-/NNIj9A7yLjKdmkx5dC2XQ9DmjIECpGpwHoGmA5E1AhU0fuICSqSWScPhN1yLCkEdkCwJIDu2xIeLPs60MNIVg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.57.0.tgz", + "integrity": "sha512-xoh8abqgPrPYPr7pTYipqnUi1V3em56JzE/HgDgitTqZBZ3yKCWI+7KUkceM6tNweyUKYru1UMi7FC060RyKwA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.57.0.tgz", + "integrity": "sha512-PCkMh7fNahWSbA0OTUQ2OpYHpjZZr0hPr8lId8twD7a7SeWrvT3xJVyza+dQwXSSq4yEQTMoXgNOfMCsn8584g==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.57.0.tgz", + "integrity": "sha512-1j3stGx+qbhXql4OCDZhnK7b01s6rBKNybfsX+TNrEe9JNq4DLi1yGiR1xW+nL+FNVvI4D02PUnl6gJ/2y6WJA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.57.0.tgz", + "integrity": "sha512-eyrr5W08Ms9uM0mLcKfM/Uzx7hjhz2bcjv8P2uynfj0yU8GGPdz8iYrBPhiLOZqahoAMB8ZiolRZPbbU2MAi6Q==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.57.0.tgz", + "integrity": "sha512-Xds90ITXJCNyX9pDhqf85MKWUI4lqjiPAipJ8OLp8xqI2Ehk+TCVhF9rvOoN8xTbcafow3QOThkNnrM33uCFQA==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.57.0.tgz", + "integrity": "sha512-Xws2KA4CLvZmXjy46SQaXSejuKPhwVdaNinldoYfqruZBaJHqVo6hnRa8SDo9z7PBW5x84SH64+izmldCgbezw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.57.0.tgz", + "integrity": "sha512-hrKXKbX5FdaRJj7lTMusmvKbhMJSGWJ+w++4KmjiDhpTgNlhYobMvKfDoIWecy4O60K6yA4SnztGuNTQF+Lplw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.57.0.tgz", + "integrity": "sha512-6A+nccfSDGKsPm00d3xKcrsBcbqzCTAukjwWK6rbuAnB2bHaL3r9720HBVZ/no7+FhZLz/U3GwwZZEh6tOSI8Q==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.57.0.tgz", + "integrity": "sha512-4P1VyYUe6XAJtQH1Hh99THxr0GKMMwIXsRNOceLrJnaHTDgk1FTcTimDgneRJPvB3LqDQxUmroBclQ1S0cIJwQ==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.57.0.tgz", + "integrity": "sha512-8Vv6pLuIZCMcgXre6c3nOPhE0gjz1+nZP6T+hwWjr7sVH8k0jRkH+XnfjjOTglyMBdSKBPPz54/y1gToSKwrSQ==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.57.0.tgz", + "integrity": "sha512-r1te1M0Sm2TBVD/RxBPC6RZVwNqUTwJTA7w+C/IW5v9Ssu6xmxWEi+iJQlpBhtUiT1raJ5b48pI8tBvEjEFnFA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.57.0.tgz", + "integrity": "sha512-say0uMU/RaPm3CDQLxUUTF2oNWL8ysvHkAjcCzV2znxBr23kFfaxocS9qJm+NdkRhF8wtdEEAJuYcLPhSPbjuQ==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.57.0.tgz", + "integrity": "sha512-/MU7/HizQGsnBREtRpcSbSV1zfkoxSTR7wLsRmBPQ8FwUj5sykrP1MyJTvsxP5KBq9SyE6kH8UQQQwa0ASeoQQ==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.57.0.tgz", + "integrity": "sha512-Q9eh+gUGILIHEaJf66aF6a414jQbDnn29zeu0eX3dHMuysnhTvsUvZTCAyZ6tJhUjnvzBKE4FtuaYxutxRZpOg==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.57.0.tgz", + "integrity": "sha512-OR5p5yG5OKSxHReWmwvM0P+VTPMwoBS45PXTMYaskKQqybkS3Kmugq1W+YbNWArF8/s7jQScgzXUhArzEQ7x0A==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.57.0.tgz", + "integrity": "sha512-XeatKzo4lHDsVEbm1XDHZlhYZZSQYym6dg2X/Ko0kSFgio+KXLsxwJQprnR48GvdIKDOpqWqssC3iBCjoMcMpw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.57.0.tgz", + "integrity": "sha512-Lu71y78F5qOfYmubYLHPcJm74GZLU6UJ4THkf/a1K7Tz2ycwC2VUbsqbJAXaR6Bx70SRdlVrt2+n5l7F0agTUw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.57.0.tgz", + "integrity": "sha512-v5xwKDWcu7qhAEcsUubiav7r+48Uk/ENWdr82MBZZRIm7zThSxCIVDfb3ZeRRq9yqk+oIzMdDo6fCcA5DHfMyA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.57.0.tgz", + "integrity": "sha512-XnaaaSMGSI6Wk8F4KK3QP7GfuuhjGchElsVerCplUuxRIzdvZ7hRBpLR0omCmw+kI2RFJB80nenhOoGXlJ5TfQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.57.0.tgz", + "integrity": "sha512-3K1lP+3BXY4t4VihLw5MEg6IZD3ojSYzqzBG571W3kNQe4G4CcFpSUQVgurYgib5d+YaCjeFow8QivWp8vuSvA==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.57.0.tgz", + "integrity": "sha512-MDk610P/vJGc5L5ImE4k5s+GZT3en0KoK1MKPXCRgzmksAMk79j4h3k1IerxTNqwDLxsGxStEZVBqG0gIqZqoA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.57.0.tgz", + "integrity": "sha512-Zv7v6q6aV+VslnpwzqKAmrk5JdVkLUzok2208ZXGipjb+msxBr/fJPZyeEXiFgH7k62Ak0SLIfxQRZQvTuf7rQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@shikijs/core": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-3.21.0.tgz", + "integrity": "sha512-AXSQu/2n1UIQekY8euBJlvFYZIw0PHY63jUzGbrOma4wPxzznJXTXkri+QcHeBNaFxiiOljKxxJkVSoB3PjbyA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.21.0", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4", + "hast-util-to-html": "^9.0.5" + } + }, + "node_modules/@shikijs/engine-javascript": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-3.21.0.tgz", + "integrity": "sha512-ATwv86xlbmfD9n9gKRiwuPpWgPENAWCLwYCGz9ugTJlsO2kOzhOkvoyV/UD+tJ0uT7YRyD530x6ugNSffmvIiQ==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.21.0", + "@shikijs/vscode-textmate": "^10.0.2", + "oniguruma-to-es": "^4.3.4" + } + }, + "node_modules/@shikijs/engine-oniguruma": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-3.21.0.tgz", + "integrity": "sha512-OYknTCct6qiwpQDqDdf3iedRdzj6hFlOPv5hMvI+hkWfCKs5mlJ4TXziBG9nyabLwGulrUjHiCq3xCspSzErYQ==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.21.0", + "@shikijs/vscode-textmate": "^10.0.2" + } + }, + "node_modules/@shikijs/langs": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-3.21.0.tgz", + "integrity": "sha512-g6mn5m+Y6GBJ4wxmBYqalK9Sp0CFkUqfNzUy2pJglUginz6ZpWbaWjDB4fbQ/8SHzFjYbtU6Ddlp1pc+PPNDVA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.21.0" + } + }, + "node_modules/@shikijs/themes": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-3.21.0.tgz", + "integrity": "sha512-BAE4cr9EDiZyYzwIHEk7JTBJ9CzlPuM4PchfcA5ao1dWXb25nv6hYsoDiBq2aZK9E3dlt3WB78uI96UESD+8Mw==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.21.0" + } + }, + "node_modules/@shikijs/types": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-3.21.0.tgz", + "integrity": "sha512-zGrWOxZ0/+0ovPY7PvBU2gIS9tmhSUUt30jAcNV0Bq0gb2S98gwfjIs1vxlmH5zM7/4YxLamT6ChlqqAJmPPjA==", + "license": "MIT", + "dependencies": { + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4" + } + }, + "node_modules/@shikijs/vscode-textmate": { + "version": "10.0.2", + "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.0.2.tgz", + "integrity": "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==", + "license": "MIT" + }, + "node_modules/@types/debug": { + "version": "4.1.12", + "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz", + "integrity": "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==", + "license": "MIT", + "dependencies": { + "@types/ms": "*" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "license": "MIT" + }, + "node_modules/@types/hast": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.4.tgz", + "integrity": "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/mdast": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", + "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/ms": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz", + "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==", + "license": "MIT" + }, + "node_modules/@types/nlcst": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@types/nlcst/-/nlcst-2.0.3.tgz", + "integrity": "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/node": { + "version": "25.0.10", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.10.tgz", + "integrity": "sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg==", + "license": "MIT", + "dependencies": { + "undici-types": "~7.16.0" + } + }, + "node_modules/@types/sax": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/@types/sax/-/sax-1.2.7.tgz", + "integrity": "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/unist": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz", + "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==", + "license": "MIT" + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz", + "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==", + "license": "ISC" + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/ansi-align": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz", + "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==", + "license": "ISC", + "dependencies": { + "string-width": "^4.1.0" + } + }, + "node_modules/ansi-align/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "license": "MIT" + }, + "node_modules/ansi-align/node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/anymatch/node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/arg": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz", + "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==", + "license": "MIT" + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "license": "Python-2.0" + }, + "node_modules/aria-query": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz", + "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==", + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/array-iterate": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/array-iterate/-/array-iterate-2.0.1.tgz", + "integrity": "sha512-I1jXZMjAgCMmxT4qxXfPXa6SthSoE8h6gkSI9BGGNv8mP8G/v0blc+qFnZu6K42vTOiuME596QaLO0TP3Lk0xg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/astro": { + "version": "5.16.15", + "resolved": "https://registry.npmjs.org/astro/-/astro-5.16.15.tgz", + "integrity": "sha512-+X1Z0NTi2pa5a0Te6h77Dgc44fYj63j1yx6+39Nvg05lExajxSq7b1Uj/gtY45zoum8fD0+h0nak+DnHighs3A==", + "license": "MIT", + "dependencies": { + "@astrojs/compiler": "^2.13.0", + "@astrojs/internal-helpers": "0.7.5", + "@astrojs/markdown-remark": "6.3.10", + "@astrojs/telemetry": "3.3.0", + "@capsizecss/unpack": "^4.0.0", + "@oslojs/encoding": "^1.1.0", + "@rollup/pluginutils": "^5.3.0", + "acorn": "^8.15.0", + "aria-query": "^5.3.2", + "axobject-query": "^4.1.0", + "boxen": "8.0.1", + "ci-info": "^4.3.1", + "clsx": "^2.1.1", + "common-ancestor-path": "^1.0.1", + "cookie": "^1.1.1", + "cssesc": "^3.0.0", + "debug": "^4.4.3", + "deterministic-object-hash": "^2.0.2", + "devalue": "^5.6.2", + "diff": "^8.0.3", + "dlv": "^1.1.3", + "dset": "^3.1.4", + "es-module-lexer": "^1.7.0", + "esbuild": "^0.25.0", + "estree-walker": "^3.0.3", + "flattie": "^1.1.1", + "fontace": "~0.4.0", + "github-slugger": "^2.0.0", + "html-escaper": "3.0.3", + "http-cache-semantics": "^4.2.0", + "import-meta-resolve": "^4.2.0", + "js-yaml": "^4.1.1", + "magic-string": "^0.30.21", + "magicast": "^0.5.1", + "mrmime": "^2.0.1", + "neotraverse": "^0.6.18", + "p-limit": "^6.2.0", + "p-queue": "^8.1.1", + "package-manager-detector": "^1.6.0", + "piccolore": "^0.1.3", + "picomatch": "^4.0.3", + "prompts": "^2.4.2", + "rehype": "^13.0.2", + "semver": "^7.7.3", + "shiki": "^3.21.0", + "smol-toml": "^1.6.0", + "svgo": "^4.0.0", + "tinyexec": "^1.0.2", + "tinyglobby": "^0.2.15", + "tsconfck": "^3.1.6", + "ultrahtml": "^1.6.0", + "unifont": "~0.7.3", + "unist-util-visit": "^5.0.0", + "unstorage": "^1.17.4", + "vfile": "^6.0.3", + "vite": "^6.4.1", + "vitefu": "^1.1.1", + "xxhash-wasm": "^1.1.0", + "yargs-parser": "^21.1.1", + "yocto-spinner": "^0.2.3", + "zod": "^3.25.76", + "zod-to-json-schema": "^3.25.1", + "zod-to-ts": "^1.2.0" + }, + "bin": { + "astro": "astro.js" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0", + "npm": ">=9.6.5", + "pnpm": ">=7.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/astrodotbuild" + }, + "optionalDependencies": { + "sharp": "^0.34.0" + } + }, + "node_modules/axobject-query": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz", + "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==", + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/bail": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz", + "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/base-64": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/base-64/-/base-64-1.0.0.tgz", + "integrity": "sha512-kwDPIFCGx0NZHog36dj+tHiwP4QMzsZ3AgMViUBKI0+V5n4U0ufTCUMhnQ04diaRI8EX/QcPfql7zlhZ7j4zgg==", + "license": "MIT" + }, + "node_modules/boolbase": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz", + "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==", + "license": "ISC" + }, + "node_modules/boxen": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/boxen/-/boxen-8.0.1.tgz", + "integrity": "sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw==", + "license": "MIT", + "dependencies": { + "ansi-align": "^3.0.1", + "camelcase": "^8.0.0", + "chalk": "^5.3.0", + "cli-boxes": "^3.0.0", + "string-width": "^7.2.0", + "type-fest": "^4.21.0", + "widest-line": "^5.0.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/camelcase": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-8.0.0.tgz", + "integrity": "sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA==", + "license": "MIT", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ccount": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz", + "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/character-entities": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz", + "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-html4": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz", + "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-legacy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz", + "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/choices.js": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/choices.js/-/choices.js-11.1.0.tgz", + "integrity": "sha512-mIt0uLhedHg2ea/K2PACrVpt391vRGHuOoctPAiHcyemezwzNMxj7jOzNEk8e7EbjLh0S0sspDkSCADOKz9kcw==", + "license": "MIT", + "dependencies": { + "fuse.js": "^7.0.0" + } + }, + "node_modules/chokidar": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz", + "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==", + "license": "MIT", + "dependencies": { + "readdirp": "^5.0.0" + }, + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/ci-info": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.3.1.tgz", + "integrity": "sha512-Wdy2Igu8OcBpI2pZePZ5oWjPC38tmDVx5WKUXKwlLYkA0ozo85sLsLvkBbBn/sZaSCMFOGZJ14fvW9t5/d7kdA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/sibiraj-s" + } + ], + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cli-boxes": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-3.0.0.tgz", + "integrity": "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/clsx": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz", + "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/comma-separated-tokens": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz", + "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/commander": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz", + "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==", + "license": "MIT", + "engines": { + "node": ">=16" + } + }, + "node_modules/common-ancestor-path": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/common-ancestor-path/-/common-ancestor-path-1.0.1.tgz", + "integrity": "sha512-L3sHRo1pXXEqX8VU28kfgUY+YGsk09hPqZiZmLacNib6XNTCM8ubYeT7ryXQw8asB1sKgcU5lkB7ONug08aB8w==", + "license": "ISC" + }, + "node_modules/cookie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz", + "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/cookie-es": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.2.tgz", + "integrity": "sha512-+W7VmiVINB+ywl1HGXJXmrqkOhpKrIiVZV6tQuV54ZyQC7MMuBt81Vc336GMLoHBq5hV/F9eXgt5Mnx0Rha5Fg==", + "license": "MIT" + }, + "node_modules/core-util-is": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", + "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", + "license": "MIT" + }, + "node_modules/crossws": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/crossws/-/crossws-0.3.5.tgz", + "integrity": "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==", + "license": "MIT", + "dependencies": { + "uncrypto": "^0.1.3" + } + }, + "node_modules/css-select": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz", + "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0", + "css-what": "^6.1.0", + "domhandler": "^5.0.2", + "domutils": "^3.0.1", + "nth-check": "^2.0.1" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/css-tree": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.1.0.tgz", + "integrity": "sha512-0eW44TGN5SQXU1mWSkKwFstI/22X2bG1nYzZTYMAWjylYURhse752YgbE4Cx46AC+bAvI+/dYTPRk1LqSUnu6w==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.12.2", + "source-map-js": "^1.0.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0" + } + }, + "node_modules/css-what": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz", + "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">= 6" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/cssesc": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz", + "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==", + "license": "MIT", + "bin": { + "cssesc": "bin/cssesc" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/csso": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/csso/-/csso-5.0.5.tgz", + "integrity": "sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==", + "license": "MIT", + "dependencies": { + "css-tree": "~2.2.0" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0", + "npm": ">=7.0.0" + } + }, + "node_modules/csso/node_modules/css-tree": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-2.2.1.tgz", + "integrity": "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.0.28", + "source-map-js": "^1.0.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0", + "npm": ">=7.0.0" + } + }, + "node_modules/csso/node_modules/mdn-data": { + "version": "2.0.28", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.28.tgz", + "integrity": "sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==", + "license": "CC0-1.0" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/decode-named-character-reference": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz", + "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==", + "license": "MIT", + "dependencies": { + "character-entities": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/defu": { + "version": "6.1.4", + "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.4.tgz", + "integrity": "sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==", + "license": "MIT" + }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/destr": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz", + "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==", + "license": "MIT" + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "license": "Apache-2.0", + "optional": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/deterministic-object-hash": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/deterministic-object-hash/-/deterministic-object-hash-2.0.2.tgz", + "integrity": "sha512-KxektNH63SrbfUyDiwXqRb1rLwKt33AmMv+5Nhsw1kqZ13SJBRTgZHtGbE+hH3a1mVW1cz+4pqSWVPAtLVXTzQ==", + "license": "MIT", + "dependencies": { + "base-64": "^1.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/devalue": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.6.2.tgz", + "integrity": "sha512-nPRkjWzzDQlsejL1WVifk5rvcFi/y1onBRxjaFMjZeR9mFpqu2gmAZ9xUB9/IEanEP/vBtGeGganC/GO1fmufg==", + "license": "MIT" + }, + "node_modules/devlop": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz", + "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==", + "license": "MIT", + "dependencies": { + "dequal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/diff": { + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/diff/-/diff-8.0.3.tgz", + "integrity": "sha512-qejHi7bcSD4hQAZE0tNAawRK1ZtafHDmMTMkrrIGgSLl7hTnQHmKCeB45xAcbfTqK2zowkM3j3bHt/4b/ARbYQ==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.3.1" + } + }, + "node_modules/dlv": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz", + "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==", + "license": "MIT" + }, + "node_modules/dom-serializer": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz", + "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==", + "license": "MIT", + "dependencies": { + "domelementtype": "^2.3.0", + "domhandler": "^5.0.2", + "entities": "^4.2.0" + }, + "funding": { + "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1" + } + }, + "node_modules/dom-serializer/node_modules/entities": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", + "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/domelementtype": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz", + "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fb55" + } + ], + "license": "BSD-2-Clause" + }, + "node_modules/domhandler": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz", + "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==", + "license": "BSD-2-Clause", + "dependencies": { + "domelementtype": "^2.3.0" + }, + "engines": { + "node": ">= 4" + }, + "funding": { + "url": "https://github.com/fb55/domhandler?sponsor=1" + } + }, + "node_modules/domutils": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz", + "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==", + "license": "BSD-2-Clause", + "dependencies": { + "dom-serializer": "^2.0.0", + "domelementtype": "^2.3.0", + "domhandler": "^5.0.3" + }, + "funding": { + "url": "https://github.com/fb55/domutils?sponsor=1" + } + }, + "node_modules/dset": { + "version": "3.1.4", + "resolved": "https://registry.npmjs.org/dset/-/dset-3.1.4.tgz", + "integrity": "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "license": "MIT" + }, + "node_modules/entities": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz", + "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/es-module-lexer": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz", + "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==", + "license": "MIT" + }, + "node_modules/esbuild": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz", + "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==", + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.25.12", + "@esbuild/android-arm": "0.25.12", + "@esbuild/android-arm64": "0.25.12", + "@esbuild/android-x64": "0.25.12", + "@esbuild/darwin-arm64": "0.25.12", + "@esbuild/darwin-x64": "0.25.12", + "@esbuild/freebsd-arm64": "0.25.12", + "@esbuild/freebsd-x64": "0.25.12", + "@esbuild/linux-arm": "0.25.12", + "@esbuild/linux-arm64": "0.25.12", + "@esbuild/linux-ia32": "0.25.12", + "@esbuild/linux-loong64": "0.25.12", + "@esbuild/linux-mips64el": "0.25.12", + "@esbuild/linux-ppc64": "0.25.12", + "@esbuild/linux-riscv64": "0.25.12", + "@esbuild/linux-s390x": "0.25.12", + "@esbuild/linux-x64": "0.25.12", + "@esbuild/netbsd-arm64": "0.25.12", + "@esbuild/netbsd-x64": "0.25.12", + "@esbuild/openbsd-arm64": "0.25.12", + "@esbuild/openbsd-x64": "0.25.12", + "@esbuild/openharmony-arm64": "0.25.12", + "@esbuild/sunos-x64": "0.25.12", + "@esbuild/win32-arm64": "0.25.12", + "@esbuild/win32-ia32": "0.25.12", + "@esbuild/win32-x64": "0.25.12" + } + }, + "node_modules/escape-string-regexp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz", + "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/eventemitter3": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==", + "license": "MIT" + }, + "node_modules/extend": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", + "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", + "license": "MIT" + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/flattie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/flattie/-/flattie-1.1.1.tgz", + "integrity": "sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/fontace": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/fontace/-/fontace-0.4.0.tgz", + "integrity": "sha512-moThBCItUe2bjZip5PF/iZClpKHGLwMvR79Kp8XpGRBrvoRSnySN4VcILdv3/MJzbhvUA5WeiUXF5o538m5fvg==", + "license": "MIT", + "dependencies": { + "fontkitten": "^1.0.0" + } + }, + "node_modules/fontkitten": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/fontkitten/-/fontkitten-1.0.2.tgz", + "integrity": "sha512-piJxbLnkD9Xcyi7dWJRnqszEURixe7CrF/efBfbffe2DPyabmuIuqraruY8cXTs19QoM8VJzx47BDRVNXETM7Q==", + "license": "MIT", + "dependencies": { + "tiny-inflate": "^1.0.3" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/fuse.js": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/fuse.js/-/fuse.js-7.1.0.tgz", + "integrity": "sha512-trLf4SzuuUxfusZADLINj+dE8clK1frKdmqiJNb1Es75fmI5oY6X2mxLVUciLLjxqw/xr72Dhy+lER6dGd02FQ==", + "license": "Apache-2.0", + "engines": { + "node": ">=10" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.4.0.tgz", + "integrity": "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/github-slugger": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/github-slugger/-/github-slugger-2.0.0.tgz", + "integrity": "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==", + "license": "ISC" + }, + "node_modules/h3": { + "version": "1.15.5", + "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.5.tgz", + "integrity": "sha512-xEyq3rSl+dhGX2Lm0+eFQIAzlDN6Fs0EcC4f7BNUmzaRX/PTzeuM+Tr2lHB8FoXggsQIeXLj8EDVgs5ywxyxmg==", + "license": "MIT", + "dependencies": { + "cookie-es": "^1.2.2", + "crossws": "^0.3.5", + "defu": "^6.1.4", + "destr": "^2.0.5", + "iron-webcrypto": "^1.2.1", + "node-mock-http": "^1.0.4", + "radix3": "^1.1.2", + "ufo": "^1.6.3", + "uncrypto": "^0.1.3" + } + }, + "node_modules/hast-util-from-html": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/hast-util-from-html/-/hast-util-from-html-2.0.3.tgz", + "integrity": "sha512-CUSRHXyKjzHov8yKsQjGOElXy/3EKpyX56ELnkHH34vDVw1N1XSQ1ZcAvTyAPtGqLTuKP/uxM+aLkSPqF/EtMw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "devlop": "^1.1.0", + "hast-util-from-parse5": "^8.0.0", + "parse5": "^7.0.0", + "vfile": "^6.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-from-parse5": { + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/hast-util-from-parse5/-/hast-util-from-parse5-8.0.3.tgz", + "integrity": "sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "devlop": "^1.0.0", + "hastscript": "^9.0.0", + "property-information": "^7.0.0", + "vfile": "^6.0.0", + "vfile-location": "^5.0.0", + "web-namespaces": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-is-element": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-is-element/-/hast-util-is-element-3.0.0.tgz", + "integrity": "sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-parse-selector": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/hast-util-parse-selector/-/hast-util-parse-selector-4.0.0.tgz", + "integrity": "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-raw": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/hast-util-raw/-/hast-util-raw-9.1.0.tgz", + "integrity": "sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "@ungap/structured-clone": "^1.0.0", + "hast-util-from-parse5": "^8.0.0", + "hast-util-to-parse5": "^8.0.0", + "html-void-elements": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "parse5": "^7.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0", + "web-namespaces": "^2.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-html": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz", + "integrity": "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-whitespace": "^3.0.0", + "html-void-elements": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "stringify-entities": "^4.0.0", + "zwitch": "^2.0.4" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-parse5": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/hast-util-to-parse5/-/hast-util-to-parse5-8.0.1.tgz", + "integrity": "sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "devlop": "^1.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "web-namespaces": "^2.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-text": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/hast-util-to-text/-/hast-util-to-text-4.0.2.tgz", + "integrity": "sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "hast-util-is-element": "^3.0.0", + "unist-util-find-after": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-whitespace": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz", + "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hastscript": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/hastscript/-/hastscript-9.0.1.tgz", + "integrity": "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-parse-selector": "^4.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/html-escaper": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-3.0.3.tgz", + "integrity": "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==", + "license": "MIT" + }, + "node_modules/html-void-elements": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-void-elements/-/html-void-elements-3.0.0.tgz", + "integrity": "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/http-cache-semantics": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz", + "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==", + "license": "BSD-2-Clause" + }, + "node_modules/immediate": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz", + "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==", + "license": "MIT" + }, + "node_modules/import-meta-resolve": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.2.0.tgz", + "integrity": "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/iron-webcrypto": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/iron-webcrypto/-/iron-webcrypto-1.2.1.tgz", + "integrity": "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/brc-dd" + } + }, + "node_modules/is-docker": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz", + "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==", + "license": "MIT", + "bin": { + "is-docker": "cli.js" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-inside-container": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz", + "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==", + "license": "MIT", + "dependencies": { + "is-docker": "^3.0.0" + }, + "bin": { + "is-inside-container": "cli.js" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-plain-obj": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", + "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-wsl": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.0.tgz", + "integrity": "sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==", + "license": "MIT", + "dependencies": { + "is-inside-container": "^1.0.0" + }, + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/isarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", + "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jszip": { + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz", + "integrity": "sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==", + "license": "(MIT OR GPL-3.0-or-later)", + "dependencies": { + "lie": "~3.3.0", + "pako": "~1.0.2", + "readable-stream": "~2.3.6", + "setimmediate": "^1.0.5" + } + }, + "node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/lie": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz", + "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==", + "license": "MIT", + "dependencies": { + "immediate": "~3.0.5" + } + }, + "node_modules/longest-streak": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz", + "integrity": "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/lru-cache": { + "version": "11.2.5", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.5.tgz", + "integrity": "sha512-vFrFJkWtJvJnD5hg+hJvVE8Lh/TcMzKnTgCWmtBipwI5yLX/iX+5UB2tfuyODF5E7k9xEzMdYgGqaSb1c0c5Yw==", + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/magicast": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.1.tgz", + "integrity": "sha512-xrHS24IxaLrvuo613F719wvOIv9xPHFWQHuvGUBmPnCA/3MQxKI3b+r7n1jAoDHmsbC5bRhTZYR77invLAxVnw==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.28.5", + "@babel/types": "^7.28.5", + "source-map-js": "^1.2.1" + } + }, + "node_modules/markdown-table": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-3.0.4.tgz", + "integrity": "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/mdast-util-definitions": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-definitions/-/mdast-util-definitions-6.0.0.tgz", + "integrity": "sha512-scTllyX6pnYNZH/AIp/0ePz6s4cZtARxImwoPJ7kS42n+MnVsI4XbnG6d4ibehRIldYMWM2LD7ImQblVhUejVQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-find-and-replace": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mdast-util-find-and-replace/-/mdast-util-find-and-replace-3.0.2.tgz", + "integrity": "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "escape-string-regexp": "^5.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-from-markdown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-2.0.2.tgz", + "integrity": "sha512-uZhTV/8NBuw0WHkPTrCqDOl0zVe1BIng5ZtHoDk49ME1qqcjYmmLmOf0gELgcRMxN4w2iuIeVso5/6QymSrgmA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "mdast-util-to-string": "^4.0.0", + "micromark": "^4.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-decode-string": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm/-/mdast-util-gfm-3.1.0.tgz", + "integrity": "sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==", + "license": "MIT", + "dependencies": { + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-gfm-autolink-literal": "^2.0.0", + "mdast-util-gfm-footnote": "^2.0.0", + "mdast-util-gfm-strikethrough": "^2.0.0", + "mdast-util-gfm-table": "^2.0.0", + "mdast-util-gfm-task-list-item": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-autolink-literal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-autolink-literal/-/mdast-util-gfm-autolink-literal-2.0.1.tgz", + "integrity": "sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "ccount": "^2.0.0", + "devlop": "^1.0.0", + "mdast-util-find-and-replace": "^3.0.0", + "micromark-util-character": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-footnote/-/mdast-util-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.1.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-strikethrough": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-strikethrough/-/mdast-util-gfm-strikethrough-2.0.0.tgz", + "integrity": "sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-table": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-table/-/mdast-util-gfm-table-2.0.0.tgz", + "integrity": "sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "markdown-table": "^3.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-task-list-item": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-task-list-item/-/mdast-util-gfm-task-list-item-2.0.0.tgz", + "integrity": "sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-phrasing": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-phrasing/-/mdast-util-phrasing-4.1.0.tgz", + "integrity": "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-hast": { + "version": "13.2.1", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", + "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@ungap/structured-clone": "^1.0.0", + "devlop": "^1.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "trim-lines": "^3.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-markdown": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/mdast-util-to-markdown/-/mdast-util-to-markdown-2.1.2.tgz", + "integrity": "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "longest-streak": "^3.0.0", + "mdast-util-phrasing": "^4.0.0", + "mdast-util-to-string": "^4.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-decode-string": "^2.0.0", + "unist-util-visit": "^5.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-4.0.0.tgz", + "integrity": "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdn-data": { + "version": "2.12.2", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.12.2.tgz", + "integrity": "sha512-IEn+pegP1aManZuckezWCO+XZQDplx1366JoVhTpMpBB1sPey/SbveZQUosKiKiGYjg1wH4pMlNgXbCiYgihQA==", + "license": "CC0-1.0" + }, + "node_modules/micromark": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz", + "integrity": "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/debug": "^4.0.0", + "debug": "^4.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-core-commonmark": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.3.tgz", + "integrity": "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-factory-destination": "^2.0.0", + "micromark-factory-label": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-factory-title": "^2.0.0", + "micromark-factory-whitespace": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-html-tag-name": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-extension-gfm": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm/-/micromark-extension-gfm-3.0.0.tgz", + "integrity": "sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==", + "license": "MIT", + "dependencies": { + "micromark-extension-gfm-autolink-literal": "^2.0.0", + "micromark-extension-gfm-footnote": "^2.0.0", + "micromark-extension-gfm-strikethrough": "^2.0.0", + "micromark-extension-gfm-table": "^2.0.0", + "micromark-extension-gfm-tagfilter": "^2.0.0", + "micromark-extension-gfm-task-list-item": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-autolink-literal": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz", + "integrity": "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==", + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-strikethrough": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-strikethrough/-/micromark-extension-gfm-strikethrough-2.1.0.tgz", + "integrity": "sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-table": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.1.tgz", + "integrity": "sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-tagfilter": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-tagfilter/-/micromark-extension-gfm-tagfilter-2.0.0.tgz", + "integrity": "sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==", + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-task-list-item": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-task-list-item/-/micromark-extension-gfm-task-list-item-2.1.0.tgz", + "integrity": "sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-factory-destination": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz", + "integrity": "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-label": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz", + "integrity": "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-space": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.0.1.tgz", + "integrity": "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-title": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz", + "integrity": "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-whitespace": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz", + "integrity": "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-character": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz", + "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-chunked": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz", + "integrity": "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-classify-character": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz", + "integrity": "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-combine-extensions": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz", + "integrity": "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-chunked": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-numeric-character-reference": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz", + "integrity": "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-string": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-2.0.1.tgz", + "integrity": "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-encode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz", + "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-html-tag-name": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz", + "integrity": "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-normalize-identifier": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz", + "integrity": "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-resolve-all": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz", + "integrity": "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-sanitize-uri": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz", + "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-subtokenize": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz", + "integrity": "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-symbol": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz", + "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz", + "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/mrmime": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz", + "integrity": "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", + "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/neotraverse": { + "version": "0.6.18", + "resolved": "https://registry.npmjs.org/neotraverse/-/neotraverse-0.6.18.tgz", + "integrity": "sha512-Z4SmBUweYa09+o6pG+eASabEpP6QkQ70yHj351pQoEXIs8uHbaU2DWVmzBANKgflPa47A50PtB2+NgRpQvr7vA==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/nlcst-to-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/nlcst-to-string/-/nlcst-to-string-4.0.0.tgz", + "integrity": "sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/node-fetch-native": { + "version": "1.6.7", + "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.7.tgz", + "integrity": "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==", + "license": "MIT" + }, + "node_modules/node-mock-http": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.4.tgz", + "integrity": "sha512-8DY+kFsDkNXy1sJglUfuODx1/opAGJGyrTuFqEoN90oRc2Vk0ZbD4K2qmKXBBEhZQzdKHIVfEJpDU8Ak2NJEvQ==", + "license": "MIT" + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/nth-check": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz", + "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0" + }, + "funding": { + "url": "https://github.com/fb55/nth-check?sponsor=1" + } + }, + "node_modules/ofetch": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.5.1.tgz", + "integrity": "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==", + "license": "MIT", + "dependencies": { + "destr": "^2.0.5", + "node-fetch-native": "^1.6.7", + "ufo": "^1.6.1" + } + }, + "node_modules/ohash": { + "version": "2.0.11", + "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.11.tgz", + "integrity": "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==", + "license": "MIT" + }, + "node_modules/oniguruma-parser": { + "version": "0.12.1", + "resolved": "https://registry.npmjs.org/oniguruma-parser/-/oniguruma-parser-0.12.1.tgz", + "integrity": "sha512-8Unqkvk1RYc6yq2WBYRj4hdnsAxVze8i7iPfQr8e4uSP3tRv0rpZcbGUDvxfQQcdwHt/e9PrMvGCsa8OqG9X3w==", + "license": "MIT" + }, + "node_modules/oniguruma-to-es": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/oniguruma-to-es/-/oniguruma-to-es-4.3.4.tgz", + "integrity": "sha512-3VhUGN3w2eYxnTzHn+ikMI+fp/96KoRSVK9/kMTcFqj1NRDh2IhQCKvYxDnWePKRXY/AqH+Fuiyb7VHSzBjHfA==", + "license": "MIT", + "dependencies": { + "oniguruma-parser": "^0.12.1", + "regex": "^6.0.1", + "regex-recursion": "^6.0.2" + } + }, + "node_modules/p-limit": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-6.2.0.tgz", + "integrity": "sha512-kuUqqHNUqoIWp/c467RI4X6mmyuojY5jGutNU0wVTmEOOfcuwLqyMVoAi9MKi2Ak+5i9+nhmrK4ufZE8069kHA==", + "license": "MIT", + "dependencies": { + "yocto-queue": "^1.1.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-queue": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/p-queue/-/p-queue-8.1.1.tgz", + "integrity": "sha512-aNZ+VfjobsWryoiPnEApGGmf5WmNsCo9xu8dfaYamG5qaLP7ClhLN6NgsFe6SwJ2UbLEBK5dv9x8Mn5+RVhMWQ==", + "license": "MIT", + "dependencies": { + "eventemitter3": "^5.0.1", + "p-timeout": "^6.1.2" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-timeout": { + "version": "6.1.4", + "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-6.1.4.tgz", + "integrity": "sha512-MyIV3ZA/PmyBN/ud8vV9XzwTrNtR4jFrObymZYnZqMmW0zA8Z17vnT0rBgFE/TlohB+YCHqXMgZzb3Csp49vqg==", + "license": "MIT", + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/package-manager-detector": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.6.0.tgz", + "integrity": "sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==", + "license": "MIT" + }, + "node_modules/pako": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz", + "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==", + "license": "(MIT AND Zlib)" + }, + "node_modules/parse-latin": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/parse-latin/-/parse-latin-7.0.0.tgz", + "integrity": "sha512-mhHgobPPua5kZ98EF4HWiH167JWBfl4pvAIXXdbaVohtK7a6YBOy56kvhCqduqyo/f3yrHFWmqmiMg/BkBkYYQ==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "@types/unist": "^3.0.0", + "nlcst-to-string": "^4.0.0", + "unist-util-modify-children": "^4.0.0", + "unist-util-visit-children": "^3.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/parse5": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz", + "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==", + "license": "MIT", + "dependencies": { + "entities": "^6.0.0" + }, + "funding": { + "url": "https://github.com/inikulin/parse5?sponsor=1" + } + }, + "node_modules/piccolore": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/piccolore/-/piccolore-0.1.3.tgz", + "integrity": "sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==", + "license": "ISC" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.6", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz", + "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/prismjs": { + "version": "1.30.0", + "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", + "integrity": "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/process-nextick-args": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", + "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", + "license": "MIT" + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "license": "MIT", + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/property-information": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.1.0.tgz", + "integrity": "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/radix3": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/radix3/-/radix3-1.1.2.tgz", + "integrity": "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==", + "license": "MIT" + }, + "node_modules/readable-stream": { + "version": "2.3.8", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", + "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", + "license": "MIT", + "dependencies": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~2.0.0", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.1.1", + "util-deprecate": "~1.0.1" + } + }, + "node_modules/readdirp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz", + "integrity": "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==", + "license": "MIT", + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz", + "integrity": "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-recursion": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/regex-recursion/-/regex-recursion-6.0.2.tgz", + "integrity": "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-utilities": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/regex-utilities/-/regex-utilities-2.3.0.tgz", + "integrity": "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==", + "license": "MIT" + }, + "node_modules/rehype": { + "version": "13.0.2", + "resolved": "https://registry.npmjs.org/rehype/-/rehype-13.0.2.tgz", + "integrity": "sha512-j31mdaRFrwFRUIlxGeuPXXKWQxet52RBQRvCmzl5eCefn/KGbomK5GMHNMsOJf55fgo3qw5tST5neDuarDYR2A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "rehype-parse": "^9.0.0", + "rehype-stringify": "^10.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-parse": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/rehype-parse/-/rehype-parse-9.0.1.tgz", + "integrity": "sha512-ksCzCD0Fgfh7trPDxr2rSylbwq9iYDkSn8TCDmEJ49ljEUBxDVCzCHv7QNzZOfODanX4+bWQ4WZqLCRWYLfhag==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-from-html": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-raw": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/rehype-raw/-/rehype-raw-7.0.0.tgz", + "integrity": "sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-raw": "^9.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-stringify": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/rehype-stringify/-/rehype-stringify-10.0.1.tgz", + "integrity": "sha512-k9ecfXHmIPuFVI61B9DeLPN0qFHfawM6RsuX48hoqlaKSF61RskNjSm1lI8PhBEM0MRdLxVVm4WmTqJQccH9mA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-to-html": "^9.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-gfm": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/remark-gfm/-/remark-gfm-4.0.1.tgz", + "integrity": "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-gfm": "^3.0.0", + "micromark-extension-gfm": "^3.0.0", + "remark-parse": "^11.0.0", + "remark-stringify": "^11.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-parse": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-11.0.0.tgz", + "integrity": "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-from-markdown": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-rehype": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/remark-rehype/-/remark-rehype-11.1.2.tgz", + "integrity": "sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "mdast-util-to-hast": "^13.0.0", + "unified": "^11.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-smartypants": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/remark-smartypants/-/remark-smartypants-3.0.2.tgz", + "integrity": "sha512-ILTWeOriIluwEvPjv67v7Blgrcx+LZOkAUVtKI3putuhlZm84FnqDORNXPPm+HY3NdZOMhyDwZ1E+eZB/Df5dA==", + "license": "MIT", + "dependencies": { + "retext": "^9.0.0", + "retext-smartypants": "^6.0.0", + "unified": "^11.0.4", + "unist-util-visit": "^5.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/remark-stringify": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/remark-stringify/-/remark-stringify-11.0.0.tgz", + "integrity": "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-to-markdown": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/retext/-/retext-9.0.0.tgz", + "integrity": "sha512-sbMDcpHCNjvlheSgMfEcVrZko3cDzdbe1x/e7G66dFp0Ff7Mldvi2uv6JkJQzdRcvLYE8CA8Oe8siQx8ZOgTcA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "retext-latin": "^4.0.0", + "retext-stringify": "^4.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext-latin": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/retext-latin/-/retext-latin-4.0.0.tgz", + "integrity": "sha512-hv9woG7Fy0M9IlRQloq/N6atV82NxLGveq+3H2WOi79dtIYWN8OaxogDm77f8YnVXJL2VD3bbqowu5E3EMhBYA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "parse-latin": "^7.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext-smartypants": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/retext-smartypants/-/retext-smartypants-6.2.0.tgz", + "integrity": "sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "nlcst-to-string": "^4.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext-stringify": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/retext-stringify/-/retext-stringify-4.0.0.tgz", + "integrity": "sha512-rtfN/0o8kL1e+78+uxPTqu1Klt0yPzKuQ2BfWwwfgIUSayyzxpM1PJzkKt4V8803uB9qSy32MvI7Xep9khTpiA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "nlcst-to-string": "^4.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rollup": { + "version": "4.57.0", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.57.0.tgz", + "integrity": "sha512-e5lPJi/aui4TO1LpAXIRLySmwXSE8k3b9zoGfd42p67wzxog4WHjiZF3M2uheQih4DGyc25QEV4yRBbpueNiUA==", + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.57.0", + "@rollup/rollup-android-arm64": "4.57.0", + "@rollup/rollup-darwin-arm64": "4.57.0", + "@rollup/rollup-darwin-x64": "4.57.0", + "@rollup/rollup-freebsd-arm64": "4.57.0", + "@rollup/rollup-freebsd-x64": "4.57.0", + "@rollup/rollup-linux-arm-gnueabihf": "4.57.0", + "@rollup/rollup-linux-arm-musleabihf": "4.57.0", + "@rollup/rollup-linux-arm64-gnu": "4.57.0", + "@rollup/rollup-linux-arm64-musl": "4.57.0", + "@rollup/rollup-linux-loong64-gnu": "4.57.0", + "@rollup/rollup-linux-loong64-musl": "4.57.0", + "@rollup/rollup-linux-ppc64-gnu": "4.57.0", + "@rollup/rollup-linux-ppc64-musl": "4.57.0", + "@rollup/rollup-linux-riscv64-gnu": "4.57.0", + "@rollup/rollup-linux-riscv64-musl": "4.57.0", + "@rollup/rollup-linux-s390x-gnu": "4.57.0", + "@rollup/rollup-linux-x64-gnu": "4.57.0", + "@rollup/rollup-linux-x64-musl": "4.57.0", + "@rollup/rollup-openbsd-x64": "4.57.0", + "@rollup/rollup-openharmony-arm64": "4.57.0", + "@rollup/rollup-win32-arm64-msvc": "4.57.0", + "@rollup/rollup-win32-ia32-msvc": "4.57.0", + "@rollup/rollup-win32-x64-gnu": "4.57.0", + "@rollup/rollup-win32-x64-msvc": "4.57.0", + "fsevents": "~2.3.2" + } + }, + "node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "license": "MIT" + }, + "node_modules/sax": { + "version": "1.4.4", + "resolved": "https://registry.npmjs.org/sax/-/sax-1.4.4.tgz", + "integrity": "sha512-1n3r/tGXO6b6VXMdFT54SHzT9ytu9yr7TaELowdYpMqY/Ao7EnlQGmAQ1+RatX7Tkkdm6hONI2owqNx2aZj5Sw==", + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=11.0.0" + } + }, + "node_modules/semver": { + "version": "7.7.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz", + "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/setimmediate": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz", + "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==", + "license": "MIT" + }, + "node_modules/sharp": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz", + "integrity": "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==", + "hasInstallScript": true, + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@img/colour": "^1.0.0", + "detect-libc": "^2.1.2", + "semver": "^7.7.3" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.34.5", + "@img/sharp-darwin-x64": "0.34.5", + "@img/sharp-libvips-darwin-arm64": "1.2.4", + "@img/sharp-libvips-darwin-x64": "1.2.4", + "@img/sharp-libvips-linux-arm": "1.2.4", + "@img/sharp-libvips-linux-arm64": "1.2.4", + "@img/sharp-libvips-linux-ppc64": "1.2.4", + "@img/sharp-libvips-linux-riscv64": "1.2.4", + "@img/sharp-libvips-linux-s390x": "1.2.4", + "@img/sharp-libvips-linux-x64": "1.2.4", + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4", + "@img/sharp-libvips-linuxmusl-x64": "1.2.4", + "@img/sharp-linux-arm": "0.34.5", + "@img/sharp-linux-arm64": "0.34.5", + "@img/sharp-linux-ppc64": "0.34.5", + "@img/sharp-linux-riscv64": "0.34.5", + "@img/sharp-linux-s390x": "0.34.5", + "@img/sharp-linux-x64": "0.34.5", + "@img/sharp-linuxmusl-arm64": "0.34.5", + "@img/sharp-linuxmusl-x64": "0.34.5", + "@img/sharp-wasm32": "0.34.5", + "@img/sharp-win32-arm64": "0.34.5", + "@img/sharp-win32-ia32": "0.34.5", + "@img/sharp-win32-x64": "0.34.5" + } + }, + "node_modules/shiki": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/shiki/-/shiki-3.21.0.tgz", + "integrity": "sha512-N65B/3bqL/TI2crrXr+4UivctrAGEjmsib5rPMMPpFp1xAx/w03v8WZ9RDDFYteXoEgY7qZ4HGgl5KBIu1153w==", + "license": "MIT", + "dependencies": { + "@shikijs/core": "3.21.0", + "@shikijs/engine-javascript": "3.21.0", + "@shikijs/engine-oniguruma": "3.21.0", + "@shikijs/langs": "3.21.0", + "@shikijs/themes": "3.21.0", + "@shikijs/types": "3.21.0", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4" + } + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "license": "MIT" + }, + "node_modules/sitemap": { + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/sitemap/-/sitemap-8.0.2.tgz", + "integrity": "sha512-LwktpJcyZDoa0IL6KT++lQ53pbSrx2c9ge41/SeLTyqy2XUNA6uR4+P9u5IVo5lPeL2arAcOKn1aZAxoYbCKlQ==", + "license": "MIT", + "dependencies": { + "@types/node": "^17.0.5", + "@types/sax": "^1.2.1", + "arg": "^5.0.0", + "sax": "^1.4.1" + }, + "bin": { + "sitemap": "dist/cli.js" + }, + "engines": { + "node": ">=14.0.0", + "npm": ">=6.0.0" + } + }, + "node_modules/sitemap/node_modules/@types/node": { + "version": "17.0.45", + "resolved": "https://registry.npmjs.org/@types/node/-/node-17.0.45.tgz", + "integrity": "sha512-w+tIMs3rq2afQdsPJlODhoUEKzFP1ayaoyl1CcnwtIlsVe7K7bA1NGm4s3PraqTLlXnbIN84zuBlxBWo1u9BLw==", + "license": "MIT" + }, + "node_modules/smol-toml": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.6.0.tgz", + "integrity": "sha512-4zemZi0HvTnYwLfrpk/CF9LOd9Lt87kAt50GnqhMpyF9U3poDAP2+iukq2bZsO/ufegbYehBkqINbsWxj4l4cw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 18" + }, + "funding": { + "url": "https://github.com/sponsors/cyyynthia" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/space-separated-tokens": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz", + "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/stream-replace-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/stream-replace-string/-/stream-replace-string-2.0.0.tgz", + "integrity": "sha512-TlnjJ1C0QrmxRNrON00JvaFFlNh5TTG00APw23j74ET7gkQpTASi6/L2fuiav8pzK715HXtUeClpBTw2NPSn6w==", + "license": "MIT" + }, + "node_modules/string_decoder": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", + "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.1.0" + } + }, + "node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/stringify-entities": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz", + "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==", + "license": "MIT", + "dependencies": { + "character-entities-html4": "^2.0.0", + "character-entities-legacy": "^3.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/svgo": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/svgo/-/svgo-4.0.0.tgz", + "integrity": "sha512-VvrHQ+9uniE+Mvx3+C9IEe/lWasXCU0nXMY2kZeLrHNICuRiC8uMPyM14UEaMOFA5mhyQqEkB02VoQ16n3DLaw==", + "license": "MIT", + "dependencies": { + "commander": "^11.1.0", + "css-select": "^5.1.0", + "css-tree": "^3.0.1", + "css-what": "^6.1.0", + "csso": "^5.0.5", + "picocolors": "^1.1.1", + "sax": "^1.4.1" + }, + "bin": { + "svgo": "bin/svgo.js" + }, + "engines": { + "node": ">=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/svgo" + } + }, + "node_modules/tiny-inflate": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz", + "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==", + "license": "MIT" + }, + "node_modules/tinyexec": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.0.2.tgz", + "integrity": "sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg==", + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/trim-lines": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz", + "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/trough": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz", + "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/tsconfck": { + "version": "3.1.6", + "resolved": "https://registry.npmjs.org/tsconfck/-/tsconfck-3.1.6.tgz", + "integrity": "sha512-ks6Vjr/jEw0P1gmOVwutM3B7fWxoWBL2KRDb1JfqGVawBmO5UsvmWOQFGHBPl5yxYz4eERr19E6L7NMv+Fej4w==", + "license": "MIT", + "bin": { + "tsconfck": "bin/tsconfck.js" + }, + "engines": { + "node": "^18 || >=20" + }, + "peerDependencies": { + "typescript": "^5.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD", + "optional": true + }, + "node_modules/type-fest": { + "version": "4.41.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz", + "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==", + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "license": "Apache-2.0", + "peer": true, + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/ufo": { + "version": "1.6.3", + "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.3.tgz", + "integrity": "sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==", + "license": "MIT" + }, + "node_modules/ultrahtml": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/ultrahtml/-/ultrahtml-1.6.0.tgz", + "integrity": "sha512-R9fBn90VTJrqqLDwyMph+HGne8eqY1iPfYhPzZrvKpIfwkWZbcYlfpsb8B9dTvBfpy1/hqAD7Wi8EKfP9e8zdw==", + "license": "MIT" + }, + "node_modules/uncrypto": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/uncrypto/-/uncrypto-0.1.3.tgz", + "integrity": "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==", + "license": "MIT" + }, + "node_modules/undici-types": { + "version": "7.16.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz", + "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==", + "license": "MIT" + }, + "node_modules/unified": { + "version": "11.0.5", + "resolved": "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz", + "integrity": "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "bail": "^2.0.0", + "devlop": "^1.0.0", + "extend": "^3.0.0", + "is-plain-obj": "^4.0.0", + "trough": "^2.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unifont": { + "version": "0.7.3", + "resolved": "https://registry.npmjs.org/unifont/-/unifont-0.7.3.tgz", + "integrity": "sha512-b0GtQzKCyuSHGsfj5vyN8st7muZ6VCI4XD4vFlr7Uy1rlWVYxC3npnfk8MyreHxJYrz1ooLDqDzFe9XqQTlAhA==", + "license": "MIT", + "dependencies": { + "css-tree": "^3.1.0", + "ofetch": "^1.5.1", + "ohash": "^2.0.11" + } + }, + "node_modules/unist-util-find-after": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-find-after/-/unist-util-find-after-5.0.0.tgz", + "integrity": "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-is": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz", + "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-modify-children": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-modify-children/-/unist-util-modify-children-4.0.0.tgz", + "integrity": "sha512-+tdN5fGNddvsQdIzUF3Xx82CU9sMM+fA0dLgR9vOmT0oPT2jH+P1nd5lSqfCfXAw+93NhcXNY2qqvTUtE4cQkw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "array-iterate": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz", + "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-remove-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-remove-position/-/unist-util-remove-position-5.0.0.tgz", + "integrity": "sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-stringify-position": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz", + "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz", + "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-children": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/unist-util-visit-children/-/unist-util-visit-children-3.0.0.tgz", + "integrity": "sha512-RgmdTfSBOg04sdPcpTSD1jzoNBjt9a80/ZCzp5cI9n1qPzLZWF9YdvWGN2zmTumP1HWhXKdUWexjy/Wy/lJ7tA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-parents": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz", + "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unstorage": { + "version": "1.17.4", + "resolved": "https://registry.npmjs.org/unstorage/-/unstorage-1.17.4.tgz", + "integrity": "sha512-fHK0yNg38tBiJKp/Vgsq4j0JEsCmgqH58HAn707S7zGkArbZsVr/CwINoi+nh3h98BRCwKvx1K3Xg9u3VV83sw==", + "license": "MIT", + "dependencies": { + "anymatch": "^3.1.3", + "chokidar": "^5.0.0", + "destr": "^2.0.5", + "h3": "^1.15.5", + "lru-cache": "^11.2.0", + "node-fetch-native": "^1.6.7", + "ofetch": "^1.5.1", + "ufo": "^1.6.3" + }, + "peerDependencies": { + "@azure/app-configuration": "^1.8.0", + "@azure/cosmos": "^4.2.0", + "@azure/data-tables": "^13.3.0", + "@azure/identity": "^4.6.0", + "@azure/keyvault-secrets": "^4.9.0", + "@azure/storage-blob": "^12.26.0", + "@capacitor/preferences": "^6 || ^7 || ^8", + "@deno/kv": ">=0.9.0", + "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0", + "@planetscale/database": "^1.19.0", + "@upstash/redis": "^1.34.3", + "@vercel/blob": ">=0.27.1", + "@vercel/functions": "^2.2.12 || ^3.0.0", + "@vercel/kv": "^1 || ^2 || ^3", + "aws4fetch": "^1.0.20", + "db0": ">=0.2.1", + "idb-keyval": "^6.2.1", + "ioredis": "^5.4.2", + "uploadthing": "^7.4.4" + }, + "peerDependenciesMeta": { + "@azure/app-configuration": { + "optional": true + }, + "@azure/cosmos": { + "optional": true + }, + "@azure/data-tables": { + "optional": true + }, + "@azure/identity": { + "optional": true + }, + "@azure/keyvault-secrets": { + "optional": true + }, + "@azure/storage-blob": { + "optional": true + }, + "@capacitor/preferences": { + "optional": true + }, + "@deno/kv": { + "optional": true + }, + "@netlify/blobs": { + "optional": true + }, + "@planetscale/database": { + "optional": true + }, + "@upstash/redis": { + "optional": true + }, + "@vercel/blob": { + "optional": true + }, + "@vercel/functions": { + "optional": true + }, + "@vercel/kv": { + "optional": true + }, + "aws4fetch": { + "optional": true + }, + "db0": { + "optional": true + }, + "idb-keyval": { + "optional": true + }, + "ioredis": { + "optional": true + }, + "uploadthing": { + "optional": true + } + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT" + }, + "node_modules/vfile": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz", + "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-location": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/vfile-location/-/vfile-location-5.0.3.tgz", + "integrity": "sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-message": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz", + "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vite": { + "version": "6.4.1", + "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.1.tgz", + "integrity": "sha512-+Oxm7q9hDoLMyJOYfUYBuHQo+dkAloi33apOPP56pzj+vsdJDzr+j1NISE5pyaAuKL4A3UD34qd0lx5+kfKp2g==", + "license": "MIT", + "dependencies": { + "esbuild": "^0.25.0", + "fdir": "^6.4.4", + "picomatch": "^4.0.2", + "postcss": "^8.5.3", + "rollup": "^4.34.9", + "tinyglobby": "^0.2.13" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || ^20.0.0 || >=22.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0", + "jiti": ">=1.21.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vitefu": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/vitefu/-/vitefu-1.1.1.tgz", + "integrity": "sha512-B/Fegf3i8zh0yFbpzZ21amWzHmuNlLlmJT6n7bu5e+pCHUKQIfXSYokrqOBGEMMe9UG2sostKQF9mml/vYaWJQ==", + "license": "MIT", + "workspaces": [ + "tests/deps/*", + "tests/projects/*", + "tests/projects/workspace/packages/*" + ], + "peerDependencies": { + "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0-beta.0" + }, + "peerDependenciesMeta": { + "vite": { + "optional": true + } + } + }, + "node_modules/web-namespaces": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/web-namespaces/-/web-namespaces-2.0.1.tgz", + "integrity": "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/which-pm-runs": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/which-pm-runs/-/which-pm-runs-1.1.0.tgz", + "integrity": "sha512-n1brCuqClxfFfq/Rb0ICg9giSZqCS+pLtccdag6C2HyufBrh3fBOiy9nb6ggRMvWOVH5GrdJskj5iGTZNxd7SA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/widest-line": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-5.0.0.tgz", + "integrity": "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA==", + "license": "MIT", + "dependencies": { + "string-width": "^7.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/xxhash-wasm": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/xxhash-wasm/-/xxhash-wasm-1.1.0.tgz", + "integrity": "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==", + "license": "MIT" + }, + "node_modules/yargs-parser": { + "version": "21.1.1", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", + "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/yocto-queue": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-1.2.2.tgz", + "integrity": "sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==", + "license": "MIT", + "engines": { + "node": ">=12.20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yocto-spinner": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/yocto-spinner/-/yocto-spinner-0.2.3.tgz", + "integrity": "sha512-sqBChb33loEnkoXte1bLg45bEBsOP9N1kzQh5JZNKj/0rik4zAPTNSAVPj3uQAdc6slYJ0Ksc403G2XgxsJQFQ==", + "license": "MIT", + "dependencies": { + "yoctocolors": "^2.1.1" + }, + "engines": { + "node": ">=18.19" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yoctocolors": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.1.2.tgz", + "integrity": "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/zod": { + "version": "3.25.76", + "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz", + "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } + }, + "node_modules/zod-to-json-schema": { + "version": "3.25.1", + "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.25.1.tgz", + "integrity": "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA==", + "license": "ISC", + "peerDependencies": { + "zod": "^3.25 || ^4" + } + }, + "node_modules/zod-to-ts": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/zod-to-ts/-/zod-to-ts-1.2.0.tgz", + "integrity": "sha512-x30XE43V+InwGpvTySRNz9kB7qFU8DlyEy7BsSTCHPH1R0QasMmHWZDCzYm6bVXtj/9NNJAZF3jW8rzFvH5OFA==", + "peerDependencies": { + "typescript": "^4.9.4 || ^5.0.2", + "zod": "^3" + } + }, + "node_modules/zwitch": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", + "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + } + } +} diff --git a/website/package.json b/website/package.json new file mode 100644 index 00000000..8cc55295 --- /dev/null +++ b/website/package.json @@ -0,0 +1,26 @@ +{ + "name": "awesome-copilot-website", + "version": "1.0.0", + "description": "Awesome GitHub Copilot website", + "type": "module", + "scripts": { + "dev": "astro dev", + "build": "astro build", + "preview": "astro preview", + "astro": "astro" + }, + "keywords": [ + "github", + "copilot", + "agents", + "prompts" + ], + "author": "GitHub", + "license": "MIT", + "dependencies": { + "@astrojs/sitemap": "^3.7.0", + "astro": "^5.16.15", + "choices.js": "^11.1.0", + "jszip": "^3.10.1" + } +} diff --git a/website/public/fonts/MonaspaceArgonNF-Regular.woff2 b/website/public/fonts/MonaspaceArgonNF-Regular.woff2 new file mode 100755 index 00000000..1a3e12e5 Binary files /dev/null and b/website/public/fonts/MonaspaceArgonNF-Regular.woff2 differ diff --git a/website/public/images/Copilot_Icon_Black.svg b/website/public/images/Copilot_Icon_Black.svg new file mode 100755 index 00000000..300c0caa --- /dev/null +++ b/website/public/images/Copilot_Icon_Black.svg @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + + diff --git a/website/public/images/Copilot_Icon_White.svg b/website/public/images/Copilot_Icon_White.svg new file mode 100755 index 00000000..0411bb16 --- /dev/null +++ b/website/public/images/Copilot_Icon_White.svg @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + + diff --git a/website/public/styles/global.css b/website/public/styles/global.css new file mode 100644 index 00000000..55d6244a --- /dev/null +++ b/website/public/styles/global.css @@ -0,0 +1,1587 @@ +/* CSS Variables and Base Styles */ +/* GitHub Copilot Brand Colors: + Purple 1: #C898FD Purple 2: #B870FF Purple 3: #8534F3 (Primary) + Purple 4: #43179E Purple 5: #26115F Purple 6: #160048 + Orange 1: #F4A876 Orange 2: #F08A3A Orange 3: #FE4C25 + Orange 4: #C53211 Orange 5: #801E0F Orange 6: #500A00 +*/ + +/* Nerd Fonts for programming language icons */ +@font-face { + font-family: 'Monaspace Argon NF'; + src: url('/fonts/MonaspaceArgonNF-Regular.woff2') format('woff2'); + font-weight: 400; + font-style: normal; + font-display: swap; +} + +:root { + /* Dark theme (default) */ + --color-bg: #0d0d12; + --color-bg-secondary: #14141c; + --color-bg-tertiary: #1c1c28; + --color-border: #2d2d3d; + --color-text: #e4e4ec; + --color-text-muted: #9090a8; + --color-text-emphasis: #ffffff; + --color-text-primary: var(--color-text); + --color-text-secondary: var(--color-text-muted); + --color-bg-primary: var(--color-bg); + --color-primary: var(--color-accent); + --color-purple-light: #C898FD; + --color-purple-dark: #43179E; + --color-link: #B870FF; + --color-link-hover: #C898FD; + --color-accent: #8534F3; + --color-accent-hover: #B870FF; + --color-accent-secondary: #FE4C25; + --color-danger: #C53211; + --color-warning: #F08A3A; + --color-success: #10b981; + --color-error: #C53211; + --color-card-bg: rgba(20, 20, 28, 0.8); + --color-card-hover: rgba(28, 28, 40, 0.9); + --color-glass: rgba(255, 255, 255, 0.05); + --color-glass-border: rgba(255, 255, 255, 0.1); + --gradient-primary: linear-gradient(180deg, #8534F3 0%, #B870FF 50%, #FE4C25 100%); + --gradient-accent: linear-gradient(135deg, #43179E 0%, #8534F3 100%); + --gradient-hero: radial-gradient(ellipse 80% 50% at 50% -20%, rgba(133, 52, 243, 0.25), transparent), + radial-gradient(ellipse 60% 40% at 80% 50%, rgba(254, 76, 37, 0.12), transparent), + radial-gradient(ellipse 60% 40% at 20% 50%, rgba(184, 112, 255, 0.12), transparent); + --border-radius: 8px; + --border-radius-lg: 16px; + --border-radius-xl: 24px; + --shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.2), 0 2px 4px -2px rgba(0, 0, 0, 0.2); + --shadow-md: 0 12px 24px -10px rgba(0, 0, 0, 0.4); + --shadow-lg: 0 20px 40px -12px rgba(0, 0, 0, 0.5); + --shadow-glow: 0 0 40px -10px rgba(133, 52, 243, 0.5); + --transition: 0.2s cubic-bezier(0.4, 0, 0.2, 1); + --transition-slow: 0.4s cubic-bezier(0.4, 0, 0.2, 1); + --container-width: 1200px; + --header-height: 72px; + --font-mono: 'Monaspace Argon NF', 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace; +} + +/* Light theme */ +[data-theme="light"] { + --color-bg: #fafafa; + --color-bg-secondary: #ffffff; + --color-bg-tertiary: #f5f5f7; + --color-border: #e4e4e7; + --color-text: #3f3f46; + --color-text-muted: #71717a; + --color-text-emphasis: #18181b; + --color-link: #8534F3; + --color-link-hover: #43179E; + --color-card-bg: rgba(255, 255, 255, 0.9); + --color-card-hover: rgba(255, 255, 255, 1); + --color-glass: rgba(255, 255, 255, 0.7); + --color-glass-border: rgba(0, 0, 0, 0.08); + --gradient-hero: radial-gradient(ellipse 80% 50% at 50% -20%, rgba(133, 52, 243, 0.12), transparent), + radial-gradient(ellipse 60% 40% at 80% 50%, rgba(254, 76, 37, 0.06), transparent), + radial-gradient(ellipse 60% 40% at 20% 50%, rgba(184, 112, 255, 0.06), transparent); + --shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.08), 0 2px 4px -2px rgba(0, 0, 0, 0.06); + --shadow-lg: 0 20px 40px -12px rgba(0, 0, 0, 0.15); + --shadow-glow: 0 0 40px -10px rgba(133, 52, 243, 0.3); +} + +/* Auto theme based on system preference */ +@media (prefers-color-scheme: light) { + :root:not([data-theme="dark"]) { + --color-bg: #fafafa; + --color-bg-secondary: #ffffff; + --color-bg-tertiary: #f5f5f7; + --color-border: #e4e4e7; + --color-text: #3f3f46; + --color-text-muted: #71717a; + --color-text-emphasis: #18181b; + --color-link: #8534F3; + --color-link-hover: #43179E; + --color-card-bg: rgba(255, 255, 255, 0.9); + --color-card-hover: rgba(255, 255, 255, 1); + --color-glass: rgba(255, 255, 255, 0.7); + --color-glass-border: rgba(0, 0, 0, 0.08); + --gradient-hero: radial-gradient(ellipse 80% 50% at 50% -20%, rgba(133, 52, 243, 0.12), transparent), + radial-gradient(ellipse 60% 40% at 80% 50%, rgba(254, 76, 37, 0.06), transparent), + radial-gradient(ellipse 60% 40% at 20% 50%, rgba(184, 112, 255, 0.06), transparent); + --shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.08), 0 2px 4px -2px rgba(0, 0, 0, 0.06); + --shadow-lg: 0 20px 40px -12px rgba(0, 0, 0, 0.15); + --shadow-glow: 0 0 40px -10px rgba(133, 52, 243, 0.3); + } +} + +* { + box-sizing: border-box; + margin: 0; + padding: 0; +} + +html { + scroll-behavior: smooth; +} + +body { + font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif; + background-color: var(--color-bg); + color: var(--color-text); + line-height: 1.6; + min-height: 100vh; +} + +/* Accessibility Utilities */ +.sr-only { + position: absolute; + width: 1px; + height: 1px; + padding: 0; + margin: -1px; + overflow: hidden; + clip: rect(0, 0, 0, 0); + white-space: nowrap; + border: 0; +} + +.skip-link { + position: absolute; + top: -100%; + left: 50%; + transform: translateX(-50%); + background: var(--color-accent); + color: var(--color-text-emphasis); + padding: 12px 24px; + border-radius: var(--border-radius); + font-weight: 600; + z-index: 10000; + transition: top var(--transition); +} + +.skip-link:focus { + top: 12px; + outline: 2px solid var(--color-text-emphasis); + outline-offset: 2px; +} + +.container { + max-width: var(--container-width); + margin: 0 auto; + padding: 0 24px; +} + +a { + color: var(--color-link); + text-decoration: none; + transition: color var(--transition); +} + +a:hover { + color: var(--color-link-hover); +} + +/* Header */ +.site-header { + background: var(--color-glass); + backdrop-filter: blur(20px); + -webkit-backdrop-filter: blur(20px); + border-bottom: 1px solid var(--color-glass-border); + position: sticky; + top: 0; + z-index: 100; + height: var(--header-height); +} + +.header-content { + display: flex; + align-items: center; + justify-content: space-between; + height: var(--header-height); +} + +.logo { + display: flex; + align-items: center; + gap: 10px; + font-weight: 700; + font-size: 20px; + color: var(--color-text-emphasis); + transition: all var(--transition); +} + +.logo:hover { + color: var(--color-text-emphasis); + transform: scale(1.02); +} + +.logo-icon { + width: 32px; + height: 32px; +} + +/* Show white logo by default (dark theme) */ +.logo-icon-light { + display: none; +} + +.logo-icon-dark { + display: block; +} + +/* Light theme: show black logo */ +[data-theme="light"] .logo-icon-light { + display: block; +} + +[data-theme="light"] .logo-icon-dark { + display: none; +} + +/* Auto theme based on system preference */ +@media (prefers-color-scheme: light) { + :root:not([data-theme="dark"]) .logo-icon-light { + display: block; + } + + :root:not([data-theme="dark"]) .logo-icon-dark { + display: none; + } +} + +.main-nav { + display: flex; + gap: 8px; +} + +.main-nav a { + color: var(--color-text-muted); + font-size: 14px; + font-weight: 500; + padding: 8px 14px; + border-radius: var(--border-radius); + transition: all var(--transition); +} + +.main-nav a:hover, +.main-nav a.active { + color: var(--color-text-emphasis); + background: var(--color-bg-tertiary); +} + +.github-link { + color: var(--color-text); + display: flex; + align-items: center; +} + +.github-link:hover { + color: var(--color-text-emphasis); +} + +/* Theme Toggle */ +.header-actions { + display: flex; + align-items: center; + gap: 16px; +} + +.theme-toggle { + background: none; + border: none; + cursor: pointer; + padding: 8px; + border-radius: var(--border-radius); + color: var(--color-text); + display: flex; + align-items: center; + justify-content: center; + transition: all var(--transition); +} + +.theme-toggle:hover { + background-color: var(--color-bg-tertiary); + color: var(--color-text-emphasis); +} + +.theme-toggle svg { + width: 20px; + height: 20px; +} + +.theme-toggle .icon-sun, +.theme-toggle .icon-moon { + display: none; +} + +/* Show sun icon in dark mode (click to switch to light) */ +:root:not([data-theme="light"]) .theme-toggle .icon-sun { + display: block; +} + +:root:not([data-theme="light"]) .theme-toggle .icon-moon { + display: none; +} + +/* Show moon icon in light mode (click to switch to dark) */ +[data-theme="light"] .theme-toggle .icon-sun { + display: none; +} + +[data-theme="light"] .theme-toggle .icon-moon { + display: block; +} + +/* Handle auto mode with prefers-color-scheme */ +@media (prefers-color-scheme: light) { + :root:not([data-theme="dark"]):not([data-theme="light"]) .theme-toggle .icon-sun { + display: none; + } + :root:not([data-theme="dark"]):not([data-theme="light"]) .theme-toggle .icon-moon { + display: block; + } +} + +/* Hero Section */ +.hero { + background: var(--gradient-hero), var(--color-bg); + padding: 50px 0 20px; + text-align: center; + position: relative; +} + +.hero::before { + content: ''; + position: absolute; + top: 0; + left: 0; + right: 0; + bottom: 0; + background: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cg fill='none' fill-rule='evenodd'%3E%3Cg fill='%239C92AC' fill-opacity='0.03'%3E%3Cpath d='M36 34v-4h-2v4h-4v2h4v4h2v-4h4v-2h-4zm0-30V0h-2v4h-4v2h4v4h2V6h4V4h-4zM6 34v-4H4v4H0v2h4v4h2v-4h4v-2H6zM6 4V0H4v4H0v2h4v4h2V6h4V4H6z'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E"); + pointer-events: none; +} + +.hero h1 { + font-size: 56px; + font-weight: 800; + letter-spacing: -0.02em; + background: var(--gradient-primary); + -webkit-background-clip: text; + -webkit-text-fill-color: transparent; + background-clip: text; + margin-bottom: 20px; + position: relative; +} + +.hero-subtitle { + font-size: 20px; + color: var(--color-text-muted); + max-width: 650px; + margin: 0 auto 40px; + line-height: 1.7; +} + +.hero-search { + max-width: 560px; + margin: 0 auto; + position: relative; + z-index: 100; +} + +.hero-search input { + width: 100%; + padding: 18px 24px; + font-size: 16px; + background: var(--color-glass); + backdrop-filter: blur(10px); + -webkit-backdrop-filter: blur(10px); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-xl); + color: var(--color-text); + transition: all var(--transition); + box-shadow: var(--shadow); +} + +.hero-search input:focus { + outline: 2px solid var(--color-accent); + outline-offset: 2px; + border-color: var(--color-accent); + box-shadow: var(--shadow-glow); +} + +.hero-search input::placeholder { + color: var(--color-text-muted); +} + +/* Search Results Dropdown */ +.search-results { + position: absolute; + top: 100%; + left: 0; + right: 0; + background: var(--color-bg-secondary); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-lg); + margin-top: 12px; + max-height: 450px; + overflow-y: auto; + box-shadow: var(--shadow-lg); + z-index: 1000; +} + +.search-results.hidden { + display: none; +} + +.search-result, +.search-result-item { + display: flex; + align-items: flex-start; + gap: 14px; + padding: 14px 18px; + cursor: pointer; + border-bottom: 1px solid var(--color-glass-border); + transition: all var(--transition); + text-align: left; +} + +.search-result:last-child, +.search-result-item:last-child { + border-bottom: none; +} + +.search-result:hover, +.search-result-item:hover { + background: var(--color-bg-tertiary); +} + +.search-result-type { + font-size: 20px; + flex-shrink: 0; + width: 36px; + height: 36px; + display: flex; + align-items: center; + justify-content: center; + background: var(--color-bg-tertiary); + border-radius: var(--border-radius); +} + +.search-result-title { + font-weight: 600; + font-size: 15px; + color: var(--color-text-emphasis); + margin-bottom: 4px; +} + +.search-result-title mark { + background: linear-gradient(135deg, rgba(99, 102, 241, 0.3), rgba(236, 72, 153, 0.3)); + color: inherit; + padding: 0 2px; + border-radius: 2px; +} + +.search-result-description { + font-size: 13px; + color: var(--color-text-muted); + line-height: 1.5; +} + +.search-result-empty { + padding: 20px; + text-align: center; + color: var(--color-text-muted); + font-size: 14px; +} + +/* Cards Grid */ +.cards-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); + gap: 24px; +} + +.card { + background: var(--color-card-bg); + backdrop-filter: blur(10px); + -webkit-backdrop-filter: blur(10px); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-lg); + padding: 28px; + transition: all var(--transition); + display: block; + color: inherit; + position: relative; + overflow: hidden; +} + +.card-with-count { + display: flex; + align-items: flex-start; + gap: 16px; +} + +.card-with-count .card-icon { + flex-shrink: 0; + margin-bottom: 0; +} + +.card-with-count .card-content { + flex: 1; + min-width: 0; +} + +.card-with-count h3 { + margin-bottom: 6px; +} + +.card-count { + flex-shrink: 0; + font-size: 28px; + font-weight: 700; + background: var(--gradient-primary); + -webkit-background-clip: text; + -webkit-text-fill-color: transparent; + background-clip: text; + line-height: 1; + min-width: 40px; + text-align: right; +} + +.card::before { + content: ''; + position: absolute; + top: 0; + left: 0; + right: 0; + height: 3px; + background: var(--gradient-primary); + opacity: 0; + transition: opacity var(--transition); +} + +.card:hover { + background: var(--color-card-hover); + border-color: transparent; + transform: translateY(-4px); + box-shadow: var(--shadow-lg), var(--shadow-glow); +} + +.card:hover::before { + opacity: 1; +} + +.card-icon { + font-size: 40px; + margin-bottom: 16px; + display: inline-block; + transition: transform var(--transition); +} + +.card:hover .card-icon { + transform: scale(1.1); +} + +.card h3 { + font-size: 20px; + font-weight: 700; + color: var(--color-text-emphasis); + margin-bottom: 10px; +} + +.card p { + font-size: 15px; + color: var(--color-text-muted); + line-height: 1.6; +} + +/* Quick Links Section */ +.quick-links { + padding: 80px 0; +} + +/* Featured Section */ +.featured { + padding: 80px 0; + background: var(--color-bg-secondary); + position: relative; +} + +.featured h2 { + font-size: 32px; + font-weight: 800; + color: var(--color-text-emphasis); + margin-bottom: 40px; + text-align: center; +} + +/* Getting Started */ +.getting-started { + padding: 100px 0; + background: var(--gradient-hero), var(--color-bg); +} + +.getting-started h2 { + font-size: 32px; + font-weight: 800; + color: var(--color-text-emphasis); + margin-bottom: 48px; + text-align: center; +} + +.steps { + display: grid; + grid-template-columns: repeat(3, 1fr); + gap: 48px; + max-width: 900px; + margin: 0 auto; +} + +.step { + text-align: center; + position: relative; +} + +.step-number { + width: 64px; + height: 64px; + background: var(--gradient-primary); + color: white; + border-radius: 50%; + display: flex; + align-items: center; + justify-content: center; + font-size: 24px; + font-weight: 800; + margin: 0 auto 20px; + box-shadow: var(--shadow-glow); +} + +.step h3 { + font-size: 20px; + font-weight: 700; + color: var(--color-text-emphasis); + margin-bottom: 10px; +} + +.step p { + font-size: 15px; + color: var(--color-text-muted); + line-height: 1.6; +} + +/* Footer */ +.site-footer { + background: var(--color-bg-secondary); + border-top: 1px solid var(--color-glass-border); + padding: 32px 0; + text-align: center; +} + +.site-footer p { + font-size: 14px; + color: var(--color-text-muted); +} + +.site-footer a { + color: var(--color-text-muted); + transition: color var(--transition); +} + +.site-footer a:hover { + color: var(--color-accent); +} + +.site-footer .build-info { + margin-top: 8px; + font-size: 12px; + opacity: 0.7; +} + +/* Buttons */ +.btn { + display: inline-flex; + align-items: center; + gap: 8px; + padding: 10px 18px; + font-size: 14px; + font-weight: 500; + border-radius: var(--border-radius); + border: 1px solid transparent; + cursor: pointer; + transition: all var(--transition); + text-decoration: none; +} + +.btn:focus { + outline: 2px solid var(--color-accent); + outline-offset: 2px; +} + +.btn:focus:not(:focus-visible) { + outline: none; +} + +.btn:focus-visible { + outline: 2px solid var(--color-accent); + outline-offset: 2px; +} + +.btn-primary { + background: var(--color-accent); + color: white; + border-color: transparent; + font-weight: 600; +} + +.btn-primary:hover { + background: var(--color-accent-hover); + transform: translateY(-1px); + box-shadow: var(--shadow-glow); + color: white; +} + +.btn-secondary { + background: var(--color-glass); + backdrop-filter: blur(10px); + color: var(--color-text); + border-color: var(--color-glass-border); +} + +.btn-secondary:hover { + background: var(--color-bg-tertiary); + border-color: var(--color-border); +} + +.btn-outline { + background: transparent; + color: var(--color-text); + border-color: var(--color-border); +} + +.btn-outline:hover { + background: var(--color-bg-tertiary); + border-color: var(--color-link); +} + +.btn-icon { + padding: 8px; + background: transparent; + border: none; + color: var(--color-text-muted); +} + +.btn-icon:hover { + color: var(--color-text); +} + +/* Split Button Dropdown */ +.install-dropdown { + position: relative; + display: inline-flex; +} + +.install-dropdown .install-btn-main { + border-top-right-radius: 0; + border-bottom-right-radius: 0; + border-right: 1px solid rgba(255, 255, 255, 0.2); +} + +.install-dropdown .install-btn-toggle { + border-top-left-radius: 0; + border-bottom-left-radius: 0; + padding: 10px 10px; + min-width: auto; +} + +.install-dropdown .install-btn-toggle svg { + transition: transform var(--transition); +} + +.install-dropdown.open .install-btn-toggle svg { + transform: rotate(180deg); +} + +.install-dropdown-menu { + position: absolute; + top: 100%; + right: 0; + margin-top: 4px; + min-width: 160px; + background: var(--color-bg-secondary); + border: 1px solid var(--color-border); + border-radius: var(--border-radius); + box-shadow: var(--shadow-md); + z-index: 1000; + opacity: 0; + visibility: hidden; + transform: translateY(-8px); + transition: all var(--transition); +} + +.install-dropdown.open .install-dropdown-menu { + opacity: 1; + visibility: visible; + transform: translateY(0); +} + +.install-dropdown-menu a { + display: flex; + align-items: center; + gap: 10px; + padding: 10px 14px; + color: var(--color-text); + text-decoration: none; + font-size: 14px; + transition: background var(--transition); +} + +.install-dropdown-menu a:first-child { + border-radius: var(--border-radius) var(--border-radius) 0 0; +} + +.install-dropdown-menu a:last-child { + border-radius: 0 0 var(--border-radius) var(--border-radius); +} + +.install-dropdown-menu a:hover { + background: var(--color-bg-tertiary); +} + +.install-dropdown-menu svg { + width: 16px; + height: 16px; + flex-shrink: 0; +} + +/* Small variant for list items */ +.install-dropdown.install-dropdown-small .install-btn-main { + padding: 8px 12px; + font-size: 13px; +} + +.install-dropdown.install-dropdown-small .install-btn-toggle { + padding: 8px 8px; +} + +.install-dropdown-menu .dropdown-divider { + height: 1px; + background: var(--color-border); + margin: 4px 0; +} + +/* Spinner animation */ +@keyframes spin { + from { + transform: rotate(0deg); + } + to { + transform: rotate(360deg); + } +} + +.spinner { + animation: spin 1s linear infinite; +} + +/* Button states */ +.btn:disabled { + opacity: 0.7; + cursor: not-allowed; +} + +/* Modal */ +.modal { + position: fixed; + top: 0; + left: 0; + right: 0; + bottom: 0; + background-color: rgba(0, 0, 0, 0.8); + backdrop-filter: blur(8px); + -webkit-backdrop-filter: blur(8px); + display: flex; + align-items: center; + justify-content: center; + z-index: 1000; + padding: 24px; +} + +.modal.hidden { + display: none; +} + +.modal-content { + background: var(--color-bg-secondary); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-xl); + width: 100%; + max-width: 900px; + max-height: 90vh; + display: flex; + flex-direction: column; + box-shadow: var(--shadow-lg); + overflow: hidden; +} + +.modal-header { + display: flex; + align-items: center; + justify-content: space-between; + padding: 20px 24px; + border-bottom: 1px solid var(--color-glass-border); + background: var(--color-glass); +} + +.modal-header h3 { + font-size: 16px; + font-weight: 600; + color: var(--color-text-emphasis); + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} + +.modal-actions { + display: flex; + gap: 8px; +} + +.modal-body { + flex: 1; + overflow: auto; + padding: 0; +} + +.modal-body pre { + margin: 0; + padding: 24px; + font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace; + font-size: 13px; + line-height: 1.6; + white-space: pre-wrap; + word-wrap: break-word; + background: var(--color-bg); + color: var(--color-text); + min-height: 200px; +} + +/* Collection Modal View */ +.collection-view { + padding: 20px 24px; +} + +.collection-description { + font-size: 14px; + color: var(--color-text); + margin-bottom: 16px; + line-height: 1.5; +} + +.collection-tags { + display: flex; + flex-wrap: wrap; + gap: 6px; + margin-bottom: 16px; +} + +.collection-items-header { + padding: 10px 0; + border-bottom: 1px solid var(--color-border); + margin-bottom: 8px; + color: var(--color-text-muted); + font-size: 13px; +} + +.collection-items-list { + display: flex; + flex-direction: column; + gap: 2px; +} + +.collection-item { + display: flex; + align-items: center; + gap: 10px; + padding: 10px 12px; + background: var(--color-bg); + border: 1px solid var(--color-border); + border-radius: var(--border-radius); + cursor: pointer; + transition: all var(--transition); +} + +.collection-item:hover { + background: var(--color-bg-tertiary); + border-color: var(--color-accent); +} + +.collection-item-icon { + font-size: 16px; + flex-shrink: 0; + width: 20px; + text-align: center; +} + +.collection-item-info { + flex: 1; + min-width: 0; +} + +.collection-item-name { + font-size: 13px; + font-weight: 500; + color: var(--color-text); + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} + +.collection-item-usage { + font-size: 12px; + color: var(--color-text-muted); + margin-top: 2px; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} + +.collection-item-type { + font-size: 11px; + color: var(--color-text-muted); + background: var(--color-bg-tertiary); + padding: 2px 6px; + border-radius: 4px; + flex-shrink: 0; + text-transform: capitalize; +} + +.collection-loading, +.collection-error { + padding: 40px; + text-align: center; + color: var(--color-text-muted); +} + +.collection-error { + color: var(--color-error); +} + +/* Page Layouts */ +.page-header { + padding: 56px 0 40px; + background: var(--gradient-hero), var(--color-bg); + border-bottom: 1px solid var(--color-glass-border); +} + +.page-header h1 { + font-size: 36px; + font-weight: 800; + color: var(--color-text); + margin-bottom: 12px; +} + +.page-header p { + font-size: 17px; + color: var(--color-text-muted); +} + +.page-content { + padding: 40px 0 80px; +} + +/* Search and Filter Bar */ +.search-bar { + display: flex; + gap: 16px; + margin-bottom: 24px; + flex-wrap: wrap; +} + +.search-bar input { + flex: 1; + min-width: 250px; + padding: 14px 18px; + font-size: 15px; + background: var(--color-glass); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-lg); + color: var(--color-text); + transition: all var(--transition); +} + +.search-bar input:focus { + outline: 2px solid var(--color-accent); + outline-offset: 2px; + border-color: var(--color-accent); + box-shadow: var(--shadow-glow); +} + +/* Filters Bar */ +.filters-bar { + display: flex; + gap: 16px; + margin-bottom: 24px; + flex-wrap: wrap; + align-items: center; + padding: 18px 20px; + background: var(--color-glass); + backdrop-filter: blur(10px); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-lg); + position: relative; + z-index: 10; +} + +.filter-group { + display: flex; + align-items: center; + gap: 10px; +} + +.filter-group label { + font-size: 13px; + font-weight: 500; + color: var(--color-text-muted); + white-space: nowrap; +} + +.filter-group select { + padding: 8px 14px; + font-size: 13px; + background: var(--color-bg); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius); + color: var(--color-text); + min-width: 150px; + cursor: pointer; +} + +.filter-group select:focus { + outline: 2px solid var(--color-accent); + outline-offset: 2px; + border-color: var(--color-accent); +} + +.checkbox-label { + display: flex; + align-items: center; + gap: 8px; + cursor: pointer; + user-select: none; + font-size: 13px; + font-weight: 500; + color: var(--color-text-muted); +} + +.checkbox-label input[type="checkbox"] { + width: 18px; + height: 18px; + cursor: pointer; + accent-color: var(--color-accent); +} + +.btn-small { + padding: 8px 14px; + font-size: 13px; +} + +/* Choices.js Theme Overrides */ +.filter-group .choices { + min-width: 200px; +} + +.choices { + margin-bottom: 0; +} + +.choices__inner { + background-color: var(--color-bg); + border-color: var(--color-border); + border-radius: var(--border-radius); + min-height: 42px; + padding: 6px 10px; + font-size: 14px; +} + +.choices__input { + background-color: transparent; + color: var(--color-text); + font-size: 14px; + padding: 4px 0; +} + +.choices__input::placeholder { + color: var(--color-text-muted); +} + +.choices__list--dropdown, +.choices__list[aria-expanded] { + background-color: var(--color-bg-secondary) !important; + border-color: var(--color-border) !important; + border-radius: 0 0 var(--border-radius) var(--border-radius); + z-index: 100; + max-height: 300px; +} + +.choices__list--dropdown .choices__item, +.choices__list[aria-expanded] .choices__item { + color: var(--color-text) !important; + font-size: 14px; + padding: 10px 14px; +} + +.choices__list--dropdown .choices__item--selectable.is-highlighted, +.choices__list[aria-expanded] .choices__item--selectable.is-highlighted { + background-color: var(--color-bg-tertiary) !important; +} + +.choices__list--multiple .choices__item { + background-color: var(--color-link); + border-color: var(--color-link); + border-radius: 4px; + color: white; + font-size: 13px; + padding: 4px 10px; + margin: 2px; +} + +.choices__list--multiple .choices__item .choices__button { + border-left-color: rgba(255,255,255,0.3); + padding-left: 8px; + margin-left: 6px; +} + +.choices__placeholder { + color: var(--color-text-muted); + opacity: 1; +} + +.choices[data-type*="select-multiple"] .choices__inner, +.choices[data-type*="text"] .choices__inner { + cursor: text; +} + +.is-open .choices__inner { + border-color: var(--color-link); + border-radius: var(--border-radius) var(--border-radius) 0 0; +} + +.is-open .choices__list--dropdown, +.is-open .choices__list[aria-expanded] { + border-color: var(--color-link); +} + +.choices__list--dropdown .choices__item--selectable::after, +.choices__list[aria-expanded] .choices__item--selectable::after { + display: none; +} + +/* Tag variants */ +.tag-model { + background: linear-gradient(135deg, rgba(99, 102, 241, 0.2), rgba(139, 92, 246, 0.2)); + color: #a5b4fc; +} + +.tag-none { + background-color: var(--color-bg-tertiary); + color: var(--color-text-muted); + font-style: italic; +} + +.tag-handoffs { + background: linear-gradient(135deg, rgba(245, 158, 11, 0.2), rgba(251, 191, 36, 0.2)); + color: #fcd34d; +} + +.tag-extension { + background: linear-gradient(135deg, rgba(16, 185, 129, 0.2), rgba(52, 211, 153, 0.2)); + color: #6ee7b7; +} + +.tag-category { + background: linear-gradient(135deg, rgba(236, 72, 153, 0.2), rgba(244, 114, 182, 0.2)); + color: #f9a8d4; +} + +.tag-assets { + background: linear-gradient(135deg, rgba(6, 182, 212, 0.2), rgba(34, 211, 238, 0.2)); + color: #67e8f9; +} + +.tag-collection { + background: linear-gradient(135deg, rgba(245, 158, 11, 0.2), rgba(251, 191, 36, 0.2)); + color: #fcd34d; +} + +.tag-featured { + background: var(--gradient-primary); + color: white; + padding: 3px 10px; + border-radius: 12px; + font-size: 12px; + font-weight: 600; +} + +.results-count { + font-size: 14px; + color: var(--color-text-muted); + margin-bottom: 20px; + font-weight: 500; +} + +/* Resource List */ +.resource-list { + display: flex; + flex-direction: column; + gap: 16px; +} + +.resource-item { + background: var(--color-card-bg); + backdrop-filter: blur(10px); + border: 1px solid var(--color-glass-border); + border-radius: var(--border-radius-lg); + padding: 20px 24px; + display: flex; + align-items: flex-start; + justify-content: space-between; + gap: 20px; + transition: all var(--transition); + cursor: pointer; + position: relative; +} + +.resource-item::before { + content: ''; + position: absolute; + top: 0; + left: 0; + width: 4px; + height: 100%; + background: var(--gradient-primary); + border-radius: var(--border-radius-lg) 0 0 var(--border-radius-lg); + opacity: 0; + transition: opacity var(--transition); +} + +.resource-item:hover { + background: var(--color-card-hover); + transform: translateX(4px); + box-shadow: var(--shadow); +} + +.resource-item:hover::before { + opacity: 1; +} + +.resource-info { + flex: 1; + min-width: 0; +} + +.resource-title { + font-size: 16px; + font-weight: 600; + color: var(--color-text-emphasis); + margin-bottom: 4px; +} + +.resource-description { + font-size: 14px; + color: var(--color-text-muted); + overflow: hidden; + text-overflow: ellipsis; + display: -webkit-box; + -webkit-line-clamp: 2; + line-clamp: 2; + -webkit-box-orient: vertical; +} + +.resource-meta { + display: flex; + gap: 8px; + margin-top: 8px; + flex-wrap: wrap; +} + +.resource-tag { + font-size: 12px; + padding: 2px 8px; + background-color: var(--color-bg-tertiary); + border-radius: 12px; + color: var(--color-text-muted); +} + +.resource-actions { + display: flex; + gap: 8px; + flex-shrink: 0; +} + +/* Collection Items */ +.collection-items { + margin-top: 12px; + padding-top: 12px; + border-top: 1px solid var(--color-border); +} + +.collection-item { + display: flex; + align-items: center; + gap: 8px; + padding: 8px 0; + font-size: 13px; + color: var(--color-text-muted); +} + +.collection-item-kind { + font-size: 11px; + padding: 2px 6px; + background-color: var(--color-bg-tertiary); + border-radius: 4px; + text-transform: capitalize; +} + +/* Empty State */ +.empty-state { + text-align: center; + padding: 60px 20px; + color: var(--color-text-muted); +} + +.empty-state h3 { + font-size: 18px; + color: var(--color-text); + margin-bottom: 8px; +} + +/* Loading State */ +.loading { + display: flex; + align-items: center; + justify-content: center; + padding: 60px 20px; + color: var(--color-text-muted); +} + +/* Toast Notifications */ +.toast { + position: fixed; + bottom: 24px; + right: 24px; + padding: 12px 20px; + background-color: var(--color-success); + color: white; + border-radius: var(--border-radius); + font-size: 14px; + font-weight: 500; + z-index: 1100; + animation: slideIn 0.3s ease; +} + +.toast.error { + background-color: var(--color-danger); +} + +@keyframes slideIn { + from { + transform: translateY(100%); + opacity: 0; + } + to { + transform: translateY(0); + opacity: 1; + } +} + +/* Responsive */ +@media (max-width: 768px) { + .main-nav { + display: none; + } + + .hero h1 { + font-size: 32px; + } + + .hero-subtitle { + font-size: 16px; + } + + .steps { + grid-template-columns: 1fr; + gap: 32px; + } + + .cards-grid { + grid-template-columns: 1fr; + } + + .card-with-count { + flex-wrap: wrap; + } + + .card-count { + position: absolute; + top: 20px; + right: 20px; + } + + .resource-item { + flex-direction: column; + align-items: stretch; + } + + .resource-actions { + justify-content: flex-end; + } +} + +/* Placeholder sections */ +.placeholder-section { + text-align: center; + padding: 80px 20px; + background-color: var(--color-bg-secondary); + border: 2px dashed var(--color-border); + border-radius: var(--border-radius-lg); + margin: 20px 0; +} + +.placeholder-section h3 { + font-size: 24px; + color: var(--color-text-emphasis); + margin-bottom: 12px; +} + +.placeholder-section p { + color: var(--color-text-muted); + max-width: 500px; + margin: 0 auto; +} + +/* Tools page specific */ +.tool-card { + display: flex; + flex-direction: column; + gap: 16px; +} + +.tool-card h3 { + display: flex; + align-items: center; + gap: 12px; +} + +.tool-status { + font-size: 12px; + padding: 4px 8px; + border-radius: 12px; + font-weight: 500; +} + +.tool-status.available { + background-color: rgba(35, 134, 54, 0.2); + color: var(--color-success); +} + +.tool-status.coming-soon { + background-color: rgba(210, 153, 34, 0.2); + color: var(--color-warning); +} diff --git a/website/src/components/Modal.astro b/website/src/components/Modal.astro new file mode 100644 index 00000000..40b283dc --- /dev/null +++ b/website/src/components/Modal.astro @@ -0,0 +1,58 @@ +--- +// Modal component for viewing file contents +--- + + diff --git a/website/src/layouts/BaseLayout.astro b/website/src/layouts/BaseLayout.astro new file mode 100644 index 00000000..74ebf201 --- /dev/null +++ b/website/src/layouts/BaseLayout.astro @@ -0,0 +1,189 @@ +--- +import { execSync } from "child_process"; + +interface Props { + title: string; + description?: string; + activeNav?: string; +} + +const { + title, + description = "Community-driven collection of custom agents, prompts, and instructions for GitHub Copilot", + activeNav = "", +} = Astro.props; +const base = import.meta.env.BASE_URL; + +// Get git commit SHA and build date at build time +let commitSha = "unknown"; +let buildDate = new Date().toISOString().split("T")[0]; +try { + // Use GITHUB_SHA env var in GitHub Actions, fallback to git command locally + const githubSha = process.env.GITHUB_SHA; + if (githubSha) { + commitSha = githubSha.substring(0, 7); + } else { + commitSha = execSync("git rev-parse --short HEAD", { encoding: "utf-8" }).trim(); + } +} catch { + // Fallback if git is not available +} +--- + + + + + + + {title} - Awesome GitHub Copilot + + + + + + +
+
+
+ + +
+ + + + +
+
+
+
+ + + + + + + + diff --git a/website/src/pages/agents.astro b/website/src/pages/agents.astro new file mode 100644 index 00000000..172cebc3 --- /dev/null +++ b/website/src/pages/agents.astro @@ -0,0 +1,54 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; +--- + + +
+
+
+

🤖 Custom Agents

+

Specialized agents that enhance GitHub Copilot for specific technologies, workflows, and domains

+
+
+ +
+
+
+ + +
+ + +
+
+ + +
+
+ + +
+
+ +
+ +
+ +
+
+
Loading agents...
+
+
+
+
+ + + + + diff --git a/website/src/pages/collections.astro b/website/src/pages/collections.astro new file mode 100644 index 00000000..9e1c439a --- /dev/null +++ b/website/src/pages/collections.astro @@ -0,0 +1,49 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; +--- + + +
+
+
+

📦 Collections

+

Curated collections of prompts, instructions, and agents for specific workflows

+
+
+ +
+
+
+ + +
+ +
+
+ + +
+
+ +
+ +
+ +
+
+
Loading collections...
+
+
+
+
+ + + + + diff --git a/website/src/pages/index.astro b/website/src/pages/index.astro new file mode 100644 index 00000000..64f1f0d7 --- /dev/null +++ b/website/src/pages/index.astro @@ -0,0 +1,120 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; + +const base = import.meta.env.BASE_URL; +--- + + +
+ +
+
+

Awesome GitHub Copilot

+

Community-contributed instructions, prompts, agents, and skills to enhance your GitHub Copilot experience

+
+ + + +
+
+
+ + +
+ +
+
+ + +
+

Agents

+

Custom agents for specialized Copilot experiences

+
+
-
+ + + +
+

Prompts

+

Ready-to-use prompt templates for development tasks

+
+
-
+ + + +
+

Instructions

+

Coding standards and best practices for Copilot

+
+
-
+ + + +
+

Skills

+

Self-contained folders with instructions and resources

+
+
-
+ + + +
+

Collections

+

Curated collections organized by themes

+
+
-
+ + + +
+

Tools

+

MCP servers and developer tools

+
+
-
+ +
+
+
+ + +
+
+ + +
+
+ + +
+
+

Getting Started

+
+
+ +

Browse

+

Explore agents, prompts, instructions, and skills

+
+
+ +

Preview

+

Click any item to view its full content

+
+
+ +

Install

+

One-click install to VS Code or copy to clipboard

+
+
+
+
+
+ + + + + diff --git a/website/src/pages/instructions.astro b/website/src/pages/instructions.astro new file mode 100644 index 00000000..e9b1f0d1 --- /dev/null +++ b/website/src/pages/instructions.astro @@ -0,0 +1,43 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; +--- + + +
+
+
+

📋 Instructions

+

Coding standards and best practices for GitHub Copilot

+
+
+ +
+
+
+ + +
+ +
+
+ + +
+ +
+ +
+
+
Loading instructions...
+
+
+
+
+ + + + + diff --git a/website/src/pages/llms.txt.ts b/website/src/pages/llms.txt.ts new file mode 100644 index 00000000..3cf5a9b8 --- /dev/null +++ b/website/src/pages/llms.txt.ts @@ -0,0 +1,101 @@ +import type { APIRoute } from "astro"; +import agentsData from "../../public/data/agents.json"; +import promptsData from "../../public/data/prompts.json"; +import instructionsData from "../../public/data/instructions.json"; +import skillsData from "../../public/data/skills.json"; + +// Base URL for absolute links (to raw GitHub content) +const GITHUB_RAW_BASE = "https://raw.githubusercontent.com/github/awesome-copilot/main"; + +export const GET: APIRoute = () => { + const agents = agentsData.items; + const prompts = promptsData.items; + const instructions = instructionsData.items; + const skills = skillsData.items; + + const url = (path: string) => `${GITHUB_RAW_BASE}/${path}`; + + let content = ""; + + // H1 header (required) + content += "# Awesome GitHub Copilot\n\n"; + + // Summary blockquote (optional but recommended) + content += + "> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.\n\n"; + + // Add overview section + content += "## Overview\n\n"; + content += + "This repository provides resources to customize and enhance GitHub Copilot:\n\n"; + content += + "- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers\n"; + content += + "- **Prompts**: Task-specific prompts for code generation and problem-solving\n"; + content += + "- **Instructions**: Coding standards and best practices applied to specific file patterns\n"; + content += + "- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks\n\n"; + + // Process Agents + content += "## Agents\n\n"; + for (const agent of agents) { + const description = (agent.description || "No description available") + .replace(/\s+/g, " ") + .trim(); + content += `- [${agent.title}](${url(agent.path)}): ${description}\n`; + } + content += "\n"; + + // Process Prompts + content += "## Prompts\n\n"; + for (const prompt of prompts) { + const description = (prompt.description || "No description available") + .replace(/\s+/g, " ") + .trim(); + content += `- [${prompt.title}](${url(prompt.path)}): ${description}\n`; + } + content += "\n"; + + // Process Instructions + content += "## Instructions\n\n"; + for (const instruction of instructions) { + const description = (instruction.description || "No description available") + .replace(/\s+/g, " ") + .trim(); + content += `- [${instruction.title}](${url(instruction.path)}): ${description}\n`; + } + content += "\n"; + + // Process Skills + content += "## Skills\n\n"; + for (const skill of skills) { + const description = (skill.description || "No description available") + .replace(/\s+/g, " ") + .trim(); + content += `- [${skill.title}](${url(skill.skillFile)}): ${description}\n`; + } + content += "\n"; + + // Add documentation links + content += "## Documentation\n\n"; + content += + `- [README.md](${url("README.md")}): Main documentation and getting started guide\n`; + content += + `- [CONTRIBUTING.md](${url("CONTRIBUTING.md")}): Guidelines for contributing to this repository\n`; + content += + `- [CODE_OF_CONDUCT.md](${url("CODE_OF_CONDUCT.md")}): Community standards and expectations\n`; + content += `- [SECURITY.md](${url("SECURITY.md")}): Security policies and reporting\n`; + content += + `- [AGENTS.md](${url("AGENTS.md")}): Project overview and setup commands\n\n`; + + // Add repository information + content += "## Repository\n\n"; + content += "- **GitHub**: https://github.com/github/awesome-copilot\n"; + content += "- **License**: MIT\n"; + content += "- **Website**: https://github.github.io/awesome-copilot\n"; + + return new Response(content, { + headers: { "Content-Type": "text/plain; charset=utf-8" }, + }); +}; diff --git a/website/src/pages/prompts.astro b/website/src/pages/prompts.astro new file mode 100644 index 00000000..00778338 --- /dev/null +++ b/website/src/pages/prompts.astro @@ -0,0 +1,43 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; +--- + + +
+
+
+

🎯 Prompts

+

Ready-to-use prompt templates for development tasks with GitHub Copilot

+
+
+ +
+
+
+ + +
+ +
+
+ + +
+ +
+ +
+
+
Loading prompts...
+
+
+
+
+ + + + + diff --git a/website/src/pages/samples.astro b/website/src/pages/samples.astro new file mode 100644 index 00000000..7cd17618 --- /dev/null +++ b/website/src/pages/samples.astro @@ -0,0 +1,248 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; + +const base = import.meta.env.BASE_URL; +--- + + +
+
+
+

📚 Samples & Recipes

+

Code samples, recipes, and examples for building with GitHub Copilot tools

+
+
+ +
+
+
+ + +
+ +
+
+ + +
+
+ + +
+ +
+ +
+ +
+
Loading samples...
+
+
+
+
+ + + + + + + diff --git a/website/src/pages/skills.astro b/website/src/pages/skills.astro new file mode 100644 index 00000000..af40aad1 --- /dev/null +++ b/website/src/pages/skills.astro @@ -0,0 +1,49 @@ +--- +import BaseLayout from '../layouts/BaseLayout.astro'; +import Modal from '../components/Modal.astro'; +--- + + +
+
+
+

⚡ Skills

+

Self-contained agent skills with instructions and bundled resources

+
+
+ +
+
+
+ + +
+ +
+
+ + +
+
+ +
+ +
+ +
+
+
Loading skills...
+
+
+
+
+ + + + + diff --git a/website/src/pages/tools.astro b/website/src/pages/tools.astro new file mode 100644 index 00000000..52b8fc22 --- /dev/null +++ b/website/src/pages/tools.astro @@ -0,0 +1,311 @@ +--- +import BaseLayout from "../layouts/BaseLayout.astro"; +--- + + +
+
+
+

🔧 Tools

+

MCP servers and developer tools for GitHub Copilot

+
+
+ +
+
+
+
+ + +
+
+ + + +
+
+
+ +
+ +
+

More Tools Coming Soon

+

+ We're working on additional tools to enhance your GitHub Copilot + experience. Check back soon! +

+
+
+
+
+ + + + + diff --git a/website/src/scripts/choices.ts b/website/src/scripts/choices.ts new file mode 100644 index 00000000..c63fa5de --- /dev/null +++ b/website/src/scripts/choices.ts @@ -0,0 +1,34 @@ +/** + * Choices.js wrapper with sensible defaults + */ +import Choices from 'choices.js'; +import 'choices.js/public/assets/styles/choices.min.css'; + +export type { Choices }; + +/** + * Get selected values from a Choices instance + */ +export function getChoicesValues(choices: Choices): string[] { + const val = choices.getValue(true); + return Array.isArray(val) ? val : (val ? [val] : []); +} + +/** + * Create a new Choices instance with sensible defaults + */ +export function createChoices(selector: string | HTMLSelectElement, options: Partial = {}): Choices { + return new Choices(selector, { + removeItemButton: true, + searchPlaceholderValue: 'Search...', + noResultsText: 'No results found', + noChoicesText: 'No options available', + itemSelectText: '', + shouldSort: false, + searchResultLimit: 100, + resetScrollPosition: false, + ...options, + }); +} + +export { Choices }; diff --git a/website/src/scripts/jszip.ts b/website/src/scripts/jszip.ts new file mode 100644 index 00000000..a0040227 --- /dev/null +++ b/website/src/scripts/jszip.ts @@ -0,0 +1,7 @@ +/** + * JSZip entry point for bundling + */ +import JSZip from 'jszip'; + +export { JSZip }; +export default JSZip; diff --git a/website/src/scripts/modal.ts b/website/src/scripts/modal.ts new file mode 100644 index 00000000..38c8e288 --- /dev/null +++ b/website/src/scripts/modal.ts @@ -0,0 +1,546 @@ +/** + * Modal functionality for file viewing + */ + +import { + fetchFileContent, + fetchData, + getVSCodeInstallUrl, + copyToClipboard, + showToast, + downloadFile, + shareFile, + getResourceType, + escapeHtml, + getResourceIcon, +} from "./utils"; + +// Modal state +let currentFilePath: string | null = null; +let currentFileContent: string | null = null; +let currentFileType: string | null = null; +let triggerElement: HTMLElement | null = null; + +// Collection data cache +interface CollectionItem { + path: string; + kind: string; + usage?: string | null; +} + +interface Collection { + id: string; + name: string; + description?: string; + path: string; + items: CollectionItem[]; + tags?: string[]; +} + +interface CollectionsData { + items: Collection[]; +} + +let collectionsCache: CollectionsData | null = null; + +/** + * Get all focusable elements within a container + */ +function getFocusableElements(container: HTMLElement): HTMLElement[] { + const focusableSelectors = [ + "button:not([disabled])", + "a[href]", + "input:not([disabled])", + "select:not([disabled])", + "textarea:not([disabled])", + '[tabindex]:not([tabindex="-1"])', + ].join(", "); + + return Array.from( + container.querySelectorAll(focusableSelectors) + ).filter((el) => el.offsetParent !== null); // Filter out hidden elements +} + +/** + * Handle keyboard navigation within modal (focus trap) + */ +function handleModalKeydown(e: KeyboardEvent, modal: HTMLElement): void { + if (e.key === "Tab") { + const focusableElements = getFocusableElements(modal); + if (focusableElements.length === 0) return; + + const firstElement = focusableElements[0]; + const lastElement = focusableElements[focusableElements.length - 1]; + + if (e.shiftKey) { + // Shift+Tab: if on first element, wrap to last + if (document.activeElement === firstElement) { + e.preventDefault(); + lastElement.focus(); + } + } else { + // Tab: if on last element, wrap to first + if (document.activeElement === lastElement) { + e.preventDefault(); + firstElement.focus(); + } + } + } +} + +/** + * Setup modal functionality + */ +export function setupModal(): void { + const modal = document.getElementById("file-modal"); + const closeBtn = document.getElementById("close-modal"); + const copyBtn = document.getElementById("copy-btn"); + const downloadBtn = document.getElementById("download-btn"); + const shareBtn = document.getElementById("share-btn"); + + if (!modal) return; + + closeBtn?.addEventListener("click", closeModal); + + modal.addEventListener("click", (e) => { + if (e.target === modal) closeModal(); + }); + + document.addEventListener("keydown", (e) => { + if (!modal.classList.contains("hidden")) { + if (e.key === "Escape") { + closeModal(); + } else { + handleModalKeydown(e, modal); + } + } + }); + + copyBtn?.addEventListener("click", async () => { + if (currentFileContent) { + const success = await copyToClipboard(currentFileContent); + showToast( + success ? "Copied to clipboard!" : "Failed to copy", + success ? "success" : "error" + ); + } + }); + + downloadBtn?.addEventListener("click", async () => { + if (currentFilePath) { + const success = await downloadFile(currentFilePath); + showToast( + success ? "Download started!" : "Download failed", + success ? "success" : "error" + ); + } + }); + + shareBtn?.addEventListener("click", async () => { + if (currentFilePath) { + const success = await shareFile(currentFilePath); + showToast( + success ? "Link copied to clipboard!" : "Failed to copy link", + success ? "success" : "error" + ); + } + }); + + // Setup install dropdown toggle + setupInstallDropdown("install-dropdown"); + + // Handle browser back/forward navigation + window.addEventListener("hashchange", handleHashChange); + + // Check for deep link on initial load + handleHashChange(); +} + +/** + * Handle hash changes for deep linking + */ +function handleHashChange(): void { + const hash = window.location.hash; + + if (hash && hash.startsWith("#file=")) { + const filePath = decodeURIComponent(hash.slice(6)); + if (filePath && filePath !== currentFilePath) { + const type = getResourceType(filePath); + openFileModal(filePath, type, false); // Don't update hash since we're responding to it + } + } else if (!hash || hash === "#") { + // No hash or empty hash - close modal if open + if (currentFilePath) { + closeModal(false); // Don't update hash since we're responding to it + } + } +} + +/** + * Update URL hash for deep linking + */ +function updateHash(filePath: string | null): void { + if (filePath) { + const newHash = `#file=${encodeURIComponent(filePath)}`; + if (window.location.hash !== newHash) { + history.pushState(null, "", newHash); + } + } else { + if (window.location.hash) { + history.pushState( + null, + "", + window.location.pathname + window.location.search + ); + } + } +} + +/** + * Setup install dropdown toggle functionality + */ +export function setupInstallDropdown(containerId: string): void { + const container = document.getElementById(containerId); + if (!container) return; + + const toggle = container.querySelector( + ".install-btn-toggle" + ); + const menuItems = container.querySelectorAll( + ".install-dropdown-menu a" + ); + + toggle?.addEventListener("click", (e) => { + e.preventDefault(); + e.stopPropagation(); + const isOpen = container.classList.toggle("open"); + toggle.setAttribute("aria-expanded", String(isOpen)); + + // Focus first menu item when opening + if (isOpen && menuItems.length > 0) { + menuItems[0].focus(); + } + }); + + // Keyboard navigation for dropdown + toggle?.addEventListener("keydown", (e) => { + if (e.key === "ArrowDown" || e.key === "Enter" || e.key === " ") { + e.preventDefault(); + container.classList.add("open"); + toggle.setAttribute("aria-expanded", "true"); + if (menuItems.length > 0) { + menuItems[0].focus(); + } + } + }); + + // Keyboard navigation within menu + menuItems.forEach((item, index) => { + item.addEventListener("keydown", (e) => { + switch (e.key) { + case "ArrowDown": + e.preventDefault(); + if (index < menuItems.length - 1) { + menuItems[index + 1].focus(); + } + break; + case "ArrowUp": + e.preventDefault(); + if (index > 0) { + menuItems[index - 1].focus(); + } else { + toggle?.focus(); + } + break; + case "Escape": + e.preventDefault(); + container.classList.remove("open"); + toggle?.setAttribute("aria-expanded", "false"); + toggle?.focus(); + break; + case "Tab": + // Close menu on tab out + container.classList.remove("open"); + toggle?.setAttribute("aria-expanded", "false"); + break; + } + }); + }); + + // Close dropdown when clicking outside + document.addEventListener("click", (e) => { + if (!container.contains(e.target as Node)) { + container.classList.remove("open"); + toggle?.setAttribute("aria-expanded", "false"); + } + }); + + // Close dropdown when clicking a menu item + container.querySelectorAll(".install-dropdown-menu a").forEach((link) => { + link.addEventListener("click", () => { + container.classList.remove("open"); + toggle?.setAttribute("aria-expanded", "false"); + }); + }); +} + +/** + * Open file viewer modal + * @param filePath - Path to the file + * @param type - Resource type (agent, prompt, instruction, etc.) + * @param updateUrl - Whether to update the URL hash (default: true) + * @param trigger - The element that triggered the modal (for focus return) + */ +export async function openFileModal( + filePath: string, + type: string, + updateUrl = true, + trigger?: HTMLElement +): Promise { + const modal = document.getElementById("file-modal"); + const title = document.getElementById("modal-title"); + const modalContent = document.getElementById("modal-content"); + const contentEl = modalContent?.querySelector("code"); + const installDropdown = document.getElementById("install-dropdown"); + const installBtnMain = document.getElementById( + "install-btn-main" + ) as HTMLAnchorElement | null; + const installVscode = document.getElementById( + "install-vscode" + ) as HTMLAnchorElement | null; + const installInsiders = document.getElementById( + "install-insiders" + ) as HTMLAnchorElement | null; + const copyBtn = document.getElementById("copy-btn"); + const downloadBtn = document.getElementById("download-btn"); + const closeBtn = document.getElementById("close-modal"); + + if (!modal || !title || !modalContent) return; + + currentFilePath = filePath; + currentFileType = type; + + // Track trigger element for focus return + triggerElement = trigger || (document.activeElement as HTMLElement); + + // Update URL for deep linking + if (updateUrl) { + updateHash(filePath); + } + + // Show modal with loading state + title.textContent = filePath.split("/").pop() || filePath; + modal.classList.remove("hidden"); + + // Set focus to close button for accessibility + setTimeout(() => { + closeBtn?.focus(); + }, 0); + + // Handle collections differently - show as item list + if (type === "collection") { + await openCollectionModal( + filePath, + title, + modalContent, + installDropdown, + copyBtn, + downloadBtn + ); + return; + } + + // Regular file modal + if (contentEl) { + contentEl.textContent = "Loading..."; + } + + // Show copy/download buttons for regular files + if (copyBtn) copyBtn.style.display = "inline-flex"; + if (downloadBtn) downloadBtn.style.display = "inline-flex"; + + // Restore pre/code structure if it was replaced by collection view + if (!modalContent.querySelector("pre")) { + modalContent.innerHTML = '
'; + } + const codeEl = modalContent.querySelector("code"); + + // Setup install dropdown + const vscodeUrl = getVSCodeInstallUrl(type, filePath, false); + const insidersUrl = getVSCodeInstallUrl(type, filePath, true); + + if (vscodeUrl && installDropdown) { + installDropdown.style.display = "inline-flex"; + installDropdown.classList.remove("open"); + if (installBtnMain) installBtnMain.href = vscodeUrl; + if (installVscode) installVscode.href = vscodeUrl; + if (installInsiders) installInsiders.href = insidersUrl || "#"; + } else if (installDropdown) { + installDropdown.style.display = "none"; + } + + // Fetch and display content + const fileContent = await fetchFileContent(filePath); + currentFileContent = fileContent; + + if (fileContent && codeEl) { + codeEl.textContent = fileContent; + } else if (codeEl) { + codeEl.textContent = + "Failed to load file content. Click the button below to view on GitHub."; + } +} + +/** + * Open collection modal with item list + */ +async function openCollectionModal( + filePath: string, + title: HTMLElement, + modalContent: HTMLElement, + installDropdown: HTMLElement | null, + copyBtn: HTMLElement | null, + downloadBtn: HTMLElement | null +): Promise { + // Hide install dropdown and copy/download for collections + if (installDropdown) installDropdown.style.display = "none"; + if (copyBtn) copyBtn.style.display = "none"; + if (downloadBtn) downloadBtn.style.display = "none"; + + // Show loading + modalContent.innerHTML = + '
Loading collection...
'; + + // Load collections data if not cached + if (!collectionsCache) { + collectionsCache = await fetchData("collections.json"); + } + + if (!collectionsCache) { + modalContent.innerHTML = + '
Failed to load collection data.
'; + return; + } + + // Find the collection + const collection = collectionsCache.items.find((c) => c.path === filePath); + if (!collection) { + modalContent.innerHTML = + '
Collection not found.
'; + return; + } + + // Update title + title.textContent = collection.name; + + // Render collection view + modalContent.innerHTML = ` +
+
${escapeHtml( + collection.description || "" + )}
+ ${ + collection.tags && collection.tags.length > 0 + ? ` +
+ ${collection.tags + .map((t) => `${escapeHtml(t)}`) + .join("")} +
+ ` + : "" + } +
+ ${collection.items.length} items in this collection +
+
+ ${collection.items + .map( + (item) => ` +
+ ${getResourceIcon( + item.kind + )} +
+
${escapeHtml( + item.path.split("/").pop() || item.path + )}
+ ${ + item.usage + ? `
${escapeHtml( + item.usage + )}
` + : "" + } +
+ ${escapeHtml(item.kind)} +
+ ` + ) + .join("")} +
+
+ `; + + // Add click handlers to collection items + modalContent.querySelectorAll(".collection-item").forEach((el) => { + el.addEventListener("click", () => { + const path = (el as HTMLElement).dataset.path; + const itemType = (el as HTMLElement).dataset.type; + if (path && itemType) { + openFileModal(path, itemType); + } + }); + }); +} + +/** + * Close modal + * @param updateUrl - Whether to update the URL hash (default: true) + */ +export function closeModal(updateUrl = true): void { + const modal = document.getElementById("file-modal"); + const installDropdown = document.getElementById("install-dropdown"); + + if (modal) { + modal.classList.add("hidden"); + } + if (installDropdown) { + installDropdown.classList.remove("open"); + } + + // Update URL for deep linking + if (updateUrl) { + updateHash(null); + } + + // Return focus to trigger element + if ( + triggerElement && + triggerElement.isConnected && + typeof triggerElement.focus === "function" + ) { + triggerElement.focus(); + } + + currentFilePath = null; + currentFileContent = null; + currentFileType = null; + triggerElement = null; +} + +/** + * Get current file path (for external use) + */ +export function getCurrentFilePath(): string | null { + return currentFilePath; +} + +/** + * Get current file content (for external use) + */ +export function getCurrentFileContent(): string | null { + return currentFileContent; +} diff --git a/website/src/scripts/pages/agents.ts b/website/src/scripts/pages/agents.ts new file mode 100644 index 00000000..5fd6f71b --- /dev/null +++ b/website/src/scripts/pages/agents.ts @@ -0,0 +1,176 @@ +/** + * Agents page functionality + */ +import { createChoices, getChoicesValues, type Choices } from '../choices'; +import { FuzzySearch, SearchItem } from '../search'; +import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers } from '../utils'; +import { setupModal, openFileModal } from '../modal'; + +interface Agent extends SearchItem { + path: string; + model?: string; + tools?: string[]; + hasHandoffs?: boolean; +} + +interface AgentsData { + items: Agent[]; + filters: { + models: string[]; + tools: string[]; + }; +} + +const resourceType = 'agent'; +let allItems: Agent[] = []; +let search = new FuzzySearch(); +let modelSelect: Choices; +let toolSelect: Choices; + +let currentFilters = { + models: [] as string[], + tools: [] as string[], + hasHandoffs: false, +}; + +function applyFiltersAndRender(): void { + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const countEl = document.getElementById('results-count'); + const query = searchInput?.value || ''; + + let results = query ? search.search(query) : [...allItems]; + + if (currentFilters.models.length > 0) { + results = results.filter(item => { + if (currentFilters.models.includes('(none)') && !item.model) { + return true; + } + return item.model && currentFilters.models.includes(item.model); + }); + } + + if (currentFilters.tools.length > 0) { + results = results.filter(item => + item.tools?.some(tool => currentFilters.tools.includes(tool)) + ); + } + + if (currentFilters.hasHandoffs) { + results = results.filter(item => item.hasHandoffs); + } + + renderItems(results, query); + + const activeFilters: string[] = []; + if (currentFilters.models.length > 0) activeFilters.push(`models: ${currentFilters.models.length}`); + if (currentFilters.tools.length > 0) activeFilters.push(`tools: ${currentFilters.tools.length}`); + if (currentFilters.hasHandoffs) activeFilters.push('has handoffs'); + + let countText = `${results.length} of ${allItems.length} agents`; + if (activeFilters.length > 0) { + countText += ` (filtered by ${activeFilters.join(', ')})`; + } + if (countEl) countEl.textContent = countText; +} + +function renderItems(items: Agent[], query = ''): void { + const list = document.getElementById('resource-list'); + if (!list) return; + + if (items.length === 0) { + list.innerHTML = ` +
+

No agents found

+

Try a different search term or adjust filters

+
+ `; + return; + } + + list.innerHTML = items.map(item => ` +
+
+
${query ? search.highlight(item.title, query) : escapeHtml(item.title)}
+
${escapeHtml(item.description || 'No description')}
+
+ ${item.model ? `${escapeHtml(item.model)}` : ''} + ${item.tools?.slice(0, 3).map(t => `${escapeHtml(t)}`).join('') || ''} + ${item.tools && item.tools.length > 3 ? `+${item.tools.length - 3} more` : ''} + ${item.hasHandoffs ? `handoffs` : ''} +
+
+
+ ${getInstallDropdownHtml(resourceType, item.path, true)} + ${getActionButtonsHtml(item.path, true)} + + GitHub + +
+
+ `).join(''); + + // Add click handlers + list.querySelectorAll('.resource-item').forEach(el => { + el.addEventListener('click', () => { + const path = (el as HTMLElement).dataset.path; + if (path) openFileModal(path, resourceType); + }); + }); +} + +export async function initAgentsPage(): Promise { + const list = document.getElementById('resource-list'); + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const handoffsCheckbox = document.getElementById('filter-handoffs') as HTMLInputElement; + const clearFiltersBtn = document.getElementById('clear-filters'); + + const data = await fetchData('agents.json'); + if (!data || !data.items) { + if (list) list.innerHTML = '

Failed to load data

'; + return; + } + + allItems = data.items; + search.setItems(allItems); + + // Initialize Choices.js for model filter + modelSelect = createChoices('#filter-model', { placeholderValue: 'All Models' }); + modelSelect.setChoices(data.filters.models.map(m => ({ value: m, label: m })), 'value', 'label', true); + document.getElementById('filter-model')?.addEventListener('change', () => { + currentFilters.models = getChoicesValues(modelSelect); + applyFiltersAndRender(); + }); + + // Initialize Choices.js for tool filter + toolSelect = createChoices('#filter-tool', { placeholderValue: 'All Tools' }); + toolSelect.setChoices(data.filters.tools.map(t => ({ value: t, label: t })), 'value', 'label', true); + document.getElementById('filter-tool')?.addEventListener('change', () => { + currentFilters.tools = getChoicesValues(toolSelect); + applyFiltersAndRender(); + }); + + applyFiltersAndRender(); + + searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200)); + + handoffsCheckbox?.addEventListener('change', () => { + currentFilters.hasHandoffs = handoffsCheckbox.checked; + applyFiltersAndRender(); + }); + + clearFiltersBtn?.addEventListener('click', () => { + currentFilters = { models: [], tools: [], hasHandoffs: false }; + modelSelect.removeActiveItems(); + toolSelect.removeActiveItems(); + if (handoffsCheckbox) handoffsCheckbox.checked = false; + if (searchInput) searchInput.value = ''; + applyFiltersAndRender(); + }); + + setupModal(); + setupDropdownCloseHandlers(); + setupActionHandlers(); +} + +// Auto-initialize when DOM is ready +document.addEventListener('DOMContentLoaded', initAgentsPage); diff --git a/website/src/scripts/pages/collections.ts b/website/src/scripts/pages/collections.ts new file mode 100644 index 00000000..3ad07f3d --- /dev/null +++ b/website/src/scripts/pages/collections.ts @@ -0,0 +1,143 @@ +/** + * Collections page functionality + */ +import { createChoices, getChoicesValues, type Choices } from '../choices'; +import { FuzzySearch, SearchItem } from '../search'; +import { fetchData, debounce, escapeHtml, getGitHubUrl } from '../utils'; +import { setupModal, openFileModal } from '../modal'; + +interface Collection extends SearchItem { + id: string; + name: string; + path: string; + tags?: string[]; + featured?: boolean; + itemCount: number; +} + +interface CollectionsData { + items: Collection[]; + filters: { + tags: string[]; + }; +} + +const resourceType = 'collection'; +let allItems: Collection[] = []; +let search = new FuzzySearch(); +let tagSelect: Choices; +let currentFilters = { + tags: [] as string[], + featured: false +}; + +function applyFiltersAndRender(): void { + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const countEl = document.getElementById('results-count'); + const query = searchInput?.value || ''; + + let results = query ? search.search(query) : [...allItems]; + + if (currentFilters.tags.length > 0) { + results = results.filter(item => item.tags?.some(tag => currentFilters.tags.includes(tag))); + } + if (currentFilters.featured) { + results = results.filter(item => item.featured); + } + + renderItems(results, query); + const activeFilters: string[] = []; + if (currentFilters.tags.length > 0) activeFilters.push(`${currentFilters.tags.length} tag${currentFilters.tags.length > 1 ? 's' : ''}`); + if (currentFilters.featured) activeFilters.push('featured'); + let countText = `${results.length} of ${allItems.length} collections`; + if (activeFilters.length > 0) { + countText += ` (filtered by ${activeFilters.join(', ')})`; + } + if (countEl) countEl.textContent = countText; +} + +function renderItems(items: Collection[], query = ''): void { + const list = document.getElementById('resource-list'); + if (!list) return; + + if (items.length === 0) { + list.innerHTML = '

No collections found

Try a different search term or adjust filters

'; + return; + } + + list.innerHTML = items.map(item => ` +
+
+
${item.featured ? '⭐ ' : ''}${query ? search.highlight(item.name, query) : escapeHtml(item.name)}
+
${escapeHtml(item.description || 'No description')}
+
+ ${item.itemCount} items + ${item.tags?.slice(0, 4).map(t => `${escapeHtml(t)}`).join('') || ''} + ${item.tags && item.tags.length > 4 ? `+${item.tags.length - 4} more` : ''} +
+
+
+ GitHub +
+
+ `).join(''); + + // Add click handlers + list.querySelectorAll('.resource-item').forEach(el => { + el.addEventListener('click', () => { + const path = (el as HTMLElement).dataset.path; + if (path) openFileModal(path, resourceType); + }); + }); +} + +export async function initCollectionsPage(): Promise { + const list = document.getElementById('resource-list'); + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const featuredCheckbox = document.getElementById('filter-featured') as HTMLInputElement; + const clearFiltersBtn = document.getElementById('clear-filters'); + + const data = await fetchData('collections.json'); + if (!data || !data.items) { + if (list) list.innerHTML = '

Failed to load data

'; + return; + } + + allItems = data.items; + + // Map collection items to search items + const searchItems = allItems.map(item => ({ + ...item, + title: item.name, + searchText: `${item.name} ${item.description} ${item.tags?.join(' ') || ''}`.toLowerCase() + })); + search.setItems(searchItems); + + tagSelect = createChoices('#filter-tag', { placeholderValue: 'All Tags' }); + tagSelect.setChoices(data.filters.tags.map(t => ({ value: t, label: t })), 'value', 'label', true); + document.getElementById('filter-tag')?.addEventListener('change', () => { + currentFilters.tags = getChoicesValues(tagSelect); + applyFiltersAndRender(); + }); + + applyFiltersAndRender(); + searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200)); + + featuredCheckbox?.addEventListener('change', () => { + currentFilters.featured = featuredCheckbox.checked; + applyFiltersAndRender(); + }); + + clearFiltersBtn?.addEventListener('click', () => { + currentFilters = { tags: [], featured: false }; + tagSelect.removeActiveItems(); + if (featuredCheckbox) featuredCheckbox.checked = false; + if (searchInput) searchInput.value = ''; + applyFiltersAndRender(); + }); + + setupModal(); +} + +// Auto-initialize when DOM is ready +document.addEventListener('DOMContentLoaded', initCollectionsPage); diff --git a/website/src/scripts/pages/index.ts b/website/src/scripts/pages/index.ts new file mode 100644 index 00000000..6fa86746 --- /dev/null +++ b/website/src/scripts/pages/index.ts @@ -0,0 +1,135 @@ +/** + * Homepage functionality + */ +import { FuzzySearch, type SearchItem } from '../search'; +import { fetchData, debounce, escapeHtml, truncate, getResourceIcon } from '../utils'; +import { setupModal, openFileModal } from '../modal'; + +interface Manifest { + counts: { + agents: number; + prompts: number; + instructions: number; + skills: number; + collections: number; + tools: number; + }; +} + +interface Collection { + id: string; + name: string; + description?: string; + path: string; + tags?: string[]; + featured?: boolean; + itemCount: number; +} + +interface CollectionsData { + items: Collection[]; +} + +export async function initHomepage(): Promise { + // Load manifest for stats + const manifest = await fetchData('manifest.json'); + if (manifest && manifest.counts) { + // Populate counts in cards + const countKeys = ['agents', 'prompts', 'instructions', 'skills', 'collections', 'tools'] as const; + countKeys.forEach(key => { + const countEl = document.querySelector(`.card-count[data-count="${key}"]`); + if (countEl && manifest.counts[key] !== undefined) { + countEl.textContent = manifest.counts[key].toString(); + } + }); + } + + // Load search index + const searchIndex = await fetchData('search-index.json'); + if (searchIndex) { + const search = new FuzzySearch(); + search.setItems(searchIndex); + + const searchInput = document.getElementById('global-search') as HTMLInputElement; + const resultsDiv = document.getElementById('search-results'); + + if (searchInput && resultsDiv) { + searchInput.addEventListener('input', debounce(() => { + const query = searchInput.value.trim(); + if (query.length < 2) { + resultsDiv.classList.add('hidden'); + return; + } + + const results = search.search(query).slice(0, 10); + if (results.length === 0) { + resultsDiv.innerHTML = '
No results found
'; + } else { + resultsDiv.innerHTML = results.map(item => ` +
+ ${getResourceIcon(item.type)} +
+
${search.highlight(item.title, query)}
+
${truncate(item.description, 60)}
+
+
+ `).join(''); + + // Add click handlers + resultsDiv.querySelectorAll('.search-result').forEach(el => { + el.addEventListener('click', () => { + const path = (el as HTMLElement).dataset.path; + const type = (el as HTMLElement).dataset.type; + if (path && type) openFileModal(path, type); + }); + }); + } + resultsDiv.classList.remove('hidden'); + }, 200)); + + // Close results when clicking outside + document.addEventListener('click', (e) => { + if (!searchInput.contains(e.target as Node) && !resultsDiv.contains(e.target as Node)) { + resultsDiv.classList.add('hidden'); + } + }); + } + } + + // Load featured collections + const collectionsData = await fetchData('collections.json'); + if (collectionsData && collectionsData.items) { + const featured = collectionsData.items.filter(c => c.featured).slice(0, 6); + const featuredEl = document.getElementById('featured-collections'); + if (featuredEl) { + if (featured.length > 0) { + featuredEl.innerHTML = featured.map(c => ` +
+

${escapeHtml(c.name)}

+

${escapeHtml(truncate(c.description, 80))}

+
+ ${c.itemCount} items + ${c.tags?.slice(0, 3).map(t => `${escapeHtml(t)}`).join('') || ''} +
+
+ `).join(''); + + // Add click handlers + featuredEl.querySelectorAll('.card').forEach(el => { + el.addEventListener('click', () => { + const path = (el as HTMLElement).dataset.path; + if (path) openFileModal(path, 'collection'); + }); + }); + } else { + featuredEl.innerHTML = '

No featured collections yet

'; + } + } + } + + // Setup modal + setupModal(); +} + +// Auto-initialize when DOM is ready +document.addEventListener('DOMContentLoaded', initHomepage); diff --git a/website/src/scripts/pages/instructions.ts b/website/src/scripts/pages/instructions.ts new file mode 100644 index 00000000..500e1757 --- /dev/null +++ b/website/src/scripts/pages/instructions.ts @@ -0,0 +1,128 @@ +/** + * Instructions page functionality + */ +import { createChoices, getChoicesValues, type Choices } from '../choices'; +import { FuzzySearch, SearchItem } from '../search'; +import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers } from '../utils'; +import { setupModal, openFileModal } from '../modal'; + +interface Instruction extends SearchItem { + path: string; + applyTo?: string; + extensions?: string[]; +} + +interface InstructionsData { + items: Instruction[]; + filters: { + extensions: string[]; + }; +} + +const resourceType = 'instruction'; +let allItems: Instruction[] = []; +let search = new FuzzySearch(); +let extensionSelect: Choices; +let currentFilters = { extensions: [] as string[] }; + +function applyFiltersAndRender(): void { + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const countEl = document.getElementById('results-count'); + const query = searchInput?.value || ''; + + let results = query ? search.search(query) : [...allItems]; + + if (currentFilters.extensions.length > 0) { + results = results.filter(item => { + if (currentFilters.extensions.includes('(none)') && (!item.extensions || item.extensions.length === 0)) { + return true; + } + return item.extensions?.some(ext => currentFilters.extensions.includes(ext)); + }); + } + + renderItems(results, query); + let countText = `${results.length} of ${allItems.length} instructions`; + if (currentFilters.extensions.length > 0) { + countText += ` (filtered by ${currentFilters.extensions.length} extension${currentFilters.extensions.length > 1 ? 's' : ''})`; + } + if (countEl) countEl.textContent = countText; +} + +function renderItems(items: Instruction[], query = ''): void { + const list = document.getElementById('resource-list'); + if (!list) return; + + if (items.length === 0) { + list.innerHTML = '

No instructions found

Try a different search term or adjust filters

'; + return; + } + + list.innerHTML = items.map(item => ` +
+
+
${query ? search.highlight(item.title, query) : escapeHtml(item.title)}
+
${escapeHtml(item.description || 'No description')}
+
+ ${item.applyTo ? `applies to: ${escapeHtml(item.applyTo)}` : ''} + ${item.extensions?.slice(0, 4).map(e => `${escapeHtml(e)}`).join('') || ''} + ${item.extensions && item.extensions.length > 4 ? `+${item.extensions.length - 4} more` : ''} +
+
+
+ ${getInstallDropdownHtml('instructions', item.path, true)} + ${getActionButtonsHtml(item.path, true)} + + GitHub + +
+
+ `).join(''); + + // Add click handlers + list.querySelectorAll('.resource-item').forEach(el => { + el.addEventListener('click', () => { + const path = (el as HTMLElement).dataset.path; + if (path) openFileModal(path, resourceType); + }); + }); +} + +export async function initInstructionsPage(): Promise { + const list = document.getElementById('resource-list'); + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const clearFiltersBtn = document.getElementById('clear-filters'); + + const data = await fetchData('instructions.json'); + if (!data || !data.items) { + if (list) list.innerHTML = '

Failed to load data

'; + return; + } + + allItems = data.items; + search.setItems(allItems); + + extensionSelect = createChoices('#filter-extension', { placeholderValue: 'All Extensions' }); + extensionSelect.setChoices(data.filters.extensions.map(e => ({ value: e, label: e })), 'value', 'label', true); + document.getElementById('filter-extension')?.addEventListener('change', () => { + currentFilters.extensions = getChoicesValues(extensionSelect); + applyFiltersAndRender(); + }); + + applyFiltersAndRender(); + searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200)); + + clearFiltersBtn?.addEventListener('click', () => { + currentFilters = { extensions: [] }; + extensionSelect.removeActiveItems(); + if (searchInput) searchInput.value = ''; + applyFiltersAndRender(); + }); + + setupModal(); + setupDropdownCloseHandlers(); + setupActionHandlers(); +} + +// Auto-initialize when DOM is ready +document.addEventListener('DOMContentLoaded', initInstructionsPage); diff --git a/website/src/scripts/pages/prompts.ts b/website/src/scripts/pages/prompts.ts new file mode 100644 index 00000000..e660d727 --- /dev/null +++ b/website/src/scripts/pages/prompts.ts @@ -0,0 +1,123 @@ +/** + * Prompts page functionality + */ +import { createChoices, getChoicesValues, type Choices } from '../choices'; +import { FuzzySearch, SearchItem } from '../search'; +import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers } from '../utils'; +import { setupModal, openFileModal } from '../modal'; + +interface Prompt extends SearchItem { + path: string; + tools?: string[]; +} + +interface PromptsData { + items: Prompt[]; + filters: { + tools: string[]; + }; +} + +const resourceType = 'prompt'; +let allItems: Prompt[] = []; +let search = new FuzzySearch(); +let toolSelect: Choices; +let currentFilters = { tools: [] as string[] }; + +function applyFiltersAndRender(): void { + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const countEl = document.getElementById('results-count'); + const query = searchInput?.value || ''; + + let results = query ? search.search(query) : [...allItems]; + + if (currentFilters.tools.length > 0) { + results = results.filter(item => + item.tools?.some(tool => currentFilters.tools.includes(tool)) + ); + } + + renderItems(results, query); + let countText = `${results.length} of ${allItems.length} prompts`; + if (currentFilters.tools.length > 0) { + countText += ` (filtered by ${currentFilters.tools.length} tool${currentFilters.tools.length > 1 ? 's' : ''})`; + } + if (countEl) countEl.textContent = countText; +} + +function renderItems(items: Prompt[], query = ''): void { + const list = document.getElementById('resource-list'); + if (!list) return; + + if (items.length === 0) { + list.innerHTML = '

No prompts found

Try a different search term or adjust filters

'; + return; + } + + list.innerHTML = items.map(item => ` +
+
+
${query ? search.highlight(item.title, query) : escapeHtml(item.title)}
+
${escapeHtml(item.description || 'No description')}
+
+ ${item.tools?.slice(0, 4).map(t => `${escapeHtml(t)}`).join('') || ''} + ${item.tools && item.tools.length > 4 ? `+${item.tools.length - 4} more` : ''} +
+
+
+ ${getInstallDropdownHtml(resourceType, item.path, true)} + ${getActionButtonsHtml(item.path, true)} + + GitHub + +
+
+ `).join(''); + + // Add click handlers + list.querySelectorAll('.resource-item').forEach(el => { + el.addEventListener('click', () => { + const path = (el as HTMLElement).dataset.path; + if (path) openFileModal(path, resourceType); + }); + }); +} + +export async function initPromptsPage(): Promise { + const list = document.getElementById('resource-list'); + const searchInput = document.getElementById('search-input') as HTMLInputElement; + const clearFiltersBtn = document.getElementById('clear-filters'); + + const data = await fetchData('prompts.json'); + if (!data || !data.items) { + if (list) list.innerHTML = '

Failed to load data

'; + return; + } + + allItems = data.items; + search.setItems(allItems); + + toolSelect = createChoices('#filter-tool', { placeholderValue: 'All Tools' }); + toolSelect.setChoices(data.filters.tools.map(t => ({ value: t, label: t })), 'value', 'label', true); + document.getElementById('filter-tool')?.addEventListener('change', () => { + currentFilters.tools = getChoicesValues(toolSelect); + applyFiltersAndRender(); + }); + + applyFiltersAndRender(); + searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200)); + + clearFiltersBtn?.addEventListener('click', () => { + currentFilters = { tools: [] }; + toolSelect.removeActiveItems(); + if (searchInput) searchInput.value = ''; + applyFiltersAndRender(); + }); + + setupModal(); + setupDropdownCloseHandlers(); + setupActionHandlers(); +} + +// Auto-initialize when DOM is ready +document.addEventListener('DOMContentLoaded', initPromptsPage); diff --git a/website/src/scripts/pages/samples.ts b/website/src/scripts/pages/samples.ts new file mode 100644 index 00000000..8a896284 --- /dev/null +++ b/website/src/scripts/pages/samples.ts @@ -0,0 +1,522 @@ +/** + * Samples/Cookbook page functionality + */ + +import { FuzzySearch, type SearchableItem } from "../search"; +import { fetchData, escapeHtml } from "../utils"; +import { createChoices, getChoicesValues, type Choices } from "../choices"; + +// Types +interface Language { + id: string; + name: string; + icon: string; + extension: string; +} + +interface RecipeVariant { + doc: string; + example: string | null; +} + +interface Recipe { + id: string; + name: string; + description: string; + tags: string[]; + variants: Record; +} + +interface Cookbook { + id: string; + name: string; + description: string; + path: string; + featured: boolean; + languages: Language[]; + recipes: Recipe[]; +} + +interface SamplesData { + cookbooks: Cookbook[]; + totalRecipes: number; + totalCookbooks: number; + filters: { + languages: string[]; + tags: string[]; + }; +} + +// State +let samplesData: SamplesData | null = null; +let search: FuzzySearch | null = null; +let selectedLanguage: string | null = null; +let selectedTags: string[] = []; +let expandedRecipes: Set = new Set(); +let tagChoices: Choices | null = null; + +/** + * Initialize the samples page + */ +export async function initSamplesPage(): Promise { + try { + // Load samples data + samplesData = await fetchData("samples.json"); + + if (!samplesData || samplesData.cookbooks.length === 0) { + showEmptyState(); + return; + } + + // Initialize search with all recipes + const allRecipes = samplesData.cookbooks.flatMap((cookbook) => + cookbook.recipes.map( + (recipe) => + ({ + ...recipe, + title: recipe.name, + cookbookId: cookbook.id, + } as SearchableItem & { cookbookId: string }) + ) + ); + search = new FuzzySearch(allRecipes); + + // Setup UI + setupFilters(); + setupSearch(); + renderCookbooks(); + updateResultsCount(); + } catch (error) { + console.error("Failed to initialize samples page:", error); + showEmptyState(); + } +} + +/** + * Show empty state when no cookbooks are available + */ +function showEmptyState(): void { + const container = document.getElementById("samples-list"); + if (container) { + container.innerHTML = ` +
+

No Samples Available

+

Check back soon for code samples and recipes.

+
+ `; + } + + // Hide filters + const filtersBar = document.getElementById("filters-bar"); + if (filtersBar) filtersBar.style.display = "none"; +} + +/** + * Setup language and tag filters + */ +function setupFilters(): void { + if (!samplesData) return; + + // Language filter + const languageSelect = document.getElementById( + "filter-language" + ) as HTMLSelectElement; + if (languageSelect) { + // Get unique languages across all cookbooks + const languages = new Map(); + samplesData.cookbooks.forEach((cookbook) => { + cookbook.languages.forEach((lang) => { + if (!languages.has(lang.id)) { + languages.set(lang.id, lang); + } + }); + }); + + languageSelect.innerHTML = ''; + languages.forEach((lang, id) => { + const option = document.createElement("option"); + option.value = id; + option.textContent = `${lang.icon} ${lang.name}`; + languageSelect.appendChild(option); + }); + + languageSelect.addEventListener("change", () => { + selectedLanguage = languageSelect.value || null; + renderCookbooks(); + updateResultsCount(); + }); + } + + // Tag filter (multi-select with Choices.js) + const tagSelect = document.getElementById("filter-tag") as HTMLSelectElement; + if (tagSelect && samplesData.filters.tags.length > 0) { + // Initialize Choices.js + tagChoices = createChoices("#filter-tag", { placeholderValue: "All Tags" }); + tagChoices.setChoices( + samplesData.filters.tags.map((tag) => ({ value: tag, label: tag })), + "value", + "label", + true + ); + + tagSelect.addEventListener("change", () => { + selectedTags = getChoicesValues(tagChoices!); + renderCookbooks(); + updateResultsCount(); + }); + } + + // Clear filters button + const clearBtn = document.getElementById("clear-filters"); + clearBtn?.addEventListener("click", clearFilters); +} + +/** + * Setup search functionality + */ +function setupSearch(): void { + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + if (!searchInput) return; + + let debounceTimer: number; + searchInput.addEventListener("input", () => { + clearTimeout(debounceTimer); + debounceTimer = window.setTimeout(() => { + renderCookbooks(); + updateResultsCount(); + }, 200); + }); +} + +/** + * Clear all filters + */ +function clearFilters(): void { + selectedLanguage = null; + selectedTags = []; + + const languageSelect = document.getElementById( + "filter-language" + ) as HTMLSelectElement; + if (languageSelect) languageSelect.value = ""; + + // Clear Choices.js selection + if (tagChoices) { + tagChoices.removeActiveItems(); + } + + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + if (searchInput) searchInput.value = ""; + + renderCookbooks(); + updateResultsCount(); +} + +/** + * Get filtered recipes + */ +function getFilteredRecipes(): { + cookbook: Cookbook; + recipe: Recipe; + highlighted?: string; +}[] { + if (!samplesData || !search) return []; + + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + const query = searchInput?.value.trim() || ""; + + let results: { cookbook: Cookbook; recipe: Recipe; highlighted?: string }[] = + []; + + if (query) { + // Use fuzzy search - returns SearchableItem[] directly + const searchResults = search.search(query); + results = searchResults.map((item) => { + const recipe = item as SearchableItem & { cookbookId: string }; + const cookbook = samplesData!.cookbooks.find( + (c) => c.id === recipe.cookbookId + )!; + return { + cookbook, + recipe: recipe as unknown as Recipe, + highlighted: search!.highlight(recipe.title, query), + }; + }); + } else { + // No search query - return all recipes + results = samplesData.cookbooks.flatMap((cookbook) => + cookbook.recipes.map((recipe) => ({ cookbook, recipe })) + ); + } + + // Apply language filter + if (selectedLanguage) { + results = results.filter( + ({ recipe }) => recipe.variants[selectedLanguage!] + ); + } + + // Apply tag filter + if (selectedTags.length > 0) { + results = results.filter(({ recipe }) => + selectedTags.some((tag) => recipe.tags.includes(tag)) + ); + } + + return results; +} + +/** + * Render cookbooks and recipes + */ +function renderCookbooks(): void { + const container = document.getElementById("samples-list"); + if (!container || !samplesData) return; + + const filteredResults = getFilteredRecipes(); + + if (filteredResults.length === 0) { + container.innerHTML = ` +
+

No Results Found

+

Try adjusting your search or filters.

+
+ `; + return; + } + + // Group by cookbook + const byCookbook = new Map< + string, + { cookbook: Cookbook; recipes: { recipe: Recipe; highlighted?: string }[] } + >(); + filteredResults.forEach(({ cookbook, recipe, highlighted }) => { + if (!byCookbook.has(cookbook.id)) { + byCookbook.set(cookbook.id, { cookbook, recipes: [] }); + } + byCookbook.get(cookbook.id)!.recipes.push({ recipe, highlighted }); + }); + + let html = ""; + byCookbook.forEach(({ cookbook, recipes }) => { + html += renderCookbookSection(cookbook, recipes); + }); + + container.innerHTML = html; + + // Setup event listeners + setupRecipeListeners(); +} + +/** + * Render a cookbook section + */ +function renderCookbookSection( + cookbook: Cookbook, + recipes: { recipe: Recipe; highlighted?: string }[] +): string { + const languageTabs = cookbook.languages + .map( + (lang) => ` + + ` + ) + .join(""); + + const recipeCards = recipes + .map(({ recipe, highlighted }) => + renderRecipeCard(cookbook, recipe, highlighted) + ) + .join(""); + + return ` +
+
+
+

${escapeHtml(cookbook.name)}

+

${escapeHtml(cookbook.description)}

+
+
+ ${languageTabs} +
+
+
+ ${recipeCards} +
+
+ `; +} + +/** + * Render a recipe card + */ +function renderRecipeCard( + cookbook: Cookbook, + recipe: Recipe, + highlightedName?: string +): string { + const recipeKey = `${cookbook.id}-${recipe.id}`; + const isExpanded = expandedRecipes.has(recipeKey); + + // Determine which language to show + const displayLang = selectedLanguage || cookbook.languages[0]?.id || "nodejs"; + const variant = recipe.variants[displayLang]; + + const tags = recipe.tags + .map((tag) => `${escapeHtml(tag)}`) + .join(""); + + const langIndicators = cookbook.languages + .filter((lang) => recipe.variants[lang.id]) + .map( + (lang) => + `${lang.icon}` + ) + .join(""); + + return ` +
+
+

${highlightedName || escapeHtml(recipe.name)}

+
${langIndicators}
+
+

${escapeHtml(recipe.description)}

+
${tags}
+
+ ${ + variant + ? ` + + ${ + variant.example + ? ` + + ` + : "" + } + + + GitHub + + ` + : 'Not available for selected language' + } +
+
+ `; +} + +/** + * Setup event listeners for recipe interactions + */ +function setupRecipeListeners(): void { + // View recipe buttons + document.querySelectorAll(".view-recipe-btn").forEach((btn) => { + btn.addEventListener("click", async (e) => { + e.stopPropagation(); + const docPath = (btn as HTMLElement).dataset.doc; + if (docPath) { + await showRecipeContent(docPath, "recipe"); + } + }); + }); + + // View example buttons + document.querySelectorAll(".view-example-btn").forEach((btn) => { + btn.addEventListener("click", async (e) => { + e.stopPropagation(); + const examplePath = (btn as HTMLElement).dataset.example; + if (examplePath) { + await showRecipeContent(examplePath, "example"); + } + }); + }); + + // Language tab clicks + document.querySelectorAll(".lang-tab").forEach((tab) => { + tab.addEventListener("click", (e) => { + const langId = (tab as HTMLElement).dataset.lang; + if (langId) { + selectedLanguage = langId; + // Update language filter select + const languageSelect = document.getElementById( + "filter-language" + ) as HTMLSelectElement; + if (languageSelect) languageSelect.value = langId; + renderCookbooks(); + updateResultsCount(); + } + }); + }); +} + +/** + * Show recipe/example content in modal + */ +async function showRecipeContent( + filePath: string, + type: "recipe" | "example" +): Promise { + // Use existing modal infrastructure + const { openFileModal } = await import("../modal"); + await openFileModal(filePath, type); +} + +/** + * Update results count display + */ +function updateResultsCount(): void { + const resultsCount = document.getElementById("results-count"); + if (!resultsCount || !samplesData) return; + + const filtered = getFilteredRecipes(); + const total = samplesData.totalRecipes; + + if (filtered.length === total) { + resultsCount.textContent = `${total} recipe${total !== 1 ? "s" : ""}`; + } else { + resultsCount.textContent = `${filtered.length} of ${total} recipe${ + total !== 1 ? "s" : "" + }`; + } +} + +// Auto-initialize when DOM is ready +if (typeof document !== "undefined") { + if (document.readyState === "loading") { + document.addEventListener("DOMContentLoaded", () => initSamplesPage()); + } else { + initSamplesPage(); + } +} diff --git a/website/src/scripts/pages/skills.ts b/website/src/scripts/pages/skills.ts new file mode 100644 index 00000000..9689833f --- /dev/null +++ b/website/src/scripts/pages/skills.ts @@ -0,0 +1,288 @@ +/** + * Skills page functionality + */ +import { createChoices, getChoicesValues, type Choices } from "../choices"; +import { FuzzySearch, SearchItem } from "../search"; +import { + fetchData, + debounce, + escapeHtml, + getGitHubUrl, + getRawGitHubUrl, + showToast, +} from "../utils"; +import { setupModal, openFileModal } from "../modal"; +import JSZip from "../jszip"; + +interface SkillFile { + name: string; + path: string; +} + +interface Skill extends SearchItem { + id: string; + path: string; + skillFile: string; + category: string; + hasAssets: boolean; + assetCount: number; + files: SkillFile[]; +} + +interface SkillsData { + items: Skill[]; + filters: { + categories: string[]; + }; +} + +const resourceType = "skill"; +let allItems: Skill[] = []; +let search = new FuzzySearch(); +let categorySelect: Choices; +let currentFilters = { + categories: [] as string[], + hasAssets: false, +}; + +function applyFiltersAndRender(): void { + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + const countEl = document.getElementById("results-count"); + const query = searchInput?.value || ""; + + let results = query ? search.search(query) : [...allItems]; + + if (currentFilters.categories.length > 0) { + results = results.filter((item) => + currentFilters.categories.includes(item.category) + ); + } + if (currentFilters.hasAssets) { + results = results.filter((item) => item.hasAssets); + } + + renderItems(results, query); + const activeFilters: string[] = []; + if (currentFilters.categories.length > 0) + activeFilters.push( + `${currentFilters.categories.length} categor${ + currentFilters.categories.length > 1 ? "ies" : "y" + }` + ); + if (currentFilters.hasAssets) activeFilters.push("has assets"); + let countText = `${results.length} of ${allItems.length} skills`; + if (activeFilters.length > 0) { + countText += ` (filtered by ${activeFilters.join(", ")})`; + } + if (countEl) countEl.textContent = countText; +} + +function renderItems(items: Skill[], query = ""): void { + const list = document.getElementById("resource-list"); + if (!list) return; + + if (items.length === 0) { + list.innerHTML = + '

No skills found

Try a different search term or adjust filters

'; + return; + } + + list.innerHTML = items + .map( + (item) => ` +
+
+
${ + query ? search.highlight(item.title, query) : escapeHtml(item.title) + }
+
${escapeHtml( + item.description || "No description" + )}
+
+ ${escapeHtml( + item.category + )} + ${ + item.hasAssets + ? `${ + item.assetCount + } asset${item.assetCount === 1 ? "" : "s"}` + : "" + } + ${item.files.length} file${ + item.files.length === 1 ? "" : "s" + } +
+
+
+ + GitHub +
+
+ ` + ) + .join(""); + + // Add click handlers for opening modal + list.querySelectorAll(".resource-item").forEach((el) => { + el.addEventListener("click", (e) => { + // Don't trigger modal if clicking download button or github link + if ((e.target as HTMLElement).closest(".resource-actions")) return; + const path = (el as HTMLElement).dataset.path; + if (path) openFileModal(path, resourceType); + }); + }); + + // Add download handlers + list.querySelectorAll(".download-skill-btn").forEach((btn) => { + btn.addEventListener("click", (e) => { + e.stopPropagation(); + const skillId = (btn as HTMLElement).dataset.skillId; + if (skillId) downloadSkill(skillId, btn as HTMLButtonElement); + }); + }); +} + +async function downloadSkill( + skillId: string, + btn: HTMLButtonElement +): Promise { + const skill = allItems.find((item) => item.id === skillId); + if (!skill || !skill.files || skill.files.length === 0) { + showToast("No files found for this skill.", "error"); + return; + } + + const originalContent = btn.innerHTML; + btn.disabled = true; + btn.innerHTML = + ' Preparing...'; + + try { + const zip = new JSZip(); + const folder = zip.folder(skill.id); + + const fetchPromises = skill.files.map(async (file) => { + const url = getRawGitHubUrl(file.path); + try { + const response = await fetch(url); + if (!response.ok) return null; + const content = await response.text(); + return { name: file.name, content }; + } catch { + return null; + } + }); + + const results = await Promise.all(fetchPromises); + let addedFiles = 0; + for (const result of results) { + if (result && folder) { + folder.file(result.name, result.content); + addedFiles++; + } + } + + if (addedFiles === 0) throw new Error("Failed to fetch any files"); + + const blob = await zip.generateAsync({ type: "blob" }); + const downloadUrl = URL.createObjectURL(blob); + const link = document.createElement("a"); + link.href = downloadUrl; + link.download = `${skill.id}.zip`; + document.body.appendChild(link); + link.click(); + document.body.removeChild(link); + URL.revokeObjectURL(downloadUrl); + + btn.innerHTML = + ' Downloaded!'; + setTimeout(() => { + btn.disabled = false; + btn.innerHTML = originalContent; + }, 2000); + } catch (error) { + const message = error instanceof Error ? error.message : "Download failed."; + showToast(message, "error"); + btn.innerHTML = + ' Failed'; + setTimeout(() => { + btn.disabled = false; + btn.innerHTML = originalContent; + }, 2000); + } +} + +export async function initSkillsPage(): Promise { + const list = document.getElementById("resource-list"); + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + const hasAssetsCheckbox = document.getElementById( + "filter-has-assets" + ) as HTMLInputElement; + const clearFiltersBtn = document.getElementById("clear-filters"); + + const data = await fetchData("skills.json"); + if (!data || !data.items) { + if (list) + list.innerHTML = + '

Failed to load data

'; + return; + } + + allItems = data.items; + search.setItems(allItems); + + categorySelect = createChoices("#filter-category", { + placeholderValue: "All Categories", + }); + categorySelect.setChoices( + data.filters.categories.map((c) => ({ value: c, label: c })), + "value", + "label", + true + ); + document.getElementById("filter-category")?.addEventListener("change", () => { + currentFilters.categories = getChoicesValues(categorySelect); + applyFiltersAndRender(); + }); + + applyFiltersAndRender(); + searchInput?.addEventListener( + "input", + debounce(() => applyFiltersAndRender(), 200) + ); + + hasAssetsCheckbox?.addEventListener("change", () => { + currentFilters.hasAssets = hasAssetsCheckbox.checked; + applyFiltersAndRender(); + }); + + clearFiltersBtn?.addEventListener("click", () => { + currentFilters = { categories: [], hasAssets: false }; + categorySelect.removeActiveItems(); + if (hasAssetsCheckbox) hasAssetsCheckbox.checked = false; + if (searchInput) searchInput.value = ""; + applyFiltersAndRender(); + }); + + setupModal(); +} + +// Auto-initialize when DOM is ready +document.addEventListener("DOMContentLoaded", initSkillsPage); diff --git a/website/src/scripts/pages/tools.ts b/website/src/scripts/pages/tools.ts new file mode 100644 index 00000000..ceb16525 --- /dev/null +++ b/website/src/scripts/pages/tools.ts @@ -0,0 +1,322 @@ +/** + * Tools page functionality + */ +import { FuzzySearch, type SearchableItem } from "../search"; +import { fetchData, debounce, escapeHtml } from "../utils"; + +export interface Tool extends SearchableItem { + id: string; + name: string; + title: string; + description: string; + category: string; + featured: boolean; + requirements: string[]; + features: string[]; + links: { + blog?: string; + vscode?: string; + "vscode-insiders"?: string; + "visual-studio"?: string; + github?: string; + documentation?: string; + marketplace?: string; + npm?: string; + pypi?: string; + }; + configuration?: { + type: string; + content: string; + }; + tags: string[]; +} + +interface ToolsData { + items: Tool[]; + filters: { + categories: string[]; + tags: string[]; + }; +} + +let allItems: Tool[] = []; +let search: FuzzySearch; +let currentFilters = { + categories: [] as string[], + query: "", +}; + +function formatMultilineText(text: string): string { + return escapeHtml(text).replace(/\r?\n/g, "
"); +} + +function applyFiltersAndRender(): void { + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + const countEl = document.getElementById("results-count"); + const query = searchInput?.value || ""; + currentFilters.query = query; + + let results = query ? search.search(query) : [...allItems]; + + if (currentFilters.categories.length > 0) { + results = results.filter((item) => + currentFilters.categories.includes(item.category) + ); + } + + renderTools(results, query); + + let countText = `${results.length} of ${allItems.length} tools`; + if (currentFilters.categories.length > 0) { + countText += ` (filtered by ${currentFilters.categories.length} categories)`; + } + if (countEl) countEl.textContent = countText; +} + +function renderTools(tools: Tool[], query = ""): void { + const container = document.getElementById("tools-list"); + if (!container) return; + + if (tools.length === 0) { + container.innerHTML = ` +
+

No tools found

+

Try a different search term or adjust filters

+
+ `; + return; + } + + container.innerHTML = tools + .map((tool) => { + const badges: string[] = []; + if (tool.featured) { + badges.push('Featured'); + } + badges.push( + `${escapeHtml(tool.category)}` + ); + + const features = + tool.features && tool.features.length > 0 + ? `
+

Features

+
    ${tool.features + .map((f) => `
  • ${escapeHtml(f)}
    • `) + .join("")}
+
` + : ""; + + const requirements = + tool.requirements && tool.requirements.length > 0 + ? `
+

Requirements

+
    ${tool.requirements + .map((r) => `
  • ${escapeHtml(r)}
    • `) + .join("")}
+
` + : ""; + + const tags = + tool.tags && tool.tags.length > 0 + ? `
+ ${tool.tags + .map((t) => `${escapeHtml(t)}`) + .join("")} +
` + : ""; + + const config = tool.configuration + ? `
+

Configuration

+
+ 
${escapeHtml(tool.configuration.content)}
+
+ +
` + : ""; + + const actions: string[] = []; + if (tool.links.blog) { + actions.push( + `📖 Blog` + ); + } + if (tool.links.marketplace) { + actions.push( + `🏪 Marketplace` + ); + } + if (tool.links.npm) { + actions.push( + `📦 npm` + ); + } + if (tool.links.pypi) { + actions.push( + `🐍 PyPI` + ); + } + if (tool.links.documentation) { + actions.push( + `📚 Docs` + ); + } + if (tool.links.github) { + actions.push( + `GitHub` + ); + } + if (tool.links.vscode) { + actions.push( + `Install in VS Code` + ); + } + if (tool.links["vscode-insiders"]) { + actions.push( + `VS Code Insiders` + ); + } + if (tool.links["visual-studio"]) { + actions.push( + `Visual Studio` + ); + } + + const actionsHtml = + actions.length > 0 + ? `
${actions.join("")}
` + : ""; + + const titleHtml = query + ? search.highlight(tool.name, query) + : escapeHtml(tool.name); + const descriptionHtml = formatMultilineText(tool.description); + + return ` +
+
+

${titleHtml}

+
+ ${badges.join("")} +
+
+

${descriptionHtml}

+ ${features} + ${requirements} + ${config} + ${tags} + ${actionsHtml} +
+ `; + }) + .join(""); + + setupCopyConfigHandlers(); +} + +function setupCopyConfigHandlers(): void { + document.querySelectorAll(".copy-config-btn").forEach((btn) => { + btn.addEventListener("click", async (e) => { + e.stopPropagation(); + const button = e.currentTarget as HTMLButtonElement; + const config = decodeURIComponent(button.dataset.config || ""); + try { + await navigator.clipboard.writeText(config); + button.classList.add("copied"); + const originalHtml = button.innerHTML; + button.innerHTML = ` + + + + Copied! + `; + setTimeout(() => { + button.classList.remove("copied"); + button.innerHTML = originalHtml; + }, 2000); + } catch (err) { + console.error("Failed to copy:", err); + } + }); + }); +} + +export async function initToolsPage(): Promise { + const container = document.getElementById("tools-list"); + const searchInput = document.getElementById( + "search-input" + ) as HTMLInputElement; + const categoryFilter = document.getElementById( + "filter-category" + ) as HTMLSelectElement; + const clearFiltersBtn = document.getElementById("clear-filters"); + + if (container) { + container.innerHTML = '
Loading tools...
'; + } + + const data = await fetchData("tools.json"); + if (!data || !data.items) { + if (container) + container.innerHTML = + '

Failed to load tools

'; + return; + } + + // Map items to include title for FuzzySearch + allItems = data.items.map((item) => ({ + ...item, + title: item.name, // FuzzySearch uses title + })); + + search = new FuzzySearch(); + search.setItems(allItems); + + // Populate category filter + if (categoryFilter && data.filters.categories) { + categoryFilter.innerHTML = + '' + + data.filters.categories + .map( + (c) => `` + ) + .join(""); + + categoryFilter.addEventListener("change", () => { + currentFilters.categories = categoryFilter.value + ? [categoryFilter.value] + : []; + applyFiltersAndRender(); + }); + } + + // Search input handler + searchInput?.addEventListener( + "input", + debounce(() => applyFiltersAndRender(), 200) + ); + + // Clear filters + clearFiltersBtn?.addEventListener("click", () => { + currentFilters = { categories: [], query: "" }; + if (categoryFilter) categoryFilter.value = ""; + if (searchInput) searchInput.value = ""; + applyFiltersAndRender(); + }); + + applyFiltersAndRender(); +} + +// Auto-initialize when DOM is ready +document.addEventListener("DOMContentLoaded", initToolsPage); diff --git a/website/src/scripts/search.ts b/website/src/scripts/search.ts new file mode 100644 index 00000000..28342dfb --- /dev/null +++ b/website/src/scripts/search.ts @@ -0,0 +1,184 @@ +/** + * Fuzzy search implementation for the Awesome Copilot website + * Simple substring matching on title and description with scoring + */ + +import { escapeHtml, fetchData } from "./utils"; + +export interface SearchItem { + title: string; + description?: string; + searchText?: string; + path: string; + type: string; + [key: string]: unknown; +} + +export interface SearchableItem { + title: string; + description?: string; + [key: string]: unknown; +} + +export interface SearchOptions { + fields?: string[]; + limit?: number; + minScore?: number; +} + +export class FuzzySearch { + private items: T[] = []; + + constructor(items: T[] = []) { + this.items = items; + } + + /** + * Update the items to search + */ + setItems(items: T[]): void { + this.items = items; + } + + /** + * Search items with fuzzy matching + */ + search(query: string, options: SearchOptions = {}): T[] { + const { + fields = ["title", "description", "searchText"], + limit = 50, + minScore = 0, + } = options; + + if (!query || query.trim().length === 0) { + return this.items.slice(0, limit); + } + + const normalizedQuery = query.toLowerCase().trim(); + const queryWords = normalizedQuery.split(/\s+/); + const results: Array<{ item: T; score: number }> = []; + + for (const item of this.items) { + const score = this.calculateScore(item, queryWords, fields); + if (score > minScore) { + results.push({ item, score }); + } + } + + // Sort by score descending + results.sort((a, b) => b.score - a.score); + + return results.slice(0, limit).map((r) => r.item); + } + + /** + * Calculate match score for an item + */ + private calculateScore( + item: T, + queryWords: string[], + fields: string[] + ): number { + let totalScore = 0; + + for (const word of queryWords) { + let wordScore = 0; + + for (const field of fields) { + const value = (item as Record)[field]; + if (!value) continue; + + const normalizedValue = String(value).toLowerCase(); + + // Exact match in title gets highest score + if (field === "title" && normalizedValue === word) { + wordScore = Math.max(wordScore, 100); + } + // Title starts with word + else if (field === "title" && normalizedValue.startsWith(word)) { + wordScore = Math.max(wordScore, 80); + } + // Title contains word + else if (field === "title" && normalizedValue.includes(word)) { + wordScore = Math.max(wordScore, 60); + } + // Description contains word + else if (field === "description" && normalizedValue.includes(word)) { + wordScore = Math.max(wordScore, 30); + } + // searchText (includes tags, tools, etc) contains word + else if (field === "searchText" && normalizedValue.includes(word)) { + wordScore = Math.max(wordScore, 20); + } + } + + totalScore += wordScore; + } + + // Bonus for matching all words + const matchesAllWords = queryWords.every((word) => + fields.some((field) => { + const value = (item as Record)[field]; + return value && String(value).toLowerCase().includes(word); + }) + ); + + if (matchesAllWords && queryWords.length > 1) { + totalScore *= 1.5; + } + + return totalScore; + } + + /** + * Highlight matching text in a string + */ + highlight(text: string, query: string): string { + if (!query || !text) return escapeHtml(text || ""); + + const normalizedQuery = query.toLowerCase().trim(); + const words = normalizedQuery.split(/\s+/); + let result = escapeHtml(text); + + for (const word of words) { + if (word.length < 2) continue; + const regex = new RegExp( + `(${word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")})`, + "gi" + ); + const parts = result.split(/(<[^>]+>)/g); + let inMark = false; + result = parts + .map((part) => { + if (part.startsWith("<")) { + if (part.toLowerCase() === "") inMark = true; + if (part.toLowerCase() === "") inMark = false; + return part; + } + + if (inMark) { + return part; + } + + return part.replace(regex, "$1"); + }) + .join(""); + } + + return result; + } +} + +// Global search instance (uses SearchItem for the global search index) +export const globalSearch = new FuzzySearch(); + +/** + * Initialize global search with search index + */ +export async function initGlobalSearch(): Promise> { + const searchIndex = await fetchData("search-index.json"); + if (searchIndex) { + globalSearch.setItems(searchIndex); + } + return globalSearch; +} diff --git a/website/src/scripts/theme.ts b/website/src/scripts/theme.ts new file mode 100644 index 00000000..d0a9cf68 --- /dev/null +++ b/website/src/scripts/theme.ts @@ -0,0 +1,65 @@ +/** + * Theme management for the Awesome Copilot website + * Supports light/dark mode with user preference storage + */ + +const THEME_KEY = 'theme'; + +/** + * Get the current theme preference + */ +function getThemePreference(): 'light' | 'dark' { + const stored = localStorage.getItem(THEME_KEY); + if (stored === 'light' || stored === 'dark') { + return stored; + } + // Check system preference + if (window.matchMedia && window.matchMedia('(prefers-color-scheme: light)').matches) { + return 'light'; + } + return 'dark'; +} + +/** + * Apply theme to the document + */ +function applyTheme(theme: 'light' | 'dark'): void { + document.documentElement.setAttribute('data-theme', theme); +} + +const initialTheme = getThemePreference(); +applyTheme(initialTheme); + +/** + * Toggle between light and dark theme + */ +export function toggleTheme(): void { + const current = document.documentElement.getAttribute('data-theme') as 'light' | 'dark'; + const newTheme = current === 'light' ? 'dark' : 'light'; + applyTheme(newTheme); + localStorage.setItem(THEME_KEY, newTheme); +} + +/** + * Initialize theme toggle button + */ +export function initThemeToggle(): void { + const toggleBtn = document.getElementById('theme-toggle'); + if (toggleBtn) { + toggleBtn.addEventListener('click', toggleTheme); + } + + // Listen for system theme changes + if (window.matchMedia) { + window.matchMedia('(prefers-color-scheme: light)').addEventListener('change', (e) => { + // Only auto-switch if user hasn't set a preference + const stored = localStorage.getItem(THEME_KEY); + if (!stored) { + applyTheme(e.matches ? 'light' : 'dark'); + } + }); + } +} + +// Auto-initialize when DOM is ready +document.addEventListener('DOMContentLoaded', initThemeToggle); diff --git a/website/src/scripts/utils.ts b/website/src/scripts/utils.ts new file mode 100644 index 00000000..479c7082 --- /dev/null +++ b/website/src/scripts/utils.ts @@ -0,0 +1,431 @@ +/** + * Utility functions for the Awesome Copilot website + */ + +const REPO_BASE_URL = + "https://raw.githubusercontent.com/github/awesome-copilot/main"; +const REPO_GITHUB_URL = "https://github.com/github/awesome-copilot/blob/main"; + +// VS Code install URL configurations +const VSCODE_INSTALL_CONFIG: Record< + string, + { baseUrl: string; scheme: string } +> = { + instructions: { + baseUrl: "https://aka.ms/awesome-copilot/install/instructions", + scheme: "chat-instructions", + }, + prompt: { + baseUrl: "https://aka.ms/awesome-copilot/install/prompt", + scheme: "chat-prompt", + }, + agent: { + baseUrl: "https://aka.ms/awesome-copilot/install/agent", + scheme: "chat-agent", + }, +}; + +/** + * Get the base path for the site + */ +export function getBasePath(): string { + // In Astro, import.meta.env.BASE_URL is available at build time + // At runtime, we use a data attribute on the body + if (typeof document !== "undefined") { + return document.body.dataset.basePath || "/"; + } + return "/"; +} + +/** + * Fetch JSON data from the data directory + */ +export async function fetchData( + filename: string +): Promise { + try { + const basePath = getBasePath(); + const response = await fetch(`${basePath}data/${filename}`); + if (!response.ok) throw new Error(`Failed to fetch ${filename}`); + return await response.json(); + } catch (error) { + console.error(`Error fetching ${filename}:`, error); + return null; + } +} + +/** + * Fetch raw file content from GitHub + */ +export async function fetchFileContent( + filePath: string +): Promise { + try { + const response = await fetch(`${REPO_BASE_URL}/${filePath}`); + if (!response.ok) throw new Error(`Failed to fetch ${filePath}`); + return await response.text(); + } catch (error) { + console.error(`Error fetching file content:`, error); + return null; + } +} + +/** + * Copy text to clipboard + */ +export async function copyToClipboard(text: string): Promise { + try { + await navigator.clipboard.writeText(text); + return true; + } catch { + // Deprecated fallback for older browsers that lack the async clipboard API. + const textarea = document.createElement("textarea"); + textarea.value = text; + textarea.style.position = "fixed"; + textarea.style.opacity = "0"; + document.body.appendChild(textarea); + textarea.select(); + const success = document.execCommand("copy"); + document.body.removeChild(textarea); + return success; + } +} + +/** + * Generate VS Code install URL + * @param type - Resource type (agent, prompt, instructions) + * @param filePath - Path to the file + * @param insiders - Whether to use VS Code Insiders + */ +export function getVSCodeInstallUrl( + type: string, + filePath: string, + insiders = false +): string | null { + const config = VSCODE_INSTALL_CONFIG[type]; + if (!config) return null; + + const rawUrl = `${REPO_BASE_URL}/${filePath}`; + const vscodeScheme = insiders ? "vscode-insiders" : "vscode"; + const innerUrl = `${vscodeScheme}:${ + config.scheme + }/install?url=${encodeURIComponent(rawUrl)}`; + + return `${config.baseUrl}?url=${encodeURIComponent(innerUrl)}`; +} + +/** + * Get GitHub URL for a file + */ +export function getGitHubUrl(filePath: string): string { + return `${REPO_GITHUB_URL}/${filePath}`; +} + +/** + * Get raw GitHub URL for a file (for fetching content) + */ +export function getRawGitHubUrl(filePath: string): string { + return `${REPO_BASE_URL}/${filePath}`; +} + +/** + * Download a file from its path + */ +export async function downloadFile(filePath: string): Promise { + try { + const response = await fetch(`${REPO_BASE_URL}/${filePath}`); + if (!response.ok) throw new Error("Failed to fetch file"); + + const content = await response.text(); + const filename = filePath.split("/").pop() || "file.md"; + + const blob = new Blob([content], { type: "text/markdown" }); + const url = URL.createObjectURL(blob); + + const a = document.createElement("a"); + a.href = url; + a.download = filename; + document.body.appendChild(a); + a.click(); + document.body.removeChild(a); + URL.revokeObjectURL(url); + + return true; + } catch (error) { + console.error("Download failed:", error); + return false; + } +} + +/** + * Share/copy link to clipboard (deep link to current page with file hash) + */ +export async function shareFile(filePath: string): Promise { + const deepLinkUrl = `${window.location.origin}${ + window.location.pathname + }#file=${encodeURIComponent(filePath)}`; + return copyToClipboard(deepLinkUrl); +} + +/** + * Show a toast notification + */ +export function showToast( + message: string, + type: "success" | "error" = "success" +): void { + const existing = document.querySelector(".toast"); + if (existing) existing.remove(); + + const toast = document.createElement("div"); + toast.className = `toast ${type}`; + toast.textContent = message; + document.body.appendChild(toast); + + setTimeout(() => { + toast.remove(); + }, 3000); +} + +/** + * Debounce function for search input + */ +export function debounce void>( + func: T, + wait: number +): (...args: Parameters) => void { + let timeout: ReturnType; + return function executedFunction(...args: Parameters) { + const later = () => { + clearTimeout(timeout); + func(...args); + }; + clearTimeout(timeout); + timeout = setTimeout(later, wait); + }; +} + +/** + * Escape HTML to prevent XSS + */ +export function escapeHtml(text: string): string { + const div = document.createElement("div"); + div.textContent = text; + return div.innerHTML; +} + +/** + * Truncate text with ellipsis + */ +export function truncate(text: string | undefined, maxLength: number): string { + if (!text || text.length <= maxLength) return text || ""; + return text.slice(0, maxLength).trim() + "..."; +} + +/** + * Get resource type from file path + */ +export function getResourceType(filePath: string): string { + if (filePath.endsWith(".agent.md")) return "agent"; + if (filePath.endsWith(".prompt.md")) return "prompt"; + if (filePath.endsWith(".instructions.md")) return "instruction"; + if (filePath.includes("/skills/") && filePath.endsWith("SKILL.md")) + return "skill"; + if (filePath.endsWith(".collection.yml")) return "collection"; + return "unknown"; +} + +/** + * Format a resource type for display + */ +export function formatResourceType(type: string): string { + const labels: Record = { + agent: "🤖 Agent", + prompt: "🎯 Prompt", + instruction: "📋 Instruction", + skill: "⚡ Skill", + collection: "📦 Collection", + }; + return labels[type] || type; +} + +/** + * Get icon for resource type + */ +export function getResourceIcon(type: string): string { + const icons: Record = { + agent: "🤖", + prompt: "🎯", + instruction: "📋", + skill: "⚡", + collection: "📦", + }; + return icons[type] || "📄"; +} + +/** + * Generate HTML for install dropdown button + */ +export function getInstallDropdownHtml( + type: string, + filePath: string, + small = false +): string { + const vscodeUrl = getVSCodeInstallUrl(type, filePath, false); + const insidersUrl = getVSCodeInstallUrl(type, filePath, true); + + if (!vscodeUrl) return ""; + + const sizeClass = small ? "install-dropdown-small" : ""; + const uniqueId = `install-${filePath.replace(/[^a-zA-Z0-9]/g, "-")}`; + + return ` + + `; +} + +/** + * Setup dropdown close handlers for dynamically created dropdowns + */ +export function setupDropdownCloseHandlers(): void { + if (dropdownHandlersReady) return; + dropdownHandlersReady = true; + + document.addEventListener( + "click", + (e) => { + const target = e.target as HTMLElement; + const dropdown = target.closest( + '.install-dropdown[data-install-scope="list"]' + ); + const toggle = target.closest( + ".install-btn-toggle" + ) as HTMLButtonElement | null; + const menuLink = target.closest( + ".install-dropdown-menu a" + ) as HTMLAnchorElement | null; + + if (dropdown) { + e.stopPropagation(); + + if (toggle) { + e.preventDefault(); + const isOpen = dropdown.classList.toggle("open"); + toggle.setAttribute("aria-expanded", String(isOpen)); + return; + } + + if (menuLink) { + dropdown.classList.remove("open"); + const toggleBtn = dropdown.querySelector( + ".install-btn-toggle" + ); + toggleBtn?.setAttribute("aria-expanded", "false"); + return; + } + + return; + } + + document + .querySelectorAll('.install-dropdown[data-install-scope="list"].open') + .forEach((openDropdown) => { + openDropdown.classList.remove("open"); + const toggleBtn = openDropdown.querySelector( + ".install-btn-toggle" + ); + toggleBtn?.setAttribute("aria-expanded", "false"); + }); + }, + true + ); +} + +/** + * Generate HTML for action buttons (download, share) in list view + */ +export function getActionButtonsHtml(filePath: string, small = false): string { + const btnClass = small ? "btn-small" : ""; + const iconSize = small ? 14 : 16; + + return ` + + + `; +} + +/** + * Setup global action handlers for download and share buttons + */ +export function setupActionHandlers(): void { + if (actionHandlersReady) return; + actionHandlersReady = true; + + document.addEventListener( + "click", + async (e) => { + const target = (e.target as HTMLElement).closest( + ".action-download, .action-share" + ) as HTMLElement | null; + if (!target) return; + + e.preventDefault(); + e.stopPropagation(); + + const path = target.dataset.path; + if (!path) return; + + if (target.classList.contains("action-download")) { + const success = await downloadFile(path); + showToast( + success ? "Download started!" : "Download failed", + success ? "success" : "error" + ); + return; + } + + const success = await shareFile(path); + showToast( + success ? "Link copied!" : "Failed to copy link", + success ? "success" : "error" + ); + }, + true + ); +} + +let dropdownHandlersReady = false; +let actionHandlersReady = false;