@hasna/hooks 0.1.1 → 0.2.0

package/AGENTS.md

@@ -1,54 +0,0 @@
-# AGENTS.md
-
-Guidance for AI agents working with this repository.
-
-## Overview
-
-This is `@hasna/hooks`, an open-source monorepo of Claude Code hooks providing CLI installation and management of 15+ lifecycle hooks.
-
-## Quick Commands
-
-```bash
-bun install          # Install dependencies
-bun run dev          # Run CLI
-bun run build        # Build
-bun run typecheck    # Type check
-```
-
-## Adding Hooks
-
-1. Copy to `hooks/hook-{name}/`
-2. Ensure it follows the standard hook pattern (stdin JSON → stdout JSON)
-3. Remove any internal references (hasnaxyz, etc.)
-4. Verify no secrets or API keys are committed
-5. Update `src/lib/registry.ts` to include the hook
-
-## Structure
-
-```
-hooks/hook-{name}/
-├── src/
-│   ├── hook.ts      # Main hook logic
-│   ├── cli.ts       # CLI commands
-│   └── index.ts     # Exports
-├── package.json
-├── CLAUDE.md
-└── README.md
-```
-
-## Hook Events
-
-| Event | Timing | Can Block | Use Case |
-|-------|--------|-----------|----------|
-| PreToolUse | Before tool | Yes | Security, safety guards |
-| PostToolUse | After tool | No | Quality checks, async tasks |
-| Stop | Session end | No | Notifications, cleanup |
-| Notification | On notify | No | Context management |
-
-## Security Checks
-
-Before committing any hook:
-- [ ] No hardcoded API keys/tokens
-- [ ] No internal references (hasnaxyz)
-- [ ] Uses `@hasna` namespace for public packages
-- [ ] .env.example has placeholders only

package/CLAUDE.md

@@ -1,70 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code when working with this repository.
-
-## Project Overview
-
-`@hasna/hooks` is an open-source monorepo of Claude Code hooks. It provides a CLI to install hooks into projects and register them in Claude settings.
-
-## Build & Run Commands
-
-```bash
-# Install dependencies
-bun install
-
-# Run CLI in development
-bun run dev
-
-# Build for distribution
-bun run build
-
-# Type check
-bun run typecheck
-```
-
-## Code Style
-
-- TypeScript with strict mode
-- ESM modules (`type: module`)
-- Async/await for all async operations
-- Minimal dependencies: commander, chalk, ink (for CLI)
-- Type annotations required everywhere
-
-## Project Structure
-
-```
-├── src/
-│   ├── cli/           # Interactive CLI (Ink/React)
-│   │   ├── components/
-│   │   └── index.tsx
-│   ├── lib/           # Core library
-│   │   ├── installer.ts
-│   │   └── registry.ts
-│   └── index.ts       # Library exports
-├── hooks/             # Individual hook packages
-│   └── hook-*/        # Each hook
-└── bin/               # Built CLI output
-```
-
-## Adding New Hooks
-
-When adding hooks:
-
-1. Copy to `hooks/hook-{name}/`
-2. Update `src/lib/registry.ts` to include the hook
-3. Ensure no secrets or API keys are committed
-4. Follow the standard hook structure (src/hook.ts, src/cli.ts)
-
-## Hook Events
-
-- **PreToolUse**: Fires before tool execution, can block
-- **PostToolUse**: Fires after tool execution, async
-- **Stop**: Fires on session end, async
-- **Notification**: Fires on notification events, async
-
-## Dependencies
-
-- commander: CLI argument parsing
-- chalk: Terminal styling
-- ink: React-based interactive CLI
-- ink-select-input: Selection component for Ink

package/CONTRIBUTING.md

