repo-nexus 0.7.6 → 0.7.7

package/docs/plugins/copilot.md

@@ -0,0 +1,47 @@
+---
+title: GitHub Copilot Plugin
+description: GitHub Copilot workspace routing instructions and user skill integration for Repo Nexus.
+---
+
+# GitHub Copilot Plugin (`copilot`)
+
+The `copilot` plugin integrates GitHub Copilot with Repo Nexus by projecting workspace routing instructions into `.github/copilot-instructions.md` and user skills into `.github/skills/`.
+
+## Architecture & Integration
+
+GitHub Copilot operates natively within VS Code, Visual Studio, JetBrains, and GitHub.com:
+- **Universal Routing (`AGENTS.md`)**: GitHub Copilot natively reads `AGENTS.md` at the workspace root.
+- **Custom Instructions (`.github/copilot-instructions.md`)**: When `instructions: true`, Repo Nexus injects its non-destructive routing block inside `<!-- REPO-NEXUS:START -->` and `<!-- REPO-NEXUS:END -->`. Custom developer rules outside these markers are strictly preserved.
+- **User Skills (`.github/skills/`)**: When `skills: true`, zero-logic User Skill pointers (`rnex-<name>.md`) redirect Copilot Chat to the underlying agentic skills under `.rnex/skills/` and active plugins.
+
+## Configuration
+
+Enable in `rnex.yaml`:
+
+```yaml
+plugins:
+  copilot:
+    instructions: true   # Maintain routing in .github/copilot-instructions.md
+    skills: true         # Generate user skills in .github/skills/
+```
+
+To disable locally without altering team configuration, add to `.local.rnex.yaml`:
+
+```yaml
+plugins:
+  copilot:
+    enabled: false
+```
+
+## CLI Management
+
+```bash
+# Enable Copilot plugin across workspace
+rnex plugin enable copilot
+
+# Inspect Copilot plugin status
+rnex plugin info copilot
+
+# Disable Copilot plugin
+rnex plugin disable copilot
+```

package/lib/ai.sh

@@ -359,6 +359,7 @@ export RNEX_ROOT="${RNEX_ROOT:-$(cd "$(dirname "$0")/../.." 2>/dev/null && pwd -
 
 if [ -z "$RNEX_PROVIDER_SKILL_DIRS" ]; then
   _dirs=""
+  [ -d "$RNEX_ROOT/.github/skills" ] && _dirs="${_dirs:+$_dirs }.github/skills"
   [ -d "$RNEX_ROOT/.cursor" ] && _dirs="${_dirs:+$_dirs }.cursor/rules"
   [ -d "$RNEX_ROOT/.claude" ] && _dirs="${_dirs:+$_dirs }.claude/skills"
   [ -d "$RNEX_ROOT/.windsurf" ] && _dirs="${_dirs:+$_dirs }.windsurf/rules"
@@ -392,6 +393,9 @@ ENV_EOF
 
 get_active_provider_skill_dirs() {
   _dirs=""
+  if provider_option_enabled "copilot" "skills" 2>/dev/null; then
+    _dirs="${_dirs:+$_dirs }.github/skills"
+  fi
   if provider_option_enabled "cursor" "skills" 2>/dev/null; then
     _dirs="${_dirs:+$_dirs }.cursor/rules"
   fi
@@ -671,13 +675,28 @@ sync_windsurf() {
   rmdir "$NEXUS_DIR/.windsurf" 2>/dev/null || true
 }
 
-sync_ai_providers() {
-  # Clean legacy Copilot prompt harness and skills if present, strictly preserving custom Copilot instructions
-  rm -rf "$NEXUS_DIR/.github/prompts" 2>/dev/null || true
-  clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
-  clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+sync_copilot() {
+  if copilot_plugin_enabled; then
+    if copilot_instructions_enabled; then
+      mkdir -p "$NEXUS_DIR/.github"
+      merge_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
+    else
+      clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
+    fi
+    if ! copilot_skills_enabled; then
+      clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+    fi
+  else
+    clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
+    clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+  fi
   clean_provider_agents "$NEXUS_DIR/.github/agents" ".agent.md"
+  rm -rf "$NEXUS_DIR/.github/prompts" 2>/dev/null || true
+  rmdir "$NEXUS_DIR/.github" 2>/dev/null || true
+}
 
+sync_ai_providers() {
+  sync_copilot
   sync_claude
   sync_gemini
   sync_cursor

package/lib/commands/init.sh

@@ -21,7 +21,8 @@ cmd_init() {
       -y|--yes) _non_interactive=1 ;;
       --hooks) _cli_hooks="true" ;;
       --no-hooks) _cli_no_hooks=1; _cli_hooks="false" ;;
-      --copilot|--no-copilot) ;; # Legacy flag ignored
+      --copilot) _cli_copilot="true" ;;
+      --no-copilot) _cli_copilot="false" ;;
       --claude) _cli_claude="true" ;;
       --no-claude) _cli_claude="false" ;;
       --gemini) _cli_gemini="true" ;;
