nlm-memory 0.5.0 → 0.5.1

package/src/ports/session-store.ts

@@ -1,45 +0,0 @@
-/**
- * SessionStore — the only way core/ reads or writes the session corpus.
- *
- * Implementations live in core/storage. Adapters and use cases depend on this
- * interface, never on better-sqlite3 directly. Swapping SQLite for Postgres
- * tomorrow means writing a new implementation; core/ does not change.
- */
-
-import type { Session, SessionStatus } from "@shared/types.js";
-
-export interface SessionFilter {
-  readonly entity?: string;
-  readonly hasDecisions?: boolean;
-  readonly hasOpenQuestions?: boolean;
-}
-
-export interface SemanticNeighbor {
-  readonly sessionId: string;
-  readonly distance: number;
-}
-
-export interface KeywordNeighbor {
-  readonly sessionId: string;
-  readonly score: number;
-}
-
-export interface SessionStore {
-  list(filter?: SessionFilter): Promise<ReadonlyArray<Session>>;
-
-  getById(sessionId: string): Promise<Session | null>;
-
-  getByIds(ids: ReadonlyArray<string>): Promise<ReadonlyArray<Session>>;
-
-  semanticSearch(
-    queryVector: Float32Array,
-    limit: number,
-  ): Promise<ReadonlyArray<SemanticNeighbor>>;
-
-  keywordSearch(
-    query: string,
-    limit: number,
-  ): Promise<ReadonlyArray<KeywordNeighbor>>;
-
-  updateStatus(sessionId: string, status: SessionStatus): Promise<void>;
-}

package/src/ports/transcript-adapter.ts

@@ -1,55 +0,0 @@
-/**
- * TranscriptAdapter — the port every runtime-specific reader implements.
- *
- * One adapter per AI runtime (claude-code, hermes, pi, codex, gemini, aider).
- * Adapters discover transcript files on disk and parse one into a normalized
- * SessionChunk that the classifier/ingest pipeline can hand off to the
- * SessionStore. Adapters do not touch storage; they convert "files on disk"
- * into "candidate sessions" and stop there.
- *
- * Layering: core/recall consumes Session (already-classified). This port
- * lives between raw transcripts and the classifier — invoked by the
- * Scheduler in Phase D.
- */
-
-export interface DetectionResult {
-  readonly adapterName: string;
-  readonly enabled: boolean;
-  readonly path: string | null;
-  readonly hint: string | null;
-}
-
-export interface SessionChunk {
-  readonly id: string;
-  readonly runtime: string;
-  readonly runtimeSessionId: string;
-  readonly sourcePath: string;
-  readonly startedAt: string;
-  readonly endedAt: string;
-  readonly durationMin: number;
-  readonly turnCount: number;
-  readonly byteRange: readonly [number, number];
-  readonly projectDir: string;
-  readonly gitBranch: string;
-  readonly text: string;
-  readonly label: string;
-}
-
-export interface DiscoverOptions {
-  readonly since?: Date;
-}
-
-export interface TranscriptAdapter {
-  readonly name: string;
-  readonly runtimeVersion: string;
-  readonly transcriptKind: string;
-
-  /** Detection: is this adapter usable on this host? */
-  detect(): DetectionResult;
-
-  /** List candidate transcript files, optionally filtered by mtime. */
-  discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
-
-  /** Parse one transcript into a SessionChunk, or null if it's empty/garbage. */
-  parseSession(path: string): Promise<SessionChunk | null>;
-}

package/src/shared/types.ts

