@hasna/skills 0.1.59 → 0.1.61

package/skills/managehook/src/lib/installer.ts

@@ -1,140 +0,0 @@
-import { readFile, writeFile, readdir, unlink, mkdir } from 'fs/promises';
-import { join } from 'path';
-import { homedir } from 'os';
-import { getItem } from './api-client';
-
-export type Target = 'claude' | 'codex';
-export type ConflictStrategy = 'skip' | 'overwrite';
-
-export interface InstallResult {
-  success: boolean;
-  message: string;
-  itemId: string;
-}
-
-export interface InstalledItem {
-  id: string;
-  name: string;
-  target: Target;
-  installedAt: string;
-}
-
-const CLAUDE_DIR = join(homedir(), '.claude', 'skills');
-const CODEX_DIR = join(homedir(), '.codex', 'skills');
-
-function getTargetDir(target: Target): string {
-  return target === 'claude' ? CLAUDE_DIR : CODEX_DIR;
-}
-
-async function ensureDir(dir: string): Promise<void> {
-  await mkdir(dir, { recursive: true });
-}
-
-async function writeItemFile(
-  target: Target,
-  itemId: string,
-  content: string,
-  strategy: ConflictStrategy
-): Promise<boolean> {
-  const dir = getTargetDir(target);
-  await ensureDir(dir);
-
-  const filePath = join(dir, `${itemId}.json`);
-
-  try {
-    await readFile(filePath);
-    if (strategy === 'skip') return false;
-  } catch {
-    // File doesn't exist, proceed
-  }
-
-  await writeFile(filePath, content, 'utf-8');
-  return true;
-}
-
-async function installToTarget(
-  target: Target,
-  itemId: string,
-  strategy: ConflictStrategy = 'skip'
-): Promise<InstallResult> {
-  try {
-    const item = await getItem(itemId);
-    const content = JSON.stringify(item, null, 2);
-    const written = await writeItemFile(target, itemId, content, strategy);
-
-    const targetName = target.charAt(0).toUpperCase() + target.slice(1);
-    return {
-      success: true,
-      message: written
-        ? `Installed to ${targetName}: ${item.name}`
-        : `Skipped (already exists): ${item.name}`,
-      itemId,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: `Failed to install to ${target}: ${error instanceof Error ? error.message : 'Unknown error'}`,
-      itemId,
-    };
-  }
-}
-
-export async function install(
-  itemId: string,
-  target: Target | 'both' = 'both',
-  strategy: ConflictStrategy = 'skip'
-): Promise<InstallResult> {
-  if (target === 'both') {
-    const claudeResult = await installToTarget('claude', itemId, strategy);
-    const codexResult = await installToTarget('codex', itemId, strategy);
-
-    return {
-      success: claudeResult.success && codexResult.success,
-      message: `${claudeResult.message}\n${codexResult.message}`,
-      itemId,
-    };
-  }
-
-  return await installToTarget(target, itemId, strategy);
-}
-
-export async function clearTarget(target?: Target | 'both'): Promise<void> {
-  const targets: Target[] = target === 'both' || !target ? ['claude', 'codex'] : [target];
-
-  for (const t of targets) {
-    const dir = getTargetDir(t);
-    try {
-      const files = await readdir(dir);
-      const jsonFiles = files.filter((f) => f.endsWith('.json')).map((f) => unlink(join(dir, f)));
-      await Promise.all(jsonFiles);
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
-    }
-  }
-}
-
-export async function listInstalled(target?: Target | 'both'): Promise<InstalledItem[]> {
-  const targets: Target[] = target === 'both' || !target ? ['claude', 'codex'] : [target];
-  const items: InstalledItem[] = [];
-
-  for (const t of targets) {
-    const dir = getTargetDir(t);
-    try {
-      const files = await readdir(dir);
-      for (const file of files.filter((f) => f.endsWith('.json'))) {
-        const content = await readFile(join(dir, file), 'utf-8');
-        const item = JSON.parse(content);
-        items.push({
-          id: item.id,
-          name: item.name,
-          target: t,
-          installedAt: file,
-        });
-      }
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
-    }
-  }
-
-  return items;
-}

package/skills/managehook/src/lib/service-dir.ts

