journal

const (
	// EffectCommitted: the effect is observed to have landed.
	EffectCommitted EffectStatus = "committed"
	// EffectNone: the effect provably never executed. Reserved: no tq
	// path can prove this today (the reclaiming observer sees no
	// dispatch-started marker), so nothing stamps it yet.
	EffectNone EffectStatus = "none"
	// EffectUnknown: the run crashed mid-effect; it may or may not have
	// landed. What the reclaim path records.
	EffectUnknown EffectStatus = "unknown"
	// EffectPartial: some steps of a multi-step effect landed.
	EffectPartial EffectStatus = "partial"
	// EffectRolledBack: the effect was compensated.
	EffectRolledBack EffectStatus = "rolled_back"
)

const (
	Heartbeat FactType = "task.heartbeat"
	// SessionOpened / SessionClosed record the lifecycle of an INTERACTIVE
	// crush session (the session-close bridge, internal/session). They are
	// observations, not task state: TaskID carries the synthetic
	// "session:<id>" identity, never a real task row, so no enqueue/claim
	// machinery can ever pick them up. SessionClosed's detail names the
	// attributed commits and the minted review/status task IDs.
	SessionOpened FactType = "session.opened"
	SessionClosed FactType = "session.closed"
	// QuestionAsked records an agent's request for a human decision while
	// its task is parked (PapDashboard questions). TaskID is the PARKED
	// task; detail carries the question contract (ref, type, text,
	// options, repo, expiry). The task stays PENDING — the park is a
	// requeue without attempt burn — until RecordAnswer unblocks it.
	QuestionAsked FactType = "task.question-asked"
	// QuestionAnswered records the owner's decision arriving from
	// PapDashboard. Written by Store.RecordAnswer in the SAME transaction
	// that injects the answer into the parked task's payload and clears
	// its NotBefore, so "answered but still parked" is unrepresentable.
	// Idempotent per question ref: a replayed pickup appends nothing.
	QuestionAnswered FactType = "task.question-answered"
	// ErrorObserved records one error report from a production surface
	// (web-client beacon or server panic/5xx middleware): an observation,
	// not task state — the session:* precedent. TaskID carries the
	// synthetic "incident:<fingerprint>" identity, never a real task row,
	// so no enqueue/claim machinery can ever pick it up. Detail carries
	// the full redacted Report (message, stack, release, route, trace
	// link); the incident policy (internal/incident) folds these facts
	// into incidents and mints agent fix tasks as reactions (ADR-0021).
	ErrorObserved FactType = "error.observed"
	// IncidentTaskMinted records that the incident policy enqueued a fix
	// task for one incident: TaskID is the incident identity, detail names
	// the minted task (taskID, sourceSeq, regression, priority). Written
	// after Enqueue succeeds; replayed deliveries converge on the task's
	// dedup key instead of minting duplicates. The task's own lifecycle
	// facts (task.completed, task.dead-lettered) close or fail the
	// incident in the fold — never a mirrored column.
	IncidentTaskMinted FactType = "incident.task-minted"
)