# Insider Lab v0.1.0 - API Reference

## Modules

- Mix tasks and CLI
  - [Insider.Adapter.CLI](Insider.Adapter.CLI.md): Bounded Erlang-term, JSON, and NDJSON transport over `Insider.Protocol`.
  - [Insider.Adapter.CLI.Dispatcher](Insider.Adapter.CLI.Dispatcher.md): Execution boundary used by the CLI transport.
  - [Insider.Lab.Output](Insider.Lab.Output.md): The single writer for the machine output of every Lab Mix task and the
`insider-lab` escript.

- Discovery
  - [Insider.Discovery.ExUnit.Inventory](Insider.Discovery.ExUnit.Inventory.md): Produces a bounded, deterministic inventory of ExUnit isolation-risk signals.

- Privacy corpus
  - [Insider.Lab.PrivacyCorpus](Insider.Lab.PrivacyCorpus.md): Runs a caller-supplied synthetic privacy corpus through the exact Logger and
Telemetry ingress code paths and reports which field names survive.

- Contracts, scenarios, fixtures
  - [Insider.Contract](Insider.Contract.md): Compile-time semantic contracts with bounded, policy-authorized callback execution.
  - [Insider.Contract.Executor](Insider.Contract.Executor.md): A fixed-capacity supervisor for failure-isolated contract callbacks.
  - [Insider.Contract.Invocation](Insider.Contract.Invocation.md): A classified local callback result. It must pass through redaction before export.

  - [Insider.Fixtures](Insider.Fixtures.md): Deterministic faulty scenarios and nearby healthy controls.
  - [Insider.Fixtures.Observation](Insider.Fixtures.Observation.md): Bounded evidence emitted by a deterministic fault fixture.
  - [Insider.Fixtures.SemanticContract](Insider.Fixtures.SemanticContract.md): A deliberately simple semantic fixture used to prove invariant incidents.
  - [Insider.Invariant](Insider.Invariant.md): Evaluates application-declared invariants and records one bounded outcome event.
  - [Insider.Invariant.Handle](Insider.Invariant.Handle.md): Evaluator handle created by `Insider.Invariant.new/1` and passed to
`Insider.Invariant.check/5`. Its fields are not a public contract.

  - [Insider.Invariant.Outcome](Insider.Invariant.Outcome.md): A local classified invariant outcome; it is not a portable wire contract.
  - [Insider.Scenario](Insider.Scenario.md): A bounded, portable sequence of declared semantic contract operations.
  - [Insider.Scenario.Executor](Insider.Scenario.Executor.md): Fixed-capacity admission for supervised scenario runs.

- Incident capture
  - [Insider.Incident.RestartCapture](Insider.Incident.RestartCapture.md): Bounded orchestration for normalized restart-recurrence evidence.

- Sentinel: sandbox and confirmation
  - [Insider.Sentinel.Confirmation](Insider.Sentinel.Confirmation.md): Validates and confirms one incident on an exact disposable sandbox target.
  - [Insider.Sentinel.Confirmation.Receipt](Insider.Sentinel.Confirmation.Receipt.md): Bounded terminal evidence returned by a trusted confirmation target adapter.
  - [Insider.Sentinel.Confirmation.Record](Insider.Sentinel.Confirmation.Record.md): A bounded, content-addressed result of one clean-target confirmation run.
  - [Insider.Sentinel.Manifest](Insider.Sentinel.Manifest.md): A closed, content-addressed handoff from an incident capsule to Sentinel.
  - [Insider.Sentinel.Sandbox](Insider.Sentinel.Sandbox.md): Provider-driven lifecycle for a disposable clean target.
  - [Insider.Sentinel.Sandbox.Body](Insider.Sentinel.Sandbox.Body.md): Behaviour for trusted work that runs while a disposable target lease is live.
  - [Insider.Sentinel.Sandbox.Executor](Insider.Sentinel.Sandbox.Executor.md): Fixed-capacity supervisor for provider-driven disposable target runs.
  - [Insider.Sentinel.Sandbox.Provider](Insider.Sentinel.Sandbox.Provider.md): Behaviour for trusted disposable-target adapters.
  - [Insider.Sentinel.Sandbox.Target](Insider.Sentinel.Sandbox.Target.md): A canonical expected fingerprint for a disposable Sentinel target.

- Sentinel: regression, minimizer, bisection
  - [Insider.Sentinel.Bisection](Insider.Sentinel.Bisection.md): Bounded offline binary search over a host-declared ordered target list.
  - [Insider.Sentinel.Bisection.Record](Insider.Sentinel.Bisection.Record.md): Canonical evidence for one bounded offline bisection over declared targets.
  - [Insider.Sentinel.Bisection.Result](Insider.Sentinel.Bisection.Result.md): Live bisection output containing the canonical verdict and its evidence.
  - [Insider.Sentinel.Minimizer](Insider.Sentinel.Minimizer.md): Deterministically removes whole scenario steps under fresh failure evidence.
  - [Insider.Sentinel.Minimizer.Record](Insider.Sentinel.Minimizer.Record.md): Canonical evidence for one bounded whole-step scenario minimization.
  - [Insider.Sentinel.Minimizer.Result](Insider.Sentinel.Minimizer.Result.md): Live minimization output containing the canonical verdict and its evidence.
  - [Insider.Sentinel.Regression](Insider.Sentinel.Regression.md): A bounded, canonical recipe for proving a confirmed incident still fails.

