foam_sync.sh (lifebalance) 2026-10-11T21:14:01Z

.wikiignore

@@ -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

04-knowledge/topics/AI.md

@@ -10,7 +10,7 @@
 
 ## Projects
 
-* [[self-hosting AI on lifebalance]]
+* [[self-hosting_AI]]
 
 ## LocalAI Packaged
 

04-knowledge/topics/chezmoi.md

@@ -78,4 +78,4 @@ chezmoi init https://github.com/username/dotfiles.git
 ## Related
 
 - [[homelab]]
-- [[dev environments]]
+- [[dev_environments]]

04-knowledge/topics/homelab.md

@@ -67,8 +67,8 @@
   * 62 GiB RAM
   * NVIDIA GeForce RTX 4090 (24 GiB VRAM)
   * Debian GNU/Linux forky/sid
-  * [[self-hosting AI on lifebalance]]
-  * [[rclone google drive]]
+  * [[self-hosting_AI]]
+  * [[rclone_google_drive]]
 * 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
 * proxmox2

AGENTS.md

@@ -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.

shopify_theme.code-workspace

@@ -31,7 +31,8 @@
       "statusBar.debuggingBackground": "#96bf48",
       "statusBar.debuggingForeground": "#15202b",
       "activityBar.activeBorder": "#15202b",
-      "activityBarTop.activeBorder": "#15202b"
+      "activityBarTop.activeBorder": "#15202b",
+      "statusBar.inactiveBackground": "#96bf48"
     },
     "peacock.color": "#96bf48"
   }

system/migration/stage1_map.csv

@@ -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