nlm-memory 0.5.0 → 0.5.2

package/src/ui/components/SideNav.tsx

@@ -1,162 +0,0 @@
-import { useEffect, useState } from "react";
-import { NavLink } from "react-router-dom";
-
-const STORAGE_KEY = "nlm.sidenav.collapsed";
-
-interface NavItem {
-  to: string;
-  label: string;
-  icon: JSX.Element;
-}
-
-const NAV_ITEMS: NavItem[] = [
-  { to: "/live",   label: "Live",   icon: liveIcon() },
-  { to: "/pulse",  label: "Pulse",  icon: pulseIcon() },
-  { to: "/river",  label: "River",  icon: riverIcon() },
-  { to: "/thread", label: "Thread", icon: threadIcon() },
-  { to: "/search", label: "Search", icon: searchIcon() },
-  { to: "/recall", label: "Recall", icon: recallIcon() },
-  { to: "/settings", label: "Settings", icon: settingsIcon() },
-];
-
-export function SideNav() {
-  const [collapsed, setCollapsed] = useState<boolean>(() => {
-    if (typeof window === "undefined") return false;
-    return window.localStorage.getItem(STORAGE_KEY) === "1";
-  });
-
-  useEffect(() => {
-    document.body.style.setProperty("--sidenav-w", collapsed ? "52px" : "180px");
-    window.localStorage.setItem(STORAGE_KEY, collapsed ? "1" : "0");
-  }, [collapsed]);
-
-  return (
-    <nav className={`sidenav${collapsed ? " collapsed" : ""}`} aria-label="Primary navigation">
-      <div className="sidenav-header">
-        <span className="sidenav-wordmark">NLM</span>
-        <button
-          className="sidenav-toggle"
-          aria-label="Toggle sidebar"
-          onClick={() => setCollapsed((c) => !c)}
-        >
-          {collapsed ? chevronRight() : chevronLeft()}
-        </button>
-      </div>
-
-      <div className="sidenav-items">
-        {NAV_ITEMS.map((item) => (
-          <NavLink
-            key={item.to}
-            to={item.to}
-            className={({ isActive }) => `sidenav-item${isActive ? " active" : ""}`}
-            data-label={item.label}
-          >
-            <span className="item-icon">{item.icon}</span>
-            <span className="item-label">{item.label}</span>
-          </NavLink>
-        ))}
-      </div>
-
-      <div className="sidenav-footer">
-        <NavLink to="/settings/data" className="sidenav-item sidenav-data" data-label="Data">
-          <span className="item-icon">{dataIcon()}</span>
-          <span className="item-label">Data</span>
-        </NavLink>
-      </div>
-    </nav>
-  );
-}
-
-// ── icons — extracted verbatim from Astro SideNav for visual parity ──────
-
-function svg(children: JSX.Element, size = 16) {
-  return (
-    <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.75} strokeLinecap="round" strokeLinejoin="round">
-      {children}
-    </svg>
-  );
-}
-
-function liveIcon() {
-  // green-dot broadcast — distinct from pulse so /live reads as its own thing
-  return svg(
-    <>
-      <circle cx="12" cy="12" r="3" />
-      <path d="M19 12a7 7 0 00-14 0M22 12a10 10 0 00-20 0" />
-    </>,
-  );
-}
-
-function pulseIcon() {
-  return svg(<polyline points="22 12 18 12 15 21 9 3 6 12 2 12" />);
-}
-
-function riverIcon() {
-  return svg(<path d="M2 12c1.5-3 3-4.5 4.5-4.5S9 9 10.5 12s3 4.5 4.5 4.5S18 15 19.5 12 21 7.5 22 7.5" />);
-}
-
-function threadIcon() {
-  return svg(
-    <>
-      <line x1="6" y1="3" x2="6" y2="15" />
-      <circle cx="18" cy="6" r="3" />
-      <circle cx="6" cy="18" r="3" />
-      <path d="M18 9a9 9 0 01-9 9" />
-    </>,
-  );
-}
-
-function searchIcon() {
-  return svg(
-    <>
-      <circle cx="11" cy="11" r="8" />
-      <line x1="21" y1="21" x2="16.65" y2="16.65" />
-    </>,
-  );
-}
-
-function recallIcon() {
-  // bar-chart — observability / adoption telemetry
-  return svg(
-    <>
-      <line x1="6" y1="20" x2="6" y2="13" />
-      <line x1="12" y1="20" x2="12" y2="4" />
-      <line x1="18" y1="20" x2="18" y2="9" />
-    </>,
-  );
-}
-
-function settingsIcon() {
-  return svg(
-    <>
-      <path d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
-      <circle cx="12" cy="12" r="3" />
-    </>,
-  );
-}
-
-function dataIcon() {
-  return (
-    <svg width={14} height={14} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.75} strokeLinecap="round" strokeLinejoin="round">
-      <ellipse cx="12" cy="5" rx="9" ry="3" />
-      <path d="M21 12c0 1.657-4.03 3-9 3S3 13.657 3 12" />
-      <path d="M3 5v14c0 1.657 4.03 3 9 3s9-1.343 9-3V5" />
-    </svg>
-  );
-}
-
-function chevronLeft() {
-  return (
-    <svg width={14} height={14} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={2} strokeLinecap="round" strokeLinejoin="round">
-      <polyline points="15 18 9 12 15 6" />
-    </svg>
-  );
-}
-
-function chevronRight() {
-  return (
-    <svg width={14} height={14} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={2} strokeLinecap="round" strokeLinejoin="round">
-      <polyline points="9 18 15 12 9 6" />
-    </svg>
-  );
-}

