devsmind-mcp 4.1.1 → 4.3.0

package/README.md

@@ -24,27 +24,47 @@ Git tells you **WHAT** changed. **DevsMind tells your AI agent WHY it changed, W
                           │ one bound server per project
         ┌─────────────────┴─────────────────┐
         ▼                                   ▼
-  c:\work\my-project\.devmind\        c:\work\other-project\.devmind\
+  c:\work\my-project\.devsmind\       c:\work\other-project\.devsmind\
   brain.db                            brain.db
   (Project A team brain)              (Project B team brain)
 ```
 
 > 📖 Looking for the exhaustive version (every flag, every schema field)? See [detailExplanation.md](detailExplanation.md). This file is the fast path.
 
+<details open>
+<summary><strong>📑 Index</strong></summary>
+
+- [How it works](#how-it-works)
+- [🛠️ Architecture: The `.devsmind/` Directory](#-architecture-the-devsmind-directory)
+  - [Flexibility: Where should the brain live?](#flexibility-where-should-the-brain-live)
+- [🚀 Why teams use it](#-why-teams-use-it)
+- [⚡ Quick Start](#-quick-start)
+- [🔌 The four setup commands, and why there are four](#-the-four-setup-commands-and-why-there-are-four)
+- [📇 Indexing your codebase: `index` vs `reindex`](#-indexing-your-codebase-index-vs-reindex)
+- [🖥️ Other commands (cheat sheet)](#-other-commands-cheat-sheet)
+- [🔌 MCP tools, grouped by purpose](#-mcp-tools-grouped-by-purpose)
+- [🗄️ Storage model, briefly](#-storage-model-briefly)
+- [Changelog](#changelog)
+- [📄 License](#-license)
+
+</details>
+
 ---
 
 ## How it works
 
-Run `devsmind init` once per project → creates `.devmind/`. Commit it. Every teammate's agent reads and writes the same graph.
+Run `devsmind init` once per project → creates `.devsmind/`. Commit it. Every teammate's agent reads and writes the same graph.
 
 ---
 
-## 🛠️ Architecture: The `.devmind/` Directory
+## 🛠️ Architecture: The `.devsmind/` Directory
 
-Running `devsmind init` creates a `.devmind/` directory in your workspace. This folder contains the configuration, distributed graph database, and local cache:
+Running `devsmind init` creates a `.devsmind/` directory in your workspace. This folder contains the configuration, distributed graph database, and local cache:
+
+> **Renamed in 4.2.0 — nothing to migrate.** This directory used to be called `.devmind/`, one letter off from an unrelated npm package. Existing `.devmind/` brains are still read, forever: every lookup tries `.devsmind` first and falls back. Only `devsmind init` on a **brand-new** project uses the new name, and re-running `init` on an existing brain repairs it in place under whatever name it already has — it will never create a second one. The only thing to know: a brain created on 4.2.0+ needs **devsmind-mcp ≥ 4.2.0** on every teammate's machine, since an older install doesn't know to look for `.devsmind`.
 
 ```
-.devmind/
+.devsmind/
   ├── .gitignore              ← Written by init; ignores everything marked LOCAL below
   ├── config.json             ← Project metadata & repository mapping        (COMMITTED)
   ├── graph/                  ← Distributed graph structure JSON             (COMMITTED)
@@ -66,6 +86,8 @@ Running `devsmind init` creates a `.devmind/` directory in your workspace. This
 
 **COMMITTED vs LOCAL is the whole storage design.** Committed is the *team's* shared brain — graph, reasoning, feature timelines. Local is either derivable (`brain.db` is a cache; delete it and `devsmind sync` rebuilds it) or genuinely personal (`local/` holds your verbatim requests and revert backups, which only mean anything on the machine that wrote them).
 
