kastell 2.2.3 → 2.2.5

package/kastell-plugin/skills/kastell-scaffold/templates/command-core.ts.tpl

@@ -1,18 +1,18 @@
-export interface __NAME_PASCAL__Options {
-  server?: string;
-  json?: boolean;
-}
-
-export interface __NAME_PASCAL__Result {
-  success: boolean;
-  message: string;
-}
-
-export async function __NAME_CAMEL__Core(
-  options: __NAME_PASCAL__Options,
-): Promise<__NAME_PASCAL__Result> {
-  // ALL business logic here. NO chalk/ora/UI imports.
-  // assertValidIp() before SSH. getAdapter(platform) for platform ops.
-  // withProviderErrorHandling() for provider calls.
-  throw new Error("Not implemented");
-}
+export interface __NAME_PASCAL__Options {
+  server?: string;
+  json?: boolean;
+}
+
+export interface __NAME_PASCAL__Result {
+  success: boolean;
+  message: string;
+}
+
+export async function __NAME_CAMEL__Core(
+  options: __NAME_PASCAL__Options,
+): Promise<__NAME_PASCAL__Result> {
+  // ALL business logic here. NO chalk/ora/UI imports.
+  // assertValidIp() before SSH. getAdapter(platform) for platform ops.
+  // withProviderErrorHandling() for provider calls.
+  throw new Error("Not implemented");
+}

package/kastell-plugin/skills/kastell-scaffold/templates/command-test.ts.tpl

@@ -1,17 +1,17 @@
-import { __NAME_CAMEL__Core } from "../../core/__NAME__.js";
-
-jest.mock("../../utils/ssh.js");
-
-describe("__NAME_CAMEL__Core", () => {
-  beforeEach(() => jest.resetAllMocks());
-
-  it("should TODO: describe expected behavior", async () => {
-    const result = await __NAME_CAMEL__Core({ server: "test-server" });
-    expect(result.success).toBe(true);
-  });
-
-  it("should handle missing server gracefully", async () => {
-    const result = await __NAME_CAMEL__Core({});
-    expect(result.success).toBe(false);
-  });
-});
+import { __NAME_CAMEL__Core } from "../../core/__NAME__.js";
+
+jest.mock("../../utils/ssh.js");
+
+describe("__NAME_CAMEL__Core", () => {
+  beforeEach(() => jest.resetAllMocks());
+
+  it("should TODO: describe expected behavior", async () => {
+    const result = await __NAME_CAMEL__Core({ server: "test-server" });
+    expect(result.success).toBe(true);
+  });
+
+  it("should handle missing server gracefully", async () => {
+    const result = await __NAME_CAMEL__Core({});
+    expect(result.success).toBe(false);
+  });
+});

package/kastell-plugin/skills/kastell-scaffold/templates/command.ts.tpl

@@ -1,25 +1,25 @@
-import { program } from "commander";
-import chalk from "chalk";
-import ora from "ora";
-import { __NAME_CAMEL__Core } from "../core/__NAME__.js";
-
-program
-  .command("__NAME__")
-  .description("TODO: describe what this command does")
-  .option("--server <name>", "Target server name or IP")
-  .option("--json", "Output as JSON")
-  .action(async (options) => {
-    const spinner = ora("Running __NAME__...").start();
-    try {
-      const result = await __NAME_CAMEL__Core(options);
-      spinner.succeed("Done");
-      if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(chalk.green(result.message));
-      }
-    } catch (error) {
-      spinner.fail(error instanceof Error ? error.message : "Unknown error");
-      process.exitCode = 1;
-    }
-  });
+import { program } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { __NAME_CAMEL__Core } from "../core/__NAME__.js";
+
+program
+  .command("__NAME__")
+  .description("TODO: describe what this command does")
+  .option("--server <name>", "Target server name or IP")
+  .option("--json", "Output as JSON")
+  .action(async (options) => {
+    const spinner = ora("Running __NAME__...").start();
+    try {
+      const result = await __NAME_CAMEL__Core(options);
+      spinner.succeed("Done");
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(chalk.green(result.message));
+      }
+    } catch (error) {
+      spinner.fail(error instanceof Error ? error.message : "Unknown error");
+      process.exitCode = 1;
+    }
+  });

package/kastell-plugin/skills/kastell-scaffold/templates/mcp-tool-test.ts.tpl

