kastell 2.2.0 → 2.2.1

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

@@ -0,0 +1,50 @@
+import type { AuditCheck, CheckParser } from "../../types.js";
+
+interface __NAME_PASCAL__CheckDef {
+  id: string;
+  name: string;
+  severity: "critical" | "warning" | "info";
+  check: (output: string) => { passed: boolean; currentValue: string };
+  expectedValue: string;
+  fixCommand: string;
+  explain: string;
+}
+
+const __NAME_UPPER___CHECKS: __NAME_PASCAL__CheckDef[] = [
+  {
+    id: "__NAME_UPPER__-01",
+    name: "TODO: check description",
+    severity: "warning",
+    check: (output) => {
+      const match = output.includes("TODO_SENTINEL");
+      return { passed: match, currentValue: match ? "configured" : "not found" };
+    },
+    expectedValue: "configured",
+    fixCommand: "TODO: fix command",
+    explain: "TODO: why this matters",
+  },
+];
+
+export const parse__NAME_PASCAL__Checks: CheckParser = (
+  sectionOutput: string,
+  _platform: string,
+): AuditCheck[] => {
+  if (!sectionOutput || sectionOutput.includes("SKIP_MARKER")) {
+    return [];
+  }
+
+  return __NAME_UPPER___CHECKS.map((def) => {
+    const { passed, currentValue } = def.check(sectionOutput);
+    return {
+      id: def.id,
+      category: "__NAME_PASCAL__",
+      name: def.name,
+      severity: def.severity,
+      passed,
+      currentValue,
+      expectedValue: def.expectedValue,
+      fixCommand: def.fixCommand,
+      explain: def.explain,
+    };
+  });
+};

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

@@ -0,0 +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");
+}

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

@@ -0,0 +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);
+  });
+});

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

@@ -0,0 +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;
+    }
+  });

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

@@ -0,0 +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
+  });
+});

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

@@ -0,0 +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),
+      },
+    ],
+  };
+}

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

@@ -0,0 +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();
+  });
+});

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

@@ -0,0 +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}`);
+  }
+}

package/package.json

@@ -1,115 +1,122 @@
-{
-  "name": "kastell",
-  "version": "2.2.0",
-  "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/",
-    "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.1",
+  "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"
+  }
+}