schema

type AnalyticsEvent ¶ added in v1.35.0

type AnalyticsEvent struct{ ent.Schema }

AnalyticsEvent holds the schema definition for the AnalyticsEvent entity.

func (AnalyticsEvent) Fields() []ent.Field

func (AnalyticsEvent) Indexes() []ent.Index

type ApprovalRule ¶ added in v1.12.0

type ApprovalRule struct {
	ent.Schema
}

ApprovalRule holds the schema definition for the ApprovalRule entity.

func (ApprovalRule) Edges() []ent.Edge

func (ApprovalRule) Fields() []ent.Field

func (ApprovalRule) Indexes() []ent.Index

type BacklogActivityNote ¶ added in v1.46.0

type BacklogActivityNote struct {
	ent.Schema
}

BacklogActivityNote is an append-only, per-item log of free-form notes that ANY session can post — with or without STAPLER_SESSION_UUID, and regardless of whether that session is linked to the item. It is the ungated sibling of BacklogProgressNote, not an extension of it: report_progress's official AC-status audit trail (BacklogProgressNote, ProgressNoteData) stays structurally separate from this anyone-can-post note, so an ungated write can never be confused with — or accidentally clobber — the role-gated tools' data. See project_plans/backlog-item-activity-log/decisions/ADR-001-sibling-table-not-extend-progress-note.md for the full rationale. This table is never written by report_progress, submit_review_verdict, or any other role-gated tool.

func (BacklogActivityNote) Edges() []ent.Edge

func (BacklogActivityNote) Fields() []ent.Field

func (BacklogActivityNote) Indexes() []ent.Index

type BacklogItem ¶ added in v1.35.0

type BacklogItem struct {
	ent.Schema
}

BacklogItem holds the schema definition for the BacklogItem entity.

func (BacklogItem) Edges() []ent.Edge

func (BacklogItem) Fields() []ent.Field

func (BacklogItem) Indexes() []ent.Index

type BacklogItemDependency ¶ added in v1.43.0

type BacklogItemDependency struct {
	ent.Schema
}

BacklogItemDependency is an explicit join row recording that blocked_id (the dependent) may not be dequeued/started until blocker_id (the blocker) reaches a resolved status (done). See domain.TransitionGuard for the resolved-status check and cycle-detection at write time in AddBacklogItemDependency.

func (BacklogItemDependency) Edges() []ent.Edge

func (BacklogItemDependency) Fields() []ent.Field

func (BacklogItemDependency) Indexes() []ent.Index

type BacklogProgressNote ¶ added in v1.38.0

type BacklogProgressNote struct {
	ent.Schema
}

BacklogProgressNote is an append-only log of every report_progress call made against a backlog item's acceptance criteria. Unlike BacklogItem.AcceptanceCriteria (which stores only the *current* note per criterion, overwritten on each call), this table preserves the full history so a reviewer can see the entire timeline of notes reported across a work session, not just the latest one per criterion.

func (BacklogProgressNote) Edges() []ent.Edge

func (BacklogProgressNote) Fields() []ent.Field

func (BacklogProgressNote) Indexes() []ent.Index

type BacklogStage ¶ added in v1.52.0

type BacklogStage struct{ ent.Schema }

BacklogStage holds the schema definition for the BacklogStage entity: the persisted form of a workflow stage (built-in or operator-defined), keyed by slug. Story 2.2.2 seeds the 9 built-in session.BacklogStatus values as rows here at boot, so ConfiguredWorkflowEngine (Epic 2.3, project_plans/backlog-custom-workflow-stages/implementation/plan.md) has real rows to load from day one instead of a hardcoded fallback.

func (BacklogStage) Edges() []ent.Edge

func (BacklogStage) Fields() []ent.Field

func (BacklogStage) Indexes() []ent.Index

type BacklogStatusEvent ¶ added in v1.35.0

type BacklogStatusEvent struct {
	ent.Schema
}

BacklogStatusEvent is an append-only log of backlog item status transitions.

func (BacklogStatusEvent) Edges() []ent.Edge

func (BacklogStatusEvent) Fields() []ent.Field

func (BacklogStatusEvent) Indexes() []ent.Index

type BacklogStuckState ¶ added in v1.38.0

type BacklogStuckState struct {
	ent.Schema
}

BacklogStuckState is a durable, resolve-in-place record of a single stuck condition for a backlog item.

