craftclose 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Core types for CraftClose skill configuration and data.
+ */
+/** SSH connection configuration */
+export interface SshConfig {
+    user: string;
+    host?: string;
+    port?: number;
+    key?: string;
+    password?: string;
+}
+/** RCON connection configuration */
+export interface RconConfig {
+    host?: string;
+    port: number;
+    password: string;
+}
+/** Pterodactyl panel configuration */
+export interface PterodactylConfig {
+    panel_url: string;
+    api_key: string;
+    server_id: string;
+}
+/** Individual server configuration */
+export interface ServerConfig {
+    name: string;
+    host: string;
+    port?: number;
+    type?: "paper" | "spigot" | "folia" | "purpur" | "fabric" | "forge" | "vanilla";
+    ssh?: SshConfig;
+    rcon?: RconConfig;
+    pterodactyl?: PterodactylConfig;
+    restart_command?: string;
+    log_path?: string;
+}
+/** Alert channel configurations */
+export interface AlertConfig {
+    telegram?: {
+        bot_token: string;
+        chat_id: string;
+    };
+    discord?: {
+        webhook_url: string;
+    };
+}
+/** AI configuration (BYOK — user's own Gemini API key) */
+export interface AiConfig {
+    /** User's own Gemini API key */
+    gemini_key?: string;
+    /** Gemini model to use */
+    model?: "gemini-2.5-flash" | "gemini-2.5-pro" | "gemini-3.1-flash" | "gemini-3.1-pro";
+    /** Max AI calls per hour (default: 10) */
+    max_calls_per_hour?: number;
+}
+/** Monitoring configuration */
+export interface MonitoringConfig {
+    /** Check interval in seconds (default: 60) */
+    interval?: number;
+    /** Enable auto-restart on crash (default: true) */
+    auto_restart?: boolean;
+    /** Max restarts per 10 minutes before circuit break (default: 3) */
+    max_restarts?: number;
+    /** Enable TPS tracking history (default: true) */
+    track_tps?: boolean;
+    /** Enable player count tracking (default: true) */
+    track_players?: boolean;
+}
+/** Security configuration */
+export interface SecurityConfig {
+    /** Require confirmation for destructive actions (default: true) */
+    confirm_destructive?: boolean;
+    /** Max log lines to read per request (default: 500) */
+    max_log_lines?: number;
+    /** Max backup size in GB (default: 10) */
+    max_backup_size_gb?: number;
+    /** Override default config file allowlist */
+    allowed_config_files?: string[];
+    /** Add extra blocked RCON commands */
+    blocked_rcon_commands?: string[];
+}
+/** Root CraftClose configuration */
+export interface CraftCloseConfig {
+    servers: ServerConfig[];
+    alerts?: AlertConfig;
+    ai?: AiConfig;
+    monitoring?: MonitoringConfig;
+    security?: SecurityConfig;
+}
+/** Health check result for a single server */
+export interface HealthCheckResult {
+    server: string;
+    timestamp: Date;
+    online: boolean;
+    cpu?: number;
+    ram?: {
+        used: number;
+        total: number;
+        percent: number;
+    };
+    disk?: {
+        used: number;
+        total: number;
+        percent: number;
+    };
+    tps?: number;
+    players?: {
+        online: number;
+        max: number;
+        list?: string[];
+    };
+    uptime?: string;
+    version?: string;
+    error?: string;
+}
+/** Crash detection event */
+export interface CrashEvent {
+    server: string;
+    timestamp: Date;
+    type: "process_dead" | "tps_zero" | "oom" | "log_pattern" | "timeout";
+    severity: "critical" | "warning" | "info";
+    raw_log?: string;
+    pattern_match?: PatternMatch;
+    ai_analysis?: AiAnalysis;
+}
+/** Pattern library match result */
+export interface PatternMatch {
+    pattern_id: string;
+    category: string;
+    title: string;
+    cause: string;
+    fix: string;
+    confidence: number;
+}
+/** AI analysis result */
+export interface AiAnalysis {
+    root_cause: string;
+    severity: "critical" | "warning" | "info";
+    fix_suggestion: string;
+    confidence: number;
+    model: string;
+    cached: boolean;
+}
+/** Alert payload sent to Telegram/Discord */
+export interface AlertPayload {
+    server: string;
+    event: "crash" | "restart" | "recovery" | "warning" | "info";
+    title: string;
+    description: string;
+    severity: "critical" | "warning" | "info" | "recovery";
+    timestamp: Date;
+    ai_analysis?: AiAnalysis;
+    pattern_match?: PatternMatch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core types for CraftClose skill configuration and data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "craftclose",
+  "version": "0.1.0",
+  "description": "AI-powered Minecraft server monitoring — crash detection, auto-restart, smart alerts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "craftclose": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/ --ext .ts",
+    "lint:fix": "eslint src/ --ext .ts --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:patterns": "vitest run tests/patterns",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "files": [
+    "dist/",
+    "craftclose.example.yml",
+    "SKILL.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "openclaw",
+    "openclaw-skill",
+    "minecraft",
+    "server-monitoring",
+    "ai",
+    "gemini",
+    "crash-detection",
+    "auto-restart",
+    "pterodactyl",
+    "devops",
+    "gameserver"
+  ],
+  "author": {
+    "name": "LaunchDay Studio",
+    "email": "info@launchdaystudio.com",
+    "url": "https://launchdaystudio.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LaunchDay-Studio-Inc/craftclose.git"
+  },
+  "homepage": "https://craftclose.dev",
+  "bugs": {
+    "url": "https://github.com/LaunchDay-Studio-Inc/craftclose/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.8.0",
+    "rcon-client": "^4.2.4",
+    "ssh2": "^1.16.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^25.5.0",
+    "@types/ssh2": "^1.15.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.5.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}