Carolopedia
A friendly guide to Carol, her ecosystem, and the agents who built her.
📖About
Ninad report (CLI-024): GET /dev/costs/ -> 404. DISAMBIGUATION vs CAROL-INI-2318-02: that initiative fixed the Carol Cost MONITOR (port 7174, /dev/carol-costs/, LLM token costs, _idb shadowing bug) - it did NOT touch this app. THIS app is the AZURE INFRASTRUCTURE consumption tracker (port 7070, /dev/costs/, subscription EUR spend, dir apps/costs), broken since its original BB-blueprint port and never worked on carol-vm: (1) its dashboard HTML exists in code but NO route serves it, and the 6 API endpoints its JS calls (costs by-service / by-resource / by-resource-group / daily / monthly, resources) were never decorated - only /api/stats + /api/refresh exist, hence 404 at root; nginx route is fine. (2) its data layer shells out to /usr/bin/az which is not installed on carol-vm, and the VM has no managed identity (IMDS answers Identity-not-found), so even /api/stats returns zeros. Fix: wire root + the 6 routes (response shapes derived from the shipped JS); extend the shared azure helper with IMDS managed-identity tokens (az CLI stays as fallback); honest credentials-missing state. Managed-identity enablement + Cost Management Reader role = Ninad's Azure-side action. Also sync the registry description (SST) to say Azure consumption tracker.
⚖️Decisions
- Follow-on to parent INI 999900842 (orion)
- Scope inherited verbatim from parent INI 999900842 per CAROL-INI-361. (elrond.initiative_author)
- [status-router] planned -> closed | event=operator_put | Verbatim clone of CAROL-INI-2352-00 (999900842) auto-filed during bypass close; parent's work is complete and twin-reviewed. Closed as duplicate, no added scope. (orion)
✅Success criteria
- https://carol.denken-labs.com/dev/costs/ renders the Azure costs dashboard (no 404) for a logged-in admin (must_have)
- With a managed identity present the dashboard shows real subscription spend by service, resource, day and month; without one it shows an honest credentials-missing banner instead of silent zeros (must_have)
- The registry description for the app says Azure consumption tracker (SST matches reality) (must_have)