eslint-plugin-runtime-cleanup 1.2.8

package/dist/rules/no-floating-web-stream-locks.js

@@ -0,0 +1,87 @@
+/**
+ * @packageDocumentation
+ * Require Web Stream readers and writers to be retained so their locks can be released.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { getStaticPropertyName, isDiscardedResourceExpression, isImmediateUnownedMemberReceiver, } from "../_internal/floating-resource.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { hasTypeNameInHierarchy } from "../_internal/type-checker.js";
+import { createTypedRule, getTypedRuleServices, } from "../_internal/typed-rule.js";
+const lockFactoryNames = ["getReader", "getWriter"];
+const cleanupMemberNames = new Set(["releaseLock"]);
+const lockFactoryMetadataByName = {
+    getReader: {
+        lockKind: "reader",
+        streamTypeName: "ReadableStream",
+    },
+    getWriter: {
+        lockKind: "writer",
+        streamTypeName: "WritableStream",
+    },
+};
+const lockFactoryNameSet = new Set(lockFactoryNames);
+const isLockFactoryName = (name) => lockFactoryNameSet.has(name);
+const getLockFactoryMetadata = (callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression || callee.optional) {
+        return undefined;
+    }
+    if (callee.object.type === AST_NODE_TYPES.Super) {
+        return undefined;
+    }
+    const factoryName = getStaticPropertyName(callee.property, callee.computed);
+    if (factoryName === undefined || !isLockFactoryName(factoryName)) {
+        return undefined;
+    }
+    return {
+        ...lockFactoryMetadataByName[factoryName],
+        receiver: callee.object,
+    };
+};
+const isReceiverExpectedWebStream = (context, receiver, streamTypeName) => {
+    const { checker, parserServices } = getTypedRuleServices(context);
+    const receiverType = checker.getTypeAtLocation(parserServices.esTreeNodeToTSNodeMap.get(receiver));
+    return hasTypeNameInHierarchy(checker, receiverType, streamTypeName);
+};
+/** Rule implementation for `runtime-cleanup/no-floating-web-stream-locks`. */
+const noFloatingWebStreamLocks = createTypedRule({
+    create(context) {
+        return {
+            CallExpression(node) {
+                const metadata = getLockFactoryMetadata(node.callee);
+                if (metadata === undefined ||
+                    !isReceiverExpectedWebStream(context, metadata.receiver, metadata.streamTypeName) ||
+                    (!isDiscardedResourceExpression(node) &&
+                        !isImmediateUnownedMemberReceiver(node, cleanupMemberNames))) {
+                    return;
+                }
+                context.report({
+                    data: { lockKind: metadata.lockKind },
+                    messageId: "floatingWebStreamLock",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require Web Stream readers and writers to be retained so their locks can be released.",
+            recommended: true,
+            requiresTypeChecking: true,
+            runtimeCleanupConfigs: [
+                "runtime-cleanup.configs.recommended-type-checked",
+                "runtime-cleanup.configs.strict",
+                "runtime-cleanup.configs.all",
+            ],
+            url: createRuleDocsUrl("no-floating-web-stream-locks"),
+        },
+        messages: {
+            floatingWebStreamLock: "Store or return the Web Stream {{lockKind}} so releaseLock() can release the stream lock during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-web-stream-locks",
+});
+export default noFloatingWebStreamLocks;
+//# sourceMappingURL=no-floating-web-stream-locks.js.map

package/dist/rules/no-floating-web-stream-locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-web-stream-locks.js","sourceRoot":"","sources":["../../src/rules/no-floating-web-stream-locks.ts"],"names":[],"mappings":"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"}

package/dist/rules/no-floating-workers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @packageDocumentation
+ * Require worker handles to be retained so they can be terminated during cleanup.
+ */
+import { type TSESLint } from "@typescript-eslint/utils";
+/** Rule implementation for `runtime-cleanup/no-floating-workers`. */
+declare const noFloatingWorkers: TSESLint.RuleModule<"floatingWorker", readonly []>;
+export default noFloatingWorkers;
+//# sourceMappingURL=no-floating-workers.d.ts.map

package/dist/rules/no-floating-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-workers.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-workers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AA2OlC,qEAAqE;AACrE,QAAA,MAAM,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CACxC,gBAAgB,EAChB,SAAS,EAAE,CAiDb,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/rules/no-floating-workers.js

@@ -0,0 +1,185 @@
+/**
+ * @packageDocumentation
+ * Require worker handles to be retained so they can be terminated during cleanup.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { getParentNode } from "../_internal/ast-node.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { getVariableInScopeChain } from "../_internal/scope-variable.js";
+import { createTypedRule, } from "../_internal/typed-rule.js";
+const browserWorkerConstructorNames = [
+    "SharedWorker",
+    "Worker",
+];
+const globalReceiverNames = [
+    "globalThis",
+    "self",
+    "window",
+];
+const workerThreadsModuleNames = [
+    "node:worker_threads",
+    "worker_threads",
+];
+const browserWorkerConstructorNameSet = new Set(browserWorkerConstructorNames);
+const globalReceiverNameSet = new Set(globalReceiverNames);
+const workerThreadsModuleNameSet = new Set(workerThreadsModuleNames);
+const isBrowserWorkerConstructorName = (name) => browserWorkerConstructorNameSet.has(name);
+const isGlobalReceiverName = (name) => globalReceiverNameSet.has(name);
+const getTransparentWrappedExpression = (node) => {
+    if (node.type === AST_NODE_TYPES.ChainExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSAsExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSNonNullExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSSatisfiesExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSTypeAssertion) {
+        return node.expression;
+    }
+    return undefined;
+};
+const getImportSourceValue = (node) => {
+    const parent = getParentNode(node);
+    if (parent?.type === AST_NODE_TYPES.ImportDeclaration &&
+        typeof parent.source.value === "string") {
+        return parent.source.value;
+    }
+    return undefined;
+};
+const isWorkerThreadsImportBinding = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    const definition = variable?.defs[0];
+    const importSource = definition === undefined
+        ? undefined
+        : getImportSourceValue(definition.node);
+    return (identifier.name === "Worker" &&
+        importSource !== undefined &&
+        workerThreadsModuleNameSet.has(importSource));
+};
+const isShadowedBrowserWorkerIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const getDirectWorkerConstructorName = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.Identifier ||
+        !isBrowserWorkerConstructorName(callee.name)) {
+        return undefined;
+    }
+    if (isWorkerThreadsImportBinding(context, callee)) {
+        return "Worker";
+    }
+    return isShadowedBrowserWorkerIdentifier(context, callee)
+        ? undefined
+        : callee.name;
+};
+const getMemberWorkerConstructorName = (callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression ||
+        callee.computed ||
+        callee.optional ||
+        callee.object.type !== AST_NODE_TYPES.Identifier ||
+        callee.property.type !== AST_NODE_TYPES.Identifier ||
+        !isGlobalReceiverName(callee.object.name) ||
+        !isBrowserWorkerConstructorName(callee.property.name)) {
+        return undefined;
+    }
+    return callee.property.name;
+};
+const getWorkerConstructorName = (context, callee) => getDirectWorkerConstructorName(context, callee) ??
+    getMemberWorkerConstructorName(callee);
+const isDiscardedWorkerInstance = (node) => {
+    let current = node;
+    let parent = getParentNode(current);
+    while (parent !== undefined) {
+        const wrappedExpression = getTransparentWrappedExpression(parent);
+        if (wrappedExpression === current) {
+            current = parent;
+            parent = getParentNode(current);
+            continue;
+        }
+        if (parent.type === AST_NODE_TYPES.ExpressionStatement &&
+            parent.expression === current) {
+            return true;
+        }
+        if (parent.type === AST_NODE_TYPES.UnaryExpression &&
+            parent.operator === "void" &&
+            parent.argument === current) {
+            const unaryParent = getParentNode(parent);
+            return unaryParent?.type === AST_NODE_TYPES.ExpressionStatement;
+        }
+        return false;
+    }
+    return false;
+};
+const isImmediateWorkerMethodReceiver = (node) => {
+    let current = node;
+    let parent = getParentNode(current);
+    while (parent !== undefined) {
+        const wrappedExpression = getTransparentWrappedExpression(parent);
+        if (wrappedExpression === current) {
+            current = parent;
+            parent = getParentNode(current);
+            continue;
+        }
+        if (parent.type !== AST_NODE_TYPES.MemberExpression ||
+            parent.object !== current ||
+            parent.computed ||
+            parent.property.type !== AST_NODE_TYPES.Identifier ||
+            parent.property.name === "terminate") {
+            return false;
+        }
+        const callExpression = getParentNode(parent);
+        return (callExpression?.type === AST_NODE_TYPES.CallExpression &&
+            callExpression.callee === parent);
+    }
+    return false;
+};
+/** Rule implementation for `runtime-cleanup/no-floating-workers`. */
+const noFloatingWorkers = createTypedRule({
+    create(context) {
+        return {
+            NewExpression(node) {
+                const workerName = getWorkerConstructorName(context, node.callee);
+                if (workerName === undefined ||
+                    (!isDiscardedWorkerInstance(node) &&
+                        !isImmediateWorkerMethodReceiver(node))) {
+                    return;
+                }
+                context.report({
+                    data: { workerName },
+                    messageId: "floatingWorker",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require worker handles to be retained so they can be terminated during cleanup.",
+            recommended: true,
+            requiresTypeChecking: false,
+            runtimeCleanupConfigs: [
+                "runtime-cleanup.configs.recommended",
+                "runtime-cleanup.configs.recommended-type-checked",
+                "runtime-cleanup.configs.strict",
+                "runtime-cleanup.configs.all",
+            ],
+            url: createRuleDocsUrl("no-floating-workers"),
+        },
+        messages: {
+            floatingWorker: "Store or return the {{workerName}} handle so it can be terminated during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-workers",
+});
+export default noFloatingWorkers;
+//# sourceMappingURL=no-floating-workers.js.map

package/dist/rules/no-floating-workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-workers.js","sourceRoot":"","sources":["../../src/rules/no-floating-workers.ts"],"names":[],"mappings":"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"}

package/dist/rules/no-unmanaged-event-listeners.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @packageDocumentation
+ * Require event listeners to have an explicit cleanup path.
+ */
+import { type TSESLint } from "@typescript-eslint/utils";
+/** Rule implementation for `runtime-cleanup/no-unmanaged-event-listeners`. */
+declare const noUnmanagedEventListeners: TSESLint.RuleModule<"unmanagedEventListener", readonly []>;
+export default noUnmanagedEventListeners;
+//# sourceMappingURL=no-unmanaged-event-listeners.d.ts.map

package/dist/rules/no-unmanaged-event-listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unmanaged-event-listeners.d.ts","sourceRoot":"","sources":["../../src/rules/no-unmanaged-event-listeners.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAiPlC,8EAA8E;AAC9E,QAAA,MAAM,yBAAyB,EAAE,QAAQ,CAAC,UAAU,CAChD,wBAAwB,EACxB,SAAS,EAAE,CA+Gb,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

package/dist/rules/no-unmanaged-event-listeners.js

@@ -0,0 +1,210 @@
+/**
+ * @packageDocumentation
+ * Require event listeners to have an explicit cleanup path.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { getParentNode } from "../_internal/ast-node.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { getVariableInScopeChain } from "../_internal/scope-variable.js";
+import { createTypedRule, } from "../_internal/typed-rule.js";
+const unknownCaptureKey = "*";
+const isCleanupBoundary = (node) => node.type === AST_NODE_TYPES.Program ||
+    node.type === AST_NODE_TYPES.FunctionDeclaration ||
+    node.type === AST_NODE_TYPES.FunctionExpression ||
+    node.type === AST_NODE_TYPES.ArrowFunctionExpression;
+const getCleanupBoundary = (node) => {
+    let current = node;
+    while (current !== undefined) {
+        if (isCleanupBoundary(current)) {
+            return current;
+        }
+        current = getParentNode(current);
+    }
+    throw new TypeError("Expected an addEventListener call to have a program.");
+};
+const getStaticPropertyName = (property) => {
+    if (property.type === AST_NODE_TYPES.Identifier) {
+        return property.name;
+    }
+    if (property.type === AST_NODE_TYPES.Literal &&
+        typeof property.value === "string") {
+        return property.value;
+    }
+    return undefined;
+};
+const isMethodCallNamed = (callee, methodName) => callee.type === AST_NODE_TYPES.MemberExpression &&
+    !callee.computed &&
+    callee.property.type === AST_NODE_TYPES.Identifier &&
+    callee.property.name === methodName;
+const isUnknownRecord = (value) => typeof value === "object" && value !== null;
+const isVariableDeclarator = (node) => isUnknownRecord(node) &&
+    node["type"] === AST_NODE_TYPES.VariableDeclarator;
+const getVariableInitializer = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    const definition = variable?.defs[0];
+    const definitionNode = definition?.node;
+    if (!isVariableDeclarator(definitionNode)) {
+        return undefined;
+    }
+    return definitionNode.init ?? undefined;
+};
+const resolveOptionsExpression = (context, argument) => {
+    if (argument.type === AST_NODE_TYPES.SpreadElement) {
+        return undefined;
+    }
+    if (argument.type === AST_NODE_TYPES.Identifier) {
+        return getVariableInitializer(context, argument);
+    }
+    return argument;
+};
+const objectExpressionHasProperty = (objectExpression, propertyName) => objectExpression.properties.some((property) => {
+    if (property.type === AST_NODE_TYPES.SpreadElement) {
+        return true;
+    }
+    return getStaticPropertyName(property.key) === propertyName;
+});
+const getBooleanPropertyValue = (objectExpression, propertyName) => {
+    for (const property of objectExpression.properties) {
+        if (property.type === AST_NODE_TYPES.Property &&
+            getStaticPropertyName(property.key) === propertyName &&
+            property.value.type === AST_NODE_TYPES.Literal &&
+            typeof property.value.value === "boolean") {
+            return property.value.value;
+        }
+    }
+    return undefined;
+};
+const hasAbortSignalOption = (context, argument) => {
+    if (argument === undefined) {
+        return false;
+    }
+    const resolvedOptions = resolveOptionsExpression(context, argument);
+    return (resolvedOptions?.type === AST_NODE_TYPES.ObjectExpression &&
+        objectExpressionHasProperty(resolvedOptions, "signal"));
+};
+const getCaptureKey = (context, argument) => {
+    if (argument === undefined) {
+        return "false";
+    }
+    const resolvedOptions = resolveOptionsExpression(context, argument);
+    if (resolvedOptions === undefined) {
+        return unknownCaptureKey;
+    }
+    if (resolvedOptions.type === AST_NODE_TYPES.Literal &&
+        typeof resolvedOptions.value === "boolean") {
+        return String(resolvedOptions.value);
+    }
+    if (resolvedOptions.type === AST_NODE_TYPES.ObjectExpression) {
+        const captureValue = getBooleanPropertyValue(resolvedOptions, "capture");
+        return captureValue === undefined ? "false" : String(captureValue);
+    }
+    return unknownCaptureKey;
+};
+const getCleanupKey = (context, node) => {
+    if (node.arguments.length < 2 || node.callee.type !== AST_NODE_TYPES.MemberExpression) {
+        return undefined;
+    }
+    const [eventType, listener, options] = node.arguments;
+    if (eventType === undefined ||
+        listener === undefined ||
+        eventType.type === AST_NODE_TYPES.SpreadElement ||
+        listener.type === AST_NODE_TYPES.SpreadElement) {
+        return undefined;
+    }
+    const targetText = context.sourceCode.getText(node.callee.object);
+    const eventTypeText = context.sourceCode.getText(eventType);
+    const listenerText = context.sourceCode.getText(listener);
+    const captureKey = getCaptureKey(context, options);
+    return `${targetText}\u0000${eventTypeText}\u0000${listenerText}\u0000${captureKey}`;
+};
+const getWildcardCleanupKey = (cleanupKey) => {
+    const [targetText, eventTypeText, listenerText] = cleanupKey.split("\u0000", 3);
+    if (targetText === undefined ||
+        eventTypeText === undefined ||
+        listenerText === undefined) {
+        throw new TypeError("Expected a complete event listener cleanup key.");
+    }
+    return `${targetText}\u0000${eventTypeText}\u0000${listenerText}\u0000${unknownCaptureKey}`;
+};
+/** Rule implementation for `runtime-cleanup/no-unmanaged-event-listeners`. */
+const noUnmanagedEventListeners = createTypedRule({
+    create(context) {
+        const addsByBoundary = new Map();
+        const removesByBoundary = new Map();
+        const addRecord = (boundary, record) => {
+            const records = addsByBoundary.get(boundary);
+            if (records === undefined) {
+                addsByBoundary.set(boundary, [record]);
+                return;
+            }
+            records.push(record);
+        };
+        const addRemoveKey = (boundary, cleanupKey) => {
+            const cleanupKeys = removesByBoundary.get(boundary);
+            if (cleanupKeys === undefined) {
+                removesByBoundary.set(boundary, new Set([cleanupKey]));
+                return;
+            }
+            cleanupKeys.add(cleanupKey);
+        };
+        return {
+            'CallExpression[callee.type="MemberExpression"]'(node) {
+                if (isMethodCallNamed(node.callee, "addEventListener") &&
+                    !hasAbortSignalOption(context, node.arguments[2])) {
+                    const cleanupKey = getCleanupKey(context, node);
+                    if (cleanupKey !== undefined) {
+                        addRecord(getCleanupBoundary(node), {
+                            cleanupKey,
+                            node,
+                        });
+                    }
+                }
+                if (isMethodCallNamed(node.callee, "removeEventListener")) {
+                    const cleanupKey = getCleanupKey(context, node);
+                    if (cleanupKey !== undefined) {
+                        addRemoveKey(getCleanupBoundary(node), cleanupKey);
+                    }
+                }
+            },
+            "Program:exit"() {
+                for (const [boundary, addRecords] of addsByBoundary) {
+                    const removeKeys = removesByBoundary.get(boundary) ?? new Set();
+                    for (const { cleanupKey, node } of addRecords) {
+                        if (removeKeys.has(cleanupKey) ||
+                            removeKeys.has(getWildcardCleanupKey(cleanupKey))) {
+                            continue;
+                        }
+                        context.report({
+                            messageId: "unmanagedEventListener",
+                            node,
+                        });
+                    }
+                }
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require event listeners to have an abort signal or a matching cleanup call.",
+            recommended: true,
+            requiresTypeChecking: false,
+            runtimeCleanupConfigs: [
+                "runtime-cleanup.configs.recommended",
+                "runtime-cleanup.configs.recommended-type-checked",
+                "runtime-cleanup.configs.strict",
+                "runtime-cleanup.configs.all",
+            ],
+            url: createRuleDocsUrl("no-unmanaged-event-listeners"),
+        },
+        messages: {
+            unmanagedEventListener: "Add an AbortSignal option or a matching removeEventListener call for this listener.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-unmanaged-event-listeners",
+});
+export default noUnmanagedEventListeners;
+//# sourceMappingURL=no-unmanaged-event-listeners.js.map

package/dist/rules/no-unmanaged-event-listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unmanaged-event-listeners.js","sourceRoot":"","sources":["../../src/rules/no-unmanaged-event-listeners.ts"],"names":[],"mappings":"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"}

package/docs/rules/getting-started.md

@@ -0,0 +1,29 @@
+# Getting started
+
+`eslint-plugin-runtime-cleanup` is an ESLint plugin scaffold for enforcing
+explicit cleanup of runtime resources in TypeScript projects.
+
+The initial package intentionally ships no rules. This keeps the repository
+clean after template conversion and prevents unrelated rule behavior from being
+published under the runtime-cleanup name.
+
+## Installation
+
+```sh
+npm install --save-dev eslint-plugin-runtime-cleanup typescript
+```
+
+## Flat config
+
+```js
+import runtimeCleanup from "eslint-plugin-runtime-cleanup";
+
+export default [runtimeCleanup.configs.recommended];
+```
+
+## Current status
+
+The plugin exports stable preset keys, parser defaults, package metadata, and
+documentation structure. Add concrete rules only when the resource pattern,
+cleanup expectation, false-positive boundaries, and fix or suggestion strategy
+are defined.

package/docs/rules/guides/adoption-checklist.md

@@ -0,0 +1,31 @@
+---
+description: Practical checklist for adopting eslint-plugin-runtime-cleanup rules with low risk.
+---
+
+# Adoption checklist
+
+Use this checklist when concrete runtime-cleanup rules are added.
+
+## Before enabling a rule
+
+- Confirm the rule targets a real resource lifetime problem in your codebase.
+- Read the rule docs and understand the cleanup pattern it expects.
+- Start with `runtime-cleanup.configs.recommended` or a single rule entry.
+- Run ESLint without `--fix` first and review every report category.
+- Enable type-aware presets only when your parser setup supports project
+  services.
+
+## During rollout
+
+- Fix the highest-confidence findings first.
+- Prefer explicit cleanup near the resource allocation site.
+- Use suggestions where cleanup placement depends on program structure.
+- Avoid blanket disables. Use narrow `eslint-disable-next-line` comments only
+  when the resource is intentionally long-lived.
+
+## Before release
+
+- Run `npm run lint:nocache`.
+- Run `npm run typecheck`.
+- Run `npm run test`.
+- Run the repository release gate when preparing a package release.

package/docs/rules/guides/preset-selection-strategy.md

@@ -0,0 +1,24 @@
+---
+description: Choose the right eslint-plugin-runtime-cleanup preset and roll it out with minimal migration risk.
+---
+
+# Preset selection strategy
+
+The package currently exposes empty presets. These keys are stable adoption
+points for future runtime cleanup rules.
+
+## Recommended path
+
+1. Use `runtime-cleanup.configs.recommended` for broad, low-noise checks.
+2. Add `runtime-cleanup.configs["recommended-type-checked"]` when type-aware
+   rules are useful and project services are available.
+3. Evaluate `runtime-cleanup.configs.strict` only after recommended findings are
+   clean.
+4. Use `runtime-cleanup.configs.experimental` in narrow CI jobs or local audits
+   before making it a default.
+
+## Direct rule enablement
+
+For early rollout, enabling one concrete rule at a time is usually better than
+turning on a broader preset. That gives reviewers a clear resource category and
+cleanup strategy to evaluate.