repo-nexus 0.7.16 → 0.7.18

package/lib/ai.sh

@@ -130,17 +130,36 @@ BASE_AI_EOF
     [ -n "$_p" ] || continue
     yaml_plugin_enabled "$_p" 2>/dev/null || continue
     _pdir="$(find_plugin_dir "$_p" 2>/dev/null || true)"
-    _p_instr=""
-    if [ -f "$_dir/.rnex/plugins/$_p/instructions.md" ]; then
-      _p_instr="$_dir/.rnex/plugins/$_p/instructions.md"
-    elif [ -n "$_pdir" ] && [ -f "$_pdir/instructions.md" ]; then
-      _p_instr="$_pdir/instructions.md"
+    _p_instr_files=""
+    if [ -n "$_pdir" ] && [ -f "$_pdir/plugin.yaml" ]; then
+      for _item in $(plugin_list_instructions "$_pdir" 2>/dev/null || true); do
+        [ -n "$_item" ] || continue
+        _src="${_item%%:*}"
+        _src="$(printf '%s' "$_src" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+        _found=""
+        if [ -f "$_dir/.rnex/plugins/$_p/$_src" ]; then
+          _found="$_dir/.rnex/plugins/$_p/$_src"
+        elif [ -f "$_pdir/$_src" ]; then
+          _found="$_pdir/$_src"
+        fi
+        if [ -n "$_found" ]; then
+          _p_instr_files="${_p_instr_files:+$_p_instr_files }$_found"
+        fi
+      done
     fi
 
-    if [ -n "$_p_instr" ]; then
-      printf '\n\n' >> "$_out_tmp"
-      cat "$_p_instr" >> "$_out_tmp"
+    if [ -z "$_p_instr_files" ]; then
+      if [ -f "$_dir/.rnex/plugins/$_p/instructions.md" ]; then
+        _p_instr_files="$_dir/.rnex/plugins/$_p/instructions.md"
+      elif [ -n "$_pdir" ] && [ -f "$_pdir/instructions.md" ]; then
+        _p_instr_files="$_pdir/instructions.md"
+      fi
     fi
+
+    for _f in $_p_instr_files; do
+      printf '\n\n' >> "$_out_tmp"
+      cat "$_f" >> "$_out_tmp"
+    done
   done
 
   mv "$_out_tmp" "$_ai_file"
@@ -371,21 +390,32 @@ write_rnex_env_script() {
 
 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
-  if provider_option_enabled "claude" "skills" 2>/dev/null; then
-    _dirs="${_dirs:+$_dirs }.claude/skills"
-  fi
-  if provider_option_enabled "windsurf" "skills" 2>/dev/null; then
-    _dirs="${_dirs:+$_dirs }.windsurf/rules"
-  fi
-  if provider_option_enabled "gemini" "skills" 2>/dev/null; then
-    _dirs="${_dirs:+$_dirs }.gemini/skills"
-  fi
+  for _p in $(yaml_list_plugins 2>/dev/null || true); do
+    [ -n "$_p" ] || continue
+    yaml_plugin_enabled "$_p" 2>/dev/null || continue
+    if provider_option_enabled "$_p" "skills" 2>/dev/null; then
+      _pdir="$(find_plugin_dir "$_p" 2>/dev/null || true)"
+      _sdir=""
+      if [ -n "$_pdir" ]; then
+        _sdir="$(plugin_get_field "$_pdir" "skill_dir" 2>/dev/null || true)"
+      fi
+      if [ -z "$_sdir" ]; then
+        case "$_p" in
+          copilot)  _sdir=".github/skills" ;;
+          cursor)   _sdir=".cursor/rules" ;;
+          claude)   _sdir=".claude/skills" ;;
+          windsurf) _sdir=".windsurf/rules" ;;
+          gemini)   _sdir=".gemini/skills" ;;
+        esac
+      fi
+      if [ -n "$_sdir" ]; then
+        case " $_dirs " in
+          *" $_sdir "*) ;;
+          *) _dirs="${_dirs:+$_dirs }$_sdir" ;;
+        esac
+      fi
+    fi
+  done
   printf '%s' "$_dirs"
 }
 
