chore: cleanup after code review

- Remove dead d1.ts and vectorize.ts files
- Remove stale D1 scripts from package.json
- Remove unused getChunkIdsByDocument from neon.ts
- Fix unsafe JSON.parse in query citation handler
- Update brand.md stack references to PostgreSQL+pgvector
- Add INGEST_SERVICE_URL to .env.example
- Move sample questions to persistent strip above chat input

Author: caio-pizzol

rag/.env.example

@@ -5,5 +5,6 @@ DATABASE_URL=postgresql://...
 OPENAI_API_KEY=sk-...
 ANTHROPIC_API_KEY=sk-ant-...
 
-# Local dev URLs
+# Ingest service
+INGEST_SERVICE_URL=http://localhost:4000
 API_URL=http://localhost:8787

rag/apps/api/package.json

@@ -5,8 +5,7 @@
 	"scripts": {
 		"dev": "wrangler dev",
 		"deploy": "wrangler deploy",
-		"db:create": "wrangler d1 create docrag",
-		"db:migrate": "wrangler d1 execute docrag --file=schema.sql"
+		"db:migrate": "psql $DATABASE_URL -f schema.sql"
 	},
 	"dependencies": {
 		"@anthropic-ai/sdk": "^0.30.0",

rag/apps/api/src/cf/d1.ts

@@ -130,12 +130,6 @@ export function createNeonClient(databaseUrl: string) {
 			return Number(rows[0].count);
 		},
 
-		async getChunkIdsByDocument(documentId: number): Promise<string[]> {
-			const rows =
-				await sql`SELECT id FROM chunks WHERE document_id = ${documentId}`;
-			return rows.map((r: any) => r.id);
-		},
-
 		async deleteDocument(id: number): Promise<void> {
 			await sql`DELETE FROM documents WHERE id = ${id}`;
 		},

rag/apps/api/src/cf/neon.ts

@@ -320,7 +320,11 @@ async function handleQuery(request: Request, env: Env): Promise<Response> {
 		if (seen.has(targetId)) continue;
 		const chunk = chunks.find((c) => c.targetId === targetId);
 		if (!chunk) continue;
-		const meta = chunk.metadata ? JSON.parse(chunk.metadata) : {};
+		let meta: Record<string, unknown> = {};
+		try {
+			if (chunk.metadata) meta = JSON.parse(chunk.metadata);
+		} catch {}
+
 		const citation = {
 			index: citations.length + 1,
 			blockId: chunk.blockId,

rag/apps/api/src/cf/vectorize.ts

@@ -3,30 +3,30 @@ WORKDIR /app
 
 # Install deps (paths relative to repo root — Docker remote build uses repo root as context)
 COPY rag/package.json rag/bun.lock* ./
-COPY rag/apps/ingest-service/package.json apps/ingest-service/
+COPY rag/apps/ingest/package.json apps/ingest/
 COPY rag/packages/shared/package.json packages/shared/
 RUN bun install --ignore-scripts
 
 # Copy source
 COPY rag/packages/shared/ packages/shared/
-COPY rag/apps/ingest-service/ apps/ingest-service/
+COPY rag/apps/ingest/ apps/ingest/
 COPY rag/tsconfig.json .
 
 # Production stage
 FROM oven/bun:1-slim
 WORKDIR /app
 
 COPY rag/package.json rag/bun.lock* ./
-COPY rag/apps/ingest-service/package.json apps/ingest-service/
+COPY rag/apps/ingest/package.json apps/ingest/
 COPY rag/packages/shared/package.json packages/shared/
 RUN bun install --ignore-scripts
 
 COPY --from=build /app/packages/shared packages/shared
-COPY --from=build /app/apps/ingest-service apps/ingest-service
+COPY --from=build /app/apps/ingest apps/ingest
 COPY rag/tsconfig.json .
 
 EXPOSE 4000
 HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
   CMD bun -e "fetch('http://localhost:4000/health').then(r=>{if(!r.ok)process.exit(1)})"
 
-CMD ["bun", "run", "apps/ingest-service/index.ts"]
+CMD ["bun", "run", "apps/ingest/index.ts"]

rag/apps/api/src/worker.ts

@@ -2,7 +2,7 @@ services:
   ingest:
     build:
       context: ../../..
-      dockerfile: rag/apps/ingest-service/Dockerfile
+      dockerfile: rag/apps/ingest/Dockerfile
     ports:
       - "4000:4000"
     environment:

rag/apps/ingest-service/Dockerfile rag/apps/ingest/Dockerfilerag/apps/ingest-service/Dockerfile renamed to rag/apps/ingest/Dockerfile

@@ -1,5 +1,5 @@
 {
-	"name": "@docrag/ingest-service",
+	"name": "@docrag/ingest",
 	"private": true,
 	"type": "module",
 	"scripts": {