@tzwzx/codesweep 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tzwzx
+
+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,102 @@
+# codesweep
+
+[![npm version](https://img.shields.io/npm/v/@tzwzx/codesweep.svg)](https://www.npmjs.com/package/@tzwzx/codesweep)
+[![license](https://img.shields.io/npm/l/@tzwzx/codesweep.svg)](./LICENSE)
+
+Run lint, format, typecheck, test, and other code quality commands in one go. Configure each project with a YAML file.
+
+## Requirements
+
+- Node.js >= 22 (or Bun >= 1)
+
+## Install
+
+```bash
+# npm
+npm install @tzwzx/codesweep
+
+# bun
+bun add @tzwzx/codesweep
+
+# pnpm
+pnpm add @tzwzx/codesweep
+```
+
+After install, the `codesweep` binary is available via `npx @tzwzx/codesweep`, `bunx @tzwzx/codesweep`, or `./node_modules/.bin/codesweep`.
+
+## CLI usage
+
+```bash
+codesweep <mode> [options]
+```
+
+- **mode** — Any mode defined in `codesweep.yml` (for example `check` or `fix`).
+- **`--config` / `-c <path>`** — Path to the config file (default: `./codesweep.yml`).
+- **`--help` / `-h`** — Show help.
+
+Examples:
+
+```bash
+codesweep check
+codesweep fix
+codesweep check --config ./packages/app/codesweep.yml
+```
+
+Exit code `0` on success, `1` on failure. Elapsed time is printed when the run finishes.
+
+## Library usage
+
+```ts
+import { codesweep } from "@tzwzx/codesweep";
+
+await codesweep("check");
+await codesweep("fix", "./custom.yml");
+```
+
+You can also import helpers such as `loadConfig`, `runParallel`, and `runSequential` from the same package.
+
+## Config: `codesweep.yml`
+
+Define one or more **modes**. Each mode is an ordered list of **stages**. Each stage is either `parallel` or `sequential`, and holds a non-empty array of shell command strings.
+
+Example:
+
+```yaml
+check:
+  - parallel:
+      - bun lint
+      - bun tsc
+      - bun test
+
+fix:
+  - sequential:
+      - bun fix
+  - parallel:
+      - bun tsc
+      - bun test
+```
+
+### Behavior
+
+- **Stages** run one after another (stage 2 starts after stage 1 finishes).
+- **Within a stage**, `parallel` runs commands concurrently; `sequential` runs them in order.
+- **Fail-through**: If one command in a stage fails, other commands in that stage still run; the stage then fails as a whole.
+
+### Validation rules
+
+- The config must be a non-empty object.
+- Each mode’s value must be an array of stages.
+- Each stage must have exactly one of `parallel` or `sequential` (not both).
+- Command lists must be non-empty arrays of non-empty strings.
+
+## Development
+
+```bash
+bun install
+bun run build   # outputs to dist/
+bun run dev     # tsc --watch
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * codesweep CLI - Run code quality checks in one command
+ *
+ * Usage:
+ *   codesweep <mode> [--config path]
+ *
+ * Examples:
+ *   codesweep check                       # Run quality checks
+ *   codesweep fix                         # Auto-fix then check
+ *   codesweep check --config ./custom.yml # Use custom config file
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/cli.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * codesweep CLI - Run code quality checks in one command
+ *
+ * Usage:
+ *   codesweep <mode> [--config path]
+ *
+ * Examples:
+ *   codesweep check                       # Run quality checks
+ *   codesweep fix                         # Auto-fix then check
+ *   codesweep check --config ./custom.yml # Use custom config file
+ */
+import process from "node:process";
+import { parseArgs } from "node:util";
+import { codesweep } from "./index.js";
+const HELP_TEXT = `
+codesweep - Run code quality checks in one command 🧹
+
+Usage:
+  codesweep <mode> [options]
+
+Modes:
+  Any mode defined in your codesweep.yml (e.g. check, fix, ...)
+
+Options:
+  --config, -c <path>   Path to config file (default: ./codesweep.yml)
+  --help, -h            Show help
+`;
+const main = async () => {
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = parseArgs({
+            allowPositionals: true,
+            args: process.argv.slice(2),
+            options: {
+                config: { short: "c", type: "string" },
+                help: { short: "h", type: "boolean" },
+            },
+        }));
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+    if (values.help) {
+        console.log(HELP_TEXT);
+        process.exit(0);
+    }
+    const [mode] = positionals;
+    if (!mode) {
+        console.log(HELP_TEXT);
+        process.exit(1);
+    }
+    try {
+        await codesweep(mode, values.config);
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};
+// Guard against any unexpected rejection escaping main() so the process
+// always exits with a non-zero code instead of an unhandled rejection.
+try {
+    await main();
+}
+catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,SAAS,GAAG;;;;;;;;;;;;CAYjB,CAAC;AAEF,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,IAAI,MAA2C,CAAC;IAChD,IAAI,WAAqB,CAAC;IAE1B,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;YACnC,gBAAgB,EAAE,IAAI;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3B,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACtC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;aACtC;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;IAE3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEF,wEAAwE;AACxE,uEAAuE;AACvE,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import type { ParallelStage, SequentialStage, Stage, CodesweepConfig } from "./types.js";
+export declare const isParallelStage: (stage: Stage) => stage is ParallelStage;
+export declare const isSequentialStage: (stage: Stage) => stage is SequentialStage;
+export declare const loadConfig: (configPath?: string) => CodesweepConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIzF,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAAoC,CAAC;AAE7F,eAAO,MAAM,iBAAiB,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,eAAwC,CAAC;AA2DnG,eAAO,MAAM,UAAU,GAAI,aAAa,MAAM,KAAG,eAchD,CAAC"}

package/dist/config.js

@@ -0,0 +1,64 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { parse } from "yaml";
+const DEFAULT_CONFIG_FILENAME = "codesweep.yml";
+export const isParallelStage = (stage) => "parallel" in stage;
+export const isSequentialStage = (stage) => "sequential" in stage;
+const validateStage = (stage, modeName, index) => {
+    if (typeof stage !== "object" || stage === null) {
+        throw new Error(`${modeName}[${index}]: Stage must be an object`);
+    }
+    const record = stage;
+    const hasParallel = "parallel" in record;
+    const hasSequential = "sequential" in record;
+    if (!hasParallel && !hasSequential) {
+        throw new Error(`${modeName}[${index}]: Stage must have a "parallel" or "sequential" key`);
+    }
+    if (hasParallel && hasSequential) {
+        throw new Error(`${modeName}[${index}]: Stage cannot have both "parallel" and "sequential"`);
+    }
+    const commands = hasParallel ? record.parallel : record.sequential;
+    if (!Array.isArray(commands) || commands.length === 0) {
+        throw new Error(`${modeName}[${index}]: Command list must be a non-empty array`);
+    }
+    for (const command of commands) {
+        if (typeof command !== "string" || command.trim() === "") {
+            throw new Error(`${modeName}[${index}]: Each command must be a non-empty string`);
+        }
+    }
+};
+const validateConfig = (config) => {
+    if (typeof config !== "object" || config === null || Array.isArray(config)) {
+        throw new Error("Config file must be an object");
+    }
+    const record = config;
+    const modes = Object.keys(record);
+    if (modes.length === 0) {
+        throw new Error("Config must define at least one mode");
+    }
+    for (const mode of modes) {
+        const stages = record[mode];
+        if (!Array.isArray(stages)) {
+            throw new TypeError(`"${mode}": Stage list must be an array`);
+        }
+        for (const [index, stage] of stages.entries()) {
+            validateStage(stage, mode, index);
+        }
+    }
+    return record;
+};
+export const loadConfig = (configPath) => {
+    const resolvedPath = configPath
+        ? path.resolve(configPath)
+        : path.resolve(process.cwd(), DEFAULT_CONFIG_FILENAME);
+    let content;
+    try {
+        content = readFileSync(resolvedPath, "utf-8");
+    }
+    catch {
+        throw new Error(`Config file not found: ${resolvedPath}`);
+    }
+    const parsed = parse(content);
+    return validateConfig(parsed);
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { Mode } from "./types.js";
+export type { CodesweepConfig, Stage, ParallelStage, SequentialStage, Mode } from "./types.js";
+export { isParallelStage, isSequentialStage, loadConfig } from "./config.js";
+export { runParallel, runSequential } from "./runner.js";
+/**
+ * Load the config file, then run the pipeline for the given mode.
+ *
+ * Stages run one after another; within a stage, commands run in parallel or
+ * sequentially as configured. Resolves when every command succeeds.
+ *
+ * @param mode - Mode name to run (must be defined in the config file).
+ * @param configPath - Path to the config file (default: `./codesweep.yml`).
+ * @throws {Error} If the mode is undefined, or any command in the pipeline fails.
+ */
+export declare const codesweep: (mode: Mode, configPath?: string) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBzD;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAU,MAAM,IAAI,EAAE,aAAa,MAAM,KAAG,OAAO,CAAC,IAAI,CAsB7E,CAAC"}

package/dist/index.js

@@ -0,0 +1,45 @@
+import { performance } from "node:perf_hooks";
+import { isParallelStage, loadConfig } from "./config.js";
+import { runParallel, runSequential } from "./runner.js";
+export { isParallelStage, isSequentialStage, loadConfig } from "./config.js";
+export { runParallel, runSequential } from "./runner.js";
+const MILLISECONDS_PER_SECOND = 1000;
+const formatDuration = (startTime) => ((performance.now() - startTime) / MILLISECONDS_PER_SECOND).toFixed(2);
+const runStage = (stage) => isParallelStage(stage) ? runParallel(stage.parallel) : runSequential(stage.sequential);
+const runPipeline = async (stages) => {
+    for (const stage of stages) {
+        // Stages run serially by design ("serial between stages"); parallelizing would break the contract.
+        // oxlint-disable-next-line no-await-in-loop
+        await runStage(stage);
+    }
+};
+/**
+ * Load the config file, then run the pipeline for the given mode.
+ *
+ * Stages run one after another; within a stage, commands run in parallel or
+ * sequentially as configured. Resolves when every command succeeds.
+ *
+ * @param mode - Mode name to run (must be defined in the config file).
+ * @param configPath - Path to the config file (default: `./codesweep.yml`).
+ * @throws {Error} If the mode is undefined, or any command in the pipeline fails.
+ */
+export const codesweep = async (mode, configPath) => {
+    const config = loadConfig(configPath);
+    const stages = config[mode];
+    if (!stages) {
+        const availableModes = Object.keys(config).join(", ");
+        throw new Error(`Mode "${mode}" is not defined in the config file (available: ${availableModes})`);
+    }
+    const startTime = performance.now();
+    try {
+        await runPipeline(stages);
+        const duration = formatDuration(startTime);
+        console.log(`\n✅ codesweep ${mode} passed (${duration}s)\n`);
+    }
+    catch (error) {
+        const duration = formatDuration(startTime);
+        console.error(`\n❌ codesweep ${mode} failed (${duration}s)\n`);
+        throw error;
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAU,EAAE,CACnD,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,uBAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAiB,EAAE,CAC/C,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAEzF,MAAM,WAAW,GAAG,KAAK,EAAE,MAAwB,EAAiB,EAAE;IACpE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,mGAAmG;QACnG,4CAA4C;QAC5C,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAU,EAAE,UAAmB,EAAiB,EAAE;IAChF,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,mDAAmD,cAAc,GAAG,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,YAAY,QAAQ,MAAM,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,YAAY,QAAQ,MAAM,CAAC,CAAC;QAC/D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Run commands sequentially (continues on failure).
+ * All commands run even if one fails; errors are collected and thrown at the end.
+ */
+export declare const runSequential: (commands: readonly string[]) => Promise<void>;
+/**
+ * Run commands in parallel (continues on failure).
+ * All commands run even if one fails; the error is thrown after all complete.
+ */
+export declare const runParallel: (commands: readonly string[]) => Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAU,UAAU,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAqB7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAe3E,CAAC"}

package/dist/runner.js

@@ -0,0 +1,61 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import concurrently from "concurrently";
+const execPromise = promisify(exec);
+const printCommandOutput = (stdout, stderr) => {
+    if (stdout) {
+        console.log(stdout);
+    }
+    if (stderr) {
+        console.error(stderr);
+    }
+};
+const runSingleCommand = async (command) => {
+    const { stdout, stderr } = await execPromise(command);
+    printCommandOutput(stdout, stderr);
+};
+/**
+ * Run commands sequentially (continues on failure).
+ * All commands run even if one fails; errors are collected and thrown at the end.
+ */
+export const runSequential = async (commands) => {
+    const errors = [];
+    for (const command of commands) {
+        try {
+            // Commands run one-by-one by design (sequential stage); parallelizing would defeat the purpose.
+            // oxlint-disable-next-line no-await-in-loop
+            await runSingleCommand(command);
+        }
+        catch (error) {
+            const { stdout, stderr } = error;
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`❌ Command failed: ${command}`);
+            printCommandOutput(stdout, stderr);
+            errors.push({ command, message });
+        }
+    }
+    if (errors.length > 0) {
+        const errorMessages = errors.map((e) => `${e.command}: ${e.message}`).join("\n");
+        throw new Error(`Sequential execution failed:\n${errorMessages}`);
+    }
+};
+/**
+ * Run commands in parallel (continues on failure).
+ * All commands run even if one fails; the error is thrown after all complete.
+ */
+export const runParallel = async (commands) => {
+    const commandObjects = commands.map((command) => ({ command }));
+    const { result } = concurrently(commandObjects, {
+        group: true,
+        killOthersOn: [],
+        prefix: "none",
+    });
+    try {
+        await result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Parallel execution failed: ${message}`, { cause: error });
+    }
+};
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,YAAY,MAAM,cAAc,CAAC;AAExC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAEpC,MAAM,kBAAkB,GAAG,CAAC,MAAe,EAAE,MAAe,EAAQ,EAAE;IACpE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAe,EAAiB,EAAE;IAChE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IACtD,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,QAA2B,EAAiB,EAAE;IAChF,MAAM,MAAM,GAA2C,EAAE,CAAC;IAE1D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,gGAAgG;YAChG,4CAA4C;YAC5C,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAA6C,CAAC;YACzE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;YAC9C,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,iCAAiC,aAAa,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,QAA2B,EAAiB,EAAE;IAC9E,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,cAAc,EAAE;QAC9C,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+/** Parallel execution stage */
+export interface ParallelStage {
+    parallel: string[];
+}
+/** Sequential execution stage */
+export interface SequentialStage {
+    sequential: string[];
+}
+/** Execution stage (parallel or sequential) */
+export type Stage = ParallelStage | SequentialStage;
+/** Mode name (any key defined in config) */
+export type Mode = string;
+/** Pipeline configuration (key = mode name, value = stages) */
+export type CodesweepConfig = Record<string, Stage[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,MAAM,KAAK,GAAG,aAAa,GAAG,eAAe,CAAC;AAEpD,4CAA4C;AAC5C,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAE1B,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@tzwzx/codesweep",
+  "version": "1.0.0",
+  "description": "Run code quality checks in one command 🧹",
+  "keywords": [
+    "cli",
+    "code-quality",
+    "formatter",
+    "linter",
+    "orchestrator",
+    "test-runner",
+    "typecheck"
+  ],
+  "homepage": "https://github.com/tzwzx/codesweep#readme",
+  "bugs": {
+    "url": "https://github.com/tzwzx/codesweep/issues"
+  },
+  "license": "MIT",
+  "author": "tzwzx",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tzwzx/codesweep.git"
+  },
+  "bin": {
+    "codesweep": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "oxfmt --check . && oxlint .",
+    "fix": "oxfmt --write . && oxlint --fix .",
+    "tsc": "tsc --noEmit",
+    "knip": "knip",
+    "syncpack": "syncpack lint",
+    "test": "bun test",
+    "codesweep:check": "node dist/cli.js check",
+    "codesweep:fix": "node dist/cli.js fix",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "concurrently": "10.0.3",
+    "yaml": "2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "26.0.1",
+    "knip": "6.23.0",
+    "oxfmt": "0.57.0",
+    "oxlint": "1.72.0",
+    "syncpack": "15.3.2",
+    "typescript": "6.0.3",
+    "ultracite": "7.8.3"
+  },
+  "engines": {
+    "bun": ">=1",
+    "node": ">=22"
+  }
+}