API CONTRACTS

{
  "mii": 0.97,
  "status": "stable",
  "trend": "flat",
  "days_stable": 42,
  "last_updated": "2026-01-31T09:52:00Z",
  "thresholds": {
    "stable": 0.95,
    "watch": 0.90,
    "breach": 0.90
  }
}

{
  "period": "30d",
  "resolution": "daily",
  "data": [
    {
      "timestamp": "2026-01-01T00:00:00Z",
      "mii": 0.96,
      "status": "stable"
    },
    {
      "timestamp": "2026-01-02T00:00:00Z",
      "mii": 0.97,
      "status": "stable"
    }
  ],
  "summary": {
    "min": 0.95,
    "max": 0.98,
    "average": 0.965,
    "status_changes": 0
  }
}

{
  "total": 1284,
  "limit": 20,
  "offset": 0,
  "entries": [
    {
      "id": "act_20260131_001",
      "timestamp": "2026-01-31T10:00:00Z",
      "summary": "Policy Update Executed",
      "intent": "Improve safety filter reliability",
      "risk": "medium",
      "integrity_impact": "neutral",
      "status": "completed",
      "approvals": {
        "required": 1,
        "received": 1,
        "roles": ["steward"]
      }
    }
  ]
}

{
  "id": "act_20260131_001",
  "timestamp": "2026-01-31T10:00:00Z",
  "summary": "Policy Update Executed",
  "intent": {
    "text": "Improve safety filter reliability",
    "epicon_id": "EPICON_C-203_SECURITY_filter-update_v1",
    "declared_at": "2026-01-30T15:00:00Z"
  },
  "risk": "medium",
  "scope": [
    "packages/integrity-core",
    "apps/broker-api"
  ],
  "integrity_impact": "neutral",
  "status": "completed",
  "approvals": {
    "required": 1,
    "received": 1,
    "timeline": [
      {
        "role": "steward",
        "approved_at": "2026-01-31T09:00:00Z"
      }
    ]
  },
  "execution": {
    "started_at": "2026-01-31T10:00:00Z",
    "completed_at": "2026-01-31T10:05:00Z",
    "outcome": "success"
  }
}

{
  "timestamp": "2026-01-31T10:00:00Z",
  "signals": {
    "intent_coverage": {
      "status": "normal",
      "value": 0.98,
      "description": "Most actions include clear explanations."
    },
    "review_latency": {
      "status": "elevated",
      "value": 1.2,
      "baseline": 1.0,
      "description": "Reviews are taking slightly longer than average."
    },
    "override_frequency": {
      "status": "normal",
      "value": 0,
      "description": "No recurring emergency behavior detected."
    },
    "drift_risk": {
      "status": "low",
      "confidence": "high",
      "description": "No long-term concerning trend identified."
    }
  },
  "overall_assessment": "No indicators suggest systemic issues at this time."
}

{
  "timestamp": "2026-01-31T10:00:00Z",
  "patterns": [
    {
      "type": "emergency_frequency",
      "status": "clear",
      "description": "No recurring emergency actions",
      "last_occurrence": null,
      "trend": "stable"
    },
    {
      "type": "explanation_quality",
      "status": "clear",
      "description": "No decline in explanation quality",
      "trend": "stable"
    }
  ],
  "confidence": "high",
  "assessment": "No concerning patterns detected at this time."
}

{
  "timestamp": "2026-01-31T10:00:00Z",
  "total_actions": 18402,
  "blocked_actions": 214,
  "integrity_breaches": {
    "total": 2,
    "resolved": 2,
    "open": 0
  },
  "longest_stable_period": {
    "days": 123,
    "start": "2025-08-15T00:00:00Z",
    "end": "2025-12-16T00:00:00Z"
  },
  "first_record": "2025-01-01T00:00:00Z"
}

{
  "total": 45,
  "annotations": [
    {
      "id": "ann_001",
      "activity_id": "act_20250115_042",
      "text": "Review process strengthened after this incident",
      "author_role": "steward",
      "created_at": "2025-01-20T10:00:00Z"
    }
  ]
}

{
  "human_approval_required": [
    "Production deployment",
    "Integrity threshold changes",
    "MIC mint/burn logic",
    "Emergency overrides"
  ],
  "oversight_path": [
    "Citizen",
    "Auditor",
    "Steward",
    "Public record"
  ],
  "authority_statement": "No single person or model has unilateral authority.",
  "escalation_thresholds": {
    "steward_review": "risk >= medium",
    "council_review": "risk >= high",
    "emergency_session": "risk == critical OR integrity_breach"
  }
}

{
  "type": "pattern",
  "description": "Concern about shortened review cycles",
  "rationale": "Potential erosion of human oversight",
  "related_activities": ["act_20260130_001", "act_20260129_002"]
}

{
  "id": "flag_20260131_001",
  "status": "submitted",
  "created_at": "2026-01-31T10:00:00Z",
  "review_deadline": "2026-02-03T10:00:00Z",
  "message": "Thank you. This report is now part of the public oversight record."
}

{
  "timestamp": "2026-01-31T10:00:00Z",
  "counts": {
    "critical": 0,
    "review": 2,
    "info": 5
  },
  "alerts": [
    {
      "id": "alert_001",
      "severity": "review",
      "title": "Review latency elevated",
      "description": "Average review time exceeds baseline by 20%",
      "created_at": "2026-01-30T15:00:00Z",
      "status": "active"
    }
  ]
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please wait before trying again.",
    "retry_after": 60
  }
}