@hiai-gg/hiai-docs 0.0.1

package/frontend/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "moduleResolution": "bundler",
+    "types": ["bun"]
+  }
+}

package/frontend/vite.config.ts

@@ -0,0 +1,25 @@
+import { paraglideVitePlugin } from "@inlang/paraglide-js";
+import { sveltekit } from "@sveltejs/kit/vite";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [
+    tailwindcss(),
+    paraglideVitePlugin({
+      project: "./project.inlang",
+      outdir: "./src/lib/paraglide",
+      strategy: ["url", "cookie", "baseLocale"],
+    }),
+    sveltekit(),
+  ],
+  server: {
+    port: 50701,
+    host: true,
+    // strictPort: vite's default silently picks the next free port,
+    // which would leave http://localhost:50701 serving the stale
+    // build (held by a previous container) while the new server
+    // runs on 5173. Fail loudly instead.
+    strictPort: true,
+  },
+});

package/init.sql

@@ -0,0 +1,9 @@
+-- hiai-docs init.sql
+-- Runs on first PostgreSQL startup via docker-entrypoint-initdb.d.
+-- Schema, indexes, and FKs live in packages/db/src/schema.ts (Drizzle).
+
+CREATE EXTENSION IF NOT EXISTS vector;
+CREATE EXTENSION IF NOT EXISTS pg_trgm;
+
+GRANT ALL PRIVILEGES ON DATABASE hiai_docs TO aiuser;
+GRANT ALL PRIVILEGES ON SCHEMA public TO aiuser;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hiai-gg/hiai-docs",
+  "version": "0.0.1",
+  "type": "module",
+  "license": "MIT",
+  "description": "The lightweight, AI-native self-hosted knowledge base — built-in RAG, hybrid semantic search, and a clean REST API for AI agents.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hiai-gg/hiai-docs.git"
+  },
+  "homepage": "https://github.com/hiai-gg/hiai-docs#readme",
+  "bugs": {
+    "url": "https://github.com/hiai-gg/hiai-docs/issues"
+  },
+  "keywords": [
+    "knowledge-base",
+    "ai-native",
+    "wiki",
+    "markdown",
+    "ai-embeddings",
+    "rag",
+    "semantic-search",
+    "self-hosted",
+    "pgvector",
+    "ollama",
+    "local-llm",
+    "outline-alternative",
+    "docmost-alternative"
+  ],
+  "engines": {
+    "bun": ">= 1.3.14"
+  },
+  "scripts": {
+    "dev": "docker compose up -d",
+    "build": "docker compose build",
+    "start": "docker compose up -d",
+    "stop": "docker compose down"
+  }
+}

package/package.public.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hiai-gg/hiai-docs",
+  "version": "0.0.1",
+  "type": "module",
+  "license": "MIT",
+  "description": "The lightweight, AI-native self-hosted knowledge base — built-in RAG, hybrid semantic search, and a clean REST API for AI agents.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hiai-gg/hiai-docs.git"
+  },
+  "homepage": "https://github.com/hiai-gg/hiai-docs#readme",
+  "bugs": {
+    "url": "https://github.com/hiai-gg/hiai-docs/issues"
+  },
+  "keywords": [
+    "knowledge-base",
+    "ai-native",
+    "wiki",
+    "markdown",
+    "ai-embeddings",
+    "rag",
+    "semantic-search",
+    "self-hosted",
+    "pgvector",
+    "ollama",
+    "local-llm",
+    "outline-alternative",
+    "docmost-alternative"
+  ],
+  "engines": {
+    "bun": ">= 1.3.14"
+  },
+  "scripts": {
+    "dev": "docker compose up -d",
+    "build": "docker compose build",
+    "start": "docker compose up -d",
+    "stop": "docker compose down"
+  }
+}

package/packages/db/drizzle.config.ts

@@ -0,0 +1,10 @@
+import type { Config } from "drizzle-kit";
+
+export default {
+  out: "./src/migrations",
+  schema: "./src/schema.ts",
+  dialect: "postgresql",
+  dbCredentials: {
+    url: process.env.DATABASE_URL || "postgresql://aiuser:aipassword@localhost:5433/hiai_docs",
+  },
+} satisfies Config;

package/packages/db/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@hiai-docs/db",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "license": "MIT",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./schema": "./src/schema.ts"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.45.2",
+    "postgres": "^3.4.9",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "drizzle-kit": "^0.31.10",
+    "typescript": "^5.8.0"
+  }
+}

package/packages/db/src/client.ts