- Sentinel: repair orchestration
  - [Insider.Sentinel.CodingAgent.CandidateSubmission](Insider.Sentinel.CodingAgent.CandidateSubmission.md): A bounded, inert candidate returned for independent verification.
  - [Insider.Sentinel.CodingAgent.Handoff](Insider.Sentinel.CodingAgent.Handoff.md): A self-contained, bounded repair request derived from confirmed evidence.
  - [Insider.Sentinel.Dedup](Insider.Sentinel.Dedup.md): Offline, deterministic, bounded retention for canonical incidents and proposals.
  - [Insider.Sentinel.Dedup.Receipt](Insider.Sentinel.Dedup.Receipt.md): A privacy-minimal, canonical outcome record for offline Sentinel deduplication.
  - [Insider.Sentinel.DraftCreation.DisclosureAuthority](Insider.Sentinel.DraftCreation.DisclosureAuthority.md): Behaviour for an explicitly configured disclosure-policy authority.
  - [Insider.Sentinel.DraftCreation.DisclosureDecision](Insider.Sentinel.DraftCreation.DisclosureDecision.md): A canonical record of one disclosure authority's draft-creation decision.
  - [Insider.Sentinel.DraftCreation.Executor](Insider.Sentinel.DraftCreation.Executor.md): A fail-closed, bounded gate for draft-only provider effects.
  - [Insider.Sentinel.DraftCreation.Identity](Insider.Sentinel.DraftCreation.Identity.md): Validators for the portable provider and disclosure-authority identities used
by the draft-creation gate. An identity selects a module only from the host's
configured allowlist; it can never resolve a module by itself.

  - [Insider.Sentinel.DraftCreation.Provider](Insider.Sentinel.DraftCreation.Provider.md): Behaviour for an explicitly configured draft-creation provider.
  - [Insider.Sentinel.DraftCreation.Receipt](Insider.Sentinel.DraftCreation.Receipt.md): A canonical local record of one draft-provider attempt.
  - [Insider.Sentinel.DraftCreation.Request](Insider.Sentinel.DraftCreation.Request.md): A canonical, disclosure-approved request for one provider-created draft.
  - [Insider.Sentinel.DraftProposal](Insider.Sentinel.DraftProposal.md): A canonical, side-effect-free proposal derived from exact repair evidence.
  - [Insider.Sentinel.RepairReport](Insider.Sentinel.RepairReport.md): Deterministically renders a human review document from a bound repair report.
  - [Insider.Sentinel.RepairReport.Manifest](Insider.Sentinel.RepairReport.Manifest.md): A bounded, content-addressed summary of completed repair evidence.
  - [Insider.Sentinel.SourceOwnership](Insider.Sentinel.SourceOwnership.md): A canonical, offline source-ownership routing companion for a draft proposal.
  - [Insider.Sentinel.Verification](Insider.Sentinel.Verification.md): Runs bounded live failing-before and passing-after verification on disposable targets.
  - [Insider.Sentinel.Verification.Candidate](Insider.Sentinel.Verification.Candidate.md): A bounded opaque candidate repair.
  - [Insider.Sentinel.Verification.Receipt](Insider.Sentinel.Verification.Receipt.md): A strict bounded receipt from one trusted post-repair sandbox body.
  - [Insider.Sentinel.Verification.Record](Insider.Sentinel.Verification.Record.md): A canonical derived verdict for bounded failing-before and passing-after evidence.

## Mix Tasks

- Mix tasks and CLI
  - [mix insider](Mix.Tasks.Insider.md): Runs bounded Insider diagnostics and emits machine-readable JSON.
  - [mix insider.candidates](Mix.Tasks.Insider.Candidates.md): Lists static ExUnit isolation-risk signals for agent-directed investigation.
  - [mix insider.live](Mix.Tasks.Insider.Live.md): Attaches to another BEAM node on this machine over Erlang distribution and
drives its `Insider.Live` session, printing canonical JSON.
[Observer node](https://github.com/hiivemarkets/insider/blob/main/docs/live/live-api-and-transports.md#observer-node-erlang-distribution)
in the root `docs/` is the reference for target setup and every flag.
  - [mix insider.oracle](Mix.Tasks.Insider.Oracle.md): Runs one fixed, value-free ExUnit oracle artifact against one selected test
command in a target Mix project, without editing the target, and saves a
versioned `insider.oracle-run/v1` record in a new run directory.
  - [mix insider.privacy_corpus](Mix.Tasks.Insider.PrivacyCorpus.md): Runs a caller-supplied synthetic privacy corpus through the exact Logger and
Telemetry ingress code paths and prints an `insider.privacy-corpus-report/v1`
JSON document that names retained fields without their values.

