@saleem11kh/repomem 0.3.1 → 0.5.0

package/dist/tools/mem-search.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memSearch = void 0;
 const file_store_js_1 = require("../store/file-store.js");
+const config_js_1 = require("../config/config.js");
+const embeddings_js_1 = require("../store/embeddings.js");
 const util_js_1 = require("./util.js");
 exports.memSearch = {
     name: "mem_search",
@@ -29,22 +31,32 @@ exports.memSearch = {
         if (!query)
             return "✖ A search query is required.";
         const includeLinked = args.linked === true;
-        const results = includeLinked
+        const lexical = includeLinked
             ? (0, file_store_js_1.searchAllRepos)(query, projectRoot)
             : (0, file_store_js_1.searchFiles)(query, projectRoot);
-        if (results.length === 0) {
-            return `No memory found for "${query}".`;
-        }
-        const lines = [`Found ${results.length} match(es) for "${query}":`, ""];
-        for (const r of results) {
-            lines.push(`${r.scope} ${r.title}  ·  ${r.file}`);
-            lines.push(`   ${r.excerpt}`);
-            if (r.related.length)
-                lines.push(`   → related: ${r.related.join(", ")}`);
-            lines.push("");
-        }
-        lines.push('_Expand any entry with mem_get("type/filename")._');
-        return lines.join("\n").trimEnd();
+        const semantic = (0, config_js_1.loadConfig)(projectRoot).semantic;
+        if (!semantic)
+            return render(lexical, query);
+        // Only this branch is async, so search stays synchronous for everyone who
+        // has not turned semantic search on.
+        const blend = Math.min(1, Math.max(0, semantic.blend ?? 0.5));
+        return (0, embeddings_js_1.semanticScores)(query, projectRoot, semantic)
+            .then((scores) => render((0, file_store_js_1.blendSemantic)(lexical, scores, projectRoot, blend), query))
+            .catch(() => render(lexical, query));
     },
 };
+function render(results, query) {
+    if (results.length === 0)
+        return `No memory found for "${query}".`;
+    const lines = [`Found ${results.length} match(es) for "${query}":`, ""];
+    for (const r of results) {
+        lines.push(`${r.scope} ${r.title}  ·  ${r.file}`);
+        lines.push(`   ${r.excerpt}`);
+        if (r.related.length)
+            lines.push(`   → related: ${r.related.join(", ")}`);
+        lines.push("");
+    }
+    lines.push('_Expand any entry with mem_get("type/filename")._');
+    return lines.join("\n").trimEnd();
+}
 //# sourceMappingURL=mem-search.js.map

package/dist/tools/mem-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"mem-search.js","sourceRoot":"","sources":["../../src/tools/mem-search.ts"],"names":[],"mappings":";;;AAAA,0DAAoF;AACpF,uCAAyC;AAE5B,QAAA,SAAS,GAAY;IAChC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,0EAA0E;QAC1E,2EAA2E;QAC3E,+EAA+E;QAC/E,6EAA6E;QAC7E,sDAAsD;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACvD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,OAAO,CAAC,IAAI,EAAE,WAAW;QACvB,IAAI,CAAC,IAAA,6BAAa,EAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,kEAAkE,CAAC;QAC5E,CAAC;QACD,MAAM,KAAK,GAAG,IAAA,aAAG,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,OAAO,+BAA+B,CAAC;QAEnD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;QAC3C,MAAM,OAAO,GAAG,aAAa;YAC3B,CAAC,CAAC,IAAA,8BAAc,EAAC,KAAK,EAAE,WAAW,CAAC;YACpC,CAAC,CAAC,IAAA,2BAAW,EAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAEpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,wBAAwB,KAAK,IAAI,CAAC;QAC3C,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,mBAAmB,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;CACF,CAAC"}
+{"version":3,"file":"mem-search.js","sourceRoot":"","sources":["../../src/tools/mem-search.ts"],"names":[],"mappings":"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"}

package/dist/tools/session.d.ts

