chore: rename project from quality-ratchet to boatman and update all references

Rafael Vieiras · Rafael Vieiras · commit 613002f008af · 2026-05-12T21:33:20.000-03:00
diff --git a/.github/workflows/quality-gate.yml b/.github/workflows/quality-gate.yml
@@ -1,5 +1,5 @@
-# quality-gate.yml — Generated by quality-ratchet
-# https://github.com/rafaelvieiras/quality-ratchet
+# quality-gate.yml — Generated by boatman
+# https://github.com/rafaelvieiras/boatman
 #
 # This workflow runs the quality gate on every push to main branches and PRs.
 # It compares metrics against baseline.json and blocks merges on regressions.
diff --git a/README.md b/README.md
@@ -1,8 +1,10 @@
-# quality-ratchet
+![boatman banner](https://raw.githubusercontent.com/rafaelvieiras/boatman/main/docs/boatman_banner.jpg)
+
+# boatman
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
-**quality-ratchet** is a zero-dependency CLI that installs a smart quality gate with a *ratchet mechanism* into any JavaScript or TypeScript project. It detects your stack automatically, presents the viable options, and generates the necessary files: a standalone gate script, a CI workflow, and npm scripts — all tailored to your project.
+**boatman** is a zero-dependency CLI that installs a smart quality gate with a *ratchet mechanism* into any JavaScript or TypeScript project. It detects your stack automatically, presents the viable options, and generates the necessary files: a standalone gate script, a CI workflow, and npm scripts — all tailored to your project.
 
 ---
 
@@ -22,25 +24,25 @@ The key insight: **you can never silently regress**. Every merge either holds th
 ## Quick Start
 
 ```bash
-npx quality-ratchet init
+npx boatman init
 ```
 
 Or target a specific directory:
 
 ```bash
-npx quality-ratchet init --path ./my-project
+npx boatman init --path ./my-project
 ```
 
 Accept all defaults without interactive prompts:
 
 ```bash
-npx quality-ratchet --yes
+npx boatman --yes
 ```
 
 Preview what would be generated without writing any files:
 
 ```bash
-npx quality-ratchet --dry-run
+npx boatman --dry-run
 ```
 
 ---
@@ -75,7 +77,7 @@ npx quality-ratchet --dry-run
 
 ## Generated Files
 
-After running `quality-ratchet init`, the following files are created or updated in your project:
+After running `boatman init`, the following files are created or updated in your project:
 
 ```
 your-project/
@@ -114,7 +116,7 @@ npx eslint src --ext ts,tsx --format json | node scripts/count-lint.mjs
 
 ## Complexity Check
 
-When the `complexity` check is enabled, quality-ratchet runs an ESLint scan with two specific rules applied on top of your existing config:
+When the `complexity` check is enabled, boatman runs an ESLint scan with two specific rules applied on top of your existing config:
 
 | Rule                    | Default threshold | Metric tracked               |
 |-------------------------|-------------------|------------------------------|
@@ -231,7 +233,7 @@ When running on GitHub Actions with the `pr-comment` check enabled, the gate pos
 > Run `npm run quality:baseline` to update the baseline with these improvements.
 
 ---
-*Generated by [quality-ratchet](https://github.com/rafaelvieiras/quality-ratchet)*
+*Generated by [boatman](https://github.com/rafaelvieiras/boatman)*
 ```
 
 When a regression is detected:
@@ -250,19 +252,19 @@ When a regression is detected:
 
 ## Zero Dependencies
 
-`quality-ratchet` uses only Node.js built-ins (`fs`, `path`, `readline`, `child_process`). The **generated** gate script is also standalone — it does not import anything from `quality-ratchet` at runtime.
+`boatman` uses only Node.js built-ins (`fs`, `path`, `readline`, `child_process`). The **generated** gate script is also standalone — it does not import anything from `boatman` at runtime.
 
 ---
 
 ## Contributing
 
 1. Fork the repository
 2. Create your feature branch: `git checkout -b feat/my-feature`
-3. Make your changes and ensure the CLI still works: `node bin/quality-ratchet.mjs --dry-run`
+3. Make your changes and ensure the CLI still works: `node bin/boatman.mjs --dry-run`
 4. Commit your changes: `git commit -m "feat: add my feature"`
 5. Open a pull request
 
-Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/rafaelvieiras/quality-ratchet/issues).
+Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/rafaelvieiras/boatman/issues).
 
 ---
 