+> **COMMITTED, but not necessarily to your code branch as of 4.3.0.** By default `graph/`/`history/`/`vectors/`/`workflows/` still commit onto whatever branch you're on. Run `devsmind push` and they move to a dedicated `devsmind` branch instead, so a PR diff isn't drowned in graph/history churn — `devsmind pull` brings them back down. `config.json` always stays on your code branch; see [Other commands](#-other-commands-cheat-sheet).
+
 ### Flexibility: Where should the brain live?
 
 DevsMind supports two deployment topologies depending on your team's workflow:
@@ -73,14 +95,14 @@ DevsMind supports two deployment topologies depending on your team's workflow:
 *   **Option A: Inside the workspace/project root directory (Shared with team)**
     ```
     c:\work\my-project\
-      ├── .devmind\              ← Config and distributed JSON database live here
+      ├── .devsmind\             ← Config and distributed JSON database live here
       ├── backend-service\
       └── frontend-web\
     ```
 *   **Option B: Standalone folder (Fully separated)**
     ```
     c:\Users\username\brains\my-project\
-      └── .devmind\              ← Brain is kept separate from code folders
+      └── .devsmind\             ← Brain is kept separate from code folders
     ```
 
 ---
@@ -110,14 +132,14 @@ npm install -g devsmind-mcp
 ### Starting a brand-new brain
 
 ```bash
-devsmind init      # 1. Create .devmind/ — interactive: project name, repos, tech stack
+devsmind init      # 1. Create .devsmind/ — interactive: project name, repos, tech stack
 devsmind mcp       # 2. Connect your IDE/CLI to the MCP server
 devsmind rule      # 3. Paste the workspace rule — this is what teaches your agent to actually use it
 devsmind memory    # 4. Print a prompt to paste into your AI chat, asking it to remember the workflow
 devsmind skill     # 5. (optional) Write it as an explicitly-invokable /devsmind skill file too
 devsmind start     # 6. Start the server (skip if your IDE launches it via stdio)
 devsmind index --run --provider gemini --key YOUR_KEY   # 7. (optional) index the codebase now
-git add .devmind && git commit -m "Add DevsMind brain"  # 8. share it
+git add .devsmind && git commit -m "Add DevsMind brain"  # 8. share it
 ```
 
 > **Step 4 is the one people skip and then wonder why the agent drifts.** A pasted rule is a file *you* maintain and it's always loaded — that part isn't optional. `devsmind memory` is a second, complementary lever: it writes nothing, it just prints a natural-language block framed as an explicit "remember this" request, because that's the one thing that actually gets an AI's own memory feature to save something reliably (background/automatic memory turns out to be discretionary almost everywhere — several tools say so in their own docs). Paste it once and ask your AI to remember it. Not every tool has a memory feature to ask that of, though — for those, `devsmind memory` says so and points at step 5's `devsmind skill` instead, which works the same regardless.
@@ -125,7 +147,7 @@ git add .devmind && git commit -m "Add DevsMind brain"  # 8. share it
 ### Joining a brain a teammate already created
 
 ```bash
-git pull           # 1. .devmind/ is already in the repo
+git pull           # 1. .devsmind/ is already in the repo
 devsmind init      # 2. sets up YOUR machine only (dev identity, local paths) — doesn't touch the shared graph
 devsmind mcp       # 3. connect your IDE/CLI
 devsmind rule      # 4. paste the workspace rule
@@ -146,6 +168,28 @@ devsmind start     # 8. start the server (skip if stdio)
 >
 > **This mattered most jumping to 4.0.0**, which *removed* `stage_change` (folded into `edit_node`) and changed the indexing protocol — a rule written against an older version told your agent to call a tool that no longer existed. `stage_change` is back since then, but with a different signature (it now recovers an edit already made outside `edit_node`, rather than being a second way to make one) — a rule from between 4.0.0 and now that never mentions it just won't tell your agent about the recovery path, not break anything. Check the [Changelog](CHANGELOG.md) after any upgrade — some releases need a re-paste, some don't.
 
+> 🪝 **Optional: auto-sync after every `git pull`**
+>
+> Step 7 above (`devsmind sync`) is easy to forget — and a stale local cache just means your agent's `search_nodes` results are behind what teammates already committed. A git `post-merge` hook runs it automatically every time `git pull` brings in new commits.
+>
+> ```sh
+> #!/bin/sh
+> # post-merge — runs after every `git pull` / `git merge`.
+> # BRAIN_DIR only needs adjusting if .devsmind/ does NOT live at your repo root — devsmind
+> # auto-detects .devsmind (and a legacy .devmind) by walking UP from wherever it's run, never
+> # down, so a brain dir in a
+> # sibling/nested folder (a dedicated "brains" repo, a monorepo subpackage, …) needs an explicit
+> # cd here (or pass --path to both commands below instead).
+> BRAIN_DIR="$(git rev-parse --show-toplevel)"
+>
+> cd "$BRAIN_DIR" || exit 1
+> devsmind analyze --fix && devsmind sync
+> ```
+>
+> **Two ways to install it, in order of how much it's worth doing:**
+> - **Quick, just for you:** save the script above as `.git/hooks/post-merge` and `chmod +x` it. Nothing to commit — `.git/hooks/` is never tracked by git, so this is per-machine only, and every teammate (and every fresh clone of yours) has to redo it by hand.
+> - **Shared with the whole team:** a hooks directory doesn't have to live inside `.git/` — that's just the default. Put the script in a tracked folder instead (e.g. `.githooks/post-merge`), commit and push it like any other file, then have everyone run **once**: `git config core.hooksPath .githooks`. From then on it fires automatically for anyone who ran that command, and updating the hook is just a normal commit everyone pulls — no manual re-copying.
+
 ---
 
 ## 🔌 The four setup commands, and why there are four
@@ -189,13 +233,13 @@ Antigravity (IDE + CLI), Codex, and Kiro have no real background-memory mechanis
 >
 > - `devsmind analyze --fix` — free local health check. Finds god entities, cycles, orphans, dangling edges, duplicates; auto-applies only the safe fixes.
 > - Ask your agent to fix what it hits: `record_alias` (same symbol, another name), `link_nodes` (a real edge the AST missed), `merge_nodes` / `split_node`, `create_missing_node`.
-> - Every `commit_changes` also **reports** problems it noticed into `.devmind/local/feedback_graph.jsonl`. Read them back with `devsmind feedback`, or have an agent drain the queue: `read_graph_feedback` → verify → fix → `mark_graph_feedback_processed`.
+> - Every `commit_changes` also **reports** problems it noticed into `.devsmind/local/feedback_graph.jsonl`. Read them back with `devsmind feedback`, or have an agent drain the queue: `read_graph_feedback` → verify → fix → `mark_graph_feedback_processed`.
 >
 > Nothing here needs an API key, and none of it is auto-applied behind your back.
 
 > 💛 **And there's feedback about DevsMind itself — please share it.**
 >
-> The same `commit_changes` call asks your agent three questions that aren't about your graph at all: which tools actually helped, what it reached for *instead* of a DevsMind tool and why, and one concrete thing that would have made the task easier. Those land in `.devmind/local/feedback_product.jsonl`.
+> The same `commit_changes` call asks your agent three questions that aren't about your graph at all: which tools actually helped, what it reached for *instead* of a DevsMind tool and why, and one concrete thing that would have made the task easier. Those land in `.devsmind/local/feedback_product.jsonl`.
 >
 > It's **gitignored and never uploaded** — DevsMind has no telemetry, so unless you send it, nobody sees it. But it's the most useful bug report there is: a log of where a real agent, on real code, gave up on a DevsMind tool and did it the old way. Run `devsmind feedback`, and if anything in there looks like a pattern, [open an issue](https://github.com/Abialidr/devsmind-mcp/issues) with it. That's how this gets better.
 
@@ -266,7 +310,7 @@ Rough benchmark (~1,080-file repo, informal): local Ollama model took ~15h at ~5
 | Command | What it does |
 |---|---|
 | `devsmind start [--stdio] [-p <port>]` | Run the MCP server |
-| `devsmind sync [--analyze] [--fix]` | Pull committed graph changes into your local cache |
+| `devsmind sync [--analyze] [--fix]` | Pull committed graph changes into your local cache. *(4.3.0)* Also catches a repo added elsewhere first — standalone mode, no-op when nothing's missing |
 | `devsmind describe [--provider …] [--key …] [--dry-run]` | Backfill natural-language descriptions for nodes that have none — what `search_nodes` needs to match a plain-English query. `--dry-run` lists the backlog without an API key. Safe to re-run |
 | `devsmind embed [--force] [--dry-run]` | Turn those descriptions into semantic vectors, **fully local** — on-device ONNX, no credentials, no network. `--force` re-embeds everything after a model upgrade. Safe to re-run |
 | `devsmind feedback [--since <days>] [--all]` | Read what your agent reported via `commit_changes` — graph problems, product feedback, indexer-rule candidates. Local, never pushed |
@@ -278,12 +322,15 @@ Rough benchmark (~1,080-file repo, informal): local Ollama model took ~15h at ~5
 | `devsmind prune` | Interactive review + permanent delete of nodes/history |
 | `devsmind workflow` | Interactive view of multi-day feature workflows |
 | `devsmind workflow-import <path>` | Import existing flow docs as resumable workflows |
+| `devsmind push [-m <message>]` | *(4.3.0)* Commit `graph/history/vectors/workflows` onto a dedicated `devsmind` branch and push — keeps that churn out of your code branch's PR diff. Your checked-out branch is never touched |
+| `devsmind pull` | *(4.3.0)* Sync `graph/history/vectors/workflows` down from the `devsmind` branch into `.devsmind/` and re-sync `brain.db` — the read side of `push`. Runs the same repo-added-elsewhere check `sync` does |
+| `devsmind add-repo` | *(4.3.0, standalone mode)* Add ONE repo to an existing brain and index just that repo, without re-running `init`. Resumable if interrupted |
 
 ---
 
 ## 🔌 MCP tools, grouped by purpose
 
-DevsMind exposes 35 tools to the agent. The ones you'll see referenced most:
+DevsMind exposes 38 tools to the agent. The ones you'll see referenced most:
 
 | Group | Tools |
 |---|---|
@@ -293,6 +340,8 @@ DevsMind exposes 35 tools to the agent. The ones you'll see referenced most:
 | **Write (the important one)** | `edit_node` — the write path to use, for every file. Edits any file, traces what changed, and **returns the red/green diff of what it changed** so you see it in the session — all in one call. `stage_change` catches up when a file already got edited WITHOUT `edit_node` — same shape, but it locates `new_string` already on disk instead of writing it. `commit_changes` flushes everything staged and takes the one `reasoning` (why/goal) that gets recorded against all of it — **not git**, despite the name: it never runs a git command, it only writes into DevsMind's own local graph. Your actual `git commit`/`git push` is still a separate step you (or your agent, if you ask it to) do yourself. |
 | **Maintenance** | `analyze_graph` (zero-token health check), `recheck_graph`, `rename_node`/`deprecate_node`, and the feedback loop: `read_graph_feedback` → fix → `mark_graph_feedback_processed` |
 | **Multi-day workflows** | `workflow_create`, `workflow_bind` (per session, local to you), `workflow_list`, `workflow_get_context`, `workflow_add_step`, `workflow_sync`, `workflow_archive`, `workflow_import` |
+| **The `devsmind` branch** *(4.3.0)* | `push_devsmind_branch` — **unlike `commit_changes`, this one DOES run real git** (commit + push), but only ever on the dedicated `devsmind` branch; your checked-out branch is never touched. `pull_devsmind_branch` reads it back down and re-syncs `brain.db` |
+| **Adding a repo** *(4.3.0, standalone mode)* | `add_repo` — registers one new repo and indexes it, same local extraction `index_start` uses, scoped to just that repo. Continue with `index_continue`/`index_complete`, passing the `scratchpad` value it returns |
 
 Full descriptions and token-cost notes: see [detailExplanation.md § MCP Tool Reference](detailExplanation.md#-mcp-tool-reference).
 
@@ -302,15 +351,15 @@ The server also declares the MCP **`prompts`** capability, separate from tools:
 
 ## 🗄️ Storage model, briefly
 
-The layout is up top under [Architecture](#-architecture-the-devmind-directory). What matters about it:
+The layout is up top under [Architecture](#-architecture-the-devsmind-directory). What matters about it:
 
 **The JSON is the source of truth, not the database.** `graph/`, `history/`, `vectors/` and `workflows/` are line-oriented JSON — git-mergeable, reviewable in a PR. `brain.db` is a disposable local cache rebuilt from them by `devsmind sync` or on server start, which is why it's gitignored: sharing a SQLite binary would conflict on every merge.
 
 **`local/` is the one thing nothing can regenerate.** Your requests, revert backups and feedback exist only there, on your machine, by design.
 
-**`devsmind init` writes `.devmind/.gitignore`** covering every LOCAL entry and repairs it on each re-run, so a brain from an older version can't leave something exposed. It appends rather than rewrites, so lines you added yourself survive.
+**`devsmind init` writes `.devsmind/.gitignore`** covering every LOCAL entry and repairs it on each re-run, so a brain from an older version can't leave something exposed. It appends rather than rewrites, so lines you added yourself survive.
 
-`brain.db` has 9 tables — 7 documented in [detailExplanation.md § Database Schema](detailExplanation.md#-database-schema-devmindbraindb), plus `node_tokens` and `node_vectors`, which are derived search indexes rebuilt from the nodes themselves.
+`brain.db` has 9 tables — 7 documented in [detailExplanation.md § Database Schema](detailExplanation.md#-database-schema-devsmindbraindb), plus `node_tokens` and `node_vectors`, which are derived search indexes rebuilt from the nodes themselves.
 
 ---
 

package/dist/cli/activity.js

@@ -27,7 +27,7 @@ function dayLabel(dateStr) {
 async function handleActivity(opts) {
     const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
     if (!devmindDir) {
-        console.error(`❌ No .devmind directory found.\n` +
+        console.error(`❌ No .devsmind directory found (nor a legacy .devmind one).\n` +
             `   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.`);
         process.exit(1);
     }

package/dist/cli/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/cli/activity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/cli/activity.ts"],"names":[],"mappings":"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"}

package/dist/cli/add-repo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `devsmind add-repo` — adds ONE repo to an existing STANDALONE brain (prompting for its name
+ * and local path, same as `devsmind init`'s existing-brain path-repair step) and indexes just
+ * that repo, reusing `index --run`'s own machinery via `runBackgroundIndexing({ repos: [name] })`.
+ *
+ * Resumable: if a previous run was interrupted mid-index, re-running this command detects the
+ * pending marker and continues that repo's indexing directly — no name/path prompt again.
+ */
+export declare function handleAddRepo(opts: {
+    path?: string;
+    provider?: string;
+    model?: string;
+    key?: string;
+    url?: string;
+    chunkSize?: string;
+    chunkOverlap?: string;
+    describeBatchSize?: string;
+    rpm?: string;
+    yes?: boolean;
+}): Promise<void>;

package/dist/cli/add-repo.js

@@ -0,0 +1,171 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAddRepo = handleAddRepo;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../utils/config");
+const prompt_1 = require("./integrations/prompt");
+const runner_1 = require("./runner");
+const indexer_1 = require("../db/indexer");
+/** `IndexScratchpad`'s own progress file for this repo's indexing run — kept resumable via
+ *  `runBackgroundIndexing`'s `padFile` override (see runner.ts). Dedicated to `add-repo` alone,
+ *  so resuming it can never collide with (or accidentally resume) an unrelated `--repos` run. */
+const ADD_REPO_INDEX_SCRATCHPAD = 'add_repo_scratchpad.json';
+/**
+ * A tiny marker recording WHICH repo an interrupted `add-repo` run was for — separate from the
+ * indexing scratchpad above, because `config.json`/`.env` are written BEFORE indexing starts, so
+ * a crash in that narrow window (before the indexer has touched a single file, when
+ * `IndexScratchpad.current_repo` is still null) would otherwise leave nothing to resume from.
+ * Deleted once indexing actually reaches `status: 'complete'`.
+ */
+const ADD_REPO_PENDING_FILE = 'add_repo_pending.json';
+function pendingPath(devmindDir) {
+    return path.join(devmindDir, ADD_REPO_PENDING_FILE);
+}
+function readPending(devmindDir) {
+    const p = pendingPath(devmindDir);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * `devsmind add-repo` — adds ONE repo to an existing STANDALONE brain (prompting for its name
+ * and local path, same as `devsmind init`'s existing-brain path-repair step) and indexes just
+ * that repo, reusing `index --run`'s own machinery via `runBackgroundIndexing({ repos: [name] })`.
+ *
+ * Resumable: if a previous run was interrupted mid-index, re-running this command detects the
+ * pending marker and continues that repo's indexing directly — no name/path prompt again.
+ */
+async function handleAddRepo(opts) {
+    const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
+    if (!devmindDir) {
+        console.error(`❌ No .devsmind directory found (nor a legacy .devmind one).\n` +
+            `   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.`);
+        process.exit(1);
+    }
+    const ctx = (0, config_1.loadProjectContext)(devmindDir);
+    if (!(0, config_1.isStandaloneMode)(ctx.config)) {
+        console.error(`❌ devsmind add-repo is only available in standalone mode.\n` +
+            `   An embedded brain already covers exactly the one repo it lives inside — there's nothing to add.`);
+        process.exit(1);
+    }
+    const indexOpts = {
+        devmindPath: devmindDir,
+        provider: opts.provider ?? 'gemini',
+        model: opts.model,
+        key: opts.key,
+        url: opts.url,
+        chunkSize: opts.chunkSize ? parseInt(opts.chunkSize, 10) : undefined,
+        chunkOverlap: opts.chunkOverlap ? parseInt(opts.chunkOverlap, 10) : undefined,
+        describeBatchSize: opts.describeBatchSize ? parseInt(opts.describeBatchSize, 10) : undefined,
+        rpm: opts.rpm ? parseInt(opts.rpm, 10) : undefined,
+        yes: !!opts.yes,
+        padFile: ADD_REPO_INDEX_SCRATCHPAD
+    };
+    const pending = readPending(devmindDir);
+    let repoName;
+    if (pending) {
+        repoName = pending.repo_name;
+        console.log(`\n🔁 DevsMind — Resuming add-repo for "${repoName}"`);
+    }
+    else {
+        console.log(`\n➕ DevsMind — Add a repo to this brain`);
+        try {
+            repoName = await (0, prompt_1.textPrompt)('Repository name?', {
+                validate: v => {
+                    const trimmed = v.trim();
+                    if (!trimmed)
+                        return 'A name is required.';
+                    if (ctx.config.repos.some(r => r.name === trimmed))
+                        return `A repo named "${trimmed}" already exists in this brain.`;
+                    return true;
+                }
+            });
+        }
+        catch (err) {
+            if (err instanceof prompt_1.CancelledError) {
+                console.log('\nCancelled.');
+                return;
+            }
+            throw err;
+        }
+        const localPath = await (0, prompt_1.browseForDir)(`Select the local folder for repository "${repoName}"`, process.cwd());
+        if (localPath === null) {
+            console.log('\nCancelled.');
+            return;
+        }
+        const pathKey = `REPO_${repoName.toUpperCase().replace(/[^A-Z0-9]/g, '_')}`;
+        const newRepo = { name: repoName, path_key: pathKey };
+        const configPath = path.join(devmindDir, 'config.json');
+        ctx.config.repos.push(newRepo);
+        fs.writeFileSync(configPath, JSON.stringify(ctx.config, null, 2) + '\n', 'utf-8');
+        console.log(`\n💾 Added "${repoName}" to ${configPath.replace(/\\/g, '/')}`);
+        const envPath = path.join(devmindDir, '.env');
+        const envLines = fs.existsSync(envPath)
+            ? fs.readFileSync(envPath, 'utf-8').split('\n').filter(l => l.trim())
+            : [];
+        envLines.push(`${pathKey}=${localPath}`);
+        fs.writeFileSync(envPath, envLines.join('\n') + '\n', 'utf-8');
+        console.log(`💾 Updated ${envPath.replace(/\\/g, '/')}`);
+        fs.writeFileSync(pendingPath(devmindDir), JSON.stringify({ repo_name: repoName }, null, 2), 'utf-8');
+    }
+    console.log(`\n🧠 Indexing "${repoName}"...`);
+    try {
+        await (0, runner_1.runBackgroundIndexing)({ ...indexOpts, repos: [repoName] });
+    }
+    catch (err) {
+        console.error(`\n⚠️  Indexing stopped: ${err.message}`);
+        console.error(`   Re-run "devsmind add-repo" to continue — it will resume "${repoName}" automatically.`);
+        return;
+    }
+    const pad = (0, indexer_1.readScratchpad)(devmindDir, ADD_REPO_INDEX_SCRATCHPAD);
+    if (pad && pad.status === 'complete') {
+        try {
+            fs.unlinkSync(pendingPath(devmindDir));
+        }
+        catch { /* best-effort */ }
+        console.log(`\n✅ "${repoName}" added and indexed.`);
+    }
+    else {
+        console.log(`\nℹ️  Indexing for "${repoName}" is not finished yet. Re-run "devsmind add-repo" to continue.`);
+    }
+}
+//# sourceMappingURL=add-repo.js.map

