@regardio/dev 1.15.0 → 1.16.0

package/README.md

@@ -27,7 +27,7 @@ The goal is code that's correct, consistent, and a pleasure to work with.
 | **Testing** | Vitest, Playwright, Testing Library |
 | **Build** | TypeScript, tsx, Vite |
 | **Workflow** | Husky, GitLab Flow |
-| **CLI utilities** | exec-clean, exec-p, exec-s, exec-ts, flow-release, flow-ship, flow-hotfix, lint-biome, lint-md, lint-package |
+| **CLI utilities** | exec-clean, exec-p, exec-s, exec-ts, ship-staging, ship-production, ship-hotfix, lint-biome, lint-md, lint-package |
 
 ## Quick Start
 

package/dist/bin/{flow → ship}/hotfix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotfix.d.ts","sourceRoot":"","sources":["../../../src/bin/flow/hotfix.ts"],"names":[],"mappings":""}
+{"version":3,"file":"hotfix.d.ts","sourceRoot":"","sources":["../../../src/bin/ship/hotfix.ts"],"names":[],"mappings":""}

package/dist/bin/{flow → ship}/hotfix.js

@@ -7,7 +7,7 @@ const subArgs = process.argv.slice(3);
 if (subcommand === 'start') {
     const name = subArgs[0];
     if (!name) {
-        console.error('Usage: flow-hotfix start <name>');
+        console.error('Usage: ship-hotfix start <name>');
         process.exit(1);
     }
     const hotfixBranch = `hotfix/${name}`;
@@ -27,20 +27,20 @@ if (subcommand === 'start') {
     git('pull', '--ff-only', 'origin', 'production');
     git('checkout', '-b', hotfixBranch);
     console.log(`\n✅ Hotfix branch "${hotfixBranch}" created from production.`);
-    console.log('Apply your fix, then run: flow-hotfix finish <patch|minor> "description"');
+    console.log('Apply your fix, then run: ship-hotfix finish <patch|minor> "description"');
     process.exit(0);
 }
 if (subcommand === 'finish') {
     const bumpType = subArgs[0];
     const message = subArgs.slice(1).join(' ');
     if (!bumpType || !['patch', 'minor'].includes(bumpType)) {
-        console.error('Usage: flow-hotfix finish <patch|minor> "description"');
+        console.error('Usage: ship-hotfix finish <patch|minor> "description"');
         console.error('Hotfixes use patch or minor bumps only.');
         process.exit(1);
     }
     if (!message) {
         console.error('A description is required.');
-        console.error('Example: flow-hotfix finish patch "Fix critical auth bug"');
+        console.error('Example: ship-hotfix finish patch "Fix critical auth bug"');
         process.exit(1);
     }
     const currentBranch = gitRead('branch', '--show-current');
@@ -111,6 +111,6 @@ if (subcommand === 'finish') {
     process.exit(0);
 }
 console.error('Usage:');
-console.error('  flow-hotfix start <name>');
-console.error('  flow-hotfix finish <patch|minor> "description"');
+console.error('  ship-hotfix start <name>');
+console.error('  ship-hotfix finish <patch|minor> "description"');
 process.exit(1);

package/dist/bin/ship/production.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=production.d.ts.map

package/dist/bin/ship/production.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production.d.ts","sourceRoot":"","sources":["../../../src/bin/ship/production.ts"],"names":[],"mappings":""}

package/dist/bin/{flow/ship.js → ship/production.js}

@@ -5,8 +5,8 @@ import { branchExists, bumpVersion, confirm, git, gitRead, insertChangelog, runQ
 const args = process.argv.slice(2);
 const bumpType = args[0];
 if (!bumpType || !['patch', 'minor', 'major'].includes(bumpType)) {
-    console.error('Usage: flow-ship <patch|minor|major>');
-    console.error('Example: flow-ship minor');
+    console.error('Usage: ship-production <patch|minor|major>');
+    console.error('Example: ship-production minor');
     process.exit(1);
 }
 const currentBranch = gitRead('branch', '--show-current');

package/dist/bin/ship/staging.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=staging.d.ts.map

package/dist/bin/ship/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../../../src/bin/ship/staging.ts"],"names":[],"mappings":""}

package/dist/bin/{flow/release.js → ship/staging.js}

@@ -59,4 +59,4 @@ git('push', 'origin', 'staging');
 git('checkout', 'main');
 git('push', 'origin', 'main');
 console.log('\n✅ Changes deployed to staging');
-console.log('Run flow-ship <patch|minor|major> when ready to promote to production.');
+console.log('Run ship-production <patch|minor|major> when ready to promote to production.');

package/dist/bin/{flow → ship}/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/bin/flow/utils.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,MAAM,EAAE,KAAG,IAGvC,CAAC;AAMF,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,MAAM,EAAE,KAAG,MACa,CAAC;AAM1D,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAG1C,CAAC;AAKF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,MAS3D,CAAC;AAMF,eAAO,MAAM,eAAe,GAAI,eAAe,MAAM,EAAE,OAAO,MAAM,KAAG,IAetE,CAAC;AAKF,eAAO,MAAM,gBAAgB,QAAO,IAInC,CAAC;AAMF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAE0B,CAAC;AAOvE,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,gBAAoB,KAAG,OAe9D,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/bin/ship/utils.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,MAAM,EAAE,KAAG,IAGvC,CAAC;AAMF,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,MAAM,EAAE,KAAG,MACa,CAAC;AAM1D,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAG1C,CAAC;AAKF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,MAS3D,CAAC;AAMF,eAAO,MAAM,eAAe,GAAI,eAAe,MAAM,EAAE,OAAO,MAAM,KAAG,IAetE,CAAC;AAKF,eAAO,MAAM,gBAAgB,QAAO,IAInC,CAAC;AAMF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAE0B,CAAC;AAOvE,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,gBAAoB,KAAG,OAe9D,CAAC"}

package/dist/bin/ship/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../../src/bin/ship/utils.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "@regardio/dev",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "private": false,
   "description": "Regardio developer tooling for testing, linting, and build workflows",
   "keywords": [
@@ -61,13 +61,13 @@
     "exec-s": "dist/bin/exec/s.js",
     "exec-ts": "dist/bin/exec/ts.js",
     "exec-tsc": "dist/bin/exec/tsc.js",
-    "flow-hotfix": "dist/bin/flow/hotfix.js",
-    "flow-release": "dist/bin/flow/release.js",
-    "flow-ship": "dist/bin/flow/ship.js",
     "lint-biome": "dist/bin/lint/biome.js",
     "lint-commit": "dist/bin/lint/commit.js",
     "lint-md": "dist/bin/lint/md.js",
-    "lint-package": "dist/bin/lint/package.js"
+    "lint-package": "dist/bin/lint/package.js",
+    "ship-hotfix": "dist/bin/ship/hotfix.js",
+    "ship-production": "dist/bin/ship/production.js",
+    "ship-staging": "dist/bin/ship/staging.js"
   },
   "files": ["dist", "src"],
   "scripts": {
@@ -77,15 +77,15 @@
     "fix:biome": "biome check --write --unsafe .",
     "fix:md": "markdownlint-cli2 --fix",
     "fix:pkg": "tsx src/bin/lint/package.ts --fix",
-    "flow:hotfix": "tsx src/bin/flow/hotfix.ts",
-    "flow:release": "tsx src/bin/flow/release.ts",
-    "flow:ship": "tsx src/bin/flow/ship.ts",
     "lint": "run-s lint:md lint:biome",
     "lint:biome": "biome check .",
     "lint:md": "markdownlint-cli2",
     "lint:pkg": "tsx src/bin/lint/package.ts",
     "prepare": "husky",
     "report": "vitest run --coverage",
+    "ship:hotfix": "tsx src/bin/ship/hotfix.ts",
+    "ship:production": "tsx src/bin/ship/production.ts",
+    "ship:staging": "tsx src/bin/ship/staging.ts",
     "test": "run-p test:*",
     "test:unit": "vitest run",
     "typecheck": "tsc --noEmit"
@@ -98,7 +98,7 @@
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.2",
     "@total-typescript/ts-reset": "0.6.1",
-    "@types/node": "25.3.1",
+    "@types/node": "25.3.2",
     "@vitest/coverage-v8": "4.0.18",
     "@vitest/ui": "4.0.18",
     "husky": "9.1.7",

package/src/bin/{flow → ship}/hotfix.ts

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 /**
- * flow-hotfix: Manage hotfix branches based on production code.
+ * ship-hotfix: Manage hotfix branches based on production code.
  *
  * Usage:
- *   flow-hotfix start <name>                        - Create hotfix/<name> from production
- *   flow-hotfix finish <patch|minor> "description"  - Finish and propagate the hotfix
+ *   ship-hotfix start <name>                        - Create hotfix/<name> from production
+ *   ship-hotfix finish <patch|minor> "description"  - Finish and propagate the hotfix
  *
  * GitLab workflow:
  *   production → hotfix/<name> → production → staging → main
@@ -44,7 +44,7 @@ const subArgs = process.argv.slice(3);
 if (subcommand === 'start') {
   const name = subArgs[0];
   if (!name) {
-    console.error('Usage: flow-hotfix start <name>');
+    console.error('Usage: ship-hotfix start <name>');
     process.exit(1);
   }
 
@@ -72,7 +72,7 @@ if (subcommand === 'start') {
   git('checkout', '-b', hotfixBranch);
 
   console.log(`\n✅ Hotfix branch "${hotfixBranch}" created from production.`);
-  console.log('Apply your fix, then run: flow-hotfix finish <patch|minor> "description"');
+  console.log('Apply your fix, then run: ship-hotfix finish <patch|minor> "description"');
   process.exit(0);
 }
 
@@ -84,14 +84,14 @@ if (subcommand === 'finish') {
   const message = subArgs.slice(1).join(' ');
 
   if (!bumpType || !['patch', 'minor'].includes(bumpType)) {
-    console.error('Usage: flow-hotfix finish <patch|minor> "description"');
+    console.error('Usage: ship-hotfix finish <patch|minor> "description"');
     console.error('Hotfixes use patch or minor bumps only.');
     process.exit(1);
   }
 
   if (!message) {
     console.error('A description is required.');
-    console.error('Example: flow-hotfix finish patch "Fix critical auth bug"');
+    console.error('Example: ship-hotfix finish patch "Fix critical auth bug"');
     process.exit(1);
   }
 
@@ -205,6 +205,6 @@ if (subcommand === 'finish') {
 // Unknown subcommand
 // ---------------------------------------------------------------------------
 console.error('Usage:');
-console.error('  flow-hotfix start <name>');
-console.error('  flow-hotfix finish <patch|minor> "description"');
+console.error('  ship-hotfix start <name>');
+console.error('  ship-hotfix finish <patch|minor> "description"');
 process.exit(1);

package/src/bin/{flow/ship.ts → ship/production.ts}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 /**
- * flow-ship: Version and promote staging to production following the GitLab workflow.
+ * ship-production: Version and promote staging to production following the GitLab workflow.
  *
- * Usage: flow-ship <patch|minor|major>
+ * Usage: ship-production <patch|minor|major>
  *
  * GitLab workflow:
  *   staging → (version bump commit) → production
@@ -20,7 +20,7 @@
  * 7. Commits the version bump on staging
  * 8. Merges staging into production (fast-forward) and pushes
  * 9. Merges production back into main to carry the version commit forward
- * 10. Syncs staging with main so the next flow-release can ff-merge cleanly
+ * 10. Syncs staging with main so the next ship-staging can ff-merge cleanly
  * 11. Returns to main
  */
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
@@ -41,8 +41,8 @@ const args = process.argv.slice(2);
 const bumpType = args[0];
 
 if (!bumpType || !['patch', 'minor', 'major'].includes(bumpType)) {
-  console.error('Usage: flow-ship <patch|minor|major>');
-  console.error('Example: flow-ship minor');
+  console.error('Usage: ship-production <patch|minor|major>');
+  console.error('Example: ship-production minor');
   process.exit(1);
 }
 

package/src/bin/{flow/release.ts → ship/staging.ts}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 /**
- * flow-release: Deploy changes to staging following the GitLab workflow.
+ * ship-staging: Deploy changes to staging following the GitLab workflow.
  *
- * Usage: flow-release [message]
+ * Usage: ship-staging [message]
  *
  * GitLab workflow:
  *   main → staging  (staging deploy, no version bump yet)
  *
- * Versioning happens at ship time (flow-ship), not here.
+ * Versioning happens at ship time (ship-production), not here.
  * This keeps version numbers reserved for production-verified code.
  *
  * This script:
@@ -120,4 +120,4 @@ git('checkout', 'main');
 git('push', 'origin', 'main');
 
 console.log('\n✅ Changes deployed to staging');
-console.log('Run flow-ship <patch|minor|major> when ready to promote to production.');
+console.log('Run ship-production <patch|minor|major> when ready to promote to production.');

package/src/bin/{flow → ship}/utils.ts

@@ -1,5 +1,5 @@
 /**
- * Shared utilities for flow-release, flow-ship, and flow-hotfix.
+ * Shared utilities for ship-staging, ship-production, and ship-hotfix.
  *
  * Git commands use execFileSync (not a shell string) so user-provided
  * strings such as commit messages are never interpolated by the shell.

package/src/templates/release.yml

@@ -2,7 +2,7 @@
 # Copy this file to .github/workflows/release.yml in your package
 #
 # Required setup:
-# 1. Add "flow:release": "flow-release", "flow:ship": "flow-ship" to package.json scripts
+# 1. Add "ship:staging": "ship-staging", "ship:production": "ship-production" to package.json scripts
 # 2. Create staging and production branches:
 #    git checkout -b staging && git push -u origin staging
 #    git checkout -b production && git push -u origin production
@@ -10,8 +10,8 @@
 #    pnpm build && npm publish --access public
 #
 # Usage:
-# - Run `pnpm flow:release "message"` to deploy changes to staging
-# - Run `pnpm flow:ship patch|minor|major` to version, promote to production, and trigger this workflow
+# - Run `pnpm ship:staging "message"` to deploy changes to staging
+# - Run `pnpm ship:production patch|minor|major` to version, promote to production, and trigger this workflow
 
 name: Release
 

package/dist/bin/flow/release.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=release.d.ts.map

package/dist/bin/flow/release.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/bin/flow/release.ts"],"names":[],"mappings":""}

package/dist/bin/flow/ship.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=ship.d.ts.map

package/dist/bin/flow/ship.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../../src/bin/flow/ship.ts"],"names":[],"mappings":""}

package/dist/bin/flow/utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../../src/bin/flow/utils.test.ts"],"names":[],"mappings":""}