devsmind-mcp 2.4.0 → 3.0.0

package/dist/cli/activity.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleActivity = handleActivity;
+const config_1 = require("../utils/config");
+const activity_1 = require("../db/activity");
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RED = '\x1b[31m';
+const RESET = '\x1b[0m';
+function dayLabel(dateStr) {
+    const d = new Date(dateStr);
+    const today = new Date();
+    const yesterday = new Date(today);
+    yesterday.setDate(yesterday.getDate() - 1);
+    const sameDay = (a, b) => a.toDateString() === b.toDateString();
+    if (sameDay(d, today))
+        return 'Today';
+    if (sameDay(d, yesterday))
+        return 'Yesterday';
+    return d.toLocaleDateString(undefined, { weekday: 'long', month: 'short', day: 'numeric' });
+}
+/**
+ * `devsmind activity` — the local, gitignored timeline in the terminal: read-only, same store
+ * `devsmind view` → Activity reads. Revert/un-revert stays on the page, where the diff and the
+ * confirmation live together; this is for a quick "what did I do" check without a browser.
+ */
+async function handleActivity(opts) {
+    const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
+    if (!devmindDir) {
+        console.error(`❌ No .devmind directory found.\n` +
+            `   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.`);
+        process.exit(1);
+    }
+    const sinceDays = opts.since ? parseInt(opts.since, 10) : undefined;
+    const cutoff = sinceDays !== undefined && !Number.isNaN(sinceDays)
+        ? Date.now() - sinceDays * 24 * 60 * 60 * 1000
+        : null;
+    let messages = (0, activity_1.listMessages)(devmindDir); // newest-created-first
+    if (cutoff !== null) {
+        messages = messages.filter(m => new Date(m.created_at).getTime() >= cutoff);
+    }
+    if (!messages.length) {
+        console.log(`\n🗓️  No activity recorded${cutoff !== null ? ` in the last ${sinceDays} day(s)` : ''}.\n` +
+            `   This fills in as edit_node + commit_changes run. Pass ${BOLD}message${RESET} on commit_changes\n` +
+            `   so requests get titled here instead of just summarized.\n`);
+        return;
+    }
+    const byDay = new Map();
+    for (const m of messages) {
+        const key = new Date(m.created_at).toDateString();
+        if (!byDay.has(key))
+            byDay.set(key, []);
+        byDay.get(key).push(m);
+    }
+    console.log('');
+    for (const [, dayMessages] of byDay) {
+        console.log(`${BOLD}${dayLabel(dayMessages[0].created_at)}${RESET}  ${DIM}${dayMessages.length} message(s)${RESET}`);
+        for (const m of dayMessages) {
+            const time = new Date(m.created_at).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+            const title = m.request || m.summary || '(untitled change)';
+            const revertedTag = m.status === 'reverted' ? `  ${RED}[reverted]${RESET}` : '';
+            console.log(`  ${DIM}${time}${RESET}  ${title}${revertedTag}`);
+            console.log(`  ${DIM}${' '.repeat(time.length)}  ${m.edits.length} change(s) · ${m.id}${RESET}`);
+        }
+        console.log('');
+    }
+    console.log(`${DIM}Full diffs + revert: devsmind view → Activity${RESET}\n`);
+}
+//# sourceMappingURL=activity.js.map

package/dist/cli/activity.js.map

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

package/dist/cli/describe.d.ts

@@ -0,0 +1,31 @@
+import { DevMindDatabase } from '../db/database';
+import { LlmCredentials } from './llm-client';
+export interface DescribeRunResult {
+    /** Nodes with no description at the moment `describePendingNodes` was called. */
+    pending: number;
+    described: number;
+    failed: number;
+    skipped: number;
+    embedded: number;
+}
+/**
+ * Describes every currently-undescribed, non-deprecated node using already-resolved `creds`.
+ * Shared by `handleDescribe` (which resolves creds from its own --provider/--key CLI flags) and
+ * `runBackgroundIndexing`'s optional Phase 3 (which reuses the creds it already resolved for
+ * extraction — same provider, same call, no separate credential setup).
+ */
+export declare function describePendingNodes(db: DevMindDatabase, creds: LlmCredentials, opts?: {
+    batchSize?: number;
+    rpm?: number;
+    log?: (msg: string) => void;
+}): Promise<DescribeRunResult>;
+export declare function handleDescribe(opts: {
+    path?: string;
+    provider: 'gemini' | 'vertex' | 'ollama';
+    model?: string;
+    key?: string;
+    url?: string;
+    rpm?: number;
+    batchSize?: number;
+    dryRun?: boolean;
+}): Promise<void>;

