from @unified-product-graph/core/intelligence · re-exported by @sdk

Intelligence

v0.4 anti-patterns and heuristics.

45 exports · 8 const · 5 type · 20 interface · 12 fn

Since v0.4.0

Quick import

import { UPG_ANTI_PATTERNS, UPG_RELATIONSHIP_BENCHMARKS } from '@unified-product-graph/core/intelligence'

Example

// Walk the v0.4 anti-pattern catalogue
import { UPG_ANTI_PATTERNS } from '@unified-product-graph/core/intelligence'

for (const pattern of UPG_ANTI_PATTERNS) {
  console.log(`${pattern.id} — ${pattern.severity}`)
}

Often used with:shapes catalog See guide

45 exports

v0.4 anti-patterns and heuristics. The rules a graph is validated against: UPG_ANTI_PATTERNS for cross-domain health checks, domain guides for per-domain authoring guidance, and benchmarks for stage-appropriate coverage targets. These are the rules the MCP get_anti_pattern and list_anti_patterns tools surface.

Exports

Constants

constUPG_ANTI_PATTERNS#source

readonly UPGCuratedAntiPattern[]

constUPG_COUNT_BENCHMARKS#source

CountBenchmark[]

constUPG_DOMAIN_ACTIVATION#source

DomainActivation[]

constUPG_DOMAIN_GUIDES#source

readonly UPGDomainUsageGuide[]

constUPG_PRODUCT_STAGE_COERCION_MAP#source

Readonly<Record<string, UPGProductStage>>

constUPG_PRODUCT_STAGES#source

readonly ["concept", "validation", "build", "beta", "launch", "growth", "mature", "maintenance", "sunset"]

constUPG_RATIO_BENCHMARKS#source

RatioBenchmark[]

constUPG_RELATIONSHIP_BENCHMARKS#source

RelationshipBenchmark[]

Types

typeIntelligenceCondition#source

type IntelligenceCondition = | { check: | EntityCheck | RelationshipCheck | BenchmarkCheck | TotalEntityCountCheck | DomainCountCheck | DomainPopu...

A structured, machine-evaluable condition for intelligence prompts.

typeStageRange#source

type StageRange = { min: number; max: number } | null

typeUPGAntiPatternSeverity#source

type UPGAntiPatternSeverity = 'high' | 'medium' | 'low'

Severity tier for a curated anti-pattern.

typeUPGBenchmarkSource#source

type UPGBenchmarkSource = | { kind: 'book'; citation: string } /** Attributed to a specific practitioner or method author. */ | { kind: 'practi...

Where a benchmark's range or expectation comes from.

typeUPGProductStage#source

type UPGProductStage = | 'concept' // napkin idea, no validation yet | 'validation' // testing demand, talking to users | 'build' // activel...

Product lifecycle stages.

Interfaces

interfaceAntiPatternInputs#source

interface AntiPatternInputs

Pre-computed graph statistics consumed by the evaluator.

interfaceAntiPatternViolation#source

interface AntiPatternViolation

One fired anti-pattern, lifted from the catalog with prose attached.

interfaceBenchmarkCheck#source

interface BenchmarkCheck

Compare against stage-appropriate benchmark

interfaceCountBenchmark#source

interface CountBenchmark

interfaceDomainActivation#source

interface DomainActivation

interfaceDomainCountCheck#source

interface DomainCountCheck

Count how many distinct UPG domains the graph populates.

interfaceDomainPopulationCheck#source

interface DomainPopulationCheck

Check whether a specific domain has any entities.

interfaceEntityCheck#source

interface EntityCheck

Count entities matching criteria

interfaceEvaluateAntiPatternsOptions#source

interface EvaluateAntiPatternsOptions

interfaceOrphanCheck#source

interface OrphanCheck

Count entities that have no incoming or outgoing edges.

interfaceProductStageCoercion#source

interface ProductStageCoercion

Result of a soft-coercion attempt on a product `stage` value.

interfaceRatioBenchmark#source

interface RatioBenchmark

interfaceRelationshipBenchmark#source

interface RelationshipBenchmark

interfaceRelationshipCheck#source

interface RelationshipCheck

Check relationship existence or count

interfaceTotalEntityCountCheck#source

interface TotalEntityCountCheck

Graph-wide entity-count check, ignoring entity type.

interfaceUPGAntiPattern#source

interface UPGAntiPattern

A common mistake agents make in a domain.

interfaceUPGCuratedAntiPattern#source

interface UPGCuratedAntiPattern

A curated, cross-domain anti-pattern with a machine-evaluable detector.

interfaceUPGDomainBridge#source

interface UPGDomainBridge

interfaceUPGDomainPattern#source

interface UPGDomainPattern

interfaceUPGDomainUsageGuide#source

interface UPGDomainUsageGuide

Functions

functioncoerceProductStage#source

(value: unknown) => ProductStageCoercion

Soft-coerce a stage value to canonical UPGProductStage, falling back to the documented mapping for known legacy values.

functionevaluateAntiPatterns#source

(inputs: AntiPatternInputs, options?: EvaluateAntiPatternsOptions) => AntiPatternViolation[]

Evaluate the curated anti-pattern catalog against a graph's pre-computed stats.

functiongetAnchorEntity#source

(domainId: UPGDomainId | string) => UPGEntityType | undefined

Get the anchor entity for a domain (the entity you create first).

functiongetAntiPatternById#source

(id: string) => UPGCuratedAntiPattern | undefined

Look up a curated anti-pattern by its slug id.

functiongetAntiPatterns#source

() => { domain: "design_system" | "business_model" | "portfolio" | "workspace" | "strategy" | "user" | "discovery" | "validation" | "market_intelligence" | "user_research" | "ux_design" | ... 24 more ... | "compliance"; anti_pattern: UPGAntiPattern; }[]

Get all anti-patterns across all domains, flattened and tagged by domain.

functiongetAntiPatternsBySeverity#source

(severity: UPGAntiPatternSeverity) => readonly UPGCuratedAntiPattern[]

Filter the curated set by severity tier.

functiongetAntiPatternsForStage#source

(stage: UPGProductStage) => readonly UPGCuratedAntiPattern[]

Filter the curated set to anti-patterns relevant at a given product stage.

functiongetBenchmark#source

(entityType: UPGEntityType | string, stage: UPGProductStage) => StageRange

Look up the expected range for a type at a given stage.

functiongetBenchmarksByDomain#source

(domain: UPGDomainId | string) => CountBenchmark[]

Get all benchmarks for a given domain.

functiongetGuideForDomain#source

(domainId: UPGDomainId | string) => UPGDomainUsageGuide | undefined

Look up the usage guide for a domain.

functionisCanonicalProductStage#source

(value: unknown) => boolean

True when `value` is a canonical UPGProductStage.

functionvalidateProductStageStrict#source

(value: unknown) => string | null

Strict validator for the write path.