Resolve-in-place model: there is exactly one row per (item_id, reason) pair at all times, enforced by the plain 2-column unique index below. A stuck condition that clears sets resolved_at (the row becomes "closed" but is not deleted). If the same (item_id, reason) condition recurs later, the SAME row is reopened in place — resolved_at and notified_at are cleared and first_detected_at is reset to the new onset time — rather than inserting a second row. Episode/occurrence history (multiple rows per pair over time) is intentionally NOT retained; see ADR-001 "Durable Stuck-State Storage Model" for the rationale (a plain unique index cannot be an OnConflictColumns target for an append-only design on SQLite, since NULLs are distinct).

func (BacklogStuckState) Edges() []ent.Edge

func (BacklogStuckState) Fields() []ent.Field

func (BacklogStuckState) Indexes() []ent.Index

type ClassificationAnalytics ¶ added in v1.12.0

type ClassificationAnalytics struct {
	ent.Schema
}

ClassificationAnalytics holds the schema definition for the ClassificationAnalytics entity.

func (ClassificationAnalytics) Edges() []ent.Edge

func (ClassificationAnalytics) Fields() []ent.Field

func (ClassificationAnalytics) Indexes() []ent.Index

type ClaudeMetadata ¶

type ClaudeMetadata struct {
	ent.Schema
}

ClaudeMetadata holds the schema definition for the ClaudeMetadata entity.

func (ClaudeMetadata) Edges() []ent.Edge

func (ClaudeMetadata) Fields() []ent.Field

type ClaudeSession ¶

type ClaudeSession struct {
	ent.Schema
}

ClaudeSession holds the schema definition for the ClaudeSession entity.

func (ClaudeSession) Edges() []ent.Edge

func (ClaudeSession) Fields() []ent.Field

type DiffStats ¶

type DiffStats struct {
	ent.Schema
}

DiffStats holds the schema definition for the DiffStats entity.

func (DiffStats) Edges() []ent.Edge

func (DiffStats) Fields() []ent.Field

type DismissedFinding ¶ added in v1.54.0

type DismissedFinding struct {
	ent.Schema
}

DismissedFinding holds the schema definition for the DismissedFinding entity — a persisted record that a WasteFinding (session/tokens/findings.go) has been dismissed from the Insights findings panel. Keyed by finding_id, a stable content-addressed hash (see ComputeFindingID) rather than a raw (session_id, finding_type) pair, so a still-active session whose finding content changes produces a new finding_id and is never silently suppressed by an old dismissal.

func (DismissedFinding) Edges() []ent.Edge

func (DismissedFinding) Fields() []ent.Field

func (DismissedFinding) Indexes() []ent.Index

type ErrorEvent ¶ added in v1.35.0

type ErrorEvent struct{ ent.Schema }

ErrorEvent holds the schema definition for the ErrorEvent entity.

func (ErrorEvent) Fields() []ent.Field

func (ErrorEvent) Indexes() []ent.Index

type EscapeEvent ¶ added in v1.35.0

type EscapeEvent struct{ ent.Schema }

EscapeEvent holds the schema for a terminal escape sequence observation.

func (EscapeEvent) Fields() []ent.Field

func (EscapeEvent) Indexes() []ent.Index

type GateSatisfactionRecord ¶ added in v1.52.0

type GateSatisfactionRecord struct{ ent.Schema }

GateSatisfactionRecord holds the schema definition for the GateSatisfactionRecord entity: a persisted one-shot gate outcome (e.g. a recorded human approval, or a terminal review verdict) keyed by (item_id, gate_id). Distinguishes stateful/one-shot gates from stateless/re-checkable ones — see TransitionGate.stateful.

item_id is a plain UUID column, not an ent edge to BacklogItem: this Epic's scope is limited to the four new schema files (Epic 2.2), so BacklogItem's own edge list is left untouched, matching this project's precedent of leaving BacklogStuckState.reason as a plain unvalidated column rather than widening an existing entity's schema for a new consumer.

func (GateSatisfactionRecord) Edges() []ent.Edge

func (GateSatisfactionRecord) Fields() []ent.Field

func (GateSatisfactionRecord) Indexes() []ent.Index

type GuidanceRequest ¶ added in v1.54.0

type GuidanceRequest struct {
	ent.Schema
}

GuidanceRequest is a durable record of a single question an agent (a backlog session, automated triage, or a background workflow) asks the human, awaiting or holding an answer. See ADR-001 (project_plans/durable-guidance-request/decisions/ADR-001-standalone- guidance-request-entity.md) for why this is a standalone entity rather than a StuckReason: two of its three scopes (session, standalone) have no BacklogItem to attach to, and it carries a typed answer/options payload StuckReason has no room for.

