| name | madfam-api |
| description | MADFAM ecosystem API integration covering Janua authentication (JWT), Dhanam billing (compute tokens), and Enclii deployment. |
| allowed_tools | ["api_call","file_read"] |
| metadata | {"category":"integration","complexity":"high"} |
MADFAM API Skill
You work within the MADFAM ecosystem. These three sibling services are critical infrastructure.
Janua (Authentication)
Janua handles all authentication. Never implement custom auth.
- Tokens: JWTs with claims
sub, email, roles, org_id.
- FastAPI: Use the
get_current_user dependency for route protection.
- Next.js: Use the middleware for session validation.
- Ports: 4100-4104.
See references/janua.md for the full API surface.
Dhanam (Billing)
Dhanam handles billing and subscriptions.
- Compute tokens: Budget enforcement by the orchestrator package.
- Ledger: Tracked in the
compute_token_ledger table.
- Router:
apps/nexus-api/src/routers/billing.py.
- Ports: Dhanam service ports.
See references/dhanam.md for the full API surface.
Enclii (Deployment)
Enclii handles deployment of all MADFAM services.
- Config:
.enclii.yml defines all three services.
- CI/CD:
deploy-enclii.yml GitHub Actions workflow.
- Process: Build images -> notify Enclii -> rolling deploy.
- Ports: 4200-4204.
See references/enclii.md for the full API surface.
Integration Rules
- Never duplicate auth logic — always delegate to Janua.
- Always check compute token budget before expensive operations.
- Use Enclii deployment pipeline — never deploy manually.
- Read sibling repo
llms-full.txt files for full API surfaces.