@@ -450,7 +480,6 @@ clean_provider_agents() {
   _ag_dir="$1"
   _ext="${2:-.md}"
   [ -d "$_ag_dir" ] || return 0
-  rm -f "$_ag_dir/wiki-curator${_ext}" 2>/dev/null || true
 
   for _pdir in "$SCRIPT_LOCATION/toolkit/plugins"/* "$NEXUS_DIR/toolkit/plugins"/* "$NEXUS_DIR/.rnex/plugins"/*; do
     [ -d "$_pdir" ] || continue
@@ -493,14 +522,20 @@ sync_rnex_base_assets() {
     cp -f "$_src_toolkit"/skills/*.md "$NEXUS_DIR/.rnex/skills/" 2>/dev/null || true
   fi
 
-  # Purge any plugin-specific skills from .rnex/skills/
-  rm -f "$NEXUS_DIR/.rnex/skills/wiki-ingest.md" "$NEXUS_DIR/.rnex/skills/wiki-lint.md" \
-        "$NEXUS_DIR/.rnex/skills/rnex-wiki-ingest.md" "$NEXUS_DIR/.rnex/skills/rnex-wiki-lint.md" 2>/dev/null || true
-
-  # Purge stale unprefixed wiki user skills across provider directories
-  for _p_dir in $(get_active_provider_skill_dirs 2>/dev/null || true); do
-    rm -f "$NEXUS_DIR/$_p_dir/rnex-wiki-ingest.md" "$NEXUS_DIR/$_p_dir/rnex-wiki-lint.md" 2>/dev/null || true
-    rm -rf "$NEXUS_DIR/$_p_dir/rnex-wiki-ingest" "$NEXUS_DIR/$_p_dir/rnex-wiki-lint" 2>/dev/null || true
+  # Purge any plugin-declared skills that may have been placed in core .rnex/skills/
+  for _pdir in $(list_all_available_plugin_dirs 2>/dev/null || true); do
+    if [ -d "$_pdir/skills" ]; then
+      for _psk in "$_pdir/skills"/*.md; do
+        [ -f "$_psk" ] || continue
+        _sbase="$(basename "$_psk")"
+        _sname="$(basename "$_psk" .md)"
+        rm -f "$NEXUS_DIR/.rnex/skills/$_sbase" "$NEXUS_DIR/.rnex/skills/rnex-$_sbase" 2>/dev/null || true
+        for _p_dir in $(get_active_provider_skill_dirs 2>/dev/null || true); do
+          rm -f "$NEXUS_DIR/$_p_dir/rnex-$_sbase" 2>/dev/null || true
+          rm -rf "$NEXUS_DIR/$_p_dir/rnex-$_sname" 2>/dev/null || true
+        done
+      done
+    fi
   done
 
   # Register core User Skills across active provider directories
@@ -512,148 +547,51 @@ sync_rnex_base_assets() {
 }
 
 sync_claude() {
-  if claude_plugin_enabled; then
-    if claude_instructions_enabled; then
-      merge_rnex_instructions "$NEXUS_DIR/CLAUDE.md"
-    else
-      clean_rnex_instructions "$NEXUS_DIR/CLAUDE.md"
-    fi
-    if ! claude_skills_enabled; then
-      clean_provider_user_skills "$NEXUS_DIR/.claude/skills"
-    fi
+  if yaml_plugin_enabled "claude" 2>/dev/null; then
+    run_plugin_hook "claude" "after_sync"
   else
-    clean_rnex_instructions "$NEXUS_DIR/CLAUDE.md"
-    clean_provider_user_skills "$NEXUS_DIR/.claude/skills"
+    run_plugin_hook "claude" "before_plugin_disable"
   fi
-  rm -rf "$NEXUS_DIR/.claude/commands" "$NEXUS_DIR/.claude/prompts" 2>/dev/null || true
-  rmdir "$NEXUS_DIR/.claude" 2>/dev/null || true
 }
 
 sync_gemini() {
-  if gemini_plugin_enabled; then
-    _gi="$NEXUS_DIR/.geminiignore"
-    if [ ! -f "$_gi" ]; then
-      cat > "$_gi" <<GI_EOF
-# Gemini CLI file discovery un-ignore for member repos
-!repos/*
-GI_EOF
-      log_ok "Created .geminiignore (enabling Gemini CLI file discovery for member repos)"
-    elif ! grep -q '!repos/\*' "$_gi" 2>/dev/null; then
-      printf '\n# Gemini CLI file discovery un-ignore for member repos\n!repos/*\n' >> "$_gi"
-      log_dim "Added !repos/* to .geminiignore"
-    fi
-
-    if gemini_instructions_enabled; then
-      merge_rnex_instructions "$NEXUS_DIR/GEMINI.md"
-    else
-      clean_rnex_instructions "$NEXUS_DIR/GEMINI.md"
-    fi
-    if ! gemini_skills_enabled; then
-      clean_provider_user_skills "$NEXUS_DIR/.gemini/skills"
-    fi
+  if yaml_plugin_enabled "gemini" 2>/dev/null; then
+    run_plugin_hook "gemini" "after_sync"
   else
-    clean_provider_ignore "$NEXUS_DIR/.geminiignore"
-    clean_rnex_instructions "$NEXUS_DIR/GEMINI.md"
-    clean_provider_user_skills "$NEXUS_DIR/.gemini/skills"
+    run_plugin_hook "gemini" "before_plugin_disable"
   fi
-  rm -rf "$NEXUS_DIR/.gemini/prompts" 2>/dev/null || true
-  rmdir "$NEXUS_DIR/.gemini" 2>/dev/null || true
 }
 
 sync_cursor() {
-  if cursor_plugin_enabled; then
-    _ci="$NEXUS_DIR/.cursorignore"
-    if [ ! -f "$_ci" ]; then
-      cat > "$_ci" <<CI_EOF
-# Cursor codebase indexing un-ignore for member repos
-!repos/*
-CI_EOF
-      log_ok "Created .cursorignore (enabling Cursor indexing for member repos)"
-    elif ! grep -q '!repos/\*' "$_ci" 2>/dev/null; then
-      printf '\n# Cursor codebase indexing un-ignore for member repos\n!repos/*\n' >> "$_ci"
-      log_dim "Added !repos/* to .cursorignore"
-    fi
-
-    if cursor_instructions_enabled; then
-      merge_rnex_instructions "$NEXUS_DIR/.cursorrules"
-      mkdir -p "$NEXUS_DIR/.cursor/rules"
-      _c_body="$(mktemp)"
-      get_rnex_instructions > "$_c_body"
-      {
-        printf -- '---\ndescription: Repo Nexus Virtual Meta-Repo routing protocol\nglobs: *\nalwaysApply: true\n---\n\n%s\n' "$AI_MARKER_START"
-        cat "$_c_body"
-        printf '\n%s\n' "$AI_MARKER_END"
-      } > "$NEXUS_DIR/.cursor/rules/rnex-context.mdc"
-      rm -f "$_c_body"
-      rm -f "$NEXUS_DIR/.cursor/rules/repo-nexus.mdc" 2>/dev/null || true
-    else
-      clean_rnex_instructions "$NEXUS_DIR/.cursorrules"
-      rm -f "$NEXUS_DIR/.cursor/rules/rnex-context.mdc" "$NEXUS_DIR/.cursor/rules/repo-nexus.mdc" 2>/dev/null || true
-    fi
-    if ! cursor_skills_enabled; then
-      clean_provider_user_skills "$NEXUS_DIR/.cursor/rules"
-    fi
+  if yaml_plugin_enabled "cursor" 2>/dev/null; then
+    run_plugin_hook "cursor" "after_sync"
   else
-    clean_provider_ignore "$NEXUS_DIR/.cursorignore"
-    clean_rnex_instructions "$NEXUS_DIR/.cursorrules"
-    rm -f "$NEXUS_DIR/.cursor/rules/rnex-context.mdc" "$NEXUS_DIR/.cursor/rules/repo-nexus.mdc" 2>/dev/null || true
-    clean_provider_user_skills "$NEXUS_DIR/.cursor/rules"
+    run_plugin_hook "cursor" "before_plugin_disable"
   fi
-  rm -rf "$NEXUS_DIR/.cursor/prompts" 2>/dev/null || true
-  rmdir "$NEXUS_DIR/.cursor/rules" 2>/dev/null || true
-  rmdir "$NEXUS_DIR/.cursor" 2>/dev/null || true
 }
 
 sync_windsurf() {
-  if windsurf_plugin_enabled; then
-    if windsurf_instructions_enabled; then
-      merge_rnex_instructions "$NEXUS_DIR/.windsurfrules"
-    else
-      clean_rnex_instructions "$NEXUS_DIR/.windsurfrules"
-    fi
-    if ! windsurf_skills_enabled; then
-      clean_provider_user_skills "$NEXUS_DIR/.windsurf/rules"
-    fi
+  if yaml_plugin_enabled "windsurf" 2>/dev/null; then
+    run_plugin_hook "windsurf" "after_sync"
   else
-    clean_rnex_instructions "$NEXUS_DIR/.windsurfrules"
-    clean_provider_user_skills "$NEXUS_DIR/.windsurf/rules"
+    run_plugin_hook "windsurf" "before_plugin_disable"
   fi
-  rm -rf "$NEXUS_DIR/.windsurf/prompts" 2>/dev/null || true
-  rmdir "$NEXUS_DIR/.windsurf/rules" 2>/dev/null || true
-  rmdir "$NEXUS_DIR/.windsurf" 2>/dev/null || true
 }
 
 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
+  if yaml_plugin_enabled "copilot" 2>/dev/null; then
+    run_plugin_hook "copilot" "after_sync"
   else
-    clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
-    clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+    run_plugin_hook "copilot" "before_plugin_disable"
   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
-  sync_windsurf
+  :
 }
 
 sync_skills() {
   write_rnex_env_script "$NEXUS_DIR"
   sync_rnex_base_assets
-  sync_ai_providers
 }
 

package/lib/commands/init.sh

@@ -10,30 +10,29 @@ cmd_init() {
   _cli_code_workspace=""
   _cli_hooks=""
   _cli_no_hooks=0
-  _cli_copilot=""
-  _cli_claude=""
-  _cli_gemini=""
-  _cli_cursor=""
-  _cli_windsurf=""
-  _cli_karpathy=""
+  _cli_plugins=""
 
   while [ $# -gt 0 ]; do
     case "$1" in
       -y|--yes) _non_interactive=1 ;;
       --hooks) _cli_hooks="true" ;;
       --no-hooks) _cli_no_hooks=1; _cli_hooks="false" ;;
-      --copilot) _cli_copilot="true" ;;
-      --no-copilot) _cli_copilot="false" ;;
-      --claude) _cli_claude="true" ;;
-      --no-claude) _cli_claude="false" ;;
-      --gemini) _cli_gemini="true" ;;
-      --no-gemini) _cli_gemini="false" ;;
-      --cursor) _cli_cursor="true" ;;
-      --no-cursor) _cli_cursor="false" ;;
-      --windsurf) _cli_windsurf="true" ;;
-      --no-windsurf) _cli_windsurf="false" ;;
-      --karpathy|--karpathy-llm) _cli_karpathy="true" ;;
-      --no-karpathy|--no-karpathy-llm) _cli_karpathy="false" ;;
+      --copilot) _cli_plugins="${_cli_plugins:+$_cli_plugins }copilot" ;;
+      --no-copilot) _cli_plugins="$(printf '%s' " $_cli_plugins " | sed -e 's/ copilot / /g' -e 's/^ *//;s/ *$//')" ;;
+      --claude) _cli_plugins="${_cli_plugins:+$_cli_plugins }claude" ;;
+      --no-claude) _cli_plugins="$(printf '%s' " $_cli_plugins " | sed -e 's/ claude / /g' -e 's/^ *//;s/ *$//')" ;;
+      --gemini) _cli_plugins="${_cli_plugins:+$_cli_plugins }gemini" ;;
+      --no-gemini) _cli_plugins="$(printf '%s' " $_cli_plugins " | sed -e 's/ gemini / /g' -e 's/^ *//;s/ *$//')" ;;
+      --cursor) _cli_plugins="${_cli_plugins:+$_cli_plugins }cursor" ;;
+      --no-cursor) _cli_plugins="$(printf '%s' " $_cli_plugins " | sed -e 's/ cursor / /g' -e 's/^ *//;s/ *$//')" ;;
+      --windsurf) _cli_plugins="${_cli_plugins:+$_cli_plugins }windsurf" ;;
+      --no-windsurf) _cli_plugins="$(printf '%s' " $_cli_plugins " | sed -e 's/ windsurf / /g' -e 's/^ *//;s/ *$//')" ;;
+      --karpathy|--karpathy-llm) _cli_plugins="${_cli_plugins:+$_cli_plugins }karpathy-llm" ;;
+      --no-karpathy|--no-karpathy-llm) _cli_plugins="$(printf '%s' " $_cli_plugins " | sed -e 's/ karpathy-llm / /g' -e 's/^ *//;s/ *$//')" ;;
+      --plugin|--enable-plugin)
+        shift
+        [ -n "$1" ] && _cli_plugins="${_cli_plugins:+$_cli_plugins }$1"
+        ;;
       --ai|--instructions|--ai-instructions)
         shift
         # Legacy flag ignored in favor of plugins