package/src/ui/components/Skeleton.tsx

@@ -1,107 +0,0 @@
-/**
- * Skeleton — shape-matched placeholders for first-load states.
- *
- * Only used where the shape is known + the data fetch is slow enough that
- * the page reflowing from "Loading…" to populated is jarring. Cached
- * refetches reuse stale data; they never show a skeleton.
- */
-
-export function Skeleton({
-  w,
-  h = 12,
-  radius = 4,
-  className,
-}: {
-  w?: number | string;
-  h?: number | string;
-  radius?: number;
-  className?: string;
-}) {
-  const style: React.CSSProperties = {
-    width: typeof w === "number" ? `${w}px` : w ?? "100%",
-    height: typeof h === "number" ? `${h}px` : h,
-    borderRadius: radius,
-  };
-  return <span className={`skeleton${className ? ` ${className}` : ""}`} style={style} aria-hidden="true" />;
-}
-
-export function PulseSkeleton() {
-  return (
-    <div className="page-pad">
-      <div className="kpi-row">
-        {Array.from({ length: 4 }).map((_, i) => (
-          <div key={i} className="kpi">
-            <Skeleton h={10} w={70} />
-            <Skeleton h={28} w={90} />
-            <Skeleton h={10} w={60} />
-          </div>
-        ))}
-        <div className="kpi"><Skeleton h={56} /></div>
-      </div>
-      <div className="pulse-grid">
-        {Array.from({ length: 4 }).map((_, i) => (
-          <section key={i} className="card">
-            <header className="card-head"><Skeleton h={14} w={140} /></header>
-            <div style={{ display: "flex", flexDirection: "column", gap: 10, padding: "12px 0" }}>
-              {Array.from({ length: 5 }).map((__, j) => (
-                <Skeleton key={j} h={12} w={`${65 + ((j * 7) % 30)}%`} />
-              ))}
-            </div>
-          </section>
-        ))}
-      </div>
-    </div>
-  );
-}
-
-export function SessionListSkeleton({ rows = 6 }: { rows?: number }) {
-  return (
-    <ul className="session-list">
-      {Array.from({ length: rows }).map((_, i) => (
-        <li key={i} className="session-row session-row-detail">
-          <Skeleton h={18} w={56} radius={10} />
-          <div className="session-row-main">
-            <Skeleton h={13} w={`${50 + ((i * 11) % 35)}%`} />
-            <Skeleton h={11} w={`${30 + ((i * 13) % 50)}%`} />
-          </div>
-          <Skeleton h={10} w={48} />
-        </li>
-      ))}
-    </ul>
-  );
-}
-
-export function TableRowSkeleton({ rows = 8, cols = 6 }: { rows?: number; cols?: number }) {
-  return (
-    <tbody>
-      {Array.from({ length: rows }).map((_, i) => (
-        <tr key={i}>
-          {Array.from({ length: cols }).map((__, j) => (
-            <td key={j}><Skeleton h={12} w={j === 0 ? "70%" : j === cols - 1 ? "60%" : "50%"} /></td>
-          ))}
-        </tr>
-      ))}
-    </tbody>
-  );
-}
-
-export function SessionDrawerSkeleton() {
-  return (
-    <div className="drawer-body">
-      <dl className="kv-list">
-        {Array.from({ length: 5 }).map((_, i) => (
-          <div key={i} style={{ display: "contents" }}>
-            <dt className="kv-label"><Skeleton h={10} w={70} /></dt>
-            <dd className="kv-value"><Skeleton h={12} w={`${40 + ((i * 13) % 50)}%`} /></dd>
-          </div>
-        ))}
-      </dl>
-      <h4 className="drawer-section"><Skeleton h={12} w={100} /></h4>
-      <div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
-        {Array.from({ length: 4 }).map((_, i) => (
-          <Skeleton key={i} h={12} w={`${55 + ((i * 7) % 35)}%`} />
-        ))}
-      </div>
-    </div>
-  );
-}

