Release 1.0.0

.dockerignore

@@ -0,0 +1,13 @@
+node_modules
+**/node_modules
+.next
+**/.next
+dist
+**/dist
+.git
+.env
+.env.local
+coverage
+.vscode
+.idea
+*.log

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.env.example

@@ -0,0 +1,30 @@
+# ---- Postgres ----
+POSTGRES_USER=rag
+POSTGRES_PASSWORD=rag
+POSTGRES_DB=rag
+POSTGRES_PORT=5432
+DATABASE_URL=postgres://rag:rag@localhost:5432/rag
+
+# ---- Ollama ----
+# Base URL for the Ollama HTTP API. Examples:
+#   - LAN host:    http://192.168.4.90:11434
+#   - Same host:   http://localhost:11434
+#   - Docker host (web container reaching host Ollama on macOS/Windows):
+#                  http://host.docker.internal:11434
+# The /api suffix is appended automatically.
+OLLAMA_BASE_URL=http://192.168.4.90:11434
+# Chat / generation model (must be pulled on the Ollama host).
+OLLAMA_CHAT_MODEL=llama3.1:8b
+# Embedding model (must be pulled on the Ollama host).
+OLLAMA_EMBED_MODEL=nomic-embed-text
+# Embedding dimension must match the model (nomic-embed-text = 768).
+EMBEDDING_DIM=768
+
+# ---- App ----
+NODE_ENV=development
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+# ---- RAG tuning ----
+RAG_CHUNK_SIZE=800
+RAG_CHUNK_OVERLAP=120
+RAG_TOP_K=6

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Report a defect or unexpected behavior
+title: "bug: "
+labels: bug
+---
+
+## What happened
+
+## What you expected
+
+## Steps to reproduce
+1.
+2.
+3.
+
+## Environment
+- OS:
+- Node:
+- pnpm:
+- Docker:
+
+## Logs / screenshots

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature request
+about: Suggest a new capability or improvement
+title: "feat: "
+labels: enhancement
+---
+
+## Problem / motivation
+
+## Proposed solution
+
+## Alternatives considered
+
+## Additional context

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## Summary
+<!-- 1-3 bullets on what changed and why -->
+
+## Related
+<!-- issue / spec link -->
+
+## Type
+- [ ] feat
+- [ ] fix
+- [ ] refactor
+- [ ] docs
+- [ ] chore / ci / build
+
+## Checklist
+- [ ] Branched from `develop` (or `main` for hotfix)
+- [ ] `pnpm typecheck` passes
+- [ ] `pnpm lint` passes
+- [ ] `pnpm test` passes (or N/A)
+- [ ] Updated `spec/` docs if behavior changed
+- [ ] Added migration if schema changed
+- [ ] Manual smoke test:
+
+## Screenshots / logs
+<!-- optional -->

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install
+        run: pnpm install --frozen-lockfile=false
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+      - name: Build
+        run: pnpm build

.gitignore

@@ -0,0 +1,43 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build output
+dist/
+build/
+.next/
+out/
+*.tsbuildinfo
+
+# Environment
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+
+# Test / coverage
+coverage/
+.nyc_output/
+
+# Drizzle
+drizzle/meta/_journal.json.bak
+
+# Docker volumes (when bind-mounted locally)
+.data/
+volumes/
+
+# Misc
+*.pid
+.turbo/

.prettierignore

@@ -0,0 +1,7 @@
+node_modules
+dist
+build
+.next
+coverage
+pnpm-lock.yaml
+*.tsbuildinfo

.prettierrc.json

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2
+}