okf

type BuildResult struct {
	Bundle       Bundle
	BundleJSON   []byte
	Manifest     BundleManifest
	ManifestJSON []byte
	SHA256File   []byte
}

type Bundle struct {
	SchemaVersion int       `json:"schema_version"`
	OKFVersion    string    `json:"okf_version"`
	RootIndex     RootIndex `json:"root_index"`
	Concepts      []Concept `json:"concepts"`
	SourceSHA256  string    `json:"source_sha256"`
}

type BundleManifest struct {
	SchemaVersion int    `json:"schema_version"`
	OKFVersion    string `json:"okf_version"`
	ConceptCount  int    `json:"concept_count"`
	SectionCount  int    `json:"section_count"`
	EvidenceCount int    `json:"evidence_count"`
	BundleSHA256  string `json:"bundle_sha256"`
	SourceSHA256  string `json:"source_sha256"`
}

type Concept struct {
	Path        string           `json:"path"`
	ConceptID   string           `json:"concept_id"`
	Type        string           `json:"type"`
	Title       string           `json:"title"`
	Description string           `json:"description,omitempty"`
	Resource    string           `json:"resource,omitempty"`
	Tags        []string         `json:"tags,omitempty"`
	Timestamp   string           `json:"timestamp,omitempty"`
	Frontmatter map[string]any   `json:"frontmatter,omitempty"`
	Body        string           `json:"-"`
	BodyLength  int              `json:"body_length"`
	Summary     string           `json:"summary,omitempty"`
	Sections    []ConceptSection `json:"sections,omitempty"`
	Evidence    []EvidenceRef    `json:"evidence,omitempty"`
	Legacy      bool             `json:"-"`
	HasSummary  bool             `json:"-"`
	HasContract bool             `json:"-"`
	HasBounds   bool             `json:"-"`
	HasEvidence bool             `json:"-"`
	Snippet     string           `json:"snippet,omitempty"`
	Links       []ConceptLink    `json:"links,omitempty"`
	Backlinks   []ConceptLink    `json:"backlinks,omitempty"`
}

type ConceptLink struct {
	Label     string `json:"label"`
	Path      string `json:"path"`
	ConceptID string `json:"concept_id,omitempty"`
	Title     string `json:"title,omitempty"`
}

type ConceptSection struct {
	ID        string `json:"id"`
	Title     string `json:"title"`
	Level     int    `json:"level"`
	Body      string `json:"body"`
	CharCount int    `json:"char_count"`
}

type ConceptSummary struct {
	ConceptID    string   `json:"concept_id,omitempty"`
	Path         string   `json:"path"`
	Type         string   `json:"type,omitempty"`
	Title        string   `json:"title"`
	Description  string   `json:"description,omitempty"`
	Resource     string   `json:"resource,omitempty"`
	Tags         []string `json:"tags,omitempty"`
	Summary      string   `json:"summary,omitempty"`
	SectionCount int      `json:"section_count,omitempty"`
}

type EvidenceRef struct {
	ID          string `json:"id"`
	Source      string `json:"source"`
	Line        int    `json:"line,omitempty"`
	Description string `json:"description"`
}

type IndexEntry struct {
	ConceptSummary
}

type IndexRequest struct {
	Section string
}

type IndexResult struct {
	OKFVersion    string         `json:"okf_version"`
	TotalSections int            `json:"total_sections"`
	Sections      []IndexSection `json:"sections"`
	Truncated     bool           `json:"truncated"`
}

type IndexSection struct {
	Title   string       `json:"title"`
	Slug    string       `json:"slug"`
	Entries []IndexEntry `json:"entries"`
}

type OpenRequest struct {
	ConceptID       string
	Path            string
	Section         string
	BodyOffset      int
	BodyLimit       int
	IncludeEvidence bool
}

type OpenResult struct {
	Concept            ConceptSummary   `json:"concept"`
	Summary            string           `json:"summary,omitempty"`
	SectionID          string           `json:"section_id,omitempty"`
	SectionTitle       string           `json:"section_title,omitempty"`
	Sections           []SectionSummary `json:"sections,omitempty"`
	Evidence           []EvidenceRef    `json:"evidence,omitempty"`
	EvidenceOmitted    bool             `json:"evidence_omitted,omitempty"`
	Body               string           `json:"body"`
	BodyOffset         int              `json:"body_offset"`
	BodyLength         int              `json:"body_length"`
	ReturnedBodyLength int              `json:"returned_body_length"`
	ConceptBodyLength  int              `json:"concept_body_length"`
	Truncated          bool             `json:"truncated"`
	Links              []ConceptLink    `json:"links"`
	Backlinks          []ConceptLink    `json:"backlinks"`
}

type QualityIssue struct {
	Level   string `json:"level"`
	Code    string `json:"code"`
	Path    string `json:"path"`
	Message string `json:"message"`
}

type QualityMode string

type QualityReport struct {
	Issues   []QualityIssue `json:"issues"`
	Errors   int            `json:"errors"`
	Warnings int            `json:"warnings"`
}

type RootIndex struct {
	Path        string         `json:"path"`
	OKFVersion  string         `json:"okf_version"`
	Frontmatter map[string]any `json:"frontmatter,omitempty"`
	Body        string         `json:"body"`
	Sections    []IndexSection `json:"sections,omitempty"`
	Links       []ConceptLink  `json:"links,omitempty"`
}

type SearchFilters struct {
	Type string   `json:"type,omitempty"`
	Tags []string `json:"tags,omitempty"`
}

type SearchMatch struct {
	ConceptID    string   `json:"concept_id"`
	Path         string   `json:"path"`
	Type         string   `json:"type"`
	Title        string   `json:"title"`
	Description  string   `json:"description,omitempty"`
	Resource     string   `json:"resource,omitempty"`
	Tags         []string `json:"tags,omitempty"`
	Summary      string   `json:"summary,omitempty"`
	SectionID    string   `json:"section_id,omitempty"`
	SectionTitle string   `json:"section_title,omitempty"`
	Snippet      string   `json:"snippet,omitempty"`
	Score        int      `json:"score"`
}

type SearchRequest struct {
	Query      string
	MaxResults int
	Type       string
	Tags       []string
}

type SearchResult struct {
	Query         string        `json:"query"`
	Filters       SearchFilters `json:"filters,omitempty"`
	TotalConcepts int           `json:"total_concepts"`
	TotalMatches  int           `json:"total_matches"`
	MatchCount    int           `json:"match_count"`
	MaxResults    int           `json:"max_results"`
	HasMore       bool          `json:"has_more"`
	OmittedCount  int           `json:"omitted_count"`
	Matches       []SearchMatch `json:"matches"`
	Truncated     bool          `json:"truncated"`
}

type SectionSummary struct {
	ID        string `json:"id"`
	Title     string `json:"title"`
	Level     int    `json:"level"`
	CharCount int    `json:"char_count"`
}