repo-nexus 0.3.4 → 0.3.5

package/README.md

@@ -176,8 +176,8 @@ rnex hide my-app
 # Restore a hidden repo back to active scope
 rnex show my-app
 
-# Reconcile all scope links, plugins, and member .rnex/ directories
-rnex sync
+# Reconcile and fix all scope links, plugins, and member .rnex/ directories (alias: sync)
+rnex fix
 
 # Unregister a repository (removes scope link & member .rnex assets)
 rnex remove my-app
@@ -288,7 +288,7 @@ repos:
 | `rnex rnex-dir <enable\|disable> <name>` | Toggle `.rnex/` directory integration for a member repository |
 | `rnex show <name>` | Make a hidden repo visible in workspace |
 | `rnex hide <name>` | Hide a repo from active workspace indexing |
-| `rnex sync` | Reconcile all scope symlinks, plugins, and member `.rnex/` directories |
+| `rnex fix` (or `sync`) | Reconcile and fix all scope symlinks, plugins, and member `.rnex/` directories |
 
 ---
 

package/docs/FAQ.md

@@ -259,7 +259,7 @@ In your Repo Nexus workspace repository:
 If you move a repository, clone a workspace on a new machine, or notice missing symlinks, run:
 
 ```bash
-rnex sync
+rnex fix
 ```
 
 This command reconciles all scope symlinks, active plugins, and member `.rnex/` directories defined in `rnex.yaml`, repairing broken links and ensuring your workspace is healthy. To inspect the current status, run:

package/docs/rnex.example.yaml

@@ -8,7 +8,7 @@
 #   2. Local Config (.local.rnex.yaml): Machine-specific (gitignored), overrides/provides
 #      local member repo paths and developer-specific plugin settings.
 #
