@geonosis/oxlint-plugin-biological-architecture 3.1.0 → 3.2.0

package/dist/discover-atoms.d.ts

@@ -1,50 +1,15 @@
+import type { Restriction } from './rules/lib/atom-map.js';
 interface AtomMapping {
     atomFile: string;
     atomName: string;
     nativeElement: string;
 }
-interface AtomRestriction {
-    atom: string;
-    element: string;
-    importPath: string;
-}
 interface RestrictedSyntaxEntry {
     message: string;
     selector: string;
 }
-/**
- * Build no-restricted-syntax entries that forbid raw native HTML usage
- * for every native element wrapped by an atom. Apply these entries to
- * molecules, compounds, cells, and tissues (NOT atoms themselves).
- */
 export declare function buildAtomRestrictions(atomsDir: string, importPathPrefix?: string): RestrictedSyntaxEntry[];
-/**
- * Build atom restrictions in the format expected by the no-raw-html-atoms rule.
- * This replaces no-restricted-syntax for linters that don't support it (e.g. oxlint).
- */
-export declare function buildAtomRuleRestrictions(atomsDir: string, importPathPrefix?: string): AtomRestriction[];
-/**
- * Scan the atoms directory and build a mapping from native HTML element
- * to the atom that wraps it. This is used to generate no-restricted-syntax
- * entries that forbid raw native HTML usage in higher-level components.
- *
- * When multiple atoms wrap the same element (e.g. `input.tsx` and
- * `inline-input.tsx` both wrap `<input>`), the atom whose filename
- * exactly matches the element name is preferred as the canonical one.
- * Variants are kept as alternatives in the error message.
- */
+export declare function buildAtomRuleRestrictions(atomsDir: string, importPathPrefix?: string): Restriction[];
 export declare function scanAtomMappings(atomsDir: string): AtomMapping[];
-/**
- * The native element an atom wraps, read from the one place every atom says so: its props type.
- *
- * `ComponentProps<'button'>`, `ComponentPropsWithoutRef<'textarea'>`,
- * `HTMLAttributes<HTMLSelectElement>` and `React.ButtonHTMLAttributes<HTMLButtonElement>` all name
- * the element outright, and an atom that types its props any other way is an atom nobody can
- * compose. The Radix `asChild ? Slot.Root : 'button'` form comes next, and the JSX-tag scan is
- * only the fallback — it was the whole detector once, and on a real tree it returned `string`,
- * `typeof` and `path` while missing every shadcn button in the repo.
- *
- * The name is kept because consumers import it.
- */
 export declare function detectFirstNativeJsxElement(source: string): null | string;
 export {};

package/dist/discover-atoms.js