@@ -0,0 +1,40 @@
+export declare const DEFAULT_SESSION_NAME = "untitled";
+export declare const UNKNOWN_AGENT = "unknown";
+export interface SessionState {
+    /** YYYY-MM-DD the session started. */
+    date: string;
+    /** HHMM the session started. */
+    time: string;
+    /** Human name for the session; slugified into the filename. */
+    name: string;
+    /** MCP client that opened the session, e.g. "claude-code". */
+    agent: string;
+    /** "YYYY-MM-DD HH:MM" for the front matter. */
+    startedAt: string;
+    /** Filename once reserved on disk — fixed for the rest of the session. */
+    filename: string | null;
+}
+/** The current session, started lazily on first use. */
+export declare function sessionState(): SessionState;
+/** Record which agent connected — taken from the MCP `initialize` clientInfo. */
+export declare function setSessionAgent(agent: string): void;
+/**
+ * The file this session writes to, chosen once and then fixed. Call before any
+ * session write.
+ */
+export declare function reserveSessionFile(projectRoot: string): string;
+/**
+ * Adopt a name for the running session. If the file was already created under
+ * the old name it is renamed, so one session always maps to exactly one file.
+ * Returns the current filename.
+ */
+export declare function nameSession(name: string, projectRoot: string): string;
+/**
+ * The YAML front matter for a session file. Written once, when the file is
+ * created — sessions previously had none, which is why they were the only type
+ * mem_context could not summarise.
+ */
+export declare function sessionFrontMatter(summary: string, s?: SessionState): string;
+/** Reset session identity. Tests only — each test needs a clean session. */
+export declare function resetSession(): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAID,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,YAAY,CAY3C;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGnD;AAsBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAmBrE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,GAAE,YAA6B,GAAG,MAAM,CAM5F;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/tools/session.js

@@ -0,0 +1,159 @@
+"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.UNKNOWN_AGENT = exports.DEFAULT_SESSION_NAME = void 0;
+exports.sessionState = sessionState;
+exports.setSessionAgent = setSessionAgent;
+exports.reserveSessionFile = reserveSessionFile;
+exports.nameSession = nameSession;
+exports.sessionFrontMatter = sessionFrontMatter;
+exports.resetSession = resetSession;
+/**
+ * Per-session identity for the sessions/ memory type.
+ *
+ * A session used to be identified by its date alone, so everything written on
+ * one day landed in one appended file. Two agents — or two teammates — working
+ * the same day interleaved into a single unreadable narrative and conflicted on
+ * every merge. Each session now owns one file:
+ *
+ *     sessions/YYYY-MM-DD-HHMM-<name>.md
+ *
+ * The timestamp is the session's *start*, so it stays put across appends, and
+ * being zero-padded it makes filename order chronological order.
+ *
+ * The MCP server is stdio-spawned per client session, so module state here lives
+ * exactly as long as the session it describes.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const file_store_js_1 = require("../store/file-store.js");
+const util_js_1 = require("./util.js");
+exports.DEFAULT_SESSION_NAME = "untitled";
+exports.UNKNOWN_AGENT = "unknown";
+let state = null;
+/** The current session, started lazily on first use. */
+function sessionState() {
+    if (!state) {
+        state = {
+            date: (0, util_js_1.today)(),
+            time: (0, util_js_1.clock)(),
+            name: exports.DEFAULT_SESSION_NAME,
+            agent: exports.UNKNOWN_AGENT,
+            startedAt: (0, util_js_1.timestamp)(),
+            filename: null,
+        };
+    }
+    return state;
+}
+/** Record which agent connected — taken from the MCP `initialize` clientInfo. */
+function setSessionAgent(agent) {
+    const trimmed = agent.trim();
+    if (trimmed)
+        sessionState().agent = trimmed;
+}
+function sessionsDir(projectRoot) {
+    return path.join((0, file_store_js_1.getRepomemRoot)(projectRoot), "sessions");
+}
+/**
+ * Candidate filename for a name, stepping past any file another session already
+ * owns. Two sessions starting in the same minute would otherwise land on the
+ * same path and silently braid together — the exact failure this design removes.
+ */
+function freeFilename(name, projectRoot, ignore) {
+    const s = sessionState();
+    const base = `${s.date}-${s.time}-${(0, util_js_1.slugify)(name)}`;
+    const dir = sessionsDir(projectRoot);
+    for (let n = 1;; n++) {
+        const candidate = n === 1 ? `${base}.md` : `${base}-${n}.md`;
+        if (candidate === ignore)
+            return candidate;
+        if (!fs.existsSync(path.join(dir, candidate)))
+            return candidate;
+    }
+}
+/**
+ * The file this session writes to, chosen once and then fixed. Call before any
+ * session write.
+ */
+function reserveSessionFile(projectRoot) {
+    const s = sessionState();
+    if (!s.filename)
+        s.filename = freeFilename(s.name, projectRoot, null);
+    return s.filename;
+}
+/**
+ * Adopt a name for the running session. If the file was already created under
+ * the old name it is renamed, so one session always maps to exactly one file.
+ * Returns the current filename.
+ */
+function nameSession(name, projectRoot) {
+    const s = sessionState();
+    const wanted = name.trim();
+    if (!wanted || (0, util_js_1.slugify)(wanted) === (0, util_js_1.slugify)(s.name))
+        return reserveSessionFile(projectRoot);
+    const previous = s.filename;
+    s.name = wanted;
+    const next = freeFilename(wanted, projectRoot, previous);
+    if (previous && previous !== next) {
+        const dir = sessionsDir(projectRoot);
+        try {
+            fs.renameSync(path.join(dir, previous), path.join(dir, next));
+        }
+        catch {
+            /* a locked or vanished file is not worth failing a save over */
+        }
+    }
+    s.filename = next;
+    return next;
+}
+/**
+ * The YAML front matter for a session file. Written once, when the file is
+ * created — sessions previously had none, which is why they were the only type
+ * mem_context could not summarise.
+ */
+function sessionFrontMatter(summary, s = sessionState()) {
+    const lines = ["---", `date: ${s.date}`, `started: ${s.startedAt}`, `session: ${s.name}`];
+    if (s.agent !== exports.UNKNOWN_AGENT)
+        lines.push(`agent: ${s.agent}`);
+    if (summary)
+        lines.push(`summary: ${summary.replace(/\n+/g, " ").trim()}`);
+    lines.push("---", "");
+    return lines.join("\n");
+}
+/** Reset session identity. Tests only — each test needs a clean session. */
+function resetSession() {
+    state = null;
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

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

package/dist/tools/util.d.ts

@@ -3,12 +3,19 @@ export interface ToolDef {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
-    handler: (args: Record<string, unknown>, projectRoot: string) => string;
+    /**
+     * Returns the tool's text, or a promise of it. Only mem_search ever goes async,
+     * and only when semantic search is switched on — every other tool, and search
+     * itself in the default configuration, stays synchronous.
+     */
+    handler: (args: Record<string, unknown>, projectRoot: string) => string | Promise<string>;
 }
 /** YYYY-MM-DD in local time. */
 export declare function today(): string;
 /** ISO-ish local timestamp for in-file headings. */
 export declare function timestamp(): string;
+/** HHMM in local time — zero-padded so filenames sort chronologically. */
+export declare function clock(): string;
 /** Turn a title into a filesystem-safe kebab slug. */
 export declare function slugify(title: string): string;
 /** Coerce an unknown arg into a trimmed string (empty when absent). */

package/dist/tools/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/tools/util.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;CACzE;AAED,gCAAgC;AAChC,wBAAgB,KAAK,IAAI,MAAM,CAI9B;AAED,oDAAoD;AACpD,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAED,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,uEAAuE;AACvE,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEtC;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAM7C"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/tools/util.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;OAIG;IACH,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,gCAAgC;AAChC,wBAAgB,KAAK,IAAI,MAAM,CAI9B;AAED,oDAAoD;AACpD,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAED,0EAA0E;AAC1E,wBAAgB,KAAK,IAAI,MAAM,CAI9B;AAED,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,uEAAuE;AACvE,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEtC;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAM7C"}

