repo-nexus 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -24,6 +24,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Preserved custom / repository-owned wrappers in `.rnex/hooks/` that are not auto-managed by `rnex`.
   - Added `cmp -s` check before writing hook files to eliminate unnecessary file churn and in-place overwrites.
   - Automatically chain to existing repository-owned `.githooks/` scripts if present.
+- **Track Workspace `.rnex/` in Version Control**:
+  - Removed `.rnex/` from `.gitignore` templates and generation.
+  - `reconcile_gitignore` and `rnex fix` actively strip legacy `.rnex/` ignore rules from `.gitignore` so that team prompts (`.rnex/prompts/`), plugins (`.rnex/plugins/`), and hooks (`.rnex/hooks/`) are tracked in git.
+  - Updated `rnex status` to expect `.rnex/` to remain tracked by git.
 
 ## [0.5.1] - 2026-10-08
 

package/docs/CLI.md

@@ -78,7 +78,7 @@ rnex init [options] [directory]
 2. Merges Repo Nexus routing instructions (`<!-- REPO-NEXUS:START -->` ... `<!-- REPO-NEXUS:END -->`) into the target AI instructions file.
 3. Creates `./repos/` directory with a tracked `.gitkeep`.
 4. Creates `.rnex/`, `.rnex/plugins/`, and copies standardized prompts to `.rnex/prompts/`.
-5. Reconciles `.gitignore` to ensure `repos/`, `.rnex/`, and `.local.rnex.yaml` are never tracked by the meta-repo.
+5. Reconciles `.gitignore` to ensure `repos/` and `.local.rnex.yaml` are never tracked by the meta-repo (while keeping `.rnex/` tracked).
 6. Generates a multi-root `.code-workspace` file if configured.
 7. Prompts to configure automated workspace Git hooks (`core.hooksPath = .rnex/hooks`) if inside a Git repository.
 
@@ -110,7 +110,7 @@ rnex status
 #### What it reports:
 - **Configuration & Versions**: Path, version tag, and load status of `rnex.yaml` and `.local.rnex.yaml`.
 - **Paths**: Clones directory (`repos_dir`) and primary AI instructions file.
-- **Git Integration**: Validation that `.gitignore` ignores `repos/`, `.rnex/`, and local files, and whether `core.hooksPath` points to `.rnex/hooks`.
+- **Git Integration**: Validation that `.gitignore` ignores `repos/` and local files (while keeping `.rnex/` tracked), and whether `core.hooksPath` points to `.rnex/hooks`.
 - **AI Routing Context**: Existence and routing block markers in `AGENTS.md`, `CLAUDE.md`, `.code-workspace`, and prompts catalog (`.rnex/prompts/index.md`).
 - **Active Plugins**: List of enabled plugins, scoped versions, and asset directories.
 - **Member Repositories**: Every registered repository, enabled/disabled state, clone health, and active Git branch.

package/package.json

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

package/rnex

