@powerhousedao/knowledge-note 1.0.5 → 1.0.6

package/dist/editors/knowledge-vault/components/ActivityView.d.ts

@@ -0,0 +1,2 @@
+export declare function ActivityView(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ActivityView.d.ts.map

package/dist/editors/knowledge-vault/components/ActivityView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityView.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/components/ActivityView.tsx"],"names":[],"mappings":"AAuHA,wBAAgB,YAAY,4CAkJ3B"}

package/dist/editors/knowledge-vault/components/ActivityView.js

@@ -0,0 +1,188 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useMemo, useCallback } from "react";
+import { setSelectedNode, useSelectedDriveId, } from "@powerhousedao/reactor-browser";
+const FILTER_TYPES = {
+    all: { label: "All", ops: [] },
+    content: {
+        label: "Content",
+        ops: ["SET_TITLE", "SET_DESCRIPTION", "SET_CONTENT", "SET_NOTE_TYPE"],
+    },
+    links: {
+        label: "Links",
+        ops: ["ADD_LINK", "REMOVE_LINK", "UPDATE_LINK_TYPE"],
+    },
+    lifecycle: {
+        label: "Lifecycle",
+        ops: [
+            "SET_STATUS",
+            "SUBMIT_FOR_REVIEW",
+            "APPROVE_NOTE",
+            "REJECT_NOTE",
+            "ARCHIVE_NOTE",
+            "RESTORE_NOTE",
+        ],
+    },
+    topics: { label: "Topics", ops: ["ADD_TOPIC", "REMOVE_TOPIC"] },
+};
+const OP_ICONS = {
+    SET_TITLE: "T",
+    SET_DESCRIPTION: "D",
+    SET_CONTENT: "C",
+    SET_NOTE_TYPE: "N",
+    ADD_LINK: "+L",
+    REMOVE_LINK: "-L",
+    ADD_TOPIC: "+#",
+    REMOVE_TOPIC: "-#",
+    SET_STATUS: "S",
+    SUBMIT_FOR_REVIEW: "R",
+    APPROVE_NOTE: "A",
+    REJECT_NOTE: "X",
+    ARCHIVE_NOTE: "Z",
+    RESTORE_NOTE: "U",
+    SET_PROVENANCE: "P",
+    SET_METADATA_FIELD: "M",
+};
+/* ------------------------------------------------------------------ */
+/*  GraphQL                                                           */
+/* ------------------------------------------------------------------ */
+const SUBGRAPH_PATH = "/graphql/knowledgeGraph";
+function getEndpoint() {
+    const envUrl = typeof import.meta !== "undefined" &&
+        import.meta.env?.VITE_SUBGRAPH_URL;
+    if (envUrl)
+        return envUrl;
+    const port = globalThis.window?.location?.port;
+    if (port === "3000" || port === "3001") {
+        return `http://localhost:4001${SUBGRAPH_PATH}`;
+    }
+    return SUBGRAPH_PATH;
+}
+const ACTIVITY_QUERY = `
+  query Activity($driveId: ID!, $limit: Int) {
+    knowledgeGraphActivity(driveId: $driveId, limit: $limit) {
+      id documentId operationType timestamp index summary signerAddress signerApp
+    }
+  }
+`;
+async function fetchActivity(driveId, limit) {
+    try {
+        const res = await fetch(getEndpoint(), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                query: ACTIVITY_QUERY,
+                variables: { driveId, limit },
+            }),
+        });
+        if (!res.ok)
+            return [];
+        const json = (await res.json());
+        return json.data?.knowledgeGraphActivity ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Component                                                         */
+/* ------------------------------------------------------------------ */
+export function ActivityView() {
+    const driveId = useSelectedDriveId();
+    const [operations, setOperations] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [filter, setFilter] = useState("all");
+    const endpoint = useMemo(() => getEndpoint(), []);
+    const loadActivity = useCallback(async () => {
+        if (!driveId)
+            return;
+        setLoading(true);
+        const data = await fetchActivity(driveId, 200);
+        setOperations(data);
+        setLoading(false);
+    }, [driveId]);
+    useEffect(() => {
+        void loadActivity();
+    }, [loadActivity]);
+    const filtered = useMemo(() => {
+        if (filter === "all")
+            return operations;
+        const allowedOps = FILTER_TYPES[filter].ops;
+        return operations.filter((op) => allowedOps.includes(op.operationType));
+    }, [operations, filter]);
+    // Group by date
+    const grouped = useMemo(() => {
+        const groups = new Map();
+        for (const op of filtered) {
+            const date = op.timestamp.slice(0, 10);
+            const existing = groups.get(date) ?? [];
+            existing.push(op);
+            groups.set(date, existing);
+        }
+        return groups;
+    }, [filtered]);
+    if (loading) {
+        return (_jsx("div", { className: "flex h-full items-center justify-center text-sm", style: { color: "var(--bai-text-muted)" }, children: "Loading activity..." }));
+    }
+    if (operations.length === 0) {
+        return (_jsxs("div", { className: "flex h-full flex-col items-center justify-center", children: [_jsxs("svg", { className: "mb-4 h-12 w-12", style: { color: "var(--bai-text-faint)", opacity: 0.5 }, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", children: [_jsx("circle", { cx: "12", cy: "12", r: "10" }), _jsx("path", { d: "M12 6v6l4 2" })] }), _jsx("p", { className: "text-sm", style: { color: "var(--bai-text-muted)" }, children: "No activity recorded yet" }), _jsx("p", { className: "mt-1 text-xs", style: { color: "var(--bai-text-faint)" }, children: "Edit notes to start tracking changes" })] }));
+    }
+    return (_jsxs("div", { className: "flex h-full flex-col p-4", children: [_jsxs("div", { className: "mb-4 flex items-center justify-between", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-sm font-semibold", style: { color: "var(--bai-text)" }, children: "Vault Activity" }), _jsxs("p", { className: "text-xs", style: { color: "var(--bai-text-muted)" }, children: [filtered.length, " operation", filtered.length !== 1 ? "s" : "", filter !== "all" ? ` (${FILTER_TYPES[filter].label})` : ""] })] }), _jsx("div", { className: "flex items-center gap-2", children: _jsx("button", { type: "button", onClick: () => void loadActivity(), className: "rounded-md border px-3 py-1.5 text-xs transition-colors", style: {
+                                borderColor: "var(--bai-border)",
+                                color: "var(--bai-text-muted)",
+                                backgroundColor: "var(--bai-surface)",
+                            }, children: "Refresh" }) })] }), _jsx("div", { className: "mb-4 flex flex-wrap gap-1.5", children: Object.keys(FILTER_TYPES).map((key) => (_jsx("button", { type: "button", onClick: () => setFilter(key), className: "rounded-full px-3 py-1 text-xs transition-colors", style: {
+                        backgroundColor: filter === key ? "var(--bai-accent)" : "var(--bai-hover)",
+                        color: filter === key ? "#fff" : "var(--bai-text-muted)",
+                    }, children: FILTER_TYPES[key].label }, key))) }), _jsx("div", { className: "flex-1 overflow-auto", children: [...grouped.entries()].map(([date, ops]) => (_jsxs("div", { className: "mb-6", children: [_jsx("h3", { className: "sticky top-0 z-10 mb-2 py-1 text-xs font-semibold uppercase tracking-wider", style: {
+                                color: "var(--bai-text-muted)",
+                                backgroundColor: "var(--bai-bg)",
+                            }, children: formatDate(date) }), _jsx("div", { className: "space-y-1", children: ops.map((op) => (_jsx(OperationRow, { op: op }, op.id))) })] }, date))) })] }));
+}
+/* ------------------------------------------------------------------ */
+/*  Operation row                                                     */
+/* ------------------------------------------------------------------ */
+function OperationRow({ op }) {
+    const icon = OP_ICONS[op.operationType] ?? "?";
+    const time = op.timestamp.slice(11, 16);
+    return (_jsxs("button", { type: "button", onClick: () => setSelectedNode(op.documentId), className: "group flex w-full items-center gap-3 rounded-lg px-3 py-2 text-left transition-colors hover:bg-[var(--bai-hover)]", children: [_jsx("div", { className: "flex h-7 w-7 shrink-0 items-center justify-center rounded-md text-[10px] font-bold", style: {
+                    backgroundColor: opColor(op.operationType) + "20",
+                    color: opColor(op.operationType),
+                }, children: icon }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-xs", style: { color: "var(--bai-text)" }, children: op.summary ?? op.operationType }), _jsxs("p", { className: "truncate text-[10px]", style: { color: "var(--bai-text-faint)" }, children: [op.documentId.slice(0, 8), "...", op.signerAddress || op.signerApp ? (_jsxs("span", { title: op.signerAddress ?? op.signerApp ?? "", className: "cursor-pointer", style: { color: "var(--bai-accent)", opacity: 0.7 }, onClick: (e) => {
+                                    e.stopPropagation();
+                                    const text = op.signerAddress ?? op.signerApp ?? "";
+                                    void navigator.clipboard.writeText(text);
+                                }, children: [" by ", op.signerAddress
+                                        ? `${op.signerAddress.slice(0, 6)}...${op.signerAddress.slice(-4)}`
+                                        : op.signerApp, " ", _jsxs("svg", { className: "inline-block h-2.5 w-2.5 opacity-0 group-hover:opacity-50", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("rect", { x: "9", y: "9", width: "13", height: "13", rx: "2" }), _jsx("path", { d: "M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1" })] })] })) : null] })] }), _jsx("span", { className: "shrink-0 text-[10px] font-mono", style: { color: "var(--bai-text-faint)" }, children: time }), _jsx("svg", { className: "h-3 w-3 shrink-0 opacity-0 transition-opacity group-hover:opacity-50", style: { color: "var(--bai-text-muted)" }, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M9 18l6-6-6-6" }) })] }));
+}
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                           */
+/* ------------------------------------------------------------------ */
+function opColor(type) {
+    if (type.startsWith("SET_TITLE") || type.startsWith("SET_CONTENT"))
+        return "#f59e0b";
+    if (type.startsWith("ADD_LINK") || type.startsWith("REMOVE_LINK"))
+        return "#3b82f6";
+    if (type.startsWith("ADD_TOPIC") || type.startsWith("REMOVE_TOPIC"))
+        return "#10b981";
+    if (type === "SUBMIT_FOR_REVIEW" ||
+        type === "APPROVE_NOTE" ||
+        type === "REJECT_NOTE")
+        return "#a855f7";
+    if (type === "ARCHIVE_NOTE" || type === "RESTORE_NOTE")
+        return "#6b7280";
+    return "#64748b";
+}
+function formatDate(dateStr) {
+    const today = new Date().toISOString().slice(0, 10);
+    const yesterday = new Date(Date.now() - 86400000).toISOString().slice(0, 10);
+    if (dateStr === today)
+        return "Today";
+    if (dateStr === yesterday)
+        return "Yesterday";
+    return new Date(dateStr + "T00:00:00").toLocaleDateString("en-US", {
+        weekday: "short",
+        month: "short",
+        day: "numeric",
+    });
+}

package/dist/editors/knowledge-vault/components/DriveExplorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DriveExplorer.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/components/DriveExplorer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAiClD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,2CAiWtD"}
+{"version":3,"file":"DriveExplorer.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/components/DriveExplorer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAmClD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,2CAmXtD"}

package/dist/editors/knowledge-vault/components/DriveExplorer.js

@@ -8,6 +8,7 @@ import { NoteList } from "./NoteList.js";
 import { SourceList } from "./SourceList.js";
 import { HealthDashboard } from "./HealthDashboard.js";
 import { SearchView } from "./SearchView.js";
+import { ActivityView } from "./ActivityView.js";
 import { GettingStartedButton } from "./GettingStarted.js";
 import { useKnowledgeNotes } from "../hooks/use-knowledge-notes.js";
 import { useKnowledgeGraph, buildSyncPayload, } from "../hooks/use-knowledge-graph.js";
@@ -129,6 +130,11 @@ export function DriveExplorer({ children }) {
             badge: sourceCount > 0 ? sourceCount : undefined,
             icon: (_jsxs("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("path", { d: "M4 19.5A2.5 2.5 0 016.5 17H20" }), _jsx("path", { d: "M6.5 2H20v20H6.5A2.5 2.5 0 014 19.5v-15A2.5 2.5 0 016.5 2z" })] })),
         },
+        {
+            key: "activity",
+            label: "Activity",
+            icon: (_jsxs("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("circle", { cx: "12", cy: "12", r: "10" }), _jsx("path", { d: "M12 6v6l4 2" })] })),
+        },
         {
             key: "pipeline",
             label: "Pipeline",
@@ -161,7 +167,7 @@ export function DriveExplorer({ children }) {
                                                 }, children: tab.badge }))] }, tab.key))), showDocumentEditor && (_jsxs("span", { className: "flex items-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium", style: {
                                             backgroundColor: "var(--bai-hover)",
                                             color: "var(--bai-accent)",
-                                        }, children: [_jsxs("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("path", { d: "M11 4H4a2 2 0 00-2 2v14a2 2 0 002 2h14a2 2 0 002-2v-7" }), _jsx("path", { d: "M18.5 2.5a2.121 2.121 0 013 3L12 15l-4 1 1-4 9.5-9.5z" })] }), "Editing"] }))] }), _jsxs("div", { className: "flex items-center gap-3", children: [hasGraphDoc && graphState && (_jsxs("span", { className: "text-[10px]", style: { color: "var(--bai-text-faint)" }, children: [graphState.nodes.length, "n / ", graphState.edges.length, "e"] })), _jsx(ThemeToggle, {}), _jsx(GettingStartedButton, {}), _jsx(CreateMenu, {})] })] }), _jsx("div", { className: "flex-1 overflow-auto", children: showDocumentEditor ? (_jsx("div", { className: "h-full", children: children })) : viewMode === "graph" ? (_jsx(GraphView, { notes: notes, graphState: graphState, mocs: mocs, tensions: tensions })) : viewMode === "search" ? (_jsx(SearchView, {})) : viewMode === "sources" ? (_jsx(SourceList, {})) : viewMode === "health" ? (_jsx(HealthDashboard, {})) : (_jsx(NoteList, { notes: notes })) })] })] }));
+                                        }, children: [_jsxs("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("path", { d: "M11 4H4a2 2 0 00-2 2v14a2 2 0 002 2h14a2 2 0 002-2v-7" }), _jsx("path", { d: "M18.5 2.5a2.121 2.121 0 013 3L12 15l-4 1 1-4 9.5-9.5z" })] }), "Editing"] }))] }), _jsxs("div", { className: "flex items-center gap-3", children: [hasGraphDoc && graphState && (_jsxs("span", { className: "text-[10px]", style: { color: "var(--bai-text-faint)" }, children: [graphState.nodes.length, "n / ", graphState.edges.length, "e"] })), _jsx(ThemeToggle, {}), _jsx(GettingStartedButton, {}), _jsx(CreateMenu, {})] })] }), _jsx("div", { className: "flex-1 overflow-auto", children: showDocumentEditor ? (_jsx("div", { className: "h-full", children: children })) : viewMode === "graph" ? (_jsx(GraphView, { notes: notes, graphState: graphState, mocs: mocs, tensions: tensions })) : viewMode === "search" ? (_jsx(SearchView, {})) : viewMode === "activity" ? (_jsx(ActivityView, {})) : viewMode === "sources" ? (_jsx(SourceList, {})) : viewMode === "health" ? (_jsx(HealthDashboard, {})) : (_jsx(NoteList, { notes: notes })) })] })] }));
 }
 const CREATE_ITEMS = [
     {

package/dist/editors/knowledge-vault/components/SearchView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchView.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/components/SearchView.tsx"],"names":[],"mappings":"AA+CA,wBAAgB,UAAU,4CAmGzB"}
+{"version":3,"file":"SearchView.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/components/SearchView.tsx"],"names":[],"mappings":"AA+CA,wBAAgB,UAAU,4CAsGzB"}

package/dist/editors/knowledge-vault/components/SearchView.js

@@ -43,19 +43,19 @@ export function SearchView() {
                                     backgroundColor: "var(--bai-surface)",
                                     borderColor: "var(--bai-border)",
                                     color: "var(--bai-text)",
-                                } }), query && (_jsx("button", { type: "button", onClick: () => setQuery(""), className: "absolute right-3 top-1/2 -translate-y-1/2 rounded p-0.5 transition-colors hover:opacity-80", style: { color: "var(--bai-text-muted)" }, children: _jsx("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M18 6 6 18M6 6l12 12" }) }) }))] }), _jsx(ModeToggle, { mode: searchMode, onChange: setSearchMode })] }), query.trim() && (_jsxs("div", { className: "mb-3 flex items-center gap-2 text-xs", style: { color: "var(--bai-text-muted)" }, children: [loading ? (_jsx("span", { children: "Searching..." })) : (_jsxs(_Fragment, { children: [_jsxs("span", { children: [results.length, " result", results.length !== 1 ? "s" : ""] }), searchMode === "semantic" && results.length > 0 && (_jsx("span", { style: { opacity: 0.6 }, children: "\u2014 match % shows how closely each note relates to your query by meaning" }))] })), error && _jsx("span", { style: { color: "#ef4444" }, children: error })] })), _jsx("div", { className: "flex-1 overflow-auto", children: !query.trim() ? (_jsx(EmptyState, { topics: topics, onTopicClick: setQuery })) : (_jsx(ResultList, { results: results, searchMode: searchMode })) })] }));
+                                } }), query && (_jsx("button", { type: "button", onClick: () => setQuery(""), className: "absolute right-3 top-1/2 -translate-y-1/2 rounded p-0.5 transition-colors hover:opacity-80", style: { color: "var(--bai-text-muted)" }, children: _jsx("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M18 6 6 18M6 6l12 12" }) }) }))] }), _jsx(ModeToggle, { mode: searchMode, onChange: setSearchMode })] }), query.trim() && (_jsxs("div", { className: "mb-3 flex items-center gap-2 text-xs", style: { color: "var(--bai-text-muted)" }, children: [loading ? (_jsx("span", { children: "Searching..." })) : (_jsxs(_Fragment, { children: [_jsxs("span", { children: [results.length, " result", results.length !== 1 ? "s" : ""] }), (searchMode === "semantic" || searchMode === "hybrid") &&
+                                results.length > 0 && (_jsxs("span", { style: { opacity: 0.6 }, children: ["\u2014 score shows relevance", searchMode === "hybrid"
+                                        ? " combining keyword + semantic matching"
+                                        : " by meaning"] }))] })), error && _jsx("span", { style: { color: "#ef4444" }, children: error })] })), _jsx("div", { className: "flex-1 overflow-auto", children: !query.trim() ? (_jsx(EmptyState, { topics: topics, onTopicClick: setQuery })) : (_jsx(ResultList, { results: results, searchMode: searchMode })) })] }));
 }
 /* ------------------------------------------------------------------ */
 /*  Mode toggle                                                       */
 /* ------------------------------------------------------------------ */
 function ModeToggle({ mode, onChange, }) {
-    return (_jsxs("div", { className: "flex shrink-0 overflow-hidden rounded-lg border text-xs", style: { borderColor: "var(--bai-border)" }, children: [_jsx("button", { type: "button", onClick: () => onChange("semantic"), className: "px-3 py-2 transition-colors", style: {
-                    backgroundColor: mode === "semantic" ? "var(--bai-accent)" : "var(--bai-surface)",
-                    color: mode === "semantic" ? "#fff" : "var(--bai-text-muted)",
-                }, children: "Semantic" }), _jsx("button", { type: "button", onClick: () => onChange("keyword"), className: "px-3 py-2 transition-colors", style: {
-                    backgroundColor: mode === "keyword" ? "var(--bai-accent)" : "var(--bai-surface)",
-                    color: mode === "keyword" ? "#fff" : "var(--bai-text-muted)",
-                }, children: "Keyword" })] }));
+    return (_jsx("div", { className: "flex shrink-0 overflow-hidden rounded-lg border text-xs", style: { borderColor: "var(--bai-border)" }, children: ["hybrid", "semantic", "keyword"].map((m) => (_jsx("button", { type: "button", onClick: () => onChange(m), className: "px-3 py-2 transition-colors capitalize", style: {
+                backgroundColor: mode === m ? "var(--bai-accent)" : "var(--bai-surface)",
+                color: mode === m ? "#fff" : "var(--bai-text-muted)",
+            }, children: m }, m))) }));
 }
 /* ------------------------------------------------------------------ */
 /*  Empty state                                                       */
