recallnest 2.2.0 → 2.3.0

package/src/mcp-server.ts

@@ -1819,11 +1819,11 @@ registerTool(
 
 registerTool(
   "import_conversations",
-  "Import a conversation file (Claude Code JSONL, Claude.ai JSON, ChatGPT JSON, Slack JSON, or plaintext) into memory. Auto-detects format or use explicit format parameter. Messages are normalized and stored via the standard persistMemory pipeline.",
+  "Import a conversation file (Claude Code JSONL, Claude.ai JSON, ChatGPT JSON, Slack JSON, plaintext, or connector-v1 JSON) into memory. Auto-detects format or use explicit format parameter. Messages are normalized and stored via the standard persistMemory pipeline. For connector-v1 format, use the standard ConnectorOutputV1 schema (see docs/connector-spec.md).",
   {
     content: z.string().min(1).max(500_000).describe("Raw file content to import"),
     scope: z.string().min(1).max(160).describe("Target scope for imported memories, e.g. 'project:myapp'"),
-    format: z.enum(["auto", "claude-code", "claude-ai", "chatgpt", "slack", "plaintext"]).default("auto").describe("Conversation format. Use 'auto' to detect automatically."),
+    format: z.enum(["auto", "claude-code", "claude-ai", "chatgpt", "slack", "plaintext", "connector-v1"]).default("auto").describe("Conversation format. Use 'auto' to detect automatically. 'connector-v1' for standard connector output."),
   },
   async ({ content, scope, format }) => {
     const { detectFormat, normalizeConversation, ingestNormalizedMessages } = await import("./conversation-importer.js");

package/src/obsidian-connector.ts

@@ -0,0 +1,282 @@
+/**
+ * Obsidian Vault Connector (GB-1)
+ *
+ * Scans an Obsidian vault directory and produces a ConnectorOutputV1 payload.
+ * Recognizes:
+ * - .obsidian/ directory (vault detection)
+ * - YAML frontmatter (tags, aliases, arbitrary metadata)
+ * - [[wikilinks]] (extracted as entity associations via link: tags)
+ * - Directory structure (folder: tags for scope/topic mapping)
+ * - Content hash (SHA-256 prefix) for incremental sync
+ */
+
+import { createHash } from "node:crypto";
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { join, relative, basename, dirname } from "node:path";
+import type { ConnectorOutputV1, ConnectorRecord } from "./connector-types.js";
+
+// ============================================================================
+// Vault Detection
+// ============================================================================
+
+/** Check if a directory is an Obsidian vault (contains .obsidian/ folder) */
+export function isObsidianVault(dirPath: string): boolean {
+  try {
+    return existsSync(join(dirPath, ".obsidian"));
+  } catch {
+    return false;
+  }
+}
+
+// ============================================================================
+// YAML Frontmatter Parser
+// ============================================================================
+
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)(?:\r?\n)?---/;
+
+export interface ObsidianFrontmatter {
+  tags?: string[];
+  aliases?: string[];
+  [key: string]: unknown;
+}
+
+/**
+ * Parse YAML frontmatter from markdown content.
+ * Lightweight parser — handles:
+ * - key: value (strings)
+ * - key: [inline, list]
+ * - key:\n  - list\n  - items
+ * Does NOT handle nested objects, multi-line strings, or anchors.
+ * Returns null frontmatter on parse failure (never throws).
+ */
+export function parseFrontmatter(content: string): {
+  frontmatter: ObsidianFrontmatter | null;
+  body: string;
+} {
+  const match = content.match(FRONTMATTER_RE);
+  if (!match) return { frontmatter: null, body: content };
+
+  const yamlBlock = match[1];
+  const body = content.slice(match[0].length).trimStart();
+
+  try {
+    const fm: ObsidianFrontmatter = {};
+    let currentKey: string | null = null;
+    let listAccum: string[] = [];
+
+    function flushList(): void {
+      if (currentKey && listAccum.length > 0) {
+        fm[currentKey] = listAccum;
+        listAccum = [];
+      }
+      currentKey = null;
+    }
+
+    for (const line of yamlBlock.split("\n")) {
+      // List item: "  - value"
+      const listItem = line.match(/^\s+-\s+(.+)/);
+      if (listItem && currentKey) {
+        listAccum.push(listItem[1].trim().replace(/^['"]|['"]$/g, ""));
+        continue;
+      }
+
+      // Key-value: "key: value"
+      const kv = line.match(/^([\w][\w-]*):\s*(.*)/);
+      if (kv) {
+        flushList();
+        const [, key, rawVal] = kv;
+        const val = rawVal.trim();
+
+        if (val === "" || val === "[]") {
+          // Empty value or empty inline list — start list accumulator
+          currentKey = key;
+          listAccum = [];
+        } else if (val.startsWith("[") && val.endsWith("]")) {
+          // Inline list: [a, b, c]
+          fm[key] = val
+            .slice(1, -1)
+            .split(",")
+            .map((s) => s.trim().replace(/^['"]|['"]$/g, ""))
+            .filter(Boolean);
+        } else {
+          // Simple string value
+          fm[key] = val.replace(/^['"]|['"]$/g, "");
+        }
+      }
+    }
+    flushList();
+
+    return {
+      frontmatter: Object.keys(fm).length > 0 ? fm : null,
+      body,
+    };
+  } catch {
+    // Parse failure — return body without frontmatter
+    return { frontmatter: null, body };
+  }
+}
+
+// ============================================================================
+// Wikilink Extraction
+// ============================================================================
+
+const WIKILINK_PATTERN = /\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g;
+
+export interface WikiLink {
+  /** Link target (file name without extension) */
+  target: string;
+  /** Optional display text (after |) */
+  displayText?: string;
+}
+
+/**
+ * Extract [[wikilinks]] from markdown text.
+ * Handles [[target]] and [[target|display text]].
+ * Does NOT handle embed syntax ![[embed]] (those are skipped).
+ */
+export function extractWikiLinks(text: string): WikiLink[] {
+  const links: WikiLink[] = [];
+  // Create a fresh regex to avoid stale lastIndex
+  const re = new RegExp(WIKILINK_PATTERN.source, WIKILINK_PATTERN.flags);
+  let match: RegExpExecArray | null;
+
+  while ((match = re.exec(text)) !== null) {
+    // Skip embed syntax: character before [[ is !
+    if (match.index > 0 && text[match.index - 1] === "!") continue;
+
+    links.push({
+      target: match[1].trim(),
+      ...(match[2] ? { displayText: match[2].trim() } : {}),
+    });
+  }
+
+  return links;
+}
+
+// ============================================================================
+// Content Hash
+// ============================================================================
+
+/** SHA-256 first 16 hex chars — compact but collision-safe for incremental sync */
+export function contentHash(text: string): string {
+  return createHash("sha256").update(text).digest("hex").slice(0, 16);
+}
+
+// ============================================================================
+// Vault Scanner
+// ============================================================================
+
+export interface ScanVaultOptions {
+  /** Scope prefix, defaults to "vault:<vault-folder-name>" */
+  scopePrefix?: string;
+  /** Directories to exclude (defaults: .obsidian, .trash, .git, node_modules) */
+  excludeDirs?: string[];
+  /** Minimum file content length to include (default: 30 chars) */
+  minContentLength?: number;
+}
+
+/**
+ * Scan an Obsidian vault and produce a ConnectorOutputV1 payload.
+ *
+ * - Recursively walks .md files (skipping excluded directories)
+ * - Parses YAML frontmatter -> tags
+ * - Extracts [[wikilinks]] -> link:<target> tags
+ * - Maps folder structure -> folder:<path> tags
+ * - Computes SHA-256 content hash for incremental sync
+ */
+export function scanVault(
+  vaultPath: string,
+  options?: ScanVaultOptions,
+): ConnectorOutputV1 {
+  const vaultName = basename(vaultPath);
+  const scopePrefix = options?.scopePrefix ?? `vault:${vaultName}`;
+  const defaultExclude = [".obsidian", ".trash", ".git", "node_modules"];
+  const excludeDirs = new Set(options?.excludeDirs ?? defaultExclude);
+  const minLen = options?.minContentLength ?? 30;
+
+  const records: ConnectorRecord[] = [];
+
+  function walk(dir: string): void {
+    let entries: ReturnType<typeof readdirSync>;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return; // Permission denied or broken symlink — skip
+    }
+
+    for (const entry of entries) {
+      if (excludeDirs.has(entry.name)) continue;
+
+      const full = join(dir, entry.name);
+
+      if (entry.isDirectory()) {
+        walk(full);
+        continue;
+      }
+
+      if (!entry.name.endsWith(".md")) continue;
+
+      let raw: string;
+      try {
+        raw = readFileSync(full, "utf-8");
+      } catch {
+        continue; // Unreadable file — skip
+      }
+
+      if (raw.trim().length < minLen) continue;
+
+      const { frontmatter, body } = parseFrontmatter(raw);
+      const wikiLinks = extractWikiLinks(body);
+      const relPath = relative(vaultPath, full);
+      const folder = dirname(relPath);
+
+      // --- Build tags ---
+      const tags: string[] = [];
+
+      // Frontmatter tags
+      if (frontmatter?.tags) {
+        const fmTags = Array.isArray(frontmatter.tags)
+          ? frontmatter.tags
+          : [String(frontmatter.tags)];
+        for (const t of fmTags) {
+          tags.push(String(t));
+        }
+      }
+
+      // Wikilink entity associations
+      for (const link of wikiLinks) {
+        tags.push(`link:${link.target}`);
+      }
+
+      // Folder path
+      if (folder !== ".") {
+        tags.push(`folder:${folder}`);
+      }
+
+      records.push({
+        id: `obsidian:${relPath}`,
+        text: body,
+        title: basename(entry.name, ".md"),
+        tags,
+        contentHash: contentHash(raw),
+        timestamp: new Date(statSync(full).mtimeMs).toISOString(),
+        sourceMetadata: {
+          vaultPath,
+          relativePath: relPath,
+          ...(frontmatter ? { frontmatter } : {}),
+          ...(wikiLinks.length > 0 ? { wikiLinks } : {}),
+        },
+      });
+    }
+  }
+
+  walk(vaultPath);
+
+  return {
+    version: "connector-v1",
+    source: "obsidian",
+    scope: scopePrefix,
+    producedAt: new Date().toISOString(),
+    records,
+  };
+}

package/src/session-schema.ts

@@ -66,9 +66,9 @@ export const ResumeContextResponseSchema = z.object({
   essentialContext: EssentialContextSchema.optional(),
   latestCheckpoint: ResumeCheckpointSummarySchema.optional(),
   /** CC-1: Hint for where to inject recalled context in the prompt. */
-  injectionHint: z.enum(["system_prompt", "user_attachment"]).default("user_attachment").optional(),
+  injectionHint: z.enum(["system_prompt", "user_attachment"]).optional().default("user_attachment"),
   /** Upstream #345: Mark recalled context as ephemeral — host should discard on compaction, not persist to transcript. */
-  ephemeral: z.boolean().default(true).optional(),
+  ephemeral: z.boolean().optional().default(true),
   responseMode: ResumeResponseModeSchema.default("default"),
   responseGuidance: optionalBoundedStringSchema(400),
   /** Constructive retrieval: LLM-synthesized reconstruction of context. */

package/src/source-heartbeat.ts

@@ -0,0 +1,108 @@
+/**
+ * GB-3: Source Heartbeat Tracking
+ *
+ * Every connector ingest writes a heartbeat record to data/source-heartbeat.json.
+ * data_checkup and doctor --ci read heartbeats to detect stale data sources.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { metaDir } from "./compat.js";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface SourceHeartbeat {
+  source: string;
+  lastIngest: string;       // ISO 8601
+  recordsIngested: number;
+  errors: string[];
+}
+
+export type HeartbeatFile = Record<string, SourceHeartbeat>;
+
+export interface StaleSource {
+  source: string;
+  lastIngest: string;
+  daysSince: number;
+}
+
+// ---------------------------------------------------------------------------
+// Path
+// ---------------------------------------------------------------------------
+
+const HEARTBEAT_PATH = resolve(metaDir(import.meta), "../data/source-heartbeat.json");
+
+/** Visible for testing — override the default path. */
+export function heartbeatPath(): string {
+  return HEARTBEAT_PATH;
+}
+
+// ---------------------------------------------------------------------------
+// Read / Write
+// ---------------------------------------------------------------------------
+
+export function readHeartbeats(path?: string): HeartbeatFile {
+  const p = path ?? HEARTBEAT_PATH;
+  if (!existsSync(p)) return {};
+  try {
+    return JSON.parse(readFileSync(p, "utf-8")) as HeartbeatFile;
+  } catch {
+    return {};
+  }
+}
+
+export function writeHeartbeat(
+  source: string,
+  recordsIngested: number,
+  errors: string[],
+  path?: string,
+): void {
+  const p = path ?? HEARTBEAT_PATH;
+  const dir = dirname(p);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
+  const existing = readHeartbeats(p);
+  existing[source] = {
+    source,
+    lastIngest: new Date().toISOString(),
+    recordsIngested,
+    errors: errors.slice(0, 10), // cap stored errors
+  };
+  writeFileSync(p, JSON.stringify(existing, null, 2) + "\n");
+}
+
+// ---------------------------------------------------------------------------
+// Staleness check
+// ---------------------------------------------------------------------------
+
+const MS_PER_DAY = 86_400_000;
+
+export function checkSourceStaleness(maxDays = 7, path?: string): StaleSource[] {
+  const heartbeats = readHeartbeats(path);
+  const now = Date.now();
+  const stale: StaleSource[] = [];
+
+  for (const hb of Object.values(heartbeats)) {
+    const lastMs = Date.parse(hb.lastIngest);
+    if (Number.isNaN(lastMs)) continue;
+    const daysSince = Math.floor((now - lastMs) / MS_PER_DAY);
+    if (daysSince > maxDays) {
+      stale.push({ source: hb.source, lastIngest: hb.lastIngest, daysSince });
+    }
+  }
+
+  return stale.sort((a, b) => b.daysSince - a.daysSince);
+}
+
+/** Human-readable age string, e.g. "2h ago", "3d ago". */
+export function formatAge(isoDate: string): string {
+  const ms = Date.now() - Date.parse(isoDate);
+  if (ms < 0) return "just now";
+  const hours = Math.floor(ms / 3_600_000);
+  if (hours < 1) return "just now";
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  return `${days}d ago`;
+}

package/.claude-plugin/CLAUDE.md

@@ -1,29 +0,0 @@
-# RecallNest Memory Plugin
-
-RecallNest is a local-first shared memory layer backed by LanceDB. It stores and recalls context across sessions, terminals, and agents (Claude Code, Codex, Gemini CLI).
-
-**Prerequisite**: Requires [Bun](https://bun.sh) runtime. On first start, dependencies install automatically.
-
-## Tool Quick Reference
-
-| When | Tool | Purpose |
-|------|------|---------|
-| Session opens, user says continue/接着/上个窗口 | `resume_context` | Load stable context, latest checkpoint, recent cases |
-| Before answering about prior work / known facts | `search_memory` | Targeted fact/pattern recall (2-3 key nouns) |
-| After solving something significant | `store_memory` or `store_case` | Persist durable knowledge |
-| Before closing a window with unfinished work | `checkpoint_session` | Save current state for next session |
-| After discovering a reusable workflow | `store_workflow_pattern` | Persist as durable pattern |
-| Memory feels stale or conflicted | `consolidate_memories` | Merge near-duplicates (dry-run by default) |
-
-## Continuity Rules
-
-- If the user says `continue`, `继续`, `接着`, `刚才`, `上个窗口`, `不要让我重复前情`, or asks where you stopped / what to do next — call `resume_context` before any Bash, Read, or repo exploration.
-- If the user starts a concrete task in an active project or asks for prior implementation detail — do lightweight RecallNest recovery before repo exploration even without an explicit `continue`.
-- Do not substitute `git status`, `git log`, or reading local docs for `resume_context`. Local inspection can validate current code state only **after** continuity has been recovered.
-- When `scope` or `sessionId` is known, pass it into recall tools instead of relying on global recall.
-- If `resume_context` returns a resolved scope or checkpoint scope, reuse that same scope in follow-up `search_memory`, `brief_memory`, `pin_memory` calls.
-- If recalled context mentions repo state (modified files, pending push), treat it as **handoff context only** — do not restate as current state without verifying in this window.
-- Before leaving a window with resumable work, call `checkpoint_session`. Do not include repo state claims unless you actually inspected the repo this window.
-- Use `store_memory` for durable profile, preference, entity, or case knowledge.
-- Use `store_workflow_pattern` for reusable multi-step workflows.
-- If the user explicitly corrects a continuity miss, fix the workflow and call `workflow_observe` with `outcome: corrected`.

package/.claude-plugin/marketplace.json

@@ -1,18 +0,0 @@
-{
-  "name": "AliceLJY",
-  "owner": {
-    "name": "Alice Jin Ye"
-  },
-  "metadata": {
-    "description": "RecallNest — shared memory layer for Claude Code, Codex, and Gemini CLI",
-    "homepage": "https://github.com/AliceLJY/recallnest"
-  },
-  "plugins": [
-    {
-      "name": "recallnest",
-      "version": "1.4.1",
-      "source": "./",
-      "description": "Local-first memory system: store, search, and recall context across sessions and terminals. Powered by LanceDB with hybrid retrieval."
-    }
-  ]
-}

package/.dockerignore

@@ -1,11 +0,0 @@
-node_modules/
-data/*
-!data/alias-map.example.json
-logs/
-.env
-.git/
-*.md
-src/__tests__/
-eval/
-integrations/
-scripts/

package/.github/workflows/ci.yml

@@ -1,28 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - run: bun install
-
-      - name: Setup config
-        run: cp config.json.example config.json
-
-      - name: Doctor (CI mode)
-        run: bun run src/cli.ts doctor --ci
-
-      - name: TypeScript check
-        run: bun build src/cli.ts --target bun --no-bundle --outdir /tmp/check 2>&1 || true

package/.mcp.json

@@ -1,9 +0,0 @@
-{
-  "mcpServers": {
-    "recallnest": {
-      "type": "stdio",
-      "command": "bash",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/start-server.sh"]
-    }
-  }
-}

package/CHANGELOG.md

@@ -1,51 +0,0 @@
-# Changelog
-
-## v1.3.1 — Upstream Sync (2026-03-12)
-
-Synced with [CortexReach/memory-lancedb-pro](https://github.com/CortexReach/memory-lancedb-pro) master (v1.1.0-beta.6+).
-
-### Changed
-
-- **Retriever**: Added `source` field to `RetrievalContext` — access reinforcement now only fires on manual retrieval, preventing auto-recall from strengthening noise memories (synced from upstream beta.2 design).
-- **Noise filter**: Added Chinese meta-question patterns (`你记得`, `记不记得`, `还记得…吗`, `上次…说`, `之前…提到`) and diagnostic artifact filter (synced from upstream beta.3).
-- **README**: Updated upstream credit link from `win4r/memory-lancedb-pro` to `CortexReach/memory-lancedb-pro`, added CortexReach team acknowledgement.
-
-## v1.2.0 — First Distributable Release (2026-03-08)
-
-The goal of this release: a new user can go from `git clone` to first search result in 15 minutes.
-
-### New
-
-- **`lm doctor`** — one-command pre-flight check for Bun, config, API key, data directory, transcript paths, and index health. Supports `--ci` mode for GitHub Actions.
-- **`lm demo`** — run sample queries to see RecallNest in action before writing your own.
-- **`config.json.example`** — ships with absolute `~/.recallnest/data/lancedb` path. New users copy this instead of editing the tracked config.
-- **GitHub Actions CI** — runs `doctor --ci` and TypeScript check on every push.
-- **Ingest pre-validation** — embedding API is tested before processing any files. Invalid Jina key now fails fast with a clear message instead of crashing mid-ingest.
-
-### Changed
-
-- **README rewritten** — added Prerequisites table (Bun + Jina key), 5-step quickstart with expected output, Troubleshooting section.
-- **Gemini support marked "coming soon"** — README, config example, and doctor all honestly reflect that Gemini CLI sessions are encrypted protobuf and not yet parseable. The `lm ingest` command prints a clear skip message instead of silently failing.
-- **Config path robustness** — default `dbPath` changed from relative `./data/lancedb` to absolute `~/.recallnest/data/lancedb` in config example. Auto-detect failure messages now include the user's actual home path.
-- **`config.json` untracked** — added to `.gitignore` so user config is not overwritten by `git pull`.
-
-### Fixed
-
-- Auto-detect hint in `doctor` now shows a real example path based on the current user's home directory.
-- `findConfigPath()` error message now suggests `cp config.json.example config.json` when the example file exists.
-
-## v1.1.0 — Hybrid Retrieval + MCP + UI (2026-02)
-
-- Hybrid retrieval: LanceDB vector + BM25 keyword search with configurable weights
-- Retrieval profiles: `default`, `writing`, `debug`, `fact-check`
-- MCP server with 9 tools: search, explain, distill, brief, pin, list assets/pins, export, stats
-- Local web workbench UI at `http://localhost:4317`
-- Multi-source ingest: Claude Code transcripts, Codex sessions, Gemini sessions, markdown notes
-- Asset system: pin, brief, export with re-indexing
-- Time-aware scoring with configurable decay
-
-## v1.0.0 — Initial Release (2026-01)
-
-- Basic vector search over Claude Code transcripts
-- LanceDB storage with Jina embeddings
-- CLI interface

package/DEMO.md

@@ -1,94 +0,0 @@
-# RecallNest 30-Second Demo
-
-Use this script when you want to explain RecallNest fast on GitHub, X, Telegram, or in a live screen recording.
-
-## Demo Goal
-
-Show three things in one pass:
-
-| What to prove | What the viewer should understand |
-|------|------|
-| Recall | old AI conversations can be found quickly |
-| Explainability | hits are not opaque |
-| Reusability | useful context can become a long-lived asset |
-
-## Fast Setup
-
-```bash
-cd /Users/anxianjingya/recallnest
-bun run src/ui-server.ts
-```
-
-Open:
-
-```text
-http://localhost:4317
-```
-
-## Recommended Demo Query
-
-Use:
-
-```text
-telegram bridge
-```
-
-Reason:
-
-| Why this query works | Result |
-|------|------|
-| already appears in the current dataset | likely to return hits immediately |
-| has operational context | good for showing explainability |
-| already has assets | good for showing reuse |
-
-## 30-Second Talk Track
-
-### Version A
-
-```text
-This is RecallNest, a local-first memory workbench for AI conversations.
-It turns Claude Code, Codex, Gemini, and notes into a recall layer.
-I can search an old topic, inspect why it matched, then pin useful context back into memory so it can be recalled again later.
-The same memory layer is exposed through MCP, so an agent can use it and I can still verify it in the UI.
-```
-
-### Version B
-
-```text
-RecallNest is not just transcript search.
-It lets me search, explain, distill, and reuse past AI conversations.
-The key idea is that useful hits do not disappear again: I can turn them into assets and feed them back into recall.
-```
-
-## Demo Click Path
-
-| Step | UI action | What to say |
-|------|------|------|
-| 1 | show the loaded `telegram bridge` query | "This starts from a real transcript topic." |
-| 2 | click `Search` | "I can recall the relevant conversation history." |
-| 3 | click `Details` on one result | "The hit is inspectable, not a black box." |
-| 4 | click `Pin` or `Brief` | "Useful context becomes a reusable asset." |
-| 5 | switch to `Assets` | "Assets stay visible and can be recalled later." |
-
-## Screenshot Rules
-
-| Rule | Why |
-|------|------|
-| keep the browser crop tight | the product, not Chrome, should dominate the frame |
-| show real hits in the result area | empty states spread poorly |
-| keep `Trace Output` collapsed unless you are explaining it | it distracts from the main product story |
-| prefer one strong screenshot over many average ones | easier to share and understand |
-
-## If The UI Opens Empty
-
-Check:
-
-1. the server is running
-2. the current dataset was ingested
-3. the page has been refreshed after startup
-
-If needed, re-run:
-
-```bash
-bun run src/ui-server.ts
-```

package/Dockerfile

@@ -1,20 +0,0 @@
-FROM oven/bun:1-alpine AS base
-WORKDIR /app
-
-# Install dependencies
-COPY package.json ./
-RUN bun install --frozen-lockfile 2>/dev/null || bun install
-
-# Copy source
-COPY src/ src/
-COPY data/alias-map.example.json data/alias-map.example.json
-
-# Default environment
-ENV RECALLNEST_API_PORT=4318
-ENV RECALLNEST_UI_PORT=4317
-
-EXPOSE 4318 4317
-
-# MCP stdio mode (default) — Glama introspection connects here
-# Override with CMD ["bun","run","src/api-server.ts"] for HTTP mode
-CMD ["bun", "run", "src/mcp-server.ts"]