/** * Feature test files import from `src/` through the `@/` alias, never via * `../` parent traversal (CLAUDE.md "Key Conventions"). A `../` import in a * test file is always reaching across `src/` directories — `@/` keeps those * imports stable under file moves and makes the test's dependencies legible. * * Scoped to feature packages (`packages//src/`, excluding `core-*`): * the convention is part of the feature template's contract. Core packages * are generated and governed by their own templates, and tooling packages * (turbo/generators, scripts) legitimately use relative paths. */ function isFeatureSrcTestFile(filename) { const normalized = filename.replace(/\\/g, "/"); if (!normalized.endsWith(".test.ts") && !normalized.endsWith(".test.tsx")) { return false; } return /\/packages\/(?!core-)[^/]+\/src\//.test(normalized); } /** @type {import("eslint").Rule.RuleModule} */ export default { meta: { type: "problem", docs: { description: "Feature test files must import src modules via the @/ alias, not ../ parent paths.", }, schema: [], messages: { relativeParentImport: 'Test file imports "{{source}}" with a ../ parent path. Use the "@/" alias for src imports (e.g. "@/application/...").', }, }, create(context) { if (!isFeatureSrcTestFile(context.filename)) return {}; return { ImportDeclaration(node) { const source = node.source.value; if (typeof source === "string" && source.startsWith("../")) { context.report({ node: node.source, messageId: "relativeParentImport", data: { source }, }); } }, }; }, };