package/src/ui/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>nlm memory</title>
-    <link rel="stylesheet" href="./styles.css" />
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="./main.tsx"></script>
-  </body>
-</html>

package/src/ui/lib/actions.ts

@@ -1,30 +0,0 @@
-/**
- * Action client. POSTs to /api/action; callers refetch the dataset to see
- * the overlay re-applied. Returns the new action id so callers can stash
- * it for undo.
- */
-
-export interface ActionPayload {
-  kind: string;
-  subject_type: string;
-  subject_id: string;
-  payload?: Record<string, unknown>;
-  actor?: string;
-  runtime?: string;
-}
-
-export async function postAction(input: ActionPayload): Promise<string> {
-  const res = await fetch("/api/action", {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ ...input, runtime: input.runtime ?? "web-ui" }),
-  });
-  if (!res.ok) throw new Error(`POST /api/action → ${res.status}`);
-  const data = (await res.json()) as { id: string };
-  return data.id;
-}
-
-export async function undoAction(actionId: string): Promise<void> {
-  const res = await fetch(`/api/action/${encodeURIComponent(actionId)}/undo`, { method: "POST" });
-  if (!res.ok) throw new Error(`undo → ${res.status}`);
-}

package/src/ui/lib/api.ts

@@ -1,92 +0,0 @@
-import { useEffect, useState } from "react";
-
-export interface RecentRead {
-  ts: string;
-  source: string;
-  query: string | null;
-  mode: string;
-  nResults: number;
-}
-
-export interface RecentWrite {
-  id: string;
-  runtime: string;
-  label: string;
-  summary: string;
-  createdAt: string;
-}
-
-export interface RecentMarker {
-  sessionId: string;
-  kind: "decision" | "open";
-  text: string;
-  label: string;
-  createdAt: string;
-}
-
-async function fetchJson<T>(path: string): Promise<T> {
-  const res = await fetch(path);
-  if (!res.ok) throw new Error(`${path} → ${res.status}`);
-  return res.json() as Promise<T>;
-}
-
-export interface PolledResult<T> {
-  /** Most recent successful payload, or `initial` until the first fetch lands. */
-  data: T;
-  /** Message from the latest failed tick; cleared on the next success. */
-  error: string | null;
-  /** Epoch ms of the last successful fetch, or null before the first. */
-  lastUpdated: number | null;
-  /** True until the first tick resolves (success or failure). */
-  loading: boolean;
-}
-
-export function usePolledEndpoint<T>(path: string, intervalMs: number, initial: T): PolledResult<T> {
-  const [state, setState] = useState<PolledResult<T>>({
-    data: initial,
-    error: null,
-    lastUpdated: null,
-    loading: true,
-  });
-  useEffect(() => {
-    let cancelled = false;
-    const tick = async () => {
-      try {
-        const next = await fetchJson<T>(path);
-        if (!cancelled) {
-          setState({ data: next, error: null, lastUpdated: Date.now(), loading: false });
-        }
-      } catch (e) {
-        // Keep prior data on transient failure; surface the error so the
-        // UI can flag staleness. The next tick retries.
-        if (!cancelled) {
-          setState((prev) => ({
-            ...prev,
-            error: e instanceof Error ? e.message : String(e),
-            loading: false,
-          }));
-        }
-      }
-    };
-    void tick();
-    const id = setInterval(tick, intervalMs);
-    return () => {
-      cancelled = true;
-      clearInterval(id);
-    };
-  }, [path, intervalMs]);
-  return state;
-}
-
-export function relativeTime(iso: string): string {
-  if (!iso) return "";
-  const t = Date.parse(iso);
-  if (!Number.isFinite(t)) return "";
-  const s = Math.max(0, Math.floor((Date.now() - t) / 1000));
-  if (s < 60) return `${s}s ago`;
-  const m = Math.floor(s / 60);
-  if (m < 60) return `${m}m ago`;
-  const h = Math.floor(m / 60);
-  if (h < 24) return `${h}h ago`;
-  return `${Math.floor(h / 24)}d ago`;
-}

