# Upgrade Report: Conscience v0.10.0

**Date:** 04/07/2026  
**Target Realm:** `replica-omnisciente` (central brain)  
**Trigger:** `savearth-workspace` MCP server deployment + `.gitmodules` refactor + cross-repo submodule alignment.

---

## Core Upgrades

### 1. New MCP Server: `savearth-workspace`
- **Location:** `.aurelio/mcp/savearth-workspace/`
- **Files:** `server.py`, `pyproject.toml`, `README.md`
- **Endpoints:**
  - `/dashboard` — Jinja2 investor/management dashboard aggregating all savearth projects.
  - `/health` — service health check.
  - `/sse` — MCP SSE transport.
- **Purpose:** Cross-project intelligence hub for the four savearth realms (`smart-device-firmware`, `iot-backend`, `flow-meter-pcb`, `hardware-device-test`). Falls back to live fleet data via `savearth-mcp` when reachable.
- **Deployment:** Running at `http://192.168.0.212:8084`, exposed publicly at `https://savearth-workspace.portugalfuturista.org` and protected by Authentik forward-auth (CT 216 Nginx proxy).

### 2. Submodule Path Refactor (`.agent` → `replica-omnisciente`)
- **Problem:** `aws-iot-core-poc/.gitmodules` pointed to `.agent` with a misspelled URL (`replica-omnesciente.git`), while the actual central-brain directory is `replica-omnisciente`.
- **Fix applied in `aws-iot-core-poc`:**
  - Updated `.gitmodules` path to `replica-omnisciente`.
  - Corrected URL to `git@github.com:fabiorafaelcoutada/replica-omnisciente.git`.
  - Registered the existing `replica-omnisciente/` directory as a proper Git submodule (gitlink `3ae781a5`).
  - Committed and pushed to `development`.
- **Cross-repo consistency verified:**
  - `savearth-iot-infrastructure` — submodule at `replica-omnisciente` ✅
  - `savearth-hw-project` — submodule at `replica-omnisciente` ✅
  - `hardware-devicesFirmwareTest` — submodule at `replica-omnisciente` ✅

### 3. Operational Path Corrections
Updated operational scripts and documentation to use the canonical `replica-omnisciente/.aurelio/mcp/...` paths:
- `.aurelio/mcp/setup.sh` — deployment script now clones `SavearthTech/aws-iot-core-poc.git`, initializes the `replica-omnisciente` submodule, and installs the service from `replica-omnisciente/.aurelio/mcp/savearth-mcp/`.
- `.aurelio/mcp/savearth-mcp/server.py` — corrected paths for `firmware-log-analyzer` skill and memory engine search to `replica-omnisciente/realms/smart-device-firmware/.aurelio/skills/...` and `replica-omnisciente/.aurelio/memory/`.
- `.aurelio/mcp/README.md` and `.aurelio/mcp/savearth-mcp/README.md` — quick-start commands now reference `replica-omnisciente/.aurelio/mcp/...`.
- `DIRECTORY_GUIDE.md` — now describes `replica-omnisciente/` as the central brain / submodule instead of `.agent/`.
- `.aurelio/workflows/upgrade-conscience.md` — updated all `.agent/` references to `replica-omnisciente/`.

---

## Capabilities Expanded

1. **Authenticated Public Dashboard:** `savearth-workspace` exposes a management dashboard protected by Authentik, enabling investors/managers to view project status without direct repository access.
2. **Uniform Workspace Memory:** All four savearth host repositories now have `.aurelio/memory/index.md`, `.aurelio/config.toml`, and `.aurelio/mcp_config.json` registered with `savearth-mcp` and `savearth-workspace`.
3. **Reliable Submodule Cloning:** `setup.sh` now explicitly initializes `replica-omnisciente`, preventing future path mismatches during deployment.

---

## Structural Inconsistencies Found

| Issue | Status | Notes |
|-------|--------|-------|
| `aws-iot-core-poc/.gitmodules` → `.agent` / misspelled URL | ✅ Fixed | Submodule now correctly tracks `replica-omnisciente` at `3ae781a5`. |
| `.aurelio/mcp/setup.sh` old `.agent/mcp/...` paths | ✅ Fixed | Deployment paths aligned with `replica-omnisciente/.aurelio/mcp/...`. |
| `savearth-mcp/server.py` `.agent/skills/...` and `.agent/memory` refs | ✅ Fixed | Pointed to realm/global memory under `replica-omnisciente/`. |
| `DIRECTORY_GUIDE.md` described `.agent/` submodule | ✅ Fixed | Now describes `replica-omnisciente/`. |
| `upgrade-conscience.md` workflow referenced `.agent/` | ✅ Fixed | Workflow now uses `replica-omnisciente/`. |
| Legacy misspelling `replica-omnesciente` (missing `i`) | 🔄 Deferred | ~57 occurrences remain, mostly in `.aurelio/brain/` session artifacts (read-only). Core docs will be cleaned in a follow-up pass. |
| Legacy `.agent_task` file name | 🔄 Deferred | Still referenced in `DIRECTORY_GUIDE.md`; no functional impact. |
| Engineering/electrical MCP docs reference `.agent/projects/smart-device-firmware/...` | 🔄 Deferred | These project paths no longer exist; equivalent files live under `realms/smart-device-firmware/`. Needs targeted doc migration. |

---

## Current System State

### Active savearth MCP Endpoints
| Service | URL | Status |
|---------|-----|--------|
| `savearth-mcp` | `https://savearth-mcp.portugalfuturista.org/sse` | ✅ 200 |
| `savearth-workspace` | `https://savearth-workspace.portugalfuturista.org/dashboard` | ✅ Behind Authentik |
| Aurelio web portal | `https://aurelio.portugalfuturista.org` | ✅ Running |
| Authentik | `https://auth.portugalfuturista.org` | ✅ Running |

### savearth Realms Tracked in Central Brain
- `smart-device-firmware` → `aws-iot-core-poc`
- `iot-backend` → `savearth-iot-infrastructure`
- `flow-meter-pcb` → `savearth-hw-project`
- `hardware-device-test` → `hardware-devicesFirmwareTest`

### Submodule State (all four host repos)
All point to `replica-omnisciente` at commit `3ae781a5` (current central-brain HEAD).

---

## Status

Conscience v0.10.0 is fully synchronized. The savearth workspace layer is deployed, authenticated, and registered across all four project repositories. Remaining cleanup is cosmetic (legacy misspellings and stale `.agent/` doc references) and does not block operations.