:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
// The frontend's dependency layers, lowest first. A file may statically import only from its own layer
// or a lower one, so nothing from a higher layer can reach the eager graph of a lower one.
// A higher layer is reached through a dynamic import() instead (lazyWithRetry, retryImport).
export const LAYERS = ['kernel', 'shell', 'query', 'features']
// First match wins. A path that no rule names is a feature, so new code stays off the shell's eager
// path until someone moves it down in a reviewed change.
const RULES = [
['kernel', /^frontend\/src\/queries\/schema\//],
['kernel', /\/generated\//],
[
'kernel',
/^frontend\/src\/lib\/(utils|lemon-ui|ui|api[a-z-]*|constants|dayjs|hooks|colors|posthog-typed)(\/|\.|$)/,
],
['kernel', /^frontend\/src\/(types|initKea|globals)\.tsx?$/],
['kernel', /^frontend\/src\/(styles|vendor)\//],
['kernel', /^frontend\/@posthog\//],
['kernel', /^(common|packages)\//],
['query', /^frontend\/src\/queries\//],
['shell', /^frontend\/src\/(lib|layout|models|taxonomy)\//],
['shell', /^frontend\/src\/scenes\/[^/]+$/],
['shell', /^frontend\/src\/[^/]+$/],
]
export function layerOf(file) {
return RULES.find(([, pattern]) => pattern.test(file))?.[0] ?? 'features'
}
export function isUpward(fromFile, toFile) {
return LAYERS.indexOf(layerOf(toFile)) > LAYERS.indexOf(layerOf(fromFile))
}
// A fixed entry fails too. If it stayed in the baseline, the same upward import could come back unnoticed.
export function compareWithBaseline(current, baseline) {
const added = current.filter((edge) => !baseline.includes(edge))
const fixed = baseline.filter((edge) => !current.includes(edge))
const pruneHint = fixed.length
? `${fixed.length} baseline entries are fixed. Run \`hogli lint:frontend-layers --prune-baseline\` to drop them:\n${fixed.map((edge) => ` ${edge}`).join('\n')}`
: null
const fixHint = added.length
? [
'Fix each new upward import in one of these ways:',
' 1. Move the imported code down to the layer of the importer, or lower.',
' 2. Load it with a dynamic import: lazyWithRetry() or retryImport(() => import(...)).',
' 3. Register it in a registry that the higher layer fills.',
'Never run --update-baseline to hide a new upward import. Run --prune-baseline only after you fix one.',
].join('\n')
: null
return { added, fixed, failed: added.length > 0 || fixed.length > 0, pruneHint, fixHint }
}
export const shortName = (file) => file.replace(/^frontend\/src\//, '')
// Folder a report shows a file under: a product, a lib component, or a top-level folder.
export function groupOf(file) {
const parts = shortName(file).split('/')
if (parts[0] === 'products') {
return parts.slice(0, 2).join('/') + (parts.includes('generated') ? '/generated' : '')
}
if (parts[0] === 'lib' && parts.length > 3) {
return parts.slice(0, 3).join('/')
}
if (parts.length > 2) {
return parts.slice(0, 2).join('/')
}
return parts.length === 2 ? `${parts[0]}/*` : 'src/*'
}