cloudsealed_score_architecture_risk
Score your declared system inventory for single-point-of-failure, excessive coupling, and scalability-gap risks, using explicit weighted rules with auditable breakdowns.
Instructions
Score architecture risk from a declared system inventory.
Scores single-point-of-failure, excessive-coupling, and scalability-gap risk (0-100 each) for every declared system using explicit, weighted rules — not a trained model. Every score ships with a rule-by-rule breakdown so the reasoning is auditable, not a black box. Calls the Predictive-ML-Core production HTTP service (or a self-hosted instance if PREDICTIVE_ML_CORE_URL is set).
Args: params (ScoreArchitectureRiskInput): Validated input containing: - company_name (str): Name of the company/project. - systems (list[SystemInput]): Declared inventory — each with name, type (APPLICATION|DATABASE|API|THIRD_PARTY_SERVICE), criticality (LOW|MEDIUM|HIGH|CRITICAL), public_facing, and optional data_sensitivity/auth_method. - historical_metrics (Optional[HistoricalMetricsInput]): Observed latency/throughput, improves the scalability-gap score. - response_format (ResponseFormat): 'markdown' (default) or 'json'.
Returns: str: Markdown report, or a JSON object with this schema: { "predictions": [ {"systemName": str, "riskScores": {"singlePointOfFailure": int, "excessiveCoupling": int, "scalabilityGap": int}, "scoreBreakdown": {...rule-by-rule points and rationale...}, "findings": [{"title": str, "severity": str, "description": str, "remediation": str}], "recommendations": [{"title": str, "description": str, "effort": str}]} ], "architectureSummary": str, "overallArchitectureScore": int }
Error response: "Error: <message>" if the service is unreachable or
rejects the request (e.g. empty systems list).Examples: - Use when: "Is our checkout service a single point of failure?" -> declare it with criticality=CRITICAL, type=API. - Use when: "Which of these services should we harden first?" -> declare the whole inventory and compare riskScores. - Don't use when: you need cost/billing analysis — use cloudsealed_analyze_billing_waste.
Error Handling: - Returns "Error: Request timed out..." if the service doesn't respond within 30s. - Returns "Error: ..." with the upstream message on 4xx/5xx responses.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |