@nex-ai/nex 0.1.7

package/dist/lib/recall-filter.js

@@ -0,0 +1,58 @@
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const DATA_DIR = join(homedir(), ".nex");
+const STATE_FILE = join(DATA_DIR, "recall-state.json");
+const DEBOUNCE_MS = 30_000;
+const QUESTION_WORDS = /\b(who|what|when|where|why|how|which|tell|explain|describe|summarize|summarise|list|find|show|get|any|does|did|is|are|was|were|have|has|do|can|could|should|would|will)\b/i;
+const TOOL_COMMANDS = /^\s*(run|build|test|lint|format|deploy|install|uninstall|start|stop|restart|commit|push|pull|merge|rebase|checkout|fetch|init|fix|refactor|rename|move|delete|remove|add|create|update|upgrade|downgrade|migrate|generate|scaffold|compile|bundle|watch|serve|debug|profile|bench|clean|reset|undo|redo|revert|squash|cherry-pick|tag|release|publish|npm|npx|yarn|pnpm|bun|pip|cargo|go|make|docker|kubectl|terraform|git|gh|cd|ls|cat|grep|find|mkdir|rm|cp|mv|touch|echo|export|source|chmod|chown|curl|wget|ssh|scp)\b/i;
+const FILE_REF = /(?:[\w./\\-]+\.\w{1,10}|src\/|lib\/|dist\/|node_modules\/|\.\/|\.\.\/)/;
+function isCodeHeavy(text) {
+    const alpha = text.replace(/[^a-zA-Z]/g, "").length;
+    return alpha < text.length * 0.5;
+}
+function readState() {
+    try {
+        return JSON.parse(readFileSync(STATE_FILE, "utf-8"));
+    }
+    catch {
+        return { lastRecallAt: 0 };
+    }
+}
+function writeState(state) {
+    try {
+        mkdirSync(DATA_DIR, { recursive: true });
+        writeFileSync(STATE_FILE, JSON.stringify(state), "utf-8");
+    }
+    catch {
+        /* best-effort */
+    }
+}
+export function recordRecall() {
+    writeState({ lastRecallAt: Date.now() });
+}
+export function shouldRecall(prompt, isFirstPrompt) {
+    const trimmed = prompt.trim();
+    if (isFirstPrompt)
+        return { shouldRecall: true, reason: "first-prompt" };
+    if (trimmed.startsWith("!"))
+        return { shouldRecall: false, reason: "opt-out" };
+    if (trimmed.length < 15)
+        return { shouldRecall: false, reason: "too-short" };
+    const hasQuestion = QUESTION_WORDS.test(trimmed);
+    if (!hasQuestion) {
+        const state = readState();
+        if (state.lastRecallAt > 0 &&
+            Date.now() - state.lastRecallAt < DEBOUNCE_MS) {
+            return { shouldRecall: false, reason: "debounce" };
+        }
+    }
+    if (TOOL_COMMANDS.test(trimmed) && !hasQuestion)
+        return { shouldRecall: false, reason: "tool-command" };
+    if (isCodeHeavy(trimmed) && FILE_REF.test(trimmed) && !hasQuestion)
+        return { shouldRecall: false, reason: "code-prompt" };
+    if (hasQuestion)
+        return { shouldRecall: true, reason: "question" };
+    return { shouldRecall: true, reason: "default" };
+}
+//# sourceMappingURL=recall-filter.js.map

package/dist/lib/recall-filter.js.map

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

package/dist/lib/session-store.d.ts

@@ -0,0 +1,15 @@
+export declare class SessionStore {
+    private filePath;
+    private maxSize;
+    constructor(config?: {
+        maxSize?: number;
+        dataDir?: string;
+    });
+    private readStore;
+    private writeStore;
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    delete(key: string): boolean;
+    list(): Record<string, string>;
+    clear(): void;
+}

package/dist/lib/session-store.js

@@ -0,0 +1,62 @@
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const DEFAULT_MAX = 100;
+const DEFAULT_DATA_DIR = join(homedir(), ".nex");
+export class SessionStore {
+    filePath;
+    maxSize;
+    constructor(config) {
+        const dataDir = config?.dataDir ?? DEFAULT_DATA_DIR;
+        this.maxSize = config?.maxSize ?? DEFAULT_MAX;
+        this.filePath = join(dataDir, "cli-sessions.json");
+        mkdirSync(dataDir, { recursive: true });
+    }
+    readStore() {
+        try {
+            const data = JSON.parse(readFileSync(this.filePath, "utf-8"));
+            if (data && typeof data === "object" && !Array.isArray(data))
+                return data;
+            return {};
+        }
+        catch {
+            return {};
+        }
+    }
+    writeStore(store) {
+        try {
+            writeFileSync(this.filePath, JSON.stringify(store), "utf-8");
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    get(key) {
+        return this.readStore()[key];
+    }
+    set(key, value) {
+        const store = this.readStore();
+        store[key] = value;
+        const keys = Object.keys(store);
+        while (keys.length > this.maxSize) {
+            delete store[keys.shift()];
+        }
+        this.writeStore(store);
+    }
+    delete(key) {
+        const store = this.readStore();
+        if (key in store) {
+            delete store[key];
+            this.writeStore(store);
+            return true;
+        }
+        return false;
+    }
+    list() {
+        return this.readStore();
+    }
+    clear() {
+        this.writeStore({});
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/lib/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/lib/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,OAAO,YAAY;IACf,QAAQ,CAAS;IACjB,OAAO,CAAS;IAExB,YAAY,MAA+C;QACzD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,gBAAgB,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,WAAW,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACnD,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAEO,SAAS;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAC9D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC1D,OAAO,IAA8B,CAAC;YACxC,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAA6B;QAC9C,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAa;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAG,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@nex-ai/nex",
+  "version": "0.1.7",
+  "description": "Nex CLI provides organizational context & memory to AI agents",
+  "type": "module",
+  "bin": {
+    "nex": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "node --import tsx --test tests/**/*.test.ts tests/**/**/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}