New cyclic dependency between modules (ARCH3328)

Key typescript.architecture.new-dependency · Severity warning · Category architecture

Merge requests only. Flags an import that makes one folder depend on another which, on the default branch, already depends on it (directly or within three steps): the two now depend on each other. Type-only imports do not count; folders most of the codebase depends on, and a folder with its own parent or child, are not counted.

Incorrect

// src/billing/invoice.ts - on the default branch src/shipping already imports src/billing
import { trackParcel } from "../shipping/tracker";

Correct

src/billing/invoice.ts

import type { ShipmentStatus } from "./shipment-status"; // billing owns the contract, shipping implements it