# scoria v0.1.0 - Table of Contents

> Phoenix-native AI runtime and operator surface for durable runs, approvals, replay, evaluation, and bounded semantic reuse.

## Pages

- [Scoria](readme.md)
- [LICENSE](license.md)
- [Choosing An Adoption Lane](adoption_lanes.md)
- [Phoenix Runtime Example](phoenix_runtime_example.md)
- [Bounded Handoffs](bounded_handoffs.md)
- [Semantic Fast Path](semantic_fast_path.md)
- [Operator Verification](operator_verification.md)

## Modules

- [Scoria](Scoria.md): Public facade for Phoenix-hosted Scoria runtime integration.
- [Scoria.AdopterDocContract](Scoria.AdopterDocContract.md): Single source of truth for adopter-facing README and support-doc contracts.
- [Scoria.Compaction.SummarizeWorker](Scoria.Compaction.SummarizeWorker.md): Summarizes uncompacted workflow events into durable compacted memories.

- [Scoria.Compaction.Tokenizer](Scoria.Compaction.Tokenizer.md): Lightweight token estimator used by the compaction worker.

- [Scoria.Connectors](Scoria.Connectors.md): Thin connector read-model helpers for the embedded operator surface.

- [Scoria.Connectors.Auth](Scoria.Connectors.Auth.md): Browser redirect auth flow handling for remote connectors.

- [Scoria.Connectors.AuthState](Scoria.Connectors.AuthState.md): Minimal PKCE-style state envelope for connector auth redirects.

- [Scoria.Connectors.CapabilitySnapshot](Scoria.Connectors.CapabilitySnapshot.md)
- [Scoria.Connectors.Connector](Scoria.Connectors.Connector.md)
- [Scoria.Connectors.Grant](Scoria.Connectors.Grant.md)
- [Scoria.Connectors.Grant.Encrypted.Binary](Scoria.Connectors.Grant.Encrypted.Binary.md)
- [Scoria.Connectors.Grant.Encrypted.Map](Scoria.Connectors.Grant.Encrypted.Map.md)
- [Scoria.Connectors.GrantRefresh](Scoria.Connectors.GrantRefresh.md): Lightweight post-auth hook placeholder for connector grant refresh work.

- [Scoria.Connectors.Invocation](Scoria.Connectors.Invocation.md): Replay-aware connector invocation that gates remote tool execution before
reaching the MCP executor.

- [Scoria.ErrorView](Scoria.ErrorView.md)
- [Scoria.Eval](Scoria.Eval.md): The Eval context for managing datasets, evaluation specs, and runs.

- [Scoria.Eval.CampaignWorker](Scoria.Eval.CampaignWorker.md): Durable worker envelope for one eval campaign target shard.

- [Scoria.Eval.Dataset](Scoria.Eval.Dataset.md)
- [Scoria.Eval.DatasetItem](Scoria.Eval.DatasetItem.md)
- [Scoria.Eval.DatasetPromotion](Scoria.Eval.DatasetPromotion.md): Builds frozen workflow-source dataset item snapshots and inserts them immutably.

