@linter-spec/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SotherWind
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @linter-spec/cli
+
+`linter-spec` 前端编码规范的一站式 Lint 工具链。将 ESLint 9、Stylelint 17、markdownlint、Prettier 3 和 commitlint 19 封装在单个 CLI（以及一个轻量 Node API）之下，让项目用一条命令即可接入、扫描、修复并对提交做卡点。
+
+## 安装
+
+```sh
+pnpm add -D @linter-spec/cli
+```
+
+各共享配置（`@linter-spec/eslint-config`、`@linter-spec/stylelint-config`、`@linter-spec/markdownlint-config`、`@linter-spec/commitlint-config`）以依赖形式一并安装——装好 CLI 即可扫描项目。
+
+> 需要 Node.js `^20.19.0 || >=22.12.0`。
+
+## 快速开始
+
+```sh
+# 交互式接入：写入配置、VS Code 设置与 git 钩子
+npx linter-spec init
+
+# 扫描项目中的规范问题
+npx linter-spec scan
+
+# 自动修复可修复的问题（先跑 Prettier，再跑各 Linter）
+npx linter-spec fix
+```
+
+`init` 会向 `package.json` 添加 `linter-spec-scan` / `linter-spec-fix` 脚本，并安装 husky 钩子（pre-commit 上的 `commit-file-scan`、commit-msg 上的 `commit-msg-scan`）。
+
+## 命令
+
+| 命令 | 说明 |
+| --- | --- |
+| `init` | 初始化项目：选择项目类型、写入 Lint 配置、合并 `.vscode/settings.json`、配置 husky 钩子。`--vscode` 仅写入 VS Code 设置。 |
+| `scan` | 运行已启用的 Linter 并打印报告。有错误时以非零状态码退出。 |
+| `fix` | 自动修复：Prettier 先格式化，随后 ESLint / Stylelint / markdownlint 应用各自的修复。 |
+| `commit-file-scan` | 扫描已暂存待提交的文件（供 pre-commit 钩子使用）。 |
+| `commit-msg-scan [msgPath]` | 通过 commitlint 校验提交信息（供 commit-msg 钩子使用）。 |
+| `update` | 将 `@linter-spec/cli` 升级到最新版本。 |
+
+### 常用选项
+
+| 选项 | 适用命令 | 说明 |
+| --- | --- | --- |
+| `-i, --include <dirpath>` | `scan`、`fix` | 要扫描的目录（默认为项目根目录）。 |
+| `-q, --quiet` | `scan` | 仅报告错误，忽略警告。 |
+| `-o, --output-report` | `scan` | 写出一份 `linter-spec-report.json` 报告文件。 |
+| `--no-ignore` | `scan`、`fix` | 忽略 ESLint 的 ignore 文件 / 规则。 |
+| `-s, --strict` | `commit-file-scan` | 警告也视为失败，而不仅仅是错误。 |
+| `--vscode` | `init` | 仅写入 `.vscode/settings.json`。 |
+
+## Node API
+
+```js
+import { init, scan } from '@linter-spec/cli';
+
+// 编程式 init（绝不会自我升级 CLI）
+await init({
+  cwd: process.cwd(),
+  eslintType: 'typescript/react', // 取值见下文「项目类型」
+  enableStylelint: true,
+  enableMarkdownlint: true,
+  enablePrettier: true,
+});
+
+// 编程式 scan —— 返回结构化报告
+const report = await scan({ cwd: process.cwd(), include: process.cwd(), fix: false });
+console.log(report.errorCount, report.warningCount);
+```
+
+`scan` 解析为一个 `ScanReport`：
+
+```ts
+interface ScanReport {
+  results: ScanResult[]; // 每个文件的消息与计数
+  errorCount: number;
+  warningCount: number;
+  runErrors: Error[]; // 某个 Linter 崩溃不会中断其余 Linter
+}
+```
+
+### 项目类型
+
+`init` 的 `eslintType`（以及交互式选项）与 `@linter-spec/eslint-config` 的入口一一对应：
+
+| 取值 | 项目 |
+| --- | --- |
+| `index` | 纯 JavaScript |
+| `typescript` | TypeScript |
+| `react` / `typescript/react` | React（JS / TS） |
+| `vue` / `typescript/vue` | Vue（JS / TS） |
+| `node` / `typescript/node` | Node.js（JS / TS） |
+| `es5` | 传统 ES5 |
+
+## 配置文件
+
+在项目根目录放置 `linter-spec.config.{mjs,cjs,js}` 即可开关各 Linter 或透传选项。传给 Node API 的内联配置优先级更高。
+
+```js
+// linter-spec.config.mjs
+export default {
+  enableESLint: true,
+  enableStylelint: true,
+  enableMarkdownlint: true,
+  enablePrettier: true,
+  // eslintOptions / stylelintOptions / markdownlintOptions 会被透传
+};
+```
+
+## 仓库
+
+- 源码：<https://github.com/SotherWind/linter-spec>
+- 许可证：MIT
+- 作者：SotherWind

