model

type Numbered[T Result] struct {
	// Num is the 1-indexed result number for user reference.
	Num int `json:"num"`

	// Item is the underlying result.
	Item T `json:"item"`
}

type Object struct {
	// ID uniquely identifies this object.
	// Typically the file path without extension, e.g., "people/alice".
	ID string `json:"id"`

	// Type is the type of this object (e.g., "person", "project").
	Type string `json:"type"`

	// Fields contains the frontmatter field values, parsed from YAML.
	Fields map[string]interface{} `json:"fields,omitempty"`

	// FilePath is the path to the file containing this object,
	// relative to the vault root.
	FilePath string `json:"file_path"`

	// LineStart is the 1-indexed line number where this object starts.
	LineStart int `json:"line_start"`

	// ParentID is the ID of the parent object, if this object is nested.
	// Nil for top-level objects.
	ParentID *string `json:"parent_id,omitempty"`
}

type Reference struct {
	// SourceID is the ID of the object or trait containing the reference.
	SourceID string `json:"source_id"`

	// SourceType indicates whether the source is an "object" or "trait".
	SourceType string `json:"source_type"`

	// TargetRaw is the raw target as written in the wikilink.
	TargetRaw string `json:"target_raw"`

	// FilePath is the path to the file containing this reference.
	FilePath string `json:"file_path"`

	// Line is the 1-indexed line number where this reference appears.
	// May be nil if the reference is in frontmatter.
	Line *int `json:"line,omitempty"`

	// DisplayText is the display text of the wikilink, if different from target.
	DisplayText *string `json:"display_text,omitempty"`
}

type Result interface {
	GetID() string
	GetKind() string // "trait", "object", "reference", "search"
	GetContent() string
	GetLocation() string
}

type SearchMatch struct {
	// ObjectID is the ID of the object containing the match.
	ObjectID string `json:"object_id"`

	// Title is the title of the matched document.
	Title string `json:"title"`

	// FilePath is the path to the file containing the match.
	FilePath string `json:"file_path"`

	// Snippet is the matched text with surrounding context.
	// Match boundaries are marked with » and «.
	Snippet string `json:"snippet"`

	// Rank is the FTS5 BM25 ranking score (lower is better match).
	Rank float64 `json:"rank"`
}

type Trait struct {
	// ID uniquely identifies this trait instance.
	// Format: "file/path.md:trait:N" where N is the trait index in the file.
	ID string `json:"id"`

	// TraitType is the name of the trait (e.g., "todo", "due", "highlight").
	TraitType string `json:"trait_type"`

	// Value is the trait's value, if any. Nil for boolean traits like @highlight.
	Value *string `json:"value,omitempty"`

	// Content is the text content of the line containing this trait,
	// with trait annotations removed.
	Content string `json:"content"`

	// FilePath is the path to the file containing this trait,
	// relative to the vault root.
	FilePath string `json:"file_path"`

	// Line is the 1-indexed line number where this trait appears.
	Line int `json:"line"`

	// ParentObjectID is the ID of the object containing this trait.
	// This is the nearest ancestor object in the document hierarchy.
	ParentObjectID string `json:"parent_object_id"`
}