@@ -1,149 +0,0 @@
-/**
- * Shared domain types crossed by core, http, mcp, and ui layers.
- * No runtime behavior here — types only.
- */
-
-/**
- * Session status as exposed to UI / recall consumers.
- *
- * Persisted values in `sessions.status` CHECK: 'active' | 'closed' | 'superseded'.
- * `idle` is a derived state computed from transcript mtime, returned by the
- * storage layer alongside the persisted value. `superseded` always wins over
- * mtime-derived state.
- */
-export type SessionStatus = "active" | "idle" | "closed" | "superseded";
-
-export type MarkerKind = "decision" | "open";
-
-export interface Session {
-  readonly id: string;
-  readonly runtime: string;
-  readonly runtimeSessionId: string;
-  readonly startedAt: string;
-  readonly endedAt: string | null;
-  readonly durationMin: number | null;
-  readonly label: string;
-  readonly summary: string;
-  readonly status: SessionStatus;
-  readonly transcriptKind: string;
-  readonly transcriptPath: string | null;
-  readonly body: string;
-  readonly entities: ReadonlyArray<string>;
-  readonly decisions: ReadonlyArray<string>;
-  readonly open: ReadonlyArray<string>;
-  /** IDs of sessions this session supersedes (newer → older). Populated by getById; absent on bulk reads. */
-  readonly supersedes?: ReadonlyArray<string>;
-  /** ID of the session that superseded this one, if any. Populated by getById; absent on bulk reads. */
-  readonly supersededBy?: string | null;
-}
-
-export type RecallMode = "keyword" | "semantic" | "hybrid";
-
-export type RecallKindFilter = "decision" | "open";
-
-export interface RecallQuery {
-  readonly query: string;
-  readonly entity?: string;
-  readonly kind?: RecallKindFilter;
-  readonly mode?: RecallMode;
-  readonly limit?: number;
-}
-
-export interface RecallHit {
-  readonly id: string;
-  readonly startedAt: string;
-  readonly label: string;
-  readonly summary: string;
-  readonly entities: ReadonlyArray<string>;
-  readonly decisions: ReadonlyArray<string>;
-  readonly open: ReadonlyArray<string>;
-  readonly status: SessionStatus;
-  readonly matchScore: number;
-  readonly matchedIn: ReadonlyArray<MatchField>;
-  readonly keywordScore?: number;
-  readonly semanticScore?: number;
-}
-
-export type MatchField = "label" | "decisions" | "open" | "summary" | "semantic";
-
-export interface RecallResult {
-  readonly query: string;
-  readonly entity: string | null;
-  readonly kind: RecallKindFilter | null;
-  readonly mode: RecallMode;
-  readonly limit: number;
-  readonly total: number;
-  readonly results: ReadonlyArray<RecallHit>;
-  readonly modeUnavailable?: "ollama_unreachable";
-}
-
-/**
- * Fact — a single normalized claim derived from a session.
- *
- * The product treats sessions as the unit of operator recall. Facts are the
- * agent-facing projection: queryable by (subject, predicate), supersedence-
- * aware, with provenance back to the session they came from. See
- * docs/plans/factstore-design.md for the full design rationale.
- *
- * `kind` mirrors the marker taxonomy plus a third category for entity
- * attributes ("mac-pro-llm-host" + "endpoint" + "http://macpro:8080/v1").
- *
- * `subject` and `predicate` are normalized (lowercased, trimmed) at extraction
- * time so the deterministic supersedence path can do exact-match collision
- * detection without per-query normalization.
- *
- * `supersededBy` is a tombstone pointer — when a newer fact replaces this one
- * the old row stays and gets pointed at the new id. Never deleted.
- */
-export type FactKind = "decision" | "open" | "attribute";
-
-export interface Fact {
-  readonly id: string;
-  readonly kind: FactKind;
-  readonly subject: string;
-  readonly predicate: string;
-  readonly value: string;
-  readonly sourceSessionId: string;
-  readonly sourceQuote: string | null;
-  readonly createdAt: string;
-  readonly supersededBy: string | null;
-  readonly confidence: number;
-}
-
-export type FactMatchField = "value" | "subject" | "predicate" | "semantic";
-
-export interface FactRecallQuery {
-  readonly query?: string;
-  readonly subject?: string;
-  readonly predicate?: string;
-  readonly kind?: FactKind;
-  readonly includeSuperseded?: boolean;
-  readonly minConfidence?: number;
-  readonly mode?: RecallMode;
-  readonly limit?: number;
-}
-
-export interface FactHit extends Fact {
-  readonly matchScore: number;
-  readonly matchedIn: ReadonlyArray<FactMatchField>;
-  readonly keywordScore?: number;
-  readonly semanticScore?: number;
-}
-
-export interface FactRecallResult {
-  readonly query: string;
-  readonly subject: string | null;
-  readonly predicate: string | null;
-  readonly kind: FactKind | null;
-  readonly mode: RecallMode;
-  readonly limit: number;
-  readonly total: number;
-  readonly results: ReadonlyArray<FactHit>;
-  readonly modeUnavailable?: "ollama_unreachable";
-}
-
-export interface FactHistoryChain {
-  readonly subject: string;
-  readonly predicate: string;
-  readonly history: ReadonlyArray<Fact>;
-}

package/src/ui/App.tsx

