docs: add VitePress documentation site

- 22 content pages across Guide, Concepts, and Reference sections - Custom indigo/cyan theme with Lucide icons and Mermaid diagrams - GitHub Actions workflow for GitHub Pages deployment - Live preview: https://mempalace-docs.netlify.app/
2026-04-09 19:11:23 -03:00
parent 2981433535
commit dfb22f5345
37 changed files with 3673 additions and 0 deletions
@@ -0,0 +1,134 @@
+# Mining Your Data
+
+MemPalace ingests your data by **mining** — scanning files and filing their content as verbatim drawers in the palace.
+
+## Mining Modes
+
+### Projects Mode (default)
+
+Scans code, docs, and notes. Respects `.gitignore` by default.
+
+```bash
+mempalace mine ~/projects/myapp
+```
+
+Each file becomes a drawer, tagged with a wing (project name) and room (topic). Rooms are auto-detected from your folder structure during `mempalace init`.
+
+Options:
+```bash
+# Override wing name
+mempalace mine ~/projects/myapp --wing myapp
+
+# Ignore .gitignore rules
+mempalace mine ~/projects/myapp --no-gitignore
+
+# Include specific ignored paths
+mempalace mine ~/projects/myapp --include-ignored dist,build
+
+# Limit number of files
+mempalace mine ~/projects/myapp --limit 100
+
+# Preview without filing
+mempalace mine ~/projects/myapp --dry-run
+```
+
+### Conversations Mode
+
+Indexes conversation exports from Claude, ChatGPT, Slack, and other tools. Chunks by exchange pair (human + assistant turns).
+
+```bash
+mempalace mine ~/chats/ --mode convos
+```
+
+Supports five chat formats automatically:
+- Claude JSON exports
+- ChatGPT exports
+- Slack exports
+- Markdown conversations
+- Plain text transcripts
+
+### General Extraction
+
+Auto-classifies conversation content into five memory types:
+
+```bash
+mempalace mine ~/chats/ --mode convos --extract general
+```
+
+Memory types:
+- **Decisions** — choices made, options rejected
+- **Preferences** — habits, likes, opinions
+- **Milestones** — sessions completed, goals reached
+- **Problems** — bugs, blockers, issues encountered
+- **Emotional context** — reactions, concerns, excitement
+
+## Splitting Mega-Files
+
+Some transcript exports concatenate multiple sessions into one huge file. Split them first:
+
+```bash
+# Preview what would be split
+mempalace split ~/chats/ --dry-run
+
+# Split files with 2+ sessions (default)
+mempalace split ~/chats/
+
+# Only split files with 3+ sessions
+mempalace split ~/chats/ --min-sessions 3
+
+# Output to a different directory
+mempalace split ~/chats/ --output-dir ~/chats-split/
+```
+
+::: tip
+Always run `mempalace split` before mining conversation files. It's a no-op if files don't need splitting.
+:::
+
+## Multi-Project Setup
+
+Mine each project into its own wing:
+
+```bash
+mempalace mine ~/chats/orion/  --mode convos --wing orion
+mempalace mine ~/chats/nova/   --mode convos --wing nova
+mempalace mine ~/chats/helios/ --mode convos --wing helios
+```
+
+Six months later:
+```bash
+# Project-specific search
+mempalace search "database decision" --wing orion
+
+# Cross-project search
+mempalace search "rate limiting approach"
+# → finds your approach in Orion AND Nova, shows the differences
+```
+
+## Team Usage
+
+Mine Slack exports and AI conversations for team history:
+
+```bash
+mempalace mine ~/exports/slack/ --mode convos --wing driftwood
+mempalace mine ~/.claude/projects/ --mode convos
+```
+
+Then search across people and projects:
+```bash
+mempalace search "Soren sprint" --wing driftwood
+# → 14 closets: OAuth refactor, dark mode, component library migration
+```
+
+## Agent Tag
+
+Every drawer is tagged with the agent that filed it:
+
+```bash
+# Default agent name
+mempalace mine ~/data/ --agent mempalace
+
+# Custom agent name
+mempalace mine ~/data/ --agent reviewer
+```
+
+This is used by [Specialist Agents](/concepts/agents) to partition memories.