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

package/corpus/e2e/bad-timeout.spec.ts

@@ -0,0 +1,5 @@
+declare const page: { waitForTimeout: (ms: number) => Promise<void> }
+
+export const buys = async (): Promise<void> => {
+  await page.waitForTimeout(2000)
+}

package/corpus/e2e/good-detail-response.spec.ts

@@ -0,0 +1,5 @@
+declare const page: { waitForResponse: (match: RegExp) => Promise<void> }
+
+export const buys = async (): Promise<void> => {
+  await page.waitForResponse(/corpus-orders-one/)
+}

package/corpus/e2e/good-state.spec.ts

@@ -0,0 +1,5 @@
+declare const expectVisible: (name: string) => Promise<void>
+
+export const buys = async (): Promise<void> => {
+  await expectVisible('order placed')
+}

package/corpus/manifest.json

@@ -16,6 +16,7 @@
     "biological-architecture/effect-hook-naming",
     "biological-architecture/emit-declares-attempts",
     "biological-architecture/font-roles-only",
+    "biological-architecture/hermetic-e2e-no-wall-clock-waits",
     "biological-architecture/icon-control-has-name",
     "biological-architecture/layer-walls",
     "biological-architecture/list-take-without-order",
@@ -74,6 +75,7 @@
     "biological-architecture/time-through-the-door",
     "biological-architecture/tissue-must-compose",
     "biological-architecture/tissue-no-data-props",
+    "biological-architecture/tissue-no-fetch",
     "biological-architecture/tissue-no-hooks",
     "biological-architecture/tissue-no-organelles",
     "biological-architecture/tissue-no-stores",

package/corpus/medusa/queries/bad-silent-cap.ts

@@ -0,0 +1,11 @@
+// BREACH: the cap is not a page. The 101st production order is never cancelled, in any order.
+declare const service: {
+  listProductionOrders: (filters: unknown, config: unknown) => Promise<{ id: string }[]>
+}
+declare function cancelOrders(ids: string[]): Promise<void>
+
+export const cancelAll = async (orderId: string): Promise<void> => {
+  const candidates = await service.listProductionOrders({ order_id: orderId }, { take: 100 })
+
+  await cancelOrders(candidates.map((one) => one.id))
+}

package/corpus/medusa/queries/good-paged-through.ts

@@ -0,0 +1,19 @@
+// ACCEPTED: every page names its order and the loop reads pages until one comes back short.
+declare const service: {
+  listProductionOrders: (filters: unknown, config: unknown) => Promise<{ id: string }[]>
+}
+declare function cancelOrders(ids: string[]): Promise<void>
+
+const PAGE = 100
+
+export const cancelAll = async (orderId: string): Promise<void> => {
+  for (let skip = 0; ; skip += PAGE) {
+    const page = await service.listProductionOrders(
+      { order_id: orderId },
+      { order: { id: 'ASC' }, skip, take: PAGE },
+    )
+
+    await cancelOrders(page.map((one) => one.id))
+    if (page.length < PAGE) return
+  }
+}

package/corpus/medusa/queries/integration-tests/any-row.ts

@@ -0,0 +1,10 @@
+// ACCEPTED: a fixture that wants any row; which row comes back does not matter.
+declare const service: {
+  listSalesChannels: (filters: unknown, config: unknown) => Promise<{ id: string }[]>
+}
+
+export const anyChannel = async (): Promise<unknown> => {
+  const [channel] = await service.listSalesChannels({}, { take: 1 })
+
+  return channel
+}

package/corpus/tissues/bad-awaits-data.tsx

@@ -0,0 +1,8 @@
+import { ProductGrid } from '../cells/product-grid'
+import { loadProducts } from '../lib/load-products'
+
+export async function BadAwaitsData() {
+  const products = await loadProducts()
+
+  return <ProductGrid products={products} />
+}

package/corpus/tissues/bad-fetches-data.tsx

@@ -0,0 +1,7 @@
+import { ProductGrid } from '../cells/product-grid'
+
+export function BadFetchesData() {
+  const pending = fetch('/api/products')
+
+  return <ProductGrid pending={pending} />
+}

package/corpus/tissues/good-takes-products.tsx

@@ -0,0 +1,5 @@
+import { ProductGrid } from '../cells/product-grid'
+
+export function GoodTakesProducts({ products }: { products: string[] }) {
+  return <ProductGrid products={products} />
+}

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,26 @@
 // 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 { timingRequested, withTiming } from "./timing.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 timed = timingRequested();
+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: timed ? withTiming(reportingOncePerRun(rule.create, name), name) : reportingOncePerRun(rule.create, name)
+    }
+  ];
 }));
 var { version } = createRequire(import.meta.url)("../package.json");
 var plugin = {
@@ -192,6 +36,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;
+}[];