{ "fluid_hypothesis": { "audit": { "decision_refs": [ "D-2811" ], "immutable_event_refs": [ "EV-990218" ] }, "backend_requirements": { "required": false, "requirement_refs": [] }, "candidate_revision_refs": [ "R-000221" ], "complexity": { "expected_delta": { "cognitive_load": -0.2, "concept_count": 0, "operation_count": 1, "semantic_overlap": 0.1, "surface_area": 1 }, "score": 0.18 }, "created_at": "2026-09-04T12:00:00Z", "created_by": { "id": "fluid-daimon/customer-finance-api", "type": "daimon" }, "economics": { "currency": "EUR", "estimated_experiment_cost": 18.0, "estimated_implementation_cost": 40.0, "expected_value_class": "MEDIUM" }, "expected_outcomes": [ { "baseline": 2.7, "cohort": "all", "direction": "lower", "metric": "requests_per_completed_task", "target": 1.2 }, { "baseline": 1.0, "cohort": "all", "direction": "lower", "metric": "client_side_sort_workarounds", "target": 0.2 } ], "experiment_refs": [ "E-000093" ], "explanation": { "claim": "Consumers treat \"latest invoice\" as a domain-level concept and the existing generic collection interface does not present that concept directly.\n", "reach": { "explains": [ "P-1831", "P-1834" ], "notes": "Medium reach: explains several related request patterns but not broader financial-context pressure.\n", "score": 0.42 } }, "failure_criteria": { "expression": "any hard guardrail violation OR adoption below 5% after 30 days when equally discoverable\n" }, "fitness_dimensions": { "expected": { "client_utility": 0.7, "compatibility": 0.0, "correctness": 0.0, "discoverability": 0.65, "maintainability": -0.05, "operational_cost": 0.0, "performance": 0.1, "reliability": 0.0, "security": 0.0, "simplicity": -0.15 } }, "guardrails": [ { "metric": "p95_latency_ms", "operator": "<=", "threshold": 315 }, { "metric": "authorization_scope_change", "operator": "==", "threshold": false }, { "metric": "backend_query_count_delta", "operator": "<=", "threshold": 0 } ], "id": "H-000184", "interface_id": "customer-finance-api", "learning_value": { "notes": "Useful signal for whether first-class convenience resources improve agent and partner integration behavior.\n", "score": 0.56 }, "observation": { "affected_cohorts": [ "partner-integrations", "coding-agents" ], "evidence_refs": [ "telemetry:invoice-pattern-2026w36", "feedback:F-9821" ], "observation_window": { "end": "2026-09-01T00:00:00Z", "start": "2026-08-15T00:00:00Z" }, "summary": "A significant consumer cohort retrieves invoice collections, sorts them by issue date, and discards all but the first item.\n" }, "outcome": { "evidence_refs": [], "status": null, "summary": null }, "pressure": { "classes": [ "successful_but_inefficient_usage", "repeated_expectation_mismatch" ], "confidence": 0.88, "severity": 0.61 }, "priority": { "decided_by": "optimization-policy-v3", "score": 0.71 }, "proposed_adaptation": { "candidate_contract": { "method": "GET", "path": "/customers/{id}/invoices/latest" }, "class": "contract", "implementation_scope": "interface_only", "summary": "Add an explicit latest-invoice retrieval capability.\n" }, "risk": { "level": "LOW", "reasons": [ "read-only operation", "no authorization expansion" ] }, "schema_version": "0.1", "state": "PRIORITIZED", "success_criteria": { "expression": "requests_per_completed_task <= 1.2 AND no hard guardrail violation\n" }, "title": "Provide direct latest-invoice capability" } }