@@ -85,7 +84,7 @@ cmd_init() {
     elif [ "$_cli_hooks" = "true" ] || [ "$_non_interactive" -eq 1 ]; then
       _init_git_hooks="true"
     elif [ -t 0 ]; then
-      printf '%bConfigure automated Git hooks (post-merge auto-sync & wiki triggers)? [Y/n]: %b' "$_BOLD" "$_NC"
+      printf '%bConfigure automated Git hooks (post-merge auto-sync & plugin triggers)? [Y/n]: %b' "$_BOLD" "$_NC"
       read -r _h_ans
       case "$_h_ans" in
         n*|N*) _init_git_hooks="false" ;;
@@ -104,23 +103,37 @@ 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
-    if [ "$_cli_gemini" = "true" ]; then
-      _init_plugins="${_init_plugins}  gemini:\n    instructions: true\n    skills: true\n"
-    fi
-    if [ "$_cli_cursor" = "true" ]; then
-      _init_plugins="${_init_plugins}  cursor:\n    instructions: true\n    skills: true\n"
-    fi
-    if [ "$_cli_windsurf" = "true" ]; then
-      _init_plugins="${_init_plugins}  windsurf:\n    instructions: true\n    skills: true\n"
-    fi
-    if [ "$_cli_karpathy" = "true" ]; then
-      _init_plugins="${_init_plugins}  karpathy-llm:\n    raw_dir: \"./docs\"\n    wiki_dir: \".rnex/wiki\"\n    lint_trigger: \"manual\"\n    ingest_member_readmes: true\n"
+    for _p in $_cli_plugins; do
+      _pdir="$(find_plugin_dir "$_p" 2>/dev/null || true)"
+      _cfg_lines=""
+      if [ -n "$_pdir" ] && [ -f "$_pdir/plugin.yaml" ]; then
+        _cfg_lines="$(awk '
+          /^config_defaults:[ ]*$/ || /^config_defaults:[ ]*#/ { in_c=1; next }
+          in_c && /^[^ #]/ { exit }
+          in_c && /^[ ]*[a-zA-Z0-9_.-]+:[ ]*/ {
+            line = $0
+            sub(/^[ ]*/, "    ", line)
+            print line
+          }
+        ' "$_pdir/plugin.yaml")"
+      fi
+      if [ -n "$_cfg_lines" ]; then
+        _init_plugins="${_init_plugins}  ${_p}:\n${_cfg_lines}\n"
+      else
+        _init_plugins="${_init_plugins}  ${_p}: {}\n"
+      fi
+    done
+
+    _existing_repos=""
+    if [ -d "$_init_dir/repos" ]; then
+      for _d in "$_init_dir/repos"/*; do
+        [ -d "$_d" ] || continue
+        _r="$(basename "$_d")"
+        case "$_r" in
+          .*) continue ;;
+          *) _existing_repos="${_existing_repos}  ${_r}:\n" ;;
+        esac
+      done
     fi
 
     cat > "$_target_yaml" <<YAML_EOF
@@ -143,6 +156,7 @@ plugins:
 $(printf '%b' "$_init_plugins")
 # Member repositories managed by Repo Nexus
 repos:
+$(printf '%b' "$_existing_repos")
 YAML_EOF
     _config_created=1
     log_ok "Created $RNEX_CONFIG_FILE"

package/lib/commands/plugin.sh

@@ -66,31 +66,60 @@ cmd_plugin_info() {
   [ -n "$_home" ] && printf '%bHomepage:%b     %s\n' "$_BOLD" "$_NC" "$_home"
   printf '%bLocation:%b     %s\n' "$_BOLD" "$_NC" "$_pdir"
 
-  case "$_name" in
-    copilot|claude|gemini|cursor|windsurf)
-      _skill_target=""
-      case "$_name" in
-        copilot)  _skill_target=".github/skills/" ;;
-        claude)   _skill_target=".claude/skills/" ;;
-        gemini)   _skill_target=".gemini/skills/" ;;
-        cursor)   _skill_target=".cursor/rules/" ;;
-        windsurf) _skill_target=".windsurf/rules/" ;;
-      esac
-      printf '\n%bConfigurable Options (in rnex.yaml or .local.rnex.yaml):%b\n' "$_BOLD" "$_NC"
-      printf '  - instructions: true|false  (maintain provider instructions; current: %s)\n' "$(provider_option_enabled "$_name" "instructions" && echo "true" || echo "false")"
-      printf '  - skills: true|false        (generate user skills in %s; current: %s)\n' "$_skill_target" "$(provider_option_enabled "$_name" "skills" && echo "true" || echo "false")"
-      ;;
+  _skill_target="$(plugin_get_field "$_pdir" "skill_dir" 2>/dev/null || true)"
+  [ -z "$_skill_target" ] && case "$_name" in
+    copilot)  _skill_target=".github/skills/" ;;
+    claude)   _skill_target=".claude/skills/" ;;
+    gemini)   _skill_target=".gemini/skills/" ;;
+    cursor)   _skill_target=".cursor/rules/" ;;
+    windsurf) _skill_target=".windsurf/rules/" ;;
+  esac
+  case "$_skill_target" in
+    */|"") ;;
+    *) _skill_target="${_skill_target}/" ;;
   esac