@@ -0,0 +1,9 @@
+import { drizzle } from "drizzle-orm/postgres-js";
+import postgres from "postgres";
+import * as schema from "./schema";
+
+const databaseUrl =
+  process.env.DATABASE_URL || "postgresql://aiuser:aipassword@localhost:5433/hiai_docs";
+
+const client = postgres(databaseUrl, { max: 20, idle_timeout: 30, connect_timeout: 10 });
+export const db = drizzle(client, { schema });

package/packages/db/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./schema";
+export { db } from "./client";

package/packages/db/src/migrations/0000_nice_bedlam.sql

@@ -0,0 +1,165 @@
+CREATE TABLE "accounts" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" uuid NOT NULL,
+	"account_id" text NOT NULL,
+	"provider_id" text NOT NULL,
+	"access_token" text,
+	"refresh_token" text,
+	"access_token_expires_at" timestamp,
+	"refresh_token_expires_at" timestamp,
+	"scope" text,
+	"password" text,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "attachments" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"document_id" uuid NOT NULL,
+	"filename" text NOT NULL,
+	"mime_type" text NOT NULL,
+	"size" bigint NOT NULL,
+	"minio_key" text NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "document_embeddings" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"document_id" uuid NOT NULL,
+	"chunk_index" bigint NOT NULL,
+	"chunk_text" text NOT NULL,
+	"embedding" vector(1024),
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "document_tags" (
+	"document_id" uuid NOT NULL,
+	"tag_id" uuid NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "documents" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"owner_id" uuid NOT NULL,
+	"folder_id" uuid,
+	"title" text DEFAULT 'Untitled' NOT NULL,
+	"content" text DEFAULT '',
+	"content_tipex" jsonb,
+	"metadata" jsonb,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "folders" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"owner_id" uuid NOT NULL,
+	"parent_id" uuid,
+	"name" text NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "guest_access" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"share_link_id" uuid NOT NULL,
+	"guest_email" text NOT NULL,
+	"granted_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "sessions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" uuid NOT NULL,
+	"token" text NOT NULL,
+	"expires_at" timestamp NOT NULL,
+	"ip_address" text,
+	"user_agent" text,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL,
+	CONSTRAINT "sessions_token_unique" UNIQUE("token")
+);
+--> statement-breakpoint
+CREATE TABLE "share_links" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"document_id" uuid,
+	"folder_id" uuid,
+	"token" text NOT NULL,
+	"password_hash" text,
+	"expires_at" timestamp,
+	"created_by" uuid NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	CONSTRAINT "share_links_token_unique" UNIQUE("token")
+);
+--> statement-breakpoint
+CREATE TABLE "tags" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"owner_id" uuid NOT NULL,
+	"name" text NOT NULL,
+	"color" text,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "users" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"email" text NOT NULL,
+	"name" text,
+	"email_verified" boolean DEFAULT false,
+	"image" text,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL,
+	CONSTRAINT "users_email_unique" UNIQUE("email")
+);
+--> statement-breakpoint
+CREATE TABLE "verifications" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"identifier" text NOT NULL,
+	"value" text NOT NULL,
+	"expires_at" timestamp NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "versions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"document_id" uuid NOT NULL,
+	"content" text NOT NULL,
+	"content_tipex" jsonb,
+	"created_by" uuid NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "accounts" ADD CONSTRAINT "accounts_user_id_users_id_fk" FOREIGN KEY ("user_id") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "attachments" ADD CONSTRAINT "attachments_document_id_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "document_embeddings" ADD CONSTRAINT "document_embeddings_document_id_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "document_tags" ADD CONSTRAINT "document_tags_document_id_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "document_tags" ADD CONSTRAINT "document_tags_tag_id_tags_id_fk" FOREIGN KEY ("tag_id") REFERENCES "public"."tags"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "documents" ADD CONSTRAINT "documents_owner_id_users_id_fk" FOREIGN KEY ("owner_id") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "documents" ADD CONSTRAINT "documents_folder_id_folders_id_fk" FOREIGN KEY ("folder_id") REFERENCES "public"."folders"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "folders" ADD CONSTRAINT "folders_owner_id_users_id_fk" FOREIGN KEY ("owner_id") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "guest_access" ADD CONSTRAINT "guest_access_share_link_id_share_links_id_fk" FOREIGN KEY ("share_link_id") REFERENCES "public"."share_links"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "sessions" ADD CONSTRAINT "sessions_user_id_users_id_fk" FOREIGN KEY ("user_id") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "share_links" ADD CONSTRAINT "share_links_document_id_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "share_links" ADD CONSTRAINT "share_links_folder_id_folders_id_fk" FOREIGN KEY ("folder_id") REFERENCES "public"."folders"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "share_links" ADD CONSTRAINT "share_links_created_by_users_id_fk" FOREIGN KEY ("created_by") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "tags" ADD CONSTRAINT "tags_owner_id_users_id_fk" FOREIGN KEY ("owner_id") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "versions" ADD CONSTRAINT "versions_document_id_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "versions" ADD CONSTRAINT "versions_created_by_users_id_fk" FOREIGN KEY ("created_by") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "accounts_user_id_idx" ON "accounts" USING btree ("user_id");--> statement-breakpoint
+CREATE UNIQUE INDEX "accounts_provider_account_idx" ON "accounts" USING btree ("provider_id","account_id");--> statement-breakpoint
+CREATE INDEX "attachments_document_id_idx" ON "attachments" USING btree ("document_id");--> statement-breakpoint
+CREATE INDEX "document_embeddings_doc_id_idx" ON "document_embeddings" USING btree ("document_id");--> statement-breakpoint
+CREATE UNIQUE INDEX "document_embeddings_doc_chunk_idx" ON "document_embeddings" USING btree ("document_id","chunk_index");--> statement-breakpoint
+CREATE UNIQUE INDEX "document_tags_unique_idx" ON "document_tags" USING btree ("document_id","tag_id");--> statement-breakpoint
+CREATE INDEX "documents_owner_id_idx" ON "documents" USING btree ("owner_id");--> statement-breakpoint
+CREATE INDEX "documents_folder_id_idx" ON "documents" USING btree ("folder_id");--> statement-breakpoint
+CREATE INDEX "documents_created_at_idx" ON "documents" USING btree ("created_at");--> statement-breakpoint
+CREATE INDEX "folders_owner_id_idx" ON "folders" USING btree ("owner_id");--> statement-breakpoint
+CREATE INDEX "folders_parent_id_idx" ON "folders" USING btree ("parent_id");--> statement-breakpoint
+CREATE INDEX "guest_access_share_link_idx" ON "guest_access" USING btree ("share_link_id");--> statement-breakpoint
+CREATE INDEX "sessions_user_id_idx" ON "sessions" USING btree ("user_id");--> statement-breakpoint
+CREATE INDEX "share_links_token_idx" ON "share_links" USING btree ("token");--> statement-breakpoint
+CREATE INDEX "share_links_document_id_idx" ON "share_links" USING btree ("document_id");--> statement-breakpoint
+CREATE INDEX "share_links_folder_id_idx" ON "share_links" USING btree ("folder_id");--> statement-breakpoint
+CREATE INDEX "tags_owner_id_idx" ON "tags" USING btree ("owner_id");--> statement-breakpoint
+CREATE UNIQUE INDEX "tags_owner_name_idx" ON "tags" USING btree ("owner_id","name");--> statement-breakpoint
+CREATE INDEX "verifications_identifier_idx" ON "verifications" USING btree ("identifier");--> statement-breakpoint
+CREATE INDEX "versions_document_id_idx" ON "versions" USING btree ("document_id");--> statement-breakpoint
+CREATE INDEX "versions_created_at_idx" ON "versions" USING btree ("created_at");

package/packages/db/src/migrations/0001_w2_3_test.sql

@@ -0,0 +1,5 @@
+ALTER TABLE "documents" ADD COLUMN "search_vector" "tsvector" GENERATED ALWAYS AS (to_tsvector('english', COALESCE(title, '') || ' ' || COALESCE(content, ''))) STORED;--> statement-breakpoint
+ALTER TABLE "folders" ADD CONSTRAINT "folders_parent_id_folders_id_fk" FOREIGN KEY ("parent_id") REFERENCES "public"."folders"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "idx_document_embeddings_hnsw" ON "document_embeddings" USING hnsw ("embedding" vector_cosine_ops);--> statement-breakpoint
+CREATE INDEX "idx_documents_search_vector" ON "documents" USING gin ("search_vector");--> statement-breakpoint
+CREATE INDEX "idx_documents_title_trgm" ON "documents" USING gin ("title" gin_trgm_ops);

package/packages/db/src/migrations/0002_rename_content_json.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "documents" RENAME COLUMN "content_tipex" TO "content_json";--> statement-breakpoint
+ALTER TABLE "versions" RENAME COLUMN "content_tipex" TO "content_json";