@@ -1,119 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync, appendFileSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-
-const SERVICE_NAME = "managehook";
-const SERVICE_DIR_NAME = `.${SERVICE_NAME}`;
-
-export function getServiceDir(): string {
-  return join(homedir(), SERVICE_DIR_NAME);
-}
-
-export function getLogFilePath(): string {
-  return join(getServiceDir(), `${SERVICE_NAME}.log`);
-}
-
-export function getReadmePath(): string {
-  return join(getServiceDir(), "README.md");
-}
-
-export function isServiceDirInstalled(): boolean {
-  return existsSync(getServiceDir());
-}
-
-export function ensureServiceDir(): void {
-  if (!isServiceDirInstalled()) {
-    initServiceDir();
-  }
-}
-
-export function initServiceDir(force = false): { success: boolean; path: string; message: string } {
-  const serviceDir = getServiceDir();
-
-  if (existsSync(serviceDir) && !force) {
-    return {
-      success: false,
-      path: serviceDir,
-      message: "Already installed. Use --force to reinstall.",
-    };
-  }
-
-  mkdirSync(serviceDir, { recursive: true });
-
-  const readmeContent = generateReadme();
-  writeFileSync(getReadmePath(), readmeContent);
-
-  const logHeader = `# ${SERVICE_NAME} log file
-# Created: ${new Date().toISOString()}
-# This file contains activity history and logs.
-# -------------------------------------------------------
-
-`;
-  writeFileSync(getLogFilePath(), logHeader);
-
-  return {
-    success: true,
-    path: serviceDir,
-    message: `Installed at ${serviceDir}`,
-  };
-}
-
-function generateReadme(): string {
-  return `# .${SERVICE_NAME}
-
-This directory contains local configuration and logs for \`${SERVICE_NAME}\`.
-
-## Files
-
-| Path | Description |
-|------|-------------|
-| \`${SERVICE_NAME}.log\` | Activity log |
-| \`README.md\` | This file |
-
-## What is ${SERVICE_NAME}?
-
-\`${SERVICE_NAME}\` is a tool for managing Claude Code hooks.
-
-## Log File
-
-The \`${SERVICE_NAME}.log\` file contains:
-- Activity logs
-- Error logs
-- API activity
-
-## More Information
-
-For full documentation, run:
-
-\`\`\`bash
-${SERVICE_NAME} --help
-\`\`\`
-`;
-}
-
-export type LogLevel = "debug" | "info" | "warn" | "error";
-
-export function logToFile(message: string, level: LogLevel = "info"): void {
-  ensureServiceDir();
-
-  const timestamp = new Date().toISOString();
-  const logLine = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-
-  try {
-    appendFileSync(getLogFilePath(), logLine);
-  } catch {
-    // Silently fail
-  }
-}
-
-export function logInfo(message: string): void {
-  logToFile(message, "info");
-}
-
-export function logError(message: string): void {
-  logToFile(message, "error");
-}
-
-export function logWarn(message: string): void {
-  logToFile(message, "warn");
-}

package/skills/managehook/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "lib": [
-      "ESNext"
-    ],
-    "allowImportingTsExtensions": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true,
-    "types": [
-      "bun"
-    ]
-  },
-  "include": [
-    "src/**/*",
-    "bin/**/*",
-    "scripts/**/*"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}

package/skills/manageskill/.env.example

@@ -1,16 +0,0 @@
-# Database (individual connection params)
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=manageskill_db
-DB_USER=postgres
-DB_PASSWORD=your-password-here
-
-# Or use a full connection string
-# DATABASE_URL=postgres://user:password@host:port/dbname
-
-# Server
-PORT=3000
-
-# API (for CLI usage)
-API_URL=https://api.example.com
-API_KEY=your-api-key-here

package/skills/manageskill/CLAUDE.md

@@ -1,48 +0,0 @@
-# CLAUDE.md
-
-Claude-specific instructions for working with the manageskill codebase.
-
-## Overview
-
-`manageskill` is a TypeScript service for managing Claude Code skills. It provides a CLI tool, REST API server, and PostgreSQL database for listing, installing, removing, and configuring skills.
-
-## Architecture
-
-- **CLI tool** (Commander.js) - Primary interface at `bin/cli.ts`
-- **API server** (Bun HTTP) - REST API at `src/server/index.ts`
-- **Database** (PostgreSQL) - Data persistence at `src/db/index.ts`
-- **Config** - CLI config stored in `~/.manageskill.json`, server config via `.env`
-
-## Key Directories
-
-- `bin/` - CLI entry point
-- `src/lib/` - Core logic (api-client, config, installer, service-dir)
-- `src/server/` - HTTP server
-- `src/db/` - Database connection
-- `scripts/` - Database migration and seeding
-
-## Guidelines
-
-### DO:
-- Use Bun-native APIs (Bun.serve, Bun file operations)
-- Add TypeScript types for all new functions
-- Use parameterized queries with the `sql` tagged template
-- Handle errors gracefully with try-catch
-- Keep CLI commands focused and single-purpose
-- Use environment variables for secrets, config files for preferences
-
-### DON'T:
-- Don't add heavyweight frameworks (Express, Fastify, etc.)
-- Don't use ORMs (use raw SQL via postgres library)
-- Don't store secrets in code or config files
-
-## Common Operations
-
-```bash
-bun run dev          # Start server with auto-reload
-bun run start        # Start server
-bun run cli          # Run CLI tool
-bun run db:migrate   # Run migrations
-bun run db:seed      # Seed database
-bun run db:reset     # Reset database (migrate + seed)
-```

