analysis

const (
	// BrokenLink is a reference whose target document does not exist.
	BrokenLink FindingKind = iota
	// BrokenAnchor is a reference whose target document exists but anchor does not.
	BrokenAnchor
	// Orphan is a document nothing links to.
	Orphan
	// Unreachable is a document not reachable from the root set.
	Unreachable
	// Ambiguous is a reference that matches multiple candidate documents.
	Ambiguous
	// KnowledgeGap is a detected documentation gap.
	KnowledgeGap
	// UnderLinked is a document with fewer inbound links than the discoverability
	// threshold (but at least one outbound link). Below-default it is Info; a
	// config knob can promote it to Warning (ADR 0012).
	UnderLinked
	// DeadEnd is a document with inbound links but no outbound navigational links
	// (a terminal node). Below-default it is Info; a config knob can promote it to
	// Warning (ADR 0012).
	DeadEnd
	// SuggestedLink is a topology-based suggestion that two UNLINKED but
	// structurally-close documents may warrant a navigational link (ADR 0013). It
	// is always Info and NEVER gates the exit code (it is an experimental,
	// additive discoverability hint, not a defect).
	SuggestedLink
	// DeadLink is an external (http/https) link that failed an opt-in liveness
	// check (--check-external): unreachable, an error status, or refused by the
	// SSRF guard. It is produced only when external checking is enabled, so it is
	// kept OUT of the default deterministic output (ADR 0003).
	DeadLink
	// ArticulationPoint is a document that is a cut VERTEX of the undirected link
	// closure (ADR 0015): removing or unlinking it fragments the corpus into more
	// pieces. It is always Info and NEVER gates the exit code (even --strict) — it
	// is a structural-resilience hint, not a defect — mirroring SuggestedLink and
	// KnowledgeGap.
	ArticulationPoint
	// Bridge is a navigational link that is a cut EDGE of the undirected closure
	// (ADR 0015): it is the only connection between two parts of the corpus, so
	// losing it disconnects them. Like ArticulationPoint it is always Info and
	// never gates the exit code.
	Bridge
	// LowScentAnchor is a navigational link whose anchor text shares too few
	// meaningful tokens with its destination — the target's title or its section
	// headings (the fragment's own heading for an anchored link) — to preview
	// where it leads (ADR 0016): a generic "click here" / a label unrelated to
	// the destination gives a reader or agent weak "information scent" (Pirolli &
	// Card 1999). It is always Info and NEVER gates the exit code (even --strict)
	// — a discoverability hint, not a defect — mirroring SuggestedLink,
	// ArticulationPoint and Bridge.
	LowScentAnchor
	// FarFromRoot is a document reachable from the root set but at or beyond the
	// configured hop-distance threshold from the NEAREST root (ADR 0021): it is
	// "reachable but effectively undiscoverable" by link traversal, since an agent
	// or reader following links from an entry point is unlikely to reach it that
	// deep. It is always Info and NEVER gates the exit code (even --strict) — a
	// discoverability hint, not a defect — mirroring UnderLinked's intent but
	// keyed on distance-from-entry-point rather than raw in-degree.
	FarFromRoot
	// OKFMissingFrontmatter is an OKF v0.1 conformance violation (rule R1, ADR
	// 0023): a non-reserved concept document (any `.md` other than index.md /
	// log.md) has no parseable YAML frontmatter block — either absent entirely or
	// present-but-unparseable (the state is carried in Details). It is produced
	// ONLY in OKF conformance mode (--okf) and is Error severity: when the mode is
	// on it gates the exit code (exit 1) regardless of --strict.
	OKFMissingFrontmatter
	// OKFMissingType is an OKF v0.1 conformance violation (rule R2, ADR 0023): a
	// concept document's frontmatter has no non-empty string `type` field. matlatl
	// NEVER validates the type VALUE against any list (OKF §4.1 forbids a central
	// registry). Produced ONLY in OKF mode; Error severity; gates exit 1
	// independent of --strict.
	OKFMissingType
	// OKFReservedFileStructure is an OKF v0.1 conformance violation (rule R3, ADR
	// 0023): a reserved file does not follow its required structure — a log.md `##`
	// heading is not an ISO 8601 `YYYY-MM-DD` date, a non-root index.md carries
	// frontmatter, or a root index.md carries a frontmatter key other than
	// okf_version. Produced ONLY in OKF mode; Error severity; gates exit 1
	// independent of --strict.
	OKFReservedFileStructure
)

const (
	// Info is an informational finding.
	Info Severity = iota
	// Warning is a finding that does not fail the build by default.
	Warning
	// Error is a finding that fails the build (exit 1, ADR 0005).
	Error
)