- [Scoria.Eval.EvalCampaign](Scoria.Eval.EvalCampaign.md)
- [Scoria.Eval.EvalCampaignTarget](Scoria.Eval.EvalCampaignTarget.md)
- [Scoria.Eval.EvalRun](Scoria.Eval.EvalRun.md)
- [Scoria.Eval.EvalSpec](Scoria.Eval.EvalSpec.md)
- [Scoria.Eval.OnlineScoreCandidate](Scoria.Eval.OnlineScoreCandidate.md)
- [Scoria.Eval.Score](Scoria.Eval.Score.md)
- [Scoria.Identity](Scoria.Identity.md): Canonical runtime identity envelope and Phoenix-edge adapters.
- [Scoria.Install.ApplyExecutor](Scoria.Install.ApplyExecutor.md)
- [Scoria.Install.Contract](Scoria.Install.Contract.md): Canonical installer contract: planner classifications, operator projection,
automation trailer prefix, and default verify command.
- [Scoria.Install.Manifest](Scoria.Install.Manifest.md): Persists and loads `.scoria/install/manifest.json` as the last-applied install snapshot.
- [Scoria.Install.Planner](Scoria.Install.Planner.md): Builds install plans from live host surface analyzers.
- [Scoria.Install.Report](Scoria.Install.Report.md)
- [Scoria.Install.Surface.Migrations](Scoria.Install.Surface.Migrations.md)
- [Scoria.Install.Surface.Router](Scoria.Install.Surface.Router.md)
- [Scoria.Install.Surface.RuntimeConfig](Scoria.Install.Surface.RuntimeConfig.md)
- [Scoria.Install.Surface.Tailwind](Scoria.Install.Surface.Tailwind.md)
- [Scoria.Knowledge](Scoria.Knowledge.md): Durable knowledge context for corpus ingestion, retrieval, citations, and grounding.

- [Scoria.Knowledge.Backends.Pgvector](Scoria.Knowledge.Backends.Pgvector.md)
- [Scoria.Knowledge.Chunk](Scoria.Knowledge.Chunk.md)
- [Scoria.Knowledge.Chunker](Scoria.Knowledge.Chunker.md)
- [Scoria.Knowledge.Chunker.Default](Scoria.Knowledge.Chunker.Default.md)
- [Scoria.Knowledge.Citation](Scoria.Knowledge.Citation.md)
- [Scoria.Knowledge.CitationFormatter](Scoria.Knowledge.CitationFormatter.md)
- [Scoria.Knowledge.Embedder](Scoria.Knowledge.Embedder.md)
- [Scoria.Knowledge.Embedder.Deterministic](Scoria.Knowledge.Embedder.Deterministic.md)
- [Scoria.Knowledge.Grounding](Scoria.Knowledge.Grounding.md)
- [Scoria.Knowledge.GroundingScore](Scoria.Knowledge.GroundingScore.md)
- [Scoria.Knowledge.RetrievalResult](Scoria.Knowledge.RetrievalResult.md)
- [Scoria.Knowledge.RetrievalRun](Scoria.Knowledge.RetrievalRun.md)
- [Scoria.Knowledge.Retrievers.Scrypath](Scoria.Knowledge.Retrievers.Scrypath.md)
- [Scoria.Knowledge.Source](Scoria.Knowledge.Source.md)
- [Scoria.MCP.Executor](Scoria.MCP.Executor.md): Executes MCP tools in an isolated Task with strict timeouts.
Emits telemetry events for auditing.

- [Scoria.MCP.Protocol](Scoria.MCP.Protocol.md): JSON-RPC 2.0 parsing and formatting for the MCP Gateway.

- [Scoria.MCP.Router](Scoria.MCP.Router.md): Plug router for handling incoming MCP (Model Context Protocol) JSON-RPC 2.0 requests.

- [Scoria.MCP.Tool](Scoria.MCP.Tool.md): Behaviour for defining an MCP tool.

- [Scoria.MCP.Validator](Scoria.MCP.Validator.md): Validates arguments against a tool's defined schema.

- [Scoria.Observe.Adapters.Jido](Scoria.Observe.Adapters.Jido.md)
- [Scoria.Observe.Adapters.ReqLLM](Scoria.Observe.Adapters.ReqLLM.md)
- [Scoria.Observe.Approval](Scoria.Observe.Approval.md)
- [Scoria.Observe.Buffer](Scoria.Observe.Buffer.md)
- [Scoria.Observe.CircuitBreaker](Scoria.Observe.CircuitBreaker.md)
- [Scoria.Observe.CircuitBreaker.Manager](Scoria.Observe.CircuitBreaker.Manager.md)
- [Scoria.Observe.Redactor](Scoria.Observe.Redactor.md): Utility for scrubbing sensitive data (PII, secrets, API keys) from telemetry events.

