# Aurelio Workspace — savearth Flow Meter PCB

## WHY

This hardware repository needs the same context, memory, and MCP tooling as the rest of the savearth engineering stack. Keeping a local `.aurelio/` workspace inside the repo means agents and contributors can connect to the central `savearth-workspace` and `savearth-mcp` services, access electrical-analysis MCPs, and sync memory without relying on an external Git submodule.

## HOW

The workspace is defined by `.aurelio/config.toml` and `.aurelio/mcp_config.json`. `config.toml` sets the realm (`flow-meter-pcb`), display name, sync endpoint, and default models. `mcp_config.json` declares the MCP servers the local IDE/agent should launch, scoped to hardware work: project/workspace servers, electrical EDA/sourcing servers, knowledge/memory servers, Atlassian, and sequential thinking. `.aurelio/sync.py` pushes and pulls the `brain/` directory to/from the central Proxmox container (CT 208) that hosts the Aurelio brain.

## WHAT

### Realm

- **Name:** `savearth Flow Meter PCB`
- **Realm:** `flow-meter-pcb`
- **Version:** `2.8.0`

### Tracked workspace files

These files are version-controlled and bootstrapped on clone:

| File | Purpose |
|---|---|
| `.aurelio/config.toml` | Workspace identity, sync endpoint, model defaults |
| `.aurelio/mcp_config.json` | MCP server declarations for this realm |
| `.aurelio/sync.py` | Push/pull `brain/` to the central Aurelio host |
| `.aurelio/README.md` | This file |
| `.aurelio/realm/AGENTS.md` | Realm-specific agent guide |
| `.aurelio/realm/memory/index.md` | Starter memory index |

### MCP servers

| Server | Purpose |
|---|---|
| `savearth-mcp` | Project-specific device and telemetry tools |
| `savearth-workspace` | Workspace orchestration and realm lookup |
| `electrical-eda-mcp` | Schematic parsing, ERC, power-rail analysis, SPICE |
| `electrical-sourcing-mcp` | JLCPCB/LCSC component search, alternates, BOM optimization |
| `knowledge-mcp` | General knowledge retrieval |
| `codebase-memory-mcp` | Codebase-aware memory and search |
| `atlassian-mcp-server` | Jira/Confluence integration |
| `sequential-thinking` | Structured reasoning helper |

### Sync commands

```bash
# Pull the latest central brain into the local workspace
python3 .aurelio/sync.py --pull

# Push local brain changes to the central workspace
python3 .aurelio/sync.py --push
```

### Ignored state

Runtime brain artifacts, session memory, and auto-generated logs live under `.aurelio/brain/` and `.aurelio/memory/` and are ignored by Git. Only the bootstrap files listed above are tracked.