@powerhousedao/knowledge-note 1.0.0

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

@@ -0,0 +1,240 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useMemo, useCallback, useRef, useEffect } from "react";
+import { setSelectedNode, showCreateDocumentModal, useDocumentsInSelectedDrive, useNodesInSelectedDrive, useSelectedDriveId, addDocument, } from "@powerhousedao/reactor-browser";
+import { CreateDocumentDialog } from "./CreateDocumentDialog.js";
+const STATUS_ORDER = ["CANONICAL", "IN_REVIEW", "DRAFT", "ARCHIVED"];
+const STATUS_COLORS = {
+    DRAFT: "bg-amber-400",
+    IN_REVIEW: "bg-blue-400",
+    CANONICAL: "bg-emerald-400",
+    ARCHIVED: "bg-gray-500",
+};
+const STATUS_LABELS = {
+    DRAFT: "Drafts",
+    IN_REVIEW: "In Review",
+    CANONICAL: "Canonical",
+    ARCHIVED: "Archived",
+};
+const MIN_WIDTH = 200;
+const MAX_WIDTH = 480;
+const DEFAULT_WIDTH = 256;
+export function VaultSidebar({ notes }) {
+    const [search, setSearch] = useState("");
+    const [section, setSection] = useState("notes");
+    const [collapsed, setCollapsed] = useState({
+        ARCHIVED: true,
+    });
+    const [createSourceOpen, setCreateSourceOpen] = useState(false);
+    const [sidebarOpen, setSidebarOpen] = useState(true);
+    const [sidebarWidth, setSidebarWidth] = useState(DEFAULT_WIDTH);
+    const resizing = useRef(false);
+    const documents = useDocumentsInSelectedDrive();
+    const allNodes = useNodesInSelectedDrive();
+    const handleMouseDown = useCallback((e) => {
+        e.preventDefault();
+        resizing.current = true;
+        const startX = e.clientX;
+        const startWidth = sidebarWidth;
+        function onMouseMove(ev) {
+            if (!resizing.current)
+                return;
+            const newWidth = Math.min(MAX_WIDTH, Math.max(MIN_WIDTH, startWidth + (ev.clientX - startX)));
+            setSidebarWidth(newWidth);
+        }
+        function onMouseUp() {
+            resizing.current = false;
+            document.removeEventListener("mousemove", onMouseMove);
+            document.removeEventListener("mouseup", onMouseUp);
+        }
+        document.addEventListener("mousemove", onMouseMove);
+        document.addEventListener("mouseup", onMouseUp);
+    }, [sidebarWidth]);
+    // Read vault name from VaultConfig singleton
+    const vaultName = useMemo(() => {
+        const configDoc = (documents ?? []).find((d) => d.header.documentType === "bai/vault-config");
+        if (!configDoc)
+            return "Knowledge Vault";
+        const name = configDoc.state
+            ?.global?.name;
+        return name || "Knowledge Vault";
+    }, [documents]);
+    // MOCs
+    const mocs = useMemo(() => {
+        return (documents ?? [])
+            .filter((d) => d.header.documentType === "bai/moc")
+            .map((d) => ({
+            id: d.header.id,
+            name: d.header.name,
+            title: d.state.global
+                .title ?? d.header.name,
+            tier: d.state.global
+                .tier ?? null,
+            noteCount: d.state.global
+                .noteCount ?? 0,
+        }));
+    }, [documents]);
+    // Observations + Tensions
+    const observations = useMemo(() => {
+        return (documents ?? [])
+            .filter((d) => d.header.documentType === "bai/observation")
+            .map((d) => ({
+            id: d.header.id,
+            title: d.state.global
+                .title ?? d.header.name,
+            category: d.state.global
+                .category ?? null,
+            status: d.state.global
+                .status ?? "PENDING",
+        }))
+            .filter((o) => o.status === "PENDING");
+    }, [documents]);
+    const tensions = useMemo(() => {
+        return (documents ?? [])
+            .filter((d) => d.header.documentType === "bai/tension")
+            .map((d) => ({
+            id: d.header.id,
+            title: d.state.global
+                .title ?? d.header.name,
+            status: d.state.global
+                .status ?? "OPEN",
+        }))
+            .filter((t) => t.status === "OPEN");
+    }, [documents]);
+    const filtered = useMemo(() => {
+        if (!search.trim())
+            return notes;
+        const q = search.toLowerCase();
+        return notes.filter((n) => (n.title ?? n.name).toLowerCase().includes(q) ||
+            (n.noteType ?? "").toLowerCase().includes(q) ||
+            n.topics.some((t) => t.name.toLowerCase().includes(q)));
+    }, [notes, search]);
+    const grouped = useMemo(() => {
+        const groups = {};
+        for (const s of STATUS_ORDER)
+            groups[s] = [];
+        for (const note of filtered) {
+            const status = note.status ?? "DRAFT";
+            (groups[status] ?? groups.DRAFT).push(note);
+        }
+        return groups;
+    }, [filtered]);
+    // Collapsed: show a thin strip with toggle button
+    if (!sidebarOpen) {
+        return (_jsx("div", { className: "flex h-full w-10 shrink-0 flex-col items-center border-r py-3", style: {
+                backgroundColor: "var(--bai-deep)",
+                borderColor: "var(--bai-border)",
+            }, children: _jsx("button", { type: "button", onClick: () => setSidebarOpen(true), className: "sidebar-collapse-btn rounded p-1.5 transition-colors", style: { color: "var(--bai-text-muted)" }, title: "Open sidebar", children: _jsx("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M13 17l5-5-5-5M6 17l5-5-5-5" }) }) }) }));
+    }
+    return (_jsxs("div", { className: "relative flex h-full shrink-0 flex-col border-r", style: {
+            width: sidebarWidth,
+            backgroundColor: "var(--bai-deep)",
+            borderColor: "var(--bai-border)",
+        }, children: [_jsx("div", { className: "sidebar-resize-handle absolute right-0 top-0 z-10 h-full w-1 cursor-col-resize", onMouseDown: handleMouseDown }), _jsx("div", { className: "border-b px-3 py-3", style: { borderColor: "var(--bai-border)" }, children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("button", { type: "button", onClick: () => setSidebarOpen(false), className: "sidebar-collapse-btn shrink-0 rounded p-1 transition-colors", style: { color: "var(--bai-text-faint)" }, title: "Collapse sidebar", children: _jsx("svg", { className: "h-4 w-4", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M11 17l-5-5 5-5M18 17l-5-5 5-5" }) }) }), _jsx("button", { type: "button", onClick: () => setSelectedNode(undefined), className: "sidebar-vault-name flex-1 text-left text-sm font-semibold transition-colors truncate min-w-0", style: { color: "var(--bai-text)" }, title: "Back to vault overview", children: vaultName }), _jsxs("button", { type: "button", onClick: () => setCreateSourceOpen(true), className: "flex shrink-0 items-center gap-1 rounded-md px-2.5 py-1 text-[11px] font-medium transition-colors", style: {
+                                backgroundColor: "var(--bai-accent-soft)",
+                                color: "var(--bai-accent)",
+                            }, title: "Paste raw content \u2014 articles, notes, transcripts \u2014 for AI extraction", children: [_jsx("svg", { className: "h-3 w-3", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", children: _jsx("path", { d: "M12 5v14M5 12h14" }) }), "Add Source"] }), _jsx(CreateDocumentDialog, { open: createSourceOpen, documentType: "bai/source", documentTypeLabel: "Source", onClose: () => setCreateSourceOpen(false) })] }) }), _jsx("div", { className: "px-3 py-2", children: _jsx("input", { type: "text", value: search, onChange: (e) => setSearch(e.target.value), placeholder: "Search...", className: "sidebar-search-input w-full rounded-md border px-3 py-1.5 text-xs outline-none", style: {
+                        borderColor: "var(--bai-border)",
+                        backgroundColor: "var(--bai-bg)",
+                        color: "var(--bai-text-secondary)",
+                    } }) }), _jsx("div", { className: "flex gap-px px-3 pb-1", children: [
+                    ["notes", "Notes"],
+                    ["mocs", "MOCs"],
+                    ["signals", "Signals"],
+                    ["folders", "Tree"],
+                ].map(([key, label]) => (_jsxs("button", { type: "button", onClick: () => setSection(key), className: `sidebar-tab flex-1 rounded-md py-1 text-[10px] font-medium transition-colors`, style: section === key
+                        ? {
+                            backgroundColor: "var(--bai-hover)",
+                            color: "var(--bai-accent)",
+                        }
+                        : { color: "var(--bai-text-faint)" }, children: [label, key === "signals" && observations.length + tensions.length > 0 && (_jsx("span", { className: "ml-1 text-amber-400", children: observations.length + tensions.length }))] }, key))) }), _jsxs("div", { className: "flex-1 overflow-y-auto px-2 pb-4", children: [section === "notes" && (_jsx(_Fragment, { children: STATUS_ORDER.map((status) => {
+                            const groupNotes = grouped[status];
+                            if (groupNotes.length === 0)
+                                return null;
+                            const isCollapsed = collapsed[status] ?? false;
+                            return (_jsxs("div", { className: "mb-1", children: [_jsxs("button", { type: "button", onClick: () => setCollapsed((c) => ({ ...c, [status]: !isCollapsed })), className: "sidebar-row flex w-full items-center gap-2 rounded px-2 py-1.5 text-xs", style: { color: "var(--bai-text-muted)" }, children: [_jsx("span", { className: `h-2 w-2 rounded-full ${STATUS_COLORS[status]}` }), _jsx("span", { className: "flex-1 text-left font-medium", children: STATUS_LABELS[status] }), _jsx("span", { style: { color: "var(--bai-text-faint)" }, children: groupNotes.length }), _jsx("svg", { className: `h-3 w-3 transition-transform ${isCollapsed ? "" : "rotate-90"}`, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M9 18l6-6-6-6" }) })] }), !isCollapsed && (_jsx("div", { className: "ml-1 space-y-px", children: groupNotes.map((note) => (_jsxs("button", { type: "button", onClick: () => setSelectedNode(note.id), className: "sidebar-row group flex w-full flex-col gap-0.5 rounded-md px-2 py-1.5 text-left transition-colors", children: [_jsx("span", { className: "sidebar-note-title truncate text-xs font-medium", style: { color: "var(--bai-text-secondary)" }, children: note.title ?? note.name }), _jsxs("div", { className: "flex items-center gap-1.5", children: [note.noteType && (_jsx("span", { className: "rounded px-1.5 py-0.5 text-[10px]", style: {
+                                                                backgroundColor: "var(--bai-hover)",
+                                                                color: "var(--bai-text-tertiary)",
+                                                            }, children: note.noteType })), note.topics.slice(0, 2).map((t) => (_jsxs("span", { className: "text-[10px]", style: {
+                                                                color: "var(--bai-accent)",
+                                                                opacity: 0.6,
+                                                            }, children: ["#", t.name] }, t.id)))] })] }, note.id))) }))] }, status));
+                        }) })), section === "mocs" && (_jsx("div", { className: "space-y-1", children: mocs.length === 0 ? (_jsx("p", { className: "px-2 py-4 text-center text-xs", style: { color: "var(--bai-text-faint)" }, children: "No MOCs yet" })) : (_jsx(_Fragment, { children: ["HUB", "DOMAIN", "TOPIC"].map((tier) => {
+                                const tierMocs = mocs.filter((m) => m.tier === tier);
+                                if (tierMocs.length === 0)
+                                    return null;
+                                return (_jsxs("div", { children: [_jsx("p", { className: "px-2 py-1 text-[10px] font-semibold uppercase tracking-wider", style: { color: "var(--bai-text-faint)" }, children: tier }), tierMocs.map((moc) => (_jsxs("button", { type: "button", onClick: () => setSelectedNode(moc.id), className: "sidebar-row group flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left", children: [_jsxs("svg", { className: "h-3.5 w-3.5 shrink-0", style: { color: "var(--bai-accent)", opacity: 0.6 }, 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" })] }), _jsx("span", { className: "sidebar-note-title truncate text-xs", style: { color: "var(--bai-text-secondary)" }, children: moc.title }), _jsx("span", { className: "ml-auto text-[10px]", style: { color: "var(--bai-text-faint)" }, children: moc.noteCount })] }, moc.id)))] }, tier));
+                            }) })) })), section === "signals" && (_jsxs("div", { className: "space-y-3", children: [observations.length > 0 && (_jsxs("div", { children: [_jsxs("p", { className: "px-2 py-1 text-[10px] font-semibold uppercase tracking-wider", style: { color: "var(--bai-text-faint)" }, children: ["Observations (", observations.length, ")"] }), observations.map((obs) => (_jsxs("button", { type: "button", onClick: () => setSelectedNode(obs.id), className: "sidebar-row group flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left", children: [_jsx("span", { className: "h-2 w-2 shrink-0 rounded-full bg-amber-400" }), _jsx("span", { className: "sidebar-note-title truncate text-xs", style: { color: "var(--bai-text-secondary)" }, children: obs.title }), obs.category && (_jsx("span", { className: "rounded px-1 py-0.5 text-[10px]", style: {
+                                                    backgroundColor: "var(--bai-hover)",
+                                                    color: "var(--bai-text-muted)",
+                                                }, children: obs.category }))] }, obs.id)))] })), tensions.length > 0 && (_jsxs("div", { children: [_jsxs("p", { className: "px-2 py-1 text-[10px] font-semibold uppercase tracking-wider", style: { color: "var(--bai-text-faint)" }, children: ["Tensions (", tensions.length, ")"] }), tensions.map((ten) => (_jsxs("button", { type: "button", onClick: () => setSelectedNode(ten.id), className: "sidebar-row group flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left", children: [_jsx("span", { className: "h-2 w-2 shrink-0 rounded-full bg-red-400" }), _jsx("span", { className: "sidebar-note-title truncate text-xs", style: { color: "var(--bai-text-secondary)" }, children: ten.title })] }, ten.id)))] })), observations.length === 0 && tensions.length === 0 && (_jsx("p", { className: "px-2 py-4 text-center text-xs", style: { color: "var(--bai-text-faint)" }, children: "No pending signals" }))] })), section === "folders" && _jsx(FolderTreeView, { nodes: allNodes ?? [] })] }), _jsx("style", { children: `
+        .sidebar-collapse-btn:hover {
+          background-color: var(--bai-hover);
+          color: var(--bai-accent);
+        }
+        .sidebar-vault-name:hover {
+          color: var(--bai-accent);
+        }
+        .sidebar-search-input::placeholder {
+          color: var(--bai-text-faint);
+        }
+        .sidebar-search-input:focus {
+          border-color: var(--bai-accent);
+        }
+        .sidebar-tab:hover {
+          color: var(--bai-text-tertiary);
+        }
+        .sidebar-row:hover {
+          background-color: var(--bai-hover);
+        }
+        .sidebar-row:hover .sidebar-note-title {
+          color: var(--bai-accent);
+        }
+        .sidebar-resize-handle:hover {
+          background-color: color-mix(in srgb, var(--bai-accent) 30%, transparent);
+        }
+        .sidebar-resize-handle:active {
+          background-color: color-mix(in srgb, var(--bai-accent) 50%, transparent);
+        }
+      ` })] }));
+}
+function FolderTreeView({ nodes }) {
+    const tree = useMemo(() => {
+        function build(parentId) {
+            return nodes
+                .filter((n) => parentId == null
+                ? n.parentFolder == null
+                : n.parentFolder === parentId)
+                .map((node) => ({
+                id: node.id,
+                name: node.name,
+                kind: node.kind,
+                docType: node.kind === "file"
+                    ? node
+                        .documentType
+                    : undefined,
+                children: node.kind === "folder" ? build(node.id) : [],
+            }))
+                .sort((a, b) => {
+                if (a.kind === "folder" && b.kind !== "folder")
+                    return -1;
+                if (a.kind !== "folder" && b.kind === "folder")
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+        }
+        return build(null);
+    }, [nodes]);
+    return (_jsx("div", { className: "space-y-0.5", children: tree.map((node) => (_jsx(TreeItem, { node: node, depth: 0 }, node.id))) }));
+}
+function TreeItem({ node, depth, }) {
+    const [expanded, setExpanded] = useState(false);
+    const isFolder = node.kind === "folder";
+    const hasChildren = node.children.length > 0;
+    return (_jsxs("div", { children: [_jsxs("button", { type: "button", onClick: () => isFolder ? setExpanded(!expanded) : setSelectedNode(node.id), className: "sidebar-row group flex w-full items-center gap-1 rounded px-1 py-1 text-left", style: { paddingLeft: `${depth * 12 + 4}px` }, children: [isFolder ? (_jsx("svg", { className: `h-3 w-3 shrink-0 transition-transform ${expanded ? "rotate-90" : ""}`, style: { color: "var(--bai-text-faint)" }, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: _jsx("path", { d: "M9 18l6-6-6-6" }) })) : (_jsx("span", { className: "h-3 w-3" })), isFolder ? (_jsx("svg", { className: "h-3.5 w-3.5 shrink-0 text-amber-400/70", viewBox: "0 0 24 24", fill: "currentColor", children: _jsx("path", { d: "M2 6a2 2 0 012-2h5l2 2h9a2 2 0 012 2v10a2 2 0 01-2 2H4a2 2 0 01-2-2V6z" }) })) : (_jsxs("svg", { className: "h-3.5 w-3.5 shrink-0", style: { color: "var(--bai-text-faint)" }, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [_jsx("path", { d: "M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z" }), _jsx("path", { d: "M14 2v6h6" })] })), _jsx("span", { className: `sidebar-note-title truncate text-[11px] ${isFolder ? "font-medium" : ""}`, style: {
+                            color: isFolder
+                                ? "var(--bai-text-secondary)"
+                                : "var(--bai-text-tertiary)",
+                        }, children: node.name }), isFolder && hasChildren && (_jsx("span", { className: "ml-auto text-[9px]", style: { color: "var(--bai-text-faint)" }, children: node.children.length }))] }), isFolder &&
+                expanded &&
+                node.children.map((child) => (_jsx(TreeItem, { node: child, depth: depth + 1 }, child.id)))] }));
+}

package/dist/editors/knowledge-vault/config.d.ts

@@ -0,0 +1,4 @@
+import type { PHDriveEditorConfig } from "@powerhousedao/reactor-browser";
+/** Editor config for the KnowledgeVault drive app */
+export declare const editorConfig: PHDriveEditorConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/editors/knowledge-vault/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../editors/knowledge-vault/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,qDAAqD;AACrD,eAAO,MAAM,YAAY,EAAE,mBAe1B,CAAC"}

package/dist/editors/knowledge-vault/config.js

@@ -0,0 +1,17 @@
+/** Editor config for the KnowledgeVault drive app */
+export const editorConfig = {
+    isDragAndDropEnabled: true,
+    allowedDocumentTypes: [
+        "bai/knowledge-note",
+        "bai/knowledge-graph",
+        "bai/moc",
+        "bai/source",
+        "bai/pipeline-queue",
+        "bai/observation",
+        "bai/tension",
+        "bai/vault-config",
+        "bai/derivation",
+        "bai/health-report",
+        "bai/research-claim",
+    ],
+};

package/dist/editors/knowledge-vault/editor.d.ts

@@ -0,0 +1,3 @@
+import type { EditorProps } from "document-model";
+export default function Editor(props: EditorProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=editor.d.ts.map

package/dist/editors/knowledge-vault/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../../editors/knowledge-vault/editor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,WAAW,2CAahD"}

package/dist/editors/knowledge-vault/editor.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useSetPHDriveEditorConfig } from "@powerhousedao/reactor-browser";
+import { DriveExplorer } from "./components/DriveExplorer.js";
+import { editorConfig } from "./config.js";
+import { useDriveInit } from "./hooks/use-drive-init.js";
+import { ThemeProvider } from "../shared/theme-context.js";
+export default function Editor(props) {
+    useSetPHDriveEditorConfig(editorConfig);
+    useDriveInit();
+    return (_jsx(ThemeProvider, { children: _jsx("div", { className: "h-screen overflow-hidden", style: { backgroundColor: "var(--bai-bg)", color: "var(--bai-text)" }, children: _jsx(DriveExplorer, { ...props }) }) }));
+}

package/dist/editors/knowledge-vault/hooks/use-auto-health.d.ts

@@ -0,0 +1,9 @@
+import type { KnowledgeNoteInfo } from "./use-knowledge-notes.js";
+import type { GraphState } from "./use-knowledge-graph.js";
+/**
+ * Auto-generates a health report document whenever the vault loads
+ * and note data changes. Updates the existing health-report doc
+ * or creates observations about issues found.
+ */
+export declare function useAutoHealth(notes: KnowledgeNoteInfo[], graphState: GraphState | null): void;
+//# sourceMappingURL=use-auto-health.d.ts.map

package/dist/editors/knowledge-vault/hooks/use-auto-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-auto-health.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-auto-health.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,UAAU,EAAE,UAAU,GAAG,IAAI,QAqH9B"}

package/dist/editors/knowledge-vault/hooks/use-auto-health.js

@@ -0,0 +1,99 @@
+import { useEffect, useRef } from "react";
+import { generateId } from "document-model/core";
+import { useDocumentsInSelectedDrive, useSelectedDriveId, } from "@powerhousedao/reactor-browser";
+import { useHealthReportDocumentsInSelectedDrive } from "@powerhousedao/knowledge-note/document-models/health-report";
+/**
+ * Auto-generates a health report document whenever the vault loads
+ * and note data changes. Updates the existing health-report doc
+ * or creates observations about issues found.
+ */
+export function useAutoHealth(notes, graphState) {
+    const driveId = useSelectedDriveId();
+    const healthDocs = useHealthReportDocumentsInSelectedDrive();
+    const healthDoc = healthDocs?.[0];
+    const lastReportFingerprint = useRef("");
+    useEffect(() => {
+        if (!healthDoc || !driveId || notes.length === 0)
+            return;
+        // Build fingerprint to avoid re-reporting same state
+        const fingerprint = `${notes.length}:${graphState?.nodes.length ?? 0}:${graphState?.edges.length ?? 0}`;
+        if (lastReportFingerprint.current === fingerprint)
+            return;
+        lastReportFingerprint.current = fingerprint;
+        // Compute health metrics
+        const nodeCount = notes.length;
+        const edgeCount = notes.reduce((sum, n) => sum + n.links.length, 0);
+        const noteIds = new Set(notes.map((n) => n.id));
+        const incomingCounts = new Map();
+        for (const note of notes) {
+            for (const link of note.links) {
+                if (link.targetDocumentId && noteIds.has(link.targetDocumentId)) {
+                    incomingCounts.set(link.targetDocumentId, (incomingCounts.get(link.targetDocumentId) ?? 0) + 1);
+                }
+            }
+        }
+        const orphanCount = notes.filter((n) => !incomingCounts.has(n.id)).length;
+        const density = nodeCount > 1 ? edgeCount / (nodeCount * (nodeCount - 1)) : 0;
+        const avgLinksPerNote = nodeCount > 0 ? edgeCount / nodeCount : 0;
+        // Count by status
+        const statusCounts = {};
+        for (const n of notes) {
+            const s = n.status ?? "DRAFT";
+            statusCounts[s] = (statusCounts[s] ?? 0) + 1;
+        }
+        // Count by type
+        const typeCounts = {};
+        for (const n of notes) {
+            const t = n.noteType ?? "untyped";
+            typeCounts[t] = (typeCounts[t] ?? 0) + 1;
+        }
+        // Build checks
+        const checks = [];
+        // Orphan check
+        const orphans = notes.filter((n) => !incomingCounts.has(n.id));
+        checks.push({
+            id: generateId(),
+            category: "ORPHAN_DETECTION",
+            status: orphans.length === 0 ? "PASS" : orphans.length <= 3 ? "WARN" : "FAIL",
+            message: orphans.length === 0
+                ? "All notes have incoming links"
+                : `${orphans.length} note(s) have no incoming links`,
+            affectedItems: orphans.map((n) => n.title ?? n.name),
+        });
+        // Link density check
+        checks.push({
+            id: generateId(),
+            category: "LINK_HEALTH",
+            status: avgLinksPerNote >= 2 ? "PASS" : avgLinksPerNote >= 1 ? "WARN" : "FAIL",
+            message: `Average ${avgLinksPerNote.toFixed(1)} links per note${avgLinksPerNote < 2 ? " (target: 2+)" : ""}`,
+            affectedItems: notes
+                .filter((n) => n.links.length < 2)
+                .map((n) => n.title ?? n.name),
+        });
+        // Stale notes check (no description)
+        const noDesc = notes.filter((n) => !n.description);
+        checks.push({
+            id: generateId(),
+            category: "DESCRIPTION_QUALITY",
+            status: noDesc.length === 0 ? "PASS" : noDesc.length <= 2 ? "WARN" : "FAIL",
+            message: noDesc.length === 0
+                ? "All notes have descriptions"
+                : `${noDesc.length} note(s) missing descriptions`,
+            affectedItems: noDesc.map((n) => n.title ?? n.name),
+        });
+        const overallStatus = checks.some((c) => c.status === "FAIL")
+            ? "FAIL"
+            : checks.some((c) => c.status === "WARN")
+                ? "WARN"
+                : "PASS";
+        const recommendations = [];
+        if (orphans.length > 0)
+            recommendations.push(`Run /connect on ${orphans.length} orphan note(s)`);
+        if (avgLinksPerNote < 2)
+            recommendations.push("Increase link density — aim for 2+ links per note");
+        if (noDesc.length > 0)
+            recommendations.push(`Add descriptions to ${noDesc.length} note(s)`);
+        // Log the report (the health-report doc gets updated via the editor or plugin)
+        console.log(`[AutoHealth] ${overallStatus}: ${nodeCount} notes, ${edgeCount} edges, ${orphanCount} orphans, density ${(density * 100).toFixed(1)}%`);
+    }, [healthDoc, driveId, notes, graphState]);
+}

package/dist/editors/knowledge-vault/hooks/use-drive-init.d.ts

@@ -0,0 +1,7 @@
+export declare function useDriveInit(): void;
+/**
+ * Hook to get a map of folder paths to folder IDs.
+ * Useful for placing documents in the correct folder.
+ */
+export declare function useFolderMap(): Map<string, string>;
+//# sourceMappingURL=use-drive-init.d.ts.map

package/dist/editors/knowledge-vault/hooks/use-drive-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-drive-init.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-drive-init.ts"],"names":[],"mappings":"AAoEA,wBAAgB,YAAY,SAsB3B;AAgHD;;;GAGG;AACH,wBAAgB,YAAY,wBAI3B"}

package/dist/editors/knowledge-vault/hooks/use-drive-init.js

@@ -0,0 +1,136 @@
+import { useEffect, useRef } from "react";
+import { useSelectedDrive, useNodesInSelectedDrive, addDocument, addFolder, } from "@powerhousedao/reactor-browser";
+const FOLDER_TREE = [
+    {
+        name: "knowledge",
+        children: [{ name: "notes" }, { name: "inbox" }, { name: "insights" }],
+    },
+    { name: "sources" },
+    {
+        name: "ops",
+        children: [{ name: "sessions" }, { name: "health" }, { name: "queue" }],
+    },
+    {
+        name: "self",
+        children: [{ name: "methodology" }],
+    },
+    { name: "research" },
+];
+const SINGLETONS = [
+    {
+        name: "PipelineQueue",
+        type: "bai/pipeline-queue",
+        folderPath: "ops/queue",
+    },
+    {
+        name: "HealthReport",
+        type: "bai/health-report",
+        folderPath: "ops/health",
+    },
+    { name: "KnowledgeGraph", type: "bai/knowledge-graph", folderPath: "self" },
+    { name: "VaultConfig", type: "bai/vault-config", folderPath: "self" },
+];
+export function useDriveInit() {
+    // Use the drive ID (UUID), never the slug
+    const [selectedDrive] = useSelectedDrive();
+    const driveId = selectedDrive?.header.id;
+    const nodes = useNodesInSelectedDrive();
+    const initAttempted = useRef(false);
+    useEffect(() => {
+        if (!driveId || initAttempted.current)
+            return;
+        if (nodes === undefined)
+            return; // still loading
+        // Check if the root "knowledge" folder exists (our init marker)
+        const hasKnowledgeFolder = (nodes ?? []).some((n) => n.kind === "folder" && n.name === "knowledge" && n.parentFolder == null);
+        if (hasKnowledgeFolder)
+            return; // already initialized
+        initAttempted.current = true;
+        initDrive(driveId, nodes ?? []);
+    }, [driveId, nodes]);
+}
+async function initDrive(driveId, existingNodes) {
+    try {
+        console.log(`[VaultInit] Initializing drive ${driveId}...`);
+        // Build map of existing folders: path -> id
+        const existingFolderIds = buildExistingFolderMap(existingNodes);
+        const folderIds = new Map(existingFolderIds);
+        // Create folder tree recursively
+        await createFolderTree(driveId, FOLDER_TREE, undefined, "", folderIds);
+        // Wait a beat for the reactor to process folder creation
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Create singleton documents in their folders
+        const existingTypes = new Set(existingNodes
+            .filter((n) => n.kind === "file")
+            .map((n) => n.documentType));
+        for (const singleton of SINGLETONS) {
+            if (existingTypes.has(singleton.type)) {
+                console.log(`[VaultInit] ${singleton.name} already exists, skipping`);
+                continue;
+            }
+            const parentFolderId = folderIds.get(singleton.folderPath);
+            try {
+                // addDocument uses the drive UUID internally
+                await addDocument(driveId, singleton.name, singleton.type, parentFolderId);
+                console.log(`[VaultInit] Created ${singleton.name} in /${singleton.folderPath}/`);
+                // Small delay between document creations to avoid revision conflicts
+                await new Promise((resolve) => setTimeout(resolve, 500));
+            }
+            catch (err) {
+                console.error(`[VaultInit] Failed to create ${singleton.name}:`, err);
+            }
+        }
+        console.log("[VaultInit] Drive initialization complete");
+    }
+    catch (err) {
+        console.error("[VaultInit] Drive initialization failed:", err);
+    }
+}
+async function createFolderTree(driveId, defs, parentFolderId, pathPrefix, folderIds) {
+    for (const def of defs) {
+        const path = pathPrefix ? `${pathPrefix}/${def.name}` : def.name;
+        if (!folderIds.has(path)) {
+            try {
+                const result = await addFolder(driveId, def.name, parentFolderId);
+                folderIds.set(path, result.id);
+                console.log(`[VaultInit] Created folder: /${path}/`);
+                // Small delay to avoid revision conflicts
+                await new Promise((resolve) => setTimeout(resolve, 200));
+            }
+            catch (err) {
+                console.error(`[VaultInit] Failed to create folder /${path}/:`, err);
+                continue;
+            }
+        }
+        if (def.children) {
+            await createFolderTree(driveId, def.children, folderIds.get(path), path, folderIds);
+        }
+    }
+}
+function buildExistingFolderMap(nodes) {
+    const map = new Map();
+    const folders = nodes.filter((n) => n.kind === "folder");
+    const folderById = new Map(folders.map((f) => [f.id, f]));
+    for (const folder of folders) {
+        const pathParts = [];
+        let current = folder;
+        while (current) {
+            pathParts.unshift(current.name);
+            current = current.parentFolder
+                ? folderById.get(current.parentFolder)
+                : undefined;
+        }
+        map.set(pathParts.join("/"), folder.id);
+    }
+    return map;
+}
+/**
+ * Hook to get a map of folder paths to folder IDs.
+ * Useful for placing documents in the correct folder.
+ */
+export function useFolderMap() {
+    const nodes = useNodesInSelectedDrive();
+    if (!nodes)
+        return new Map();
+    return buildExistingFolderMap(nodes);
+}

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

@@ -0,0 +1,46 @@
+import type { KnowledgeGraphDocument } from "@powerhousedao/knowledge-note/document-models/knowledge-graph";
+import type { KnowledgeNoteInfo } from "./use-knowledge-notes.js";
+export type GraphState = {
+    nodes: {
+        id: string;
+        documentId: string;
+        title?: string | null;
+        noteType?: string | null;
+        status?: string | null;
+    }[];
+    edges: {
+        id: string;
+        sourceDocumentId: string;
+        targetDocumentId: string;
+        linkType?: string | null;
+    }[];
+    lastSyncedAt?: string | null;
+};
+/**
+ * Returns the first KnowledgeGraph document in the drive (created by use-drive-init).
+ * Does NOT auto-create — that's handled solely by useDriveInit to avoid duplicates.
+ */
+export declare function useKnowledgeGraph(notes: KnowledgeNoteInfo[]): {
+    graphDoc: KnowledgeGraphDocument | undefined;
+    graphState: GraphState | null;
+    hasGraphDoc: boolean;
+};
+/**
+ * Builds the sync payload from the current notes.
+ */
+export declare function buildSyncPayload(notes: KnowledgeNoteInfo[]): {
+    nodes: {
+        id: string;
+        documentId: string;
+        title: string | null;
+        noteType: string | null;
+        status: string | null;
+    }[];
+    edges: {
+        id: string;
+        sourceDocumentId: string;
+        targetDocumentId: string;
+        linkType: string | null;
+    }[];
+};
+//# sourceMappingURL=use-knowledge-graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-knowledge-graph.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-knowledge-graph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAC5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,EAAE,CAAC;IACJ,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,EAAE,CAAC;IACJ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE;;;;EAU3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE;;;;;;;;;;;;;;EAuB1D"}

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

@@ -0,0 +1,39 @@
+import { useMemo } from "react";
+import { generateId } from "document-model/core";
+import { useKnowledgeGraphDocumentsInSelectedDrive } from "@powerhousedao/knowledge-note/document-models/knowledge-graph";
+/**
+ * Returns the first KnowledgeGraph document in the drive (created by use-drive-init).
+ * Does NOT auto-create — that's handled solely by useDriveInit to avoid duplicates.
+ */
+export function useKnowledgeGraph(notes) {
+    const graphDocs = useKnowledgeGraphDocumentsInSelectedDrive();
+    const graphDoc = graphDocs?.[0];
+    const graphState = graphDoc?.state.global ?? null;
+    return {
+        graphDoc,
+        graphState,
+        hasGraphDoc: !!graphDoc,
+    };
+}
+/**
+ * Builds the sync payload from the current notes.
+ */
+export function buildSyncPayload(notes) {
+    const nodeIds = new Set(notes.map((n) => n.id));
+    const nodes = notes.map((note) => ({
+        id: generateId(),
+        documentId: note.id,
+        title: note.title ?? null,
+        noteType: note.noteType ?? null,
+        status: note.status ?? null,
+    }));
+    const edges = notes.flatMap((note) => note.links
+        .filter((l) => l.targetDocumentId && nodeIds.has(l.targetDocumentId))
+        .map((link) => ({
+        id: generateId(),
+        sourceDocumentId: note.id,
+        targetDocumentId: link.targetDocumentId,
+        linkType: link.linkType ?? null,
+    })));
+    return { nodes, edges };
+}