- [Scoria.Observe.Telemetry](Scoria.Observe.Telemetry.md)
- [Scoria.Orchestrator](Scoria.Orchestrator.md): Recursive fallback mechanism for LLM requests.

- [Scoria.PromptPolicy](Scoria.PromptPolicy.md): Canonical public prompt-policy noun for runtime defaults and governance.
- [Scoria.PromptRegistry](Scoria.PromptRegistry.md): The PromptRegistry context for managing prompt templates and their lifecycle.

- [Scoria.PromptRegistry.PromptTemplate](Scoria.PromptRegistry.PromptTemplate.md)
- [Scoria.PromptRegistry.Tokenizer](Scoria.PromptRegistry.Tokenizer.md): Stateless utility module for accurately estimating token usage of prompt templates.
Uses Tiktoken under the hood to ensure operators are warned before hitting context limits.

- [Scoria.Repo](Scoria.Repo.md)
- [Scoria.Repo.Span](Scoria.Repo.Span.md)
- [Scoria.Repo.SpanEvent](Scoria.Repo.SpanEvent.md)
- [Scoria.Repo.Trace](Scoria.Repo.Trace.md)
- [Scoria.Req.Steps](Scoria.Req.Steps.md): Provides the `attach/2` function to add Scoria's resiliency and model routing
steps to a Req pipeline.

- [Scoria.Req.Steps.CircuitBreaker](Scoria.Req.Steps.CircuitBreaker.md): Req request step that checks the circuit breaker state before executing the request.

- [Scoria.Req.Steps.Resiliency](Scoria.Req.Steps.Resiliency.md): Req response and error steps that track successes and failures in the circuit breaker.

- [Scoria.Runtime](Scoria.Runtime.md): Advanced runtime lifecycle and inspection APIs behind the `Scoria` facade.
- [Scoria.Runtime.CompactedMemory](Scoria.Runtime.CompactedMemory.md)
- [Scoria.Runtime.Defaults](Scoria.Runtime.Defaults.md): Resolves baseline and identity-aware runtime defaults exactly once.

- [Scoria.Runtime.Instance](Scoria.Runtime.Instance.md)
- [Scoria.Runtime.Params](Scoria.Runtime.Params.md): Normalizes public runtime inputs into explicit start and resume contracts.

- [Scoria.Runtime.ReleaseGate](Scoria.Runtime.ReleaseGate.md): Middleware that enforces release gating rules before a run is executed.
Specifically prevents draft prompts from being served in production paths.

- [Scoria.Runtime.ReplayComparison](Scoria.Runtime.ReplayComparison.md): Builds curated original-versus-replay evidence maps for workflow steps.

- [Scoria.Runtime.RunDetail](Scoria.Runtime.RunDetail.md): Curated public detail DTO for advanced run inspection.

- [Scoria.Runtime.RunSummary](Scoria.Runtime.RunSummary.md): Stable public summary DTO for lifecycle, polling, and resume flows.

- [Scoria.SRE](Scoria.SRE.md): Public Phase 7 context boundary for runtime governance, alerts, incidents,
and audit export.
- [Scoria.SRE.Adapters.Chimeway](Scoria.SRE.Adapters.Chimeway.md): Optional Chimeway-facing alert adapter.
- [Scoria.SRE.Adapters.Mailglass](Scoria.SRE.Adapters.Mailglass.md): Optional Mailglass-facing alert adapter.
- [Scoria.SRE.Adapters.Parapet](Scoria.SRE.Adapters.Parapet.md): Translates Scoria telemetry envelopes into dependency-free Parapet-facing maps.

- [Scoria.SRE.Adapters.Threadline](Scoria.SRE.Adapters.Threadline.md): Optional Threadline-facing audit adapter.
- [Scoria.SRE.AlertEvent](Scoria.SRE.AlertEvent.md)
- [Scoria.SRE.AlertPolicy](Scoria.SRE.AlertPolicy.md)
- [Scoria.SRE.AlertSink](Scoria.SRE.AlertSink.md): Behavior for optional alert delivery sinks.
- [Scoria.SRE.AuditOutboxEvent](Scoria.SRE.AuditOutboxEvent.md)
- [Scoria.SRE.AuditSink](Scoria.SRE.AuditSink.md): Behavior for optional audit export sinks.
- [Scoria.SRE.BreakerRegistry](Scoria.SRE.BreakerRegistry.md): Integration-scoped Fuse helpers for external-effect boundaries.

- [Scoria.SRE.BreakerTrip](Scoria.SRE.BreakerTrip.md)
- [Scoria.SRE.BudgetEngine](Scoria.SRE.BudgetEngine.md): Budget reservation and loop-guard decisions for workflow and MCP execution.

- [Scoria.SRE.BudgetPolicy](Scoria.SRE.BudgetPolicy.md)
- [Scoria.SRE.BudgetReservation](Scoria.SRE.BudgetReservation.md)
- [Scoria.SRE.Incident](Scoria.SRE.Incident.md)
- [Scoria.SRE.IncidentEvent](Scoria.SRE.IncidentEvent.md)
- [Scoria.SRE.IncidentManager](Scoria.SRE.IncidentManager.md): Routes alert envelopes into durable incidents, alert rows, and append-only
incident events.

- [Scoria.SRE.NotificationDelivery](Scoria.SRE.NotificationDelivery.md)
- [Scoria.SRE.Relay](Scoria.SRE.Relay.md): Supervised durable fanout worker for audit outbox rows and notification
deliveries.
- [Scoria.SRE.Telemetry](Scoria.SRE.Telemetry.md): Public Phase 7 telemetry helpers for SLI and breaker evidence.

- [Scoria.SRE.TelemetryIdentity](Scoria.SRE.TelemetryIdentity.md): Builds the canonical low-cardinality SRE identity contract.

- [Scoria.SemanticCache](Scoria.SemanticCache.md): Durable semantic-cache context for persisted reusable answers and lifecycle events.

- [Scoria.SemanticCache.Compatibility](Scoria.SemanticCache.Compatibility.md): Compatibility helpers for conservative semantic-cache reuse.

- [Scoria.SemanticCache.Eligibility](Scoria.SemanticCache.Eligibility.md): Conservative semantic-cache eligibility and scope derivation.

- [Scoria.SemanticCache.Entry](Scoria.SemanticCache.Entry.md)
- [Scoria.SemanticCache.EntryEvent](Scoria.SemanticCache.EntryEvent.md)
- [Scoria.SemanticCache.Invalidation](Scoria.SemanticCache.Invalidation.md): Transactional stale and invalidation state transitions for semantic-cache entries.

- [Scoria.SemanticCache.Lookup](Scoria.SemanticCache.Lookup.md): Exact-text-first semantic lookup with conservative compatibility checks.

- [Scoria.SemanticLane](Scoria.SemanticLane.md): Public semantic-lane contract for explicit semantic-cache admission.

- [Scoria.TestSupport.Migrations.KnowledgeMigrationRepo](Scoria.TestSupport.Migrations.KnowledgeMigrationRepo.md)
- [Scoria.Vault](Scoria.Vault.md)
- [Scoria.VerificationLanes](Scoria.VerificationLanes.md): Canonical verification lane contract for adopter-facing and maintainer-facing proofs.
- [Scoria.WarningBaseline](Scoria.WarningBaseline.md): Parses `.planning/WARNING-BASELINE.md` accepted warning debt rows for executable expiry enforcement.
- [Scoria.WarningInventory](Scoria.WarningInventory.md): Parses and classifies compiler warning output for maintainer inventory runs.
- [Scoria.WarningInventory.Cluster](Scoria.WarningInventory.Cluster.md): Stable cluster registry for compiler warning classification.
- [Scoria.WarningRatchet](Scoria.WarningRatchet.md): SSOT for high-signal warning-as-errors test paths (WARN-06).
- [Scoria.Workflows](Scoria.Workflows.md): Durable workflow persistence and lifecycle transitions.

