Registry / devops / eslint-plugin-acture-migration

eslint-plugin-acture-migration

library1.1.0jsnpmunverified

ESLint rules for acture strangler-fig migrations. v1.1.0 (stable). Ships TypeScript types. Provides two rules: `no-stale-wrap-mutation` flags public-API footguns and ensures `wrapMutation(...)` results are consumed, preventing silent graduation mistakes; `require-param-describe` enforces `.describe(...)` on command params for JSON Schema correctness. Peer dependency on ESLint >=9.0.0 (flat config). Conservative single-file detection reduces noise over cross-file analysis. Unlike generic ESLint plugins, this is purpose-built for the acture migration pattern and integrates with its `acture-migration` import path.

devops testing

npm install eslint-plugin-acture-migration

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-ACTU

eslint-plugin-acture-migration

devopsjavascriptv1.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (plugin object)

✓ import acture from 'eslint-plugin-acture-migration';

✗ const acture = require('eslint-plugin-acture-migration');

Requires ESLint 9 flat config — CommonJS require() works in Node, but ESLint 9 expects ESM. Use default import.

plugin (default) in eslint.config.js

✓ import acture from 'eslint-plugin-acture-migration'; export default [{ plugins: { acture }, rules: { 'acture/no-stale-wrap-mutation': 'warn' } }];

✗ const acture = require('eslint-plugin-acture-migration').default;

The plugin key is your choice; the rule prefix matches that key. The default import is the plugin object.

recommended config

✓ import acture from 'eslint-plugin-acture-migration'; export default [acture.configs.recommended];

Recommended config enables both rules as warnings. No extra setup needed.

Shows flat config setup with both rules active as warnings, enabling migration and schema-quality checks.

// eslint.config.js import acture from 'eslint-plugin-acture-migration'; export default [ { plugins: { acture }, rules: { 'acture/no-stale-wrap-mutation': 'warn', 'acture/require-param-describe': 'warn', }, }, ];

Debug

Known issues

gotchaNamespace imports like `import * as m from 'acture-migration'` are NOT tracked by `no-stale-wrap-mutation` — only named or aliased imports work.

fix

Use named imports: `import { wrapMutation } from 'acture-migration'`

affects: >=1.0.0

gotchaThe rule only checks a single file — cross-file unused exports are not flagged, leading to false negatives.

fix

Manually audit exported `wrapMutation` results that are never imported elsewhere.

affects: >=1.0.0

gotchaESLint version requirement: >=9.0.0 (flat config). Legacy `.eslintrc` format is not supported.

fix

Migrate to eslint.config.js flat config or use an older plugin version if on ESLint <9.

affects: >=1.0.0

gotchaThe plugin object must be imported as default — attempting to destructure `{ rules }` will fail.

fix

Use `import acture from 'eslint-plugin-acture-migration'` then access `acture.rules` or `acture.configs.recommended`.

affects: >=1.0.0

Errors

Common errors & fixes

ESLint couldn't find the plugin 'eslint-plugin-acture-migration'.

Plugin not installed or not in node_modules.

fix

Run `npm install --save-dev eslint-plugin-acture-migration`. Also verify flat config path resolution.

TypeError: Cannot read properties of undefined (reading 'recommended')

Importing the plugin incorrectly (e.g., destructured or wrong path).

fix

Use `import acture from 'eslint-plugin-acture-migration'` then `acture.configs.recommended`.

Error: Failed to load plugin 'acture': Cannot find module 'eslint-plugin-acture-migration'

ESLint config referencing a plugin key that doesn't match the package name.

fix

Ensure the plugin key in `plugins: { myCustomKey: acture }` is arbitrary but the rule prefix matches: `'myCustomKey/no-stale-wrap-mutation'`.

Upgrade

Version history

1.1.0latest on npm

Audit

Dependencies

eslintrequiredpeer dependency – plugin requires ESLint 9+ flat config

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/thorwhalen/acture ↗

packageeslint-plugin-acture-migration ↗

homepagehttps://github.com/thorwhalen/acture#readme ↗