@better-openclaw/core 1.0.10 → 1.0.12

package/src/generators/scripts.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+import { generateScripts } from "./scripts.js";
+
+describe("generateScripts", () => {
+	it("generates all 5 expected scripts", () => {
+		const result = generateScripts();
+
+		const expectedScripts = [
+			"scripts/start.sh",
+			"scripts/stop.sh",
+			"scripts/update.sh",
+			"scripts/backup.sh",
+			"scripts/status.sh",
+		];
+
+		for (const script of expectedScripts) {
+			expect(result).toHaveProperty(script);
+			expect(result[script]!.length).toBeGreaterThan(0);
+		}
+	});
+
+	it("start.sh calls docker compose up", () => {
+		const result = generateScripts();
+		expect(result["scripts/start.sh"]).toContain("docker compose");
+		expect(result["scripts/start.sh"]).toContain("up");
+	});
+
+	it("stop.sh calls docker compose down", () => {
+		const result = generateScripts();
+		expect(result["scripts/stop.sh"]).toContain("docker compose");
+		expect(result["scripts/stop.sh"]).toContain("down");
+	});
+
+	it("update.sh calls docker compose pull", () => {
+		const result = generateScripts();
+		expect(result["scripts/update.sh"]).toContain("docker compose");
+		expect(result["scripts/update.sh"]).toContain("pull");
+	});
+
+	it("backup.sh references volumes or backup", () => {
+		const result = generateScripts();
+		const backup = result["scripts/backup.sh"]!;
+		expect(backup).toBeDefined();
+		expect(backup.length).toBeGreaterThan(50);
+	});
+
+	it("status.sh calls docker compose ps", () => {
+		const result = generateScripts();
+		expect(result["scripts/status.sh"]).toContain("docker compose");
+		expect(result["scripts/status.sh"]).toContain("ps");
+	});
+
+	it("all scripts start with bash shebang", () => {
+		const result = generateScripts();
+
+		for (const [, content] of Object.entries(result)) {
+			expect(content.startsWith("#!/")).toBe(true);
+		}
+	});
+});

package/src/generators/traefik.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from "vitest";
-import { generateTraefikConfig } from "./traefik.js";
-import type { ResolverOutput } from "../types.js";
 import { resolve } from "../resolver.js";