package/src/ui/lib/dataset.ts

@@ -1,141 +0,0 @@
-/**
- * Dataset hook + types. /api/dataset is the single read backbone for pulse,
- * river, search, and thread. Fetched once on mount; pages compose against
- * the cached result. Optional polling for live refresh.
- */
-
-import { useCallback, useEffect, useRef, useState } from "react";
-
-export interface DatasetSession {
-  id: string;
-  date: string;
-  started_at: string | null;
-  ended_at: string | null;
-  label: string;
-  summary: string;
-  entities: string[];
-  decisions: string[];
-  open: string[];
-  open_questions: { id: string; text: string; resolved: boolean }[];
-  status: "active" | "idle" | "closed" | "superseded";
-  duration_min: number;
-  runtime: string;
-  supersedes?: string;
-  superseded_by?: string;
-}
-
-export interface DatasetEntity {
-  canonical: string;
-  type: string;
-  status: string;
-  session_count: number;
-  last_seen_session: string | null;
-}
-
-export interface DatasetAlert {
-  id: string;
-  type: "stale";
-  severity: "high" | "medium";
-  entity: string;
-  summary: string;
-  sessions: string[];
-  age_days: number;
-  last_touch_at: string | null;
-}
-
-export interface Dataset {
-  meta: {
-    last_sync: string;
-    sessions_total: number;
-    entities_total: number;
-    db_present: boolean;
-    db_path: string;
-  };
-  sessions: DatasetSession[];
-  entities: DatasetEntity[];
-  entity_colors: Record<string, string>;
-  entity_type: Record<string, string>;
-  entity_status: Record<string, string>;
-  metrics: {
-    this_week: number;
-    last_week: number;
-    sparkline: number[];
-    healthy: number;
-    sparse: number;
-    stale: number;
-    closed_decisions: number;
-  };
-  alerts: DatasetAlert[];
-  runtimes: DatasetRuntime[];
-}
-
-export interface DatasetRuntime {
-  name: string;
-  status: "active" | "idle" | "dormant";
-  sessions_total: number;
-  this_week: number;
-  last_week: number;
-  last_session_at: string | null;
-}
-
-export interface DatasetState {
-  data: Dataset | null;
-  loading: boolean;
-  error: string | null;
-  refetch: () => Promise<void>;
-}
-
-interface DatasetInternal {
-  data: Dataset | null;
-  loading: boolean;
-  error: string | null;
-}
-
-export function useDataset(pollMs?: number): DatasetState {
-  const [state, setState] = useState<DatasetInternal>({ data: null, loading: true, error: null });
-  const cancelledRef = useRef(false);
-
-  const load = useCallback(async () => {
-    try {
-      const res = await fetch("/api/dataset");
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      const data = (await res.json()) as Dataset;
-      if (!cancelledRef.current) setState({ data, loading: false, error: null });
-    } catch (e) {
-      if (!cancelledRef.current) {
-        const msg = e instanceof Error ? e.message : String(e);
-        setState((prev) => ({ data: prev.data, loading: false, error: msg }));
-      }
-    }
-  }, []);
-
-  useEffect(() => {
-    cancelledRef.current = false;
-    void load();
-    if (pollMs && pollMs > 0) {
-      const id = setInterval(load, pollMs);
-      return () => {
-        cancelledRef.current = true;
-        clearInterval(id);
-      };
-    }
-    return () => {
-      cancelledRef.current = true;
-    };
-  }, [pollMs, load]);
-
-  return { ...state, refetch: load };
-}
-
-export function relativeAge(iso: string | null | undefined): string {
-  if (!iso) return "—";
-  const t = Date.parse(iso);
-  if (!Number.isFinite(t)) return "—";
-  const days = Math.floor((Date.now() - t) / 86_400_000);
-  if (days <= 0) return "today";
-  if (days === 1) return "1d";
-  if (days < 30) return `${days}d`;
-  const months = Math.floor(days / 30);
-  if (months < 12) return `${months}mo`;
-  return `${Math.floor(days / 365)}y`;
-}