package/dist/cli/describe.js

@@ -0,0 +1,201 @@
+"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.describePendingNodes = describePendingNodes;
+exports.handleDescribe = handleDescribe;
+const path = __importStar(require("path"));
+const database_1 = require("../db/database");
+const config_1 = require("../utils/config");
+const llm_client_1 = require("./llm-client");
+const runner_1 = require("./runner");
+const tokenize_1 = require("../utils/tokenize");
+const json_1 = require("../utils/json");
+const embedder_1 = require("../db/embedder");
+const sync_progress_1 = require("./sync-progress");
+/**
+ * The one-off backfill for nodes that already exist but predate the description requirement
+ * (or were created by a teammate on an older devsmind version). The GROW-AS-YOU-GO path — the
+ * commit_changes gate + add_description — is what keeps new nodes described going forward;
+ * this command is only for clearing an existing backlog, and is always safe to re-run: the
+ * work queue is simply `WHERE description IS NULL`, so nothing here can double-describe a node
+ * or lose track of progress on interruption.
+ *
+ * The core loop (`describePendingNodes`) is also reused as an optional Phase 3 of
+ * `devsmind index --run` (see runner.ts's `--describe` flag) — `devsmind index --run`'s own
+ * Phase 1 extraction never writes a description (it's LLM-extracted structure only), so its
+ * nodes start out exactly as undescribed as a pre-description-requirement backlog would be, and
+ * the SAME credentials already resolved for indexing can describe them immediately afterward
+ * instead of requiring a separate `devsmind describe` invocation with its own --key/--provider.
+ */
+const BATCH_SIZE = 25;
+const SYSTEM_PROMPT = 'You are documenting an existing codebase for a semantic search index. For each code entity given, write a 1-3 sentence natural-language DESCRIPTION of what it actually DOES and the domain concepts involved — using words a developer would search by later (e.g. mention "login"/"sign-in"/"authentication" together, not just whichever single term the code happens to use). NEVER restate the identifier\'s own name back as the description ("verifyCredentials" -> "verifies credentials" is rejected — it adds no new searchable vocabulary). Return ONLY a JSON object matching {"descriptions": [{"node_id": "...", "description": "..."}]} — exactly one entry per entity given, node_id copied verbatim, in the same order. No markdown fences, no extra commentary.';
+function buildUserPrompt(nodes) {
+    return nodes.map(n => `node_id: ${n.node_id}\nname: ${n.name}\ntype: ${n.type}\nsignature: ${n.signature || '(none)'}\nfile: ${n.file_path}\ncode:\n${n.code.slice(0, 2000)}`).join('\n---\n');
+}
+/**
+ * Describes every currently-undescribed, non-deprecated node using already-resolved `creds`.
+ * Shared by `handleDescribe` (which resolves creds from its own --provider/--key CLI flags) and
+ * `runBackgroundIndexing`'s optional Phase 3 (which reuses the creds it already resolved for
+ * extraction — same provider, same call, no separate credential setup).
+ */
+async function describePendingNodes(db, creds, opts = {}) {
+    const log = opts.log ?? console.log;
+    const pending = db.getAllNodes().filter(n => !n.deprecated && !n.description);
+    const result = { pending: pending.length, described: 0, failed: 0, skipped: 0, embedded: 0 };
+    if (pending.length === 0) {
+        log('✅ Nothing to describe — every node already has one.');
+        return result;
+    }
+    log(`   Pending  : ${pending.length} node(s) with no description`);
+    // Checked once, not per-batch — if the optional ONNX dependency is absent this stays false for
+    // the whole run and every batch just skips the embed step. Description-writing still succeeds
+    // either way; an unembedded description is picked up later by `devsmind embed`.
+    const embedderAvailable = await (0, embedder_1.isEmbedderAvailable)();
+    if (!embedderAvailable) {
+        log('   (semantic embedder unavailable — descriptions will be written without vectors; run "devsmind embed" later once it is)');
+    }
+    const batchSize = Math.max(1, opts.batchSize || BATCH_SIZE);
+    for (let i = 0; i < pending.length; i += batchSize) {
+        const batch = pending.slice(i, i + batchSize);
+        const candidates = [];
+        for (const n of batch) {
+            const latest = db.getLatestCode(n.id);
+            if (!latest?.code_snapshot) {
+                result.skipped++;
+                continue;
+            } // nothing to describe FROM
+            candidates.push({ node_id: n.id, name: n.name, type: n.type, signature: n.signature, file_path: n.file_path, code: latest.code_snapshot });
+        }
+        if (candidates.length === 0)
+            continue;
+        log(`\n[${Math.min(i + batchSize, pending.length)}/${pending.length}] describing a batch of ${candidates.length}...`);
+        let raw;
+        try {
+            await (0, runner_1.throttleRpm)(opts.rpm);
+            raw = await (0, llm_client_1.sendPromptWithRetry)(creds, SYSTEM_PROMPT, buildUserPrompt(candidates), {
+                onRetry: (msg) => log(`   ⚠ ${msg}`)
+            });
+        }
+        catch (err) {
+            // Per-batch failures are non-fatal — this batch's nodes stay undescribed (still NULL) and
+            // get picked up again automatically on the next `devsmind describe` run. Nothing to clean
+            // up, nothing lost.
+            log(`   ❌ batch failed after retries (${err.message}) — skipping, safe to re-run this command later`);
+            result.failed += candidates.length;
+            continue;
+        }
+        const parsed = (0, json_1.safeJsonParse)(raw, {});
+        const byId = new Map((parsed.descriptions || []).map(it => [it.node_id, it.description]));
+        // Accumulated across this batch and flushed as ONE embedding call below, after the
+        // description-write loop — batching matters far more for ONNX inference than it did for
+        // describe's own HTTP calls, so embedding one-at-a-time inside the loop would be wasteful.
+        const toEmbed = [];
+        for (const n of candidates) {
+            const description = byId.get(n.node_id);
+            if (!description) {
+                result.failed++;
+                log(`   ⚠ no description returned for ${n.node_id}`);
+                continue;
+            }
+            const check = (0, tokenize_1.validateDescription)(description, n.node_id);
+            if (!check.ok) {
+                result.failed++;
+                log(`   ⚠ rejected for ${n.node_id}: ${check.error}`);
+                continue;
+            }
+            db.upsertNode({ id: n.node_id, type: n.type, name: n.name, file_path: n.file_path, description });
+            result.described++;
+            if (embedderAvailable)
+                toEmbed.push({ node_id: n.node_id, description });
+        }
+        if (toEmbed.length > 0) {
+            const vectors = await (0, embedder_1.embedTextsInt8)(toEmbed.map(t => t.description));
+            if (vectors) {
+                for (let j = 0; j < toEmbed.length; j++) {
+                    db.upsertNodeVector(toEmbed[j].node_id, vectors[j], (0, embedder_1.hashDescription)(toEmbed[j].description));
+                    result.embedded++;
+                }
+            }
+            else {
+                // Embedder was available a moment ago but failed mid-run — descriptions are already
+                // written and safe; these nodes just fall into `devsmind embed`'s queue for later.
+                log(`   ⚠ embedding failed for this batch — descriptions saved, vectors pending (run "devsmind embed" later)`);
+            }
+        }
+    }
+    log(`\n✅ Described ${result.described} node(s).` +
+        (embedderAvailable ? ` Embedded ${result.embedded}.` : '') +
+        (result.failed ? ` ${result.failed} failed or were rejected (still undescribed — re-run to retry just those).` : '') +
+        (result.skipped ? ` ${result.skipped} skipped (no code snapshot on record to describe from).` : ''));
+    return result;
+}
+async function handleDescribe(opts) {
+    const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
+    if (!devmindDir) {
+        console.error('❌ No .devmind directory found.\n   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.');
+        process.exit(1);
+        return;
+    }
+    console.log(`🧠 DevsMind Describe — backfilling node descriptions`);
+    console.log(`   Brain    : ${devmindDir}`);
+    const db = new database_1.DevMindDatabase(path.join(devmindDir, 'brain.db'), { onSyncProgress: sync_progress_1.renderSyncProgress });
+    (0, sync_progress_1.clearSyncProgressLine)();
+    if (opts.dryRun) {
+        const pending = db.getAllNodes().filter(n => !n.deprecated && !n.description);
+        console.log(`   Pending  : ${pending.length} node(s) with no description`);
+        console.log('   (--dry-run: listing only, no credentials needed, no LLM calls made, nothing written)');
+        for (const n of pending.slice(0, 50))
+            console.log(`   - ${n.id}`);
+        if (pending.length > 50)
+            console.log(`   ... and ${pending.length - 50} more`);
+        db.close();
+        return;
+    }
+    // Credentials are only resolved past this point — --dry-run above never needs them at all.
+    let creds;
+    try {
+        creds = (0, llm_client_1.resolveLlmCredentials)({ provider: opts.provider, model: opts.model, key: opts.key, url: opts.url });
+    }
+    catch (err) {
+        console.error(`❌ ${err.message}`);
+        db.close();
+        process.exit(1);
+        return;
+    }
+    console.log(`   Provider : ${opts.provider}   Model: ${creds.model}`);
+    await describePendingNodes(db, creds, { batchSize: opts.batchSize, rpm: opts.rpm });
+    db.close();
+}
+//# sourceMappingURL=describe.js.map