-  if [ "$_name" = "karpathy-llm" ]; then
-    _cur_lt="$(yaml_plugin_get "karpathy-llm" "lint_trigger" 2>/dev/null || true)"
-    _cur_nc="$(yaml_plugin_get "karpathy-llm" "notify_on_changes" 2>/dev/null || true)"
-    _cur_imr="$(yaml_plugin_get "karpathy-llm" "ingest_member_readmes" 2>/dev/null || true)"
-    printf '\n%bConfigurable Options (in rnex.yaml or .local.rnex.yaml):%b\n' "$_BOLD" "$_NC"
-    printf '  - wiki_dir: <dir>  (directory for curated markdown pages; current: %s)\n' "$(karpathy_wiki_dir)"
-    printf '  - raw_dir: <dir>   (directory for unmodified intake documents; current: %s)\n' "$(karpathy_raw_dir)"
-    printf '  - lint_trigger: git-post-merge|git-post-commit|git-pre-commit|git-pre-push|manual  (current: %s)\n' "${_cur_lt:-manual}"
-    printf '  - notify_on_changes: true|false  (show notification when raw/wiki changes are committed; current: %s)\n' "${_cur_nc:-true}"
-    printf '  - ingest_member_readmes: true|false  (automatically track member repository READMEs in wiki; current: %s)\n' "${_cur_imr:-true}"
+
+  if [ -f "$_pdir/plugin.yaml" ]; then
+    _cfg_lines="$(awk '
+      /^config_descriptions:[ ]*$/ || /^config_descriptions:[ ]*#/ { in_d=1; next }
+      in_d && /^[^ #]/ { exit }
+      in_d && /^[ ]*[a-zA-Z0-9_.-]+:[ ]*/ {
+        print $0
+      }
+    ' "$_pdir/plugin.yaml")"
+
+    if [ -n "$_cfg_lines" ]; then
+      printf '\n%bConfigurable Options (in rnex.yaml or .local.rnex.yaml):%b\n' "$_BOLD" "$_NC"
+      echo "$_cfg_lines" | while read -r _cline; do
+        [ -n "$_cline" ] || continue
+        _opt="${_cline%%:*}"
+        _opt="$(printf '%s' "$_opt" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+        _desc="${_cline#*:}"
+        _desc="$(printf '%s' "$_desc" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//' -e 's/^"//' -e 's/"$//')"
+        [ -n "$_skill_target" ] && _desc="$(printf '%s' "$_desc" | sed -e "s|{skill_dir}|$_skill_target|g")"
+
+        _cur="$(yaml_plugin_get "$_name" "$_opt" 2>/dev/null || true)"
+        if [ -z "$_cur" ]; then
+          _cur="$(awk -v k="$_opt" '
+            /^config_defaults:[ ]*$/ || /^config_defaults:[ ]*#/ { in_c=1; next }
+            in_c && /^[^ #]/ { exit }
+            in_c && $0 ~ ("^[ ]*" k ":") {
+              sub("^[ ]*" k ":[ ]*", "")
+              sub(/[ ]*#.*/, "")
+              gsub(/^["\047]|["\047]$/, "")
+              print
+              exit
+            }
+          ' "$_pdir/plugin.yaml")"
+        fi
+        case "$_opt" in
+          *_dir|dir)
+            _cur="$(printf '%s' "$_cur" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//' -e 's#^\./##' -e 's#^/##' -e 's#/$##')"
+            ;;
+        esac
+        printf '  - %s: %s  (current: %s)\n' "$_opt" "$_desc" "${_cur:-default}"
+      done
+    fi
   fi
 
   printf '\n%bScoped Directory:%b .rnex/plugins/%s\n' "$_BOLD" "$_NC" "$_name"
@@ -104,15 +133,7 @@ cmd_plugin_info() {
       _d="${_item#*:}"
       _s="$(printf '%s' "$_s" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
       _d="$(printf '%s' "$_d" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
-      if [ "$_name" = "karpathy-llm" ]; then
-        _wiki_d="$(karpathy_wiki_dir)"
-        _raw_d="$(karpathy_raw_dir)"
-        _d="$(printf '%s' "$_d" | sed \
-          -e "s|{wiki_dir}|$_wiki_d|g" \
-          -e "s|{raw_dir}|$_raw_d|g" \
-          -e "s|^wiki/|${_wiki_d}/|" \
-          -e "s|^raw/|${_raw_d}/|")"
-      fi
+      _d="$(plugin_resolve_placeholders "$_name" "$_pdir" "$_d")"
       printf '  - %s → %s\n' "$_s" "$_d"
     done
   fi
@@ -252,15 +273,15 @@ cmd_rnex_dir() {
 
 cmd_plugin_update() {
   require_workspace
-  _target_plugin="$1"
-  if [ -n "$_target_plugin" ]; then
-    yaml_has_plugin "$_target_plugin" || die "Plugin '$_target_plugin' is not enabled in workspace"
-    _pdir="$(find_plugin_dir "$_target_plugin" 2>/dev/null || true)"
-    [ -n "$_pdir" ] || die "Plugin '$_target_plugin' not found."
-    log_info "Updating plugin '$_target_plugin'..."
+  _update_pname="$1"
+  if [ -n "$_update_pname" ]; then
+    yaml_has_plugin "$_update_pname" || die "Plugin '$_update_pname' is not enabled in workspace"
+    _pdir="$(find_plugin_dir "$_update_pname" 2>/dev/null || true)"
+    [ -n "$_pdir" ] || die "Plugin '$_update_pname' not found."
+    log_info "Updating plugin '$_update_pname'..."
     cmd_sync
-    run_plugin_hook "$_target_plugin" "after_sync"
-    log_ok "Plugin '$_target_plugin' updated"
+    run_plugin_hook "$_update_pname" "after_sync"
+    log_ok "Plugin '$_update_pname' updated"
   else
     log_info "Updating all enabled plugins..."
     cmd_sync

package/lib/commands/status.sh

@@ -90,9 +90,15 @@ cmd_status() {
     true|yes|1)
       if [ "$_gh_active" -eq 1 ]; then
         _active_trigger=""
-        if yaml_plugin_enabled "karpathy-llm"; then
-          _active_trigger="$(yaml_plugin_get "karpathy-llm" "lint_trigger")"
-        fi
+        for _p in $(yaml_list_plugins 2>/dev/null || true); do
+          yaml_plugin_enabled "$_p" 2>/dev/null || continue
+          _trig="$(yaml_plugin_get "$_p" "lint_trigger" 2>/dev/null || true)"
+          [ -z "$_trig" ] && _trig="$(yaml_plugin_get "$_p" "trigger" 2>/dev/null || true)"
+          if [ -n "$_trig" ] && [ "$_trig" != "manual" ]; then
+            _active_trigger="$_trig"
+            break
+          fi
+        done
         if [ -n "$_active_trigger" ]; then
           printf '  %b✓%b Git Hooks:     active (git_hooks: true, .rnex/hooks — %s)\n' "$_G" "$_NC" "$_active_trigger"
         else
@@ -105,9 +111,15 @@ cmd_status() {
     *)
       if [ "$_gh_active" -eq 1 ]; then
         _active_trigger=""
-        if yaml_plugin_enabled "karpathy-llm"; then
-          _active_trigger="$(yaml_plugin_get "karpathy-llm" "lint_trigger")"
-        fi
+        for _p in $(yaml_list_plugins 2>/dev/null || true); do
+          yaml_plugin_enabled "$_p" 2>/dev/null || continue
+          _trig="$(yaml_plugin_get "$_p" "lint_trigger" 2>/dev/null || true)"
+          [ -z "$_trig" ] && _trig="$(yaml_plugin_get "$_p" "trigger" 2>/dev/null || true)"
+          if [ -n "$_trig" ] && [ "$_trig" != "manual" ]; then
+            _active_trigger="$_trig"
+            break
+          fi
+        done
         if [ -n "$_active_trigger" ]; then
           printf '  %b✓%b Git Hooks:     active (.rnex/hooks — post-merge auto-sync, %s)\n' "$_G" "$_NC" "$_active_trigger"
         else
@@ -198,13 +210,11 @@ cmd_status() {
         else
           printf '  %b●%b %-18s %b(v%s)%b %s\n' "$_G" "$_NC" "$_pname" "$_DIM" "${_ver:-0.1.0}" "$_NC" "${_desc:+- $_desc}"
           printf '    %bScoped directory: .rnex/plugins/%s%b\n' "$_DIM" "$_pname" "$_NC"
-          case "$_pname" in
-            copilot|claude|gemini|cursor|windsurf)
-              printf '    %b↳ Options: instructions=%s, skills=%s%b\n' "$_DIM" \
-                "$(provider_option_enabled "$_pname" "instructions" && echo "true" || echo "false")" \
-                "$(provider_option_enabled "$_pname" "skills" && echo "true" || echo "false")" "$_NC"
-              ;;
-          esac
+          if [ -n "$_pdir" ] && { grep -q "instructions:" "$_pdir/plugin.yaml" 2>/dev/null || [ -n "$(yaml_plugin_get "$_pname" "instructions" 2>/dev/null)" ]; }; then
+            printf '    %b↳ Options: instructions=%s, skills=%s%b\n' "$_DIM" \
+              "$(provider_option_enabled "$_pname" "instructions" && echo "true" || echo "false")" \
+              "$(provider_option_enabled "$_pname" "skills" && echo "true" || echo "false")" "$_NC"
+          fi
         fi
       else
         printf '  %b✗%b %-18s %bMISSING%b\n' "$_R" "$_NC" "$_pname" "$_R" "$_NC"