@@ -1,30 +1,30 @@
-import { handle__NAME_PASCAL__ } from "../../mcp/tools/__NAME__.js";
-
-// Mock the core dependency
-// jest.mock("../../core/__NAME__.js");
-
-describe("handle__NAME_PASCAL__", () => {
-  beforeEach(() => jest.resetAllMocks());
-
-  it("returns success response", async () => {
-    const result = await handle__NAME_PASCAL__({
-      server: "test-server",
-      action: "TODO",
-    });
-
-    expect(result.isError).toBeUndefined();
-    expect(result.content[0].text).toContain("success");
-  });
-
-  it("handles missing server gracefully", async () => {
-    const result = await handle__NAME_PASCAL__({
-      action: "TODO",
-    });
-
-    expect(result.content).toBeDefined();
-  });
-
-  it("returns error on failure", async () => {
-    // TODO: mock core to reject, verify isError
-  });
-});
+import { handle__NAME_PASCAL__ } from "../../mcp/tools/__NAME__.js";
+
+// Mock the core dependency
+// jest.mock("../../core/__NAME__.js");
+
+describe("handle__NAME_PASCAL__", () => {
+  beforeEach(() => jest.resetAllMocks());
+
+  it("returns success response", async () => {
+    const result = await handle__NAME_PASCAL__({
+      server: "test-server",
+      action: "TODO",
+    });
+
+    expect(result.isError).toBeUndefined();
+    expect(result.content[0].text).toContain("success");
+  });
+
+  it("handles missing server gracefully", async () => {
+    const result = await handle__NAME_PASCAL__({
+      action: "TODO",
+    });
+
+    expect(result.content).toBeDefined();
+  });
+
+  it("returns error on failure", async () => {
+    // TODO: mock core to reject, verify isError
+  });
+});

package/kastell-plugin/skills/kastell-scaffold/templates/mcp-tool.ts.tpl

@@ -1,29 +1,29 @@
-import { z } from "zod";
-import type { McpResponse } from "../types.js";
-
-// IMPORTANT: Schema is a flat object, NOT wrapped in z.object()
-// The SDK wraps it automatically
-export const __NAME_CAMEL__Schema = {
-  server: z
-    .string()
-    .optional()
-    .describe("Server name or IP. Auto-selected if only one server exists."),
-  action: z.enum(["TODO"]).describe("TODO: describe actions"),
-};
-
-export async function handle__NAME_PASCAL__(params: {
-  server?: string;
-  action: string;
-}): Promise<McpResponse> {
-  // Delegate to core function (NOT direct SSH/provider calls)
-  // Example: const result = await someCoreFunction(params);
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify({ success: true }, null, 2),
-      },
-    ],
-  };
-}
+import { z } from "zod";
+import type { McpResponse } from "../types.js";
+
+// IMPORTANT: Schema is a flat object, NOT wrapped in z.object()
+// The SDK wraps it automatically
+export const __NAME_CAMEL__Schema = {
+  server: z
+    .string()
+    .optional()
+    .describe("Server name or IP. Auto-selected if only one server exists."),
+  action: z.enum(["TODO"]).describe("TODO: describe actions"),
+};
+
+export async function handle__NAME_PASCAL__(params: {
+  server?: string;
+  action: string;
+}): Promise<McpResponse> {
+  // Delegate to core function (NOT direct SSH/provider calls)
+  // Example: const result = await someCoreFunction(params);
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify({ success: true }, null, 2),
+      },
+    ],
+  };
+}

package/kastell-plugin/skills/kastell-scaffold/templates/provider-test.ts.tpl

@@ -1,34 +1,34 @@
-import { __NAME_PASCAL__Provider } from "../../providers/__NAME__.js";
-
-// Mock axios at module level
-jest.mock("axios", () => ({
-  create: jest.fn(() => ({
-    get: jest.fn(),
-    post: jest.fn(),
-    delete: jest.fn(),
-  })),
-}));
-
-describe("__NAME_PASCAL__Provider", () => {
-  let provider: __NAME_PASCAL__Provider;
-
-  beforeEach(() => {
-    jest.resetAllMocks();
-    provider = new __NAME_PASCAL__Provider("test-token");
-  });
-
-  it("should create instance with correct base URL", () => {
-    expect(provider).toBeDefined();
-  });
-
-  it("should list servers", async () => {
-    // TODO: mock API response and verify
-    await expect(provider.listServers()).resolves.toBeDefined();
-  });
-
-  it("should create server", async () => {
-    // TODO: mock API response and verify
-    const params = { name: "test", region: "us-east", size: "small" };
-    await expect(provider.createServer(params)).resolves.toBeDefined();
-  });
-});
+import { __NAME_PASCAL__Provider } from "../../providers/__NAME__.js";
+
+// Mock axios at module level
+jest.mock("axios", () => ({
+  create: jest.fn(() => ({
+    get: jest.fn(),
+    post: jest.fn(),
+    delete: jest.fn(),
+  })),
+}));
+
+describe("__NAME_PASCAL__Provider", () => {
+  let provider: __NAME_PASCAL__Provider;
+
+  beforeEach(() => {
+    jest.resetAllMocks();
+    provider = new __NAME_PASCAL__Provider("test-token");
+  });
+
+  it("should create instance with correct base URL", () => {
+    expect(provider).toBeDefined();
+  });
+
+  it("should list servers", async () => {
+    // TODO: mock API response and verify
+    await expect(provider.listServers()).resolves.toBeDefined();
+  });
+
+  it("should create server", async () => {
+    // TODO: mock API response and verify
+    const params = { name: "test", region: "us-east", size: "small" };
+    await expect(provider.createServer(params)).resolves.toBeDefined();
+  });
+});

