@nex-ai/nex 0.1.8 → 0.1.9

package/dist/plugin/config.js

@@ -0,0 +1,166 @@
+/**
+ * Plugin configuration — reads from environment variables,
+ * with fallback to ~/.nex-mcp.json (shared with MCP server).
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+/** Shared config file with MCP server — stores registration data. */
+const MCP_CONFIG_PATH = join(homedir(), ".nex-mcp.json");
+export { MCP_CONFIG_PATH };
+/** Read ~/.nex-mcp.json (shared with MCP server registration). */
+export function loadMcpConfig() {
+    try {
+        const raw = readFileSync(MCP_CONFIG_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/** Write registration data to ~/.nex-mcp.json. */
+export function persistRegistration(data) {
+    const existing = loadMcpConfig();
+    if (typeof data.api_key === "string")
+        existing.api_key = data.api_key;
+    if (typeof data.workspace_id === "string" || typeof data.workspace_id === "number") {
+        existing.workspace_id = String(data.workspace_id);
+    }
+    if (typeof data.workspace_slug === "string")
+        existing.workspace_slug = data.workspace_slug;
+    mkdirSync(dirname(MCP_CONFIG_PATH), { recursive: true });
+    writeFileSync(MCP_CONFIG_PATH, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+}
+/**
+ * Load config from environment variables, with fallback to ~/.nex-mcp.json.
+ *
+ * Priority: NEX_API_KEY env > ~/.nex-mcp.json api_key
+ * If neither is set, throws ConfigError with registration instructions.
+ */
+export function loadConfig() {
+    let apiKey = process.env.NEX_API_KEY;
+    if (!apiKey) {
+        // Fallback to shared MCP config
+        const mcpConfig = loadMcpConfig();
+        apiKey = mcpConfig.api_key;
+    }
+    if (!apiKey) {
+        throw new ConfigError("No API key found. Set NEX_API_KEY or run /register to create an account.");
+    }
+    let baseUrl = process.env.NEX_API_BASE_URL ?? "https://app.nex.ai";
+    // Strip trailing slash
+    baseUrl = baseUrl.replace(/\/+$/, "");
+    return { apiKey, baseUrl };
+}
+/**
+ * Load base URL without requiring an API key.
+ * Used for registration (which doesn't need auth).
+ */
+export function loadBaseUrl() {
+    let baseUrl = process.env.NEX_API_BASE_URL ?? "https://app.nex.ai";
+    return baseUrl.replace(/\/+$/, "");
+}
+function parseTomlValue(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    if (/^-?\d+(\.\d+)?$/.test(raw))
+        return Number(raw);
+    if ((raw.startsWith('"') && raw.endsWith('"')) || (raw.startsWith("'") && raw.endsWith("'"))) {
+        return raw.slice(1, -1);
+    }
+    if (raw.startsWith("[") && raw.endsWith("]")) {
+        const inner = raw.slice(1, -1).trim();
+        if (!inner)
+            return [];
+        return inner.split(",").map((item) => parseTomlValue(item.trim()));
+    }
+    return raw;
+}
+function parseToml(content) {
+    const obj = {};
+    const currentSection = [];
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const sectionMatch = trimmed.match(/^\[([^\]]+)\]$/);
+        if (sectionMatch) {
+            currentSection.length = 0;
+            currentSection.push(...sectionMatch[1].split("."));
+            continue;
+        }
+        const kvMatch = trimmed.match(/^([a-zA-Z_][a-zA-Z0-9_.]*)\s*=\s*(.+)$/);
+        if (!kvMatch)
+            continue;
+        const path = [...currentSection, ...kvMatch[1].trim().split(".")];
+        const value = parseTomlValue(kvMatch[2].trim());
+        let target = obj;
+        for (let i = 0; i < path.length - 1; i++) {
+            if (!(path[i] in target) || typeof target[path[i]] !== "object") {
+                target[path[i]] = {};
+            }
+            target = target[path[i]];
+        }
+        target[path[path.length - 1]] = value;
+    }
+    return obj;
+}
+/**
+ * Check if a specific hook is enabled in .nex.toml.
+ * Returns true by default (hooks are opt-out).
+ */
+export function isHookEnabled(hookName) {
+    try {
+        const tomlPath = join(process.cwd(), ".nex.toml");
+        const content = readFileSync(tomlPath, "utf-8");
+        const config = parseToml(content);
+        // Master kill switch
+        if (config.hooks?.enabled === false)
+            return false;
+        // Per-hook setting
+        const hookConfig = config.hooks?.[hookName];
+        if (hookConfig?.enabled === false)
+            return false;
+        return true;
+    }
+    catch {
+        return true; // No .nex.toml or read error → hooks enabled by default
+    }
+}
+const DEFAULT_SCAN_EXTENSIONS = [".md", ".txt", ".csv", ".json", ".yaml", ".yml"];
+const DEFAULT_IGNORE_DIRS = [
+    "node_modules", ".git", "dist", "build", ".next", "__pycache__",
+    "vendor", ".venv", ".claude", "coverage", ".turbo", ".cache",
+];
+/**
+ * Load scan config from NEX_SCAN_* environment variables.
+ * All fields have sensible defaults; NEX_SCAN_ENABLED=false is the kill switch.
+ */
+export function loadScanConfig() {
+    const enabled = (process.env.NEX_SCAN_ENABLED ?? "true").toLowerCase() !== "false";
+    const extensions = process.env.NEX_SCAN_EXTENSIONS
+        ? process.env.NEX_SCAN_EXTENSIONS.split(",").map((e) => e.trim())
+        : DEFAULT_SCAN_EXTENSIONS;
+    const maxFileSize = process.env.NEX_SCAN_MAX_FILE_SIZE
+        ? parseInt(process.env.NEX_SCAN_MAX_FILE_SIZE, 10)
+        : 100_000;
+    const maxFilesPerScan = process.env.NEX_SCAN_MAX_FILES
+        ? parseInt(process.env.NEX_SCAN_MAX_FILES, 10)
+        : 5;
+    const scanDepth = process.env.NEX_SCAN_DEPTH
+        ? parseInt(process.env.NEX_SCAN_DEPTH, 10)
+        : 2;
+    const ignoreDirs = process.env.NEX_SCAN_IGNORE_DIRS
+        ? process.env.NEX_SCAN_IGNORE_DIRS.split(",").map((d) => d.trim())
+        : DEFAULT_IGNORE_DIRS;
+    return { extensions, maxFileSize, maxFilesPerScan, scanDepth, ignoreDirs, enabled };
+}
+//# sourceMappingURL=config.js.map

package/dist/plugin/config.js.map

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

package/dist/plugin/context-files.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Ingests Claude Code context files (CLAUDE.md + memory files) into Nex.
+ *
+ * Reads from both global and project-level locations:
+ * - ~/.claude/CLAUDE.md (global instructions)
+ * - {cwd}/CLAUDE.md (project instructions)
+ * - ~/.claude/projects/{project-key}/memory/MEMORY.md (auto-memory)
+ * - ~/.claude/projects/{project-key}/memory/*.md (topic memory files)
+ *
+ * Uses the file manifest for change detection — unchanged files are skipped.
+ */
+import type { NexClient } from "./nex-client.js";
+import type { RateLimiter } from "./rate-limiter.js";
+export interface ContextFilesResult {
+    ingested: number;
+    skipped: number;
+    errors: number;
+    files: string[];
+}
+/**
+ * Ingest changed CLAUDE.md and memory files into Nex.
+ */
+export declare function ingestContextFiles(client: NexClient, rateLimiter: RateLimiter, cwd: string): Promise<ContextFilesResult>;

package/dist/plugin/context-files.js

@@ -0,0 +1,103 @@
+/**
+ * Ingests Claude Code context files (CLAUDE.md + memory files) into Nex.
+ *
+ * Reads from both global and project-level locations:
+ * - ~/.claude/CLAUDE.md (global instructions)
+ * - {cwd}/CLAUDE.md (project instructions)
+ * - ~/.claude/projects/{project-key}/memory/MEMORY.md (auto-memory)
+ * - ~/.claude/projects/{project-key}/memory/*.md (topic memory files)
+ *
+ * Uses the file manifest for change detection — unchanged files are skipped.
+ */
+import { existsSync, readdirSync, statSync, readFileSync } from "node:fs";
+import { join, extname, basename } from "node:path";
+import { homedir } from "node:os";
+import { readManifest, writeManifest, isChanged, markIngested } from "./file-manifest.js";
+const CLAUDE_DIR = join(homedir(), ".claude");
+const INGEST_TIMEOUT_MS = 10_000;
+const MAX_FILE_SIZE = 100_000;
+/**
+ * Derive the Claude Code project key from a cwd path.
+ * e.g. /Users/foo/bar → -Users-foo-bar
+ */
+function projectKey(cwd) {
+    return cwd.replace(/\//g, "-");
+}
+/**
+ * Collect all context file paths to check.
+ */
+function collectContextFiles(cwd) {
+    const files = [];
+    const key = projectKey(cwd);
+    // 1. Global CLAUDE.md
+    const globalClaude = join(CLAUDE_DIR, "CLAUDE.md");
+    if (existsSync(globalClaude)) {
+        files.push({ path: globalClaude, contextTag: "claude-md:global" });
+    }
+    // 2. Project CLAUDE.md
+    const projectClaude = join(cwd, "CLAUDE.md");
+    if (existsSync(projectClaude)) {
+        files.push({ path: projectClaude, contextTag: "claude-md:project" });
+    }
+    // 3. Memory files: ~/.claude/projects/{key}/memory/*.md
+    const memoryDir = join(CLAUDE_DIR, "projects", key, "memory");
+    if (existsSync(memoryDir)) {
+        try {
+            const entries = readdirSync(memoryDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile())
+                    continue;
+                if (extname(entry.name).toLowerCase() !== ".md")
+                    continue;
+                const fullPath = join(memoryDir, entry.name);
+                const name = basename(entry.name, ".md");
+                files.push({ path: fullPath, contextTag: `claude-memory:${name}` });
+            }
+        }
+        catch {
+            // memoryDir unreadable — skip silently
+        }
+    }
+    return files;
+}
+/**
+ * Ingest changed CLAUDE.md and memory files into Nex.
+ */
+export async function ingestContextFiles(client, rateLimiter, cwd) {
+    const result = { ingested: 0, skipped: 0, errors: 0, files: [] };
+    const manifest = readManifest();
+    const candidates = collectContextFiles(cwd);
+    let dirty = false;
+    for (const { path, contextTag } of candidates) {
+        try {
+            const stat = statSync(path);
+            if (!isChanged(path, stat, manifest)) {
+                result.skipped++;
+                continue;
+            }
+            if (!rateLimiter.canProceed()) {
+                process.stderr.write("[nex-context-files] Rate limited — stopping context file ingest\n");
+                result.skipped += candidates.length - result.ingested - result.skipped - result.errors;
+                break;
+            }
+            let content = readFileSync(path, "utf-8");
+            if (content.length > MAX_FILE_SIZE) {
+                content = content.slice(0, MAX_FILE_SIZE) + "\n[...truncated]";
+            }
+            await client.ingest(content, contextTag, INGEST_TIMEOUT_MS);
+            markIngested(path, stat, contextTag, manifest);
+            result.ingested++;
+            result.files.push(contextTag);
+            dirty = true;
+        }
+        catch (err) {
+            process.stderr.write(`[nex-context-files] Failed to ingest ${contextTag}: ${err instanceof Error ? err.message : String(err)}\n`);
+            result.errors++;
+        }
+    }
+    if (dirty) {
+        writeManifest(manifest);
+    }
+    return result;
+}
+//# sourceMappingURL=context-files.js.map

package/dist/plugin/context-files.js.map

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

package/dist/plugin/context-format.d.ts

@@ -0,0 +1,18 @@
+/**
+ * XML context formatting and stripping for recall injection.
+ * Wraps Nex answers in <nex-context> tags and strips them before capture.
+ */
+export interface NexRecallResult {
+    answer: string;
+    entityCount: number;
+    sessionId?: string;
+}
+/**
+ * Format a Nex /ask response as an XML block for context injection.
+ */
+export declare function formatNexContext(result: NexRecallResult): string;
+/**
+ * Strip all <nex-context>...</nex-context> blocks from text.
+ * Also handles unclosed tags (strips from open tag to end of text).
+ */
+export declare function stripNexContext(text: string): string;

package/dist/plugin/context-format.js

@@ -0,0 +1,34 @@
+/**
+ * XML context formatting and stripping for recall injection.
+ * Wraps Nex answers in <nex-context> tags and strips them before capture.
+ */
+const OPEN_TAG = "<nex-context>";
+const CLOSE_TAG = "</nex-context>";
+/**
+ * Format a Nex /ask response as an XML block for context injection.
+ */
+export function formatNexContext(result) {
+    const parts = [
+        OPEN_TAG,
+        "The following is relevant context from the user's knowledge base. Use it to inform your response, but do not mention this block directly.",
+    ];
+    if (result.entityCount > 0) {
+        parts.push(`[${result.entityCount} related entities found]`);
+    }
+    parts.push("");
+    parts.push(result.answer);
+    parts.push(CLOSE_TAG);
+    return parts.join("\n");
+}
+/**
+ * Strip all <nex-context>...</nex-context> blocks from text.
+ * Also handles unclosed tags (strips from open tag to end of text).
+ */
+export function stripNexContext(text) {
+    // First: strip complete blocks
+    let result = text.replace(/<nex-context>[\s\S]*?<\/nex-context>/g, "");
+    // Then: strip unclosed tags (open tag without matching close)
+    result = result.replace(/<nex-context>[\s\S]*/g, "");
+    return result.trim();
+}
+//# sourceMappingURL=context-format.js.map

package/dist/plugin/context-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-format.js","sourceRoot":"","sources":["../../src/plugin/context-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,QAAQ,GAAG,eAAe,CAAC;AACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAQnC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,MAAM,KAAK,GAAa;QACtB,QAAQ;QACR,2IAA2I;KAC5I,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,0BAA0B,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,+BAA+B;IAC/B,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IACvE,8DAA8D;IAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/plugin/file-manifest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Persistent file manifest — tracks which files have been ingested
+ * using mtime + size as change detection.
+ *
+ * Stored at ~/.nex/file-scan-manifest.json. Follows session-store.ts pattern.
+ */
+import { type Stats } from "node:fs";
+export interface FileManifestEntry {
+    mtime: number;
+    size: number;
+    ingestedAt: number;
+    context: string;
+}
+export interface FileManifest {
+    version: 1;
+    files: Record<string, FileManifestEntry>;
+}
+export declare function readManifest(): FileManifest;
+export declare function writeManifest(manifest: FileManifest): void;
+export declare function isChanged(path: string, stat: Stats, manifest: FileManifest): boolean;
+export declare function markIngested(path: string, stat: Stats, context: string, manifest: FileManifest): void;

package/dist/plugin/file-manifest.js

@@ -0,0 +1,48 @@
+/**
+ * Persistent file manifest — tracks which files have been ingested
+ * using mtime + size as change detection.
+ *
+ * Stored at ~/.nex/file-scan-manifest.json. Follows session-store.ts pattern.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const DATA_DIR = join(homedir(), ".nex");
+const MANIFEST_PATH = join(DATA_DIR, "file-scan-manifest.json");
+export function readManifest() {
+    try {
+        const raw = readFileSync(MANIFEST_PATH, "utf-8");
+        const data = JSON.parse(raw);
+        if (data && data.version === 1 && data.files) {
+            return data;
+        }
+        return { version: 1, files: {} };
+    }
+    catch {
+        return { version: 1, files: {} };
+    }
+}
+export function writeManifest(manifest) {
+    try {
+        mkdirSync(DATA_DIR, { recursive: true });
+        writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2), "utf-8");
+    }
+    catch {
+        // Best-effort — if we can't write, next scan re-ingests
+    }
+}
+export function isChanged(path, stat, manifest) {
+    const entry = manifest.files[path];
+    if (!entry)
+        return true;
+    return entry.mtime !== stat.mtimeMs || entry.size !== stat.size;
+}
+export function markIngested(path, stat, context, manifest) {
+    manifest.files[path] = {
+        mtime: stat.mtimeMs,
+        size: stat.size,
+        ingestedAt: Date.now(),
+        context,
+    };
+}
+//# sourceMappingURL=file-manifest.js.map

package/dist/plugin/file-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manifest.js","sourceRoot":"","sources":["../../src/plugin/file-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAc,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAclC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACzC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;AAEhE,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7C,OAAO,IAAoB,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,IAAI,CAAC;QACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAW,EAAE,QAAsB;IACzE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,IAAW,EACX,OAAe,EACf,QAAsB;IAEtB,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;QACrB,KAAK,EAAE,IAAI,CAAC,OAAO;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/plugin/file-scanner.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Core file scanner — walks project directories, detects changed files,
+ * and ingests them into Nex via the developer API.
+ *
+ * No new dependencies — uses only Node.js built-ins.
+ */
+import type { NexClient } from "./nex-client.js";
+import type { RateLimiter } from "./rate-limiter.js";
+import type { ScanConfig } from "./config.js";
+export interface ScanResult {
+    scanned: number;
+    ingested: number;
+    skipped: number;
+    errors: number;
+}
+/**
+ * Scan project directory for text files and ingest changed ones into Nex.
+ */
+export declare function scanAndIngest(client: NexClient, rateLimiter: RateLimiter, cwd: string, config: ScanConfig): Promise<ScanResult>;

package/dist/plugin/file-scanner.js

@@ -0,0 +1,90 @@
+/**
+ * Core file scanner — walks project directories, detects changed files,
+ * and ingests them into Nex via the developer API.
+ *
+ * No new dependencies — uses only Node.js built-ins.
+ */
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { join, relative, extname } from "node:path";
+import { readManifest, writeManifest, isChanged, markIngested } from "./file-manifest.js";
+/**
+ * Recursively collect candidate files up to scanDepth levels.
+ */
+function walkDir(dir, cwd, config, depth, results) {
+    if (depth > config.scanDepth)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return; // Permission denied or missing — skip silently
+    }
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (config.ignoreDirs.includes(entry.name))
+                continue;
+            walkDir(fullPath, cwd, config, depth + 1, results);
+        }
+        else if (entry.isFile()) {
+            const ext = extname(entry.name).toLowerCase();
+            if (!config.extensions.includes(ext))
+                continue;
+            try {
+                const stat = statSync(fullPath);
+                results.push({
+                    absolutePath: fullPath,
+                    relativePath: relative(cwd, fullPath),
+                    stat,
+                });
+            }
+            catch {
+                // stat failed — skip
+            }
+        }
+    }
+}
+/**
+ * Scan project directory for text files and ingest changed ones into Nex.
+ */
+export async function scanAndIngest(client, rateLimiter, cwd, config) {
+    const result = { scanned: 0, ingested: 0, skipped: 0, errors: 0 };
+    if (!config.enabled)
+        return result;
+    const manifest = readManifest();
+    const candidates = [];
+    walkDir(cwd, cwd, config, 0, candidates);
+    result.scanned = candidates.length;
+    // Filter to changed files, sort by mtime descending (newest first)
+    const changed = candidates
+        .filter((f) => isChanged(f.absolutePath, f.stat, manifest))
+        .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs)
+        .slice(0, config.maxFilesPerScan);
+    result.skipped = candidates.length - changed.length;
+    for (const file of changed) {
+        if (!rateLimiter.canProceed()) {
+            process.stderr.write(`[nex-scan] Rate limited — stopping after ${result.ingested} files\n`);
+            result.skipped += changed.length - result.ingested - result.errors;
+            break;
+        }
+        try {
+            let content = readFileSync(file.absolutePath, "utf-8");
+            // Truncate large files
+            if (content.length > config.maxFileSize) {
+                content = content.slice(0, config.maxFileSize) + "\n[...truncated]";
+            }
+            const context = `file-scan:${file.relativePath}`;
+            await client.ingest(content, context, 10_000);
+            markIngested(file.absolutePath, file.stat, context, manifest);
+            result.ingested++;
+        }
+        catch (err) {
+            process.stderr.write(`[nex-scan] Failed to ingest ${file.relativePath}: ${err instanceof Error ? err.message : String(err)}\n`);
+            result.errors++;
+        }
+    }
+    writeManifest(manifest);
+    return result;
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/plugin/file-scanner.js.map

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