- [Scoria.Workflows.BatchEnqueue](Scoria.Workflows.BatchEnqueue.md): Provides bulk chunking and enqueueing of Oban jobs into target queues.

- [Scoria.Workflows.Checkpoint](Scoria.Workflows.Checkpoint.md)
- [Scoria.Workflows.DatasetPromotion](Scoria.Workflows.DatasetPromotion.md): Workflow-owned approval wrapper for sealed dataset baseline promotion.

- [Scoria.Workflows.Event](Scoria.Workflows.Event.md)
- [Scoria.Workflows.Handoff](Scoria.Workflows.Handoff.md)
- [Scoria.Workflows.JidoAdapter](Scoria.Workflows.JidoAdapter.md): Optional adapter that translates Jido-style directives into Scoria workflow primitives.

- [Scoria.Workflows.PromptRelease](Scoria.Workflows.PromptRelease.md): Event-driven workflow service for prompt release approvals.

- [Scoria.Workflows.Reconciler](Scoria.Workflows.Reconciler.md): Startup and transition boundary that finds runnable steps and dispatches them safely.

- [Scoria.Workflows.RemoteApprovalProjection](Scoria.Workflows.RemoteApprovalProjection.md): Curated operator-facing projection for remote approval inbox and lineage reads.

- [Scoria.Workflows.ReplayDisposition](Scoria.Workflows.ReplayDisposition.md): Resolves seam-level replay outcomes from local classification, source evidence,
replay approval context, and replay overrides.

- [Scoria.Workflows.Resume](Scoria.Workflows.Resume.md): Thin recovery entrypoints that reconstruct the next action from durable workflow state.

- [Scoria.Workflows.Run](Scoria.Workflows.Run.md)
- [Scoria.Workflows.Runtime](Scoria.Workflows.Runtime.md): Executes bounded workflow steps under supervision and persists stable outcomes.

- [Scoria.Workflows.Step](Scoria.Workflows.Step.md)
- [ScoriaWeb.ApprovalInboxComponent](ScoriaWeb.ApprovalInboxComponent.md)
- [ScoriaWeb.CitationEvidenceComponent](ScoriaWeb.CitationEvidenceComponent.md)
- [ScoriaWeb.ConnectorAuthController](ScoriaWeb.ConnectorAuthController.md)
- [ScoriaWeb.ConnectorDetailDrawerComponent](ScoriaWeb.ConnectorDetailDrawerComponent.md)
- [ScoriaWeb.DatasetLive.PromoteComponent](ScoriaWeb.DatasetLive.PromoteComponent.md)
- [ScoriaWeb.DelegatedEvidenceComponent](ScoriaWeb.DelegatedEvidenceComponent.md)
- [ScoriaWeb.EvalSpecLive.Index](ScoriaWeb.EvalSpecLive.Index.md)
- [ScoriaWeb.IncidentEvidenceComponent](ScoriaWeb.IncidentEvidenceComponent.md)
- [ScoriaWeb.MCPController](ScoriaWeb.MCPController.md)
- [ScoriaWeb.MemoryNotebookComponent](ScoriaWeb.MemoryNotebookComponent.md)
- [ScoriaWeb.OrchestratorLive](ScoriaWeb.OrchestratorLive.md)
- [ScoriaWeb.Presence](ScoriaWeb.Presence.md): Provides presence tracking for channels and processes.
- [ScoriaWeb.PromptLive.Index](ScoriaWeb.PromptLive.Index.md)
- [ScoriaWeb.PromptLive.ReleaseWorkbenchLive](ScoriaWeb.PromptLive.ReleaseWorkbenchLive.md)
- [ScoriaWeb.RemoteInvocationEvidenceComponent](ScoriaWeb.RemoteInvocationEvidenceComponent.md)
- [ScoriaWeb.ReplayEvidenceNotebookComponent](ScoriaWeb.ReplayEvidenceNotebookComponent.md)
- [ScoriaWeb.ReviewQueueLive](ScoriaWeb.ReviewQueueLive.md)
- [ScoriaWeb.Router](ScoriaWeb.Router.md): Provides the scoria_dashboard macro to mount the Scoria LiveView dashboard
in a host Phoenix application.