package/dist/actions/init/index.d.ts

@@ -0,0 +1,2 @@
+import type { InitOptions } from '../../types.js';
+export default function init(options: InitOptions): Promise<void>;

package/dist/actions/init/index.js

@@ -0,0 +1,67 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import update from '../update.js';
+import log from '../../utils/log.js';
+import conflictResolve from '../../utils/conflict-resolve.js';
+import generateTemplate from '../../utils/generate-template.js';
+import { CLI_NAME, PROJECT_TYPES } from '../../utils/constants.js';
+import { messages } from '../../utils/messages.js';
+import { chooseEnableMarkdownlint, chooseEnablePrettier, chooseEnableStylelint, chooseEslintType, } from './prompts.js';
+import { installCliDep } from './install-deps.js';
+import { setupHusky } from './setup-husky.js';
+export default async function init(options) {
+    const cwd = options.cwd || process.cwd();
+    const isTest = process.env.NODE_ENV === 'test';
+    const checkVersionUpdate = options.checkVersionUpdate || false;
+    const disableNpmInstall = options.disableNpmInstall || false;
+    const pkgPath = path.resolve(cwd, 'package.json');
+    let pkg = fs.readJSONSync(pkgPath);
+    let step = 0;
+    if (!isTest && checkVersionUpdate) {
+        await update(false);
+    }
+    const enableESLint = typeof options.enableESLint === 'boolean' ? options.enableESLint : true;
+    const eslintType = options.eslintType && PROJECT_TYPES.some((c) => c.value === options.eslintType)
+        ? options.eslintType
+        : await chooseEslintType(++step);
+    const enableStylelint = typeof options.enableStylelint === 'boolean'
+        ? options.enableStylelint
+        : await chooseEnableStylelint(++step, !/node/.test(eslintType));
+    const enableMarkdownlint = typeof options.enableMarkdownlint === 'boolean'
+        ? options.enableMarkdownlint
+        : await chooseEnableMarkdownlint(++step);
+    const enablePrettier = typeof options.enablePrettier === 'boolean'
+        ? options.enablePrettier
+        : await chooseEnablePrettier(++step);
+    const config = {
+        enableESLint,
+        eslintType,
+        enableStylelint,
+        enableMarkdownlint,
+        enablePrettier,
+    };
+    if (!isTest) {
+        log.info(messages.stepConflict(++step));
+        pkg = await conflictResolve(cwd, options.rewriteConfig);
+        log.success(messages.stepConflictDone(step));
+        if (!disableNpmInstall) {
+            log.info(messages.stepInstall(++step));
+            await installCliDep(cwd);
+            log.success(messages.stepInstallDone(step));
+        }
+    }
+    // Re-read: install / conflict-resolve may have rewritten package.json.
+    pkg = fs.readJSONSync(pkgPath);
+    if (!pkg.scripts)
+        pkg.scripts = {};
+    pkg.scripts[`${CLI_NAME}-scan`] ??= `${CLI_NAME} scan`;
+    pkg.scripts[`${CLI_NAME}-fix`] ??= `${CLI_NAME} fix`;
+    log.info(messages.stepHusky(++step));
+    setupHusky(cwd, pkg);
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+    log.success(messages.stepHuskyDone(step));
+    log.info(messages.stepWrite(++step));
+    generateTemplate(cwd, config);
+    log.success(messages.stepWriteDone(step));
+    log.success(messages.initDone);
+}

package/dist/actions/init/install-deps.d.ts

@@ -0,0 +1,9 @@
+/** True when the project carries its own lint config files. */
+export declare function hasLocalLintConfig(cwd: string): boolean;
+/** Install the CLI itself as a dev dependency of the target project. */
+export declare function installCliDep(cwd: string): Promise<void>;
+/**
+ * When a project relies on the bundled lint configs but has no `node_modules`,
+ * install its dependencies first (otherwise config resolution fails).
+ */
+export declare function installProjectDepsIfMissing(cwd: string, hasLocalConfig: boolean): Promise<void>;

