@niroai/niro 0.3.2 → 0.3.3

package/README.md

@@ -14,8 +14,9 @@ One package gives you three things:
 
 ## Working on branches
 
-Niro indexes your team's code from one branch (usually main). When you work on a feature
-branch, Niro notices and refuses to answer from the old code. Your assistant will offer the fix:
+Your projects cover the repos and branches you chose to index. On every question, Niro routes
+to the project matching your repo and current branch. When you are on a branch **no project
+covers** (with real changes), Niro refuses to answer from stale code. Your assistant offers the fix:
 
 ```bash
 niro new-temp-project     # run once in the repo folder
@@ -23,8 +24,9 @@ niro new-temp-project     # run once in the repo folder
 
 This creates your own private copy of the project that follows your branch and your
 uncommitted edits, live (keep `niro watch` running). Teammates are not affected and cannot
-see your copy. Switching branches needs nothing: Niro answers from your copy on the feature
-branch and from the shared project on main. When your branch is merged:
+see your copy. Switching branches needs nothing: Niro answers from your copy on the new
+branch, and from the matching indexed project on branches you already cover. When your branch
+is merged:
 
 ```bash
 niro discard-temp-project

package/docs/working-on-branches.md

@@ -1,8 +1,13 @@
 # Working on branches with Niro
 
-Niro indexes your team's code from one branch, usually main.
-When you work on your own branch, your code is different from what Niro indexed.
-This page explains what happens then. Two minutes to read.
+Your team decides what Niro indexes: you create projects, and each project
+covers the repos and branches you choose. One project might index main,
+another might index a develop or release branch. That is up to you.
+
+When you ask a question, Niro picks the project that matches your repo and
+the branch you are currently on. This page is about the moment when NO
+project matches: you created a new branch and changed code that no project
+has indexed yet. Two minutes to read.
 
 ## The short version
 
@@ -14,11 +19,12 @@ Run it in your repo folder when Niro asks for it. That is all.
 
 ## What you will see
 
-You create a branch and start changing code.
+You create a branch that no project covers and start changing code.
 Then you ask your AI assistant something about the code.
 
-Niro notices your branch is not the one it indexed. Instead of giving you
-a wrong answer based on the old code, it replies with something like:
+Niro notices that no project has indexed this branch. Instead of giving
+you a wrong answer based on some other branch, it replies with something
+like:
 
     I cannot answer this safely. Your branch has diverged
     from the branch Niro indexed.
@@ -44,8 +50,9 @@ From then on, answers come from YOUR code.
 
 Nothing to do. Niro checks which branch you are on for every question.
 
-- On your feature branch: answers come from your private copy.
-- Back on main: answers come from the shared project.
+- On your new branch: answers come from your private copy.
+- On a branch one of your projects already indexes: answers come
+  from that project.
 
 ## When your work is merged
 
@@ -78,8 +85,13 @@ No. Niro copies the existing index instead of re-reading your code.
 It normally takes seconds.
 
 I just created a branch and have not changed anything. Will Niro nag me?
-No. Your code is still identical to what Niro indexed, so Niro answers
-normally. It only steps in once your code actually differs.
+No. Your code is still identical to the branch you started from, so Niro
+answers normally. It only steps in once your code actually differs.
+
+We already have projects for main and develop. Do I need this?
+Not while you are on main or develop: Niro routes to the matching project
+by itself. You only need a temporary project for a branch that none of
+your projects cover.
 
 What if I really want an answer from the shared project while on my branch?
 Tell your assistant so. The answer will be clearly labeled as describing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@niroai/niro",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Niro — one package: the niro CLI plus the Niro MCP server (code intelligence for AI coding assistants).",
   "keywords": [
     "niro",