@better-openclaw/core 1.0.23 → 1.0.24

package/src/skills/manifest.json

@@ -1445,6 +1445,70 @@
       "services": [
         "headscale"
       ]
+    },
+    {
+      "id": "langfuse-trace",
+      "path": "langfuse-trace/SKILL.md",
+      "emoji": "📊",
+      "services": [
+        "langfuse"
+      ]
+    },
+    {
+      "id": "twenty-crm",
+      "path": "twenty-crm/SKILL.md",
+      "emoji": "📇",
+      "services": [
+        "twenty"
+      ]
+    },
+    {
+      "id": "mautic-campaign",
+      "path": "mautic-campaign/SKILL.md",
+      "emoji": "📬",
+      "services": [
+        "mautic"
+      ]
+    },
+    {
+      "id": "airflow-dag",
+      "path": "airflow-dag/SKILL.md",
+      "emoji": "🌪️",
+      "services": [
+        "airflow"
+      ]
+    },
+    {
+      "id": "airbyte-sync",
+      "path": "airbyte-sync/SKILL.md",
+      "emoji": "🔗",
+      "services": [
+        "airbyte"
+      ]
+    },
+    {
+      "id": "fonoster-voice",
+      "path": "fonoster-voice/SKILL.md",
+      "emoji": "📞",
+      "services": [
+        "fonoster"
+      ]
+    },
+    {
+      "id": "medusa-commerce",
+      "path": "medusa-commerce/SKILL.md",
+      "emoji": "🛒",
+      "services": [
+        "medusa"
+      ]
+    },
+    {
+      "id": "axolotl-finetune",
+      "path": "axolotl-finetune/SKILL.md",
+      "emoji": "🦎",
+      "services": [
+        "axolotl"
+      ]
     }
   ]
 }

package/src/skills/registry.ts

@@ -473,7 +473,7 @@ const skillPacks: SkillPack[] = [
 		description:
 			"AI-powered helpdesk with live chat, LLM observability, and ticket management across channels",
 		requiredServices: ["chatwoot", "langfuse", "postgresql", "redis"],
-		skills: ["chatwoot-inbox", "langfuse-trace", "postgresql-query", "redis-cache"],
+		skills: ["chatwoot-support", "langfuse-trace", "postgresql-query", "redis-cache"],
 		icon: "💬",
 		tags: ["support", "chat", "helpdesk", "tickets", "customer-service"],
 	},
@@ -483,7 +483,7 @@ const skillPacks: SkillPack[] = [
 		description:
 			"CRM-driven sales pipeline with email marketing, newsletter management, and lead nurturing",
 		requiredServices: ["twenty", "mautic", "listmonk", "postgresql"],
-		skills: ["twenty-crm", "mautic-campaign", "listmonk-newsletter", "postgresql-query"],
+		skills: ["twenty-crm", "mautic-campaign", "listmonk-email", "postgresql-query"],
 		icon: "📈",
 		tags: ["sales", "crm", "email", "leads", "marketing"],
 	},
@@ -543,7 +543,7 @@ const skillPacks: SkillPack[] = [
 		description:
 			"Full marketing stack with blogging, email automation, newsletter management, and web analytics",
 		requiredServices: ["ghost", "mautic", "listmonk", "umami"],
-		skills: ["ghost-publish", "mautic-campaign", "listmonk-newsletter", "umami-analytics"],
+		skills: ["ghost-publish", "mautic-campaign", "listmonk-email", "umami-analytics"],
 		icon: "📣",
 		tags: ["marketing", "blog", "email", "analytics", "content"],
 	},

