graph

type Annotation struct {
	ID        uint   `gorm:"primaryKey"`
	NodeID    uint   `gorm:"uniqueIndex;not null"`
	Summary   string `gorm:"type:text"`
	Context   string `gorm:"type:text"`
	RawText   string `gorm:"type:text"`
	CreatedAt time.Time
	UpdatedAt time.Time

	Tags []DocTag `gorm:"foreignKey:AnnotationID"`
}

type Community struct {
	ID          uint   `gorm:"primaryKey"`
	Namespace   string `gorm:"type:text;not null;default:'default';uniqueIndex:idx_community_ns_key"`
	Key         string `gorm:"type:text;not null;uniqueIndex:idx_community_ns_key"`
	Label       string `gorm:"type:text;not null"`
	Strategy    string `gorm:"type:text;not null;index"`
	Description string `gorm:"type:text"`
	CreatedAt   time.Time
	UpdatedAt   time.Time

	Members []CommunityMembership `gorm:"foreignKey:CommunityID"`
}

type CommunityMembership struct {
	ID          uint `gorm:"primaryKey"`
	CommunityID uint `gorm:"not null;uniqueIndex:idx_community_node"`
	NodeID      uint `gorm:"not null;uniqueIndex:idx_community_node;index"`
	CreatedAt   time.Time
}

type CrossRef struct {
	ID             uint           `gorm:"primaryKey"`
	FromNamespace  string         `gorm:"type:text;not null;index:idx_crossref_from_ns"`
	FromNodeID     uint           `gorm:"not null;index:idx_crossref_from_node"`
	Raw            string         `gorm:"type:text;not null"`
	ToNamespace    string         `gorm:"type:text;not null;index:idx_crossref_to_ns"`
	ToPath         string         `gorm:"type:text;not null;default:''"`
	ToSymbol       string         `gorm:"type:text;not null;default:''"`
	ResolvedNodeID *uint          `gorm:"index:idx_crossref_resolved_node"`
	Status         CrossRefStatus `gorm:"type:text;not null"`
	Source         CrossRefSource `gorm:"type:text;not null;default:'annotation'"`
	CreatedAt      time.Time
	UpdatedAt      time.Time
}

type CrossRefSource string

type CrossRefStatus string

type DocTag struct {
	ID           uint    `gorm:"primaryKey"`
	AnnotationID uint    `gorm:"not null;index"`
	Kind         TagKind `gorm:"type:text;not null;index"`
	Type         string  `gorm:"type:text"`
	Name         string  `gorm:"type:text"`
	Value        string  `gorm:"type:text;not null"`
	Ordinal      int     `gorm:"not null"`
	CreatedAt    time.Time
}

type Edge struct {
	ID          uint     `gorm:"primaryKey"`
	Namespace   string   `gorm:"type:text;not null;default:'default';index;uniqueIndex:idx_edges_namespace_fingerprint"`
	FromNodeID  uint     `gorm:"index"`
	ToNodeID    uint     `gorm:"index"`
	Kind        EdgeKind `gorm:"type:text;not null;index"`
	FilePath    string   `gorm:"type:text;index"`
	Line        int
	Fingerprint string `gorm:"type:text;not null;uniqueIndex:idx_edges_namespace_fingerprint"`
	CreatedAt   time.Time

	FromNode Node `gorm:"foreignKey:FromNodeID;constraint:-"`
	ToNode   Node `gorm:"foreignKey:ToNodeID;constraint:-"`
}

type EdgeKind string

type Flow struct {
	ID          uint   `gorm:"primaryKey"`
	Namespace   string `gorm:"type:text;not null;default:'default';index"`
	Name        string `gorm:"type:text;not null"`
	Description string `gorm:"type:text"`
	CreatedAt   time.Time

	Members []FlowMembership `gorm:"foreignKey:FlowID"`
}

type FlowMembership struct {
	ID        uint   `gorm:"primaryKey"`
	Namespace string `gorm:"type:text;not null;default:'default';index"`
	FlowID    uint   `gorm:"not null;index"`
	NodeID    uint   `gorm:"not null;index"`
	Ordinal   int    `gorm:"not null"`
}

type Node struct {
	ID            uint     `gorm:"primaryKey"`
	Namespace     string   `gorm:"type:text;not null;default:'default';uniqueIndex:idx_ns_qn_fp_sl;index:idx_nodes_ns_file_path,priority:1"`
	QualifiedName string   `gorm:"type:text;not null;uniqueIndex:idx_ns_qn_fp_sl"`
	Kind          NodeKind `gorm:"type:text;not null;index"`
	Name          string   `gorm:"type:text;not null"`
	FilePath      string   `gorm:"type:text;not null;index;uniqueIndex:idx_ns_qn_fp_sl;index:idx_nodes_ns_file_path,priority:2"`
	StartLine     int      `gorm:"not null;uniqueIndex:idx_ns_qn_fp_sl"`
	EndLine       int      `gorm:"not null"`
	Hash          string   `gorm:"type:text"`
	Language      string   `gorm:"type:text;index"`
	CreatedAt     time.Time
	UpdatedAt     time.Time

	Annotation *Annotation `gorm:"foreignKey:NodeID"`
}

type NodeKind string

type ParseCacheEntry struct {
	ID            uint   `gorm:"primaryKey"`
	Namespace     string `gorm:"type:text;not null;default:'default';uniqueIndex:idx_parse_cache_ns_file"`
	FilePath      string `gorm:"type:text;not null;uniqueIndex:idx_parse_cache_ns_file"`
	SourceHash    string `gorm:"type:text;not null;index"`
	ParserVersion string `gorm:"type:text;not null"`
	ContextHash   string `gorm:"type:text;not null"`
	Payload       []byte `gorm:"not null"`
	CreatedAt     time.Time
	UpdatedAt     time.Time
}

type SchemaVersion struct {
	Key       string `gorm:"primaryKey;type:text"`
	Version   int    `gorm:"not null"`
	UpdatedAt time.Time
}

type SearchDocument struct {
	ID        uint   `gorm:"primaryKey"`
	Namespace string `gorm:"type:text;not null;default:'default';index;uniqueIndex:idx_searchdoc_ns_node"`
	NodeID    uint   `gorm:"not null;uniqueIndex:idx_searchdoc_ns_node"`
	Content   string `gorm:"type:text;not null"`
	// IntentContent holds only the reason the node exists (@intent, @domainRule).
	// It is indexed separately from Content so an intent question is scored on the
	// reason rather than on whatever the node happens to be called.
	IntentContent string `gorm:"type:text;not null;default:''"`
	Language      string `gorm:"type:text;index"`
}

type TagKind string

type UnresolvedEdgeCandidate struct {
	ID              uint     `gorm:"primaryKey"`
	Namespace       string   `gorm:"type:text;not null;default:'default';uniqueIndex:idx_unresolved_ns_fp_hash"`
	LookupKey       string   `gorm:"type:text;not null"`
	LookupKeyHash   string   `gorm:"type:text;not null;index:idx_unresolved_lookup_hash"`
	Fingerprint     string   `gorm:"type:text;not null"`
	FingerprintHash string   `gorm:"type:text;not null;uniqueIndex:idx_unresolved_ns_fp_hash"`
	FilePath        string   `gorm:"type:text;not null;index"`
	Kind            EdgeKind `gorm:"type:text;not null"`
	Line            int
	CreatedAt       time.Time
}

type UnresolvedIndexState struct {
	Namespace string `gorm:"primaryKey;type:text"`
	Version   string `gorm:"type:text;not null;default:''"`
	UpdatedAt time.Time
}