package/dist/actions/init/install-deps.js

@@ -0,0 +1,36 @@
+import spawn from 'cross-spawn';
+import path from 'node:path';
+import fs from 'fs-extra';
+import fg from 'fast-glob';
+import { detectPackageManager, addDevCommand, installAllCommand } from '../../utils/npm.js';
+import log from '../../utils/log.js';
+import { messages } from '../../utils/messages.js';
+import { PKG_NAME } from '../../utils/constants.js';
+/** True when the project carries its own lint config files. */
+export function hasLocalLintConfig(cwd) {
+    return (fg.sync([
+        '.eslintrc?(.@(js|cjs|mjs|yaml|yml|json))',
+        'eslint.config.@(js|mjs|cjs|ts)',
+        '.stylelintrc?(.@(js|cjs|mjs|yaml|yml|json))',
+        'stylelint.config.@(js|mjs|cjs)',
+        '.markdownlint?(-cli2).@(jsonc|json|yaml|yml|cjs|mjs)',
+    ], { cwd, dot: true }).length > 0);
+}
+/** Install the CLI itself as a dev dependency of the target project. */
+export async function installCliDep(cwd) {
+    const [command, args] = addDevCommand(detectPackageManager(cwd), PKG_NAME);
+    spawn.sync(command, args, { stdio: 'inherit', cwd });
+}
+/**
+ * When a project relies on the bundled lint configs but has no `node_modules`,
+ * install its dependencies first (otherwise config resolution fails).
+ */
+export async function installProjectDepsIfMissing(cwd, hasLocalConfig) {
+    const nodeModulesPath = path.resolve(cwd, 'node_modules');
+    if (!fs.existsSync(nodeModulesPath) && hasLocalConfig) {
+        const pm = detectPackageManager(cwd);
+        log.info(messages.installingDeps(pm));
+        const [command, args] = installAllCommand(pm);
+        spawn.sync(command, args, { cwd, stdio: 'inherit' });
+    }
+}

package/dist/actions/init/prompts.d.ts

@@ -0,0 +1,4 @@
+export declare const chooseEslintType: (step: number) => Promise<string>;
+export declare const chooseEnableStylelint: (step: number, defaultValue: boolean) => Promise<boolean>;
+export declare const chooseEnableMarkdownlint: (step: number) => Promise<boolean>;
+export declare const chooseEnablePrettier: (step: number) => Promise<boolean>;

package/dist/actions/init/prompts.js

@@ -0,0 +1,10 @@
+import { select, confirm } from '@inquirer/prompts';
+import { PROJECT_TYPES } from '../../utils/constants.js';
+import { messages } from '../../utils/messages.js';
+export const chooseEslintType = (step) => select({
+    message: messages.stepChooseType(step),
+    choices: PROJECT_TYPES.map((t) => ({ name: t.name, value: t.value })),
+});
+export const chooseEnableStylelint = (step, defaultValue) => confirm({ message: messages.stepEnableStylelint(step), default: defaultValue });
+export const chooseEnableMarkdownlint = (step) => confirm({ message: messages.stepEnableMarkdownlint(step), default: true });
+export const chooseEnablePrettier = (step) => confirm({ message: messages.stepEnablePrettier(step), default: true });

package/dist/actions/init/setup-husky.d.ts

@@ -0,0 +1,7 @@
+import type { PKG } from '../../types.js';
+/**
+ * Configure git commit hooks via husky v9.
+ * Writes the hook scripts and ensures a `prepare` script so husky installs on
+ * the next `npm install`. Mutates `pkg.scripts` (caller persists package.json).
+ */
+export declare function setupHusky(cwd: string, pkg: PKG): void;

package/dist/actions/init/setup-husky.js

@@ -0,0 +1,18 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CLI_NAME } from '../../utils/constants.js';
+/**
+ * Configure git commit hooks via husky v9.
+ * Writes the hook scripts and ensures a `prepare` script so husky installs on
+ * the next `npm install`. Mutates `pkg.scripts` (caller persists package.json).
+ */
+export function setupHusky(cwd, pkg) {
+    if (!pkg.scripts)
+        pkg.scripts = {};
+    if (!pkg.scripts.prepare)
+        pkg.scripts.prepare = 'husky';
+    const huskyDir = path.resolve(cwd, '.husky');
+    fs.ensureDirSync(huskyDir);
+    fs.writeFileSync(path.join(huskyDir, 'pre-commit'), `${CLI_NAME} commit-file-scan\n`, 'utf8');
+    fs.writeFileSync(path.join(huskyDir, 'commit-msg'), `${CLI_NAME} commit-msg-scan "$1"\n`, 'utf8');
+}

