feat(logger): Logger拡張・JSTタイムスタンプ追加・スクリプトTS化

package.json

@@ -5,14 +5,14 @@
   "scripts": {
     "lint": "npx oxlint src/",
     "test": "npx vitest run",
-    "test:e2e": "node scripts/e2e.mjs",
+    "test:e2e": "npx tsx scripts/e2e.ts",
     "build": "npx tsc --noEmit --pretty || true",
     "build:hooks-pre-tool-validate": "cd .claude/hooks-pre-tool-validate && cargo build --release && cp target/release/hooks-pre-tool-validate.exe ../hooks-pre-tool-validate.exe",
     "build:hooks-post-tool-linter": "cd .claude/hooks-post-tool-linter && cargo build --release && cp target/release/hooks-post-tool-linter.exe ../hooks-post-tool-linter.exe",
     "build:hooks-stop-quality": "cd .claude/hooks-stop-quality && cargo build --release && cp target/release/hooks-stop-quality.exe ../hooks-stop-quality.exe",
     "build:hooks-settings": "node -e \"const fs=require('fs');const t=fs.readFileSync('.claude/settings.local.json.template','utf8');const p=process.cwd().replace(/\\\\/g,'\\\\\\\\');fs.writeFileSync('.claude/settings.local.json',t.replace(/\\{\\{PROJECT_DIR\\}\\}/g,p))\" && echo settings.local.json generated",
     "build:hooks": "pnpm build:hooks-pre-tool-validate && pnpm build:hooks-post-tool-linter && pnpm build:hooks-stop-quality && pnpm build:hooks-settings",
-    "deploy:hooks": "node scripts/deploy-hooks.js",
+    "deploy:hooks": "npx tsx scripts/deploy-hooks.ts",
     "py-lint": "ruff check src/",
     "py-test": "python -m pytest tests/",
     "py-typecheck": "mypy src/",

scripts/deploy-hooks.ts

@@ -0,0 +1,169 @@
+/**
+ * hooks exe を派生プロジェクトに一括配布するスクリプト
+ *
+ * 動作:
+ *   1. deploy-targets.json からターゲットプロジェクト一覧を読み込み
+ *   2. 各ターゲットの .claude/ ディレクトリに exe をコピー
+ *   3. settings.local.json.template を解決して settings.local.json を生成
+ *   4. hooks-config.toml が存在しない場合は作成を促すメッセージを表示
+ *
+ * 使い方: pnpm deploy:hooks
+ */
+
+import { existsSync, readFileSync, writeFileSync, copyFileSync, mkdirSync } from "node:fs";
+import { resolve, join, basename } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger } from "../src/logger";
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const ROOT = resolve(__dirname, "..");
+const CLAUDE_DIR = join(ROOT, ".claude");
+
+const EXE_FILES = [
+  "hooks-pre-tool-validate.exe",
+  "hooks-post-tool-linter.exe",
+  "hooks-stop-quality.exe",
+];
+
+const SETTINGS_TEMPLATE = "settings.local.json.template";
+
+interface DeployTargets {
+  targets?: string[];
+}
+
+function loadTargets(): string[] {
+  const targetsPath = join(__dirname, "deploy-targets.json");
+  if (!existsSync(targetsPath)) {
+    logger.error("deploy-targets.json not found.");
+    logger.error("Copy deploy-targets.template.json and fill in your local paths:");
+    logger.error("  cp scripts/deploy-targets.template.json scripts/deploy-targets.json");
+    process.exit(1);
+  }
+  try {
+    const parsed: unknown = JSON.parse(readFileSync(targetsPath, "utf8"));
+    const targets =
+      parsed &&
+      typeof parsed === "object" &&
+      !Array.isArray(parsed) &&
+      Array.isArray((parsed as DeployTargets).targets) &&
+      (parsed as DeployTargets).targets!.every((t) => typeof t === "string")
+        ? (parsed as DeployTargets).targets!
+        : null;
+    if (!targets) {
+      throw new Error("`targets` must be string[]");
+    }
+    return targets;
+  } catch (e) {
+    logger.error("Failed to parse deploy-targets.json:", (e as Error).message);
+    process.exit(1);
+  }
+}
+
+function copyFile(src: string, dest: string): void {
+  copyFileSync(src, dest);
+  logger.info(`  copied: ${basename(src)}`);
+}
+
+function deployTo(targetDir: string): boolean {
+  const targetClaude = join(targetDir, ".claude");
+
+  if (!existsSync(targetDir)) {
+    logger.warn(`  SKIP: project directory does not exist: ${targetDir}`);
+    return false;
+  }
+
+  if (!existsSync(targetClaude)) {
+    mkdirSync(targetClaude, { recursive: true });
+  }
+
+  for (const exe of EXE_FILES) {
+    const src = join(CLAUDE_DIR, exe);
+    if (!existsSync(src)) {
+      logger.warn(`  ${exe} not found (run pnpm build:hooks first)`);
+      continue;
+    }
+    copyFile(src, join(targetClaude, exe));
+  }
+
+  const configDest = join(targetClaude, "hooks-config.toml");
+  if (!existsSync(configDest)) {
+    logger.info(
+      "  NOTE: hooks-config.toml not found — please create one for this project"
+    );
+    logger.info(
+      "        See templates/ directory for language-specific examples"
+    );
+  }
+
+  const templateSrc = join(CLAUDE_DIR, SETTINGS_TEMPLATE);
+  if (existsSync(templateSrc)) {
+    const template = readFileSync(templateSrc, "utf8");
+    const resolved = template.replace(
+      /\{\{PROJECT_DIR\}\}/g,
+      targetDir.replace(/\\/g, "\\\\")
+    );
+    let newSettings: Record<string, unknown>;
+    try {
+      newSettings = JSON.parse(resolved);
+    } catch (e) {
+      logger.warn(`  Failed to parse ${SETTINGS_TEMPLATE}: ${(e as Error).message}`);
+      return false;
+    }
+    if (
+      !newSettings ||
+      typeof newSettings !== "object" ||
+      Array.isArray(newSettings) ||
+      !newSettings.hooks ||
+      typeof newSettings.hooks !== "object" ||
+      Array.isArray(newSettings.hooks)
+    ) {
+      throw new Error("Invalid settings template: `hooks` object is required");
+    }
+    const settingsDest = join(targetClaude, "settings.local.json");
+
+    if (existsSync(settingsDest)) {
+      try {
+        const parsed: unknown = JSON.parse(readFileSync(settingsDest, "utf8"));
+        const existing: Record<string, unknown> =
+          parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? (parsed as Record<string, unknown>)
+            : {};
+        existing.hooks = newSettings.hooks;
+        writeFileSync(settingsDest, JSON.stringify(existing, null, 2) + "\n");
+        logger.info("  updated: settings.local.json (hooks merged, permissions preserved)");
+      } catch (e) {
+        writeFileSync(settingsDest, JSON.stringify(newSettings, null, 2) + "\n");
+        logger.warn(`  existing settings.local.json was invalid (${(e as Error).message}), regenerated`);
+      }
+    } else {
+      writeFileSync(settingsDest, JSON.stringify(newSettings, null, 2) + "\n");
+      logger.info("  generated: settings.local.json");
+    }
+  }
+
+  return true;
+}
+
+function main(): void {
+  const targets = loadTargets();
+
+  if (targets.length === 0) {
+    logger.info("No deploy targets configured in deploy-targets.json");
+    return;
+  }
+
+  logger.info(`Deploying hooks to ${targets.length} target(s)...\n`);
+
+  let success = 0;
+  for (const target of targets) {
+    logger.info(`[${basename(target)}] ${target}`);
+    if (deployTo(target)) {
+      success++;
+    }
+    logger.info("");
+  }
+
+  logger.info(`Done: ${success}/${targets.length} targets deployed.`);
+}
+
+main();

scripts/e2e.mjs → scripts/e2e.ts

@@ -1,10 +1,14 @@
-// E2E test runner
-// .env.e2e が存在しない場合は自動スキップ
+/**
+ * E2E test runner
+ * .env.e2e が存在しない場合は自動スキップ
+ */
+
 import { existsSync } from "node:fs";
 import { execFileSync } from "node:child_process";
+import { logger } from "../src/logger";
 
 if (!existsSync(".env.e2e")) {
-  console.log("Skipped: .env.e2e not found");
+  logger.info("Skipped: .env.e2e not found");
   process.exit(0);
 }