// Package compat wires AgentTeam Insight graph artifacts to the upstream
// Understand-Anything TypeScript validator and dashboard.
//
// AgentTeam Insight persists graph artifacts that the UA dashboard reads directly, so
// every persisted graph must pass UA's `validateGraph()` 4-tier pipeline
// (sanitize -> normalize aliases -> auto-fix -> drop broken -> fatal). The Go
// `internal/graphbuilder/schema` package ports that pipeline deterministically;
// this package runs the upstream TypeScript validator against generated or
// hand-crafted fixtures as an end-to-end parity gate.
//
// # Skip strategy
//
// UA is an external checkout that is not part of the AgentTeam workspace. Tests in
// this package skip when the UA repo cannot be located, so AgentTeam CI does not
// need to clone Understand-Anything to validate AgentTeam Insight changes. Developers
// run the full parity gate locally by setting:
//
//	UNDERSTAND_ANYTHING_ROOT=/path/to/Understand-Anything
//
// or by passing <ua-root> as the first positional argument to
// scripts/validate-ua-graph.mjs. When the env var is absent and a graph
// fixture needs UA parity, the test reports the skip reason with the suggested
// command so the gap is visible.
//
// # Manual gate
//
// From a AgentTeam Insight checkout:
//
//	pnpm --filter @understand-anything/core build   # one-time, in UA repo
//	node kits/agentteam-insight/scripts/validate-ua-graph.mjs <ua-root> <repo>/.agentteam-insight/knowledge-graph.json
//
// # Dashboard smoke
//
// To verify the dashboard renders a generated graph without fatal validation
// errors:
//
//	cd <ua-root>/understand-anything-plugin/packages/dashboard
//	GRAPH_DIR=<repo> pnpm dev
package compat