Status is derived, not stored: pending (answered_at AND cancelled_at both NULL), cancelled (cancelled_at set — terminal, dominates even if answered_at is also set), otherwise answered. See GuidanceRequestData.Status in session/ent_repository_guidance.go.

func (GuidanceRequest) Edges() []ent.Edge

func (GuidanceRequest) Fields() []ent.Field

func (GuidanceRequest) Indexes() []ent.Index

type HandoffSummary ¶ added in v1.49.0

type HandoffSummary struct{ ent.Schema }

HandoffSummary holds the schema definition for the HandoffSummary entity — an automatically-generated, durably-persisted handoff summary for a session. Deliberately has no Edges() method: session_id is a plain (non-edge) unique string field, not an edge.From(...).Unique().Required() back to Session, so this row survives Session row deletion by construction (ADR-001/ADR-002 — see implementation/plan.md's Pattern Decisions "ent persistence shape" row).

func (HandoffSummary) Fields() []ent.Field

func (HandoffSummary) Indexes() []ent.Index

type ItemSession ¶ added in v1.35.0

type ItemSession struct {
	ent.Schema
}

ItemSession holds the schema definition for the ItemSession entity.

func (ItemSession) Edges() []ent.Edge

func (ItemSession) Fields() []ent.Field

func (ItemSession) Indexes() []ent.Index

type ItemSource ¶ added in v1.35.0

type ItemSource struct {
	ent.Schema
}

ItemSource holds the schema definition for the ItemSource entity.

func (ItemSource) Edges() []ent.Edge

func (ItemSource) Fields() []ent.Field

func (ItemSource) Indexes() []ent.Index

type PipelineMode ¶ added in v1.38.0

type PipelineMode struct{ ent.Schema }

PipelineMode holds the schema definition for the PipelineMode entity.

func (PipelineMode) Edges() []ent.Edge

func (PipelineMode) Fields() []ent.Field

func (PipelineMode) Indexes() []ent.Index

type Project ¶ added in v1.23.0

type Project struct {
	ent.Schema
}

Project holds the schema definition for the Project entity.

func (Project) Edges() []ent.Edge

func (Project) Fields() []ent.Field

func (Project) Indexes() []ent.Index

type ReviewVerdict ¶ added in v1.35.0

type ReviewVerdict struct {
	ent.Schema
}

ReviewVerdict holds the schema definition for the ReviewVerdict entity.

func (ReviewVerdict) Edges() []ent.Edge

func (ReviewVerdict) Fields() []ent.Field

func (ReviewVerdict) Indexes() []ent.Index

type Session ¶

type Session struct {
	ent.Schema
}

Session holds the schema definition for the Session entity.

func (Session) Edges() []ent.Edge

func (Session) Fields() []ent.Field

func (Session) Indexes() []ent.Index

type SessionGoal ¶ added in v1.35.0

type SessionGoal struct{ ent.Schema }

SessionGoal holds the schema definition for the SessionGoal entity. Stores the current goal, status, and task tree for a session (1:1 per session).

func (SessionGoal) Edges() []ent.Edge

func (SessionGoal) Fields() []ent.Field

func (SessionGoal) Indexes() []ent.Index

type SessionSummary ¶ added in v1.41.0

type SessionSummary struct{ ent.Schema }

SessionSummary holds the schema definition for the SessionSummary entity — an automatically-generated, durably-persisted completion summary for a session. Deliberately has no Edges() method: session_id is a plain (non-edge) unique string field, not an edge.From(...).Unique().Required() back to Session, so this row survives Session row deletion by construction (ADR-001/ADR-002 — see implementation/plan.md's Pattern Decisions "ent persistence shape" row).

func (SessionSummary) Fields() []ent.Field

func (SessionSummary) Indexes() []ent.Index

type Shell ¶ added in v1.35.0

type Shell struct {
	ent.Schema
}

Shell holds the schema definition for the Shell entity. A Shell is an independent sibling tmux session attached to a parent Session. Each shell is named {parentPrefix}_shell_{shellUUID} in tmux.

func (Shell) Edges() []ent.Edge

func (Shell) Fields() []ent.Field

func (Shell) Indexes() []ent.Index

type SourceSyncEvent ¶ added in v1.35.0

type SourceSyncEvent struct {
	ent.Schema
}

SourceSyncEvent holds the schema definition for the SourceSyncEvent entity.

func (SourceSyncEvent) Edges() []ent.Edge

func (SourceSyncEvent) Fields() []ent.Field

func (SourceSyncEvent) Indexes() []ent.Index

type StageLivenessDefinition ¶ added in v1.52.0

type StageLivenessDefinition struct{ ent.Schema }

StageLivenessDefinition holds the schema definition for the StageLivenessDefinition entity: the persisted form of session.LivenessDefinition (Epic 1.1, backlog-custom-workflow-stages), keyed by (stage_slug, pipeline_mode). One table with kind-specific nullable columns (Pattern Decisions: "single-table inheritance-adjacent" — over-normalization into one table per LivenessKind isn't worth it for a table expected to hold dozens of operator-authored rows total).

func (StageLivenessDefinition) Edges() []ent.Edge

func (StageLivenessDefinition) Fields() []ent.Field

func (StageLivenessDefinition) Indexes() []ent.Index

type StageTransition ¶ added in v1.52.0

type StageTransition struct{ ent.Schema }

StageTransition holds the schema definition for the StageTransition entity: one legal (from_stage, to_stage) edge in the workflow graph. Story 2.2.2 seeds one row per entry in domain.ValidTransitions() for the 9 built-in stages.

func (StageTransition) Edges() []ent.Edge

func (StageTransition) Fields() []ent.Field

func (StageTransition) Indexes() []ent.Index

type Tag ¶

type Tag struct {
	ent.Schema
}

Tag holds the schema definition for the Tag entity.

func (Tag) Edges() []ent.Edge

func (Tag) Fields() []ent.Field

func (Tag) Indexes() []ent.Index

type TaggingRule ¶ added in v1.54.0

type TaggingRule struct {
	ent.Schema
}

TaggingRule holds the schema definition for the TaggingRule entity — a user-editable rule that assigns descriptive tags to sessions based on branch/path/program/name patterns and prerequisite tags. Sibling schema to ApprovalRule, same shape and CRUD/concurrency guarantees (unique rule_id, atomic upsert).

func (TaggingRule) Edges() []ent.Edge

func (TaggingRule) Fields() []ent.Field

func (TaggingRule) Indexes() []ent.Index

type TaggingRuleFire ¶ added in v1.54.0

type TaggingRuleFire struct {
	ent.Schema
}

TaggingRuleFire records a single instant a TaggingRule matched (per classifier.TagMatch), independent of whether the resulting tag survived suppression filtering. Deliberately a separate, minimal table from ClassificationAnalytics (whose fields are approval/command-decision-specific) — this table exists purely to back "Fires(7d)" aggregation for tagging rules.

func (TaggingRuleFire) Edges() []ent.Edge

func (TaggingRuleFire) Fields() []ent.Field

func (TaggingRuleFire) Indexes() []ent.Index

type TransitionGate ¶ added in v1.52.0

type TransitionGate struct{ ent.Schema }

TransitionGate holds the schema definition for the TransitionGate entity: persisted config for one gate attached to a StageTransition (Epic 2.4 wires gate evaluation; this Epic only persists the shape). kind discriminates the gate's evaluation logic (e.g. "human_approval", "automated_review"); config carries kind-specific fields.

func (TransitionGate) Edges() []ent.Edge

func (TransitionGate) Fields() []ent.Field

func (TransitionGate) Indexes() []ent.Index

type TriggerFireEvent ¶ added in v1.43.0

type TriggerFireEvent struct {
	ent.Schema
}

TriggerFireEvent holds the schema definition for the TriggerFireEvent entity. One audit row per trigger evaluation attempt (fired/no-match/rejected), modeled on SourceSyncEvent — see project_plans/webhook-triggers/implementation/plan.md Epic 1.2.

func (TriggerFireEvent) Edges() []ent.Edge

func (TriggerFireEvent) Fields() []ent.Field

func (TriggerFireEvent) Indexes() []ent.Index

type Workflow ¶ added in v1.35.0

type Workflow struct{ ent.Schema }

Workflow holds the schema definition for the Workflow entity.

func (Workflow) Edges() []ent.Edge

func (Workflow) Fields() []ent.Field

func (Workflow) Indexes() []ent.Index

type Worktree ¶

type Worktree struct {
	ent.Schema
}

Worktree holds the schema definition for the Worktree entity.

func (Worktree) Edges() []ent.Edge

func (Worktree) Fields() []ent.Field