package/dist/cli/add-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-repo.js","sourceRoot":"","sources":["../../src/cli/add-repo.ts"],"names":[],"mappings":"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"}

package/dist/cli/analyze.js

@@ -39,6 +39,7 @@ const path = __importStar(require("path"));
 const config_1 = require("../utils/config");
 const database_1 = require("../db/database");
 const analyze_1 = require("../db/analyze");
+const sync_progress_1 = require("./sync-progress");
 /**
  * `devsmind analyze` — local, zero-AI graph health check (Phase 1 of the roadmap's
  * `analyze_graph`). Pure SQLite queries, filesystem checks, and `git log` — no LLM
@@ -57,8 +58,14 @@ async function handleAnalyze(opts) {
     const godEntityThreshold = opts.godEntityThreshold ? parseInt(opts.godEntityThreshold, 10) : undefined;
     console.log(`\n🩺 DevsMind — Analyze graph health${opts.fix ? ' (--fix)' : ''}`);
     console.log(`   Brain : ${devmindDir.replace(/\\/g, '/')}`);
-    const db = new database_1.DevMindDatabase(dbPath);
+    // Opening the DB runs a full syncFromDisk() pass — on a large brain that reads every
+    // graph/history/vectors/workflows JSON file back into SQLite, and was previously silent here
+    // (unlike `sync`/`describe`/`embed`, which already wire this same progress line), so it looked
+    // hung instead of working on a many-thousand-node brain.
+    const db = new database_1.DevMindDatabase(dbPath, { onSyncProgress: sync_progress_1.renderSyncProgress });
+    (0, sync_progress_1.clearSyncProgressLine)();
     try {
+        console.log('   Running health checks...');
         const report = (0, analyze_1.runAnalysis)(db, workspaceRoot, { fix: opts.fix === true, godEntityThreshold });
         printReport(report);
     }
@@ -78,6 +85,7 @@ const SECTIONS = [
     { key: 'missing_files', label: 'Nodes with missing files', fixable: true },
     { key: 'renamed_files', label: 'Renamed files (git-detected)', fixable: true },
     { key: 'untracked_files', label: 'Git-tracked files with zero graph nodes', fixable: false },
+    { key: 'stray_output_dirs', label: 'Stray .devmind output directories blocking sync', fixable: true },
 ];
 const MAX_ROWS = 20;
 function printReport(report) {
@@ -136,6 +144,8 @@ function formatRow(key, row) {
             return `[${row.repo}] ${row.from} → ${row.to}${row.migrated ? ' (migrated)' : ''}`;
         case 'untracked_files':
             return `[${row.repo}] ${row.file}`;
+        case 'stray_output_dirs':
+            return `${row.kind} — ${row.target} (blocked writes for ${row.file_path})`;
         default:
             return JSON.stringify(row);
     }

package/dist/cli/analyze.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/cli/analyze.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/cli/analyze.ts"],"names":[],"mappings":"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"}

package/dist/cli/branch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `devsmind push` — commits the current graph/history/vectors/workflows onto the dedicated
+ * `devsmind` branch and pushes it, leaving your actual checked-out branch untouched. See
+ * `utils/devsmind-branch.ts` for why: this is what keeps a PR diff to your real code changes
+ * instead of the hundreds of graph/history files DevsMind itself writes.
+ */
+export declare function handlePush(opts: {
+    path?: string;
+    message?: string;
+}): Promise<void>;
+/**
+ * `devsmind pull` — the read side of `devsmind push`: copies graph/history/vectors/workflows
+ * down from the `devsmind` branch (preferring the remote-tracking ref when a remote exists)
+ * into the real `.devsmind/` on disk, then fully re-syncs `brain.db` from it (both directions,
+ * same as `devsmind sync`). Needed because a fresh clone of the code branch alone no longer
+ * carries that data — see CHANGELOG 4.3.0.
+ *
+ * Runs the SAME `reconcileRepoPaths` pre-flight `devsmind sync` does — a pull is exactly the
+ * other moment (besides a plain `sync`) a repo a teammate added elsewhere would first become
+ * visible on this machine, so it needs the same catch-up walkthrough, not a thinner copy of it.
+ */
+export declare function handlePull(opts: {
+    path?: string;
+}): Promise<void>;