- [ScoriaWeb.RuntimeDetailDrawerComponent](ScoriaWeb.RuntimeDetailDrawerComponent.md)
- [ScoriaWeb.SemanticEvidenceNotebookComponent](ScoriaWeb.SemanticEvidenceNotebookComponent.md)
- [ScoriaWeb.TraceTreeComponent](ScoriaWeb.TraceTreeComponent.md)
- [ScoriaWeb.WorkflowDetailPanelComponent](ScoriaWeb.WorkflowDetailPanelComponent.md)
- [ScoriaWeb.WorkflowLive.Show](ScoriaWeb.WorkflowLive.Show.md)
- [ScoriaWeb.WorkflowTreeComponent](ScoriaWeb.WorkflowTreeComponent.md)

- Exceptions
  - [Scoria.Install.ApplyExecutor.BlockedApplyError](Scoria.Install.ApplyExecutor.BlockedApplyError.md)

## Mix Tasks

- [mix scoria.eval](Mix.Tasks.Scoria.Eval.md): Runs LLM-as-judge evaluations over dataset items.
- [mix scoria.install](Mix.Tasks.Scoria.Install.md): Installs Scoria through planner-led safe apply with three verification modes.
- [mix scoria.milestone.archive_thread](Mix.Tasks.Scoria.Milestone.ArchiveThread.md)
- [mix scoria.pgvector.bootstrap](Mix.Tasks.Scoria.Pgvector.Bootstrap.md)
- [mix scoria.release_preview](Mix.Tasks.Scoria.ReleasePreview.md)
- [mix scoria.test.adoption](Mix.Tasks.Scoria.Test.Adoption.md)
- [mix scoria.test.ci_trust](Mix.Tasks.Scoria.Test.CiTrust.md)
- [mix scoria.test.install_contract](Mix.Tasks.Scoria.Test.InstallContract.md)
- [mix scoria.test.knowledge](Mix.Tasks.Scoria.Test.Knowledge.md)
- [mix scoria.test.runtime_to_handoff](Mix.Tasks.Scoria.Test.RuntimeToHandoff.md)
- [mix scoria.test.semantic_fast_path](Mix.Tasks.Scoria.Test.SemanticFastPath.md)
- [mix scoria.warning_baseline.check](Mix.Tasks.Scoria.WarningBaseline.Check.md): Validates accepted warning debt rows in `.planning/WARNING-BASELINE.md`.
- [mix scoria.warning_inventory](Mix.Tasks.Scoria.WarningInventory.md)
- [mix scoria.warning_ratchet.check](Mix.Tasks.Scoria.WarningRatchet.Check.md)
- [mix scoria.warning_ratchet.test](Mix.Tasks.Scoria.WarningRatchet.Test.md)
- [mix test.adoption](Mix.Tasks.Test.Adoption.md)
- [mix test.ci_trust](Mix.Tasks.Test.CiTrust.md)
- [mix test.install_contract](Mix.Tasks.Test.InstallContract.md)
- [mix test.knowledge](Mix.Tasks.Test.Knowledge.md)
- [mix test.runtime_to_handoff](Mix.Tasks.Test.RuntimeToHandoff.md)
- [mix test.semantic_fast_path](Mix.Tasks.Test.SemanticFastPath.md)

