@hasna/skills 0.1.62 → 0.1.63

package/skills/analyze-data/src/index.ts

@@ -1,74 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Analyze Data Skill
- *
- * Comprehensive data analysis for CSV and JSON files with statistics,
- * quality checks, correlation detection, and trend analysis.
- */
-
-import { statSync, writeFileSync } from 'fs';
-import { resolve } from 'path';
-
-import { analyzeData } from './analysis';
-import { parseArguments } from './cli';
-import { formatHTML, formatMarkdown } from './formatters';
-import { log, SESSION_ID, SKILL_NAME } from './logger';
-
-async function main() {
-  try {
-    log(`Starting ${SKILL_NAME} session: ${SESSION_ID}`);
-    const { filePath, options } = parseArguments();
-
-    // Check if file exists
-    try {
-      statSync(filePath);
-    } catch {
-      log(`Error: File not found: ${filePath}`, 'error');
-      process.exit(1);
-    }
-
-    // Perform analysis
-    const report = await analyzeData(filePath, options);
-
-    // Format output
-    let output: string;
-    switch (options.format) {
-      case 'json':
-        output = JSON.stringify(report, null, 2);
-        break;
-      case 'html':
-        output = formatHTML(report);
-        break;
-      default:
-        output = formatMarkdown(report);
-    }
-
-    // Save or print
-    if (options.output) {
-      const outputPath = resolve(process.cwd(), options.output);
-      writeFileSync(outputPath, output, 'utf-8');
-      log(`Report saved to: ${outputPath}`, 'success');
-    } else {
-      console.log(output);
-    }
-
-    // Show summary in verbose mode
-    if (options.verbose) {
-      log('Analysis Complete', 'success');
-      log(`Rows: ${report.overview.rowCount}`);
-      log(`Columns: ${report.overview.columnCount}`);
-      log(`Quality Score: ${report.quality.dataQualityScore}/100`);
-      log(`Processing Time: ${report.overview.processingTime}ms`);
-    }
-
-  } catch (error) {
-    log(`Error: ${error instanceof Error ? error.message : String(error)}`, 'error');
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-if (import.meta.main) {
-  main();
-}

package/skills/analyze-data/src/logger.ts

@@ -1,36 +0,0 @@
-import { appendFileSync, existsSync, mkdirSync } from 'fs';
-import { randomUUID } from 'crypto';
-import { join } from 'path';
-
-export const SKILL_NAME = "analyze-data";
-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 LOG_FILE = join(LOGS_DIR, `${new Date().toISOString().replace(/[:.]/g, "_").slice(0, 19)}_${SESSION_ID}.log`);
-
-export function ensureDir(dir: string) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-
-export function log(message: string, level: "info" | "error" | "success" = "info") {
-  ensureDir(LOGS_DIR);
-  const timestamp = new Date().toISOString();
-  const logMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-  appendFileSync(LOG_FILE, logMessage);
-
-  const prefixes = {
-    info: "ℹ️ ",
-    error: "❌ ",
-    success: "✅ "
-  };
-
-  if (level === "error") {
-    console.error(`${prefixes[level]} ${message}`);
-  } else {
-    console.log(`${prefixes[level]} ${message}`);
-  }
-}
-
-// ============================================================================

package/skills/analyze-data/src/parsers.ts

@@ -1,57 +0,0 @@
-export function parseCSV(content: string): any[] {
-  const lines = content.split('\n').filter(line => line.trim());
-  if (lines.length === 0) return [];
-
-  const headers = lines[0].split(',').map(h => h.trim().replace(/^"|"$/g, ''));
-  const data: any[] = [];
-
-  for (let i = 1; i < lines.length; i++) {
-    const values = parseCSVLine(lines[i]);
-    if (values.length === headers.length) {
-      const row: any = {};
-      headers.forEach((header, idx) => {
-        row[header] = values[idx];
-      });
-      data.push(row);
-    }
-  }
-
-  return data;
-}
-
-function parseCSVLine(line: string): string[] {
-  const values: string[] = [];
-  let current = '';
-  let inQuotes = false;
-
-  for (let i = 0; i < line.length; i++) {
-    const char = line[i];
-
-    if (char === '"') {
-      inQuotes = !inQuotes;
-    } else if (char === ',' && !inQuotes) {
-      values.push(current.trim());
-      current = '';
-    } else {
-      current += char;
-    }
-  }
-
-  values.push(current.trim());
-  return values.map(v => v.replace(/^"|"$/g, ''));
-}
-
-export function parseJSON(content: string): any[] {
-  const parsed = JSON.parse(content);
-
-  if (Array.isArray(parsed)) {
-    return parsed;
-  } else if (parsed.data && Array.isArray(parsed.data)) {
-    return parsed.data;
-  } else if (typeof parsed === 'object') {
-    // Convert object to array of key-value pairs
-    return Object.entries(parsed).map(([key, value]) => ({ key, value }));
-  }
-
-  throw new Error('Unsupported JSON structure');
-}

package/skills/analyze-data/src/stats.ts

@@ -1,151 +0,0 @@
-import type { ColumnStats } from './types';
-
-export function detectDataType(values: any[]): ColumnStats['dataType'] {
-  const nonNullValues = values.filter(v => v !== null && v !== undefined && v !== '');
-  if (nonNullValues.length === 0) return 'string';
-
-  let numericCount = 0;
-  let dateCount = 0;
-  let booleanCount = 0;
-
-  for (const value of nonNullValues.slice(0, 100)) {
-    if (typeof value === 'number' || !isNaN(Number(value))) {
-      numericCount++;
-    }
-    if (value === true || value === false || value === 'true' || value === 'false') {
-      booleanCount++;
-    }
-    if (!isNaN(Date.parse(String(value)))) {
-      dateCount++;
-    }
-  }
-
-  const total = Math.min(nonNullValues.length, 100);
-
-  if (numericCount / total > 0.8) return 'numeric';
-  if (booleanCount / total > 0.8) return 'boolean';
-  if (dateCount / total > 0.8) return 'date';
-  if (numericCount > 0 && numericCount < total * 0.8) return 'mixed';
-
-  return 'string';
-}
-
-export function calculateStats(values: number[]): Partial<ColumnStats> {
-  if (values.length === 0) return {};
-
-  const sorted = [...values].sort((a, b) => a - b);
-  const n = sorted.length;
-
-  // Basic stats
-  const sum = sorted.reduce((acc, val) => acc + val, 0);
-  const mean = sum / n;
-
-  const median = n % 2 === 0
-    ? (sorted[n / 2 - 1] + sorted[n / 2]) / 2
-    : sorted[Math.floor(n / 2)];
-
-  // Mode
-  const frequency: Record<number, number> = {};
-  sorted.forEach(val => {
-    frequency[val] = (frequency[val] || 0) + 1;
-  });
-  const maxFreq = Math.max(...Object.values(frequency));
-  const modes = Object.keys(frequency)
-    .filter(key => frequency[Number(key)] === maxFreq)
-    .map(Number);
-  const mode = modes.length === sorted.length ? undefined : (modes.length === 1 ? modes[0] : modes);
-
-  // Variance and standard deviation
-  const squaredDiffs = sorted.map(val => Math.pow(val - mean, 2));
-  const variance = squaredDiffs.reduce((acc, val) => acc + val, 0) / n;
-  const stdDev = Math.sqrt(variance);
-
-  // Quartiles
-  const q1 = sorted[Math.floor(n * 0.25)];
-  const q2 = median;
-  const q3 = sorted[Math.floor(n * 0.75)];
-
-  // Skewness and kurtosis
-  const cubedDiffs = sorted.map(val => Math.pow((val - mean) / stdDev, 3));
-  const skewness = cubedDiffs.reduce((acc, val) => acc + val, 0) / n;
-
-  const fourthDiffs = sorted.map(val => Math.pow((val - mean) / stdDev, 4));
-  const kurtosis = fourthDiffs.reduce((acc, val) => acc + val, 0) / n - 3;
-
-  return {
-    mean: roundTo(mean, 4),
-    median: roundTo(median, 4),
-    mode,
-    stdDev: roundTo(stdDev, 4),
-    variance: roundTo(variance, 4),
-    min: sorted[0],
-    max: sorted[n - 1],
-    range: sorted[n - 1] - sorted[0],
-    q1: roundTo(q1, 4),
-    q2: roundTo(q2, 4),
-    q3: roundTo(q3, 4),
-    skewness: roundTo(skewness, 4),
-    kurtosis: roundTo(kurtosis, 4),
-  };
-}
-
-export function calculatePercentiles(values: number[], percentiles: number[]): Record<number, number> {
-  const sorted = [...values].sort((a, b) => a - b);
-  const result: Record<number, number> = {};
-
-  percentiles.forEach(p => {
-    const index = (p / 100) * (sorted.length - 1);
-    const lower = Math.floor(index);
-    const upper = Math.ceil(index);
-    const fraction = index - lower;
-
-    result[p] = sorted[lower] + fraction * (sorted[upper] - sorted[lower]);
-  });
-
-  return result;
-}
-
-export function detectOutliers(values: number[], q1: number, q3: number): number[] {
-  const iqr = q3 - q1;
-  const lowerBound = q1 - 1.5 * iqr;
-  const upperBound = q3 + 1.5 * iqr;
-
-  return values.filter(val => val < lowerBound || val > upperBound);
-}
-
-export function calculateCorrelation(x: number[], y: number[]): number {
-  const n = Math.min(x.length, y.length);
-  if (n === 0) return 0;
-
-  const meanX = x.reduce((acc, val) => acc + val, 0) / n;
-  const meanY = y.reduce((acc, val) => acc + val, 0) / n;
-
-  let numerator = 0;
-  let sumXSquared = 0;
-  let sumYSquared = 0;
-
-  for (let i = 0; i < n; i++) {
-    const dx = x[i] - meanX;
-    const dy = y[i] - meanY;
-    numerator += dx * dy;
-    sumXSquared += dx * dx;
-    sumYSquared += dy * dy;
-  }
-
-  const denominator = Math.sqrt(sumXSquared * sumYSquared);
-  return denominator === 0 ? 0 : numerator / denominator;
-}
-
-export function roundTo(value: number, decimals: number): number {
-  const factor = Math.pow(10, decimals);
-  return Math.round(value * factor) / factor;
-}
-
-export function formatBytes(bytes: number): string {
-  if (bytes < 1024) return bytes + ' B';
-  if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(2) + ' KB';
-  if (bytes < 1024 * 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(2) + ' MB';
-  return (bytes / (1024 * 1024 * 1024)).toFixed(2) + ' GB';
-}
-
-// ============================================================================

package/skills/analyze-data/src/types.ts

@@ -1,85 +0,0 @@
-export interface AnalysisOptions {
-  format: 'markdown' | 'json' | 'html';
-  output?: string;
-  correlations: boolean;
-  outliers: boolean;
-  trends: boolean;
-  sample?: number;
-  percentiles: number[];
-  verbose: boolean;
-}
-
-export interface ColumnStats {
-  name: string;
-  dataType: 'numeric' | 'string' | 'date' | 'boolean' | 'mixed';
-  count: number;
-  nullCount: number;
-  nullPercentage: number;
-  uniqueCount: number;
-  uniquePercentage: number;
-  sampleValues: any[];
-
-  // Numeric stats
-  mean?: number;
-  median?: number;
-  mode?: number | number[];
-  stdDev?: number;
-  variance?: number;
-  min?: number;
-  max?: number;
-  range?: number;
-  q1?: number;
-  q2?: number;
-  q3?: number;
-  percentiles?: Record<number, number>;
-  skewness?: number;
-  kurtosis?: number;
-  outliers?: number[];
-
-  // String stats
-  avgLength?: number;
-  minLength?: number;
-  maxLength?: number;
-
-  // Distribution
-  distribution?: Record<string, number>;
-  topValues?: Array<{ value: any; count: number; percentage: number }>;
-}
-
-export interface AnalysisReport {
-  overview: {
-    fileName: string;
-    fileSize: string;
-    fileType: string;
-    rowCount: number;
-    columnCount: number;
-    memoryUsage: string;
-    processingTime: number;
-    timestamp: string;
-  };
-  columns: ColumnStats[];
-  correlations?: number[][];
-  correlationPairs?: Array<{ col1: string; col2: string; correlation: number }>;
-  quality: {
-    totalCells: number;
-    missingCells: number;
-    missingPercentage: number;
-    duplicateRows: number;
-    duplicatePercentage: number;
-    dataQualityScore: number;
-    issues: string[];
-  };
-  trends?: {
-    detected: boolean;
-    patterns: string[];
-    insights: string[];
-  };
-  visualizationRecommendations: Array<{
-    column: string;
-    chartType: string;
-    reason: string;
-  }>;
-  insights: string[];
-}
-
-// ============================================================================

package/skills/analyze-data/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "dist",
-    "rootDir": ".",
-    "types": [
-      "bun"
-    ]
-  },
-  "include": [
-    "src/**/*",
-    "bin/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/skills/api-docs-portal/SKILL.md

@@ -1,84 +0,0 @@
----
-name: api-docs-portal
-description: Generate a self-contained static API documentation portal, normalized endpoint JSON, and a markdown reference from an OpenAPI 3.x or Swagger 2.0 spec.
----
-
-# API Docs Portal
-
-Turn an OpenAPI/Swagger document into a browsable static portal. Everything is
-generated locally and deterministically: no network calls, no credentials, and
-the emitted HTML makes no external requests.
-
-## What It Does
-
-- Reads OpenAPI 3.x or Swagger 2.0 specs in JSON or YAML.
-- Resolves local `$ref` pointers (`#/components/schemas/...`, `#/definitions/...`) with a cycle guard, so referenced request/response schemas render inline.
-- Groups endpoints by their first tag, falling back to the first path segment.
-- Renders method, path, summary, description, deprecation, path/query/header/cookie parameters (including path-level shared parameters), request body fields, and per-status response fields.
-- Flattens nested object schemas up to three levels and labels types (`string<uuid>`, `object[]`, `string (open | paid | cancelled)`, `A | B`).
-- Extracts security schemes and per-operation security requirements, and generates a cURL example per endpoint.
-
-## Requirements
-
-- [Bun](https://bun.sh) 1.x
-- npm dependency: `yaml` (install once with `bun install` in this skill directory) — only needed for YAML specs, JSON specs parse natively
-- An OpenAPI/Swagger document with a `paths` object. External (`http://`, `other.yaml#/...`) `$ref`s are not fetched; they are marked as unresolved in the output.
-
-## Usage
-
-```bash
-# Generate the portal into ./api-portal
-skills run api-docs-portal -- --spec ./openapi.yaml
-
-# Dark theme, custom output directory and base URL
-skills run api-docs-portal -- --spec ./openapi.json --output ./docs/api \
-  --theme slate --base-url https://api.example.com/v2
-
-# Machine-readable summary on stdout
-skills run api-docs-portal -- --spec ./openapi.yaml --json
-```
-
-Then open `./api-portal/index.html` in a browser. Run it directly from the skill
-directory with `bun run src/index.ts --spec ./openapi.yaml`.
-
-## Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `-s, --spec <path>` | OpenAPI/Swagger document, JSON or YAML (also accepted positionally) | required |
-| `-o, --output <dir>` | Output directory | `./api-portal` |
-| `--theme <name>` | `light` or `slate` | `light` |
-| `--base-url <url>` | Base URL shown in the portal and cURL examples | first `servers[].url` |
-| `--title <text>` | Override the portal title | spec `info.title` |
-| `--json` | Print a JSON summary on stdout | off |
-| `--help` | Show usage | |
-| `--version` | Show version | |
-
-## Outputs
-
-Written into `--output` (default `./api-portal`):
-
-| File | Contents |
-|------|----------|
-| `index.html` | Self-contained portal: inline CSS, sticky sidebar navigation, responsive layout, zero external requests (no CDN scripts, fonts, or images) |
-| `endpoints.json` | Normalized endpoint model (method, path, group, params, request body fields, response fields, security) |
-| `reference.md` | Markdown API reference with parameter/field tables and cURL examples |
-
-Without `--json`, a summary is printed to stdout:
-
-```
-api-docs-portal: /abs/path/openapi.yaml
-  title      Orders API v2.1.0
-  base url   https://api.example.com/v2
-  theme      slate
-  endpoints  5 in 2 groups
-    customers: 1
-    orders: 4
-  output     /abs/path/api-portal
-  files      index.html, endpoints.json, reference.md
-```
-
-## Exit Codes
-
-- `0` — portal generated
-- `1` — missing/unreadable spec, invalid JSON/YAML, no `paths` object, no operations, or an invalid option value

package/skills/api-docs-portal/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "api-docs-portal",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Generate a self-contained static API documentation portal from an OpenAPI or Swagger spec",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "api-docs-portal": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "SKILL.md",
-    "tsconfig.json"
-  ],
-  "keywords": [
-    "openapi",
-    "swagger",
-    "documentation",
-    "static-site",
-    "cli",
-    "skill"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "yaml": "^2.8.2"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  }
-}