package/kastell-plugin/skills/kastell-scaffold/templates/provider.ts.tpl

@@ -1,32 +1,32 @@
-import {
-  BaseProvider,
-  type ProviderServer,
-  type CreateServerParams,
-  type ProviderResponse,
-} from "./base.js";
-
-export class __NAME_PASCAL__Provider extends BaseProvider {
-  constructor(token: string) {
-    super(token, "https://api.__NAME__.com/v1"); // TODO: adjust API base URL
-  }
-
-  async listServers(): Promise<ProviderResponse<ProviderServer[]>> {
-    return this.request<ProviderServer[]>("GET", "/servers");
-  }
-
-  async createServer(
-    params: CreateServerParams,
-  ): Promise<ProviderResponse<ProviderServer>> {
-    return this.request<ProviderServer>("POST", "/servers", { body: params });
-  }
-
-  async deleteServer(serverId: string): Promise<ProviderResponse<void>> {
-    return this.request<void>("DELETE", `/servers/${serverId}`);
-  }
-
-  async getServer(
-    serverId: string,
-  ): Promise<ProviderResponse<ProviderServer>> {
-    return this.request<ProviderServer>("GET", `/servers/${serverId}`);
-  }
-}
+import {
+  BaseProvider,
+  type ProviderServer,
+  type CreateServerParams,
+  type ProviderResponse,
+} from "./base.js";
+
+export class __NAME_PASCAL__Provider extends BaseProvider {
+  constructor(token: string) {
+    super(token, "https://api.__NAME__.com/v1"); // TODO: adjust API base URL
+  }
+
+  async listServers(): Promise<ProviderResponse<ProviderServer[]>> {
+    return this.request<ProviderServer[]>("GET", "/servers");
+  }
+
+  async createServer(
+    params: CreateServerParams,
+  ): Promise<ProviderResponse<ProviderServer>> {
+    return this.request<ProviderServer>("POST", "/servers", { body: params });
+  }
+
+  async deleteServer(serverId: string): Promise<ProviderResponse<void>> {
+    return this.request<void>("DELETE", `/servers/${serverId}`);
+  }
+
+  async getServer(
+    serverId: string,
+  ): Promise<ProviderResponse<ProviderServer>> {
+    return this.request<ProviderServer>("GET", `/servers/${serverId}`);
+  }
+}

package/package.json

