knowledge

type Backlink struct {
	Concept *Concept
	Link    Link
}

type Bundle struct {
	Root     string
	Title    string
	Concepts []*Concept
	ByID     map[string]*Concept
	Markdown map[string]string
}

type BundleValidationStats struct {
	Name                  string
	Root                  string
	MarkdownFiles         int
	ReservedFiles         int
	ConceptFiles          int
	LoadedConcepts        int
	InvalidConceptFiles   int
	LinksChecked          int
	BrokenLinks           int
	StaleGeneratedIndexes int
}

type Concept struct {
	ID          string
	RelPath     string
	AbsPath     string
	Metadata    map[string]any
	Type        string
	Title       string
	Description string
	Tags        []string
	Body        string
	Links       []Link
}

type ConceptRef struct {
	BundleName string
	Bundle     *Bundle
	Concept    *Concept
}

type GraphNode struct {
	Concept *Concept
	Depth   int
}

type Issue struct {
	Path    string `json:"path"`
	Message string `json:"message"`
}

type Link struct {
	Label      string
	RawTarget  string
	TargetPath string
	TargetID   string
	External   bool
	Broken     bool
}

type NewConcept struct {
	Type        string
	Title       string
	Description string
	Tags        []string
}

type SearchOptions struct {
	Tag   string
	Type  string
	Path  string
	Limit int
}

type SearchResult struct {
	Concept *Concept
	Score   float64
}

type SearchResultRef struct {
	BundleName string
	Concept    *Concept
	Score      float64
}

type ValidationReport struct {
	Errors   []Issue
	Warnings []Issue
	Stats    ValidationStats
	Bundles  []BundleValidationStats
}

type ValidationStats struct {
	Root                  string
	Mode                  string
	Bundles               int
	MarkdownFiles         int
	ReservedFiles         int
	ConceptFiles          int
	LoadedConcepts        int
	InvalidConceptFiles   int
	LinksChecked          int
	BrokenLinks           int
	StaleGeneratedIndexes int
}

type Workspace struct {
	Root       string
	SingleRoot bool
	Bundles    []*Bundle
	ByName     map[string]*Bundle
}