@@ -890,14 +890,11 @@ reconcile_gitignore() {
 repos/*
 !repos/.gitkeep
 
-# Repo Nexus internal state & cache
-.rnex/
-
 # Local machine-specific configuration
 $RNEX_LOCAL_CONFIG_FILE
 .rnex.local.yaml
 GI_EOF
-    log_ok "Created .gitignore (ignoring repos/, .rnex/, and $RNEX_LOCAL_CONFIG_FILE)"
+    log_ok "Created .gitignore (ignoring repos/ and $RNEX_LOCAL_CONFIG_FILE)"
     return 0
   fi
 
@@ -908,18 +905,19 @@ GI_EOF
     log_ok "Removed legacy lint trigger counter entries from .gitignore"
   fi
 
-  # 2. Ensure repos/* is ignored
+  # 2. Strip legacy .rnex/ entries if present (.rnex/ contains tracked prompts, plugins, and hooks)
+  if grep -qE '^[ ]*#?[ ]*Repo Nexus internal state' "$_gi" 2>/dev/null || grep -qE '^\.rnex/?$' "$_gi" 2>/dev/null; then
+    _tmp="$(mktemp)"
+    grep -vE '(^[ ]*#?[ ]*Repo Nexus internal state|^\.rnex/?$)' "$_gi" > "$_tmp" && mv "$_tmp" "$_gi"
+    log_ok "Removed .rnex/ from .gitignore (.rnex should be tracked in git)"
+  fi
+
+  # 3. Ensure repos/* is ignored
   if ! grep -q "^repos" "$_gi" 2>/dev/null; then
     printf '\n# Member repos (managed by rnex)\nrepos/*\n!repos/.gitkeep\n' >> "$_gi"
     log_dim "Added repos/* to .gitignore"
   fi
 
-  # 3. Ensure .rnex/ is ignored
-  if ! grep -q '^\.rnex/' "$_gi" 2>/dev/null && ! grep -q '^\.rnex$' "$_gi" 2>/dev/null; then
-    printf '\n# Repo Nexus internal state & cache\n.rnex/\n' >> "$_gi"
-    log_dim "Added .rnex/ to .gitignore"
-  fi
-
   # 4. Ensure local config files are ignored
   if ! grep -qF "$RNEX_LOCAL_CONFIG_FILE" "$_gi" 2>/dev/null; then
     printf '\n# Local machine-specific configuration\n%s\n' "$RNEX_LOCAL_CONFIG_FILE" >> "$_gi"
@@ -1621,7 +1619,7 @@ YAML_EOF
   sync_prompts
   NEXUS_DIR="$_orig_nexus"
 
-  # ---- 5. Ensure repos/, .rnex/, and local configs are gitignored ---------
+  # ---- 5. Ensure repos/ and local configs are gitignored ---------
   reconcile_gitignore "$_target_dir"
 
   # ---- 6. Generate VS Code / Cursor workspace if configured ----------------
@@ -1978,18 +1976,18 @@ cmd_status() {
   fi
 
   _gi="$NEXUS_DIR/.gitignore"
-  _gi_repos=0; _gi_rnex=0; _gi_local=0; _gi_has_counter=0
+  _gi_repos=0; _gi_local=0; _gi_has_counter=0; _gi_has_rnex=0
   if [ -f "$_gi" ]; then
     grep -q '^repos' "$_gi" 2>/dev/null && _gi_repos=1
-    (grep -q '^\.rnex/' "$_gi" 2>/dev/null || grep -q '^\.rnex$' "$_gi" 2>/dev/null) && _gi_rnex=1
     grep -qF "$RNEX_LOCAL_CONFIG_FILE" "$_gi" 2>/dev/null && _gi_local=1
     grep -q "lint_trigger_counter" "$_gi" 2>/dev/null && _gi_has_counter=1
+    (grep -q '^\.rnex/' "$_gi" 2>/dev/null || grep -q '^\.rnex$' "$_gi" 2>/dev/null) && _gi_has_rnex=1
   fi
 
-  if [ "$_gi_repos" -eq 1 ] && [ "$_gi_rnex" -eq 1 ] && [ "$_gi_local" -eq 1 ] && [ "$_gi_has_counter" -eq 0 ]; then
-    printf '  %b✓%b Git Ignore:    repos/, .rnex/, and %s ignored in .gitignore\n' "$_G" "$_NC" "$RNEX_LOCAL_CONFIG_FILE"
+  if [ "$_gi_repos" -eq 1 ] && [ "$_gi_local" -eq 1 ] && [ "$_gi_has_counter" -eq 0 ] && [ "$_gi_has_rnex" -eq 0 ]; then
+    printf '  %b✓%b Git Ignore:    repos/ and %s ignored in .gitignore\n' "$_G" "$_NC" "$RNEX_LOCAL_CONFIG_FILE"
   else
-    printf '  %b!%b Git Ignore:    recommend running "rnex fix" to update .gitignore (repos/, .rnex/, local configs)\n' "$_Y" "$_NC"
+    printf '  %b!%b Git Ignore:    recommend running "rnex fix" to update .gitignore (repos/, local configs)\n' "$_Y" "$_NC"
   fi
 
   _hooks_path="$(git -C "$NEXUS_DIR" config --get core.hooksPath 2>/dev/null || true)"