om-memory-system 4.12.0-next.100 → 4.12.0

package/dist/services/api-handlers.d.ts

@@ -1,3 +1,4 @@
+import { type KeywordCount } from "./keyword-counts.js";
 import type { MemoryType } from "../types/index.js";
 import type { UserProfileData } from "./user-profile/types.js";
 interface ApiResponse<T = any> {
@@ -41,6 +42,10 @@ interface PaginatedResponse<T> {
 export declare function handleListTags(): Promise<ApiResponse<{
     project: TagInfo[];
 }>>;
+/** Labels (comma-separated memory tags) with how many memories carry each one. */
+export declare function handleListKeywords(tag?: string): Promise<ApiResponse<{
+    keywords: KeywordCount[];
+}>>;
 export declare function handleListMemories(tag?: string, page?: number, pageSize?: number, includePrompts?: boolean, keyword?: string): Promise<ApiResponse<PaginatedResponse<Memory | any>>>;
 export declare function handleAddMemory(data: {
     content: string;

package/dist/services/api-handlers.js

@@ -6,6 +6,7 @@ import { ensureTursoReady } from "./turso/ready.js";
 import { formatTagsForEmbedding } from "./turso/vector-utils.js";
 import { extractScopeFromContainerTag, tryExtractScopeFromContainerTag } from "./memory-scope.js";
 import { log } from "./logger.js";
+import { countKeywords } from "./keyword-counts.js";
 import { CONFIG } from "../config.js";
 import { userPromptManager } from "./user-prompt/user-prompt-manager.js";
 import { sortProfileItems, stripProfileVectors } from "../utils/profile.js";
@@ -99,38 +100,55 @@ export async function handleListTags() {
         return { success: false, error: String(error) };
     }
 }
+/** Reads stored memory rows for one project tag, or for every project and user shard. */
+async function loadMemoryRows(tag) {
+    const allMemories = [];
+    if (tag) {
+        const { scope: tagScope, hash } = extractScopeFromTag(tag);
+        const shards = await tursoShardManager.getAllShards(tagScope, hash);
+        for (const shard of shards) {
+            const db = await tursoConnectionManager.getConnection(shard.dbPath);
+            const memories = await tursoVectorSearch.listMemories(db, tag, 10000);
+            allMemories.push(...memories);
+        }
+    }
+    else {
+        // Iterate both project- and user-scoped shards. Previously this only
+        // walked project shards, which silently hid user-scope memories from the
+        // listing endpoint (Web UI navigation, /api/memories without a tag
+        // filter, …). User-scope memories still showed up in /api/search and
+        // /api/stats `byType`, but were invisible in /api/stats `byScope` and
+        // unbrowseable in the UI — a confusing UX gap. The filter keeps the
+        // defense-in-depth check on container_tag, just widens it to both
+        // canonical scope markers.
+        const projectShards = await tursoShardManager.getAllShards("project", "");
+        const userShards = await tursoShardManager.getAllShards("user", "");
+        for (const shard of [...projectShards, ...userShards]) {
+            const db = await tursoConnectionManager.getConnection(shard.dbPath);
+            const memories = await tursoVectorSearch.getAllMemories(db);
+            allMemories.push(...memories.filter((m) => m.container_tag?.includes("_project_") || m.container_tag?.includes("_user_")));
+        }
+    }
+    return allMemories;
+}
+/** Labels (comma-separated memory tags) with how many memories carry each one. */
+export async function handleListKeywords(tag) {
+    try {
+        await ensureTursoReady();
+        const rows = await loadMemoryRows(tag);
+        return { success: true, data: { keywords: countKeywords(rows.map((r) => r.tags)) } };
+    }
+    catch (error) {
+        log("handleListKeywords: error", { error: String(error) });
+        return { success: false, error: String(error) };
+    }
+}
 export async function handleListMemories(tag, page = 1, pageSize = 20, includePrompts = true, keyword) {
     try {
         await ensureTursoReady();
         // Listing only reads SQLite rows; no vector ops happen here.
         // See handleListTags comment - keep embedding init out of read paths.
-        const allMemories = [];
-        if (tag) {
-            const { scope: tagScope, hash } = extractScopeFromTag(tag);
-            const shards = await tursoShardManager.getAllShards(tagScope, hash);
-            for (const shard of shards) {
-                const db = await tursoConnectionManager.getConnection(shard.dbPath);
-                const memories = await tursoVectorSearch.listMemories(db, tag, 10000);
-                allMemories.push(...memories);
-            }
-        }
-        else {
-            // Iterate both project- and user-scoped shards. Previously this only
-            // walked project shards, which silently hid user-scope memories from the
-            // listing endpoint (Web UI navigation, /api/memories without a tag
-            // filter, …). User-scope memories still showed up in /api/search and
-            // /api/stats `byType`, but were invisible in /api/stats `byScope` and
-            // unbrowseable in the UI — a confusing UX gap. The filter keeps the
-            // defense-in-depth check on container_tag, just widens it to both
-            // canonical scope markers.
-            const projectShards = await tursoShardManager.getAllShards("project", "");
-            const userShards = await tursoShardManager.getAllShards("user", "");
-            for (const shard of [...projectShards, ...userShards]) {
-                const db = await tursoConnectionManager.getConnection(shard.dbPath);
-                const memories = await tursoVectorSearch.getAllMemories(db);
-                allMemories.push(...memories.filter((m) => m.container_tag?.includes("_project_") || m.container_tag?.includes("_user_")));
-            }
-        }
+        const allMemories = await loadMemoryRows(tag);
         const memoriesWithType = allMemories.map((r) => {
             const metadata = safeJSONParse(r.metadata);
             return {

package/dist/services/keyword-counts.d.ts

@@ -0,0 +1,10 @@
+export interface KeywordCount {
+    keyword: string;
+    count: number;
+}
+/**
+ * Counts labels across stored `tags` fields (comma-separated). Labels are matched
+ * case-insensitively, the same rule the keyword filter uses, and each memory counts
+ * a label once. Sorted by count, then name.
+ */
+export declare function countKeywords(tagFields: Array<string | null | undefined>): KeywordCount[];

package/dist/services/keyword-counts.js

@@ -0,0 +1,21 @@
+/**
+ * Counts labels across stored `tags` fields (comma-separated). Labels are matched
+ * case-insensitively, the same rule the keyword filter uses, and each memory counts
+ * a label once. Sorted by count, then name.
+ */
+export function countKeywords(tagFields) {
+    const counts = new Map();
+    for (const field of tagFields) {
+        if (!field)
+            continue;
+        const labels = new Set(field
+            .split(",")
+            .map((label) => label.trim().toLowerCase())
+            .filter(Boolean));
+        for (const label of labels)
+            counts.set(label, (counts.get(label) ?? 0) + 1);
+    }
+    return [...counts]
+        .map(([keyword, count]) => ({ keyword, count }))
+        .sort((a, b) => b.count - a.count || a.keyword.localeCompare(b.keyword));
+}

package/dist/services/web-server.js

@@ -12,7 +12,7 @@ import { isOlderVersion } from "./version-compare.js";
 import { AUTH_HEADER, getOrCreateAuthToken, isAuthorizedApiRequest } from "./auth-token.js";
 import { WebAuth } from "./web-auth.js";
 import { NODE_HTTP_IDLE_TIMEOUT_MS } from "./request-timeouts.js";
-import { handleListTags, handleListMemories, handleAddMemory, handleDeleteMemory, handleBulkDelete, handleUpdateMemory, handleSearch, handleStats, handlePinMemory, handleUnpinMemory, handleRunCleanup, handleRunDeduplication, handleDetectMigration, handleRunMigration, handleDetectTagMigration, handleRunTagMigrationBatch, handleGetTagMigrationProgress, handleDeletePrompt, handleBulkDeletePrompts, handleGetUserProfile, handleGetProfileChangelog, handleGetProfileSnapshot, handleRefreshProfile, handleAICleanup, handleApplyCleanup, handleUpdateProfileItem, } from "./api-handlers.js";
+import { handleListTags, handleListKeywords, handleListMemories, handleAddMemory, handleDeleteMemory, handleBulkDelete, handleUpdateMemory, handleSearch, handleStats, handlePinMemory, handleUnpinMemory, handleRunCleanup, handleRunDeduplication, handleDetectMigration, handleRunMigration, handleDetectTagMigration, handleRunTagMigrationBatch, handleGetTagMigrationProgress, handleDeletePrompt, handleBulkDeletePrompts, handleGetUserProfile, handleGetProfileChangelog, handleGetProfileSnapshot, handleRefreshProfile, handleAICleanup, handleApplyCleanup, handleUpdateProfileItem, } from "./api-handlers.js";
 const isBun = typeof globalThis.Bun !== "undefined";
 const MIN_FAILED_TAKEOVERS = 3;
 export function attachNodeDisconnectHandlers(req, res, onDisconnect) {
@@ -1184,6 +1184,10 @@ export class WebServer {
                 const result = await handleListTags();
                 return this.jsonResponse(result);
             }
+            if (path === "/api/keywords" && method === "GET") {
+                const result = await handleListKeywords(url.searchParams.get("tag") || undefined);
+                return this.jsonResponse(result);
+            }
             if (path === "/api/memories" && method === "GET") {
                 const tag = url.searchParams.get("tag") || undefined;
                 const page = parseInt(url.searchParams.get("page") || "1");