package/src/track-analytics.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, it } from "vitest";
+import { buildAnalyticsPayload } from "./track-analytics.js";
+import type { GenerationInput, GenerationMetadata } from "./types.js";
+
+const baseInput: GenerationInput = {
+	projectName: "test-stack",
+	services: ["postgresql", "redis", "n8n"],
+	skillPacks: ["research-agent"],
+	aiProviders: ["openai"],
+	gsdRuntimes: [],
+	proxy: "caddy",
+	domain: "example.com",
+	gpu: false,
+	platform: "linux/amd64",
+	deployment: "local",
+	deploymentType: "docker",
+	generateSecrets: true,
+	openclawVersion: "latest",
+	monitoring: true,
+	openclawImage: "official",
+	openclawInstallMethod: "docker",
+	hardened: true,
+	deployTarget: "local",
+};
+
+const baseMetadata: GenerationMetadata = {
+	serviceCount: 5,
+	skillCount: 1,
+	estimatedMemoryMB: 2048,
+	resolvedServices: ["postgresql", "redis", "n8n", "caddy", "searxng"],
+	generatedAt: "2026-03-09T00:00:00.000Z",
+};
+
+describe("buildAnalyticsPayload", () => {
+	it("builds payload for a preset-based CLI generation", () => {
+		const payload = buildAnalyticsPayload(baseInput, baseMetadata, "cli", "researcher");
+
+		expect(payload.source).toBe("cli");
+		expect(payload.buildMethod).toBe("preset");
+		expect(payload.presetId).toBe("researcher");
+		expect(payload.services).toEqual(["postgresql", "redis", "n8n"]);
+		expect(payload.skillPacks).toEqual(["research-agent"]);
+		expect(payload.serviceCount).toBe(5);
+		expect(payload.proxy).toBe("caddy");
+		expect(payload.deployment).toBe("local");
+		expect(payload.deploymentType).toBe("docker");
+		expect(payload.platform).toBe("linux/amd64");
+		expect(payload.gpu).toBe(false);
+		expect(payload.monitoring).toBe(true);
+		expect(payload.hasDomain).toBe(true);
+		expect(payload.openclawImage).toBe("official");
+		expect(payload.estimatedMemoryMB).toBe(2048);
+	});
+
+	it("sets buildMethod to custom when no presetId", () => {
+		const payload = buildAnalyticsPayload(baseInput, baseMetadata, "web");
+
+		expect(payload.buildMethod).toBe("custom");
+		expect(payload.presetId).toBeNull();
+	});
+
+	it("sets buildMethod to custom when presetId is null", () => {
+		const payload = buildAnalyticsPayload(baseInput, baseMetadata, "api", null);
+
+		expect(payload.buildMethod).toBe("custom");
+		expect(payload.presetId).toBeNull();
+	});
+
+	it("sets hasDomain to false when no domain in input", () => {
+		const noDomainInput = { ...baseInput, domain: undefined };
+		const payload = buildAnalyticsPayload(noDomainInput, baseMetadata, "mcp");
+
+		expect(payload.hasDomain).toBe(false);
+	});
+
+	it("preserves all source types", () => {
+		for (const source of ["cli", "web", "api", "mcp"] as const) {
+			const payload = buildAnalyticsPayload(baseInput, baseMetadata, source);
+			expect(payload.source).toBe(source);
+		}
+	});
+});

package/src/track-analytics.ts

@@ -0,0 +1,76 @@
+import type { GenerationInput, GenerationMetadata } from "./types.js";
+
+export interface AnalyticsPayload {
+	source: "cli" | "web" | "api" | "mcp";
+	buildMethod: "preset" | "custom";
+	presetId: string | null;
+	services: string[];
+	skillPacks: string[];
+	serviceCount: number;
+	proxy: string;
+	deployment: string;
+	deploymentType: string;
+	platform: string;
+	gpu: boolean;
+	monitoring: boolean;
+	hasDomain: boolean;
+	openclawImage: string;
+	estimatedMemoryMB: number;
+}
+
+/**
+ * Build an analytics payload from generation input and metadata.
+ * Pure function — does not send anything.
+ */
+export function buildAnalyticsPayload(
+	input: GenerationInput,
+	metadata: GenerationMetadata,
+	source: AnalyticsPayload["source"],
+	presetId?: string | null,
+): AnalyticsPayload {
+	return {
+		source,
+		buildMethod: presetId ? "preset" : "custom",
+		presetId: presetId ?? null,
+		services: input.services,
+		skillPacks: input.skillPacks,
+		serviceCount: metadata.serviceCount,
+		proxy: input.proxy,
+		deployment: input.deployment,
+		deploymentType: input.deploymentType,
+		platform: input.platform,
+		gpu: input.gpu,
+		monitoring: input.monitoring,
+		hasDomain: Boolean(input.domain),
+		openclawImage: input.openclawImage,
+		estimatedMemoryMB: metadata.estimatedMemoryMB,
+	};
+}
+
+const DEFAULT_API_URL = "https://better-openclaw.dev/api/v1/analytics/event";
+
+/**
+ * Fire-and-forget POST to the analytics endpoint.
+ * Respects DISABLE_ANALYTICS=true env var.
+ * Silently catches all errors — tracking must never crash the main flow.
+ */
+export async function trackAnalytics(
+	payload: AnalyticsPayload,
+	apiUrl: string = DEFAULT_API_URL,
+): Promise<void> {
+	if (process.env.DISABLE_ANALYTICS === "true") return;
+
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 5000);
+		await fetch(apiUrl, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(payload),
+			signal: controller.signal,
+		});
+		clearTimeout(timeout);
+	} catch {
+		// Silent — tracking must never block or crash generation
+	}
+}

