repo-nexus 0.3.3 → 0.3.5

package/README.md

@@ -54,7 +54,7 @@ A **simple, lightweight companion tool** for multi-repo workflows. It links mult
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│  Repo Nexus Workspace Root                                 │
+│  Repo Nexus Workspace Root                                  │
 │                                                             │
 │  my-workspace/                                              │
 │    repos/                                                   │
@@ -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
@@ -214,20 +214,22 @@ The `karpathy-llm` plugin packages Andrej Karpathy's verified LLM agent design p
 * **Autonomous Karpathy LLM Wiki Knowledge Architecture:**
   * **Intake (`/raw/`):** Append-only intake for unmodified source documents.
   * **Curated Knowledge Base (`/wiki/`):** Interlinked atomic markdown pages with typed YAML frontmatter relations (`sources`, `related`, `extends`, `contradicts`, `mentioned_in`).
-  * **Control Index (`/wiki/index.md`):** Master navigation index with `lint_trigger: enabled|disabled` toggle.
+  * **Navigation Index (`/wiki/index.md`):** Master categorized navigation index.
   * **Rolling Context (`/wiki/hot.md`):** ~500-word quick-orient context cache for AI agents.
   * **Operation Log (`/wiki/_log.md`):** Append-only audit trail of ingest and lint operations.
-  * **Session Counter (`.rnex/.lint_trigger_counter`):** Machine-local state tracking session activity (gitignored).
-* **Autonomous Lint Trigger (`.rnex/scripts/wiki-lint-trigger.sh`):** Session counter and maintenance alerts on session 1 and every 15 sessions.
 * **Standardized Workflows (`.rnex/workflows/`):**
   * `wiki-ingest.md`: 8-step protocol decomposing raw source documents into 5–25 atomic wiki pages.
   * `wiki-lint.md`: 10-step protocol validating paths, recomputing `mentioned_in`, removing orphans, resolving contradictions, identifying gaps, suggesting source candidates, and rebuilding indexes.
 
 ---
 
-## Workspace Configuration (`rnex.yaml`)
+## Two-Level Configuration
 
-The configuration file defines repo symlink directory, enabled plugins, and registered repositories:
+Repo Nexus supports a two-level configuration model:
+1. **Repo Config (`rnex.yaml`):** Shared manifest committed to git. Tracks member repo names, default settings, and active plugins.
+2. **Local Config (`.local.rnex.yaml`):** Machine-specific file ignored in `.gitignore`. Overrides or provides member repo paths on each developer's workstation.
+
+### Repo Configuration (`rnex.yaml`)
 
 ```yaml
 # Directory for repository symlinks (relative or absolute)
@@ -235,17 +237,15 @@ repos_dir: ./repos
 
 # Workspace plugins
 plugins:
-  karpathy-llm:
-    lint_trigger_enabled: true
+  karpathy-llm: {}
 
 # Member repositories
 repos:
   backend:
-    path: /Users/dev/code/backend-api
     scope: visible
     rnex_dir: true      # default: true (creates repos/backend/.rnex/)
   frontend:
-    path: ../web-app
+    path: ../web-app    # optional default relative path
     scope: visible
     rnex_dir: true
   analytics:
@@ -254,6 +254,14 @@ repos:
     rnex_dir: false     # disabled: leaves analytics repo 100% untouched
 ```
 
+### Local Configuration (`.local.rnex.yaml`)
+
+```yaml
+repos:
+  backend:
+    path: /Users/alice/projects/backend-api
+```
+
 > See [`docs/rnex.example.yaml`](docs/rnex.example.yaml) for a comprehensive example with all options.
 > For common questions and architecture details, see the [Frequently Asked Questions (FAQ)](docs/FAQ.md).
 
@@ -280,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

@@ -1,8 +1,14 @@
 # ==============================================================================
 # rnex.yaml — Repo Nexus Workspace Configuration (Full Example)
 # ==============================================================================
-# This file is the central manifest for a Repo Nexus workspace.
-# Place it in your workspace root directory and run `rnex sync` to apply.
+# This file is the central team manifest for a Repo Nexus workspace (committed to git).
+#
+# TWO-LEVEL CONFIGURATION:
+#   1. Repo Config (rnex.yaml): Shared across team, tracks member repos, plugins.
+#   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 fix` to apply.
 #
 # For more information: https://github.com/nu-nenoi/repo-nexus
 
@@ -37,8 +43,7 @@ repos_dir: ./repos
 # Local / custom plugins can also be placed in .rnex/plugins/<name>/
 
 plugins:
-  # karpathy-llm:
-  #   lint_trigger_enabled: true
+  # karpathy-llm: {}
 
 # ------------------------------------------------------------------------------
 # repos — Member repositories managed by Repo Nexus

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-nexus",
-  "version": "0.3.3",
+  "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",