fix(ci): guard optional hook tooling

Keep dev-dependency-free installs working.
Prevent hooks from downloading fallback packages.

Generated-by: OpenAI Codex
Signed-off-by: Jiawei Zhao <Phoenix500526@163.com>

Author: Phoenix500526

.husky/pre-commit

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-npm exec -- biome check --staged --no-errors-on-unmatched
+npx --no -- biome check --staged --no-errors-on-unmatched
 node scripts/asf-license-headers.mjs check-staged
 node scripts/protocol-epoch-check.mjs --staged
 git diff --cached --check

package.json

@@ -26,7 +26,7 @@
     "apps/desktop"
   ],
   "scripts": {
-    "prepare": "husky",
+    "prepare": "node scripts/install-husky.mjs",
     "postinstall": "node scripts/apply-dependency-patches.mjs && node scripts/install-electron-with-retry.mjs",
     "lint": "biome lint .",
     "format": "biome format --write .",

scripts/install-husky.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+try {
+  const install = (await import('husky')).default;
+  process.stdout.write(install());
+} catch (error) {
+  if (
+    error instanceof Error &&
+    'code' in error &&
+    error.code === 'ERR_MODULE_NOT_FOUND' &&
+    error.message.includes("package 'husky'")
+  ) {
+    console.warn('husky is not installed; skipping Git hook setup.');
+  } else {
+    throw error;
+  }
+}