@@ -78,7 +78,7 @@ function ResultList({ results, searchMode, }) {
     if (results.length === 0) {
         return (_jsx("div", { className: "py-12 text-center text-sm", style: { color: "var(--bai-text-muted)" }, children: "No results found" }));
     }
-    return (_jsx("div", { className: "space-y-2", children: results.map((result) => (_jsx(ResultCard, { result: result, showSimilarity: searchMode === "semantic" }, result.documentId))) }));
+    return (_jsx("div", { className: "space-y-2", children: results.map((result) => (_jsx(ResultCard, { result: result, showSimilarity: searchMode !== "keyword" }, result.documentId))) }));
 }
 /* ------------------------------------------------------------------ */
 /*  Result card                                                       */
@@ -86,11 +86,18 @@ function ResultList({ results, searchMode, }) {
 function ResultCard({ result, showSimilarity, }) {
     const status = result.status ?? "DRAFT";
     const badgeStyle = STATUS_COLORS[status] ?? STATUS_COLORS.DRAFT;
-    return (_jsxs("button", { type: "button", onClick: () => setSelectedNode(result.documentId), className: "group flex w-full items-start gap-3 rounded-xl border p-4 text-left transition-all border-[var(--bai-border)] bg-[var(--bai-surface)] hover:border-[var(--bai-accent)] hover:bg-[var(--bai-hover)]", children: [showSimilarity && result.similarity != null && (_jsxs("div", { className: "shrink-0 rounded-md px-2 py-1 text-center font-mono text-xs font-bold", title: "Semantic similarity \u2014 how closely this note's meaning matches your query (higher is better)", style: {
+    return (_jsxs("button", { type: "button", onClick: () => setSelectedNode(result.documentId), className: "group flex w-full items-start gap-3 rounded-xl border p-4 text-left transition-all border-[var(--bai-border)] bg-[var(--bai-surface)] hover:border-[var(--bai-accent)] hover:bg-[var(--bai-hover)]", children: [showSimilarity && result.similarity != null && (_jsxs("div", { className: "shrink-0 rounded-md px-2 py-1 text-center font-mono text-xs font-bold", title: "Relevance score \u2014 how closely this note matches your query (higher is better)", style: {
                     color: similarityColor(result.similarity),
                     backgroundColor: `${similarityColor(result.similarity)}15`,
                 }, children: [(result.similarity * 100).toFixed(0), "%"] })), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "mb-1 flex items-start justify-between gap-2", children: [_jsx("h4", { className: "truncate text-sm font-semibold text-[var(--bai-text)] group-hover:text-[var(--bai-accent)]", children: result.title ?? "Untitled" }), _jsx("span", { className: "shrink-0 rounded-full border px-2 py-0.5 text-[10px] font-medium", style: badgeStyle, children: status.replace("_", " ") })] }), result.description && (_jsx("p", { className: "mb-2 line-clamp-2 text-xs leading-relaxed", style: { color: "var(--bai-text-muted)" }, children: result.description })), _jsxs("div", { className: "flex flex-wrap items-center gap-1.5", children: [result.noteType && (_jsx("span", { className: "rounded px-1.5 py-0.5 text-[10px] font-medium", style: {
                                     background: "var(--bai-hover)",
                                     color: "var(--bai-text-muted)",
-                                }, children: result.noteType })), result.topics?.slice(0, 4).map((topic) => (_jsxs("span", { className: "text-[10px]", style: { color: "var(--bai-accent)", opacity: 0.6 }, children: ["#", topic] }, topic)))] })] }), _jsx("svg", { className: "mt-1 h-4 w-4 shrink-0 opacity-0 transition-opacity group-hover:opacity-60", style: { color: "var(--bai-text-muted)" }, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M9 18l6-6-6-6" }) })] }));
+                                }, children: result.noteType })), result.topics?.slice(0, 4).map((topic) => (_jsxs("span", { className: "text-[10px]", style: { color: "var(--bai-accent)", opacity: 0.6 }, children: ["#", topic] }, topic))), result.matchedBy && result.matchedBy.length > 0 && (_jsx("span", { className: "ml-auto flex gap-1", children: result.matchedBy.map((m) => (_jsx("span", { className: "rounded px-1.5 py-0.5 text-[9px] font-medium", style: {
+                                        background: m === "semantic"
+                                            ? "rgba(139, 92, 246, 0.15)"
+                                            : "rgba(59, 130, 246, 0.15)",
+                                        color: m === "semantic"
+                                            ? "rgba(167, 139, 250, 1)"
+                                            : "rgba(147, 197, 253, 1)",
+                                    }, children: m }, m))) }))] })] }), _jsx("svg", { className: "mt-1 h-4 w-4 shrink-0 opacity-0 transition-opacity group-hover:opacity-60", style: { color: "var(--bai-text-muted)" }, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M9 18l6-6-6-6" }) })] }));
 }

package/dist/editors/knowledge-vault/hooks/use-graph-search.d.ts

@@ -6,12 +6,13 @@ export type SearchResult = {
     status: string | null;
     topics: string[];
     similarity?: number;
+    matchedBy?: string[];
 };
 export type TopicInfo = {
     name: string;
     noteCount: number;
 };
-export type SearchMode = "semantic" | "keyword";
+export type SearchMode = "hybrid" | "semantic" | "keyword";
 export declare function useGraphSearch(): {
     query: string;
     setQuery: (q: string) => void;

package/dist/editors/knowledge-vault/hooks/use-graph-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-graph-search.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-graph-search.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAkIhD,wBAAgB,cAAc;;kBAgBtB,MAAM;;;;;;uBAQN,UAAU;EAoGjB"}
+{"version":3,"file":"use-graph-search.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-graph-search.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAkJ3D,wBAAgB,cAAc;;kBAgBtB,MAAM;;;;;;uBAQN,UAAU;EA4HjB"}

package/dist/editors/knowledge-vault/hooks/use-graph-search.js

@@ -79,6 +79,15 @@ const KEYWORD_SEARCH_QUERY = `
     }
   }
 `;
+const HYBRID_SEARCH_QUERY = `
+  query HybridSearch($driveId: ID!, $query: String!, $limit: Int) {
+    knowledgeGraphHybridSearch(driveId: $driveId, query: $query, limit: $limit) {
+      node { documentId title description noteType status topics }
+      score
+      matchedBy
+    }
+  }
+`;
 const TOPICS_QUERY = `
   query Topics($driveId: ID!) {
     knowledgeGraphTopics(driveId: $driveId) { name noteCount }
@@ -93,9 +102,14 @@ function loadSearchState() {
         const raw = sessionStorage.getItem(STORAGE_KEY);
         if (raw) {
             const parsed = JSON.parse(raw);
+            const mode = parsed.mode;
             return {
                 query: parsed.query ?? "",
-                mode: parsed.mode === "keyword" ? "keyword" : "semantic",
+                mode: mode === "keyword"
+                    ? "keyword"
+                    : mode === "semantic"
+                        ? "semantic"
+                        : "hybrid",
             };
         }
     }
@@ -151,7 +165,24 @@ export function useGraphSearch() {
         }
         setLoading(true);
         setError(null);
-        if (mode === "semantic") {
+        if (mode === "hybrid") {
+            const data = await graphqlFetch(endpoint, HYBRID_SEARCH_QUERY, { driveId, query: q, limit: 20 });
+            if (data?.knowledgeGraphHybridSearch) {
+                const raw = data.knowledgeGraphHybridSearch;
+                // Normalize RRF scores to 0-1 range (top result = 1.0)
+                const maxScore = raw.length > 0 ? raw[0].score : 1;
+                setResults(raw.map((r) => ({
+                    ...r.node,
+                    similarity: maxScore > 0 ? r.score / maxScore : 0,
+                    matchedBy: r.matchedBy,
+                })));
+            }
+            else {
+                setResults([]);
+                setError("Hybrid search unavailable. Try keyword mode.");
+            }
+        }
+        else if (mode === "semantic") {
             const data = await graphqlFetch(endpoint, SEMANTIC_SEARCH_QUERY, { driveId, query: q, limit: 20 });
             if (data?.knowledgeGraphSemanticSearch) {
                 setResults(data.knowledgeGraphSemanticSearch.map((r) => ({

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@powerhousedao/knowledge-note",
     "description": "Knowledge Note document model package for Powerhouse",
-    "version": "1.0.5",
+    "version": "1.0.6",
     "license": "AGPL-3.0-only",
     "type": "module",
     "files": [

package/dist/processors/graph-indexer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAItC,qBAAa,qBAAsB,SAAQ,qBAAqB,CAAC,EAAE,CAAC;WAClD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAItC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,YAAY,CACzB,UAAU,EAAE,oBAAoB,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAmKV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAQrB,UAAU;CA8BzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AA+DtC,qBAAa,qBAAsB,SAAQ,qBAAqB,CAAC,EAAE,CAAC;WAClD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAItC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,YAAY,CACzB,UAAU,EAAE,oBAAoB,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAgMV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAQrB,UAAU;CA8BzB"}

package/dist/processors/graph-indexer/index.js

@@ -2,6 +2,62 @@ import { RelationalDbProcessor } from "@powerhousedao/shared/processors";
 import { up } from "./migrations.js";
 import { generateEmbedding } from "./embedder.js";
 import { upsertEmbedding, deleteEmbedding } from "./embedding-store.js";
+function summarizeOperation(type, input) {
+    switch (type) {
+        case "SET_TITLE":
+            return `Title changed to "${truncate(input.title)}"`;
+        case "SET_DESCRIPTION":
+            return `Description updated`;
+        case "SET_CONTENT": {
+            const len = typeof input.content === "string" ? input.content.length : 0;
+            return `Content updated (${len} chars)`;
+        }
+        case "SET_NOTE_TYPE":
+            return `Type set to ${String(input.noteType)}`;
+        case "SET_STATUS":
+            return `Status changed to ${String(input.status)}`;
+        case "ADD_LINK":
+            return `Linked to "${truncate(input.targetTitle)}" (${s(input.linkType, "RELATES_TO")})`;
+        case "REMOVE_LINK":
+            return `Removed link ${s(input.id)}`;
+        case "UPDATE_LINK_TYPE":
+            return `Link type changed to ${s(input.linkType)}`;
+        case "ADD_TOPIC":
+            return `Added topic #${s(input.name)}`;
+        case "REMOVE_TOPIC":
+            return `Removed topic`;
+        case "SET_PROVENANCE":
+            return `Provenance set: ${s(input.author, "unknown")}, ${s(input.sourceOrigin)}`;
+        case "SUBMIT_FOR_REVIEW":
+            return `Submitted for review`;
+        case "APPROVE_NOTE":
+            return `Approved by ${s(input.actor, "unknown")}`;
+        case "REJECT_NOTE":
+            return `Rejected: ${truncate(input.comment)}`;
+        case "ARCHIVE_NOTE":
+            return `Archived`;
+        case "RESTORE_NOTE":
+            return `Restored from archive`;
+        case "SET_METADATA_FIELD":
+            return `Metadata: ${String(input.field)} = ${truncate(input.value)}`;
+        default:
+            return type;
+    }
+}
+/** Safely stringify an unknown value with optional fallback */
+function s(val, fallback = "") {
+    if (val == null)
+        return fallback;
+    if (typeof val === "string")
+        return val;
+    if (typeof val === "number" || typeof val === "boolean")
+        return String(val);
+    return fallback;
+}
+function truncate(val, max = 60) {
+    const str = s(val);
+    return str.length > max ? str.slice(0, max) + "..." : str;
+}
 export class GraphIndexerProcessor extends RelationalDbProcessor {
     static getNamespace(driveId) {
         return super.getNamespace(driveId);
@@ -28,6 +84,30 @@ export class GraphIndexerProcessor extends RelationalDbProcessor {
             // Only process knowledge-note documents
             if (context.documentType !== "bai/knowledge-note")
                 continue;
+            // Index operation for history tracking
+            try {
+                const input = operation.action.input;
+                const signer = operation.action.context?.signer;
+                await this.relationalDb
+                    .insertInto("graph_operations")
+                    .values({
+                    id: `${documentId}-${operation.index}`,
+                    document_id: documentId,
+                    operation_type: operation.action.type,
+                    timestamp: operation.timestampUtcMs ?? new Date().toISOString(),
+                    index: operation.index,
+                    scope: context.scope ?? "global",
+                    summary: summarizeOperation(operation.action.type, input),
+                    input_json: JSON.stringify(input),
+                    signer_address: signer?.user?.address || null,
+                    signer_app: signer?.app?.name || null,
+                })
+                    .onConflict((oc) => oc.column("id").doNothing())
+                    .execute();
+            }
+            catch {
+                // non-critical — don't block state reconciliation
+            }
             // Collect last state per document
             if (context.resultingState) {
                 lastByDocument.set(documentId, entry);

package/dist/processors/graph-indexer/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,wBAAsB,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmF9D;AAED,wBAAsB,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,wBAAsB,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqI9D;AAED,wBAAsB,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhE"}

package/dist/processors/graph-indexer/migrations.js

@@ -73,8 +73,54 @@ export async function up(db) {
         .column("name")
         .ifNotExists()
         .execute();
+    // --- Operation history ---
+    await db.schema
+        .createTable("graph_operations")
+        .addColumn("id", "varchar(255)", (col) => col.primaryKey())
+        .addColumn("document_id", "varchar(255)", (col) => col.notNull())
+        .addColumn("operation_type", "varchar(100)", (col) => col.notNull())
+        .addColumn("timestamp", "varchar(50)", (col) => col.notNull())
+        .addColumn("index", "integer", (col) => col.notNull())
+        .addColumn("scope", "varchar(20)", (col) => col.notNull())
+        .addColumn("summary", "text")
+        .addColumn("input_json", "text")
+        .addColumn("signer_address", "varchar(255)")
+        .addColumn("signer_app", "varchar(255)")
+        .ifNotExists()
+        .execute();
+    await db.schema
+        .createIndex("idx_graph_ops_doc")
+        .on("graph_operations")
+        .column("document_id")
+        .ifNotExists()
+        .execute();
+    await db.schema
+        .createIndex("idx_graph_ops_timestamp")
+        .on("graph_operations")
+        .column("timestamp")
+        .ifNotExists()
+        .execute();
+    await db.schema
+        .createIndex("idx_graph_ops_type")
+        .on("graph_operations")
+        .column("operation_type")
+        .ifNotExists()
+        .execute();
+    // Add signer columns to graph_operations (idempotent)
+    for (const col of ["signer_address", "signer_app"]) {
+        try {
+            await db.schema
+                .alterTable("graph_operations")
+                .addColumn(col, "varchar(255)")
+                .execute();
+        }
+        catch {
+            // column likely already exists — ignore
+        }
+    }
 }
 export async function down(db) {
+    await db.schema.dropTable("graph_operations").ifExists().execute();
     await db.schema.dropTable("graph_topics").ifExists().execute();
     await db.schema.dropTable("graph_edges").ifExists().execute();
     await db.schema.dropTable("graph_nodes").ifExists().execute();

package/dist/processors/graph-indexer/query.d.ts

@@ -40,6 +40,22 @@ export interface RelatedByTopicResult {
     sharedTopics: string[];
     sharedTopicCount: number;
 }
+export interface HybridSearchResult {
+    node: GraphNodeResult;
+    score: number;
+    matchedBy: string[];
+}
+export interface OperationRecord {
+    id: string;
+    documentId: string;
+    operationType: string;
+    timestamp: string;
+    index: number;
+    scope: string;
+    summary: string | null;
+    signerAddress: string | null;
+    signerApp: string | null;
+}
 export declare function createGraphQuery(db: Kysely<DB>): {
     allNodes(): Promise<GraphNodeResult[]>;
     allEdges(): Promise<GraphEdgeResult[]>;
@@ -66,5 +82,18 @@ export declare function createGraphQuery(db: Kysely<DB>): {
     nodesByAuthor(author: string): Promise<GraphNodeResult[]>;
     nodesByOrigin(origin: string): Promise<GraphNodeResult[]>;
     recentNodes(limit?: number, since?: string): Promise<GraphNodeResult[]>;
+    /**
+     * Hybrid search: run keyword + semantic in parallel, merge via
+     * Reciprocal Rank Fusion (RRF). semanticResults must be pre-fetched
+     * from the embedding store by the caller.
+     */
+    hybridSearch(keywordQuery: string, semanticResults: Array<{
+        documentId: string;
+        similarity: number;
+    }>, limit?: number): Promise<HybridSearchResult[]>;
+    history(documentId: string, limit?: number): Promise<OperationRecord[]>;
+    activity(limit?: number, since?: string): Promise<OperationRecord[]>;
+    activityByType(operationType: string, limit?: number): Promise<OperationRecord[]>;
+    staleNodes(since: string, limit?: number): Promise<GraphNodeResult[]>;
 };
 //# sourceMappingURL=query.d.ts.map

package/dist/processors/graph-indexer/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/query.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/query.ts"],"names":[],"mappings":"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"}

package/dist/processors/graph-indexer/query.js

@@ -24,6 +24,19 @@ function rowToEdge(row) {
         updatedAt: row.updated_at,
     };
 }
+function rowToOperation(row) {
+    return {
+        id: row.id,
+        documentId: row.document_id,
+        operationType: row.operation_type,
+        timestamp: row.timestamp,
+        index: row.index,
+        scope: row.scope,
+        summary: row.summary,
+        signerAddress: row.signer_address,
+        signerApp: row.signer_app,
+    };
+}
 export function createGraphQuery(db) {
     return {
         async allNodes() {
@@ -372,5 +385,96 @@ export function createGraphQuery(db) {
             const rows = await query.execute();
             return rows.map(rowToNode);
         },
+        /**
+         * Hybrid search: run keyword + semantic in parallel, merge via
+         * Reciprocal Rank Fusion (RRF). semanticResults must be pre-fetched
+         * from the embedding store by the caller.
+         */
+        async hybridSearch(keywordQuery, semanticResults, limit = 20) {
+            const K = 60;
+            const scores = new Map();
+            // Keyword leg
+            const keywordResults = await this.fullSearch(keywordQuery, limit * 2);
+            keywordResults.forEach((node, rank) => {
+                const existing = scores.get(node.documentId) ?? {
+                    score: 0,
+                    matchedBy: [],
+                };
+                existing.score += 1 / (K + rank);
+                existing.matchedBy.push("keyword");
+                existing.node = node;
+                scores.set(node.documentId, existing);
+            });
+            // Semantic leg
+            for (let rank = 0; rank < semanticResults.length; rank++) {
+                const sr = semanticResults[rank];
+                const existing = scores.get(sr.documentId) ?? {
+                    score: 0,
+                    matchedBy: [],
+                };
+                existing.score += 1 / (K + rank);
+                if (!existing.matchedBy.includes("semantic")) {
+                    existing.matchedBy.push("semantic");
+                }
+                // Fetch node data if we don't have it from keyword results
+                if (!existing.node) {
+                    existing.node = await this.nodeByDocumentId(sr.documentId);
+                }
+                scores.set(sr.documentId, existing);
+            }
+            return [...scores.values()]
+                .filter((e) => !!e.node)
+                .sort((a, b) => b.score - a.score)
+                .slice(0, limit)
+                .map(({ score, matchedBy, node }) => ({ node, score, matchedBy }));
+        },
+        // ---- Operation history queries ----
+        async history(documentId, limit = 50) {
+            const rows = await db
+                .selectFrom("graph_operations")
+                .where("document_id", "=", documentId)
+                .orderBy("index", "desc")
+                .selectAll()
+                .limit(limit)
+                .execute();
+            return rows.map(rowToOperation);
+        },
+        async activity(limit = 50, since) {
+            let query = db
+                .selectFrom("graph_operations")
+                .orderBy("timestamp", "desc")
+                .selectAll()
+                .limit(limit);
+            if (since) {
+                query = query.where("timestamp", ">", since);
+            }
+            const rows = await query.execute();
+            return rows.map(rowToOperation);
+        },
+        async activityByType(operationType, limit = 50) {
+            const rows = await db
+                .selectFrom("graph_operations")
+                .where("operation_type", "=", operationType)
+                .orderBy("timestamp", "desc")
+                .selectAll()
+                .limit(limit)
+                .execute();
+            return rows.map(rowToOperation);
+        },
+        async staleNodes(since, limit = 50) {
+            // Nodes with no operations after `since` but that have neighbors
+            // who DO have operations after `since`
+            const staleRows = await db
+                .selectFrom("graph_nodes")
+                .where("document_id", "not in", db
+                .selectFrom("graph_operations")
+                .where("timestamp", ">", since)
+                .select("document_id"))
+                .where("updated_at", "<", since)
+                .selectAll()
+                .limit(limit)
+                .execute();
+            return staleRows.map(rowToNode);
+        },
     };
 }

package/dist/processors/graph-indexer/schema.d.ts

@@ -25,9 +25,22 @@ export interface GraphEdge {
     target_title: string | null;
     updated_at: string;
 }
+export interface GraphOperation {
+    id: string;
+    document_id: string;
+    operation_type: string;
+    timestamp: string;
+    index: number;
+    scope: string;
+    summary: string | null;
+    input_json: string | null;
+    signer_address: string | null;
+    signer_app: string | null;
+}
 export interface DB {
     graph_nodes: GraphNode;
     graph_edges: GraphEdge;
     graph_topics: GraphTopic;
+    graph_operations: GraphOperation;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/processors/graph-indexer/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,EAAE;IACjB,WAAW,EAAE,SAAS,CAAC;IACvB,WAAW,EAAE,SAAS,CAAC;IACvB,YAAY,EAAE,UAAU,CAAC;CAC1B"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../processors/graph-indexer/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,EAAE;IACjB,WAAW,EAAE,SAAS,CAAC;IACvB,WAAW,EAAE,SAAS,CAAC;IACvB,YAAY,EAAE,UAAU,CAAC;IACzB,gBAAgB,EAAE,cAAc,CAAC;CAClC"}

package/dist/style.css

@@ -1509,6 +1509,13 @@
       }
     }
   }
+  .group-hover\:opacity-50 {
+    &:is(:where(.group):hover *) {
+      @media (hover: hover) {
+        opacity: 50%;
+      }
+    }
+  }
   .group-hover\:opacity-60 {
     &:is(:where(.group):hover *) {
       @media (hover: hover) {

package/dist/subgraphs/knowledge-graph/subgraph.d.ts

@@ -360,6 +360,61 @@ export declare class KnowledgeGraphSubgraph extends BaseSubgraph {
                 };
                 similarity: number;
             }[]>;
+            knowledgeGraphHybridSearch: (_: unknown, args: {
+                driveId: string;
+                query: string;
+                limit?: number;
+            }) => Promise<{
+                node: {
+                    _driveId: string;
+                    id: string;
+                    documentId: string;
+                    title: string | null;
+                    description: string | null;
+                    noteType: string | null;
+                    status: string | null;
+                    content: string | null;
+                    author: string | null;
+                    sourceOrigin: string | null;
+                    createdAt: string | null;
+                    updatedAt: string;
+                };
+                score: number;
+                matchedBy: string[];
+            }[]>;
+            knowledgeGraphHistory: (_: unknown, args: {
+                driveId: string;
+                documentId: string;
+                limit?: number;
+            }) => Promise<import("../../processors/graph-indexer/query.js").OperationRecord[]>;
+            knowledgeGraphActivity: (_: unknown, args: {
+                driveId: string;
+                limit?: number;
+                since?: string;
+            }) => Promise<import("../../processors/graph-indexer/query.js").OperationRecord[]>;
+            knowledgeGraphActivityByType: (_: unknown, args: {
+                driveId: string;
+                operationType: string;
+                limit?: number;
+            }) => Promise<import("../../processors/graph-indexer/query.js").OperationRecord[]>;
+            knowledgeGraphStale: (_: unknown, args: {
+                driveId: string;
+                since: string;
+                limit?: number;
+            }) => Promise<{
+                _driveId: string;
+                id: string;
+                documentId: string;
+                title: string | null;
+                description: string | null;
+                noteType: string | null;
+                status: string | null;
+                content: string | null;
+                author: string | null;
+                sourceOrigin: string | null;
+                createdAt: string | null;
+                updatedAt: string;
+            }[]>;
             knowledgeGraphDebug: (_: unknown, args: {
                 driveId: string;
             }) => Promise<{

package/dist/subgraphs/knowledge-graph/subgraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subgraph.d.ts","sourceRoot":"","sources":["../../../subgraphs/knowledge-graph/subgraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subgraph.d.ts","sourceRoot":"","sources":["../../../subgraphs/knowledge-graph/subgraph.ts"],"names":[],"mappings":"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"}

package/dist/subgraphs/knowledge-graph/subgraph.js

@@ -129,6 +129,32 @@ export class KnowledgeGraphSubgraph extends BaseSubgraph {
         documentId: String!
         limit: Int
       ): [SemanticResult!]!
+      knowledgeGraphHybridSearch(
+        driveId: ID!
+        query: String!
+        limit: Int
+      ): [HybridResult!]!
+
+      knowledgeGraphHistory(
+        driveId: ID!
+        documentId: String!
+        limit: Int
+      ): [OperationRecord!]!
+      knowledgeGraphActivity(
+        driveId: ID!
+        limit: Int
+        since: String
+      ): [OperationRecord!]!
+      knowledgeGraphActivityByType(
+        driveId: ID!
+        operationType: String!
+        limit: Int
+      ): [OperationRecord!]!
+      knowledgeGraphStale(
+        driveId: ID!
+        since: String!
+        limit: Int
+      ): [KnowledgeGraphNode!]!
 
       """
       Debug: raw processor DB tables
@@ -147,6 +173,24 @@ export class KnowledgeGraphSubgraph extends BaseSubgraph {
       similarity: Float!
     }
 
+    type HybridResult {
+      node: KnowledgeGraphNode!
+      score: Float!
+      matchedBy: [String!]!
+    }
+
+    type OperationRecord {
+      id: String!
+      documentId: String!
+      operationType: String!
+      timestamp: String!
+      index: Int!
+      scope: String!
+      summary: String
+      signerAddress: String
+      signerApp: String
+    }
+
     type GraphDebugInfo {
       rawNodeCount: Int!
       rawEdgeCount: Int!
@@ -331,6 +375,34 @@ export class KnowledgeGraphSubgraph extends BaseSubgraph {
                 }
                 return semanticResults.slice(0, args.limit ?? 10);
             },
+            knowledgeGraphHybridSearch: async (_, args) => {
+                const queryEmbedding = await generateEmbedding(args.query);
+                const semanticResults = await searchSimilar(queryEmbedding, (args.limit ?? 20) * 2);
+                const graphQuery = this.getQuery(args.driveId);
+                const hybridResults = await graphQuery.hybridSearch(args.query, semanticResults, args.limit ?? 20);
+                return hybridResults.map((r) => ({
+                    node: { ...r.node, _driveId: args.driveId },
+                    score: r.score,
+                    matchedBy: r.matchedBy,
+                }));
+            },
+            knowledgeGraphHistory: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.history(args.documentId, args.limit ?? 50);
+            },
+            knowledgeGraphActivity: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.activity(args.limit ?? 50, args.since ?? undefined);
+            },
+            knowledgeGraphActivityByType: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.activityByType(args.operationType, args.limit ?? 50);
+            },
+            knowledgeGraphStale: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                const nodes = await query.staleNodes(args.since, args.limit ?? 50);
+                return nodes.map((n) => ({ ...n, _driveId: args.driveId }));
+            },
             knowledgeGraphDebug: async (_, args) => {
                 const namespace = GraphIndexerProcessor.getNamespace(args.driveId);
                 try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@powerhousedao/knowledge-note",
   "description": "Knowledge Note document model package for Powerhouse",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "license": "AGPL-3.0-only",
   "type": "module",
   "files": [