feat(hooks): appending commit hook and creating new install script

Signed-off-by: Dhruv Arora <dhruv.arora1@autodesk.com>

Author: Dhruv-0-Arora

fission/README.md

@@ -132,4 +132,4 @@ These core systems make up the lion's share of the fission source code. Each sys
 | `assetpack`          | Downloads the assetpack and unzips/installs it in the correct location.                                                                         |
 | `assetpack:update`   | Downloads the assetpack and unzips/installs it in the correct location, replacing the old directory if it exists.                               |
 | `playwright:install` | Downloads the Playwright browsers.                                                                                                              |
-| `hooks:install`      | Points `core.hooksPath` at `fission/scripts/hooks`, enabling the Biome pre-commit hook. Run automatically by `init`.                            |
+| `prepare`            | Run automatically by `bun i`. Adds a line to `.git/hooks/pre-commit` which runs `scripts/hooks/pre-commit`.                                |

fission/package.json

@@ -27,7 +27,7 @@
     "assetpack:update": "bun update_manifest.ts && cd public && zip -FS -r assetpack.zip Downloadables -x '**/.*' -x '**/__MACOSX'",
     "assetpack:merge": "git checkout --theirs public/assetpack.zip && rm -rf public/Downloadables && tar -xf public/assetpack.zip -C public/ && git checkout --ours public/assetpack.zip && tar -xf public/assetpack.zip -C public/ && bun run assetpack:update",
     "playwright:install": "bun x playwright install",
-    "hooks:install": "git config core.hooksPath fission/scripts/hooks",
+    "prepare": "f=$(git rev-parse --git-path hooks/pre-commit 2>/dev/null) || exit 0; [ -e \"$f\" ] || printf '#!/bin/sh\\n' > \"$f\"; grep -q fission/scripts/hooks/pre-commit \"$f\" || printf 'sh ./fission/scripts/hooks/pre-commit\\n' >> \"$f\"; chmod +x \"$f\"",
     "lockfile:clean": "bun x replace-regex --from='https:\\/\\/npm.autodesk.com\\/artifactory\\/[a-zA-Z0-9_.\\/@-]*' --to='' ./bun.lock",
     "postinstall": "bun run lockfile:clean | bun x dev-null"
   },

fission/scripts/install-hooks.ts

@@ -0,0 +1,65 @@
+#!/usr/bin/env bun
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
+import { EOL } from "node:os"
+import { isAbsolute, join, resolve } from "node:path"
+import { execFileSync } from "node:child_process"
+
+const BEGIN_MARKER = "# >>> fission biome pre-commit (bun run hooks:install) >>>"
+const END_MARKER = "# <<< fission biome pre-commit <<<"
+
+const HOOK_BLOCK = [
+    BEGIN_MARKER,
+    '"$(git rev-parse --show-toplevel)/fission/scripts/hooks/pre-commit" "$@" || exit $?',
+    END_MARKER,
+].join("\n")
+
+function git(...args: string[]): string {
+    return execFileSync("git", args, { encoding: "utf8" }).trim()
+}
+
+function resolveHooksDir(): string {
+    let configuredPath: string | undefined
+    try {
+        configuredPath = git("config", "--get", "core.hooksPath")
+    } catch {
+        // no-op
+    }
+
+    if (configuredPath) {
+        return isAbsolute(configuredPath)
+            ? configuredPath
+            : resolve(git("rev-parse", "--show-toplevel"), configuredPath)
+    }
+
+    return join(resolve(git("rev-parse", "--git-common-dir")), "hooks")
+}
+
+const hooksDir = resolveHooksDir()
+const hookFile = join(hooksDir, "pre-commit")
+
+const existing = existsSync(hookFile) ? readFileSync(hookFile, "utf8") : undefined
+
+if (existing?.includes(BEGIN_MARKER)) {
+    console.log(`Biome pre-commit hook already installed in ${hookFile}`)
+    process.exit(0)
+}
+
+mkdirSync(hooksDir, { recursive: true })
+
+const contents =
+    existing === undefined
+        ? `#!/usr/bin/env sh\n\n${HOOK_BLOCK}\n`
+        : `${existing.replace(/\n*$/, "\n")}\n${HOOK_BLOCK}\n`
+
+writeFileSync(hookFile, contents)
+chmodSync(hookFile, 0o755)
+
+console.log(
+    [
+        existing === undefined
+            ? `Installed Biome pre-commit hook at ${hookFile}`
+            : `Appended Biome pre-commit hook to the existing ${hookFile}`,
+        "Bypass it for a single commit with: git commit --no-verify",
+        `Uninstall it by deleting the block between the "${BEGIN_MARKER.slice(2)}" markers.`,
+    ].join(EOL)
+)

fission/tsconfig.json

@@ -32,7 +32,7 @@
     "composite": true,
     "types": ["vite-plugin-glsl/ext"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx", "update_manifest.ts"],
+  "include": ["src/**/*.ts", "src/**/*.tsx", "update_manifest.ts", "scripts/**/*.ts"],
   "references": [
     {
       "path": "./tsconfig.node.json"