vault-architecture-v1

apps/demo-mcp/README.md

@@ -12,6 +12,52 @@ bun run apps/demo-mcp/src/cli.ts import reddit --file ./export_username_date.zip
 
 This creates a SQLite database at `.data/reddit.db` with your Reddit posts, comments, and other data.
 
+## Plaintext export/import (Markdown)
+
+Export database rows to deterministic plaintext files under `vault/<adapter>/...` using Markdown (with frontmatter):
+
+```bash
+bun run apps/demo-mcp/src/cli.ts export-fs reddit --db ./.data/reddit.db --repo .
+```
+
+Import files from the repo back into the database:
+
+```bash
+bun run apps/demo-mcp/src/cli.ts import-fs reddit --db ./.data/reddit.db --repo .
+```
+
+Notes:
+
+- Files are Markdown only, written under `vault/<adapter>/<table>/<pk...>.md`.
+
+## Try it
+
+1) Import your Reddit export into a local DB
+
+```bash
+bun run apps/demo-mcp/src/cli.ts import reddit --file ./export_username_date.zip --db ./.data/reddit.db
+```
+
+2) Export DB rows to Markdown files in your repo
+
+```bash
+bun run apps/demo-mcp/src/cli.ts export-fs reddit --db ./.data/reddit.db --repo .
+```
+
+You should see Markdown files under `vault/reddit/<table>/...`. To re-import from files into the DB:
+
+```bash
+bun run apps/demo-mcp/src/cli.ts import-fs reddit --db ./.data/reddit.db --repo .
+```
+
+### CLI usage
+
+```bash
+bun run apps/demo-mcp/src/cli.ts --help
+# or
+bun run apps/demo-mcp/src/cli.ts help
+```
+
 ## MCP Integration with Claude Code
 
 Once you have imported your data, you can connect the database to Claude Code for natural language querying.

apps/demo-mcp/package.json

@@ -5,13 +5,16 @@
 	"type": "module",
 	"description": "Minimal CLI to import Reddit export ZIP into a local LibSQL DB using the Reddit adapter",
 	"scripts": {
-		"dev": "bun run src/cli.ts import",
-		"import": "bun run src/cli.ts import",
-		"serve": "bun run src/cli.ts serve",
-		"check": "tsc --noEmit"
+		"dev": "bun run src/cli.ts import reddit",
+		"import": "bun run src/cli.ts import reddit",
+		"export-fs": "bun run src/cli.ts export-fs reddit",
+		"import-fs": "bun run src/cli.ts import-fs reddit",
+		"sync": "bun run src/cli.ts sync reddit",
+		"serve": "bun run src/cli.ts serve"
 	},
 	"dependencies": {
 		"@libsql/client": "^0.11.0",
+		"@repo/vault-core": "workspace:*",
 		"drizzle-orm": "catalog:"
 	}
 }