"""Declarative capability catalog: extend without changing the Tools UI."""

CAPABILITIES = (
    {'key':'overview','title':'Executive overview','description':'Live KPIs, trends, pipeline and broker signals.',
     'category':'Analysis','endpoint':'dashboard.index','min_role':'viewer','demo':True},
    {'key':'analytics','title':'Analytics studio','description':'Profitability, cycle times, team throughput and rate locks.',
     'category':'Analysis','endpoint':'analytics.index','min_role':'viewer','demo':True},
    {'key':'reports','title':'Reporting studio','description':'CSV exports for operations, finance and audit evidence.',
     'category':'Reporting','endpoint':'reporting.index','min_role':'viewer','demo':True},
    {'key':'connections','title':'Database connections','description':'Read-only SQLAlchemy view adapter and diagnostics.',
     'category':'Integrations','endpoint':'integrations.index','min_role':'viewer','demo':True},
    {'key':'profile','title':'My profile','description':'Personal account details and password management.',
     'category':'Identity','endpoint':'users.profile','min_role':'viewer','demo':False},
    {'key':'users','title':'User management','description':'Account creation, access roles and activation.',
     'category':'Identity','endpoint':'users.index','min_role':'admin','demo':False},
    {'key':'audits','title':'Audit center','description':'Actor-linked events and sanitized configuration snapshots.',
     'category':'Governance','endpoint':'reporting.audit_center','min_role':'admin','demo':False},
    {'key':'health','title':'System health','description':'Integrity, audit-chain, data-quality and freshness checks with backups.',
     'category':'Governance','endpoint':'health.index','min_role':'admin','demo':True},
    {'key':'imports','title':'Import center','description':'Authenticated CSV imports from lending systems.',
     'category':'Operations','endpoint':'import_export.index','min_role':'admin','demo':False},
    {'key':'backups','title':'Backup & recovery','description':'SHA-256 manifested backups, verification and offline restore.',
     'category':'Governance','endpoint':'health.index','min_role':'admin','demo':False},
)
ROLE_RANK = {'viewer':1,'analyst':2,'admin':3}


def list_capabilities(role='viewer', demo=False):
    """Status and allowed routes for current role; never elevates permissions."""
    return [{**item, 'available': item['demo'] if demo else
             ROLE_RANK.get(role, 0) >= ROLE_RANK[item['min_role']]}
            for item in CAPABILITIES]
