Initial commit: RA-H Open Source Edition

Local-first knowledge management system with BYO API keys.

Features:
- 3-panel UI (Nodes | Focus | Helpers)
- SQLite + sqlite-vec for vector search
- Agent system (Easy/Hard mode orchestrators)
- Content extraction (YouTube, PDF, web)
- Integrate workflow for connection discovery
- Dimension system with auto-assignment

Tech stack:
- Next.js 15 + TypeScript + Tailwind CSS
- Anthropic (Claude) + OpenAI (GPT) via Vercel AI SDK

Setup:
  npm install && npm rebuild better-sqlite3
  scripts/dev/bootstrap-local.sh
  npm run dev

MIT License

app/api/nodes/[id]/chunks/route.ts

@@ -0,0 +1,35 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { chunkService } from '@/services/database';
+
+export const runtime = 'nodejs';
+
+export async function GET(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const nodeId = parseInt(id, 10);
+    
+    if (isNaN(nodeId)) {
+      return NextResponse.json({
+        success: false,
+        error: 'Invalid node ID'
+      }, { status: 400 });
+    }
+    
+    const chunks = await chunkService.getChunksByNodeId(nodeId);
+    
+    return NextResponse.json({
+      success: true,
+      chunks: chunks
+    });
+  } catch (error) {
+    console.error('Error fetching chunks:', error);
+    
+    return NextResponse.json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to fetch chunks'
+    }, { status: 500 });
+  }
+}

app/api/nodes/[id]/edges/route.ts

@@ -0,0 +1,37 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { edgeService } from '@/services/database';
+
+export const runtime = 'nodejs';
+
+export async function GET(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const nodeId = parseInt(id, 10);
+    
+    if (isNaN(nodeId)) {
+      return NextResponse.json({
+        success: false,
+        error: 'Invalid node ID'
+      }, { status: 400 });
+    }
+    
+    const connections = await edgeService.getNodeConnections(nodeId);
+    console.log('[api/nodes/[id]/edges] node', nodeId, 'returned connections:', connections.length);
+    
+    return NextResponse.json({
+      success: true,
+      data: connections,
+      count: connections.length
+    });
+  } catch (error) {
+    console.error('Error fetching node edges:', error);
+    
+    return NextResponse.json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to fetch node edges'
+    }, { status: 500 });
+  }
+}

app/api/nodes/[id]/route.ts

@@ -0,0 +1,150 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { nodeService } from '@/services/database';
+import { autoEmbedQueue } from '@/services/embedding/autoEmbedQueue';
+import { hasSufficientContent } from '@/services/embedding/constants';
+
+export const runtime = 'nodejs';
+
+export async function GET(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const nodeId = parseInt(id, 10);
+    
+    if (isNaN(nodeId)) {
+      return NextResponse.json({
+        success: false,
+        error: 'Invalid node ID'
+      }, { status: 400 });
+    }
+    
+    const node = await nodeService.getNodeById(nodeId);
+    
+    if (!node) {
+      return NextResponse.json({
+        success: false,
+        error: 'Node not found'
+      }, { status: 404 });
+    }
+    
+    return NextResponse.json({
+      success: true,
+      node: node
+    });
+  } catch (error) {
+    console.error('Error fetching node:', error);
+    
+    return NextResponse.json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to fetch node'
+    }, { status: 500 });
+  }
+}
+
+export async function PUT(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const nodeId = parseInt(id, 10);
+    
+    if (isNaN(nodeId)) {
+      return NextResponse.json({
+        success: false,
+        error: 'Invalid node ID'
+      }, { status: 400 });
+    }
+
+    const body = await request.json();
+
+    const existingNode = await nodeService.getNodeById(nodeId);
+    if (!existingNode) {
+      return NextResponse.json({
+        success: false,
+        error: 'Node not found'
+      }, { status: 404 });
+    }
+
+    if (body && Object.prototype.hasOwnProperty.call(body, 'is_pinned')) {
+      console.warn(`[nodes/${nodeId}] Ignoring legacy is_pinned payload`);
+      delete body.is_pinned;
+    }
+
+    const updates: Record<string, unknown> = { ...body };
+    let shouldQueueEmbed = false;
+
+    const incomingChunk = typeof body.chunk === 'string' ? body.chunk : undefined;
+    const incomingContent = typeof body.content === 'string' ? body.content : undefined;
+    const existingChunk = existingNode.chunk ?? '';
+
+    if (incomingChunk !== undefined) {
+      const trimmedIncoming = incomingChunk.trim();
+      const trimmedExisting = existingChunk.trim();
+
+      if (!trimmedIncoming) {
+        updates.chunk_status = null;
+      } else if (trimmedIncoming !== trimmedExisting) {
+        updates.chunk_status = 'not_chunked';
+        shouldQueueEmbed = hasSufficientContent(trimmedIncoming);
+      } else {
+        delete updates.chunk_status;
+      }
+    } else if (!existingChunk.trim() && hasSufficientContent(incomingContent)) {
+      updates.chunk = incomingContent;
+      updates.chunk_status = 'not_chunked';
+      shouldQueueEmbed = true;
+    }
+
+    const node = await nodeService.updateNode(nodeId, updates);
+
+    if (shouldQueueEmbed) {
+      autoEmbedQueue.enqueue(nodeId, { reason: 'node_updated' });
+    }
+
+    return NextResponse.json({
+      success: true,
+      node: node,
+      message: `Node updated successfully`
+    });
+  } catch (error) {
+    console.error('Error updating node:', error);
+    return NextResponse.json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to update node'
+    }, { status: 500 });
+  }
+}
+
+export async function DELETE(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const nodeId = parseInt(id, 10);
+    
+    if (isNaN(nodeId)) {
+      return NextResponse.json({
+        success: false,
+        error: 'Invalid node ID'
+      }, { status: 400 });
+    }
+
+    await nodeService.deleteNode(nodeId);
+
+    return NextResponse.json({
+      success: true,
+      message: `Node ${nodeId} deleted successfully`
+    });
+  } catch (error) {
+    console.error('Error deleting node:', error);
+    
+    return NextResponse.json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to delete node'
+    }, { status: 500 });
+  }
+}