@@ -3,110 +3,7 @@ import { readdirSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { stripComments } from "./rules/lib/module-text.js";
 var GENERIC_ELEMENTS = new Set(["div", "span"]);
-var HTML_ELEMENTS = new Set([
-  "a",
-  "abbr",
-  "address",
-  "area",
-  "article",
-  "aside",
-  "audio",
-  "b",
-  "bdi",
-  "bdo",
-  "blockquote",
-  "br",
-  "button",
-  "canvas",
-  "caption",
-  "cite",
-  "code",
-  "col",
-  "colgroup",
-  "data",
-  "datalist",
-  "dd",
-  "del",
-  "details",
-  "dfn",
-  "dialog",
-  "div",
-  "dl",
-  "dt",
-  "em",
-  "embed",
-  "fieldset",
-  "figcaption",
-  "figure",
-  "footer",
-  "form",
-  "h1",
-  "h2",
-  "h3",
-  "h4",
-  "h5",
-  "h6",
-  "header",
-  "hgroup",
-  "hr",
-  "i",
-  "iframe",
-  "img",
-  "input",
-  "ins",
-  "kbd",
-  "label",
-  "legend",
-  "li",
-  "main",
-  "map",
-  "mark",
-  "menu",
-  "meter",
-  "nav",
-  "noscript",
-  "object",
-  "ol",
-  "optgroup",
-  "option",
-  "output",
-  "p",
-  "picture",
-  "pre",
-  "progress",
-  "q",
-  "rp",
-  "rt",
-  "ruby",
-  "s",
-  "samp",
-  "search",
-  "section",
-  "select",
-  "small",
-  "source",
-  "span",
-  "strong",
-  "sub",
-  "summary",
-  "sup",
-  "table",
-  "tbody",
-  "td",
-  "template",
-  "textarea",
-  "tfoot",
-  "th",
-  "thead",
-  "time",
-  "tr",
-  "track",
-  "u",
-  "ul",
-  "var",
-  "video",
-  "wbr"
-]);
+var HTML_ELEMENTS = new Set("a abbr address area article aside audio b bdi bdo blockquote br button canvas caption cite code col colgroup data datalist dd del details dfn dialog div dl dt em embed fieldset figcaption figure footer form h1 h2 h3 h4 h5 h6 header hgroup hr i iframe img input ins kbd label legend li main map mark menu meter nav noscript object ol optgroup option output p picture pre progress q rp rt ruby s samp search section select small source span strong sub summary sup table tbody td template textarea tfoot th thead time tr track u ul var video wbr".split(" "));
 var TAG_OF_DOM_INTERFACE = {
   HTMLAnchorElement: "a",
   HTMLAreaElement: "area",

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { ProbeFn } from './rules/lib/probe.js';
+import { type Tier } from './rules/lib/tiers.js';
 export type Rule = {
     create: (context: never) => Record<string, unknown>;
     fixShape: string;
@@ -10,25 +11,15 @@ export type Rule = {
         schema: unknown[];
         type: string;
     };
-    /**
-     * Present only on a rule whose REACH depends on an option. It answers with the smallest source
-     * that must fire the rule under the options it is handed, so a repo whose corpus carries no such
-     * file can still be shown the rule reaching something — and a rule with no probe that fires
-     * nowhere stays a failure, which is the whole point of the check that reads this.
-     */
     probe?: ProbeFn;
-    /**
-     * The engine this rule presumes, and the packages a workspace's manifest proves it with. Present
-     * only on a rule that reaches ONE engine: enabled where the engine is absent, it has zero
-     * possible findings and reads exactly like compliance (#159). Declared once in `presets.ts`.
-     */
     presumes?: {
         engine: string;
         packages: readonly string[];
     };
+    tier?: Tier;
 };
 export declare const rules: Record<string, Rule>;
-export { PRESETS, RENAMED_TO, rulesOfPreset } from './presets.js';
+export { PRESETS, presetSections, RENAMED_TO, rulesOfPreset } from './presets.js';
 export type { Preset, PresetName } from './presets.js';
 declare const plugin: {
     configs: {

package/dist/index.js

@@ -1,182 +1,24 @@
 // src/index.ts
 import { createRequire } from "node:module";
-import { PRESETS, PRESUMED_ENGINES } from "./presets.js";
-import atomNoDeps from "./rules/atom-no-deps.js";
-import boundaryTimeIsPrimitive from "./rules/boundary-time-is-primitive.js";
-import cellMustBeStateful from "./rules/cell-must-be-stateful.js";
-import cellMustNotComposeCell from "./rules/cell-must-not-compose-cell.js";
-import cellNoCrossFeatureOrganelles from "./rules/cell-no-cross-feature-organelles.js";
-import cellNoTissues from "./rules/cell-no-tissues.js";
-import cellsFolderIndexIsBarrel from "./rules/cells-folder-index-is-barrel.js";
-import compoundMustBeStateless from "./rules/compound-must-be-stateless.js";
-import compoundNoStores from "./rules/compound-no-stores.js";
-import constantsInConstantsFile from "./rules/constants-in-constants-file.js";
-import dialectThroughTheSeam from "./rules/dialect-through-the-seam.js";
-import durableBodyReadsThroughSteps from "./rules/durable-body-reads-through-steps.js";
-import effectHookNaming from "./rules/effect-hook-naming.js";
-import emitDeclaresAttempts from "./rules/emit-declares-attempts.js";
-import fontRolesOnly from "./rules/font-roles-only.js";
-import iconControlHasName from "./rules/icon-control-has-name.js";
-import layerWalls from "./rules/layer-walls.js";
+import { PRESETS, PRESUMED_ENGINES, TIER_RULES } from "./presets.js";
+import { registered } from "./registry.js";
 import { reportingOncePerRun } from "./rules/lib/options.js";
-import listTakeWithoutOrder from "./rules/list-take-without-order.js";
-import maxCommentDensity from "./rules/max-comment-density.js";
-import moleculeAtomsOnly from "./rules/molecule-atoms-only.js";
-import moleculeMustCompose from "./rules/molecule-must-compose.js";
-import mutatingStepDeclaresRetry from "./rules/mutating-step-declares-retry.js";
-import namedWhenBlock from "./rules/named-when-block.js";
-import nextRouteSegmentIsThinDelegate from "./rules/next-route-segment-is-thin-delegate.js";
-import noBrandNames from "./rules/no-brand-names.js";
-import noCardShapedDiv from "./rules/no-card-shaped-div.js";
-import noCrossFeatureStores from "./rules/no-cross-feature-stores.js";
-import noD1Transaction from "./rules/no-d1-transaction.js";
-import noDateStringCompare from "./rules/no-date-string-compare.js";
-import noDuplicateJsxPatterns from "./rules/no-duplicate-jsx-patterns.js";
-import noGenericUtilityPackage from "./rules/no-generic-utility-package.js";
-import noHookInComponentDisguise from "./rules/no-hook-in-component-disguise.js";
-import noIndexCountAsExact from "./rules/no-index-count-as-exact.js";
-import noInertHiddenJsx from "./rules/no-inert-hidden-jsx.js";
-import noInlineDataInJsx from "./rules/no-inline-data-in-jsx.js";
-import noInvalidFeatureFolders from "./rules/no-invalid-feature-folders.js";
-import noLoaderSideEffectInIndexFile from "./rules/no-loader-side-effect-in-index-file.js";
-import noLogicInComponentFiles from "./rules/no-logic-in-component-files.js";
-import noMockDbInIntegration from "./rules/no-mock-db-in-integration.js";
-import noOrmOutsideDb from "./rules/no-orm-outside-db.js";
-import noRawHtmlAtoms from "./rules/no-raw-html-atoms.js";
-import noRawSqlOutsideAllowed from "./rules/no-raw-sql-outside-allowed.js";
-import noReactNamespace from "./rules/no-react-namespace.js";
-import noRenamedHtmlProps from "./rules/no-renamed-html-props.js";
-import noRenderPropReader from "./rules/no-render-prop-reader.js";
-import noRuntimeDeadAffordance from "./rules/no-runtime-dead-affordance.js";
-import noSwallowedCatch from "./rules/no-swallowed-catch.js";
-import noTrivialWrapperComponent from "./rules/no-trivial-wrapper-component.js";
-import noTsInBioFolders from "./rules/no-ts-in-bio-folders.js";
-import noTypeDefinitionsInComponents from "./rules/no-type-definitions-in-components.js";
-import noUnregisteredPluginDir from "./rules/no-unregistered-plugin-dir.js";
-import noVoidPort from "./rules/no-void-port.js";
-import organelleDependency from "./rules/organelle-dependency.js";
-import organelleSingleSource from "./rules/organelle-single-source.js";
-import pluginRouteNamespaced from "./rules/plugin-route-namespaced.js";
-import queriesRequireOrgScope from "./rules/queries-require-org-scope.js";
-import queueLoopIsTheLibrary from "./rules/queue-loop-is-the-library.js";
-import routeNoInlineMutation from "./rules/route-no-inline-mutation.js";
-import routerSchemaParity from "./rules/router-schema-parity.js";
-import serviceNameNotReserved from "./rules/service-name-not-reserved.js";
-import ssotNoInlineFacts from "./rules/ssot-no-inline-facts.js";
-import ssotNoProcessEnv from "./rules/ssot-no-process-env.js";
-import stepDeclaresCompensationOrNone from "./rules/step-declares-compensation-or-none.js";
-import stepOpensItsOwnCell from "./rules/step-opens-its-own-cell.js";
-import storeRouteScopesTenantData from "./rules/store-route-scopes-tenant-data.js";
-import subpathOverBarrel from "./rules/subpath-over-barrel.js";
-import subscriberDeclaresId from "./rules/subscriber-declares-id.js";
-import tablesDeclareTheirPlane from "./rules/tables-declare-their-plane.js";
-import tenantTablesCarryOrgId from "./rules/tenant-tables-carry-org-id.js";
-import testNoClockPollingForPromiseFlips from "./rules/test-no-clock-polling-for-promise-flips.js";
-import timeThroughTheDoor from "./rules/time-through-the-door.js";
-import tissueMustCompose from "./rules/tissue-must-compose.js";
-import tissueNoDataProps from "./rules/tissue-no-data-props.js";
-import tissueNoHooks from "./rules/tissue-no-hooks.js";
-import tissueNoOrganelles from "./rules/tissue-no-organelles.js";
-import tissueNoStores from "./rules/tissue-no-stores.js";
-import todoNamesItsPlan from "./rules/todo-names-its-plan.js";
-import tokensOnlyColors from "./rules/tokens-only-colors.js";
-import uniqueQueryStepName from "./rules/unique-query-step-name.js";
-import workerHandlesAreScoped from "./rules/worker-handles-are-scoped.js";
-import zustandV5BestPractices from "./rules/zustand-v5-best-practices.js";
-import { PRESETS as PRESETS2, RENAMED_TO, rulesOfPreset } from "./presets.js";
-var reportingOnce = (declared) => Object.fromEntries(Object.entries(declared).map(([name, rule]) => [
-  name,
-  { ...rule, create: reportingOncePerRun(rule.create) }
-]));
-var withEngines = (declared) => {
-  const presumed = new Map(PRESUMED_ENGINES.flatMap((one) => one.rules.map((name) => [name, { engine: one.engine, packages: one.packages }])));
-  return Object.fromEntries(Object.entries(declared).map(([name, rule]) => {
-    const engine = presumed.get(name);
-    return [name, engine === undefined ? rule : { ...rule, presumes: engine }];
-  }));
-};
-var rules = reportingOnce(withEngines({
-  "atom-no-deps": atomNoDeps,
-  "boundary-time-is-primitive": boundaryTimeIsPrimitive,
-  "cell-must-be-stateful": cellMustBeStateful,
-  "cell-must-not-compose-cell": cellMustNotComposeCell,
-  "cell-no-cross-feature-organelles": cellNoCrossFeatureOrganelles,
-  "cell-no-tissues": cellNoTissues,
-  "cells-folder-index-is-barrel": cellsFolderIndexIsBarrel,
-  "compound-must-be-stateless": compoundMustBeStateless,
-  "compound-no-stores": compoundNoStores,
-  "constants-in-constants-file": constantsInConstantsFile,
-  "dialect-through-the-seam": dialectThroughTheSeam,
-  "durable-body-reads-through-steps": durableBodyReadsThroughSteps,
-  "effect-hook-naming": effectHookNaming,
-  "emit-declares-attempts": emitDeclaresAttempts,
-  "font-roles-only": fontRolesOnly,
-  "icon-control-has-name": iconControlHasName,
-  "layer-walls": layerWalls,
-  "list-take-without-order": listTakeWithoutOrder,
-  "max-comment-density": maxCommentDensity,
-  "molecule-atoms-only": moleculeAtomsOnly,
-  "molecule-must-compose": moleculeMustCompose,
-  "mutating-step-declares-retry": mutatingStepDeclaresRetry,
-  "plugin-route-namespaced": pluginRouteNamespaced,
-  "route-no-inline-mutation": routeNoInlineMutation,
-  "unique-query-step-name": uniqueQueryStepName,
-  "named-when-block": namedWhenBlock,
-  "next-route-segment-is-thin-delegate": nextRouteSegmentIsThinDelegate,
-  "no-brand-names": noBrandNames,
-  "no-card-shaped-div": noCardShapedDiv,
-  "no-cross-feature-stores": noCrossFeatureStores,
-  "no-d1-transaction": noD1Transaction,
-  "no-date-string-compare": noDateStringCompare,
-  "no-duplicate-jsx-patterns": noDuplicateJsxPatterns,
-  "no-generic-utility-package": noGenericUtilityPackage,
-  "no-hook-in-component-disguise": noHookInComponentDisguise,
-  "no-index-count-as-exact": noIndexCountAsExact,
-  "no-inert-hidden-jsx": noInertHiddenJsx,
-  "no-inline-data-in-jsx": noInlineDataInJsx,
-  "no-invalid-feature-folders": noInvalidFeatureFolders,
-  "no-loader-side-effect-in-index-file": noLoaderSideEffectInIndexFile,
-  "no-logic-in-component-files": noLogicInComponentFiles,
-  "no-mock-db-in-integration": noMockDbInIntegration,
-  "no-orm-outside-db": noOrmOutsideDb,
-  "no-raw-html-atoms": noRawHtmlAtoms,
-  "no-raw-sql-outside-allowed": noRawSqlOutsideAllowed,
-  "no-react-namespace": noReactNamespace,
-  "no-renamed-html-props": noRenamedHtmlProps,
-  "no-render-prop-reader": noRenderPropReader,
-  "no-swallowed-catch": noSwallowedCatch,
-  "no-runtime-dead-affordance": noRuntimeDeadAffordance,
-  "no-trivial-wrapper-component": noTrivialWrapperComponent,
-  "no-ts-in-bio-folders": noTsInBioFolders,
-  "no-type-definitions-in-components": noTypeDefinitionsInComponents,
-  "no-unregistered-plugin-dir": noUnregisteredPluginDir,
-  "no-void-port": noVoidPort,
-  "organelle-dependency": organelleDependency,
-  "organelle-single-source": organelleSingleSource,
-  "queries-require-org-scope": queriesRequireOrgScope,
-  "queue-loop-is-the-library": queueLoopIsTheLibrary,
-  "router-schema-parity": routerSchemaParity,
-  "service-name-not-reserved": serviceNameNotReserved,
-  "ssot-no-inline-facts": ssotNoInlineFacts,
-  "ssot-no-process-env": ssotNoProcessEnv,
-  "step-declares-compensation-or-none": stepDeclaresCompensationOrNone,
-  "step-opens-its-own-cell": stepOpensItsOwnCell,
-  "store-route-scopes-tenant-data": storeRouteScopesTenantData,
-  "subpath-over-barrel": subpathOverBarrel,
-  "subscriber-declares-id": subscriberDeclaresId,
-  "tables-declare-their-plane": tablesDeclareTheirPlane,
-  "tenant-tables-carry-org-id": tenantTablesCarryOrgId,
-  "test-no-clock-polling-for-promise-flips": testNoClockPollingForPromiseFlips,
-  "time-through-the-door": timeThroughTheDoor,
-  "tokens-only-colors": tokensOnlyColors,
-  "tissue-must-compose": tissueMustCompose,
-  "tissue-no-data-props": tissueNoDataProps,
-  "tissue-no-hooks": tissueNoHooks,
-  "tissue-no-organelles": tissueNoOrganelles,
-  "tissue-no-stores": tissueNoStores,
-  "todo-names-its-plan": todoNamesItsPlan,
-  "worker-handles-are-scoped": workerHandlesAreScoped,
-  "zustand-v5-best-practices": zustandV5BestPractices
+import { TIERS } from "./rules/lib/tiers.js";
+import { PRESETS as PRESETS2, presetSections, RENAMED_TO, rulesOfPreset } from "./presets.js";
+var presumed = new Map(PRESUMED_ENGINES.flatMap((one) => one.rules.map((name) => [name, { engine: one.engine, packages: one.packages }])));
+var reached = new Map(TIERS.flatMap((tier) => TIER_RULES[tier].map((name) => [name, tier])));
+var rules = Object.fromEntries(Object.entries(registered).map(([name, rule]) => {
+  const presumes = presumed.get(name);
+  const tier = reached.get(name);
+  return [
+    name,
+    {
+      ...rule,
+      ...presumes === undefined ? {} : { presumes },
+      ...tier === undefined ? {} : { tier },
+      create: reportingOncePerRun(rule.create, name)
+    }
+  ];
 }));
 var { version } = createRequire(import.meta.url)("../package.json");
 var plugin = {
@@ -192,6 +34,7 @@ export {
   PRESETS2 as PRESETS,
   RENAMED_TO,
   src_default as default,
+  presetSections,
   rules,
   rulesOfPreset
 };

package/dist/presets.d.ts

@@ -1,30 +1,14 @@
-/**
- * #197: the preset was named after `sagaflow-js`, which `@geonosis/workflows` replaced. A config
- * naming the old name resolves to the same rules until the next major — a rename that breaks every
- * consumer's config the day it ships is a rename nobody adopts — and the reading says so ONCE per
- * process, whatever door read it and however many rules it resolved.
- */
+import type { Tier } from './rules/lib/tiers.js';
 export declare const RENAMED_TO: Record<string, string>;
 export type Preset = {
-    /** Rule ids that belong to this preset but are not ours — enabled alongside, never instead. */
     rules: Record<string, string>;
 };
-/**
- * The engine a rule PRESUMES, and the packages a manifest proves it with.
- *
- * A rule that presumes an engine can sit at "error" over a tree that has none, with zero possible
- * findings, and read exactly like compliance — a Workers + D1 app ran three of these over sagaflow trees
- * (#159). It is written down ONCE, here beside the presets that already knew it, and projected onto
- * the rules so `geonosis-doctor` can ask a workspace's manifest without carrying a second list.
- *
- * The two step rules that appear in `backend-workflows` as well are deliberately NOT here: 026-W2
- * measured them reaching both engines' spellings, and a rule that reaches both presumes neither.
- */
 export declare const PRESUMED_ENGINES: readonly {
     engine: string;
     packages: readonly string[];
     rules: readonly string[];
 }[];
+export declare const TIER_RULES: Record<Tier, readonly string[]>;
 export declare const PRESETS: {
     'backend-d1': {
         rules: Record<string, "error">;
@@ -74,5 +58,13 @@ export declare const PRESETS: {
     };
 };
 export type PresetName = keyof typeof PRESETS;
-/** The rule names a preset carries, stripped of the plugin namespace. */
 export declare const rulesOfPreset: (preset: PresetName) => string[];
+export type PresetDoc = {
+    blurb: string;
+    order: number;
+};
+export declare const presetSections: () => {
+    blurb: string;
+    name: PresetName;
+    order: number;
+}[];

package/dist/presets.js

@@ -34,6 +34,7 @@ var FRONTEND = [
   "organelle-single-source",
   "tissue-must-compose",
   "tissue-no-data-props",
+  "tissue-no-fetch",
   "tissue-no-hooks",
   "tissue-no-organelles",
   "tissue-no-stores",
@@ -84,18 +85,22 @@ var BACKEND_MEDUSA = [
   "subscriber-declares-id",
   "unique-query-step-name"
 ];
+var WORKFLOW_RULES = new Set(BACKEND_WORKFLOWS);
 var FAILURE_PATHS = ["no-swallowed-catch"];
 var INTEGRATIONS = ["no-unregistered-plugin-dir"];
 var BACKEND_TRPC = ["router-schema-parity"];
 var TENANT_SCOPING = [
   "queries-require-org-scope",
-  "store-route-scopes-tenant-data",
   "tables-declare-their-plane",
   "tenant-tables-carry-org-id"
 ];
 var TOOLING = ["layer-walls", "no-generic-utility-package", "todo-names-its-plan"];
 var THEMEKIT = ["font-roles-only", "tokens-only-colors"];
-var TESTBED = ["no-mock-db-in-integration", "test-no-clock-polling-for-promise-flips"];
+var TESTBED = [
+  "hermetic-e2e-no-wall-clock-waits",
+  "no-mock-db-in-integration",
+  "test-no-clock-polling-for-promise-flips"
+];
 var PACKAGE_SUBPATHS = ["subpath-over-barrel"];
 var RULE_PREFIX = "biological-architecture";
 var asRules = (names) => Object.fromEntries(names.map((name) => [`${RULE_PREFIX}/${name}`, "error"]));
@@ -109,9 +114,30 @@ var PRESUMED_ENGINES = [
   {
     engine: "Medusa",
     packages: ["@medusajs/framework", "@medusajs/medusa", "@medusajs/utils"],
-    rules: BACKEND_MEDUSA.filter((name) => !BACKEND_WORKFLOWS.includes(name))
+    rules: BACKEND_MEDUSA.filter((name) => !WORKFLOW_RULES.has(name))
   }
 ];
+var TIER_RULES = {
+  atoms: ["atom-no-deps"],
+  cells: [
+    "cell-must-be-stateful",
+    "cell-must-not-compose-cell",
+    "cell-no-cross-feature-organelles",
+    "cell-no-tissues",
+    "cells-folder-index-is-barrel"
+  ],
+  compounds: ["compound-must-be-stateless", "compound-no-stores"],
+  molecules: ["molecule-atoms-only", "molecule-must-compose"],
+  organelles: ["organelle-dependency", "organelle-single-source"],
+  tissues: [
+    "tissue-must-compose",
+    "tissue-no-data-props",
+    "tissue-no-fetch",
+    "tissue-no-hooks",
+    "tissue-no-organelles",
+    "tissue-no-stores"
+  ]
+};
 var PRESETS = {
   "backend-d1": { rules: asRules(BACKEND_D1) },
   "backend-medusa": { rules: asRules(BACKEND_MEDUSA) },
@@ -136,9 +162,68 @@ var PRESETS = {
   tooling: { rules: asRules(TOOLING) }
 };
 var rulesOfPreset = (preset) => Object.keys(PRESETS[preset].rules).filter((id) => id.startsWith(`${RULE_PREFIX}/`)).map((id) => id.slice(RULE_PREFIX.length + 1));
+var SECTIONS = {
+  frontend: {
+    blurb: "The tier rules every React repo gets. `recommended` is this preset.",
+    order: 1
+  },
+  "backend-workflows": {
+    blurb: "Workflows, the data layer, and single-source-of-truth. Storage-engine facts live in `backend-d1`.",
+    order: 2
+  },
+  "backend-d1": {
+    blurb: "Cloudflare D1 and cell-worker facts. False on any other engine — enable per repo.",
+    order: 3
+  },
+  "backend-workflows-cf": {
+    blurb: "The org workflow engine on Cloudflare Workflows. False next door — an inline run never hibernates.",
+    order: 4
+  },
+  "backend-medusa": { blurb: "Medusa's storefront route surface.", order: 5 },
+  "backend-trpc": {
+    blurb: "The router/schema mirror. A layout convention, not a framework fact — both directories are options, and in one consumer they are in different packages.",
+    order: 6
+  },
+  integrations: {
+    blurb: "The integration seam. Enforces nothing until the repo says where its plugin directories live and which file registers them.",
+    order: 7
+  },
+  "package-subpaths": {
+    blurb: "Where a package's names are imported from. The map is each of the repo's own packages' `exports`, read off disk; `packages` overrides it per package.",
+    order: 8
+  },
+  "tenant-scoping": {
+    blurb: "Every row placed, scoped and narrowed to one organisation.",
+    order: 9
+  },
+  themekit: {
+    blurb: "Conformance with a themekit: the component library never hardcodes what the theme decides. Inert until the repo says how its own tokens are spelled.",
+    order: 10
+  },
+  testbed: {
+    blurb: "The harness. Enforces nothing until the repo says where its integration suites live and what its database module is called.",
+    order: 11
+  },
+  "comment-ceiling": {
+    blurb: "The comment posture. Opt in per repo — the two source repos were defensible and opposite.",
+    order: 12
+  },
+  "failure-paths": {
+    blurb: "The modules a repo cannot afford to fail quietly on. Requires `paths` — which of them fetch and refresh; enabled without it the rule reports that once a run and judges nothing.",
+    order: 13
+  },
+  tooling: {
+    blurb: "A repo's own layers, walled. Enforces nothing until the walls are declared.",
+    order: 14
+  }
+};
+var isPresetName = (name) => (name in PRESETS);
+var presetSections = () => Object.entries(SECTIONS).flatMap(([name, doc]) => isPresetName(name) ? [{ ...doc, name }] : []).toSorted((a, b) => a.order - b.order);
 export {
   PRESETS,
   PRESUMED_ENGINES,
   RENAMED_TO,
+  TIER_RULES,
+  presetSections,
   rulesOfPreset
 };

package/dist/registry.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from './index.js';
+export declare const registered: Record<string, Rule>;