diff --git a/baseline.json b/baseline.json
@@ -1,7 +1,7 @@
 {
   "generatedAt": "2026-05-10T18:12:57.603Z",
   "commit": "5c12a55",
-  "project": "quality-ratchet",
+  "project": "boatman",
   "metrics": {
     "eslint_errors": 0,
     "eslint_warnings": 0,
diff --git a/bin/boatman.mjs b/bin/boatman.mjs
@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 /**
- * quality-ratchet — Smart quality gate installer with ratchet mechanism
- * https://github.com/rafaelvieiras/quality-ratchet
+ * boatman — Smart quality gate installer with ratchet mechanism
+ * https://github.com/rafaelvieiras/boatman
  *
  * Usage:
- *   npx quality-ratchet [init] [--path <dir>] [--yes] [--dry-run]
- *   npx quality-ratchet help
+ *   npx boatman [init] [--path <dir>] [--yes] [--dry-run]
+ *   npx boatman help
  */
 
 import { run } from '../src/installer/index.mjs';
diff --git a/docs/boatman_banner.jpg b/docs/boatman_banner.jpg
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "quality-ratchet",
+  "name": "boatman",
   "version": "1.0.0",
   "description": "Smart quality gate installer with ratchet mechanism — prevents metric regressions in JavaScript/TypeScript projects",
   "type": "module",
   "bin": {
-    "quality-ratchet": "bin/quality-ratchet.mjs"
+    "boatman": "bin/boatman.mjs"
   },
   "files": [
     "bin/",
@@ -27,7 +27,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/rafaelvieiras/quality-ratchet"
+    "url": "https://github.com/rafaelvieiras/boatman"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
diff --git a/scripts/count-lint.mjs b/scripts/count-lint.mjs
@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * count-lint.mjs — Generated by quality-ratchet
+ * count-lint.mjs — Generated by boatman
  * Reads ESLint JSON output from stdin and prints error/warning counts.
  * Usage: npx eslint . --ext ts,tsx --format json | node scripts/count-lint.mjs
  */
diff --git a/scripts/quality-gate.mjs b/scripts/quality-gate.mjs
@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * quality-gate.mjs — Generated by quality-ratchet
- * Project: quality-ratchet
+ * quality-gate.mjs — Generated by boatman
+ * Project: boatman
  *
  * This script implements a ratchet-style quality gate:
  *  - Reads current metrics from report files
@@ -217,7 +217,7 @@ async function gatherMetrics() {
 
 // ─── Generate baseline ───────────────────────────────────────────────────────
 async function generateBaseline() {
-  log(`${c.bold}Generating quality baseline for quality-ratchet...${c.reset}\n`);
+  log(`${c.bold}Generating quality baseline for boatman...${c.reset}\n`);
   mkdirSync(join(ROOT, 'reports'), { recursive: true });
 
   log('Running ESLint...');
@@ -237,7 +237,7 @@ async function generateBaseline() {
   const baseline = {
     generatedAt: new Date().toISOString(),
     commit: (() => { try { return execSync('git rev-parse --short HEAD', { cwd: ROOT, stdio: 'pipe' }).toString().trim(); } catch { return 'unknown'; } })(),
-    project: 'quality-ratchet',
+    project: 'boatman',
     metrics,
   };
 
@@ -324,7 +324,7 @@ function fmtDelta(cur, base, lowerIsBetter) {
 // ─── Local (terminal) output ──────────────────────────────────────────────────
 function printLocal(current, result) {
   const { regressions, improvements, unchanged } = result;
-  log(`${c.bold}Quality Gate — quality-ratchet${c.reset}\n`);
+  log(`${c.bold}Quality Gate — boatman${c.reset}\n`);
 
   if (improvements.length > 0) {
     log(`${c.green}${c.bold}Improvements:${c.reset}`);
@@ -379,7 +379,7 @@ function printMarkdown(current, result) {
   const lines = [];
   lines.push(`## ${status}`);
   lines.push('');
-  lines.push(`**Project:** \`quality-ratchet\``);
+  lines.push(`**Project:** \`boatman\``);
   lines.push(`**Generated:** ${new Date().toISOString()}`);
   lines.push('');
 
@@ -426,7 +426,7 @@ function printMarkdown(current, result) {
   }
 
   lines.push(`---`);
-  lines.push(`*Generated by [quality-ratchet](https://github.com/rafaelvieiras/quality-ratchet)*`);
+  lines.push(`*Generated by [boatman](https://github.com/rafaelvieiras/boatman)*`);
 
   const markdown = lines.join('\n');
   log(markdown);
diff --git a/src/generators/count-lint-script.mjs b/src/generators/count-lint-script.mjs
@@ -7,7 +7,7 @@
 export function generateCountLintScript() {
   return `#!/usr/bin/env node
 /**
- * count-lint.mjs — Generated by quality-ratchet
+ * count-lint.mjs — Generated by boatman
  * Reads ESLint JSON output from stdin and prints error/warning counts.
  * Usage: npx eslint . --ext ts,tsx --format json | node scripts/count-lint.mjs
  */
diff --git a/src/generators/gate-script.mjs b/src/generators/gate-script.mjs
@@ -278,7 +278,7 @@ export function generateGateScript(config) {
 
   return `#!/usr/bin/env node
 /**
- * quality-gate.mjs — Generated by quality-ratchet
+ * quality-gate.mjs — Generated by boatman
  * Project: ${projectName}
  *
  * This script implements a ratchet-style quality gate:
@@ -545,7 +545,7 @@ function printMarkdown(current, result) {
   }
 
   lines.push(\`---\`);
-  lines.push(\`*Generated by [quality-ratchet](https://github.com/rafaelvieiras/quality-ratchet)*\`);
+  lines.push(\`*Generated by [boatman](https://github.com/rafaelvieiras/boatman)*\`);
 
   const markdown = lines.join('\\n');
   log(markdown);
diff --git a/src/generators/workflow-github.mjs b/src/generators/workflow-github.mjs
@@ -189,8 +189,8 @@ export function generateGithubWorkflow(config) {
 
   const stepsYaml = steps.join('\n');
 
-  return `# quality-gate.yml — Generated by quality-ratchet
-# https://github.com/rafaelvieiras/quality-ratchet
+  return `# quality-gate.yml — Generated by boatman
+# https://github.com/rafaelvieiras/boatman
 #
 # This workflow runs the quality gate on every push to main branches and PRs.
 # It compares metrics against baseline.json and blocks merges on regressions.
diff --git a/src/generators/workflow-gitlab.mjs b/src/generators/workflow-gitlab.mjs
@@ -175,8 +175,8 @@ ${needsYaml}  script:
 
   const jobsYaml = jobs.join('\n\n');
 
-  return `# .gitlab-ci.yml — Generated by quality-ratchet
-# https://github.com/rafaelvieiras/quality-ratchet
+  return `# .gitlab-ci.yml — Generated by boatman
+# https://github.com/rafaelvieiras/boatman
 #
 # This pipeline runs the quality gate on every push and MR.
 # It compares metrics against baseline.json and blocks merges on regressions.
diff --git a/src/installer/index.mjs b/src/installer/index.mjs
@@ -59,16 +59,16 @@ function parseArgs(argv) {
 function printBanner(version) {
   console.log('');
   console.log(`${BOLD}${CYAN}  ╔═══════════════════════════════════════╗${RESET}`);
-  console.log(`${BOLD}${CYAN}  ║       quality-ratchet  v${version.padEnd(13)}║${RESET}`);
+  console.log(`${BOLD}${CYAN}  ║       boatman          v${version.padEnd(13)}║${RESET}`);
   console.log(`${BOLD}${CYAN}  ║  Smart quality gate with ratchet  🔒  ║${RESET}`);
   console.log(`${BOLD}${CYAN}  ╚═══════════════════════════════════════╝${RESET}`);
   console.log('');
 }
 
 function printHelp() {
-  console.log(`${BOLD}quality-ratchet${RESET} — Smart quality gate installer with ratchet mechanism\n`);
+  console.log(`${BOLD}boatman${RESET} — Smart quality gate installer with ratchet mechanism\n`);
   console.log(`${BOLD}Usage:${RESET}`);
-  console.log(`  npx quality-ratchet [init] [options]\n`);
+  console.log(`  npx boatman [init] [options]\n`);
   console.log(`${BOLD}Commands:${RESET}`);
   console.log(`  init          Run the interactive installer (default)`);
   console.log(`  help          Show this help message\n`);
@@ -77,9 +77,9 @@ function printHelp() {
   console.log(`  --yes, -y     Accept all defaults without prompting`);
   console.log(`  --dry-run     Show what would be generated without writing files\n`);
   console.log(`${BOLD}Examples:${RESET}`);
-  console.log(`  npx quality-ratchet`);
-  console.log(`  npx quality-ratchet init --path ./my-project`);
-  console.log(`  npx quality-ratchet --yes --dry-run\n`);
+  console.log(`  npx boatman`);
+  console.log(`  npx boatman init --path ./my-project`);
+  console.log(`  npx boatman --yes --dry-run\n`);
 }
 
 function printStack(project) {
@@ -191,7 +191,7 @@ export async function run(args) {
 
   if (!project.hasPackageJson) {
     console.log(`  ${RED}✘${RESET} No package.json found at ${opts.path}`);
-    console.log(`  ${DIM}quality-ratchet only supports JavaScript/TypeScript projects.${RESET}\n`);
+    console.log(`  ${DIM}boatman only supports JavaScript/TypeScript projects.${RESET}\n`);
     close();
     return;
   }

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`		`-# quality-gate.yml — Generated by quality-ratchet`
`2`		`-# https://github.com/rafaelvieiras/quality-ratchet`
	`1`	`+# quality-gate.yml — Generated by boatman`
	`2`	`+# https://github.com/rafaelvieiras/boatman`
`3`	`3`	`#`
`4`	`4`	`# This workflow runs the quality gate on every push to main branches and PRs.`
`5`	`5`	`# It compares metrics against baseline.json and blocks merges on regressions.`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"generatedAt": "2026-05-10T18:12:57.603Z",`
`3`	`3`	`"commit": "5c12a55",`
`4`		`- "project": "quality-ratchet",`
	`4`	`+ "project": "boatman",`
`5`	`5`	`"metrics": {`
`6`	`6`	`"eslint_errors": 0,`
`7`	`7`	`"eslint_warnings": 0,`