chore(clean-build): script to reset everything to a clean slate (#161)

With lefthook setup I kept running into an error after running `git
clean -fdx && yarn && yarn build` where it couldn't run linting inside
the RSC installer package. This new script fixes that, and also includes
some nice safeguards that would have saved me some grief in the past had
I had them in place then :D

Author: Tobbe

package.json

@@ -14,7 +14,6 @@
   "scripts": {
     "build": "nx run-many -t build",
     "build:clean": "node ./tasks/clean.mjs",
-    "build:clean:super": "git clean -fdx && yarn && yarn build",
     "build:pack": "nx run-many -t build:pack",
     "build:test-project": "node ./tasks/test-project/test-project",
     "build:watch": "lerna run build:watch --parallel; tsc --build",
@@ -27,6 +26,7 @@
     "format": "prettier . --write",
     "format:check": "prettier . --check",
     "generate-dependency-graph": "node ./tasks/generateDependencyGraph.mjs",
+    "git-clean-build": "node $(git rev-parse --show-toplevel)/tasks/git-clean-build.mjs",
     "install:all": "concurrently -g -c auto -n install:fw \"yarn install\" npm:install:crwrsca",
     "install:ci": "concurrently -g -c auto -n install:fw:ci \"yarn install --inline-builds\" npm:install:crwrsca:ci",
     "install:crwrsca": "yarn --cwd packages/create-cedar-rsc-app install",

tasks/git-clean-build.mjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+/* eslint-env node */
+
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+import { $, question } from 'zx'
+
+// Get the directory of this script
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Get the repo root (parent of tasks directory)
+const repoRoot = path.resolve(__dirname, '..')
+
+const originalCwd = process.cwd()
+
+const restoreCwd = () => {
+  process.chdir(originalCwd)
+}
+
+process.on('exit', restoreCwd)
+process.on('SIGINT', restoreCwd)
+process.on('SIGTERM', restoreCwd)
+process.on('uncaughtException', (error) => {
+  console.error('Uncaught exception:', error)
+  restoreCwd()
+  process.exit(1)
+})
+
+try {
+  console.log(`Original directory: ${originalCwd}`)
+  console.log(`Repo root: ${repoRoot}`)
+
+  process.chdir(repoRoot)
+
+  console.log('Checking for untracked files...')
+  const statusResult =
+    await $`git status --porcelain --untracked-files=all`.quiet()
+  const untrackedFiles = statusResult.stdout
+    .trim()
+    .split('\n')
+    .filter((line) => line.startsWith('??'))
+    .map((line) => line.substring(3))
+    .filter((file) => file.trim())
+
+  if (untrackedFiles.length > 0) {
+    console.log(
+      `\n⚠️  WARNING: git clean -fdx will delete ${untrackedFiles.length} untracked files/directories:`,
+    )
+
+    if (untrackedFiles.length <= 5) {
+      untrackedFiles.forEach((file) => {
+        console.log(`  - ${file}`)
+      })
+    } else {
+      console.log(
+        `  (${untrackedFiles.length} files/directories - too many to list)`,
+      )
+    }
+
+    const confirmed = await question('\nDo you want to proceed? (y/N): ')
+    if (!confirmed || !['y', 'yes'].includes(confirmed.toLowerCase())) {
+      console.log('Operation cancelled.')
+      process.exit(0)
+    }
+  }
+
+  console.log('Running git clean -fdx...')
+  await $`git clean -fdx`
+
+  console.log('Running yarn install...')
+  await $`yarn install`
+
+  console.log('Running yarn build...')
+  await $`yarn build`
+
+  console.log('Installing dependencies in packages/create-cedar-rsc-app...')
+  const createCedarRscAppPath = path.join(
+    repoRoot,
+    'packages/create-cedar-rsc-app',
+  )
+  process.chdir(createCedarRscAppPath)
+  await $`yarn install`
+
+  console.log('All tasks completed successfully!')
+  console.log(`Returning to original directory: ${originalCwd}`)
+} catch (error) {
+  console.error('Error during clean-build process:', error)
+  process.exit(1)
+}