# Changelog

All notable changes to VaultMesh are documented in this file.

## [Unreleased] - 2025-12-07

### Added

#### Observability Engine
- Prometheus exporter at `:9108/metrics` with 4 metrics:
  - `vaultmesh_receipts_total` (counter by module)
  - `vaultmesh_receipts_failed_total` (counter by module, reason)
  - `vaultmesh_anchor_age_seconds` (gauge)
  - `vaultmesh_emit_seconds` (histogram by module)
- Docker Compose stack (Prometheus + Grafana + Exporter)
- Grafana dashboard JSON at `docs/observability/dashboards/receipts.json`
- 8 unit + integration tests for observability

#### Guardian Engine
- Full implementation replacing stub (~200 LoC)
- `compute_scroll_root()` and `anchor()` methods
- Optional `metrics` feature for observability integration
- `set_anchor_age(0.0)` after each anchor (fresh anchor indicator)
- Metrics integration test (`--features metrics`)
- 5 unit tests

#### Treasury Engine
- Full implementation replacing stub (~300 LoC)
- Budget management: `create_budget`, `debit`, `credit`
- Receipt emission for all financial operations
- Optional `metrics` feature for observability integration
- 5 unit tests

#### Mesh Engine
- Full implementation replacing stub (~400 LoC)
- Node management: `node_join`, `node_leave`
- Route management: `route_add`, `route_remove`
- Capability management: `capability_grant`, `capability_revoke`
- Topology snapshots with `topology_snapshot()`
- 6 receipt types: `mesh_node_join`, `mesh_node_leave`, `mesh_route_change`, `mesh_capability_grant`, `mesh_capability_revoke`, `mesh_topology_snapshot`
- Optional `metrics` feature for observability integration
- Metrics integration test (`--features metrics`)
- 5 unit tests + 1 integration test

#### Core
- 13 unit tests for hash.rs and did.rs

#### MCP Server
- 7 Claude tools in `packages/vaultmesh_mcp/`:
  - `guardian_anchor_now`
  - `guardian_verify_receipt`
  - `guardian_status`
  - `treasury_create_budget`
  - `treasury_balance`
  - `treasury_debit`
  - `treasury_credit`
- Receipt emission for all tool calls

#### CI/CD
- GitLab CI pipeline with build/test/lint stages
- `observability-smoke` job for exporter tests
- `guardian-metrics-integration` job for guardian metrics integration test
- `mesh-metrics-integration` job for mesh metrics integration test
- `before_script` to ensure receipts directories exist (including `receipts/mesh`)

### Notes
- Total tests in workspace: 40 (38 workspace + 2 metrics integration)
- Level-of-Done score: 2.5 → 4.0