package/src/ui/lib/registries.ts

@@ -1,155 +0,0 @@
-/**
- * Shared types + tiny helpers for the sources and providers registries.
- *
- * Mirrors the daemon contracts in src/core/sources/source-registry.ts and
- * src/core/providers/provider-registry.ts. HTTP responses always carry
- * redacted rows (no api_key, no source token) except the one-time reveal
- * on insert/regenerate.
- */
-
-export type SourceKind = "claude-code" | "hermes" | "pi" | "jsonl-generic" | "webhook";
-
-export interface SourceRow {
-  id: number;
-  kind: SourceKind;
-  name: string;
-  pathOrUrl: string | null;
-  runtimeLabel: string;
-  parseConfig: Record<string, unknown>;
-  enabled: boolean;
-  token: string | null;
-  hasToken: boolean;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export type ProviderKind =
-  | "deepseek"
-  | "ollama"
-  | "openai"
-  | "anthropic"
-  | "openrouter"
-  | "openai-compatible";
-
-export interface ProviderRow {
-  id: number;
-  kind: ProviderKind;
-  name: string;
-  baseUrl: string | null;
-  apiKey: string | null;
-  hasApiKey: boolean;
-  defaultModel: string | null;
-  enabled: boolean;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export const SOURCE_KINDS: ReadonlyArray<SourceKind> = [
-  "claude-code", "hermes", "pi", "jsonl-generic", "webhook",
-];
-
-export const PROVIDER_KINDS: ReadonlyArray<ProviderKind> = [
-  "deepseek", "ollama", "openai", "anthropic", "openrouter", "openai-compatible",
-];
-
-export const PROVIDER_KIND_LABEL: Record<ProviderKind, string> = {
-  deepseek: "DeepSeek",
-  ollama: "Ollama",
-  openai: "OpenAI",
-  anthropic: "Anthropic",
-  openrouter: "OpenRouter",
-  "openai-compatible": "OpenAI-compatible",
-};
-
-export const SOURCE_KIND_LABEL: Record<SourceKind, string> = {
-  "claude-code": "Claude Code",
-  hermes: "Hermes",
-  pi: "pi.dev",
-  "jsonl-generic": "Custom JSONL",
-  webhook: "Webhook",
-};
-
-/** Defaults the "Add source" wizard offers per kind. The user can edit. */
-export const SOURCE_PRESETS: Record<
-  SourceKind,
-  { name: string; runtimeLabel: string; pathOrUrl: string | null; parseConfig: Record<string, unknown> }
-> = {
-  "claude-code": {
-    name: "Claude Code",
-    runtimeLabel: "claude-code",
-    pathOrUrl: "~/.claude/projects",
-    parseConfig: {},
-  },
-  hermes: {
-    name: "Hermes",
-    runtimeLabel: "hermes",
-    pathOrUrl: "~/.hermes/sessions",
-    parseConfig: {},
-  },
-  pi: {
-    name: "pi.dev",
-    runtimeLabel: "pi",
-    pathOrUrl: "~/.pi/transcripts",
-    parseConfig: {},
-  },
-  "jsonl-generic": {
-    name: "",
-    runtimeLabel: "",
-    pathOrUrl: "",
-    parseConfig: {
-      idField: "session_id",
-      textField: "text",
-      startedAtField: "started_at",
-      endedAtField: "ended_at",
-    },
-  },
-  webhook: {
-    name: "",
-    runtimeLabel: "",
-    pathOrUrl: null,
-    parseConfig: {},
-  },
-};
-
-export const PROVIDER_PRESETS: Record<ProviderKind, { baseUrl: string | null; defaultModel: string | null }> = {
-  deepseek: { baseUrl: "https://api.deepseek.com", defaultModel: "deepseek-v4-flash" },
-  ollama: { baseUrl: "http://localhost:11434", defaultModel: "phi4-mini:latest" },
-  openai: { baseUrl: "https://api.openai.com/v1", defaultModel: "gpt-4o-mini" },
-  anthropic: { baseUrl: "https://api.anthropic.com", defaultModel: "claude-haiku-4-5-20251001" },
-  openrouter: { baseUrl: "https://openrouter.ai/api/v1", defaultModel: "anthropic/claude-haiku-4-5" },
-  "openai-compatible": { baseUrl: "", defaultModel: null },
-};
-
-export async function fetchSources(): Promise<SourceRow[]> {
-  const r = await fetch("/api/sources");
-  if (!r.ok) throw new Error(`HTTP ${r.status}`);
-  const data = (await r.json()) as { sources: SourceRow[] };
-  return data.sources;
-}
-
-export async function fetchProviders(): Promise<ProviderRow[]> {
-  const r = await fetch("/api/providers");
-  if (!r.ok) throw new Error(`HTTP ${r.status}`);
-  const data = (await r.json()) as { providers: ProviderRow[] };
-  return data.providers;
-}
-
-export async function fetchProviderModels(id: number): Promise<string[]> {
-  const r = await fetch(`/api/providers/${id}/models`);
-  const data = (await r.json()) as { models?: string[]; error?: string };
-  if (!r.ok || data.error) throw new Error(data.error ?? `HTTP ${r.status}`);
-  return data.models ?? [];
-}
-
-export interface TestResult {
-  ok: boolean;
-  modelCount?: number;
-  latencyMs: number;
-  error?: string;
-}
-
-export async function testProvider(id: number): Promise<TestResult> {
-  const r = await fetch(`/api/providers/${id}/test`, { method: "POST" });
-  const data = (await r.json()) as TestResult;
-  return data;
-}