package/dist/plugin/nex-client.d.ts

@@ -0,0 +1,50 @@
+/**
+ * HTTP client for the Nex Developer API.
+ * Adapted from openclaw-plugin — uses native fetch with timeout.
+ */
+export declare class NexAuthError extends Error {
+    constructor(message?: string);
+}
+export declare class NexRateLimitError extends Error {
+    retryAfterMs: number;
+    constructor(retryAfterMs?: number);
+}
+export declare class NexServerError extends Error {
+    status: number;
+    constructor(status: number, body?: string);
+}
+export interface RegisterResponse {
+    api_key: string;
+    workspace_id?: string | number;
+    workspace_slug?: string;
+    [key: string]: unknown;
+}
+export interface IngestResponse {
+    artifact_id: string;
+}
+export interface EntityReference {
+    id?: number;
+    name: string;
+    type: string;
+    count?: number;
+}
+export interface AskResponse {
+    answer: string;
+    session_id?: string;
+    entity_references?: EntityReference[];
+}
+export declare class NexClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl: string);
+    private request;
+    /**
+     * Register a new account and get an API key.
+     * Does NOT require an existing API key — uses the public registration endpoint.
+     */
+    static register(baseUrl: string, email: string, name?: string, companyName?: string): Promise<RegisterResponse>;
+    /** Ingest text content into the Nex knowledge graph. */
+    ingest(content: string, context?: string, timeoutMs?: number): Promise<IngestResponse>;
+    /** Ask a question against the Nex knowledge graph. */
+    ask(query: string, sessionId?: string, timeoutMs?: number): Promise<AskResponse>;
+}