feat(storage): Adds the complete storage layer for the Smart Notes vault system.

apps/storage/.gitignore

@@ -0,0 +1,38 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+*.log
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store
+
+# Test vaults created by demo.ts / test runs
+test-vault/
+demo-vault/

apps/storage/README.md

@@ -0,0 +1,45 @@
+# Smart Notes Storage
+
+What it does — in plain terms
+Vault (the notes folder)
+Open any folder as a vault
+Re-opening the same folder is safe — nothing breaks or duplicates
+Works even if you already have existing .md files in the folder
+Notes
+Create a note — writes a .md file, saves metadata to DB
+Read a note — gives you the content + title + tags
+Update a note — saves new content, keeps frontmatter intact
+Rename a note — renames the file, updates the title inside the file
+Move a note to a different folder
+Delete a note — moves to trash by default, or permanent delete
+Trash
+Deleted notes go to a .trash folder, not permanently gone
+List everything in the trash
+Restore a trashed note back to its original location
+Folders
+Create a folder (with optional icon and pin-to-top)
+Rename a folder — all notes inside automatically get their paths updated
+Delete a folder — safely trashes all notes inside first
+Tags
+Attach tags to a note when creating or updating
+Tags stored in both the DB and the .md file frontmatter
+Filter notes by tag
+List all tags in the vault with usage counts
+Search
+Search notes by title
+Sorting & Pagination
+List notes sorted by last updated, created date, or name
+Limit results per page (useful for sidebars with many notes)
+Conflict Detection
+If a note was edited by another app (e.g. VS Code) while you had it open, it won't silently overwrite — saves a conflict copy and alerts you
+File Watcher
+Detects when any .md file is added, changed, or deleted outside your app
+DB automatically stays in sync even if the user edits notes in another editor
+Events
+Every action fires an event (noteCreated, noteUpdated, noteDeleted, noteRenamed, noteMoved, folderCreated, folderRenamed, folderDeleted, conflictDetected)
+Your UI just listens and reacts — no polling needed
+RAG / AI pipeline bridge
+Tells the RAG pipeline which notes need to be embedded (new, changed, or previously failed)
+Tells the RAG pipeline which notes changed since a specific time (for incremental updates)
+Lets the RAG pipeline report back when it finishes indexing a note
+Bulk-read all notes with content in one call for initial indexing

apps/storage/index.ts

@@ -0,0 +1 @@
+export * from "./src/index"

apps/storage/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "storage",
+  "module": "index.ts",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "demo": "bun run demo.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.6.2",
+    "chokidar": "^5.0.0",
+    "eventemitter3": "^5.0.4",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.0",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/bun": "latest",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.3.3",
+    "@types/uuid": "^11.0.0",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}