package/skills/manageskill/README.md

@@ -1,210 +0,0 @@
-# manageskill
-
-Manage Claude Code skills - list, install, remove, and configure skills.
-
-A TypeScript service with CLI, API client, and database integration.
-
-## Features
-
-- CLI tool for managing skills
-- HTTP server with REST API
-- PostgreSQL database with migrations
-- Configuration management
-- Installer for Claude/Codex tools
-
-## Installation
-
-```bash
-# Install dependencies
-bun install
-
-# Copy environment file
-cp .env.example .env
-
-# Edit .env with your configuration
-```
-
-## Configuration
-
-### Environment Variables
-
-Edit `.env` file with your configuration:
-
-```bash
-# Database
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=manageskill_db
-DB_USER=postgres
-DB_PASSWORD=your-password-here
-
-# Server
-PORT=3000
-
-# API
-API_URL=https://api.example.com
-API_KEY=your-api-key-here
-```
-
-### CLI Configuration
-
-Configure the CLI tool:
-
-```bash
-# Set API URL
-bun cli config --set-api-url https://api.example.com
-
-# Set API key
-bun cli config --set-api-key your-api-key-here
-
-# Show current configuration
-bun cli config --show
-```
-
-## Database Setup
-
-```bash
-# Run migrations
-bun run db:migrate
-
-# Seed database
-bun run db:seed
-
-# Reset database (migrate + seed)
-bun run db:reset
-```
-
-## Development
-
-```bash
-# Start server with auto-reload
-bun run dev
-
-# Start server
-bun run start
-```
-
-## CLI Usage
-
-### Setup
-
-```bash
-# Interactive setup
-bun run cli setup
-```
-
-### Managing Skills
-
-```bash
-# List all skills
-bun run cli list
-
-# List with options
-bun run cli list --filter "category" --limit 20
-
-# Get skill by ID
-bun run cli get <skill-id>
-
-# Search skills
-bun run cli search "query" --limit 10
-
-# Add skill
-bun run cli add --name "Skill Name" --description "Description"
-
-# Add skill with metadata
-bun run cli add --name "Skill" --metadata '{"key": "value"}'
-```
-
-### Installation to Claude/Codex
-
-```bash
-# Install to both
-bun run cli install <skill-id>
-
-# Install to specific target
-bun run cli install <skill-id> --target claude
-bun run cli install <skill-id> --target codex
-
-# Install multiple skills
-bun run cli install <id1> <id2> <id3>
-
-# Force overwrite
-bun run cli install <skill-id> --force
-
-# Clear installed skills
-bun run cli install --clear
-
-# List installed skills
-bun run cli install --list
-```
-
-## API Endpoints
-
-The server provides the following REST API endpoints:
-
-### Health Check
-
-```bash
-GET /health
-```
-
-Returns server health status.
-
-### Items
-
-```bash
-# List items
-GET /api/items
-
-# Create item
-POST /api/items
-Content-Type: application/json
-
-{
-  "name": "Skill name",
-  "description": "Skill description",
-  "metadata": {"key": "value"}
-}
-```
-
-## Project Structure
-
-```
-.
-├── bin/
-│   └── cli.ts              # CLI entry point
-├── src/
-│   ├── lib/
-│   │   ├── api-client.ts   # API client functions
-│   │   ├── config.ts       # Configuration management
-│   │   ├── installer.ts    # Claude/Codex installer
-│   │   └── service-dir.ts  # Service directory management
-│   ├── db/
-│   │   └── index.ts        # Database connection
-│   └── server/
-│       └── index.ts        # HTTP server
-├── scripts/
-│   ├── migrate.ts          # Database migrations
-│   └── seed.ts             # Database seeding
-├── .env.example            # Environment template
-├── package.json            # Package configuration
-├── tsconfig.json           # TypeScript config
-└── README.md               # Documentation
-```
-
-## Scripts
-
-- `bun run dev` - Start server with auto-reload
-- `bun run start` - Start server
-- `bun run cli` - Run CLI tool
-- `bun run db:migrate` - Run migrations
-- `bun run db:seed` - Seed database
-- `bun run db:reset` - Reset database (migrate + seed)
-
-## License
-
-Apache-2.0
-
-## Author
-
-Hasna