@@ -1,122 +1,125 @@
-{
-  "name": "kastell",
-  "version": "2.2.3",
-  "description": "CLI toolkit for provisioning, securing, and managing self-hosted servers",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "kastell": "bin/kastell",
-    "kastell-mcp": "bin/kastell-mcp"
-  },
-  "files": [
-    "bin/",
-    "dist/",
-    ".claude-plugin/",
-    "kastell-plugin/skills/",
-    "kastell-plugin/agents/",
-    "kastell-plugin/hooks/",
-    "kastell-plugin/.claude-plugin/",
-    "kastell-plugin/.mcp.json",
-    "kastell-plugin/README.md",
-    "README.md",
-    "LICENSE",
-    "NOTICE",
-    "SECURITY.md",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "test": "jest --config jest.config.cjs",
-    "test:watch": "jest --config jest.config.cjs --watch",
-    "test:coverage": "jest --config jest.config.cjs --coverage",
-    "test:mutate": "cp .stryker-tmp/incremental.json .stryker-tmp/incremental.backup.json 2>/dev/null; stryker run",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\""
-  },
-  "mcpName": "io.github.kastelldev/kastell",
-  "keywords": [
-    "kastell",
-    "mcp-server",
-    "coolify",
-    "deployment",
-    "hetzner",
-    "digitalocean",
-    "vultr",
-    "linode",
-    "cli",
-    "vps",
-    "cloud",
-    "automation",
-    "self-hosted",
-    "server-security",
-    "server-maintenance",
-    "infrastructure",
-    "devops",
-    "server"
-  ],
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/kastelldev/kastell.git"
-  },
-  "bugs": {
-    "url": "https://github.com/kastelldev/kastell/issues"
-  },
-  "homepage": "https://kastell.dev",
-  "author": {
-    "name": "Ömer",
-    "email": "hello@omrfc.dev",
-    "url": "https://omrfc.dev"
-  },
-  "funding": {
-    "type": "github",
-    "url": "https://github.com/sponsors/omrfc"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "1.27.1",
-    "@napi-rs/keyring": "1.2.0",
-    "axios": "1.15.0",
-    "chalk": "5.6.2",
-    "commander": "14.0.3",
-    "grammy": "1.41.1",
-    "inquirer": "12.11.1",
-    "js-yaml": "4.1.1",
-    "ora": "9.3.0",
-    "p-limit": "7.3.0",
-    "semver": "7.7.2",
-    "zod": "4.3.6"
-  },
-  "overrides": {
-    "minimatch": "^10.2.4"
-  },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@stryker-mutator/core": "^9.6.0",
-    "@stryker-mutator/jest-runner": "^9.6.0",
-    "@stryker-mutator/typescript-checker": "^9.6.0",
-    "@types/inquirer": "^9.0.7",
-    "@types/jest": "^30.0.0",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.12.0",
-    "@types/semver": "7.7.0",
-    "eslint": "^10.0.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-no-secrets": "^2.3.3",
-    "eslint-plugin-security": "^4.0.0",
-    "fast-check": "^4.7.0",
-    "ignore": "^7.0.5",
-    "jest": "^30.2.0",
-    "prettier": "^3.8.1",
-    "ts-jest": "^29.4.6",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.1"
-  }
-}
+{
+  "name": "kastell",
+  "version": "2.2.5",
+  "description": "CLI toolkit for provisioning, securing, and managing self-hosted servers",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "kastell": "bin/kastell",
+    "kastell-mcp": "bin/kastell-mcp"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    ".claude-plugin/",
+    "kastell-plugin/skills/",
+    "kastell-plugin/agents/",
+    "kastell-plugin/hooks/",
+    "kastell-plugin/.claude-plugin/",
+    "kastell-plugin/.mcp.json",
+    "kastell-plugin/README.md",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "SECURITY.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc && node scripts/bundle-mcp.mjs",
+    "bundle:mcp": "node scripts/bundle-mcp.mjs",
+    "start": "node dist/index.js",
+    "test": "jest --config jest.config.cjs",
+    "test:watch": "jest --config jest.config.cjs --watch",
+    "test:coverage": "jest --config jest.config.cjs --coverage",
+    "test:mutate": "cp .stryker-tmp/incremental.json .stryker-tmp/incremental.backup.json 2>/dev/null; stryker run",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  },
+  "mcpName": "io.github.kastelldev/kastell",
+  "keywords": [
+    "kastell",
+    "mcp-server",
+    "coolify",
+    "deployment",
+    "hetzner",
+    "digitalocean",
+    "vultr",
+    "linode",
+    "cli",
+    "vps",
+    "cloud",
+    "automation",
+    "self-hosted",
+    "server-security",
+    "server-maintenance",
+    "infrastructure",
+    "devops",
+    "server"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kastelldev/kastell.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kastelldev/kastell/issues"
+  },
+  "homepage": "https://kastell.dev",
+  "author": {
+    "name": "Ömer",
+    "email": "hello@omrfc.dev",
+    "url": "https://omrfc.dev"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/omrfc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "@napi-rs/keyring": "1.2.0",
+    "axios": "1.15.2",
+    "chalk": "5.6.2",
+    "commander": "14.0.3",
+    "grammy": "1.41.1",
+    "inquirer": "12.11.1",
+    "js-yaml": "4.1.1",
+    "ora": "9.3.0",
+    "p-limit": "7.3.0",
+    "semver": "7.7.2",
+    "zod": "4.3.6"
+  },
+  "overrides": {
+    "minimatch": "^10.2.4",
+    "ip-address": "^10.1.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stryker-mutator/core": "^9.6.0",
+    "@stryker-mutator/jest-runner": "^9.6.0",
+    "@stryker-mutator/typescript-checker": "^9.6.0",
+    "@types/inquirer": "^9.0.7",
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.12.0",
+    "@types/semver": "7.7.0",
+    "esbuild": "^0.28.0",
+    "eslint": "^10.0.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-no-secrets": "^2.3.3",
+    "eslint-plugin-security": "^4.0.0",
+    "fast-check": "^4.7.0",
+    "ignore": "^7.0.5",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  }
+}

package/dist/commands/interactive.d.ts

@@ -1,11 +0,0 @@
-import inquirer from "inquirer";
-type SeparatorInstance = InstanceType<typeof inquirer.Separator>;
-type Choice = {
-    name: string;
-    value: string;
-    description?: string;
-} | SeparatorInstance;
-export declare function buildSearchSource(term: string | undefined): Choice[];
-export declare function interactiveMenu(): Promise<string[] | null>;
-export {};
-//# sourceMappingURL=interactive.d.ts.map

package/dist/commands/interactive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/commands/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAyIhC,KAAK,iBAAiB,GAAG,YAAY,CAAC,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjE,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAAC;AAkBxF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAsBpE;AAu3BD,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAqChE"}