redlint 6.6.0 → 6.7.0

package/CONTRIBUTING.md

@@ -6,14 +6,15 @@
 - **No `t.pass('everything ok')` in tests** — every assertion must test something meaningful.
 - **100% coverage required** — checked via [`.nycrc.json`](.nycrc.json). Run `redrun coverage` to verify.
 - **Tests use [supertape](https://github.com/coderaiser/supertape)** with `stub()` for mocking.
-- **TDD is encouraged** — write a failing test first, then implement, then `redrun fix:lint test`.
-- **Run `redrun fix:lint test` before every commit** — linter must be clean, all tests green.
+- **TDD is encouraged** — write a failing test first, then implement, then `redrun fix:lint coverage`.
+- **Run `redrun fix:lint coverage` before every commit** — linter must be clean, all tests green, coverage 100%.
 
 ## Table of Contents
 
 - [Do / Don't](#do--dont)
 - [Workflow](#workflow)
 - [Architecture](#architecture)
+- [How to add a new converter](#how-to-add-a-new-converter)
 - [Import Map](#import-map)
 - [File Tree](#file-tree)
 - [Overrides Pattern](#overrides-pattern)
@@ -74,6 +75,98 @@ The debug mode is an escape hatch when workers misbehave.
 - Mocking: `stub()` from supertape (no external mocking library)
 - Fixtures: plain `.js` files in `fixture/` directories
 
+## How to add a new converter (e.g. `convert-json-to-yaml`)?
+
+All converters live in `lib/convert/converters/` and follow the same pattern. Adding a new one requires changes in **6 files** (1 new, 5 modified):
+
+### 1. Create the converter — `lib/convert/converters/convert-X-to-Y.js`
+
+```js
+import * as pluginFilesystem from '@putout/plugin-filesystem';
+
+const [, pluginConvertXToY] = pluginFilesystem.rules['convert-X-to-Y'];
+
+export const convertXToY = (filename) => ({
+    rules: {
+        'filesystem/convert-X-to-Y': ['on', {
+            filename,
+        }],
+    },
+    plugins: [
+        ['filesystem/convert-X-to-Y', pluginConvertXToY],
+    ],
+});
+```
+
+The `[@putout/plugin-filesystem](https://github.com/coderaiser/putout/tree/master/packages/plugin-filesystem)`
+package must already export the rule (use `[@putout/plugin-filesystem](https://github.com/coderaiser/putout/tree/master/packages/plugin-filesystem)` >= 13.2.0 for `convert-json-to-yaml`).
+
+### 2. Register menu constants — `lib/menu.js`
+
+Add a pair of exports (normal + debug):
+
+```js
+export const CONVERT_X_TO_Y = '🦏 convert x to y';
+export const CONVERT_X_TO_Y_DEBUG = '🦏 convert x to y: debug';
+```
+
+Then add `CONVERT_X_TO_Y` to the array in `isConvertChosen()` and `CONVERT_X_TO_Y_DEBUG` to the array in `isConvertChosenDebug()`.
+
+### 3. Add to converters map — `lib/convert/create-options.js`
+
+```js
+import {convertXToY} from './converters/convert-X-to-Y.js';
+
+const CONVERTERS = {
+    // ...existing...
+    [CONVERT_X_TO_Y]: convertXToY,
+    [CONVERT_X_TO_Y_DEBUG]: convertXToY,
+};
+```
+
+### 4. Add to convert menu — `lib/convert/index.js`
+
+Import `CONVERT_X_TO_Y` and add it to the `chooseConvert()` dialog array.
+
+### 5. Add to debug menu — `lib/debug.js`
+
+Import `CONVERT_X_TO_Y_DEBUG` and add it to the `debug()` dialog array.
+
+### 6. Add a test — `lib/convert/convert.spec.js`
+
+```js
+import {CONVERT_X_TO_Y} from '../menu.js';
+
+test('redlint: convert: x to y', (t) => {
+    const filesystem = stringify([
+        '/hello/world/',
+        '/hello/world/file.x',
+    ]);
+    
+    const converted = convert('file.x', CONVERT_X_TO_Y, filesystem, {
+        merge,
+        branch,
+    });
+    
+    const result = parse(converted);
+    
+    const expected = ['/hello/world/', [
+        '/hello/world/file.y',
+        'e30K',
+    ]];
+    
+    t.deepEqual(result, expected);
+    t.end();
+});
+```
+
+### 🧪 Verify
+
+```sh
+redrun fix:lint     # putout . --fix — must pass
+redrun coverage     # 100% required
+```
+
 ## Import Map
 
 The project uses Node.js [`imports`](package.json) for internal aliases:
@@ -177,5 +270,5 @@ This pattern keeps functions pure, easy to unit test, and doesn't require any mo
 | [madrun](https://github.com/coderaiser/madrun)        | Define tasks in `.madrun.js`                         | `redrun`             |
 | [putout](https://github.com/coderaiser/putout)        | JavaScript code transformer & linter                 | `redrun fix:lint`    |
 | [supertape](https://github.com/coderaiser/supertape)  | Test framework with built-in `stub()`                | `redrun test`        |
-| [superc8](https://github.com/coderaiser/superc8)      | Enhanced c8 wrapper                                  | `redrun coverage`    |
+| [superc8](https://github.com/coderaiser/superc8)      | coverage tool, drop-in modern  `c8` replacement                                  | `redrun coverage`    |
 | [nodemon](https://github.com/remy/nodemon)            | Watch mode for tests                                 | `redrun watch:test`  |

package/ChangeLog

@@ -1,3 +1,9 @@
+2026.06.07, v6.7.0
+
+feature:
+- 32a0dfc redlint: isKnownCommand: add
+- 68d1431 redlint: convert-json-to-yaml
+
 2026.06.06, v6.6.0
 
 feature:

package/bin/redlint.js

@@ -57,6 +57,7 @@ import {
     isBundleDebug,
     isEdit,
     isView,
+    isKnownCommand,
     VIEW,
     TEST,
     isTest,
@@ -120,6 +121,11 @@ async function uiLoop(arg) {
     if (!arg)
         return;
     
+    if (!isKnownCommand(arg)) {
+        console.error(`'${arg}' is not a redlint command. See 'redlint --help'.`);
+        process.exit(1);
+    }
+    
     log('Running:');
     const spinner = ora('index filesystem').start();
     const CWD = process.cwd();

package/lib/convert/converters/convert-json-to-yaml.js

@@ -0,0 +1,14 @@
+import * as pluginFilesystem from '@putout/plugin-filesystem';
+
+const [, pluginConvertJsonToYaml] = pluginFilesystem.rules['convert-json-to-yaml'];
+
+export const convertJsonToYaml = (filename) => ({
+    rules: {
+        'filesystem/convert-json-to-yaml': ['on', {
+            filename,
+        }],
+    },
+    plugins: [
+        ['filesystem/convert-json-to-yaml', pluginConvertJsonToYaml],
+    ],
+});

package/lib/convert/create-options.js

@@ -5,9 +5,12 @@ import {
     CONVERT_JS_TO_JSON_DEBUG,
     CONVERT_YAML_TO_JSON,
     CONVERT_YAML_TO_JSON_DEBUG,
+    CONVERT_JSON_TO_YAML,
+    CONVERT_JSON_TO_YAML_DEBUG,
     CONVERT_RC_TO_FLAT,
 } from '../menu.js';
 import {convertYamlToJson} from './converters/convert-yaml-to-json.js';
+import {convertJsonToYaml} from './converters/convert-json-to-yaml.js';
 import {convertJsonToJs} from './converters/convert-json-to-js.js';
 import {convertJSToJson} from './converters/convert-js-to-json.js';
 import {convertRCToFlat} from './converters/convert-rc-to-flat.js';
@@ -19,6 +22,8 @@ const CONVERTERS = {
     [CONVERT_JS_TO_JSON_DEBUG]: convertJSToJson,
     [CONVERT_YAML_TO_JSON]: convertYamlToJson,
     [CONVERT_YAML_TO_JSON_DEBUG]: convertYamlToJson,
+    [CONVERT_JSON_TO_YAML]: convertJsonToYaml,
+    [CONVERT_JSON_TO_YAML_DEBUG]: convertJsonToYaml,
     [CONVERT_RC_TO_FLAT]: convertRCToFlat,
 };
 

package/lib/convert/index.js

@@ -6,6 +6,7 @@ import {
     EXIT,
     CONVERT_RC_TO_FLAT,
     CONVERT_YAML_TO_JSON,
+    CONVERT_JSON_TO_YAML,
 } from '../menu.js';
 
 export * from './convert.js';
@@ -14,6 +15,7 @@ export const chooseConvert = async () => {
         CONVERT_JS_TO_JSON,
         CONVERT_JSON_TO_JS,
         CONVERT_YAML_TO_JSON,
+        CONVERT_JSON_TO_YAML,
         CONVERT_RC_TO_FLAT,
         BACK,
         EXIT,

package/lib/debug.js

@@ -7,6 +7,7 @@ import {
     CONVERT_JS_TO_JSON_DEBUG,
     CONVERT_JSON_TO_JS_DEBUG,
     CONVERT_YAML_TO_JSON_DEBUG,
+    CONVERT_JSON_TO_YAML_DEBUG,
     RENAME_JS_TO_JSX_DEBUG,
     BACK,
     EXIT,
@@ -23,6 +24,7 @@ export const debug = async () => {
         CONVERT_JS_TO_JSON_DEBUG,
         CONVERT_JSON_TO_JS_DEBUG,
         CONVERT_YAML_TO_JSON_DEBUG,
+        CONVERT_JSON_TO_YAML_DEBUG,
         RENAME_JS_TO_JSX_DEBUG,
         RENAME_JS_TO_JSX_DEBUG,
         BUNDLE_DEBUG,

package/lib/menu.js

@@ -29,6 +29,9 @@ export const CONVERT_JSON_TO_JS_DEBUG = '🦏 convert json to js: debug';
 export const CONVERT_YAML_TO_JSON = '🦏 convert yaml to json';
 export const CONVERT_YAML_TO_JSON_DEBUG = '🦏 convert yaml to json: debug';
 
+export const CONVERT_JSON_TO_YAML = '🦏 convert json to yaml';
+export const CONVERT_JSON_TO_YAML_DEBUG = '🦏 convert json to yaml: debug';
+
 export const RENAME_JS_TO_JSX = '🦏 rename js to jsx';
 export const RENAME_JS_TO_JSX_DEBUG = '🦏 rename js to jsx: debug';
 
@@ -60,6 +63,7 @@ export const isConvertChosen = (a) => {
         CONVERT_JSON_TO_JS,
         CONVERT_JS_TO_JSON,
         CONVERT_YAML_TO_JSON,
+        CONVERT_JSON_TO_YAML,
         CONVERT_RC_TO_FLAT,
     ].includes(a);
 };
@@ -69,9 +73,40 @@ export const isConvertChosenDebug = (a) => [
     CONVERT_JS_TO_JSON_DEBUG,
     CONVERT_JSON_TO_JS_DEBUG,
     CONVERT_YAML_TO_JSON_DEBUG,
+    CONVERT_JSON_TO_YAML_DEBUG,
 ].includes(a);
 
 export const isConvertRCToFlat = (a) => a === CONVERT_RC_TO_FLAT;
 
 export const isRenameToJs = (a) => a === RENAME_JS_TO_JSX || a === RENAME_JS_TO_JSX_DEBUG;
 export const isRenameToJsx = (a) => a === RENAME_JSX_TO_JS || a === RENAME_JSX_TO_JS_DEBUG;
+
+const callWith = (a) => (fn) => fn(a);
+
+export const isKnownCommand = (a) => [
+    isScan,
+    isScanDebug,
+    isFix,
+    isFixDebug,
+    isPack,
+    isPackDebug,
+    isExtract,
+    isExtractDebug,
+    isGenerate,
+    isGenerateSimple,
+    isHelp,
+    isVersion,
+    isDebug,
+    isConvert,
+    isRename,
+    isBack,
+    isExit,
+    isEdit,
+    isView,
+    isTest,
+    isBundleDebug,
+    isConvertChosen,
+    isConvertChosenDebug,
+    isRenameToJsChosen,
+    isRenameToJsxChosen,
+].some(callWith(a));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redlint",
-  "version": "6.6.0",
+  "version": "6.7.0",
   "type": "module",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "Lint Filesystem with 🐊Putout",
@@ -27,6 +27,8 @@
     "test:dts": "madrun test:dts",
     "watch:test": "madrun watch:test",
     "lint": "madrun lint",
+    "scan": "madrun scan",
+    "scan:fix": "madrun scan:fix",
     "fresh:lint": "madrun fresh:lint",
     "lint:fresh": "madrun lint:fresh",
     "fix:lint": "madrun fix:lint",