@hasna/hooks 0.0.1 → 0.0.2

package/hooks/hook-gitguard/src/cli.ts

@@ -1,159 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * CLI for hook-gitguard
- */
-
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-
-const HOOK_NAME = "hook-gitguard";
-const SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
-
-interface ClaudeSettings {
-  hooks?: {
-    PreToolUse?: Array<{
-      matcher: string;
-      hooks: Array<{ type: "command"; command: string }>;
-    }>;
-  };
-  [key: string]: unknown;
-}
-
-function readSettings(): ClaudeSettings {
-  try {
-    if (existsSync(SETTINGS_PATH)) {
-      return JSON.parse(readFileSync(SETTINGS_PATH, "utf-8"));
-    }
-  } catch {}
-  return {};
-}
-
-function writeSettings(settings: ClaudeSettings): void {
-  const dir = join(homedir(), ".claude");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2));
-}
-
-function install(): void {
-  const settings = readSettings();
-  if (!settings.hooks) settings.hooks = {};
-  if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = [];
-
-  const existing = settings.hooks.PreToolUse.find((h) =>
-    h.hooks.some((hook) => hook.command.includes(HOOK_NAME))
-  );
-
-  if (existing) {
-    console.log(`${HOOK_NAME} is already installed`);
-    return;
-  }
-
-  settings.hooks.PreToolUse.push({
-    matcher: "Bash",
-    hooks: [{ type: "command", command: `bunx @hasnaxyz/${HOOK_NAME}` }],
-  });
-
-  writeSettings(settings);
-  console.log(`${HOOK_NAME} installed successfully`);
-  console.log("Hook will block destructive git operations");
-}
-
-function uninstall(): void {
-  const settings = readSettings();
-  if (!settings.hooks?.PreToolUse) {
-    console.log(`${HOOK_NAME} is not installed`);
-    return;
-  }
-
-  const before = settings.hooks.PreToolUse.length;
-  settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter(
-    (h) => !h.hooks.some((hook) => hook.command.includes(HOOK_NAME))
-  );
-
-  if (before === settings.hooks.PreToolUse.length) {
-    console.log(`${HOOK_NAME} is not installed`);
-    return;
-  }
-
-  writeSettings(settings);
-  console.log(`${HOOK_NAME} uninstalled successfully`);
-}
-
-function status(): void {
-  const settings = readSettings();
-  const installed = settings.hooks?.PreToolUse?.some((h) =>
-    h.hooks.some((hook) => hook.command.includes(HOOK_NAME))
-  );
-  console.log(`${HOOK_NAME} is ${installed ? "installed" : "not installed"}`);
-}
-
-function test(command: string): void {
-  const PATTERNS: Array<{ pattern: RegExp; description: string }> = [
-    { pattern: /git\s+reset\s+--hard/, description: "git reset --hard" },
-    { pattern: /git\s+push\s+.*--force(?!-)/, description: "git push --force" },
-    { pattern: /git\s+push\s+.*\s-f\b/, description: "git push -f" },
-    { pattern: /git\s+checkout\s+\.\s*$/, description: "git checkout ." },
-    { pattern: /git\s+checkout\s+--\s+\./, description: "git checkout -- ." },
-    { pattern: /git\s+clean\s+(-[a-zA-Z]*f|--force)/, description: "git clean -f" },
-    { pattern: /git\s+branch\s+-D\s/, description: "git branch -D" },
-    { pattern: /git\s+stash\s+(drop|clear)/, description: "git stash drop/clear" },
-  ];
-
-  for (const { pattern, description } of PATTERNS) {
-    if (pattern.test(command)) {
-      console.log(`BLOCKED: ${description}`);
-      return;
-    }
-  }
-  console.log("ALLOWED");
-}
-
-function help(): void {
-  console.log(`
-${HOOK_NAME} - Block destructive git operations in Claude Code
-
-Usage: ${HOOK_NAME} <command>
-
-Commands:
-  install     Install hook to Claude Code settings
-  uninstall   Remove hook from Claude Code settings
-  status      Check if hook is installed
-  test <cmd>  Test if a git command would be blocked
-  help        Show this help message
-
-Blocked operations:
-  git reset --hard          git push --force / -f
-  git checkout .            git checkout -- .
-  git clean -f              git branch -D
-  git stash drop/clear      git reflog expire/delete
-`);
-}
-
-const command = process.argv[2];
-
-switch (command) {
-  case "install": install(); break;
-  case "uninstall": uninstall(); break;
-  case "status": status(); break;
-  case "test":
-    if (process.argv[3]) {
-      test(process.argv.slice(3).join(" "));
-    } else {
-      console.error("Usage: hook-gitguard test <command>");
-      process.exit(1);
-    }
-    break;
-  case "help":
-  case "--help":
-  case "-h": help(); break;
-  default:
-    if (!command) {
-      import("./hook.ts").then((m) => m.run());
-    } else {
-      console.error(`Unknown command: ${command}`);
-      help();
-      process.exit(1);
-    }
-}