package/src/types.ts

@@ -3,6 +3,7 @@ import type {
 	AddedDependencySchema,
 	AiProviderSchema,
 	ApiErrorSchema,
+	BuildContextSchema,
 	ComposeOptionsSchema,
 	DeploymentTargetSchema,
 	DeploymentTypeSchema,
@@ -11,6 +12,7 @@ import type {
 	EnvVariableSchema,
 	ErrorSchema,
 	GenerationInputSchema,
+	GitSourceSchema,
 	GsdRuntimeSchema,
 	HealthCheckSchema,
 	MaturitySchema,
@@ -50,6 +52,8 @@ export type DeploymentTarget = z.infer<typeof DeploymentTargetSchema>;
 export type DeploymentType = z.infer<typeof DeploymentTypeSchema>;
 export type NativePlatform = z.infer<typeof NativePlatformSchema>;
 export type NativeRecipe = z.infer<typeof NativeRecipeSchema>;
+export type GitSource = z.infer<typeof GitSourceSchema>;
+export type BuildContext = z.infer<typeof BuildContextSchema>;
 export type OutputFormat = z.infer<typeof OutputFormatSchema>;
 export type OpenclawImageVariant = z.infer<typeof OpenclawImageVariantSchema>;
 export type OpenclawInstallMethod = z.infer<typeof OpenclawInstallMethodSchema>;
@@ -369,4 +373,11 @@ export const SERVICE_CATEGORIES: CategoryInfo[] = [
 		label: "IoT & Edge",
 		icon: "📡",
 	},
+	{
+		id: "saas-boilerplate",
+		name: "SaaS Boilerplates",
+		description: "Full-stack SaaS starter kits and boilerplates",
+		label: "SaaS Boilerplates",
+		icon: "🚀",
+	},
 ];

package/src/version-manager.test.ts

@@ -48,9 +48,11 @@ describe("pinImageTags", () => {
 		expect(pinned.services).toHaveLength(resolved.services.length);
 
 		for (const svc of pinned.services) {
+			// Git-based services (e.g., mission-control) don't have imageTag
+			if (svc.definition.gitSource) continue;
 			expect(svc.definition.imageTag).toBeDefined();
 			expect(typeof svc.definition.imageTag).toBe("string");
-			expect(svc.definition.imageTag.length).toBeGreaterThan(0);
+			expect(svc.definition.imageTag!.length).toBeGreaterThan(0);
 		}
 	});
 
@@ -63,10 +65,12 @@ describe("pinImageTags", () => {
 			platform: "linux/amd64",
 		});
 
-		const originalTag = resolved.services[0]?.definition.imageTag;
+		const redis = resolved.services.find((s) => s.definition.id === "redis");
+		const originalTag = redis?.definition.imageTag;
 		pinImageTags(resolved);
 
-		expect(resolved.services[0]?.definition.imageTag).toBe(originalTag);
+		const redisAfter = resolved.services.find((s) => s.definition.id === "redis");
+		expect(redisAfter?.definition.imageTag).toBe(originalTag);
 	});
 
 	it("preserves non-tag properties", () => {
@@ -79,8 +83,9 @@ describe("pinImageTags", () => {
 		});
 
 		const pinned = pinImageTags(resolved);
-		expect(pinned.services[0]?.definition.id).toBe("redis");
-		expect(pinned.services[0]?.definition.name).toBe("Redis");
+		const redis = pinned.services.find((s) => s.definition.id === "redis");
+		expect(redis).toBeDefined();
+		expect(redis!.definition.name).toBe("Redis");
 		expect(pinned.estimatedMemoryMB).toBe(resolved.estimatedMemoryMB);
 	});
 });

package/src/version-manager.ts

@@ -10,7 +10,7 @@ export function getImageTag(serviceId: string): string | undefined {
 /** Get the full image reference (image:tag) for a service */
 export function getImageReference(serviceId: string): string | undefined {
 	const svc = getServiceById(serviceId);
-	if (!svc) return undefined;
+	if (!svc || !svc.image || !svc.imageTag) return undefined;
 	return `${svc.image}:${svc.imageTag}`;
 }
 

package/dist/schema-B4c64P8N.d.cts.map

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

package/dist/schema-CXNhYci1.d.mts.map

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