Compare commits

..

2 Commits

Author SHA1 Message Date
Ben f1bfcd32eb foam_sync.sh (lifebalance) 2026-10-11T21:14:01Z 2026-10-11 21:14:01 -06:00
Ben 5984f323a6 chore: execute stage 1 vault migration to hybrid architecture 2026-09-07 13:45:31 -06:00
38 changed files with 112 additions and 5 deletions
+36
View File
@@ -0,0 +1,36 @@
# .wikiignore - Privacy Denylist for LLM & Web Processing
# Paths and patterns listed here will NEVER be sent to remote LLM services
# or uploaded to online extraction tools.
# Secrets and Credentials
.env*
*secret*
*credential*
*.key
*.pem
# Configuration and Workspace
.vscode/
*.code-workspace
.git/
.foam/
# Operational / Log data
.logs/
system/runs/
system/migration/
# Raw binaries not meant for text extraction
assets/
attachments/
*.jpg
*.png
*.jpeg
*.gif
*.webp
*.mp4
*.mp3
*.wav
# Specific private notes (Add as needed)
finance.md
View File
View File
View File
View File
+1 -1
View File
@@ -10,7 +10,7 @@
## Projects ## Projects
* [[self-hosting AI on lifebalance]] * [[self-hosting_AI]]
## LocalAI Packaged ## LocalAI Packaged
@@ -78,4 +78,4 @@ chezmoi init https://github.com/username/dotfiles.git
## Related ## Related
- [[homelab]] - [[homelab]]
- [[dev environments]] - [[dev_environments]]
@@ -67,8 +67,8 @@
* 62 GiB RAM * 62 GiB RAM
* NVIDIA GeForce RTX 4090 (24 GiB VRAM) * NVIDIA GeForce RTX 4090 (24 GiB VRAM)
* Debian GNU/Linux forky/sid * Debian GNU/Linux forky/sid
* [[self-hosting AI on lifebalance]] * [[self-hosting_AI]]
* [[rclone google drive]] * [[rclone_google_drive]]
* proxmox1 * proxmox1
* Beelink Mini PC EQi12, Intel Core 1220P(Max 4.4GHz 10C/12T), 16GB DDR4 500GB PCle4.0 SSD Mini Computers,Dual LAN/Wifi6/BT5.2,Dual 4K Display,Built-in Power Supply Office PC * Beelink Mini PC EQi12, Intel Core 1220P(Max 4.4GHz 10C/12T), 16GB DDR4 500GB PCle4.0 SSD Mini Computers,Dual LAN/Wifi6/BT5.2,Dual 4K Display,Built-in Power Supply Office PC
* proxmox2 * proxmox2
+49
View File
@@ -0,0 +1,49 @@
# Homefoam Wiki Architecture & Automation Rules
This vault is a shared cognitive workspace for both human and agent. It is maintained by background LLM orchestration and semantic indexing, utilizing the QMD search engine.
## 1. Vault Organization
The vault uses a hybrid hierarchy. Do not create folders with numeric prefixes if they don't already exist unless listed below.
- `00-inbox/` - Unprocessed human notes.
- `00-inbox/agent/` - Raw, timestamped agent insights (memory store).
- `01-journal/` - Daily notes and chronologies.
- `02-projects/` - Active projects.
- `03-areas/` - Life and maintenance areas.
- `04-knowledge/topics/` - Canonical topic pages.
- `04-knowledge/entities/` - Canonical entity pages (people, organizations, etc).
- `04-knowledge/synthesis/` - Cross-topic conclusions and multi-source answers.
- `04-knowledge/hypotheses/` - Speculative connections generated by the Dreaming Cycle.
- `05-sources/` - External ingested materials, packaged as `sources/<slug>-<hash>/`.
- `system/` - System records, rules (this file), claim ledgers, and run logs.
## 2. Memory & Cognitive Cycles
- **Store**: Agents must write new insights as timestamped markdown files in `00-inbox/agent/`. Do not bypass the inbox to write unstructured facts directly into canonical pages.
- **Recall/Reflect**: Use standard file reads and QMD CLI/MCP tools.
- **Distillation Cycle (Nightly 03:30)**:
1. Process `00-inbox/` (human and agent) into formal claims.
2. Compact and deduplicate the existing claim graph.
3. Re-evaluate dependent claims for modified sources.
- **Dreaming Cycle (Weekly)**: Traverse the QMD graph, synthesize non-obvious connections, and write speculative notes to `04-knowledge/hypotheses/`.
## 3. Evidence & Formal Claims
- **Location**: Per-page Markdown sidecars in `system/claims/`.
- **Identity**: Globally stable, opaque IDs (e.g., `clm-a1b2c3`).
- **Locators**: Exact locators (headings, line numbers, timestamps) are required.
- **Authored Notes**: For notes the human authors directly, cite the Git path and baseline commit (e.g., `path/to/note.md@commit`). Do not duplicate human notes into `05-sources/`.
- **Status Lifecycle**: `supported`, `inferred`, `conflicted`, `superseded`, `retracted`.
- **Confidence**: `high`, `medium`, `low`.
- **Contradictions**: Preserved as `conflicted`; the agent must not silently force a winner.
## 4. Editing Rules & Automation Guardrails
- **Privacy (.wikiignore)**: Paths in `.wikiignore` are strictly excluded from remote LLM/web processing.
- **Protected Markers**:
- `<!-- wiki:private:start -->` ... `<!-- wiki:private:end -->` : Content inside is never sent to the LLM or indexed.
- `<!-- wiki:protected:start -->` ... `<!-- wiki:protected:end -->` : Content inside may be read/indexed, but the agent must never rewrite it.
- **Rewrite Authority**: The agent may freely rewrite semantic content in eligible Markdown notes (unless protected). It must never overwrite, move, or delete raw source binaries, assets, attachments, or editor config files.
- **Failures & Recovery**: Operational failures (network, locks) can be retried. Semantic/content conflicts during automated sync must halt the job and leave `main` untouched; never attempt to force a Git conflict resolution on knowledge content.
## 5. QMD Search
- **Corpus**: Knowledge, sources, extracted text, and claim sidecars. (Exclude `system/runs`, `system/migration`, and raw binaries).
- **Tooling**: CLI and Stdio MCP.
- **Artifacts**: QMD config is committed. SQLite indexes and model caches must remain untracked.
- **Index Refresh**: Only run after a successful batch that actually altered indexable content.
+2 -1
View File
@@ -31,7 +31,8 @@
"statusBar.debuggingBackground": "#96bf48", "statusBar.debuggingBackground": "#96bf48",
"statusBar.debuggingForeground": "#15202b", "statusBar.debuggingForeground": "#15202b",
"activityBar.activeBorder": "#15202b", "activityBar.activeBorder": "#15202b",
"activityBarTop.activeBorder": "#15202b" "activityBarTop.activeBorder": "#15202b",
"statusBar.inactiveBackground": "#96bf48"
}, },
"peacock.color": "#96bf48" "peacock.color": "#96bf48"
} }
+21
View File
@@ -0,0 +1,21 @@
old_path,new_path
inbox.md,00-inbox/inbox.md
todo.md,02-projects/todo.md
TODO homelab.md,02-projects/TODO_homelab.md
making.md,02-projects/making.md
finance.md,03-areas/finance.md
home improvement.md,03-areas/home_improvement.md
AI.md,04-knowledge/topics/AI.md
homelab.md,04-knowledge/topics/homelab.md
keyboards.md,04-knowledge/topics/keyboards.md
cigars.md,04-knowledge/topics/cigars.md
booloumud.md,04-knowledge/topics/booloumud.md
pool.md,04-knowledge/topics/pool.md
opentofu.md,04-knowledge/topics/opentofu.md
gitea.md,04-knowledge/topics/gitea.md
tmux.md,04-knowledge/topics/tmux.md
chezmoi.md,04-knowledge/topics/chezmoi.md
rclone google drive.md,04-knowledge/topics/rclone_google_drive.md
dev environments.md,04-knowledge/topics/dev_environments.md
self-hosting AI on lifebalance.md,04-knowledge/topics/self-hosting_AI.md
to watch.md,04-knowledge/topics/to_watch.md
1 old_path new_path
2 inbox.md 00-inbox/inbox.md
3 todo.md 02-projects/todo.md
4 TODO homelab.md 02-projects/TODO_homelab.md
5 making.md 02-projects/making.md
6 finance.md 03-areas/finance.md
7 home improvement.md 03-areas/home_improvement.md
8 AI.md 04-knowledge/topics/AI.md
9 homelab.md 04-knowledge/topics/homelab.md
10 keyboards.md 04-knowledge/topics/keyboards.md
11 cigars.md 04-knowledge/topics/cigars.md
12 booloumud.md 04-knowledge/topics/booloumud.md
13 pool.md 04-knowledge/topics/pool.md
14 opentofu.md 04-knowledge/topics/opentofu.md
15 gitea.md 04-knowledge/topics/gitea.md
16 tmux.md 04-knowledge/topics/tmux.md
17 chezmoi.md 04-knowledge/topics/chezmoi.md
18 rclone google drive.md 04-knowledge/topics/rclone_google_drive.md
19 dev environments.md 04-knowledge/topics/dev_environments.md
20 self-hosting AI on lifebalance.md 04-knowledge/topics/self-hosting_AI.md
21 to watch.md 04-knowledge/topics/to_watch.md