package/dist/tools/util.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.today = today;
 exports.timestamp = timestamp;
+exports.clock = clock;
 exports.slugify = slugify;
 exports.str = str;
 exports.strArray = strArray;
@@ -18,6 +19,12 @@ function timestamp() {
     const pad = (n) => String(n).padStart(2, "0");
     return `${today()} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
 }
+/** HHMM in local time — zero-padded so filenames sort chronologically. */
+function clock() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${pad(d.getHours())}${pad(d.getMinutes())}`;
+}
 /** Turn a title into a filesystem-safe kebab slug. */
 function slugify(title) {
     return title

package/dist/tools/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/tools/util.ts"],"names":[],"mappings":";AAAA,4CAA4C;;AAU5C,sBAIC;AAGD,8BAIC;AAGD,0BAMC;AAGD,kBAEC;AAGD,4BAMC;AAnCD,gCAAgC;AAChC,SAAgB,KAAK;IACnB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,oDAAoD;AACpD,SAAgB,SAAS;IACvB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,sDAAsD;AACtD,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;AAChC,CAAC;AAED,uEAAuE;AACvE,SAAgB,GAAG,CAAC,CAAU;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,iDAAiD;AACjD,SAAgB,QAAQ,CAAC,CAAU;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/tools/util.ts"],"names":[],"mappings":";AAAA,4CAA4C;;AAkB5C,sBAIC;AAGD,8BAIC;AAGD,sBAIC;AAGD,0BAMC;AAGD,kBAEC;AAGD,4BAMC;AA1CD,gCAAgC;AAChC,SAAgB,KAAK;IACnB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,oDAAoD;AACpD,SAAgB,SAAS;IACvB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,0EAA0E;AAC1E,SAAgB,KAAK;IACnB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,sDAAsD;AACtD,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;AAChC,CAAC;AAED,uEAAuE;AACvE,SAAgB,GAAG,CAAC,CAAU;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,iDAAiD;AACjD,SAAgB,QAAQ,CAAC,CAAU;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleem11kh/repomem",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Git-native memory for AI coding agents. .repomem/ commits with your code, clones with your team, works with Claude Code, Cursor, Gemini CLI and more.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",