package/dist/actions/init/write-vscode.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Write (and merge) only the `.vscode/*` config into the project.
+ */
+export declare function writeVSCodeConfig(cwd: string, data: Record<string, unknown>): void;

package/dist/actions/init/write-vscode.js

@@ -0,0 +1,7 @@
+import generateTemplate from '../../utils/generate-template.js';
+/**
+ * Write (and merge) only the `.vscode/*` config into the project.
+ */
+export function writeVSCodeConfig(cwd, data) {
+    generateTemplate(cwd, data, true);
+}

package/dist/actions/scan/index.d.ts

@@ -0,0 +1,5 @@
+import type { ScanOptions, ScanReport } from '../../types.js';
+/**
+ * Read project config, run the linters, and (optionally) write a JSON report.
+ */
+export default function scan(options: ScanOptions): Promise<ScanReport>;

package/dist/actions/scan/index.js

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CLI_NAME } from '../../utils/constants.js';
+import { readLinterSpecConfig } from '../../utils/read-config.js';
+import { orchestrate } from './orchestrate.js';
+/**
+ * Read project config, run the linters, and (optionally) write a JSON report.
+ */
+export default async function scan(options) {
+    const { cwd, outputReport, config: inlineConfig } = options;
+    const pkgPath = path.resolve(cwd, 'package.json');
+    const pkg = fs.existsSync(pkgPath) ? fs.readJSONSync(pkgPath) : {};
+    const config = inlineConfig || (await readLinterSpecConfig(cwd));
+    const report = await orchestrate(options, pkg, config);
+    if (outputReport) {
+        const reportPath = path.resolve(cwd, `./${CLI_NAME}-report.json`);
+        await fs.outputFile(reportPath, JSON.stringify(report.results, null, 2));
+    }
+    return report;
+}

package/dist/actions/scan/orchestrate.d.ts

@@ -0,0 +1,6 @@
+import type { Config, PKG, ScanOptions, ScanReport } from '../../types.js';
+/**
+ * Run the enabled linters over the project and collect a unified report.
+ * Each linter is isolated so one crashing does not abort the others.
+ */
+export declare function orchestrate(options: ScanOptions, pkg: PKG, config: Config): Promise<ScanReport>;

package/dist/actions/scan/orchestrate.js

@@ -0,0 +1,49 @@
+import { doESLint, doMarkdownlint, doPrettier, doStylelint } from '../../lints/index.js';
+/**
+ * Run the enabled linters over the project and collect a unified report.
+ * Each linter is isolated so one crashing does not abort the others.
+ */
+export async function orchestrate(options, pkg, config) {
+    const { fix } = options;
+    const runErrors = [];
+    let results = [];
+    // Prettier first (only on fix), so subsequent linters see formatted code.
+    if (fix && config.enablePrettier !== false) {
+        try {
+            await doPrettier(options);
+        }
+        catch (e) {
+            runErrors.push(e);
+        }
+    }
+    if (config.enableESLint !== false) {
+        try {
+            results = results.concat(await doESLint({ ...options, pkg, config }));
+        }
+        catch (e) {
+            runErrors.push(e);
+        }
+    }
+    if (config.enableStylelint !== false) {
+        try {
+            results = results.concat(await doStylelint({ ...options, pkg, config }));
+        }
+        catch (e) {
+            runErrors.push(e);
+        }
+    }
+    if (config.enableMarkdownlint !== false) {
+        try {
+            results = results.concat(await doMarkdownlint({ ...options, pkg, config }));
+        }
+        catch (e) {
+            runErrors.push(e);
+        }
+    }
+    return {
+        results,
+        errorCount: results.reduce((count, { errorCount }) => count + errorCount, 0),
+        warningCount: results.reduce((count, { warningCount }) => count + warningCount, 0),
+        runErrors,
+    };
+}

package/dist/actions/update.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Check for (and optionally install) a newer version of the CLI.
+ * @param install install the new version globally when found
+ */
+export default function update(install?: boolean): Promise<void>;