@@ -102,6 +103,9 @@ cmd_init() {
     log_dim "  rnex sync"
   else
     _init_plugins=""
+    if [ "$_cli_copilot" = "true" ]; then
+      _init_plugins="${_init_plugins}  copilot:\n    instructions: true\n    skills: true\n"
+    fi
     if [ "$_cli_claude" = "true" ]; then
       _init_plugins="${_init_plugins}  claude:\n    instructions: true\n    skills: true\n"
     fi
@@ -149,6 +153,7 @@ YAML_EOF
   [ -f "$_init_dir/GEMINI.md" ] && merge_rnex_instructions "$_init_dir/GEMINI.md"
   [ -f "$_init_dir/.cursorrules" ] && merge_rnex_instructions "$_init_dir/.cursorrules"
   [ -f "$_init_dir/.windsurfrules" ] && merge_rnex_instructions "$_init_dir/.windsurfrules"
+  [ -f "$_init_dir/.github/copilot-instructions.md" ] && merge_rnex_instructions "$_init_dir/.github/copilot-instructions.md"
 
   # ---- 3. Create repos directory with .gitkeep -----------------------------
   _repos_dir="$_init_dir/repos"

package/lib/yaml.sh

@@ -117,9 +117,9 @@ provider_option_enabled() {
   esac
 }
 
-copilot_plugin_enabled() { return 1; }
-copilot_skills_enabled() { return 1; }
-copilot_instructions_enabled() { return 1; }
+copilot_plugin_enabled() { provider_plugin_enabled "copilot"; }
+copilot_instructions_enabled() { provider_option_enabled "copilot" "instructions"; }
+copilot_skills_enabled() { provider_option_enabled "copilot" "skills"; }
 copilot_agents_enabled() { return 1; }
 
 claude_plugin_enabled() { provider_plugin_enabled "claude"; }
@@ -143,7 +143,7 @@ windsurf_skills_enabled() { provider_option_enabled "windsurf" "skills"; }
 windsurf_agents_enabled() { return 1; }
 
 has_ai_provider_plugin_enabled() {
-  for _ap in claude gemini cursor windsurf; do
+  for _ap in copilot claude gemini cursor windsurf; do
     if provider_plugin_enabled "$_ap"; then
       return 0
     fi
@@ -261,7 +261,7 @@ yaml_enable_plugin() {
   if ! _yaml_list_plugins_from_file "$_target_file" | grep -qx "$_name" 2>/dev/null; then
     _tmp="$(mktemp)"
     case "$_name" in
-      claude|gemini|cursor|windsurf)
+      copilot|claude|gemini|cursor|windsurf)
         awk -v name="$_name" '
           /^plugins:[ ]*$/ || /^plugins:[ ]*#/ {
             print

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-nexus",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "description": "Lightweight, zero-dependency Virtual Meta-Repo companion for multi-repo workspaces and shared AI context (no git submodules)",
   "bin": {
     "repo-nexus": "rnex",

package/toolkit/plugins/copilot/README.md

@@ -0,0 +1,31 @@
+# GitHub Copilot Plugin for Repo Nexus
+
+A built-in Repo Nexus plugin providing instructions and skill integration for GitHub Copilot.
+
+## Capabilities
+
+1. **Instructions Integration**: Generates and maintains `.github/copilot-instructions.md` with Repo Nexus routing instructions while preserving custom instructions outside delimiters.
+2. **User Skills Generation**: Standardized Repo Nexus core skills and active plugins' skills are mirrored as zero-logic User Skill pointers (`rnex-<name>.md`) in `.github/skills/`.
+
+## Usage
+
+Enable the plugin across the workspace:
+```bash
+rnex plugin enable copilot
+```
+
+Or configure options in `rnex.yaml` or `.local.rnex.yaml`:
+```yaml
+plugins:
+  copilot:
+    instructions: true
+    skills: true
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `instructions` | boolean | `true` | Maintain routing in `.github/copilot-instructions.md` |
+| `skills` | boolean | `true` | Generate user skills in `.github/skills/` |
+| `enabled` | boolean | `true` | Set to `false` in `.local.rnex.yaml` to override team config |

package/toolkit/plugins/copilot/instructions/rnex-copilot-integration.md

@@ -0,0 +1,24 @@
+# GitHub Copilot Integration for Repo Nexus
+
+This workspace has the Repo Nexus `copilot` plugin enabled.
+
+## Operating Principles
+- **Instructions Integration**: GitHub Copilot natively reads `.github/copilot-instructions.md` and root `AGENTS.md` for workspace routing and active plugin guidelines between `<!-- REPO-NEXUS:START -->` and `<!-- REPO-NEXUS:END -->`. Custom instructions outside these markers are strictly preserved.
+- **User Skills**: Standardized Repo Nexus core skills and active plugin skills can be accessed via `.github/skills/rnex-*.md` when `skills: true`.
+
+## Configuration
+Configure plugin options in `rnex.yaml` or override them per developer in `.local.rnex.yaml`:
+
+```yaml
+plugins:
+  copilot:
+    instructions: true   # Maintain routing in .github/copilot-instructions.md (default: true)
+    skills: true         # Generate user skills in .github/skills/ (default: true)
+```
+
+To disable locally without altering team configuration, add to `.local.rnex.yaml`:
+```yaml
+plugins:
+  copilot:
+    enabled: false
+```

package/toolkit/plugins/copilot/plugin.yaml

@@ -0,0 +1,7 @@
+name: copilot
+version: 0.5.1
+description: GitHub Copilot integration (maintains .github/copilot-instructions.md and user skills in .github/skills/)
+author: unoxen
+homepage: https://github.com/unoxen/repo-nexus
+instructions:
+  - instructions/rnex-copilot-integration.md: .rnex/plugins/copilot/instructions/rnex-copilot-integration.md