package/hooks/hook-gitguard/src/hook.ts

@@ -1,129 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Claude Code Hook: gitguard
- *
- * PreToolUse hook that blocks destructive git operations:
- * - git reset --hard
- * - git push --force / -f (especially to main/master)
- * - git checkout . / git checkout -- .
- * - git clean -f / -fd
- * - git branch -D (force delete)
- * - git stash drop / clear
- * - git rebase without caution
- */
-
-import { readFileSync } from "fs";
-
-interface HookInput {
-  session_id: string;
-  cwd: string;
-  tool_name: string;
-  tool_input: Record<string, unknown>;
-}
-
-interface HookOutput {
-  decision?: "approve" | "block";
-  reason?: string;
-}
-
-const DESTRUCTIVE_PATTERNS: Array<{ pattern: RegExp; description: string }> = [
-  // git reset --hard
-  { pattern: /git\s+reset\s+--hard/, description: "git reset --hard (discards all uncommitted changes)" },
-
-  // git push --force (any variant)
-  { pattern: /git\s+push\s+.*--force-with-lease/, description: "git push --force-with-lease (force push with safety)" },
-  { pattern: /git\s+push\s+.*--force(?!-)/, description: "git push --force (overwrites remote history)" },
-  { pattern: /git\s+push\s+.*\s-f\b/, description: "git push -f (force push)" },
-
-  // Force push to main/master specifically
-  { pattern: /git\s+push\s+.*--force.*\s+(main|master)\b/, description: "force push to main/master" },
-  { pattern: /git\s+push\s+.*-f\s+.*(main|master)\b/, description: "force push to main/master" },
-
-  // git checkout . / git checkout -- . (discard all changes)
-  { pattern: /git\s+checkout\s+\.\s*$/, description: "git checkout . (discards all working directory changes)" },
-  { pattern: /git\s+checkout\s+--\s+\./, description: "git checkout -- . (discards all working directory changes)" },
-
-  // git restore . (discard all changes)
-  { pattern: /git\s+restore\s+\.\s*$/, description: "git restore . (discards all working directory changes)" },
-  { pattern: /git\s+restore\s+--staged\s+--worktree\s+\./, description: "git restore --staged --worktree . (discards everything)" },
-
-  // git clean -f (remove untracked files)
-  { pattern: /git\s+clean\s+(-[a-zA-Z]*f|--force)/, description: "git clean -f (removes untracked files permanently)" },
-
-  // git branch -D (force delete branch)
-  { pattern: /git\s+branch\s+-D\s/, description: "git branch -D (force delete branch without merge check)" },
-
-  // git stash drop/clear
-  { pattern: /git\s+stash\s+drop/, description: "git stash drop (permanently deletes stash entry)" },
-  { pattern: /git\s+stash\s+clear/, description: "git stash clear (deletes all stash entries)" },
-
-  // git reflog expire/delete
-  { pattern: /git\s+reflog\s+(expire|delete)/, description: "git reflog expire/delete (destroys recovery points)" },
-
-  // git gc --prune=now
-  { pattern: /git\s+gc\s+--prune=now/, description: "git gc --prune=now (permanently removes unreachable objects)" },
-];
-
-function readStdinJson(): HookInput | null {
-  try {
-    const input = readFileSync(0, "utf-8").trim();
-    if (!input) return null;
-    return JSON.parse(input);
-  } catch {
-    return null;
-  }
-}
-
-function checkDestructiveGit(command: string): { blocked: boolean; reason?: string } {
-  for (const { pattern, description } of DESTRUCTIVE_PATTERNS) {
-    if (pattern.test(command)) {
-      return { blocked: true, reason: `Blocked: ${description}` };
-    }
-  }
-  return { blocked: false };
-}
-
-function respond(output: HookOutput): void {
-  console.log(JSON.stringify(output));
-}
-
-export function run(): void {
-  const input = readStdinJson();
-
-  if (!input) {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  if (input.tool_name !== "Bash") {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  const command = input.tool_input?.command as string;
-  if (!command || typeof command !== "string") {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  // Only check commands that contain "git"
-  if (!command.includes("git")) {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  const result = checkDestructiveGit(command);
-
-  if (result.blocked) {
-    console.error(`[hook-gitguard] ${result.reason}`);
-    respond({ decision: "block", reason: result.reason });
-    return;
-  }
-
-  respond({ decision: "approve" });
-}
-
-if (import.meta.main) {
-  run();
-}

package/hooks/hook-gitguard/tsconfig.json

@@ -1,25 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "lib": ["ESNext"],
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "types": ["bun-types"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/hooks/hook-packageage/src/cli.ts

@@ -1,165 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * CLI for hook-packageage
- */
-
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-
-const HOOK_NAME = "hook-packageage";
-const SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
-
-interface ClaudeSettings {
-  hooks?: {
-    PreToolUse?: Array<{
-      matcher: string;
-      hooks: Array<{ type: "command"; command: string }>;
-    }>;
-  };
-  [key: string]: unknown;
-}
-
-function readSettings(): ClaudeSettings {
-  try {
-    if (existsSync(SETTINGS_PATH)) {
-      return JSON.parse(readFileSync(SETTINGS_PATH, "utf-8"));
-    }
-  } catch {}
-  return {};
-}
-
-function writeSettings(settings: ClaudeSettings): void {
-  const dir = join(homedir(), ".claude");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2));
-}
-
-function install(): void {
-  const settings = readSettings();
-  if (!settings.hooks) settings.hooks = {};
-  if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = [];
-
-  const existing = settings.hooks.PreToolUse.find((h) =>
-    h.hooks.some((hook) => hook.command.includes(HOOK_NAME))
-  );
-
-  if (existing) {
-    console.log(`${HOOK_NAME} is already installed`);
-    return;
-  }
-
-  settings.hooks.PreToolUse.push({
-    matcher: "Bash",
-    hooks: [{ type: "command", command: `bunx @hasnaxyz/${HOOK_NAME}` }],
-  });
-
-  writeSettings(settings);
-  console.log(`${HOOK_NAME} installed successfully`);
-  console.log("Hook will check package age before npm/bun install commands");
-}
-
-function uninstall(): void {
-  const settings = readSettings();
-  if (!settings.hooks?.PreToolUse) {
-    console.log(`${HOOK_NAME} is not installed`);
-    return;
-  }
-
-  const before = settings.hooks.PreToolUse.length;
-  settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter(
-    (h) => !h.hooks.some((hook) => hook.command.includes(HOOK_NAME))
-  );
-
-  if (before === settings.hooks.PreToolUse.length) {
-    console.log(`${HOOK_NAME} is not installed`);
-    return;
-  }
-
-  writeSettings(settings);
-  console.log(`${HOOK_NAME} uninstalled successfully`);
-}
-
-function status(): void {
-  const settings = readSettings();
-  const installed = settings.hooks?.PreToolUse?.some((h) =>
-    h.hooks.some((hook) => hook.command.includes(HOOK_NAME))
-  );
-  console.log(`${HOOK_NAME} is ${installed ? "installed" : "not installed"}`);
-}
-
-async function check(packageName: string): Promise<void> {
-  console.log(`Checking ${packageName}...`);
-  try {
-    const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}`);
-    if (!response.ok) {
-      console.error(`Package not found: ${packageName}`);
-      return;
-    }
-    const data = await response.json() as Record<string, unknown>;
-    const time = data.time as Record<string, string> | undefined;
-    const modified = time?.modified;
-    if (modified) {
-      const days = Math.floor((Date.now() - new Date(modified).getTime()) / (1000 * 60 * 60 * 24));
-      const status = days > 730 ? "ABANDONED" : days > 365 ? "STALE" : "ACTIVE";
-      console.log(`  Last updated: ${modified} (${days} days ago) — ${status}`);
-    }
-
-    const distTags = data["dist-tags"] as Record<string, string> | undefined;
-    const latestVersion = distTags?.latest;
-    const versions = data.versions as Record<string, Record<string, unknown>> | undefined;
-    if (latestVersion && versions?.[latestVersion]?.deprecated) {
-      console.log(`  DEPRECATED: ${versions[latestVersion].deprecated}`);
-    }
-  } catch (error) {
-    console.error(`Error checking ${packageName}:`, error);
-  }
-}
-
-function help(): void {
-  console.log(`
-${HOOK_NAME} - Check package age before install
-
-Usage: ${HOOK_NAME} <command>
-
-Commands:
-  install         Install hook to Claude Code settings
-  uninstall       Remove hook from Claude Code settings
-  status          Check if hook is installed
-  check <pkg>     Manually check a package's age
-  help            Show this help message
-
-Thresholds:
-  > 1 year since last publish: STALE warning
-  > 2 years since last publish: ABANDONED warning
-  Deprecated packages: always warned
-`);
-}
-
-const command = process.argv[2];
-
-switch (command) {
-  case "install": install(); break;
-  case "uninstall": uninstall(); break;
-  case "status": status(); break;
-  case "check":
-    if (process.argv[3]) {
-      check(process.argv[3]);
-    } else {
-      console.error("Usage: hook-packageage check <package-name>");
-      process.exit(1);
-    }
-    break;
-  case "help":
-  case "--help":
-  case "-h": help(); break;
-  default:
-    if (!command) {
-      import("./hook.ts").then((m) => m.run());
-    } else {
-      console.error(`Unknown command: ${command}`);
-      help();
-      process.exit(1);
-    }
-}

package/hooks/hook-packageage/src/hook.ts

@@ -1,177 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Claude Code Hook: packageage
- *
- * PreToolUse hook that checks package age before npm/bun install commands.
- * Warns on packages that haven't been updated in over a year (potentially
- * abandoned) or have known deprecation markers.
- *
- * Checks the npm registry for last publish date and warns accordingly.
- */
-
-import { readFileSync } from "fs";
-
-interface HookInput {
-  session_id: string;
-  cwd: string;
-  tool_name: string;
-  tool_input: Record<string, unknown>;
-}
-
-interface HookOutput {
-  decision?: "approve" | "block";
-  reason?: string;
-}
-
-const INSTALL_PATTERNS = [
-  /(?:npm|bun|yarn|pnpm)\s+(?:install|add|i)\s+/,
-];
-
-const STALE_THRESHOLD_DAYS = 365; // 1 year
-const ABANDONED_THRESHOLD_DAYS = 730; // 2 years
-
-function readStdinJson(): HookInput | null {
-  try {
-    const input = readFileSync(0, "utf-8").trim();
-    if (!input) return null;
-    return JSON.parse(input);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Extract package names from an install command
- */
-function extractPackageNames(command: string): string[] {
-  // Match: npm install pkg1 pkg2 / bun add pkg1 / etc.
-  const match = command.match(/(?:npm|bun|yarn|pnpm)\s+(?:install|add|i)\s+(.*)/);
-  if (!match) return [];
-
-  return match[1]
-    .split(/\s+/)
-    .filter((arg) => !arg.startsWith("-") && !arg.startsWith("--"))
-    .map((pkg) => pkg.replace(/@[\^~><=\d].*$/, "")) // strip version specifier
-    .filter((pkg) => pkg.length > 0 && !pkg.startsWith(".")); // filter paths
-}
-
-/**
- * Check package age via npm registry
- */
-async function checkPackageAge(packageName: string): Promise<{
-  name: string;
-  lastPublish: Date | null;
-  daysSincePublish: number;
-  deprecated: boolean;
-  error?: string;
-}> {
-  try {
-    const response = await fetch(
-      `https://registry.npmjs.org/${encodeURIComponent(packageName)}`,
-      { signal: AbortSignal.timeout(5000) }
-    );
-
-    if (!response.ok) {
-      return { name: packageName, lastPublish: null, daysSincePublish: 0, deprecated: false, error: `HTTP ${response.status}` };
-    }
-
-    const data = await response.json() as Record<string, unknown>;
-
-    // Check deprecation
-    const distTags = data["dist-tags"] as Record<string, string> | undefined;
-    const latestVersion = distTags?.latest;
-    const versions = data.versions as Record<string, Record<string, unknown>> | undefined;
-    const deprecated = latestVersion && versions?.[latestVersion]?.deprecated ? true : false;
-
-    // Get last publish date
-    const time = data.time as Record<string, string> | undefined;
-    const modified = time?.modified;
-
-    if (!modified) {
-      return { name: packageName, lastPublish: null, daysSincePublish: 0, deprecated };
-    }
-
-    const lastPublish = new Date(modified);
-    const daysSincePublish = Math.floor(
-      (Date.now() - lastPublish.getTime()) / (1000 * 60 * 60 * 24)
-    );
-
-    return { name: packageName, lastPublish, daysSincePublish, deprecated };
-  } catch (error) {
-    return {
-      name: packageName,
-      lastPublish: null,
-      daysSincePublish: 0,
-      deprecated: false,
-      error: error instanceof Error ? error.message : String(error),
-    };
-  }
-}
-
-function respond(output: HookOutput): void {
-  console.log(JSON.stringify(output));
-}
-
-export async function run(): Promise<void> {
-  const input = readStdinJson();
-
-  if (!input) {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  if (input.tool_name !== "Bash") {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  const command = input.tool_input?.command as string;
-  if (!command || typeof command !== "string") {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  // Check if this is a package install command
-  const isInstall = INSTALL_PATTERNS.some((p) => p.test(command));
-  if (!isInstall) {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  const packages = extractPackageNames(command);
-  if (packages.length === 0) {
-    respond({ decision: "approve" });
-    return;
-  }
-
-  const warnings: string[] = [];
-
-  // Check each package (in parallel, with timeout)
-  const results = await Promise.all(packages.map(checkPackageAge));
-
-  for (const result of results) {
-    if (result.deprecated) {
-      warnings.push(`${result.name}: DEPRECATED`);
-    }
-    if (result.daysSincePublish > ABANDONED_THRESHOLD_DAYS) {
-      warnings.push(`${result.name}: possibly abandoned (last updated ${result.daysSincePublish} days ago)`);
-    } else if (result.daysSincePublish > STALE_THRESHOLD_DAYS) {
-      warnings.push(`${result.name}: stale (last updated ${result.daysSincePublish} days ago)`);
-    }
-  }
-
-  if (warnings.length > 0) {
-    const reason = `Package age warnings:\n${warnings.map((w) => `  - ${w}`).join("\n")}\n\nConsider using more actively maintained alternatives.`;
-    console.error(`[hook-packageage] ${reason}`);
-    // Warn but don't block — just inject the warning
-    respond({ decision: "approve", reason });
-    return;
-  }
-
-  respond({ decision: "approve" });
-}
-
-if (import.meta.main) {
-  run();
-}

package/hooks/hook-packageage/tsconfig.json

@@ -1,25 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "lib": ["ESNext"],
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "types": ["bun-types"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}