Domain model reference
Review the strict, vendor-neutral Pydantic contracts exported from lumis_sdk.domain.
Incident and diagnosis
| Type | Purpose |
|---|---|
| IncidentInput | Source tool, optional pipeline, environment, and raw payload. |
| EvidenceItem / EvidenceRequest / EvidenceCollection / EvidenceFailure | Bounded observations, the collection ask, the typed answer, and structured collection errors. |
| TriageResult | Classification, severity, summary, and missing context. |
| DiagnosisResult | Facts, hypothesis, confidence, evidence, gaps, next steps, method, and review flag. |
| ConfirmedResolution | Human- or verification-confirmed cause, action, outcome, and truth state. |
| Severity / DiagnosisMethod / TruthState | The shared enums used across diagnosis and memory. |
Planning and governance
| Type | Purpose |
|---|---|
| PlaybookDocument / PlaybookAction / ParameterDefinition | Versioned allowlist of typed, bounded, risk-labeled actions. |
| PolicyDocument / PolicyRule | Default-deny mapping from actions to approval requirements. |
| ActionProposal / EvidenceReference | Recommendation-only, digest-linked, expiring proposal with bounded parameters. |
| ApprovalDecision / ApprovalDecisionRecord | Explicit attributable approval state with idempotency support. |
| VerificationRequest / VerificationCheck / VerificationRecord | Explicit passed, failed, unknown, or timed-out verification outcomes. |
| AuditEvent / LifecycleResult | Inspectable transitions and the complete output of one non-executing lifecycle run. |
| PluginManifest / PluginLoadPolicy / PluginAuthority | Static plugin identity, explicit load policy, and named sensitive authorities. |
Strict contracts
Public domain models reject unknown fields. This makes integration mistakes visible and prevents provider-specific data from silently leaking into core contracts. Proposal and approval documents additionally use canonical JSON with SHA-256 digests, so revisions can be pinned and tampering is detectable.