-# Place it in your workspace root directory and run `rnex sync` to apply.
+# Place it in your workspace root directory and run `rnex fix` to apply.
 #
 # For more information: https://github.com/nu-nenoi/repo-nexus
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-nexus",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Lightweight, zero-dependency companion tool for multi-repo workspaces and shared AI context via symlinks (no git submodules)",
   "bin": {
     "repo-nexus": "rnex",

package/rnex

@@ -907,7 +907,7 @@ cmd_init() {
   if [ -f "$_target_yaml" ]; then
     log_warn "Workspace configuration already exists at $_target_dir ($RNEX_CONFIG_FILE exists)"
     log_dim "To reconcile symlinks and plugins, run:"
-    log_dim "  rnex sync"
+    log_dim "  rnex fix"
   else
     cat > "$_target_yaml" <<YAML_EOF
 # Repo Nexus workspace configuration
@@ -1203,10 +1203,10 @@ cmd_status() {
         printf '  %b●%b %-22s %bactive%b%b → %s%b\n' "$_G" "$_NC" "$_name" "$_G" "$_NC" "$_rnex_tag" "$_path" "$_src_tag"
       elif [ -L "$_link" ]; then
         printf '  %b✗%b %-22s %bBROKEN LINK%b%b → %s%b\n' "$_R" "$_NC" "$_name" "$_R" "$_NC" "$_rnex_tag" "$_path" "$_src_tag"
-        printf '    %b↳ Suggestion: run '\''rnex sync'\'' to recreate scope link%b\n' "$_Y" "$_NC"
+        printf '    %b↳ Suggestion: run '\''rnex fix'\'' to recreate scope link%b\n' "$_Y" "$_NC"
       else
         printf '  %b✗%b %-22s %bMISSING LINK%b%b → %s%b\n' "$_R" "$_NC" "$_name" "$_R" "$_NC" "$_rnex_tag" "$_path" "$_src_tag"
-        printf '    %b↳ Suggestion: run '\''rnex sync'\'' to create scope link%b\n' "$_Y" "$_NC"
+        printf '    %b↳ Suggestion: run '\''rnex fix'\'' to create scope link%b\n' "$_Y" "$_NC"
       fi
     done
   fi
@@ -1218,11 +1218,11 @@ cmd_status() {
   printf '\n'
 }
 
-cmd_sync() {
+cmd_fix() {
   require_workspace
   ensure_repos_dir
 
-  log_info "Synchronizing workspace from $(basename "$WORKSPACE_YAML")..."
+  log_info "Fixing and reconciling workspace from $(basename "$WORKSPACE_YAML")..."
   sync_plugins
 
   yaml_list_repos | while read -r _name; do
@@ -1278,7 +1278,11 @@ cmd_sync() {
     sync_repo_rnex "$_name"
   done
 
-  log_ok "Sync complete — all scope links, plugins, and member .rnex directories reconciled"
+  log_ok "Fix complete — all scope links, plugins, and member .rnex directories reconciled"
+}
+
+cmd_sync() {
+  cmd_fix "$@"
 }
 
 cmd_plugin_list() {
@@ -1437,7 +1441,7 @@ cmd_plugin_enable() {
     log_dim "Added '$RNEX_LOCAL_CONFIG_FILE' to .gitignore"
   fi
 
-  cmd_sync
+  cmd_fix
   log_ok "Plugin '$_name' active in workspace"
 }
 
@@ -1609,7 +1613,7 @@ cmd_help() {
   WORKSPACE & SYSTEM SETUP
     init [dir]              Initialize a new Repo Nexus workspace in current (or specified) dir
     install [dir]           Install rnex & repo-nexus globally into ~/.local/bin (or custom dir)
-    sync                    Reconcile scope links, plugins & member .rnex/ directories
+    fix                     Reconcile and fix scope links, plugins & member .rnex/ directories (alias: sync)
 
   REPO MANAGEMENT
     add [--local] [--no-rnex-dir] <name> <path>  Register member repo (--local writes to .local.rnex.yaml)
@@ -1641,7 +1645,7 @@ cmd_help() {
     rnex plugin enable karpathy-llm           # Enable Karpathy LLM plugin
     rnex hide my-app                          # Temporarily hide from active indexing
     rnex show my-app                          # Bring back into active scope
-    rnex sync                                 # Reconcile all links from config
+    rnex fix                                  # Reconcile and fix all links from config (alias: sync)
 
 EOF
 }
@@ -1687,7 +1691,7 @@ case "${1:-help}" in
   list)        shift; cmd_list "$@" ;;
   status)      shift; cmd_status "$@" ;;
   rnex-dir)    shift; cmd_rnex_dir "$@" ;;
-  sync)        shift; cmd_sync "$@" ;;
+  fix|sync)    shift; cmd_fix "$@" ;;
   plugin)      shift; cmd_plugin "$@" ;;
   version|-v|--version) cmd_version ;;
   help|-h|--help) cmd_help ;;

package/toolkit/plugins/karpathy-llm/README.md

@@ -106,7 +106,7 @@ This command:
 1. Adds `karpathy-llm` to `plugins:` in `rnex.yaml`.
 2. Copies initial templates (`wiki/index.md`, `wiki/_log.md`, `wiki/hot.md`, `raw/.gitkeep`, `.rnex/templates/wiki-page.template.md`, `.rnex/templates/LLM_WIKI.sample.md`).
 3. Links `KARPATHY_RULES.md` and workflows into `.rnex/rules/` and `.rnex/workflows/`.
-4. Syncs scope links and AI context files across all registered member repositories via `rnex sync`.
+4. Syncs scope links and AI context files across all registered member repositories via `rnex fix`.
 
 ### Option 2: Declarative in `rnex.yaml`
 
@@ -117,10 +117,10 @@ plugins:
   karpathy-llm: {}
 ```
 
-Then synchronize:
+Then reconcile and fix:
 
 ```bash
-rnex sync
+rnex fix
 ```
 
 ---