@@ -1,45 +0,0 @@
-# Contributing
-
-Thanks for helping improve the hooks. Please follow these guidelines so we can keep publishing safe and consistent.
-
-## NPM Auth (Optional)
-
-If you need a scoped registry token (publish or private installs), copy an example file and set `NPM_TOKEN`:
-
-```bash
-cp .npmrc.example .npmrc
-```
-
-- Do not commit `.npmrc` files with real tokens.
-- Use environment variables in CI: `NPM_TOKEN` only.
-
-## Adding a New Hook
-
-1. Create the hook directory: `hooks/hook-{name}/`
-2. Follow the standard structure:
-   ```
-   hook-{name}/
-   ├── src/
-   │   ├── hook.ts     # Main hook logic
-   │   ├── cli.ts      # CLI commands
-   │   └── index.ts    # Exports
-   ├── package.json
-   ├── CLAUDE.md
-   ├── README.md
-   └── tsconfig.json
-   ```
-3. Register it in `src/lib/registry.ts`
-4. Test with `bun run dev`
-
-## Hook Conventions
-
-- Hooks receive JSON on stdin and output JSON on stdout
-- PreToolUse hooks return `{ "decision": "approve" | "block", "reason": "..." }`
-- PostToolUse/Stop/Notification hooks return `{ "continue": true }`
-- Log diagnostic info to stderr, not stdout
-- No external dependencies (use Node.js builtins only)
-
-## Secrets
-
-- Never commit `.env` files with real values.
-- Keep credentials in your local environment only.

package/hooks/hook-agentmessages/bin/cli.ts

@@ -1,125 +0,0 @@
-#!/usr/bin/env bun
-/**
- * CLI for hook-agentmessages
- *
- * Usage:
- *   hook-agentmessages install    - Install hooks into Claude Code
- *   hook-agentmessages uninstall  - Remove hooks from Claude Code
- *   hook-agentmessages status     - Show hook status
- */
-
-import { homedir } from 'os';
-import { join } from 'path';
-
-const CLAUDE_SETTINGS_FILE = join(homedir(), '.claude', 'settings.json');
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-async function showStatus() {
-  console.log('hook-agentmessages status\n');
-
-  // Check if hooks are installed
-  try {
-    const file = Bun.file(CLAUDE_SETTINGS_FILE);
-    if (await file.exists()) {
-      const settings = await file.json();
-
-      if (settings.hooks) {
-        let installed = false;
-
-        if (settings.hooks.SessionStart) {
-          const hasHook = settings.hooks.SessionStart.some((h: any) =>
-            h.hooks?.some((hook: any) => hook.command?.includes('hook-agentmessages'))
-          );
-          if (hasHook) {
-            console.log('  SessionStart hook: installed');
-            installed = true;
-          }
-        }
-
-        if (settings.hooks.Stop) {
-          const hasHook = settings.hooks.Stop.some((h: any) =>
-            h.hooks?.some((hook: any) => hook.command?.includes('hook-agentmessages'))
-          );
-          if (hasHook) {
-            console.log('  Stop hook: installed');
-            installed = true;
-          }
-        }
-
-        if (!installed) {
-          console.log('  No hook-agentmessages hooks installed');
-        }
-      } else {
-        console.log('  No hooks configured in Claude Code');
-      }
-    } else {
-      console.log('  Claude Code settings not found');
-    }
-  } catch (err) {
-    console.log('  Error reading settings:', (err as Error).message);
-  }
-
-  // Check service-message status
-  const serviceDir = join(homedir(), '.service', 'service-message');
-  const configFile = Bun.file(join(serviceDir, 'config.json'));
-
-  console.log('\nservice-message integration:');
-  if (await configFile.exists()) {
-    const config = await configFile.json();
-    console.log(`  Agent ID: ${config.agentId || 'not set'}`);
-    console.log(`  Data dir: ${serviceDir}`);
-  } else {
-    console.log('  Not configured');
-  }
-}
-
-function showHelp() {
-  console.log(`
-hook-agentmessages - Claude Code hook for service-message integration
-
-Usage:
-  hook-agentmessages <command>
-
-Commands:
-  install     Install hooks into Claude Code settings
-  uninstall   Remove hooks from Claude Code settings
-  status      Show current hook status
-
-Examples:
-  hook-agentmessages install
-  hook-agentmessages status
-`);
-}
-
-async function main() {
-  if (!command || command === '--help' || command === '-h') {
-    showHelp();
-    return;
-  }
-
-  switch (command) {
-    case 'install':
-      await import('../src/install.ts');
-      break;
-
-    case 'uninstall':
-      await import('../src/uninstall.ts');
-      break;
-
-    case 'status':
-      await showStatus();
-      break;
-
-    default:
-      console.error(`Unknown command: ${command}`);
-      showHelp();
-      process.exit(1);
-  }
-}
-
-main().catch((err) => {
-  console.error('Error:', err.message);
-  process.exit(1);
-});