@@ -1,58 +0,0 @@
-import { Navigate, Route, Routes, useLocation } from "react-router-dom";
-import { SideNav } from "./components/SideNav.js";
-import { LivePage } from "./pages/Live.js";
-import { PulsePage } from "./pages/Pulse.js";
-import { RiverPage } from "./pages/River.js";
-import { SearchPage } from "./pages/Search.js";
-import { ThreadPage } from "./pages/Thread.js";
-import { RecallPage } from "./pages/Recall.js";
-import { SettingsIndexPage } from "./pages/settings/Index.js";
-import { SettingsDataPage } from "./pages/settings/Data.js";
-import { SettingsViewsPage } from "./pages/settings/Views.js";
-import { SettingsLabelsPage } from "./pages/settings/Labels.js";
-import { SettingsClassifierPage } from "./pages/settings/Classifier.js";
-import { SettingsSourcesPage } from "./pages/settings/Sources.js";
-import { SettingsProvidersPage } from "./pages/settings/Providers.js";
-import { StubPage } from "./pages/Stub.js";
-import { readViewSettings } from "./lib/view-settings.js";
-
-export function App() {
-  return (
-    <div className="page-shell">
-      <SideNav />
-      <div className="page-main">
-        <AppHeader />
-        <Routes>
-          <Route path="/" element={<Navigate to={`/${readViewSettings().landing}`} replace />} />
-          <Route path="/live"                element={<LivePage />} />
-          <Route path="/pulse"               element={<PulsePage />} />
-          <Route path="/river"               element={<RiverPage />} />
-          <Route path="/thread"              element={<ThreadPage />} />
-          <Route path="/search"              element={<SearchPage />} />
-          <Route path="/recall"              element={<RecallPage />} />
-          <Route path="/settings"            element={<SettingsIndexPage />} />
-          <Route path="/settings/sources"    element={<SettingsSourcesPage />} />
-          <Route path="/settings/providers"  element={<SettingsProvidersPage />} />
-          <Route path="/settings/labels"     element={<SettingsLabelsPage />} />
-          <Route path="/settings/classifier" element={<SettingsClassifierPage />} />
-          <Route path="/settings/data"       element={<SettingsDataPage />} />
-          <Route path="/settings/views"      element={<SettingsViewsPage />} />
-          <Route path="*"                    element={<StubPage page="not found" />} />
-        </Routes>
-      </div>
-    </div>
-  );
-}
-
-function AppHeader() {
-  const { pathname } = useLocation();
-  const page = pathname.replace(/^\//, "").replace(/\/+$/, "") || "live";
-  return (
-    <header className="app-header">
-      <span className="wordmark-page">{page}</span>
-      <span className="header-spacer" />
-      <span className="status-dot" aria-hidden="true" />
-      <span className="header-info">nlm-memory · :3940</span>
-    </header>
-  );
-}

package/src/ui/components/PromoteOpenButton.tsx

@@ -1,65 +0,0 @@
-import { useState } from "react";
-import { postAction } from "../lib/actions.js";
-
-interface PromoteOpenButtonProps {
-  openId: string;
-  defaultText: string;
-  onPromoted: () => void | Promise<void>;
-}
-
-/**
- * Inline "flip → decision" control for an open question.
- * Click → expands a small editor pre-filled with the original text;
- * the user accepts as-is or rewords, then submits. POSTs a
- * `promote_open` action which the dataset overlay projects as a
- * decision on the next read.
- */
-export function PromoteOpenButton({ openId, defaultText, onPromoted }: PromoteOpenButtonProps) {
-  const [editing, setEditing] = useState(false);
-  const [busy, setBusy] = useState(false);
-  const [value, setValue] = useState(defaultText);
-
-  const submit = async () => {
-    const resolution = value.trim();
-    if (!resolution) return;
-    setBusy(true);
-    try {
-      await postAction({
-        kind: "promote_open",
-        subject_type: "open_question",
-        subject_id: openId,
-        payload: { resolution, original_text: defaultText },
-      });
-      await onPromoted();
-      setEditing(false);
-    } catch {
-      setBusy(false);
-    }
-  };
-
-  if (!editing) {
-    return (
-      <button type="button" className="chip promote-chip" onClick={() => { setValue(defaultText); setEditing(true); }}>
-        → decision
-      </button>
-    );
-  }
-
-  return (
-    <div className="promote-editor" onClick={(e) => e.stopPropagation()}>
-      <input
-        className="form-input form-input-inline promote-input"
-        value={value}
-        onChange={(e) => setValue(e.target.value)}
-        onKeyDown={(e) => {
-          if (e.key === "Enter") { e.preventDefault(); void submit(); }
-          if (e.key === "Escape") { e.preventDefault(); setEditing(false); }
-        }}
-        disabled={busy}
-        autoFocus
-      />
-      <button type="button" className="chip" onClick={() => void submit()} disabled={busy || !value.trim()}>save</button>
-      <button type="button" className="chip" onClick={() => setEditing(false)} disabled={busy}>cancel</button>
-    </div>
-  );
-}

package/src/ui/components/SessionDrawer.tsx

@@ -1,199 +0,0 @@
-import { useEffect, useState } from "react";
-import { Link } from "react-router-dom";
-import { SessionDrawerSkeleton } from "./Skeleton.js";
-
-interface SessionDetail {
-  id: string;
-  label: string;
-  summary: string;
-  body: string;
-  status: string;
-  startedAt: string | null;
-  endedAt: string | null;
-  durationMin: number | null;
-  runtime: string;
-  entities: string[];
-  decisions: string[];
-  open: string[];
-  supersededBy: string | null;
-  supersedes: string[];
-}
-
-interface SessionDrawerProps {
-  sessionId: string;
-  onClose: () => void;
-  entityColor?: string;
-  onNavigate?: (id: string) => void;
-  prevSessionId?: string | null;
-  nextSessionId?: string | null;
-}
-
-export function SessionDrawer({ sessionId, onClose, entityColor, onNavigate, prevSessionId, nextSessionId }: SessionDrawerProps) {
-  const [session, setSession] = useState<SessionDetail | null>(null);
-  const [error, setError] = useState<string | null>(null);
-
-  useEffect(() => {
-    setSession(null);
-    setError(null);
-    fetch(`/api/session/${encodeURIComponent(sessionId)}`)
-      .then(async (r) => {
-        if (!r.ok) throw new Error(`HTTP ${r.status}`);
-        const raw = (await r.json()) as Record<string, unknown>;
-        setSession({
-          id: String(raw["id"] ?? sessionId),
-          label: String(raw["label"] ?? ""),
-          summary: String(raw["summary"] ?? ""),
-          body: String(raw["body"] ?? ""),
-          status: String(raw["status"] ?? "closed"),
-          startedAt: typeof raw["startedAt"] === "string" ? (raw["startedAt"] as string) : null,
-          endedAt: typeof raw["endedAt"] === "string" ? (raw["endedAt"] as string) : null,
-          durationMin: typeof raw["durationMin"] === "number" ? (raw["durationMin"] as number) : null,
-          runtime: String(raw["runtime"] ?? ""),
-          entities: Array.isArray(raw["entities"]) ? (raw["entities"] as string[]) : [],
-          decisions: Array.isArray(raw["decisions"]) ? (raw["decisions"] as string[]) : [],
-          open: Array.isArray(raw["open"]) ? (raw["open"] as string[]) : [],
-          supersededBy: typeof raw["supersededBy"] === "string" ? (raw["supersededBy"] as string) : null,
-          supersedes: Array.isArray(raw["supersedes"]) ? (raw["supersedes"] as string[]) : [],
-        });
-      })
-      .catch((e: unknown) => setError(e instanceof Error ? e.message : String(e)));
-  }, [sessionId]);
-
-  useEffect(() => {
-    const handler = (e: KeyboardEvent) => {
-      if (e.key === "Escape") { onClose(); return; }
-      if (e.key === "ArrowLeft" && prevSessionId != null && onNavigate) onNavigate(prevSessionId);
-      if (e.key === "ArrowRight" && nextSessionId != null && onNavigate) onNavigate(nextSessionId);
-    };
-    window.addEventListener("keydown", handler);
-    return () => window.removeEventListener("keydown", handler);
-  }, [onClose, onNavigate, prevSessionId, nextSessionId]);
-
-  return (
-    <>
-      <div className="drawer-backdrop" onClick={onClose} />
-      <aside className="session-drawer" role="dialog" aria-modal="true">
-        <header className="drawer-head">
-          {entityColor && <span className="dot" style={{ background: entityColor }} />}
-          <h3 className="drawer-title">{session?.label ?? sessionId}</h3>
-          {(prevSessionId != null || nextSessionId != null) && onNavigate && (
-            <div className="drawer-nav">
-              <button
-                type="button"
-                className="drawer-nav-btn"
-                disabled={prevSessionId == null}
-                onClick={() => prevSessionId && onNavigate(prevSessionId)}
-                aria-label="Previous session"
-              >
-                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M15 18l-6-6 6-6"/></svg>
-              </button>
-              <button
-                type="button"
-                className="drawer-nav-btn"
-                disabled={nextSessionId == null}
-                onClick={() => nextSessionId && onNavigate(nextSessionId)}
-                aria-label="Next session"
-              >
-                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M9 18l6-6-6-6"/></svg>
-              </button>
-            </div>
-          )}
-          <button type="button" className="drawer-close" onClick={onClose} aria-label="Close">×</button>
-        </header>
-        {error && <div className="muted error drawer-body">{error}</div>}
-        {!session && !error && <SessionDrawerSkeleton />}
-        {session && (
-          <div className="drawer-body">
-            {session.supersededBy && (
-              <div className="supersedence-banner supersedence-banner--superseded">
-                <span className="supersedence-label">Superseded by</span>
-                {onNavigate ? (
-                  <button
-                    type="button"
-                    className="supersedence-link"
-                    onClick={() => onNavigate(session.supersededBy!)}
-                  >
-                    {session.supersededBy}
-                  </button>
-                ) : (
-                  <span className="supersedence-id mono small">{session.supersededBy}</span>
-                )}
-              </div>
-            )}
-            {session.supersedes.length > 0 && (
-              <div className="supersedence-banner supersedence-banner--supersedes">
-                <span className="supersedence-label">Supersedes</span>
-                <span className="supersedence-ids">
-                  {session.supersedes.map((sid) => (
-                    onNavigate ? (
-                      <button
-                        key={sid}
-                        type="button"
-                        className="supersedence-link"
-                        onClick={() => onNavigate(sid)}
-                      >
-                        {sid}
-                      </button>
-                    ) : (
-                      <span key={sid} className="supersedence-id mono small">{sid}</span>
-                    )
-                  ))}
-                </span>
-              </div>
-            )}
-            {session.summary && (
-              <>
-                <h4 className="drawer-section">Summary</h4>
-                <p className="drawer-paragraph">{session.summary}</p>
-              </>
-            )}
-            {session.decisions.length > 0 && (
-              <>
-                <h4 className="drawer-section">Decisions</h4>
-                <ul className="drawer-list">
-                  {session.decisions.map((d, i) => <li key={i}><span className="live-tag" data-kind="decision">decision</span> {d}</li>)}
-                </ul>
-              </>
-            )}
-            {session.open.length > 0 && (
-              <>
-                <h4 className="drawer-section">Open questions</h4>
-                <ul className="drawer-list">
-                  {session.open.map((q, i) => <li key={i}><span className="live-tag" data-kind="open">open</span> {q}</li>)}
-                </ul>
-              </>
-            )}
-            {session.entities.length > 0 && (
-              <>
-                <h4 className="drawer-section">Entities</h4>
-                <div className="entity-chips">
-                  {session.entities.map((e) => (
-                    <Link key={e} to={`/thread?entity=${encodeURIComponent(e)}`} className="chip" onClick={onClose}>{e}</Link>
-                  ))}
-                </div>
-              </>
-            )}
-            <dl className="kv-list">
-              <dt className="kv-label">Status</dt>
-              <dd className="kv-value"><span className={`chip-inline status-${session.status}`}>{session.status}</span></dd>
-              <dt className="kv-label">Started</dt>
-              <dd className="kv-value mono small">{session.startedAt ?? "—"}</dd>
-              <dt className="kv-label">Duration</dt>
-              <dd className="kv-value">{session.durationMin ?? "—"} min</dd>
-              <dt className="kv-label">Runtime</dt>
-              <dd className="kv-value mono small">{session.runtime}</dd>
-              <dt className="kv-label">Session ID</dt>
-              <dd className="kv-value mono small">{session.id}</dd>
-            </dl>
-            {session.body && (
-              <>
-                <h4 className="drawer-section">Transcript excerpt</h4>
-                <pre className="drawer-body-text">{session.body.slice(0, 3000)}{session.body.length > 3000 ? "\n\n[…truncated]" : ""}</pre>
-              </>
-            )}
-          </div>
-        )}
-      </aside>
-    </>
-  );
-}