repo-nexus 0.6.0 → 0.6.2

package/lib/ai.sh

@@ -68,20 +68,35 @@ This workspace operates as a **Repo Nexus Virtual Meta-Repo** uniting independen
 
 ## Routing Protocol for AI Assistants
 
+> [!IMPORTANT]
+> **MANDATORY GATE: DO NOT INSPECT \`repos/\` BEFORE CONSULTING THE WIKI (\`${_wiki_dir}/\`).**
+> Never run broad codebase searches, recursive directory listings, or grep commands across \`repos/\`.
+> The Karpathy LLM Wiki (\`${_wiki_dir}/\`) is the authoritative architectural index. Always query \`${_wiki_dir}/hot.md\` and \`${_wiki_dir}/index.md\` first to identify exact files and cross-repo contracts.
+
 ### Mandatory Session Startup
 
-Before answering the first task or making any task-specific tool call in a new session:
+Before answering the first task or making any task-specific tool call in a new session, execute these steps in strict sequence:
 
 1. **Read Configuration First (Highest Priority)**: Inspect and read \`.local.rnex.yaml\` (if present) and \`rnex.yaml\` to identify workspace structure (\`repos_dir\`), active member repositories (\`repos/\`), and enabled plugins.
    - \`.local.rnex.yaml\` takes highest priority over \`rnex.yaml\`.
    - Repositories are enabled by default unless explicitly marked \`enabled: false\`. Disabled repositories are excluded from active tasks.
-2. Inspect instructions for every enabled Repo Nexus plugin under \`.rnex/plugins/<plugin-name>/\`.
-3. If \`${_wiki_dir}/\` is present: read \`${_wiki_dir}/hot.md\` and \`${_wiki_dir}/index.md\` to orient on architecture and domain concepts.
-4. Follow links from the index to wiki pages relevant to the request.
-5. Only then inspect member repositories (\`repos/<name>/\`) or produce an answer.
+2. **Wiki Orientation (MANDATORY GATE BEFORE REPO ACCESS)**:
+   - If \`${_wiki_dir}/\` is present: you MUST read \`${_wiki_dir}/hot.md\` and \`${_wiki_dir}/index.md\` to orient on architecture, cross-repo contracts, and domain concepts.
+   - Follow links from the index to wiki pages relevant to the request.
+   - **STRICT PROHIBITION**: Any tool call inspecting, grepping, or listing files in \`repos/\` before reading the wiki is a protocol violation.
+3. **Plugin Instructions**: Inspect instructions for every enabled Repo Nexus plugin under \`.rnex/plugins/<plugin-name>/\`.
+4. **Targeted Member Repository Access Only**:
+   - Only after consulting the wiki, navigate directly to the specific files in \`repos/<name>/\` identified by the wiki.
+   - Never perform blind repository-wide scans or unbounded searches across \`repos/\`.
 
 This is a hard gate, not optional orientation. Complete it once per session and retain the resulting context; do not repeatedly reload these files.
 
+### Forbidden Startup Actions
+- ❌ **DO NOT** grep or search \`repos/\` as your first step.
+- ❌ **DO NOT** perform recursive tree exploration of member repositories.
+- ❌ **DO NOT** guess architecture or cross-repo contracts without checking \`${_wiki_dir}/\`.
+- ❌ **DO NOT** bypass \`${_wiki_dir}/hot.md\` and \`${_wiki_dir}/index.md\`.
+
 ## Workspace Skills, Workflows & Rules
 Tools and agents operate on skills, workflows, instructions, and rules located under \`.rnex/\`:
 - **Skills**: Inspect \`.rnex/skills/\` and active plugin skills under \`.rnex/plugins/<plugin-name>/skills/\`.
@@ -94,7 +109,7 @@ Autonomous subagents are defined under \`.rnex/agents/\` and active plugin agent
 - To execute a task requiring a subagent, adopt the role, operational persona, and constraints specified in the corresponding subagent definition file.
 
 ## Member Repositories (\`repos/<name>/\`)
-Each member repository is an autonomous Git repository. For repository-specific instructions, inspect \`repos/<name>/.rnex/\`.
+Each member repository is an autonomous Git repository. For repository-specific instructions, inspect \`repos/<name>/.rnex/\`. Inspect only files pinpointed through wiki routing.
 
 ## Workspace Maintenance
 When workspace configuration, routing blocks, plugin assets, or member repository structures require reconciliation or schema upgrades:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-nexus",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Lightweight, zero-dependency Virtual Meta-Repo companion for multi-repo workspaces and shared AI context (no git submodules)",
   "bin": {
     "repo-nexus": "rnex",
@@ -64,4 +64,4 @@
   "devDependencies": {
     "vitepress": "^1.6.0"
   }
-}
+}