package/dist/cli/describe.js.map

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

package/dist/cli/diff.d.ts

@@ -0,0 +1,14 @@
+/** `devsmind diff <node_id>` — what the agent changed about one entity, newest last. */
+export declare function handleDiff(nodeId: string, opts: {
+    path?: string;
+}): Promise<void>;
+/**
+ * `devsmind revert <node_id>` — restore an entity to before its newest recorded edit.
+ *
+ * Confirms first, and shows the diff being undone: this erases the change and its recorded
+ * reasoning, and nothing here can bring either back.
+ */
+export declare function handleRevert(nodeId: string, opts: {
+    path?: string;
+    yes?: boolean;
+}): Promise<void>;

package/dist/cli/diff.js

@@ -0,0 +1,161 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDiff = handleDiff;
+exports.handleRevert = handleRevert;
+const path = __importStar(require("path"));
+const prompts_1 = __importDefault(require("prompts"));
+const config_1 = require("../utils/config");
+const database_1 = require("../db/database");
+const diff_1 = require("../utils/diff");
+const revert_1 = require("../db/revert");
+const RED = '\x1b[31m';
+const GREEN = '\x1b[32m';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+function openBrain(optPath) {
+    const devmindDir = (0, config_1.resolveDevmindDir)(optPath);
+    if (!devmindDir) {
+        console.error(`❌ No .devmind directory found.\n` +
+            `   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.`);
+        process.exit(1);
+    }
+    return { db: new database_1.DevMindDatabase(path.join(devmindDir, 'brain.db')), devmindDir };
+}
+function printLines(lines) {
+    for (const l of lines) {
+        if (l.type === 'add')
+            console.log(`${GREEN}+ ${l.text}${RESET}`);
+        else if (l.type === 'del')
+            console.log(`${RED}- ${l.text}${RESET}`);
+        else
+            console.log(`${DIM}  ${l.text}${RESET}`);
+    }
+}
+/** `devsmind diff <node_id>` — what the agent changed about one entity, newest last. */
+async function handleDiff(nodeId, opts) {
+    const { db } = openBrain(opts.path);
+    try {
+        const node = db.getNode(nodeId);
+        const resolvedId = node ? node.id : nodeId;
+        const entry = db.getLatestHistory(resolvedId);
+        if (!entry) {
+            console.log(`\n${BOLD}${resolvedId}${RESET}\n   No history recorded.`);
+            return;
+        }
+        if (!entry.edits.length) {
+            console.log(`\n${BOLD}${resolvedId}${RESET}\n` +
+                `   ${DIM}No diff available — this change was recorded without a before-state.${RESET}\n` +
+                `   ${DIM}Entries predating diff tracking, and stage_change entries (non-TS/JS), have none.${RESET}`);
+            return;
+        }
+        console.log(`\n${BOLD}${resolvedId}${RESET}  ${DIM}${entry.edits.length} edit(s) this session${RESET}`);
+        entry.edits.forEach((e, i) => {
+            const lines = (0, diff_1.diffSnapshots)(e.before, e.after);
+            const added = lines.filter(l => l.type === 'add').length;
+            const removed = lines.filter(l => l.type === 'del').length;
+            console.log(`\n${DIM}── ${new Date(e.at).toLocaleString()}  ${RESET}${GREEN}+${added}${RESET} ${RED}-${removed}${RESET}`);
+            const what = e.reasoning.split('\n').find(l => /^What changed:/i.test(l));
+            if (what)
+                console.log(`${DIM}   ${what.replace(/^What changed:\s*/i, '')}${RESET}`);
+            console.log('');
+            printLines(lines);
+            if (i === entry.edits.length - 1) {
+                console.log(`\n${DIM}   devsmind revert ${resolvedId}   ${RESET}${DIM}undoes this one${RESET}`);
+            }
+        });
+        console.log('');
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * `devsmind revert <node_id>` — restore an entity to before its newest recorded edit.
+ *
+ * Confirms first, and shows the diff being undone: this erases the change and its recorded
+ * reasoning, and nothing here can bring either back.
+ */
+async function handleRevert(nodeId, opts) {
+    const { db, devmindDir } = openBrain(opts.path);
+    try {
+        const node = db.getNode(nodeId);
+        const resolvedId = node ? node.id : nodeId;
+        if (!opts.yes) {
+            if (!process.stdin.isTTY || !process.stdout.isTTY) {
+                console.error(`❌ devsmind revert needs an interactive terminal to confirm. Pass --yes to skip the prompt.`);
+                process.exit(1);
+            }
+            const entry = db.getLatestHistory(resolvedId);
+            if (entry?.edits.length) {
+                const last = entry.edits[entry.edits.length - 1];
+                console.log(`\n${BOLD}${resolvedId}${RESET} — about to undo:\n`);
+                printLines((0, diff_1.diffSnapshots)(last.before, last.after));
+            }
+            const { go } = await (0, prompts_1.default)({
+                type: 'confirm',
+                name: 'go',
+                message: 'Restore the code and erase this change from history?',
+                initial: false
+            });
+            if (!go) {
+                console.log('   Cancelled — nothing changed.');
+                return;
+            }
+        }
+        const result = (0, revert_1.revertLastEdit)(db, devmindDir, resolvedId);
+        if (!result.ok) {
+            console.error(`\n❌ ${result.error}`);
+            process.exit(1);
+        }
+        console.log(`\n✅ Reverted ${resolvedId}`);
+        console.log(`   File    : ${String(result.file_path).replace(/\\/g, '/')}`);
+        if (result.was_staged)
+            console.log(`   ${DIM}The change was still staged, so there was no history to erase.${RESET}`);
+        else if (result.entry_deleted)
+            console.log(`   ${DIM}History entry deleted.${RESET}`);
+        if (result.note)
+            console.log(`   ${DIM}${result.note}${RESET}`);
+        console.log('');
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/diff.js.map

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

package/dist/cli/embed.d.ts

@@ -0,0 +1,6 @@
+export declare function handleEmbed(opts: {
+    path?: string;
+    batchSize?: number;
+    dryRun?: boolean;
+    force?: boolean;
+}): Promise<void>;

package/dist/cli/embed.js

@@ -0,0 +1,109 @@
+"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.handleEmbed = handleEmbed;
+const path = __importStar(require("path"));
+const database_1 = require("../db/database");
+const config_1 = require("../utils/config");
+const embedder_1 = require("../db/embedder");
+const sync_progress_1 = require("./sync-progress");
+/**
+ * The one-off (and re-runnable) backfill that computes vectors for every described node that
+ * doesn't have one yet, or whose vector is stale. Fully local and offline — no `--provider`,
+ * `--key`, or `--rpm` like `describe` has, because inference is on-device: no credentials, no
+ * rate limit. Safe to re-run any time; the work queue (`getNodesNeedingEmbedding`) is naturally
+ * idempotent — a node already carrying a fresh vector for the current model just isn't selected.
+ */
+const BATCH_SIZE = 32;
+async function handleEmbed(opts) {
+    const devmindDir = (0, config_1.resolveDevmindDir)(opts.path);
+    if (!devmindDir) {
+        console.error('❌ No .devmind directory found.\n   Run from inside a DevsMind brain folder, or pass --path <devmind_path>.');
+        process.exit(1);
+        return;
+    }
+    console.log(`🧠 DevsMind Embed — computing semantic vectors`);
+    console.log(`   Brain    : ${devmindDir}`);
+    const db = new database_1.DevMindDatabase(path.join(devmindDir, 'brain.db'), { onSyncProgress: sync_progress_1.renderSyncProgress });
+    (0, sync_progress_1.clearSyncProgressLine)();
+    const pending = db.getNodesNeedingEmbedding(!!opts.force);
+    console.log(`   Pending  : ${pending.length} node(s) need${opts.force ? ' (--force: re-embedding all described nodes)' : ' a vector'}`);
+    if (pending.length === 0) {
+        console.log('✅ Nothing to embed — every described node already has a current vector.');
+        db.close();
+        return;
+    }
+    if (opts.dryRun) {
+        console.log('   (--dry-run: listing only, no inference run, nothing written)');
+        for (const n of pending.slice(0, 50))
+            console.log(`   - ${n.id}`);
+        if (pending.length > 50)
+            console.log(`   ... and ${pending.length - 50} more`);
+        db.close();
+        return;
+    }
+    const available = await (0, embedder_1.isEmbedderAvailable)();
+    if (!available) {
+        console.error('❌ The local embedding model is unavailable — either the optional "onnxruntime-node"\n' +
+            '   dependency failed to install for this platform, or the vendored model files are\n' +
+            '   missing. Semantic search will still fall back to keyword (BM25) search without it.');
+        db.close();
+        process.exit(1);
+        return;
+    }
+    const batchSize = Math.max(1, opts.batchSize || BATCH_SIZE);
+    let embedded = 0, failed = 0;
+    for (let i = 0; i < pending.length; i += batchSize) {
+        const batch = pending.slice(i, i + batchSize);
+        console.log(`\n[${Math.min(i + batchSize, pending.length)}/${pending.length}] embedding a batch of ${batch.length}...`);
+        const vectors = await (0, embedder_1.embedTextsInt8)(batch.map(n => n.description));
+        if (!vectors) {
+            // The embedder was available a moment ago but failed mid-run (rare) — this batch's nodes
+            // stay in the queue (no vector was written) and get retried on the next `devsmind embed`.
+            console.log(`   ❌ batch failed — skipping, safe to re-run this command later`);
+            failed += batch.length;
+            continue;
+        }
+        for (let j = 0; j < batch.length; j++) {
+            const node = batch[j];
+            db.upsertNodeVector(node.id, vectors[j], (0, embedder_1.hashDescription)(node.description));
+            embedded++;
+        }
+    }
+    console.log(`\n✅ Embedded ${embedded} node(s).` +
+        (failed ? ` ${failed} failed (still pending — re-run this command to retry just those).` : ''));
+    db.close();
+}
+//# sourceMappingURL=embed.js.map

package/dist/cli/embed.js.map

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