package/dist/actions/update.js

@@ -0,0 +1,61 @@
+import { execa } from 'execa';
+import ora from 'ora';
+import log from '../utils/log.js';
+import { detectPackageManager, addGlobalCommand } from '../utils/npm.js';
+import { messages } from '../utils/messages.js';
+import { PKG_NAME, PKG_VERSION } from '../utils/constants.js';
+/** Return the latest published version if it is newer than the local one. */
+async function checkLatestVersion() {
+    // Query the registry directly — package-manager agnostic, and avoids spawning
+    // a child process just to read one version string.
+    const res = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`);
+    if (!res.ok)
+        return null;
+    const data = (await res.json());
+    const latestVersion = data.version;
+    if (!latestVersion || PKG_VERSION === latestVersion)
+        return null;
+    // NOTE: simple numeric `x.y.z` comparison only — pre-release / build metadata
+    // (`1.0.0-beta.1`, `1.0.0+build.5`) is not handled. Our own releases are plain
+    // semver, so this holds; swap in the `semver` package if that ever changes.
+    const current = PKG_VERSION.split('.').map(Number);
+    const latest = latestVersion.split('.').map(Number);
+    for (let i = 0; i < current.length; i++) {
+        if ((current[i] ?? 0) > (latest[i] ?? 0))
+            return null;
+        if ((current[i] ?? 0) < (latest[i] ?? 0))
+            return latestVersion;
+    }
+    return null;
+}
+/**
+ * Check for (and optionally install) a newer version of the CLI.
+ * @param install install the new version globally when found
+ */
+export default async function update(install = true) {
+    const checking = ora(messages.updateChecking);
+    checking.start();
+    try {
+        const pm = detectPackageManager();
+        const latestVersion = await checkLatestVersion();
+        checking.stop();
+        if (latestVersion && install) {
+            const updating = ora(messages.updateFound(latestVersion));
+            updating.start();
+            const [command, args] = addGlobalCommand(pm, PKG_NAME);
+            await execa(command, args, { stdio: 'inherit' });
+            updating.stop();
+        }
+        else if (latestVersion) {
+            const [command, args] = addGlobalCommand(pm, `${PKG_NAME}@latest`);
+            log.warn(messages.updateHint(latestVersion, PKG_VERSION, [command, ...args].join(' ')));
+        }
+        else if (install) {
+            log.info(messages.updateNone);
+        }
+    }
+    catch (e) {
+        checking.stop();
+        log.error(e);
+    }
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { registerCommands } from './commands/index.js';
+import { messages } from './utils/messages.js';
+import { CLI_NAME, PKG_VERSION } from './utils/constants.js';
+const cwd = process.cwd();
+program.name(CLI_NAME).version(PKG_VERSION).description(messages.description);
+registerCommands(program, cwd);
+program.parse(process.argv);

package/dist/commands/commit-file-scan.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerCommitFileScan(program: Command, cwd: string): void;

package/dist/commands/commit-file-scan.js

@@ -0,0 +1,35 @@
+import ora from 'ora';
+import scan from '../actions/scan/index.js';
+import printReport from '../utils/print-report.js';
+import log from '../utils/log.js';
+import { getAmendFiles, getCommitFiles } from '../utils/git.js';
+import { hasLocalLintConfig, installProjectDepsIfMissing } from '../actions/init/install-deps.js';
+import { messages } from '../utils/messages.js';
+export function registerCommitFileScan(program, cwd) {
+    program
+        .command('commit-file-scan')
+        .description(messages.commitFileScanDescription)
+        .option('-s, --strict', messages.optStrict)
+        .action(async (cmd) => {
+        await installProjectDepsIfMissing(cwd, hasLocalLintConfig(cwd));
+        const files = await getAmendFiles({ cwd });
+        if (files)
+            log.warn(messages.notStaged(files));
+        const checking = ora();
+        checking.start(messages.runCommitChecking);
+        const { results, errorCount, warningCount } = await scan({
+            cwd,
+            include: cwd,
+            quiet: !cmd.strict,
+            files: await getCommitFiles({ cwd }),
+        });
+        if (errorCount > 0 || (cmd.strict && warningCount > 0)) {
+            checking.fail();
+            printReport(results, false);
+            process.exitCode = 1;
+        }
+        else {
+            checking.succeed();
+        }
+    });
+}

package/dist/commands/commit-msg-scan.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerCommitMsgScan(program: Command): void;

package/dist/commands/commit-msg-scan.js

@@ -0,0 +1,24 @@
+import spawn from 'cross-spawn';
+import { createRequire } from 'node:module';
+import { messages } from '../utils/messages.js';
+const require = createRequire(import.meta.url);
+export function registerCommitMsgScan(program) {
+    program
+        .command('commit-msg-scan [msgPath]')
+        .description(messages.commitMsgScanDescription)
+        .action((msgPath) => {
+        const editFile = msgPath || process.env.HUSKY_GIT_PARAMS || process.env.GIT_PARAMS || '.git/COMMIT_EDITMSG';
+        // Resolve @commitlint/cli from our own dependencies and run it via node,
+        // rather than assuming a `commitlint` binary is on PATH — it isn't when
+        // this CLI is installed globally into a project that lacks commitlint.
+        const commitlintBin = require.resolve('@commitlint/cli/cli.js');
+        const result = spawn.sync(process.execPath, [commitlintBin, '--edit', editFile], {
+            stdio: 'inherit',
+        });
+        if (result.status) {
+            // Propagate commitlint's own exit code to the git hook verbatim.
+            // eslint-disable-next-line n/no-process-exit
+            process.exit(result.status);
+        }
+    });
+}

package/dist/commands/fix.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerFix(program: Command, cwd: string): void;

package/dist/commands/fix.js

@@ -0,0 +1,26 @@
+import ora from 'ora';
+import scan from '../actions/scan/index.js';
+import printReport from '../utils/print-report.js';
+import { hasLocalLintConfig, installProjectDepsIfMissing } from '../actions/init/install-deps.js';
+import { messages } from '../utils/messages.js';
+export function registerFix(program, cwd) {
+    program
+        .command('fix')
+        .description(messages.fixDescription)
+        .option('-i, --include <dirpath>', messages.optInclude)
+        .option('--no-ignore', messages.optNoIgnore)
+        .action(async (cmd) => {
+        await installProjectDepsIfMissing(cwd, hasLocalLintConfig(cwd));
+        const checking = ora();
+        checking.start(messages.runFixing);
+        const { results } = await scan({
+            cwd,
+            fix: true,
+            include: cmd.include || cwd,
+            ignore: cmd.ignore,
+        });
+        checking.succeed();
+        if (results.length > 0)
+            printReport(results, true);
+    });
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+/** Register every CLI command on the commander program. */
+export declare function registerCommands(program: Command, cwd: string): void;

package/dist/commands/index.js

@@ -0,0 +1,15 @@
+import { registerInit } from './init.js';
+import { registerScan } from './scan.js';
+import { registerFix } from './fix.js';
+import { registerUpdate } from './update.js';
+import { registerCommitMsgScan } from './commit-msg-scan.js';
+import { registerCommitFileScan } from './commit-file-scan.js';
+/** Register every CLI command on the commander program. */
+export function registerCommands(program, cwd) {
+    registerInit(program, cwd);
+    registerScan(program, cwd);
+    registerFix(program, cwd);
+    registerCommitMsgScan(program);
+    registerCommitFileScan(program, cwd);
+    registerUpdate(program);
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerInit(program: Command, cwd: string): void;

package/dist/commands/init.js

@@ -0,0 +1,31 @@
+import init from '../actions/init/index.js';
+import { writeVSCodeConfig } from '../actions/init/write-vscode.js';
+import { readLinterSpecConfig } from '../utils/read-config.js';
+import { CliAbortError } from '../utils/errors.js';
+import log from '../utils/log.js';
+import { messages } from '../utils/messages.js';
+export function registerInit(program, cwd) {
+    program
+        .command('init')
+        .description(messages.initDescription)
+        .option('--vscode', messages.optVscode)
+        .action(async (cmd) => {
+        try {
+            if (cmd.vscode) {
+                const config = await readLinterSpecConfig(cwd);
+                writeVSCodeConfig(cwd, config);
+            }
+            else {
+                await init({ cwd, checkVersionUpdate: true });
+            }
+        }
+        catch (e) {
+            // User declined a destructive step — exit cleanly, not as a crash.
+            if (e instanceof CliAbortError) {
+                log.info(messages.conflictCancelled);
+                return;
+            }
+            throw e;
+        }
+    });
+}

package/dist/commands/scan.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerScan(program: Command, cwd: string): void;