@hasna/skills 0.1.61 → 0.1.63

package/skills/generate-env/src/generators.ts

@@ -1,240 +0,0 @@
-import { randomBytes } from "crypto";
-import type { EnvVariable, GenerateOptions } from "./types";
-
-// Secret Generation
-// ============================================================================
-
-/**
- * Generate a secure random secret
- */
-export function generateSecret(length: number = 32): string {
-  return randomBytes(Math.ceil(length / 2))
-    .toString('hex')
-    .slice(0, length);
-}
-
-// ============================================================================
-// File Generation
-// ============================================================================
-
-/**
- * Generate .env file content
- */
-export function generateEnvFile(
-  variables: EnvVariable[],
-  environment: string,
-  options: GenerateOptions
-): string {
-  const lines: string[] = [];
-
-  // Header
-  if (environment === 'example') {
-    lines.push('# Environment Configuration Template');
-    lines.push('# Copy this file to .env.local and fill in the values');
-  } else {
-    lines.push(`# ${environment.charAt(0).toUpperCase() + environment.slice(1)} Environment Configuration`);
-  }
-  lines.push(`# Generated: ${new Date().toISOString()}`);
-  lines.push('');
-
-  // Group by category
-  const categories = new Map<string, EnvVariable[]>();
-  variables.forEach(v => {
-    const cat = v.category;
-    if (!categories.has(cat)) categories.set(cat, []);
-    categories.get(cat)!.push(v);
-  });
-
-  // Generate sections
-  for (const [category, vars] of categories) {
-    lines.push('# ' + '='.repeat(77));
-    lines.push(`# ${category.toUpperCase()}`);
-    lines.push('# ' + '='.repeat(77));
-    lines.push('');
-
-    for (const envVar of vars) {
-      // Add description
-      if (options.format !== 'minimal') {
-        lines.push(`# ${envVar.description}`);
-
-        if (options.includeExamples && envVar.example) {
-          lines.push(`# Example: ${envVar.example}`);
-        }
-
-        if (options.securityWarnings && envVar.sensitive) {
-          lines.push('# ⚠️  SECURITY WARNING: This is a sensitive credential');
-          lines.push('#    - Never commit this to version control');
-          lines.push('#    - Use a strong, randomly generated value');
-          lines.push('#    - Store securely (e.g., password manager, secrets vault)');
-        }
-      }
-
-      // Generate value
-      let value = '';
-      if (environment === 'example') {
-        value = envVar.example || 'your-value-here';
-      } else if (options.generateSecrets && envVar.sensitive && !envVar.example?.includes('sk-')) {
-        value = generateSecret(options.secretLength);
-      } else {
-        value = envVar.defaultValue || envVar.example || '';
-      }
-
-      // Add variable
-      if (environment === 'example' || !value) {
-        lines.push(`${envVar.name}="${value}"`);
-      } else {
-        lines.push(`${envVar.name}="${value}"`);
-      }
-
-      lines.push('');
-    }
-
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Generate TypeScript type definitions
- */
-export function generateTypeDefs(variables: EnvVariable[]): string {
-  const lines: string[] = [];
-
-  lines.push('/**');
-  lines.push(' * Environment Variables Type Definitions');
-  lines.push(' * Generated by generate-env skill');
-  lines.push(' */');
-  lines.push('');
-  lines.push('declare global {');
-  lines.push('  namespace NodeJS {');
-  lines.push('    interface ProcessEnv {');
-
-  // Group by category
-  const categories = new Map<string, EnvVariable[]>();
-  variables.forEach(v => {
-    const cat = v.category;
-    if (!categories.has(cat)) categories.set(cat, []);
-    categories.get(cat)!.push(v);
-  });
-
-  for (const [category, vars] of categories) {
-    lines.push(`      // ${category.charAt(0).toUpperCase() + category.slice(1)}`);
-
-    for (const envVar of vars) {
-      let type = 'string';
-      if (envVar.name === 'NODE_ENV') {
-        type = "'development' | 'production' | 'test'";
-      } else if (envVar.name === 'PORT') {
-        type = 'string';
-      }
-
-      const optional = envVar.required ? '' : '?';
-      lines.push(`      ${envVar.name}${optional}: ${type};`);
-    }
-
-    lines.push('');
-  }
-
-  lines.push('    }');
-  lines.push('  }');
-  lines.push('}');
-  lines.push('');
-  lines.push('export {};');
-
-  return lines.join('\n');
-}
-
-/**
- * Generate Zod validation schema
- */
-export function generateValidation(variables: EnvVariable[]): string {
-  const lines: string[] = [];
-
-  lines.push("import { z } from 'zod';");
-  lines.push('');
-  lines.push('/**');
-  lines.push(' * Environment Variables Validation Schema');
-  lines.push(' * Generated by generate-env skill');
-  lines.push(' */');
-  lines.push('');
-  lines.push('export const envSchema = z.object({');
-
-  // Group by category
-  const categories = new Map<string, EnvVariable[]>();
-  variables.forEach(v => {
-    const cat = v.category;
-    if (!categories.has(cat)) categories.set(cat, []);
-    categories.get(cat)!.push(v);
-  });
-
-  for (const [category, vars] of categories) {
-    lines.push(`  // ${category.charAt(0).toUpperCase() + category.slice(1)}`);
-
-    for (const envVar of vars) {
-      let validation = envVar.validation || 'z.string()';
-
-      // Add specific validations
-      if (envVar.name.endsWith('_URL')) {
-        validation = 'z.string().url()';
-      } else if (envVar.name.endsWith('_EMAIL')) {
-        validation = 'z.string().email()';
-      } else if (envVar.sensitive && !envVar.validation) {
-        validation = 'z.string().min(1)';
-      }
-
-      if (!envVar.required) {
-        validation += '.optional()';
-      }
-
-      lines.push(`  ${envVar.name}: ${validation},`);
-    }
-
-    lines.push('');
-  }
-
-  lines.push('});');
-  lines.push('');
-  lines.push('export type Env = z.infer<typeof envSchema>;');
-  lines.push('');
-  lines.push('/**');
-  lines.push(' * Validate environment variables at runtime');
-  lines.push(' */');
-  lines.push('export function validateEnv(): Env {');
-  lines.push('  const parsed = envSchema.safeParse(process.env);');
-  lines.push('');
-  lines.push('  if (!parsed.success) {');
-  lines.push("    console.error('❌ Invalid environment variables:', parsed.error.flatten().fieldErrors);");
-  lines.push("    throw new Error('Invalid environment variables');");
-  lines.push('  }');
-  lines.push('');
-  lines.push('  return parsed.data;');
-  lines.push('}');
-
-  return lines.join('\n');
-}
-
-/**
- * Generate metadata file
- */
-export function generateMetadata(variables: EnvVariable[], options: GenerateOptions): string {
-  return JSON.stringify({
-    generatedAt: new Date().toISOString(),
-    totalVariables: variables.length,
-    categories: Array.from(new Set(variables.map(v => v.category))).sort(),
-    sensitiveCount: variables.filter(v => v.sensitive).length,
-    requiredCount: variables.filter(v => v.required).length,
-    options: {
-      templateOnly: options.templateOnly,
-      generateSecrets: options.generateSecrets,
-      withTypes: options.withTypes,
-      withValidation: options.withValidation,
-    },
-    variables: variables.map(v => ({
-      name: v.name,
-      category: v.category,
-      required: v.required,
-      sensitive: v.sensitive,
-    })),
-  }, null, 2);
-}

package/skills/generate-env/src/index.ts

@@ -1,120 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Environment Configuration Generator
- *
- * Analyzes codebase to detect environment variables and generates
- * comprehensive .env templates with documentation, types, and validation.
- */
-
-import { existsSync, mkdirSync, writeFileSync } from "fs";
-import { join } from "path";
-import { parseGenerateOptions } from "./cli";
-import { detectEnvVariables } from "./detection";
-import { COMMON_VARIABLES } from "./env-data";
-import {
-  generateEnvFile,
-  generateMetadata,
-  generateTypeDefs,
-  generateValidation,
-} from "./generators";
-import { SESSION_ID, SKILL_NAME, log } from "./runtime";
-import type { EnvVariable } from "./types";
-
-async function main() {
-  log(`Starting ${SKILL_NAME} session: ${SESSION_ID}`);
-
-  const options = parseGenerateOptions();
-  const variables = options.templateOnly
-    ? useTemplateVariables()
-    : await detectEnvVariables(options);
-
-  logCategoryCounts(variables);
-  logGeneratedSecrets(variables, options.generateSecrets, options.secretLength);
-
-  if (!existsSync(options.output)) {
-    mkdirSync(options.output, { recursive: true });
-  }
-
-  log("Writing configuration files...");
-
-  for (const env of options.envs) {
-    const filename = `${options.prefix}.${env}`;
-    const filepath = join(options.output, filename);
-    const content = generateEnvFile(variables, env, options);
-    writeFileSync(filepath, content, "utf-8");
-    log(`   ✓ ${filename}`);
-  }
-
-  if (options.withTypes) {
-    const filepath = join(options.output, "env.d.ts");
-    writeFileSync(filepath, generateTypeDefs(variables), "utf-8");
-    log("   ✓ env.d.ts (TypeScript types)");
-  }
-
-  if (options.withValidation) {
-    const filepath = join(options.output, "env.validation.ts");
-    writeFileSync(filepath, generateValidation(variables), "utf-8");
-    log("   ✓ env.validation.ts (Zod schema)");
-  }
-
-  const metadataPath = join(options.output, ".env.generated.json");
-  writeFileSync(metadataPath, generateMetadata(variables, options), "utf-8");
-  log("   ✓ .env.generated.json (metadata)");
-
-  log("Environment configuration generated successfully!", "success");
-  printNextSteps(options.withValidation);
-}
-
-function useTemplateVariables() {
-  log("Using template variables...");
-  return COMMON_VARIABLES;
-}
-
-function logCategoryCounts(variables: EnvVariable[]) {
-  if (variables.length === 0) return;
-
-  log("Categorizing variables...");
-  const categoryCounts = new Map<string, number>();
-  variables.forEach((variable) => {
-    categoryCounts.set(variable.category, (categoryCounts.get(variable.category) || 0) + 1);
-  });
-  categoryCounts.forEach((count, category) => {
-    log(`   ${category}: ${count} variables`);
-  });
-}
-
-function logGeneratedSecrets(variables: EnvVariable[], generateSecrets: boolean, secretLength: number) {
-  if (!generateSecrets) return;
-
-  log("Generating secrets...");
-  const secretVars = variables.filter((variable) => variable.sensitive);
-  secretVars.forEach((variable) => {
-    log(`   ✓ ${variable.name} (${secretLength} chars)`);
-  });
-}
-
-function printNextSteps(withValidation: boolean) {
-  console.log("⚠️  Important:");
-  console.log("   - Review generated values before committing");
-  console.log("   - Add .env.local and .env.production to .gitignore");
-  console.log("   - Update placeholder values in .env.example");
-  if (withValidation) {
-    console.log("   - Run validation: bun run env.validation.ts");
-  }
-  console.log("");
-
-  console.log("📚 Next steps:");
-  console.log("   1. Copy .env.example to .env.local");
-  console.log("   2. Fill in actual values for your environment");
-  if (withValidation) {
-    console.log("   3. Import and use validateEnv() in your app");
-  }
-  console.log("   4. Update values in CI/CD for production");
-  console.log("");
-}
-
-main().catch((error) => {
-  log(`Error: ${error.message}`, "error");
-  process.exit(1);
-});

package/skills/generate-env/src/runtime.ts

@@ -1,30 +0,0 @@
-import { appendFileSync, existsSync, mkdirSync } from "fs";
-import { randomUUID } from "crypto";
-import { join } from "path";
-
-export const SKILL_NAME = "generate-env";
-export const SESSION_ID = randomUUID().slice(0, 8);
-export const SKILLS_OUTPUT_DIR = process.env.SKILLS_OUTPUT_DIR || join(process.cwd(), ".skills");
-export const LOGS_DIR = join(SKILLS_OUTPUT_DIR, "logs", SKILL_NAME);
-export const SESSION_TIMESTAMP = new Date().toISOString().replace(/[:.]/g, "_").slice(0, 19);
-
-export function ensureDir(dir: string) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-
-export function log(message: string, level: "info" | "error" | "success" | "warn" = "info") {
-  ensureDir(LOGS_DIR);
-  const timestamp = new Date().toISOString();
-  const logFile = join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`);
-  const logEntry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-  appendFileSync(logFile, logEntry);
-
-  const prefix = level === "error" ? "❌" : level === "success" ? "✅" : level === "warn" ? "⚠️" : "ℹ️";
-  if (level === "error") {
-    console.error(`${prefix} ${message}`);
-  } else {
-    console.log(`${prefix} ${message}`);
-  }
-}

package/skills/generate-env/src/types.ts

@@ -1,32 +0,0 @@
-// ============================================================================
-
-export interface EnvVariable {
-  name: string;
-  category: string;
-  description: string;
-  example?: string;
-  defaultValue?: string;
-  required: boolean;
-  sensitive: boolean;
-  format?: string;
-  validation?: string;
-}
-
-export interface GenerateOptions {
-  dir: string;
-  include: string[];
-  exclude: string[];
-  output: string;
-  envs: string[];
-  prefix: string;
-  generateSecrets: boolean;
-  secretLength: number;
-  withTypes: boolean;
-  withValidation: boolean;
-  templateOnly: boolean;
-  categories: string[];
-  autoCategorize: boolean;
-  format: 'inline' | 'block' | 'minimal';
-  includeExamples: boolean;
-  securityWarnings: boolean;
-}

package/skills/generate-env/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist"
-  },
-  "include": [
-    "src/**/*",
-    "bin/**/*"
-  ]
-}

package/skills/generate-favicon/CLAUDE.md

@@ -1,19 +0,0 @@
-# generate-favicon
-
-Generate Favicon skill.
-
-## Tech Stack
-
-- Runtime: Bun
-- Language: TypeScript
-- CLI: Commander.js
-
-## CLI
-
-```bash
-generate-favicon run
-```
-
-## Data Directory
-
-~/.skill/generate-favicon/

package/skills/generate-favicon/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "generate-favicon",
-  "version": "0.1.0",
-  "description": "Generate Favicon skill",
-  "type": "module",
-  "bin": {
-    "generate-favicon": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "sharp": "^0.33.5"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
-}