@tahminator/pipeline 1.0.93 → 1.0.94-beta.g1c0747b4

package/README.md

@@ -30,6 +30,76 @@ bun run src/index.ts
 > [!WARNING]
 > This repository is iterating quickly & as such may have rough edges. I will always be happy to respond to & fix any issues anyone may have :)
 
+## CI script checks
+
+Enable `LINT_CI` to typecheck, lint, and check formatting without a `test` script:
+
+```yaml
+- uses: tahminator/pipeline/actions/setup@<published-commit-sha>
+  with:
+    GITHUB_SCRIPTS_DIR: ./.github/scripts
+    LINT_CI: true
+```
+
+The setup action installs the CI package's dependencies with
+`bun install --frozen-lockfile`, then runs these internal Bun scripts from
+`GITHUB_SCRIPTS_DIR`:
+
+1. `src/internal/tsc.ts`: runs the package's TypeScript compiler with
+   `--noEmit`, using TypeScript's normal config discovery.
+2. `src/internal/lintfmt.ts`: runs the package's Oxlint, then `oxfmt --check`.
+   Both run even if Oxlint reports errors.
+
+The scripts do not require specific config filenames or pass config paths.
+Each tool handles its own supported formats, discovery, defaults, and config errors.
+For example, Oxlint supports
+[JSON, JSONC, and TypeScript configs](https://oxc.rs/docs/guide/usage/linter/config.html),
+and TypeScript searches for `tsconfig.json` in the current directory and its ancestors.
+
+All three tools resolve from the CI scripts package, not from the action's dependencies.
+Add them as devDependencies in that package and commit the updated `package.json`
+and `bun.lock`:
+
+```sh
+bun add --cwd .github/scripts -d typescript oxlint oxfmt
+```
+
+An optional Oxlint configuration could look like this:
+
+```ts
+// .github/scripts/oxlint.config.ts
+export default {
+  ignorePatterns: ["node_modules/**"],
+  rules: {
+    "no-debugger": "error",
+    "no-unused-vars": "error",
+  },
+};
+```
+
+Oxfmt uses its native configuration discovery, or its defaults when no formatter
+config exists. To create a formatter config, run `bun run oxfmt --init` from the CI
+scripts package directory.
+
+Missing tools or launchers produce actionable errors. Config, type, lint, or
+formatting errors fail the step; a failed typecheck stops before linting
+and formatting. No tools are downloaded by these scripts, no files are emitted or
+autofixed, and no tests run. `LINT_CI` remains disabled by default.
+
+Lint and formatting failures print the relevant local fix command. Run these from
+your CI scripts package directory, then review the changes:
+
+```sh
+bun run oxlint --fix
+bun run oxfmt --write
+```
+
+Oxlint can only autofix supported rules; other lint issues and TypeScript errors
+require manual fixes.
+
+Previously, `LINT_CI` invoked the consumer's `test` script. It now runs only these
+internal scripts; a `test` script is neither required nor invoked.
+
 ## Slash commands action
 
 Use [`actions/commands`](./actions/commands/README.md) to run your repository's workflows from PR comments such as `/merge` or `/ai`.

package/dist/internal/lintfmt.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal/lintfmt.js

@@ -0,0 +1,51 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+async function main() {
+    const tools = [
+        {
+            name: "oxlint",
+            args: [],
+            fix: "For lint issues that support autofix, run `bun run oxlint --fix` from your CI scripts package directory. Other issues require manual fixes.",
+        },
+        {
+            name: "oxfmt",
+            args: ["--check"],
+            fix: "To fix formatting, run `bun run oxfmt --write` from your CI scripts package directory.",
+        },
+    ];
+    for (const tool of tools) {
+        let launcher;
+        try {
+            const manifest = Bun.resolveSync(`${tool.name}/package.json`, process.cwd());
+            launcher = join(dirname(manifest), "bin", tool.name);
+        }
+        catch (error) {
+            if (!(error instanceof Error) ||
+                !("code" in error) ||
+                (error.code !== "MODULE_NOT_FOUND" &&
+                    error.code !== "ERR_MODULE_NOT_FOUND")) {
+                throw error;
+            }
+        }
+        if (!launcher || !existsSync(launcher)) {
+            console.error(`pipeline: ${tool.name} is missing. Add ${tool.name} as a devDependency to your CI scripts package.json by running \`bun add -d ${tool.name}\` in that directory.`);
+            process.exitCode = 1;
+            continue;
+        }
+        const child = Bun.spawn([process.execPath, launcher, ...tool.args], {
+            stdin: "inherit",
+            stdout: "inherit",
+            stderr: "inherit",
+        });
+        const exitCode = await child.exited;
+        if (child.signalCode) {
+            process.kill(process.pid, child.signalCode);
+            return;
+        }
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+            console.error(`pipeline: ${tool.fix}`);
+        }
+    }
+}
+await main();

package/dist/internal/tsc.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal/tsc.js

@@ -0,0 +1,33 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+async function main() {
+    let launcher;
+    try {
+        const manifest = Bun.resolveSync("typescript/package.json", process.cwd());
+        launcher = join(dirname(manifest), "bin/tsc");
+    }
+    catch (error) {
+        if (!(error instanceof Error) ||
+            !("code" in error) ||
+            (error.code !== "MODULE_NOT_FOUND" &&
+                error.code !== "ERR_MODULE_NOT_FOUND")) {
+            throw error;
+        }
+    }
+    if (!launcher || !existsSync(launcher)) {
+        console.error("pipeline: TypeScript is missing. Add typescript as a devDependency to your CI scripts package.json by running `bun add -d typescript` in that directory.");
+        process.exitCode = 1;
+        return;
+    }
+    const child = Bun.spawn([process.execPath, launcher, "--noEmit"], {
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+    });
+    const exitCode = await child.exited;
+    if (child.signalCode)
+        process.kill(process.pid, child.signalCode);
+    else
+        process.exitCode = exitCode;
+}
+await main();

package/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "author": "Tahmid Ahmed",
   "description": "A collection of Bun shell scripts that can be re-used in various CICD pipelines.",
-  "version": "1.0.93",
+  "version": "1.0.94-beta.g1c0747b4",
   "repository": {
     "url": "git+https://github.com/tahminator/pipeline.git"
   },