🏗️ HamaFX-Ai Architecture Vault

Auto-generated Obsidian vault of the HamaFX-Ai project architecture. Open this folder as an Obsidian vault to explore 1,401 source files as an interactive graph with color-coded dependencies, Dataview dashboards, and Canvas diagrams.

🚀 Quick Start

1. Install Obsidian (desktop or iOS)
2. Clone this repo (or download & unzip)
3. Open folder as vault in Obsidian
4. Install the Dataview plugin (Settings → Community Plugins → "Dataview")
5. Enable the CSS snippet (Settings → Appearance → CSS snippets → toggle "developer")

🎯 What's Inside

Feature	How to Access	What You Get
Graph View	Ctrl+G / sidebar icon	1,401 nodes + 4,220 edges, color-coded by type and layer
_Dashboard	File explorer	Live DataviewJS tables: top connected nodes, risk distribution, package heatmap
_Architecture Canvas	Click .canvas file	Drag-and-drop package dependency diagram
Tag Browser	Right sidebar → Tags	Browse by #type/api_route, #layer/data, #risk/high, #hamafx/ai
Backlinks	Open any file → right sidebar	See everything that depends on the current file

📂 Key Files

File	Content
_Dashboard.md	Project overview with live DataviewJS queries
_API Routes.md	All 93 API endpoints
_Database Tables.md	All 49 database tables
_AI Tools.md	All 32 AI tools
_Agents.md	AI agents & committee
_Components.md	React components
_Background Jobs.md	Worker jobs & timers
_Hotspots.md	Architecture hotspots (high-risk files)
_Circular Dependencies.md	Cyclic dependency chains
_Timeline.md	Activity & change overview
_Package Overview.md	Cross-package dependency matrix
_Architecture.canvas	Visual package dependency diagram
MOC_*.md	Per-package Map of Content files

🔄 Keeping Updated

This vault is auto-generated from the HamaFX-Ai source code. To refresh:

cd tools/architecture-explorer
npx tsx src/index.ts --root /path/to/HamaFX-Ai

The vault regenerates at docs/obsidian/. Copy or sync it back to this repo.

⚙️ Pre-configured Settings

• Graph colors: 10 type colors + 9 layer colors
• Core plugins enabled: Graph, Backlinks, Tags, Canvas, Properties
• CSS snippet: developer.css — color-coded tags, compact tables, monospace properties