@geonosis/oxlint-plugin-biological-architecture 2.6.1 → 2.8.0

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PRESUMED_ENGINES,
   RENAMED_TO,
   rulesOfPreset
-} from "./chunk-KV7JRNAP.js";
+} from "./chunk-24K5232K.js";
 
 // src/index.ts
 import { createRequire } from "module";
@@ -257,16 +257,6 @@ var requireOption = (rule, value, option, accepts) => {
   }
   return value;
 };
-var requireOptionHere = (rule, value, option, file, accepts) => {
-  if (isMissing(value)) {
-    throw new OptionMissing(
-      rule,
-      option,
-      `${refusalHeader(rule, option)} It is enabled over "${file}", which it would judge, and its \`${option}\` option is ${NOTHING}. Configure \`${option}\`, or turn the rule off for this tree.${accepts === void 0 ? "" : ` It accepts ${accepts}.`}`
-    );
-  }
-  return value;
-};
 var raisedOver = /* @__PURE__ */ new Map();
 var fileOf2 = (context) => {
   const named = context?.filename;
@@ -548,7 +538,12 @@ var cellMustNotComposeCell = directionRule({
   description: "Cells must not import from any other cell anywhere in the repo. No same-feature exception, no shared/document/charts exception. Cells compose only atoms, molecules, compounds, and organelles. Type-only imports are allowed.",
   fixShape: `A cell never composes another cell \u2014 not same-feature, not \`shared/\`, no exception. If you want to,
 one of the two is misclassified: arrangement goes up to a \`tissues/\` file, a stateless display goes
-down to \`compounds/\`, a store adapter goes sideways to \`organelles/\`. Private siblings of the SAME
+down to \`compounds/\`, a store adapter goes sideways to \`organelles/\`. A parent that holds state AND
+hosts a cell (a summary card that opens a modal-hosted form) is two cells side by side: the child
+hosts its own modal and reads whether it is open from the store, the parent writes it, and a
+\`tissues/\` file arranges both. Cells coordinate through a store, never through props from one to
+the other. A stateless adapter between cells is a tissue \u2014 it may take number and boolean layout
+configuration with a literal default (\`step = 10\`). Private siblings of the SAME
 component (\`invoice-editor.parts.tsx\` from \`invoice-editor.tsx\`) are one cell and are fine. The
 barrels \`cells/index.ts\`, \`cells/dynamic.ts\` and \`cells/dynamic.tsx\` are exempt \u2014 re-exporting
 siblings is the shape \`cells-folder-index-is-barrel\` requires of them.`,
@@ -884,155 +879,6 @@ configs. Everywhere else, use the dialect-free aliases the seam exports (\`Datab
 };
 var dialect_through_the_seam_default = dialectThroughTheSeam;
 
-// src/rules/document-sagas-are-generic.ts
-var escapeForRegex = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
-var RULE2 = "document-sagas-are-generic";
-var DEFAULT_FACTORIES = ["saga", "createWorkflow"];
-var perEntityNameOf = (node, factories) => {
-  for (const factory of factories) {
-    const name = literalNamedBy(node, factory);
-    if (name !== null) return name;
-  }
-  return null;
-};
-var declaresAFlow = (text, factories) => factories.some((factory) => new RegExp(`\\b${escapeForRegex(factory)}\\s*\\(`).test(text));
-var documentSagasAreGeneric = {
-  create(context) {
-    const factories = requireOption(
-      RULE2,
-      context.options?.[0]?.factories ?? DEFAULT_FACTORIES,
-      "factories"
-    );
-    const filename = normalise(context.filename);
-    const named = context.options?.[0]?.within;
-    const insideTree = named === void 0 || named === "" ? void 0 : new RegExp(named).test(filename);
-    if (insideTree === false) return {};
-    if (insideTree === void 0 && !declaresAFlow(context.sourceCode?.text ?? "", factories)) {
-      return {};
-    }
-    const prefixes = requireOptionHere(
-      RULE2,
-      context.options?.[0]?.perKindPrefixes,
-      "perKindPrefixes",
-      filename
-    );
-    const within = requireOptionHere(RULE2, named, "within", filename);
-    if (!new RegExp(within).test(filename)) return {};
-    const perKindPrefix = new RegExp(`^(?:${prefixes.map(escapeForRegex).join("|")})\\.`);
-    return {
-      CallExpression(node) {
-        const name = perEntityNameOf(node, factories);
-        if (name === null || !perKindPrefix.test(name)) return;
-        context.report({ data: { name }, messageId: "perKindSaga", node });
-      }
-    };
-  },
-  fixShape: `A saga named for one document kind (\`invoice.issue\`, \`quote.accept\`) is the hand-written fork the
-generic base entity replaced. Mint it from the generic factory \u2014 \`documentSagas(entity, effects)\` \u2014
-and pass the kind as data. The same holds for a workflow: \`createWorkflow('invoice.create', \u2026)\` is
-the fork, \`documentWorkflows(entity)\` is the mint. A name assembled from the entity \u2014 a template
-literal \u2014 is what minting looks like and is left alone by construction. Configure the kind vocabulary
-through \`perKindPrefixes\`, the tree that holds the flows through \`within\` (a regex over the
-filename), and \`factories\` if the repo declares them under other names; enabled without
-\`perKindPrefixes\` or \`within\` the rule refuses the run.`,
-  meta: {
-    floor: { name: "document", pending: true },
-    docs: {
-      description: "Document sagas are minted, not written: `documentSagas(entity, effects)` gives every entity that extends Document its create/save/setStatus/remove/send/convert/duplicate/share from one body. A saga or workflow named with a LITERAL for one entity is a fork; a name assembled from the entity is the mint and is unreadable here on purpose. `factories`, `perKindPrefixes` and `within` are options."
-    },
-    messages: {
-      perKindSaga: '"{{name}}" is a hand-written flow for one entity. Every entity that extends Document gets its sagas from `documentSagas(entity, effects)` and its workflows from the same mint; put what this entity decides in its `Document.extend` definition or in its `DocumentEffects`.'
-    },
-    schema: [
-      {
-        additionalProperties: false,
-        properties: {
-          factories: { items: { type: "string" }, type: "array" },
-          perKindPrefixes: { items: { type: "string" }, type: "array" },
-          within: { type: "string" }
-        },
-        type: "object"
-      }
-    ],
-    type: "problem"
-  },
-  /** Every half comes from the options now: the vocabulary, the tree, and the factory it is minted by. */
-  probe(options) {
-    const { perKindPrefixes = [], within = "" } = bagOf(options);
-    const factory = firstOf(bagOf(options).factories, DEFAULT_FACTORIES);
-    return {
-      path: pathMatching(within, "geonosis-probe-saga.ts"),
-      source: `import { ${factory} } from 'sagaflow-js'
-
-export const geonosisProbe = ${factory}('${perKindPrefixes[0] ?? ""}.geonosis-probe', {})
-`
-    };
-  }
-};
-var document_sagas_are_generic_default = documentSagasAreGeneric;
-
-// src/rules/documents-share-one-table.ts
-var TABLE_CALLEES = ["sqliteTable", "pgTable"];
-var documentsShareOneTable = {
-  create(context) {
-    const perKindTables = new Set(
-      requireOption(
-        "documents-share-one-table",
-        context.options?.[0]?.perKindTables,
-        "perKindTables"
-      )
-    );
-    if (!/\/packages\/db\/src\/schema\//.test(normalise(context.filename))) return {};
-    return {
-      CallExpression(node) {
-        for (const callee of TABLE_CALLEES) {
-          const table = literalNamedBy(node, callee);
-          if (table === null || !perKindTables.has(table)) continue;
-          context.report({ data: { table }, messageId: "perKindTable", node });
-          return;
-        }
-      }
-    };
-  },
-  fixShape: `Every document kind is a row of the one \`documents\` table with a \`kind\` column, not a table of its
-own. A \`pgTable('invoices', \u2026)\` beside a \`pgTable('quotes', \u2026)\` is the second storage the base entity
-retired: write the row, not the table. Both constructors count \u2014 \`pgTable\` and \`sqliteTable\` \u2014 since
-the dialect is a seam fact, not a reason for a kind to own storage. The forbidden table names are the rule's
-\`perKindTables\` option; enabled without it the rule refuses the run rather than passing every
-schema silently.`,
-  meta: {
-    floor: { name: "document", pending: true },
-    docs: {
-      description: "Documents share ONE table: `documents` holds the head every kind derives and the body its kind declares. A table named for one kind of document is a second storage."
-    },
-    messages: {
-      perKindTable: '"{{table}}" is a table for one kind of document. Every kind is a row of `documents` \u2014 add the kind to `documentEntities` and let its `headOf` fill the columns.'
-    },
-    schema: [
-      {
-        additionalProperties: false,
-        properties: {
-          perKindTables: { items: { type: "string" }, type: "array" }
-        },
-        type: "object"
-      }
-    ],
-    type: "problem"
-  },
-  /** The schema directory is compiled in; the forbidden table names are this repo's vocabulary. */
-  probe(options) {
-    const { perKindTables = [] } = bagOf(options);
-    return {
-      path: "packages/db/src/schema/geonosis-probe-table.ts",
-      source: `import { pgTable, text } from 'drizzle-orm/pg-core'
-
-export const geonosisProbe = pgTable('${perKindTables[0] ?? ""}', { id: text('id') })
-`
-    };
-  }
-};
-var documents_share_one_table_default = documentsShareOneTable;
-
 // src/rules/lib/objects.ts
 var propertiesOf = (node) => {
   const object = node;
@@ -1084,7 +930,7 @@ var stepNameOf = (node, config) => {
 };
 
 // src/rules/durable-body-reads-through-steps.ts
-var RULE3 = "durable-body-reads-through-steps";
+var RULE2 = "durable-body-reads-through-steps";
 var ACCEPTS2 = "{ ports: string[] (required), durableKey: string, durableValue: boolean | string, workflowFactories: string[], stepFactories: string[], stepProxies: string[] }";
 var DEFAULT_WORKFLOW_FACTORIES = ["createWorkflow"];
 var DEFAULT_DURABLE_KEY = "execution";
@@ -1116,13 +962,13 @@ var insideAStep = (node, factories) => {
 var durableBodyReadsThroughSteps = {
   create(context) {
     const bag = context.options?.[0] ?? {};
-    const ports = new Set(requireOption(RULE3, bag.ports, "ports", ACCEPTS2));
+    const ports = new Set(requireOption(RULE2, bag.ports, "ports", ACCEPTS2));
     const proxies = new Set(bag.stepProxies ?? []);
-    const steps = stepFactoriesOf(RULE3, bag.stepFactories);
+    const steps = stepFactoriesOf(RULE2, bag.stepFactories);
     const workflows = new Set(
-      requireOption(RULE3, bag.workflowFactories ?? DEFAULT_WORKFLOW_FACTORIES, "workflowFactories")
+      requireOption(RULE2, bag.workflowFactories ?? DEFAULT_WORKFLOW_FACTORIES, "workflowFactories")
     );
-    const durableKey = requireOption(RULE3, bag.durableKey ?? DEFAULT_DURABLE_KEY, "durableKey");
+    const durableKey = requireOption(RULE2, bag.durableKey ?? DEFAULT_DURABLE_KEY, "durableKey");
     const durableValue = bag.durableValue ?? DEFAULT_DURABLE_VALUE;
     return {
       CallExpression(node) {
@@ -1272,7 +1118,7 @@ file and the export together \u2014 half the pair still fires.`,
 var effect_hook_naming_default = effectHookNaming;
 
 // src/rules/emit-declares-attempts.ts
-var RULE4 = "emit-declares-attempts";
+var RULE3 = "emit-declares-attempts";
 var DEFAULT_EMITTERS = ["emitEventStep"];
 var OPTIONS = "options";
 var ATTEMPTS = "attempts";
@@ -1287,7 +1133,7 @@ var valueOf2 = (properties, name) => properties.find((one) => one.key?.type ===
 var emitDeclaresAttempts = {
   create(context) {
     const emitters = new Set(
-      requireOption(RULE4, context.options?.[0]?.emitters ?? DEFAULT_EMITTERS, "emitters")
+      requireOption(RULE3, context.options?.[0]?.emitters ?? DEFAULT_EMITTERS, "emitters")
     );
     const budgetHelpers = new Set(context.options?.[0]?.budgetHelpers ?? []);
     return {
@@ -1957,21 +1803,21 @@ var writesWith = (prefixes) => (node) => {
 var writeNameOf = (node) => propertyNameOf(node.callee ?? {}) ?? "a service write";
 
 // src/rules/mutating-step-declares-retry.ts
-var RULE5 = "mutating-step-declares-retry";
+var RULE4 = "mutating-step-declares-retry";
 var DEFAULT_RETRY_KEY = "maxRetries";
 var DEFAULT_RETRY_LIMIT_KEY = "limit";
 var NO_RETRY2 = 0;
 var mutatingStepDeclaresRetry = {
   create(context) {
-    const factories = stepFactoriesOf(RULE5, context.options?.[0]?.stepFactories);
-    const isWrite = writesWith(mutationPrefixesOf(RULE5, context.options?.[0]?.mutationPrefixes));
+    const factories = stepFactoriesOf(RULE4, context.options?.[0]?.stepFactories);
+    const isWrite = writesWith(mutationPrefixesOf(RULE4, context.options?.[0]?.mutationPrefixes));
     const retryKey = requireOption(
-      RULE5,
+      RULE4,
       context.options?.[0]?.retryKey ?? DEFAULT_RETRY_KEY,
       "retryKey"
     );
     const retryLimitKey = requireOption(
-      RULE5,
+      RULE4,
       context.options?.[0]?.retryLimitKey ?? DEFAULT_RETRY_LIMIT_KEY,
       "retryLimitKey"
     );
@@ -2048,13 +1894,13 @@ the repo wraps \`createStep\`, and \`mutationPrefixes\` if its writes are named
 var mutating_step_declares_retry_default = mutatingStepDeclaresRetry;
 
 // src/rules/named-when-block.ts
-var RULE6 = "named-when-block";
+var RULE5 = "named-when-block";
 var DEFAULT_BLOCKS = ["when"];
 var NAMED = 3;
 var namedWhenBlock = {
   create(context) {
     const blocks = new Set(
-      requireOption(RULE6, context.options?.[0]?.blocks ?? DEFAULT_BLOCKS, "blocks")
+      requireOption(RULE5, context.options?.[0]?.blocks ?? DEFAULT_BLOCKS, "blocks")
     );
     return {
       CallExpression(node) {
@@ -2272,16 +2118,16 @@ var next_route_segment_is_thin_delegate_default = nextRouteSegmentIsThinDelegate
 // src/rules/no-brand-names.ts
 import * as fs3 from "fs";
 var EXEMPT_PATH = /\/examples\//;
-var escapeForRegex2 = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var escapeForRegex = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var noBrandNames = {
   create(context) {
     const { allowedSubstrings = [], brands = [] } = context.options?.[0] ?? {};
     requireOption("no-brand-names", brands, "brands");
     const filename = normalise(context.filename);
     if (EXEMPT_PATH.test(filename)) return {};
-    const brandPattern = new RegExp(`\\b(?:${brands.map(escapeForRegex2).join("|")})\\b`, "i");
+    const brandPattern = new RegExp(`\\b(?:${brands.map(escapeForRegex).join("|")})\\b`, "i");
     const allowedPatterns = allowedSubstrings.map(
-      (allowed) => new RegExp(escapeForRegex2(allowed), "gi")
+      (allowed) => new RegExp(escapeForRegex(allowed), "gi")
     );
     let programNode = null;
     return {
@@ -2780,6 +2626,7 @@ var EXPLICIT_SIDE_EFFECT_HOOKS = /* @__PURE__ */ new Set([
 ]);
 var CUSTOM_EFFECT_HOOK_PATTERN = /^use[A-Z][A-Za-z0-9]*Effect$/;
 var STORE_HOOK_PATTERN = /^use[A-Z][A-Za-z0-9]*Store$/;
+var ANY_HOOK_PATTERN = /^use[A-Z]/;
 function isSideEffectHook(name) {
   if (EXPLICIT_SIDE_EFFECT_HOOKS.has(name)) return true;
   if (CUSTOM_EFFECT_HOOK_PATTERN.test(name)) return true;
@@ -2793,6 +2640,7 @@ var ROUTE_FALLBACK_BASENAMES = /* @__PURE__ */ new Set([
   "loading.tsx",
   "not-found.tsx"
 ]);
+var LAYOUT_BASENAMES = /* @__PURE__ */ new Set(["layout.tsx", "template.tsx"]);
 var R3F_PACKAGES = /* @__PURE__ */ new Set(["@react-three/drei", "@react-three/fiber"]);
 function isPascalCase(name) {
   return /^[A-Z]/.test(name);
@@ -2825,11 +2673,21 @@ function isIdentityFragment(n) {
   return false;
 }
 function classifyReturnShape(arg) {
-  if (isNullLiteral(arg)) return "identity";
-  if (isChildrenIdentifier(arg)) return "identity";
-  if (isIdentityFragment(arg)) return "identity";
+  if (isNullLiteral(arg)) return "null";
+  if (isChildrenIdentifier(arg)) return "passthrough";
+  if (isIdentityFragment(arg)) return "passthrough";
   return "real";
 }
+function recordReturn(scope, arg) {
+  if (!scope) return;
+  const shape = classifyReturnShape(arg);
+  if (shape === "real") {
+    scope.hasNonIdentityReturn = true;
+    return;
+  }
+  scope.hasIdentityReturn = true;
+  if (shape === "passthrough") scope.hasPassthroughReturn = true;
+}
 function suggestedHookName(componentName) {
   const trimmed = componentName.replace(/(Provider|Sync|Listener|Hydration)$/, "");
   const kebab = trimmed.replaceAll(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
@@ -2843,6 +2701,7 @@ var noHookInComponentDisguise = {
     const basename = normalized.split("/").pop() ?? "";
     if (ROUTE_FALLBACK_BASENAMES.has(basename)) return {};
     let fileUsesR3F = false;
+    let fileIsClientBoundary = false;
     const scopeStack = [];
     let pendingName = null;
     function currentScope() {
@@ -2850,9 +2709,11 @@ var noHookInComponentDisguise = {
     }
     function enterFunction(name, node) {
       scopeStack.push({
+        calledAnyHook: false,
         calledHooks: /* @__PURE__ */ new Set(),
         hasIdentityReturn: false,
         hasNonIdentityReturn: false,
+        hasPassthroughReturn: false,
         name,
         node
       });
@@ -2865,14 +2726,16 @@ var noHookInComponentDisguise = {
       if (scope.hasNonIdentityReturn) return;
       if (!scope.hasIdentityReturn) return;
       if (basename === "page.tsx" && scope.calledHooks.size === 0) return;
+      if (fileIsClientBoundary && scope.calledAnyHook && !scope.hasPassthroughReturn) return;
       const hasHooks = scope.calledHooks.size > 0;
+      const passthrough = LAYOUT_BASENAMES.has(basename) ? "passthroughLayout" : "passthroughComponent";
       context.report({
         data: {
           hooks: hasHooks ? [...scope.calledHooks].toSorted((a, b) => a.localeCompare(b)).join(", ") : "",
           name: scope.name,
           suggested: suggestedHookName(scope.name)
         },
-        messageId: hasHooks ? "hookInDisguise" : "passthroughComponent",
+        messageId: hasHooks ? "hookInDisguise" : passthrough,
         node: scope.node
       });
     }
@@ -2882,12 +2745,7 @@ var noHookInComponentDisguise = {
         pendingName = null;
         enterFunction(name, node);
         if (node.body && node.body.type !== "BlockStatement") {
-          const shape = classifyReturnShape(node.body);
-          const scope = currentScope();
-          if (scope) {
-            if (shape === "identity") scope.hasIdentityReturn = true;
-            else scope.hasNonIdentityReturn = true;
-          }
+          recordReturn(currentScope(), node.body);
         }
       },
       "ArrowFunctionExpression:exit"() {
@@ -2899,6 +2757,7 @@ var noHookInComponentDisguise = {
         if (!scope) return;
         const name = node.callee.name;
         if (!name) return;
+        if (ANY_HOOK_PATTERN.test(name)) scope.calledAnyHook = true;
         if (isSideEffectHook(name)) {
           scope.calledHooks.add(name);
         }
@@ -2924,12 +2783,16 @@ var noHookInComponentDisguise = {
           fileUsesR3F = true;
         }
       },
+      // Only the prologue is a directive: the same string after an import is an expression
+      // statement, and React reads it as nothing.
+      Program(node) {
+        for (const statement2 of node.body ?? []) {
+          if (typeof statement2.directive !== "string") break;
+          if (statement2.directive === "use client") fileIsClientBoundary = true;
+        }
+      },
       ReturnStatement(node) {
-        const scope = currentScope();
-        if (!scope) return;
-        const shape = classifyReturnShape(node.argument);
-        if (shape === "identity") scope.hasIdentityReturn = true;
-        else scope.hasNonIdentityReturn = true;
+        recordReturn(currentScope(), node.argument);
       },
       VariableDeclarator(node) {
         if (node.id?.type === "Identifier" && node.init && (node.init.type === "ArrowFunctionExpression" || node.init.type === "FunctionExpression")) {
@@ -2940,14 +2803,19 @@ var noHookInComponentDisguise = {
   },
   fixShape: `A component that calls hooks, renders nothing, and exists only to run an effect is a hook wearing
 \`.tsx\`. Move it to \`organelles/use-<thing>.ts\`, export it as \`use<Thing>\`, and let the cell call it.
-A component returns UI; a hook returns state.`,
+A component returns UI; a hook returns state. The one exception is the client-boundary beacon, for a
+parent that cannot call hooks \u2014 a Server Component, or a tissue: \`'use client'\` as the file's first
+statement, a hook call, and \`return null\`. Render it beside the children, never around them \u2014 a
+component that returns its \`children\` is still a disguise. A component that calls no hook and
+returns nothing is not a beacon either; delete it.`,
   meta: {
     docs: {
-      description: "Forbid components whose body calls side-effect hooks (useEffect/useLayoutEffect/useInsertionEffect/useRef) but whose every return is identity (null, bare `children`, `<></>`, `<>{children}</>`). Such a component renders no real UI \u2014 it's a hook masquerading as a component. Move to organelles/use-*-effect.ts and call the hook from a real component. Exempt: route fallback files (default/not-found/loading/error/global-error.tsx) and files importing from @react-three/fiber or @react-three/drei. That is lint-theater."
+      description: "Forbid components whose body calls side-effect hooks (useEffect/useLayoutEffect/useInsertionEffect/useRef) but whose every return is identity (null, bare `children`, `<></>`, `<>{children}</>`). Such a component renders no real UI \u2014 it's a hook masquerading as a component. Move to organelles/use-*-effect.ts and call the hook from a real component. Exempt: route fallback files (default/not-found/loading/error/global-error.tsx), files importing from @react-three/fiber or @react-three/drei, and the client-boundary beacon \u2014 a 'use client' file whose component calls a hook and returns only null. That is lint-theater."
     },
     messages: {
-      hookInDisguise: "Component '{{name}}' has side-effect hooks ({{hooks}}) but renders only identity/null. It's a hook in disguise \u2014 move to organelles/use-{{suggested}}-effect.ts and call the hook from a real component.",
-      passthroughComponent: "Component '{{name}}' renders only identity/null with no effects. It serves no architectural purpose. If this is a metadata-only layout, move `metadata`/`generateMetadata` to the sibling page.tsx and delete this file. If it's structural, give it real content."
+      hookInDisguise: "Component '{{name}}' has side-effect hooks ({{hooks}}) but renders only identity/null. It's a hook in disguise \u2014 move to organelles/use-{{suggested}}-effect.ts and call the hook from a real component. If its parent cannot call hooks (a Server Component, a tissue), make it the client boundary instead: 'use client' first, and return null \u2014 rendered beside the children, not around them.",
+      passthroughComponent: "Component '{{name}}' renders only identity/null and calls no hook. It serves no architectural purpose: delete it and render its children where it is used, or give it real content.",
+      passthroughLayout: "Component '{{name}}' renders only identity/null with no effects. It serves no architectural purpose. If this is a metadata-only layout, move `metadata`/`generateMetadata` to the sibling page.tsx and delete this file. If it's structural, give it real content."
     },
     schema: [],
     type: "problem"
@@ -2956,20 +2824,20 @@ A component returns UI; a hook returns state.`,
 var no_hook_in_component_disguise_default = noHookInComponentDisguise;
 
 // src/rules/no-index-count-as-exact.ts
-var RULE7 = "no-index-count-as-exact";
+var RULE6 = "no-index-count-as-exact";
 var DEFAULT_ESTIMATE_FIELDS = ["estimate_count", "count_estimate"];
 var DEFAULT_LABEL_KEY = "count_is_estimate";
 var noIndexCountAsExact = {
   create(context) {
     const fields = new Set(
       requireOption(
-        RULE7,
+        RULE6,
         context.options?.[0]?.estimateFields ?? DEFAULT_ESTIMATE_FIELDS,
         "estimateFields"
       )
     );
     const label = requireOption(
-      RULE7,
+      RULE6,
       context.options?.[0]?.labelKey ?? DEFAULT_LABEL_KEY,
       "labelKey"
     );
@@ -3176,10 +3044,31 @@ var VALID_FOLDERS = /* @__PURE__ */ new Set([
   "tissues"
 ]);
 var FEATURE_PATH_PATTERN = /features\/([^/]+)\/([^/]+)\//;
+var folderUnderRoot = (normalized, roots) => {
+  const path2 = `/${normalized}`;
+  for (const declared of roots) {
+    const root = declared.replaceAll(/^\/+|\/+$/g, "");
+    const at = path2.indexOf(`/${root}/`);
+    if (root === "" || at === -1) continue;
+    const rest = path2.slice(at + root.length + 2);
+    const slash = rest.indexOf("/");
+    if (slash !== -1) return { folder: rest.slice(0, slash), root };
+  }
+  return void 0;
+};
 var noInvalidFeatureFolders = {
   create(context) {
     const normalized = normalise(context.filename);
     const match = normalized.match(FEATURE_PATH_PATTERN);
+    const { roots = [] } = context.options?.[0] ?? {};
+    const underRoot = match ? void 0 : folderUnderRoot(normalized, roots);
+    if (underRoot && underRoot.folder !== "features" && !VALID_FOLDERS.has(underRoot.folder)) {
+      return {
+        Program(node) {
+          context.report({ data: underRoot, messageId: "untiered", node });
+        }
+      };
+    }
     if (!match) return {};
     const feature = match[1] ?? "";
     const folder = match[2] ?? "";
@@ -3209,36 +3098,48 @@ var noInvalidFeatureFolders = {
   fixShape: `A feature folder holds only the tiers and their two neighbours: \`atoms\`, \`molecules\`, \`compounds\`,
 \`organelles\`, \`cells\`, \`tissues\`, \`stores\`, \`lib\`. Anything else (\`components\`, \`utils\`, \`helpers\`,
 \`types\`) is an unclassified pile \u2014 put the file in the tier that describes what it does, and pure
-logic in \`lib/\`.`,
+logic in \`lib/\`. A repo whose components live outside \`features/\` names those directories in
+\`roots\` (default: none), and the same holds directly under each one. An unmigrated folder there
+(\`organisms/\`) is a finding per file \u2014 debt the ratchet counts, never a place to park a file whose
+tier would not accept it.`,
   meta: {
     docs: {
-      description: 'Files inside features/*/ must be in a valid biological hierarchy folder. Hooks (use-*) must be in organelles/, not lib/. Folders like "dynamic", "utils", "helpers", "components", "hooks" are forbidden.'
+      description: 'Files inside features/*/ \u2014 and directly under each directory the `roots` option declares \u2014 must be in a valid biological hierarchy folder. Hooks (use-*) must be in organelles/, not lib/. Folders like "dynamic", "utils", "helpers", "components", "hooks" are forbidden.'
     },
     messages: {
       hookInLib: 'Hook file "{{file}}" is in features/{{feature}}/lib/ but hooks must be in features/{{feature}}/organelles/. lib/ is for pure logic only \u2014 no hooks, no state.',
-      invalid: 'File is in "features/{{feature}}/{{folder}}/" which is not a valid biological hierarchy folder. Valid folders: compounds, organelles, cells, tissues, stores, lib.'
+      invalid: 'File is in "features/{{feature}}/{{folder}}/" which is not a valid biological hierarchy folder. Valid folders: compounds, organelles, cells, tissues, stores, lib.',
+      untiered: 'File is in "{{root}}/{{folder}}/", which is not a tier, so no tier rule inspects it. Move it to the tier that describes what it does: atoms, molecules, compounds, organelles, cells, tissues, stores or lib.'
     },
-    schema: [],
+    schema: [
+      {
+        additionalProperties: false,
+        properties: {
+          roots: { items: { type: "string" }, type: "array" }
+        },
+        type: "object"
+      }
+    ],
     type: "problem"
   }
 };
 var no_invalid_feature_folders_default = noInvalidFeatureFolders;
 
 // src/rules/no-loader-side-effect-in-index-file.ts
-var RULE8 = "no-loader-side-effect-in-index-file";
+var RULE7 = "no-loader-side-effect-in-index-file";
 var DEFAULT_DIRECTORIES = ["(?:^|/)subscribers/", "(?:^|/)jobs/"];
 var DEFAULT_RESOURCE_FACTORIES = ["createWorkflow", "createStep", "createHook"];
 var INDEX = /(?:^|\/)index\.[cm]?[jt]sx?$/;
 var noLoaderSideEffectInIndexFile = {
   create(context) {
     const directories = requireOption(
-      RULE8,
+      RULE7,
       context.options?.[0]?.directories ?? DEFAULT_DIRECTORIES,
       "directories"
     ).map((source) => new RegExp(source));
     const factories = new Set(
       requireOption(
-        RULE8,
+        RULE7,
         context.options?.[0]?.resourceFactories ?? DEFAULT_RESOURCE_FACTORIES,
         "resourceFactories"
       )
@@ -3401,7 +3302,7 @@ the same component. Thin preset wrappers over one imported component do not coun
 var no_logic_in_component_files_default = noLogicInComponentFiles;
 
 // src/rules/no-mock-db-in-integration.ts
-var RULE9 = "no-mock-db-in-integration";
+var RULE8 = "no-mock-db-in-integration";
 var BUN_MOCK = "mock.module";
 var MOCK_CALLS = /* @__PURE__ */ new Set(["jest.mock", BUN_MOCK, "vi.mock"]);
 var calleeOf = (node) => {
@@ -3419,8 +3320,8 @@ var inDirectory = (filename, directory) => {
 var noMockDbInIntegration = {
   create(context) {
     const options = context.options?.[0] ?? {};
-    const dirs = requireOption(RULE9, options.integrationDirs, "integrationDirs");
-    const modules = requireOption(RULE9, options.dbModules, "dbModules");
+    const dirs = requireOption(RULE8, options.integrationDirs, "integrationDirs");
+    const modules = requireOption(RULE8, options.dbModules, "dbModules");
     const mockNames = new Set(options.mockNames ?? []);
     const filename = normalise(context.filename);
     const spans = /* @__PURE__ */ new Set();
@@ -3521,14 +3422,14 @@ below the seam, and a caller that names it has crossed it.`,
 var no_orm_outside_db_default = noOrmOutsideDb;
 
 // src/rules/no-raw-html-atoms.ts
-var RULE10 = "no-raw-html-atoms";
+var RULE9 = "no-raw-html-atoms";
 var WHERE_RAW_HTML_IS_THE_POINT = "atoms";
 var noRawHtmlAtoms = {
   create(context) {
-    const restrictions = requireOption(RULE10, context.options[0], "element\u2192atom map");
+    const restrictions = requireOption(RULE9, context.options[0], "element\u2192atom map");
     const scope = context.options[1]?.scope;
     const filename = context.filename;
-    const inScope = scope === void 0 ? !inTier(filename, WHERE_RAW_HTML_IS_THE_POINT) : requireTiers(RULE10, scope).some((tier) => inTier(filename, tier));
+    const inScope = scope === void 0 ? !inTier(filename, WHERE_RAW_HTML_IS_THE_POINT) : requireTiers(RULE9, scope).some((tier) => inTier(filename, tier));
     if (!inScope) return {};
     const elementMap = /* @__PURE__ */ new Map();
     for (const r of restrictions) {
@@ -4178,7 +4079,7 @@ var no_type_definitions_in_components_default = noTypeDefinitionsInComponents;
 
 // src/rules/no-unregistered-plugin-dir.ts
 import { readFileSync as readFileSync4 } from "fs";
-var RULE11 = "no-unregistered-plugin-dir";
+var RULE10 = "no-unregistered-plugin-dir";
 var ACCEPTS3 = "{ roots: (string | { path: string, files: boolean })[], registry: string | string[], manifests: string[] }";
 var trimSlashes = (path2) => path2.replace(/^\/+/, "").replace(/\/+$/, "");
 var withoutComments = (source) => source.replaceAll(/\/\*[\s\S]*?\*\//g, " ").replaceAll(/\/\/[^\n]*/g, " ");
@@ -4206,12 +4107,12 @@ var oneFile = (segments) => {
 var noUnregisteredPluginDir = {
   create(context) {
     const options = context.options?.[0] ?? {};
-    const roots = requireOption(RULE11, options.roots, "roots", ACCEPTS3).map(
+    const roots = requireOption(RULE10, options.roots, "roots", ACCEPTS3).map(
       (one) => typeof one === "string" ? { files: false, path: trimSlashes(one) } : { files: one.files === true, path: trimSlashes(one.path) }
     );
-    const declared = requireOption(RULE11, options.registry, "registry", ACCEPTS3);
+    const declared = requireOption(RULE10, options.registry, "registry", ACCEPTS3);
     const registries = (typeof declared === "string" ? [declared] : declared).map(trimSlashes);
-    const manifests = new Set(requireOption(RULE11, options.manifests, "manifests", ACCEPTS3));
+    const manifests = new Set(requireOption(RULE10, options.manifests, "manifests", ACCEPTS3));
     const filename = normalise(context.filename);
     return {
       Program(node) {
@@ -4488,16 +4389,16 @@ source. The CELL is the only level where several sources meet; it derives and pa
 var organelle_single_source_default = organelleSingleSource;
 
 // src/rules/plugin-route-namespaced.ts
-var RULE12 = "plugin-route-namespaced";
+var RULE11 = "plugin-route-namespaced";
 var DEFAULT_SCOPES = ["store", "admin"];
 var ROUTE_FILE = /(?:^|\/)api\/(.+\/)?route\.[cm]?[jt]sx?$/;
 var NAMESPACED_FROM = 2;
 var readPackages = (configured) => {
-  const rules2 = requireOption(RULE12, configured, "packages");
+  const rules2 = requireOption(RULE11, configured, "packages");
   for (const rule of rules2) {
     if (typeof rule.under !== "string" || rule.under === "") {
       throw new Error(
-        `biological-architecture/${RULE12}: every \`packages\` entry needs \`under\` \u2014 the directory whose children are packages. Without it the rule cannot tell which files belong to a plugin.`
+        `biological-architecture/${RULE11}: every \`packages\` entry needs \`under\` \u2014 the directory whose children are packages. Without it the rule cannot tell which files belong to a plugin.`
       );
     }
   }
@@ -4524,7 +4425,7 @@ var pluginRouteNamespaced = {
   create(context) {
     const rules2 = readPackages(context.options?.[0]?.packages);
     const scopes = new Set(
-      requireOption(RULE12, context.options?.[0]?.scopes ?? DEFAULT_SCOPES, "scopes")
+      requireOption(RULE11, context.options?.[0]?.scopes ?? DEFAULT_SCOPES, "scopes")
     );
     const path2 = normalise(context.filename);
     const route = routePathOf(path2);
@@ -4710,8 +4611,55 @@ decides what an event MEANS and throws when it cannot.`,
 };
 var queue_loop_is_the_library_default = queueLoopIsTheLibrary;
 
+// src/rules/retired.ts
+var SINCE = "2.7.0";
+var REASON = "it enforced one consumer's document kinds, which is vocabulary the kit does not hold";
+var announced = /* @__PURE__ */ new Set();
+var retired = (name, schema) => ({
+  create: () => {
+    if (!announced.has(name)) {
+      announced.add(name);
+      process.stderr.write(
+        `biological-architecture: rule "${name}" is retired since ${SINCE} \u2014 ${REASON}. It reports nothing and goes at the next major. Remove it from your config.
+`
+      );
+    }
+    return {};
+  },
+  fixShape: `\`${name}\` is retired since ${SINCE} and reports nothing. Remove it from the config.`,
+  meta: {
+    docs: {
+      description: `Retired since ${SINCE}: ${REASON}. Reports nothing; goes at the next major.`
+    },
+    messages: {},
+    retired: { reason: REASON, since: SINCE },
+    schema,
+    type: "problem"
+  }
+});
+var RETIRED_RULES = {
+  "document-sagas-are-generic": retired("document-sagas-are-generic", [
+    {
+      additionalProperties: false,
+      properties: {
+        factories: { items: { type: "string" }, type: "array" },
+        perKindPrefixes: { items: { type: "string" }, type: "array" },
+        within: { type: "string" }
+      },
+      type: "object"
+    }
+  ]),
+  "documents-share-one-table": retired("documents-share-one-table", [
+    {
+      additionalProperties: false,
+      properties: { perKindTables: { items: { type: "string" }, type: "array" } },
+      type: "object"
+    }
+  ])
+};
+
 // src/rules/route-no-inline-mutation.ts
-var RULE13 = "route-no-inline-mutation";
+var RULE12 = "route-no-inline-mutation";
 var DEFAULT_PATHS = [String.raw`(?:^|/)api/.*/route\.[cm]?[jt]sx?$`];
 var DEFAULT_INLINE_MUTATION_OK = "arch:inline-mutation-ok";
 var commentsOf2 = (sourceCode) => sourceCode?.getAllComments?.() ?? sourceCode?.ast?.comments ?? [];
@@ -4755,15 +4703,15 @@ var annotated = (found, comments, marker) => {
 };
 var routeNoInlineMutation = {
   create(context) {
-    const paths = requireOption(RULE13, context.options?.[0]?.paths ?? DEFAULT_PATHS, "paths").map(
+    const paths = requireOption(RULE12, context.options?.[0]?.paths ?? DEFAULT_PATHS, "paths").map(
       (source) => new RegExp(source)
     );
     const marker = requireOption(
-      RULE13,
+      RULE12,
       context.options?.[0]?.inlineMutationOk ?? DEFAULT_INLINE_MUTATION_OK,
       "inlineMutationOk"
     );
-    const isWrite = writesWith(mutationPrefixesOf(RULE13, context.options?.[0]?.mutationPrefixes));
+    const isWrite = writesWith(mutationPrefixesOf(RULE12, context.options?.[0]?.mutationPrefixes));
     const filename = normalise(context.filename);
     if (!paths.some((pattern) => pattern.test(filename))) return {};
     return {
@@ -4833,7 +4781,7 @@ var route_no_inline_mutation_default = routeNoInlineMutation;
 
 // src/rules/router-schema-parity.ts
 import { existsSync as existsSync2 } from "fs";
-var RULE14 = "router-schema-parity";
+var RULE13 = "router-schema-parity";
 var EXTENSIONS2 = [".ts", ".tsx"];
 var trimSlashes2 = (path2) => path2.replace(/^\/+/, "").replace(/\/+$/, "");
 var baseOf = (file) => file.replace(/\.[cm]?[jt]sx?$/, "");
@@ -4851,8 +4799,8 @@ var directlyUnder = (filename, directory) => {
 var routerSchemaParity = {
   create(context) {
     const options = context.options?.[0] ?? {};
-    const routers = trimSlashes2(requireOption(RULE14, options.routers, "routers"));
-    const schemas = trimSlashes2(requireOption(RULE14, options.schemas, "schemas"));
+    const routers = trimSlashes2(requireOption(RULE13, options.routers, "routers"));
+    const schemas = trimSlashes2(requireOption(RULE13, options.schemas, "schemas"));
     const suffix = options.suffix ?? "";
     const ignored = new Set(options.ignore ?? []);
     const mounts = options.mounts ?? {};
@@ -4924,7 +4872,7 @@ repo-root-relative, because in one consumer they live in different packages.`,
 var router_schema_parity_default = routerSchemaParity;
 
 // src/rules/service-name-not-reserved.ts
-var RULE15 = "service-name-not-reserved";
+var RULE14 = "service-name-not-reserved";
 var DEFAULT_MODULE_FACTORIES = ["Module"];
 var MODULES_2_19 = [
   "analytics",
@@ -4964,13 +4912,13 @@ var serviceNameNotReserved = {
   create(context) {
     const factories = new Set(
       requireOption(
-        RULE15,
+        RULE14,
         context.options?.[0]?.moduleFactories ?? DEFAULT_MODULE_FACTORIES,
         "moduleFactories"
       )
     );
     const reserved = new Set(
-      requireOption(RULE15, context.options?.[0]?.reserved ?? MODULES_2_19, "reserved")
+      requireOption(RULE14, context.options?.[0]?.reserved ?? MODULES_2_19, "reserved")
     );
     const constants = /* @__PURE__ */ new Map();
     const pending = [];
@@ -5281,12 +5229,12 @@ can be misspelled and a second default nobody agreed to.`,
 var ssot_no_process_env_default = ssotNoProcessEnv;
 
 // src/rules/step-declares-compensation-or-none.ts
-var RULE16 = "step-declares-compensation-or-none";
+var RULE15 = "step-declares-compensation-or-none";
 var NO_COMPENSATION = "noCompensation";
 var WITH_COMPENSATION = 3;
 var stepDeclaresCompensationOrNone = {
   create(context) {
-    const factories = stepFactoriesOf(RULE16, context.options?.[0]?.stepFactories);
+    const factories = stepFactoriesOf(RULE15, context.options?.[0]?.stepFactories);
     return {
       CallExpression(node) {
         if (!isStepCall(node, factories)) return;
@@ -5330,7 +5278,7 @@ variable \u2014 passes, since the flag may be in the base. Configure \`stepFacto
 var step_declares_compensation_or_none_default = stepDeclaresCompensationOrNone;
 
 // src/rules/step-opens-its-own-cell.ts
-var RULE17 = "step-opens-its-own-cell";
+var RULE16 = "step-opens-its-own-cell";
 var STEP = "step";
 var ACCEPTS4 = "{ within: string (required), hosts: string[], scopeKey: string, engine: string, wrapper: string }";
 var DEFAULT_HOSTS = ["createRuntime", "entrypointFor"];
@@ -5365,9 +5313,9 @@ var declaresScope = (call, scopeKey) => {
 var stepOpensItsOwnCell = {
   create(context) {
     const bag = context.options?.[0] ?? {};
-    const within = requireOption(RULE17, bag.within, "within", ACCEPTS4);
-    const hosts = new Set(requireOption(RULE17, bag.hosts ?? DEFAULT_HOSTS, "hosts", ACCEPTS4));
-    const scopeKey = requireOption(RULE17, bag.scopeKey ?? DEFAULT_SCOPE_KEY, "scopeKey", ACCEPTS4);
+    const within = requireOption(RULE16, bag.within, "within", ACCEPTS4);
+    const hosts = new Set(requireOption(RULE16, bag.hosts ?? DEFAULT_HOSTS, "hosts", ACCEPTS4));
+    const scopeKey = requireOption(RULE16, bag.scopeKey ?? DEFAULT_SCOPE_KEY, "scopeKey", ACCEPTS4);
     const { engine, wrapper } = bag;
     const filename = normalise(context.filename);
     if (!new RegExp(within).test(filename)) return {};
@@ -5470,7 +5418,7 @@ without \`within\` the rule refuses the run.`,
     const path2 = pathMatching(within, "geonosis-probe-engine-step.ts");
     if (wrapper !== void 0 && new RegExp(wrapper).test(path2)) {
       throw new Error(
-        `biological-architecture/${RULE17}: the probe path "${path2}" is also the \`wrapper\`, which is the one file allowed to reach \`${engine}\` \u2014 no single file inside \`within\` can both land where the rule looks and be somewhere it speaks.`
+        `biological-architecture/${RULE16}: the probe path "${path2}" is also the \`wrapper\`, which is the one file allowed to reach \`${engine}\` \u2014 no single file inside \`within\` can both land where the rule looks and be somewhere it speaks.`
       );
     }
     return {
@@ -5675,10 +5623,10 @@ data, it belongs on the admin surface.`,
 var store_route_scopes_tenant_data_default = storeRouteScopesTenantData;
 
 // src/rules/subpath-over-barrel.ts
-var RULE18 = "subpath-over-barrel";
+var RULE17 = "subpath-over-barrel";
 var ACCEPTS5 = "{ packages: { name: string, subpaths: { [subpath: string]: string[] } }[] (required) }";
 var homesOf = (declared) => {
-  const subpaths = requireOption(RULE18, Object.keys(declared.subpaths ?? {}), "subpaths", ACCEPTS5);
+  const subpaths = requireOption(RULE17, Object.keys(declared.subpaths ?? {}), "subpaths", ACCEPTS5);
   return new Map(
     subpaths.flatMap(
       (subpath) => (declared.subpaths?.[subpath] ?? []).map((name) => [name, subpath])
@@ -5701,9 +5649,9 @@ var importedNamesOf = (node) => {
 };
 var subpathOverBarrel = {
   create(context) {
-    const declared = requireOption(RULE18, context.options?.[0]?.packages, "packages", ACCEPTS5);
+    const declared = requireOption(RULE17, context.options?.[0]?.packages, "packages", ACCEPTS5);
     const homes = new Map(
-      declared.map((one) => [requireOption(RULE18, one.name, "name", ACCEPTS5), homesOf(one)])
+      declared.map((one) => [requireOption(RULE17, one.name, "name", ACCEPTS5), homesOf(one)])
     );
     return {
       ImportDeclaration(node) {
@@ -5773,7 +5721,7 @@ is a type-only import, which erases before any of that happens. Declare the map
     const [exported] = first?.subpaths?.[subpath ?? ""] ?? [];
     if (exported === void 0) {
       throw new Error(
-        `biological-architecture/${RULE18}: the configured packages declare no subpath with a name in it, so there is nothing a probe could import from the root.`
+        `biological-architecture/${RULE17}: the configured packages declare no subpath with a name in it, so there is nothing a probe could import from the root.`
       );
     }
     return {
@@ -5788,7 +5736,7 @@ export const geonosisProbe = ${exported}
 var subpath_over_barrel_default = subpathOverBarrel;
 
 // src/rules/subscriber-declares-id.ts
-var RULE19 = "subscriber-declares-id";
+var RULE18 = "subscriber-declares-id";
 var DEFAULT_PATHS2 = ["(?:^|/)subscribers/"];
 var CONFIG = "config";
 var CONTEXT = "context";
@@ -5802,7 +5750,7 @@ var declaredName2 = (node) => {
 };
 var subscriberDeclaresId = {
   create(context) {
-    const paths = requireOption(RULE19, context.options?.[0]?.paths ?? DEFAULT_PATHS2, "paths").map(
+    const paths = requireOption(RULE18, context.options?.[0]?.paths ?? DEFAULT_PATHS2, "paths").map(
       (source) => new RegExp(source)
     );
     const filename = normalise(context.filename);
@@ -6065,7 +6013,7 @@ are tests is \`testGlobs\` and which calls poll is \`pollers\`, both defaulted.`
 var test_no_clock_polling_for_promise_flips_default = testNoClockPollingForPromiseFlips;
 
 // src/rules/time-through-the-door.ts
-var RULE20 = "time-through-the-door";
+var RULE19 = "time-through-the-door";
 var ACCEPTS6 = "{ door: string (a regex over the filename), exempt: string[] (regex sources, default the test paths: __tests__/, .test., .spec.), libraries: string[] (default ['dayjs']) }";
 var DEFAULT_LIBRARIES = ["dayjs"];
 var DEFAULT_EXEMPT = ["__tests__/", String.raw`\.test\.`, String.raw`\.spec\.`];
@@ -6093,11 +6041,11 @@ var memberName = (callee) => ({
 var readable2 = (pattern) => pattern.replaceAll("\\", "").replace(/\$$/, "");
 var timeThroughTheDoor = {
   create(context) {
-    const door = requireOption(RULE20, context.options?.[0]?.door, "door", ACCEPTS6);
+    const door = requireOption(RULE19, context.options?.[0]?.door, "door", ACCEPTS6);
     const exempt = context.options?.[0]?.exempt ?? DEFAULT_EXEMPT;
     const exemptModules = context.options?.[0]?.exemptModules ?? [];
     const libraries = requireOption(
-      RULE20,
+      RULE19,
       context.options?.[0]?.libraries ?? DEFAULT_LIBRARIES,
       "libraries",
       ACCEPTS6
@@ -6201,7 +6149,7 @@ it internally cannot be tested at a chosen instant.`,
     );
     if (outside === void 0) {
       throw new Error(
-        `biological-architecture/${RULE20}: every path a probe could be written at is inside the \`door\` (${door}) or one of its \`exempt\` patterns, so there is nowhere left for this rule to speak.`
+        `biological-architecture/${RULE19}: every path a probe could be written at is inside the \`door\` (${door}) or one of its \`exempt\` patterns, so there is nowhere left for this rule to speak.`
       );
     }
     return {
@@ -6409,6 +6357,12 @@ function isAllowedType(t) {
       return true;
   }
 }
+var literalDefaultsOf = (param) => new Map(
+  (param.properties ?? []).flatMap(
+    (property) => property.type === "Property" && property.key?.type === "Identifier" && property.value?.type === "AssignmentPattern" && property.value.right?.type === "Literal" ? [[property.key.name ?? "", property.value.right.value]] : []
+  )
+);
+var isLayoutConfiguration = (t, defaults, prop) => t.type === "TSNumberKeyword" && typeof defaults.get(prop) === "number" || t.type === "TSBooleanKeyword" && typeof defaults.get(prop) === "boolean";
 var tissueNoDataProps = {
   create(context) {
     const normalized = normalise(context.filename);
@@ -6424,6 +6378,7 @@ var tissueNoDataProps = {
       const typeLiteral = firstParam.typeAnnotation?.typeAnnotation;
       if (!typeLiteral || typeLiteral.type !== "TSTypeLiteral") return;
       const members = typeLiteral.members ?? [];
+      const defaults = literalDefaultsOf(firstParam);
       for (const member of members) {
         if (member.key?.type !== "Identifier") continue;
         const propName = member.key.name ?? "";
@@ -6432,6 +6387,7 @@ var tissueNoDataProps = {
         const t = member.typeAnnotation?.typeAnnotation;
         if (!t) continue;
         if (isAllowedType(t)) continue;
+        if (isLayoutConfiguration(t, defaults, propName)) continue;
         context.report({
           data: { prop: propName, type: describeTypeAnnotation(t) },
           messageId: "dataProp",
@@ -6471,13 +6427,14 @@ var tissueNoDataProps = {
   fixShape: `A tissue takes \`children\`, ReactNode slot props, layout variants, \`params\` and \`searchParams\` \u2014 and
 nothing else. A prop typed \`string\`, \`number\`, an array or a domain type (\`id\`, \`initialData\`,
 \`documents\`) means the file owns data, which makes it a CELL: move it to \`cells/\`. A tissue gets its
-content as slots, never as data.`,
+content as slots, never as data. Layout configuration is not data: a \`number\` or \`boolean\` prop the
+tissue gives a literal default (\`{ step = 10, wrap = false }\`) is allowed.`,
   meta: {
     docs: {
       description: "Tissues must not own data. Props on a tissue must be limited to `children`, ReactNode slot props, `params`, `searchParams`, icon types, or layout-variant literal unions. Any primitive (`string`/`number`/`boolean`), array type, or arbitrary domain type reference means the file is actually a cell \u2014 move it to cells/. That is lint-theater.2 (Tissue self-sufficiency rule)."
     },
     messages: {
-      dataProp: "Tissue prop '{{prop}}' has type '{{type}}' which is not allowed on a tissue. Tissues arrange children without owning data. Move the file from features/*/tissues/ to features/*/cells/ \u2014 cells own data. Allowed tissue props: children, params, searchParams, ReactNode slots, literal-union variants, icon types."
+      dataProp: "Tissue prop '{{prop}}' has type '{{type}}' which is not allowed on a tissue. Tissues arrange children without owning data. Move the file from features/*/tissues/ to features/*/cells/ \u2014 cells own data. Allowed tissue props: children, params, searchParams, ReactNode slots, literal-union variants, icon types, and number/boolean layout configuration with a literal default."
     },
     schema: [],
     type: "problem"
@@ -6588,13 +6545,13 @@ var tissue_no_stores_default = tissueNoStores;
 // src/rules/todo-names-its-plan.ts
 var ID_DEFAULT = String.raw`\d{3,}`;
 var commentsOf3 = (sourceCode) => sourceCode?.getAllComments?.() ?? sourceCode?.ast?.comments ?? [];
-var escapeForRegex3 = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var escapeForRegex2 = (value) => value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var todoNamesItsPlan = {
   create(context) {
     const { id = ID_DEFAULT, markers = [] } = context.options?.[0] ?? {};
     requireOption("todo-names-its-plan", markers, "markers", "{ markers: string[], id?: string }");
     const marker = new RegExp(
-      `\\b(${markers.map(escapeForRegex3).join("|")})\\b(?:\\(([^)]*)\\))?`,
+      `\\b(${markers.map(escapeForRegex2).join("|")})\\b(?:\\(([^)]*)\\))?`,
       "g"
     );
     const names2 = new RegExp(`^${id}$`);
@@ -7011,7 +6968,7 @@ var isNamedOnly = (value) => /^[a-z]+$/i.test(value.trim());
 var tokens_only_colors_default = tokensOnlyColors;
 
 // src/rules/unique-query-step-name.ts
-var RULE21 = "unique-query-step-name";
+var RULE20 = "unique-query-step-name";
 var ACCEPTS7 = "{ queryStepCalls: string[] (required), workflowFactories: string[] }";
 var DEFAULT_WORKFLOW_FACTORIES2 = ["createWorkflow"];
 var CONFIG2 = "config";
@@ -7055,13 +7012,13 @@ var uniqueQueryStepName = {
   create(context) {
     const factories = new Set(
       requireOption(
-        RULE21,
+        RULE20,
         context.options?.[0]?.workflowFactories ?? DEFAULT_WORKFLOW_FACTORIES2,
         "workflowFactories"
       )
     );
     const calls = new Set(
-      requireOption(RULE21, context.options?.[0]?.queryStepCalls, "queryStepCalls", ACCEPTS7)
+      requireOption(RULE20, context.options?.[0]?.queryStepCalls, "queryStepCalls", ACCEPTS7)
     );
     return {
       CallExpression(node) {
@@ -7142,7 +7099,7 @@ because the collision it reports is one framework's step-handler map and not eve
 var unique_query_step_name_default = uniqueQueryStepName;
 
 // src/rules/worker-handles-are-scoped.ts
-var RULE22 = "worker-handles-are-scoped";
+var RULE21 = "worker-handles-are-scoped";
 var ACCEPTS8 = "{ within: string (a regex over the filename), wrapper: string[] }";
 var handlerKeys = /* @__PURE__ */ new Set(["fetch", "queue", "scheduled", "email"]);
 var entrypointMakers = /* @__PURE__ */ new Set([
@@ -7152,8 +7109,8 @@ var entrypointMakers = /* @__PURE__ */ new Set([
 ]);
 var cellHandlesAreScoped = {
   create(context) {
-    const within = requireOption(RULE22, context.options?.[0]?.within, "within", ACCEPTS8);
-    const wrappers = requireOption(RULE22, context.options?.[0]?.wrapper, "wrapper", ACCEPTS8);
+    const within = requireOption(RULE21, context.options?.[0]?.within, "within", ACCEPTS8);
+    const wrappers = requireOption(RULE21, context.options?.[0]?.wrapper, "wrapper", ACCEPTS8);
     if (!new RegExp(within).test(normalise(context.filename))) return {};
     const scopedBy = new Set(wrappers);
     let handler = null;
@@ -7356,8 +7313,6 @@ var rules = refusingOnce(
     "compound-no-stores": compound_no_stores_default,
     "constants-in-constants-file": constants_in_constants_file_default,
     "dialect-through-the-seam": dialect_through_the_seam_default,
-    "document-sagas-are-generic": document_sagas_are_generic_default,
-    "documents-share-one-table": documents_share_one_table_default,
     "durable-body-reads-through-steps": durable_body_reads_through_steps_default,
     "effect-hook-naming": effect_hook_naming_default,
     "emit-declares-attempts": emit_declares_attempts_default,
@@ -7430,18 +7385,22 @@ var rules = refusingOnce(
   })
 );
 var { version } = createRequire(import.meta.url)("../package.json");
+var loaded = { ...rules, ...RETIRED_RULES };
 var plugin = {
   configs: PRESETS,
   meta: {
     name: "biological-architecture",
     version
   },
-  rules
+  // A retired id resolves here and nowhere else: a config that still names one parses, and the id
+  // reports nothing. `rules` — what the kit's own tooling reads as its rule set — does not carry it.
+  rules: loaded
 };
 var index_default = plugin;
 export {
   PRESETS,
   RENAMED_TO,
+  RETIRED_RULES,
   index_default as default,
   rules,
   rulesOfPreset