package/skills/manageskill/package.json

@@ -1,24 +0,0 @@
-{
-  "name": "manageskill",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Manage Claude Code skills - list, install, remove, and configure skills",
-  "bin": {
-    "manageskill": "src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run --watch src/server/index.ts",
-    "start": "bun run src/server/index.ts",
-    "cli": "bun run bin/cli.ts",
-    "db:migrate": "bun run scripts/migrate.ts",
-    "db:seed": "bun run scripts/seed.ts",
-    "db:reset": "bun run scripts/migrate.ts && bun run scripts/seed.ts"
-  },
-  "dependencies": {
-    "postgres": "^3.4.5"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.1.14",
-    "typescript": "^5.7.2"
-  }
-}

package/skills/manageskill/scripts/migrate.ts

@@ -1,57 +0,0 @@
-#!/usr/bin/env bun
-
-import { sql, testConnection, closeConnection } from '../src/db';
-
-console.log('Running database migrations...');
-
-const connected = await testConnection();
-if (!connected) {
-  console.error('Failed to connect to database');
-  process.exit(1);
-}
-
-console.log('Database connected\n');
-
-try {
-  console.log('Creating tables...');
-  await sql`
-    CREATE TABLE IF NOT EXISTS items (
-      id SERIAL PRIMARY KEY,
-      name VARCHAR(255) NOT NULL,
-      description TEXT,
-      metadata JSONB DEFAULT '{}',
-      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-      updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-    )
-  `;
-
-  console.log('Creating indexes...');
-  await sql`CREATE INDEX IF NOT EXISTS idx_items_name ON items(name)`;
-  await sql`CREATE INDEX IF NOT EXISTS idx_items_created_at ON items(created_at DESC)`;
-
-  console.log('Creating triggers...');
-  await sql`
-    CREATE OR REPLACE FUNCTION update_updated_at_column()
-    RETURNS TRIGGER AS $$
-    BEGIN
-      NEW.updated_at = CURRENT_TIMESTAMP;
-      RETURN NEW;
-    END;
-    $$ language 'plpgsql'
-  `;
-
-  await sql`DROP TRIGGER IF EXISTS update_items_updated_at ON items`;
-  await sql`
-    CREATE TRIGGER update_items_updated_at
-    BEFORE UPDATE ON items
-    FOR EACH ROW
-    EXECUTE FUNCTION update_updated_at_column()
-  `;
-
-  console.log('\nMigrations completed successfully');
-} catch (error) {
-  console.error('\nMigration failed:', error);
-  process.exit(1);
-} finally {
-  await closeConnection();
-}

package/skills/manageskill/scripts/seed.ts

@@ -1,58 +0,0 @@
-#!/usr/bin/env bun
-
-import { sql, testConnection, closeConnection } from '../src/db';
-
-console.log('Seeding database...');
-
-const connected = await testConnection();
-if (!connected) {
-  console.error('Failed to connect to database');
-  process.exit(1);
-}
-
-console.log('Database connected\n');
-
-try {
-  const [{ count }] = await sql`SELECT COUNT(*) as count FROM items`;
-
-  if (parseInt(count) > 0) {
-    console.log(`Database already has ${count} items - skipping seed`);
-    console.log('To re-seed, truncate the items table first\n');
-    process.exit(0);
-  }
-
-  console.log('Inserting seed data...');
-
-  const seedItems = [
-    {
-      name: 'Example Item 1',
-      description: 'This is the first example item',
-      metadata: { category: 'example', priority: 'high' },
-    },
-    {
-      name: 'Example Item 2',
-      description: 'This is the second example item',
-      metadata: { category: 'sample', priority: 'medium' },
-    },
-    {
-      name: 'Example Item 3',
-      description: 'This is the third example item',
-      metadata: { category: 'demo', priority: 'low' },
-    },
-  ];
-
-  for (const item of seedItems) {
-    await sql`
-      INSERT INTO items (name, description, metadata)
-      VALUES (${item.name}, ${item.description}, ${JSON.stringify(item.metadata)})
-    `;
-    console.log(`  Created: ${item.name}`);
-  }
-
-  console.log(`\nSeeded ${seedItems.length} items successfully`);
-} catch (error) {
-  console.error('\nSeeding failed:', error);
-  process.exit(1);
-} finally {
-  await closeConnection();
-}