+import type { ResolverOutput } from "../types.js";
+import { generateTraefikConfig } from "./traefik.js";
 
 function resolveWith(services: string[]): ResolverOutput {
 	return resolve({ services, skillPacks: [], proxy: "traefik", gpu: false });
@@ -28,9 +28,7 @@ describe("generateTraefikConfig", () => {
 		const redisLabels = serviceLabels.get("redis");
 		expect(redisLabels).toBeDefined();
 		expect(redisLabels!["traefik.enable"]).toBe("true");
-		expect(redisLabels!["traefik.http.routers.redis.rule"]).toBe(
-			"Host(`redis.example.com`)",
-		);
+		expect(redisLabels!["traefik.http.routers.redis.rule"]).toBe("Host(`redis.example.com`)");
 		expect(redisLabels!["traefik.http.routers.redis.entrypoints"]).toBe("websecure");
 		expect(redisLabels!["traefik.http.routers.redis.tls.certresolver"]).toBe("letsencrypt");
 		expect(redisLabels!["traefik.http.services.redis.loadbalancer.server.port"]).toBe("6379");
@@ -42,9 +40,7 @@ describe("generateTraefikConfig", () => {
 
 		const redisLabels = serviceLabels.get("redis")!;
 		expect(redisLabels["traefik.http.routers.redis-http.entrypoints"]).toBe("web");
-		expect(redisLabels["traefik.http.routers.redis-http.middlewares"]).toBe(
-			"redirect-to-https",
-		);
+		expect(redisLabels["traefik.http.routers.redis-http.middlewares"]).toBe("redirect-to-https");
 	});
 
 	it("assigns root domain to gateway", () => {
@@ -53,9 +49,7 @@ describe("generateTraefikConfig", () => {
 
 		const gwLabels = serviceLabels.get("openclaw-gateway");
 		expect(gwLabels).toBeDefined();
-		expect(gwLabels!["traefik.http.routers.gateway.rule"]).toBe(
-			"Host(`example.com`)",
-		);
+		expect(gwLabels!["traefik.http.routers.gateway.rule"]).toBe("Host(`example.com`)");
 		expect(gwLabels!["traefik.http.services.gateway.loadbalancer.server.port"]).toBe("18789");
 	});
 
@@ -65,9 +59,9 @@ describe("generateTraefikConfig", () => {
 
 		const traefikLabels = serviceLabels.get("traefik");
 		expect(traefikLabels).toBeDefined();
-		expect(
-			traefikLabels!["traefik.http.middlewares.redirect-to-https.redirectscheme.scheme"],
-		).toBe("https");
+		expect(traefikLabels!["traefik.http.middlewares.redirect-to-https.redirectscheme.scheme"]).toBe(
+			"https",
+		);
 		expect(
 			traefikLabels!["traefik.http.middlewares.redirect-to-https.redirectscheme.permanent"],
 		).toBe("true");
@@ -90,8 +84,6 @@ describe("generateTraefikConfig", () => {
 		const labels = serviceLabels.get("open-webui");
 		expect(labels).toBeDefined();
 		// Router name has hyphens removed
-		expect(labels!["traefik.http.routers.openwebui.rule"]).toBe(
-			"Host(`open-webui.example.com`)",
-		);
+		expect(labels!["traefik.http.routers.openwebui.rule"]).toBe("Host(`open-webui.example.com`)");
 	});
 });

package/src/index.ts

@@ -8,17 +8,22 @@ export {
 } from "./bare-metal-partition.js";
 export type { ComposeResult } from "./composer.js";
 export { compose, composeMultiFile } from "./composer.js";
+// ─── Errors ─────────────────────────────────────────────────────────────────
+export { StackConfigError, ValidationError } from "./errors.js";
 export { generate, generateServicesDoc } from "./generate.js";
 export { generateCaddyfile } from "./generators/caddy.js";
 export type { EnvVarGroup } from "./generators/env.js";
 export { generateEnvFiles, getStructuredEnvVars } from "./generators/env.js";
 export { generateGrafanaConfig, generateGrafanaDashboard } from "./generators/grafana.js";
+export { generateHealthCheck } from "./generators/health-check.js";
 export { generateN8nWorkflows } from "./generators/n8n-workflows.js";
 export { generatePostgresInit, getDbRequirements } from "./generators/postgres-init.js";
 export { generatePrometheusConfig } from "./generators/prometheus.js";
 export { generateReadme } from "./generators/readme.js";
 export { generateScripts } from "./generators/scripts.js";
 export { generateSkillFiles } from "./generators/skills.js";
+// ─── Config Migrations ──────────────────────────────────────────────────────
+export { CURRENT_CONFIG_VERSION, migrateConfig, needsMigration } from "./migrations.js";
 // ─── Presets ────────────────────────────────────────────────────────────────
 export { getAllPresets, getPresetById, presetRegistry } from "./presets/registry.js";
 export { resolve } from "./resolver.js";
@@ -68,6 +73,13 @@ export {
 	getSkillPackById,
 	skillPackRegistry,
 } from "./skills/registry.js";
+// ─── Skill Manifest ─────────────────────────────────────────────────────────
+export type { SkillManifestEntry } from "./skills/skill-manifest.js";
+export {
+	getAllManifestSkills,
+	getManifestSkillById,
+	getManifestSkillCount,
+} from "./skills/skill-manifest.js";
 // ─── Types ──────────────────────────────────────────────────────────────────
 export type {
 	AddedDependency,
@@ -109,12 +121,6 @@ export type {
 export { SERVICE_CATEGORIES } from "./types.js";
 export { validate } from "./validator.js";
 
-// ─── Config Migrations ──────────────────────────────────────────────────────
-export { migrateConfig, needsMigration, CURRENT_CONFIG_VERSION } from "./migrations.js";
-
-// ─── Errors ─────────────────────────────────────────────────────────────────
-export { StackConfigError, ValidationError } from "./errors.js";
-
 // ─── Version Manager ────────────────────────────────────────────────────────
 export {
 	checkCompatibility,

package/src/migrations.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { migrateConfig, needsMigration, CURRENT_CONFIG_VERSION } from "./migrations.js";
+import { CURRENT_CONFIG_VERSION, migrateConfig, needsMigration } from "./migrations.js";
 
 describe("config migrations", () => {
 	it("migrates v1 config to current version", () => {

package/src/migrations.ts

@@ -1,5 +1,3 @@
-import type { GenerationInput } from "./types.js";
-
 export const CURRENT_CONFIG_VERSION = 2;
 
 type MigrationFn = (input: Record<string, unknown>) => Record<string, unknown>;
@@ -21,9 +19,7 @@ export function migrateConfig(input: Record<string, unknown>): Record<string, un
 	let version = (input.configVersion as number) ?? 1;
 
 	if (version > CURRENT_CONFIG_VERSION) {
-		throw new Error(
-			`No migration path from config version ${version}`,
-		);
+		throw new Error(`No migration path from config version ${version}`);
 	}
 
 	let current = { ...input };

package/src/services/definitions/convex.ts

@@ -64,8 +64,7 @@ export const convexDefinition: ServiceDefinition = {
 			key: "DATABASE_URL",
 			defaultValue: "",
 			secret: true,
-			description:
-				"Optional Postgres connection string for production (leave empty to use SQLite)",
+			description: "Optional Postgres connection string for production (leave empty to use SQLite)",
 			required: false,
 		},
 		{
@@ -106,8 +105,7 @@ export const convexDefinition: ServiceDefinition = {
 	openclawEnvVars: [],
 
 	docsUrl: "https://github.com/get-convex/convex-backend",
-	selfHostedDocsUrl:
-		"https://github.com/get-convex/convex-backend/blob/main/self-hosted/README.md",
+	selfHostedDocsUrl: "https://github.com/get-convex/convex-backend/blob/main/self-hosted/README.md",
 	tags: ["convex", "database", "reactive", "real-time", "backend", "self-hosted"],
 	maturity: "stable",
 

package/src/services/definitions/desktop-environment.ts

@@ -124,15 +124,7 @@ export const desktopEnvironmentDefinition: ServiceDefinition = {
 	],
 
 	docsUrl: "https://www.kasmweb.com/docs/latest/index.html",
-	tags: [
-		"computer-use",
-		"vnc",
-		"desktop",
-		"screen-capture",
-		"automation",
-		"obs",
-		"kasm",
-	],
+	tags: ["computer-use", "vnc", "desktop", "screen-capture", "automation", "obs", "kasm"],
 	maturity: "experimental",
 
 	requires: [],

package/src/services/definitions/index.ts

@@ -7,10 +7,10 @@ export { calComDefinition } from "./cal-com.js";
 export { chromadbDefinition } from "./chromadb.js";
 export { claudeCodeDefinition } from "./claude-code.js";
 export { codeServerDefinition } from "./code-server.js";
+export { codexDefinition } from "./codex.js";
 export { comfyuiDefinition } from "./comfyui.js";
 export { convexDefinition } from "./convex.js";
 export { convexDashboardDefinition } from "./convex-dashboard.js";
-export { codexDefinition } from "./codex.js";
 export { coolifyDefinition } from "./coolify.js";
 export { desktopEnvironmentDefinition } from "./desktop-environment.js";
 export { difyDefinition } from "./dify.js";
@@ -35,8 +35,8 @@ export { matomoDefinition } from "./matomo.js";
 export { matrixSynapseDefinition } from "./matrix-synapse.js";
 export { mattermostDefinition } from "./mattermost.js";
 export { meilisearchDefinition } from "./meilisearch.js";
-export { missionControlDefinition } from "./mission-control.js";
 export { minioDefinition } from "./minio.js";
+export { missionControlDefinition } from "./mission-control.js";
 export { mixpostDefinition } from "./mixpost.js";
 export { motionCanvasDefinition } from "./motion-canvas.js";
 export { n8nDefinition } from "./n8n.js";
@@ -66,8 +66,8 @@ export { tailscaleDefinition } from "./tailscale.js";
 export { temporalDefinition } from "./temporal.js";
 export { traefikDefinition } from "./traefik.js";
 export { umamiDefinition } from "./umami.js";
-export { usesendDefinition } from "./usesend.js";
 export { uptimeKumaDefinition } from "./uptime-kuma.js";
+export { usesendDefinition } from "./usesend.js";
 export { valkeyDefinition } from "./valkey.js";
 export { watchtowerDefinition } from "./watchtower.js";
 export { weaviateDefinition } from "./weaviate.js";
@@ -84,10 +84,10 @@ import { calComDefinition } from "./cal-com.js";
 import { chromadbDefinition } from "./chromadb.js";
 import { claudeCodeDefinition } from "./claude-code.js";
 import { codeServerDefinition } from "./code-server.js";
+import { codexDefinition } from "./codex.js";
 import { comfyuiDefinition } from "./comfyui.js";
 import { convexDefinition } from "./convex.js";
 import { convexDashboardDefinition } from "./convex-dashboard.js";
-import { codexDefinition } from "./codex.js";
 import { coolifyDefinition } from "./coolify.js";
 import { desktopEnvironmentDefinition } from "./desktop-environment.js";
 import { difyDefinition } from "./dify.js";
@@ -112,8 +112,8 @@ import { matomoDefinition } from "./matomo.js";
 import { matrixSynapseDefinition } from "./matrix-synapse.js";
 import { mattermostDefinition } from "./mattermost.js";
 import { meilisearchDefinition } from "./meilisearch.js";
-import { missionControlDefinition } from "./mission-control.js";
 import { minioDefinition } from "./minio.js";
+import { missionControlDefinition } from "./mission-control.js";
 import { mixpostDefinition } from "./mixpost.js";
 import { motionCanvasDefinition } from "./motion-canvas.js";
 import { n8nDefinition } from "./n8n.js";
@@ -143,8 +143,8 @@ import { tailscaleDefinition } from "./tailscale.js";
 import { temporalDefinition } from "./temporal.js";
 import { traefikDefinition } from "./traefik.js";
 import { umamiDefinition } from "./umami.js";
-import { usesendDefinition } from "./usesend.js";
 import { uptimeKumaDefinition } from "./uptime-kuma.js";
+import { usesendDefinition } from "./usesend.js";
 import { valkeyDefinition } from "./valkey.js";
 import { watchtowerDefinition } from "./watchtower.js";
 import { weaviateDefinition } from "./weaviate.js";

package/src/services/definitions/mission-control.ts

@@ -32,8 +32,7 @@ export const missionControlDefinition: ServiceDefinition = {
 			key: "CONVEX_SELF_HOSTED_URL",
 			defaultValue: "http://convex:3210",
 			secret: false,
-			description:
-				"Internal Docker URL for pushing Convex functions during build",
+			description: "Internal Docker URL for pushing Convex functions during build",
 			required: true,
 		},
 		{
@@ -52,8 +51,7 @@ export const missionControlDefinition: ServiceDefinition = {
 	skills: [],
 	openclawEnvVars: [],
 
-	docsUrl:
-		"https://github.com/bidewio/better-openclaw/tree/main/packages/mission-control",
+	docsUrl: "https://github.com/bidewio/better-openclaw/tree/main/packages/mission-control",
 	selfHostedDocsUrl:
 		"https://github.com/bidewio/better-openclaw/tree/main/packages/mission-control",
 	tags: ["openclaw", "dashboard", "monitoring", "agents", "analytics", "convex"],

package/src/services/definitions/stream-gateway.ts

@@ -50,8 +50,7 @@ export const streamGatewayDefinition: ServiceDefinition = {
 			key: "TIKTOK_STREAM_URL",
 			defaultValue: "",
 			secret: true,
-			description:
-				"Full TikTok RTMP URL from TikTok Studio (leave empty to skip TikTok relay)",
+			description: "Full TikTok RTMP URL from TikTok Studio (leave empty to skip TikTok relay)",
 			required: false,
 		},
 		{