vm-core/CHANGELOG.md

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