@better-openclaw/core 1.0.16 → 1.0.18

package/dist/deployers/index.mjs

@@ -0,0 +1,21 @@
+import { CoolifyDeployer } from "./coolify.mjs";
+import { DokployDeployer } from "./dokploy.mjs";
+
+//#region src/deployers/index.ts
+/** Registry of all available PaaS deployers. */
+const deployerRegistry = {
+	dokploy: new DokployDeployer(),
+	coolify: new CoolifyDeployer()
+};
+/** Get a deployer by ID, or undefined if not found. */
+function getDeployer(id) {
+	return deployerRegistry[id];
+}
+/** List all available deployer IDs. */
+function getAvailableDeployers() {
+	return Object.keys(deployerRegistry);
+}
+
+//#endregion
+export { CoolifyDeployer, DokployDeployer, deployerRegistry, getAvailableDeployers, getDeployer };
+//# sourceMappingURL=index.mjs.map

package/dist/deployers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/deployers/index.ts"],"sourcesContent":["/**\n * PaaS deployer registry — barrel export + lookup helpers.\n *\n * To add a new provider, implement `PaasDeployer` and register it in\n * `deployerRegistry` below.\n */\n\nexport { CoolifyDeployer } from \"./coolify.js\";\nexport { DokployDeployer } from \"./dokploy.js\";\nexport type {\n\tDeployInput,\n\tDeployResult,\n\tDeployStep,\n\tDeployTarget,\n\tPaasDeployer,\n} from \"./types.js\";\n\nimport { CoolifyDeployer } from \"./coolify.js\";\nimport { DokployDeployer } from \"./dokploy.js\";\nimport type { PaasDeployer } from \"./types.js\";\n\n/** Registry of all available PaaS deployers. */\nexport const deployerRegistry: Record<string, PaasDeployer> = {\n\tdokploy: new DokployDeployer(),\n\tcoolify: new CoolifyDeployer(),\n};\n\n/** Get a deployer by ID, or undefined if not found. */\nexport function getDeployer(id: string): PaasDeployer | undefined {\n\treturn deployerRegistry[id];\n}\n\n/** List all available deployer IDs. */\nexport function getAvailableDeployers(): string[] {\n\treturn Object.keys(deployerRegistry);\n}\n"],"mappings":";;;;;AAsBA,MAAa,mBAAiD;CAC7D,SAAS,IAAI,iBAAiB;CAC9B,SAAS,IAAI,iBAAiB;CAC9B;;AAGD,SAAgB,YAAY,IAAsC;AACjE,QAAO,iBAAiB;;;AAIzB,SAAgB,wBAAkC;AACjD,QAAO,OAAO,KAAK,iBAAiB"}

package/dist/deployers/types.d.cts

@@ -0,0 +1,72 @@
+//#region src/deployers/types.d.ts
+/**
+ * Common types for PaaS deployers (Dokploy, Coolify, etc.)
+ *
+ * This module defines the contract that all PaaS deployment providers must
+ * implement. The deployer system is designed to be extensible — adding a new
+ * provider only requires implementing the `PaasDeployer` interface and
+ * registering it in `deployers/index.ts`.
+ *
+ * Architecture:
+ *   Web UI / CLI  -->  API relay (/v1/deploy)  -->  PaaS instance (Dokploy/Coolify)
+ *
+ * The API server acts as a relay to avoid CORS issues when deploying from the
+ * browser. The CLI calls the deployer directly (no relay needed).
+ */
+/** Credentials and connection info for a PaaS target. */
+interface DeployTarget {
+  /** Base URL of the PaaS instance (e.g. "https://dokploy.example.com") */
+  instanceUrl: string;
+  /** API key / bearer token */
+  apiKey: string;
+}
+/** Input for a deploy operation. */
+interface DeployInput {
+  /** Target PaaS connection */
+  target: DeployTarget;
+  /** Project name to create or use */
+  projectName: string;
+  /** Raw docker-compose.yml content */
+  composeYaml: string;
+  /** Raw .env file content (key=value lines) */
+  envContent: string;
+  /** Optional description */
+  description?: string;
+}
+/** Step-level status for deploy progress. */
+interface DeployStep {
+  step: string;
+  status: "pending" | "running" | "done" | "error";
+  detail?: string;
+}
+/** Result of a deploy operation. */
+interface DeployResult {
+  success: boolean;
+  /** URL to the deployed project/compose in the PaaS dashboard */
+  dashboardUrl?: string;
+  /** PaaS-assigned project ID */
+  projectId?: string;
+  /** PaaS-assigned compose/service ID */
+  composeId?: string;
+  /** Step-by-step progress */
+  steps: DeployStep[];
+  /** Error message if failed */
+  error?: string;
+}
+/** Interface that all PaaS deployers implement. */
+interface PaasDeployer {
+  /** Human-readable name */
+  readonly name: string;
+  /** Identifier (e.g. "dokploy", "coolify") */
+  readonly id: string;
+  /** Test connection to the PaaS instance */
+  testConnection(target: DeployTarget): Promise<{
+    ok: boolean;
+    error?: string;
+  }>;
+  /** Deploy a compose stack */
+  deploy(input: DeployInput): Promise<DeployResult>;
+}
+//#endregion
+export { DeployInput, DeployResult, DeployStep, DeployTarget, PaasDeployer };
+//# sourceMappingURL=types.d.cts.map

package/dist/deployers/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/deployers/types.ts"],"mappings":";;AAgBA;;;;;AAQA;;;;;;;;;UARiB,YAAA;EAkBL;EAhBX,WAAA;EAoBgB;EAlBhB,MAAA;AAAA;;UAIgB,WAAA;EAgBhB;EAdA,MAAA,EAAQ,YAAA;EAeF;EAbN,WAAA;EAiBgB;EAfhB,WAAA;;EAEA,UAAA;EAcA;EAZA,WAAA;AAAA;;UAIgB,UAAA;EAChB,IAAA;EACA,MAAA;EACA,MAAA;AAAA;AAmBD;AAAA,UAfiB,YAAA;EAChB,OAAA;EAoBuB;EAlBvB,YAAA;EAoBc;EAlBd,SAAA;EAkB4B;EAhB5B,SAAA;EAgBmC;EAdnC,KAAA,EAAO,UAAA;EAUE;EART,KAAA;AAAA;;UAIgB,YAAA;EAMgC;EAAA,SAJvC,IAAA;EAMT;EAAA,SAJS,EAAA;EAIF;EAFP,cAAA,CAAe,MAAA,EAAQ,YAAA,GAAe,OAAA;IAAU,EAAA;IAAa,KAAA;EAAA;;EAE7D,MAAA,CAAO,KAAA,EAAO,WAAA,GAAc,OAAA,CAAQ,YAAA;AAAA"}

package/dist/deployers/types.d.mts

@@ -0,0 +1,72 @@
+//#region src/deployers/types.d.ts
+/**
+ * Common types for PaaS deployers (Dokploy, Coolify, etc.)
+ *
+ * This module defines the contract that all PaaS deployment providers must
+ * implement. The deployer system is designed to be extensible — adding a new
+ * provider only requires implementing the `PaasDeployer` interface and
+ * registering it in `deployers/index.ts`.
+ *
+ * Architecture:
+ *   Web UI / CLI  -->  API relay (/v1/deploy)  -->  PaaS instance (Dokploy/Coolify)
+ *
+ * The API server acts as a relay to avoid CORS issues when deploying from the
+ * browser. The CLI calls the deployer directly (no relay needed).
+ */
+/** Credentials and connection info for a PaaS target. */
+interface DeployTarget {
+  /** Base URL of the PaaS instance (e.g. "https://dokploy.example.com") */
+  instanceUrl: string;
+  /** API key / bearer token */
+  apiKey: string;
+}
+/** Input for a deploy operation. */
+interface DeployInput {
+  /** Target PaaS connection */
+  target: DeployTarget;
+  /** Project name to create or use */
+  projectName: string;
+  /** Raw docker-compose.yml content */
+  composeYaml: string;
+  /** Raw .env file content (key=value lines) */
+  envContent: string;
+  /** Optional description */
+  description?: string;
+}
+/** Step-level status for deploy progress. */
+interface DeployStep {
+  step: string;
+  status: "pending" | "running" | "done" | "error";
+  detail?: string;
+}
+/** Result of a deploy operation. */
+interface DeployResult {
+  success: boolean;
+  /** URL to the deployed project/compose in the PaaS dashboard */
+  dashboardUrl?: string;
+  /** PaaS-assigned project ID */
+  projectId?: string;
+  /** PaaS-assigned compose/service ID */
+  composeId?: string;
+  /** Step-by-step progress */
+  steps: DeployStep[];
+  /** Error message if failed */
+  error?: string;
+}
+/** Interface that all PaaS deployers implement. */
+interface PaasDeployer {
+  /** Human-readable name */
+  readonly name: string;
+  /** Identifier (e.g. "dokploy", "coolify") */
+  readonly id: string;
+  /** Test connection to the PaaS instance */
+  testConnection(target: DeployTarget): Promise<{
+    ok: boolean;
+    error?: string;
+  }>;
+  /** Deploy a compose stack */
+  deploy(input: DeployInput): Promise<DeployResult>;
+}
+//#endregion
+export { DeployInput, DeployResult, DeployStep, DeployTarget, PaasDeployer };
+//# sourceMappingURL=types.d.mts.map

package/dist/deployers/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/deployers/types.ts"],"mappings":";;AAgBA;;;;;AAQA;;;;;;;;;UARiB,YAAA;EAkBL;EAhBX,WAAA;EAoBgB;EAlBhB,MAAA;AAAA;;UAIgB,WAAA;EAgBhB;EAdA,MAAA,EAAQ,YAAA;EAeF;EAbN,WAAA;EAiBgB;EAfhB,WAAA;;EAEA,UAAA;EAcA;EAZA,WAAA;AAAA;;UAIgB,UAAA;EAChB,IAAA;EACA,MAAA;EACA,MAAA;AAAA;AAmBD;AAAA,UAfiB,YAAA;EAChB,OAAA;EAoBuB;EAlBvB,YAAA;EAoBc;EAlBd,SAAA;EAkB4B;EAhB5B,SAAA;EAgBmC;EAdnC,KAAA,EAAO,UAAA;EAUE;EART,KAAA;AAAA;;UAIgB,YAAA;EAMgC;EAAA,SAJvC,IAAA;EAMT;EAAA,SAJS,EAAA;EAIF;EAFP,cAAA,CAAe,MAAA,EAAQ,YAAA,GAAe,OAAA;IAAU,EAAA;IAAa,KAAA;EAAA;;EAE7D,MAAA,CAAO,KAAA,EAAO,WAAA,GAAc,OAAA,CAAQ,YAAA;AAAA"}

package/dist/deployers/types.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/errors.cjs

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/errors.ts
+/**
+* Typed error classes for stack generation.
+*/
+/** Thrown when the resolved stack configuration is invalid (e.g. conflicts). */
+var StackConfigError = class extends Error {
+	code = "STACK_CONFIG_ERROR";
+	constructor(message) {
+		super(message);
+		this.name = "StackConfigError";
+	}
+};
+/** Thrown when post-generation validation fails. */
+var ValidationError = class extends Error {
+	code = "VALIDATION_ERROR";
+	constructor(message) {
+		super(message);
+		this.name = "ValidationError";
+	}
+};
+
+//#endregion
+exports.StackConfigError = StackConfigError;
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error classes for stack generation.\n */\n\n/** Thrown when the resolved stack configuration is invalid (e.g. conflicts). */\nexport class StackConfigError extends Error {\n\treadonly code = \"STACK_CONFIG_ERROR\" as const;\n\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"StackConfigError\";\n\t}\n}\n\n/** Thrown when post-generation validation fails. */\nexport class ValidationError extends Error {\n\treadonly code = \"VALIDATION_ERROR\" as const;\n\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"ValidationError\";\n\t}\n}\n"],"mappings":";;;;;;;AAKA,IAAa,mBAAb,cAAsC,MAAM;CAC3C,AAAS,OAAO;CAEhB,YAAY,SAAiB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;AAKd,IAAa,kBAAb,cAAqC,MAAM;CAC1C,AAAS,OAAO;CAEhB,YAAY,SAAiB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO"}

package/dist/errors.d.cts

@@ -0,0 +1,17 @@
+//#region src/errors.d.ts
+/**
+ * Typed error classes for stack generation.
+ */
+/** Thrown when the resolved stack configuration is invalid (e.g. conflicts). */
+declare class StackConfigError extends Error {
+  readonly code: "STACK_CONFIG_ERROR";
+  constructor(message: string);
+}
+/** Thrown when post-generation validation fails. */
+declare class ValidationError extends Error {
+  readonly code: "VALIDATION_ERROR";
+  constructor(message: string);
+}
+//#endregion
+export { StackConfigError, ValidationError };
+//# sourceMappingURL=errors.d.cts.map

package/dist/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../src/errors.ts"],"mappings":";;AAKA;;;cAAa,gBAAA,SAAyB,KAAA;EAAA,SAC5B,IAAA;cAEG,OAAA;AAAA;;cAOA,eAAA,SAAwB,KAAA;EAAA,SAC3B,IAAA;cAEG,OAAA;AAAA"}

package/dist/generate.cjs

@@ -0,0 +1,225 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_bare_metal_partition = require('./bare-metal-partition.cjs');
+const require_resolver = require('./resolver.cjs');
+const require_generators_postgres_init = require('./generators/postgres-init.cjs');
+const require_composer = require('./composer.cjs');
+const require_errors = require('./errors.cjs');
+const require_generators_bare_metal_install = require('./generators/bare-metal-install.cjs');
+const require_generators_caddy = require('./generators/caddy.cjs');
+const require_generators_cloud_init = require('./generators/cloud-init.cjs');
+const require_generators_env = require('./generators/env.cjs');
+const require_generators_get_shit_done = require('./generators/get-shit-done.cjs');
+const require_generators_grafana = require('./generators/grafana.cjs');
+const require_generators_health_check = require('./generators/health-check.cjs');
+const require_generators_n8n_workflows = require('./generators/n8n-workflows.cjs');
+const require_generators_native_services = require('./generators/native-services.cjs');
+const require_generators_openclaw_install_script = require('./generators/openclaw-install-script.cjs');
+const require_generators_openclaw_json = require('./generators/openclaw-json.cjs');
+const require_generators_prometheus = require('./generators/prometheus.cjs');
+const require_generators_readme = require('./generators/readme.cjs');
+const require_generators_scripts = require('./generators/scripts.cjs');
+const require_generators_skills = require('./generators/skills.cjs');
+const require_generators_stack_manifest = require('./generators/stack-manifest.cjs');
+const require_generators_traefik = require('./generators/traefik.cjs');
+const require_migrations = require('./migrations.cjs');
+const require_validator = require('./validator.cjs');
+
+//#region src/generate.ts
+/** Resolver/compose only support linux image platforms; normalize for bare-metal (windows/macos). */
+function getComposePlatform(platform) {
+	if (platform === "linux/amd64" || platform === "linux/arm64") return platform;
+	return "linux/amd64";
+}
+/**
+* Main orchestration function: takes generation input, resolves dependencies,
+* generates all files, validates, and returns the complete file tree.
+*/
+function generate(rawInput) {
+	const input = require_migrations.migrateConfig(rawInput);
+	const composePlatform = getComposePlatform(input.platform);
+	const resolved = require_resolver.resolve({
+		services: input.services,
+		skillPacks: input.skillPacks,
+		aiProviders: input.aiProviders,
+		proxy: input.proxy,
+		gpu: input.gpu,
+		platform: composePlatform,
+		monitoring: input.monitoring
+	});
+	if (!resolved.isValid) throw new require_errors.StackConfigError(`Invalid stack configuration: ${resolved.errors.map((e) => e.message).join("; ")}`);
+	const isBareMetal = input.deploymentType === "bare-metal";
+	let resolvedForCompose = resolved;
+	let nativeIds = /* @__PURE__ */ new Set();
+	let nativeServices = [];
+	let dockerOnlyServices = [];
+	if (isBareMetal) {
+		const partition = require_bare_metal_partition.partitionBareMetal(resolved, input.platform);
+		nativeServices = partition.nativeServices;
+		dockerOnlyServices = partition.dockerOnlyServices;
+		nativeIds = partition.nativeIds;
+		if (nativeServices.length > 0) resolvedForCompose = require_bare_metal_partition.resolvedWithOnlyServices(resolved, dockerOnlyServices);
+	}
+	let traefikOutput;
+	if (input.proxy === "traefik" && input.domain) traefikOutput = require_generators_traefik.generateTraefikConfig(resolvedForCompose, input.domain);
+	const composeOptions = {
+		projectName: input.projectName,
+		proxy: input.proxy,
+		proxyHttpPort: input.proxyHttpPort,
+		proxyHttpsPort: input.proxyHttpsPort,
+		portOverrides: input.portOverrides,
+		domain: input.domain,
+		gpu: input.gpu,
+		platform: composePlatform,
+		deployment: input.deployment,
+		openclawVersion: input.openclawVersion,
+		bareMetalNativeHost: isBareMetal && nativeIds.size > 0,
+		traefikLabels: traefikOutput?.serviceLabels,
+		openclawImage: input.openclawImage ?? "official",
+		hardened: input.hardened ?? true,
+		openclawInstallMethod: input.openclawInstallMethod ?? "docker"
+	};
+	const composeResult = require_composer.composeMultiFile(resolvedForCompose, composeOptions);
+	const validation = require_validator.validate(resolvedForCompose, composeResult.files["docker-compose.yml"] ?? "", {
+		domain: input.domain,
+		generateSecrets: input.generateSecrets
+	});
+	if (!validation.valid) throw new require_errors.ValidationError(`Validation failed: ${validation.errors.map((e) => e.message).join("; ")}`);
+	const files = {};
+	for (const [filename, content] of Object.entries(composeResult.files)) files[filename] = content;
+	const envFiles = require_generators_env.generateEnvFiles(resolved, {
+		generateSecrets: input.generateSecrets,
+		domain: input.domain,
+		openclawVersion: input.openclawVersion,
+		nativeServiceIds: isBareMetal ? nativeIds : void 0,
+		composeFiles: Object.keys(composeResult.files),
+		composeProfiles: composeResult.profiles,
+		openclawImage: input.openclawImage
+	});
+	files[".env.example"] = envFiles.envExample;
+	files[".env"] = envFiles.env;
+	files[".gitignore"] = [
+		".env",
+		".env.local",
+		".env.*.local",
+		"*.log",
+		"docker-compose.override.yml"
+	].join("\n");
+	const manifestFiles = require_generators_stack_manifest.generateStackManifest(resolved, input);
+	for (const [path, content] of Object.entries(manifestFiles)) files[path] = content;
+	const skillFiles = require_generators_skills.generateSkillFiles(resolved);
+	for (const [path, content] of Object.entries(skillFiles)) files[path] = content;
+	files["openclaw/config/openclaw.json"] = require_generators_openclaw_json.generateOpenClawConfig(resolved, {
+		deploymentType: input.deploymentType,
+		gatewayPort: 18789,
+		openclawVersion: input.openclawVersion
+	});
+	files["README.md"] = require_generators_readme.generateReadme(resolved, {
+		projectName: input.projectName,
+		domain: input.domain,
+		proxy: input.proxy,
+		deploymentType: input.deploymentType,
+		hasNativeServices: isBareMetal && nativeServices.length > 0,
+		openclawInstallMethod: input.openclawInstallMethod
+	});
+	const scripts = require_generators_scripts.generateScripts();
+	for (const [path, content] of Object.entries(scripts)) files[path] = content;
+	const healthCheckFiles = require_generators_health_check.generateHealthCheck(resolved, {
+		projectName: input.projectName,
+		deploymentType: input.deploymentType
+	});
+	for (const [path, content] of Object.entries(healthCheckFiles)) files[path] = content;
+	const n8nWorkflows = require_generators_n8n_workflows.generateN8nWorkflows(resolved);
+	for (const [path, content] of Object.entries(n8nWorkflows)) files[path] = content;
+	const postgresInit = require_generators_postgres_init.generatePostgresInit(resolved);
+	if (postgresInit) files["postgres/init-databases.sh"] = postgresInit;
+	if (input.proxy === "caddy" && input.domain) files["caddy/Caddyfile"] = require_generators_caddy.generateCaddyfile(resolved, input.domain);
+	if (traefikOutput) files["traefik/traefik.yml"] = traefikOutput.staticConfig;
+	if (resolved.services.some((s) => s.definition.id === "prometheus")) files["prometheus/prometheus.yml"] = require_generators_prometheus.generatePrometheusConfig(resolved);
+	if (resolved.services.some((s) => s.definition.id === "grafana")) {
+		const grafanaFiles = require_generators_grafana.generateGrafanaConfig();
+		for (const [path, content] of Object.entries(grafanaFiles)) files[path] = content;
+		files["config/grafana/dashboards/openclaw-stack-overview.json"] = require_generators_grafana.generateGrafanaDashboard();
+	}
+	files["docker-compose.override.yml"] = [
+		"# Local overrides for docker-compose.yml",
+		"# This file is gitignored — use it for personal port changes, extra volumes, etc.",
+		"services: {}",
+		""
+	].join("\n");
+	files["docs/SERVICES.md"] = generateServicesDoc(resolved);
+	if (isBareMetal) {
+		if (nativeServices.length > 0) {
+			const nativePlatform = require_bare_metal_partition.platformToNativePlatform(input.platform);
+			const nativeScripts = require_generators_native_services.generateNativeInstallScripts({
+				nativeServices,
+				platform: nativePlatform,
+				projectName: input.projectName
+			});
+			for (const [path, content] of Object.entries(nativeScripts)) files[path] = content;
+		}
+		const bareMetalFiles = require_generators_bare_metal_install.generateBareMetalInstall({
+			platform: input.platform,
+			projectName: input.projectName,
+			hasNativeServices: nativeServices.length > 0
+		});
+		for (const [path, content] of Object.entries(bareMetalFiles)) files[path] = content;
+	}
+	if (input.gsdRuntimes && input.gsdRuntimes.length > 0) {
+		const gsdScripts = require_generators_get_shit_done.generateGsdScripts(input.gsdRuntimes);
+		if (gsdScripts) {
+			files["openclaw/scripts/setup-gsd.sh"] = gsdScripts.sh;
+			files["openclaw/scripts/setup-gsd.ps1"] = gsdScripts.ps1;
+		}
+	}
+	if (input.openclawInstallMethod === "direct") {
+		const installScripts = require_generators_openclaw_install_script.generateOpenclawInstallScript({ projectName: input.projectName });
+		for (const [path, content] of Object.entries(installScripts)) files[path] = content;
+	}
+	if (input.deployTarget === "cloud-init") files["cloud-init.yml"] = require_generators_cloud_init.generateCloudInit({
+		composeYaml: composeResult.files["docker-compose.yml"] ?? "",
+		envContent: envFiles.env,
+		projectName: input.projectName,
+		gatewayPort: 18789
+	});
+	const skillCount = resolved.services.reduce((sum, s) => sum + s.definition.skills.length, 0);
+	return {
+		files,
+		metadata: {
+			serviceCount: resolved.services.length,
+			skillCount,
+			estimatedMemoryMB: resolved.estimatedMemoryMB,
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		}
+	};
+}
+function generateServicesDoc(resolved) {
+	const lines = [
+		"# Service Reference",
+		"",
+		"This document describes all companion services in your OpenClaw stack.",
+		""
+	];
+	for (const svc of resolved.services) {
+		const def = svc.definition;
+		lines.push(`## ${def.icon} ${def.name}`);
+		lines.push("");
+		lines.push(def.description);
+		lines.push("");
+		lines.push(`- **Image**: \`${def.image}:${def.imageTag}\``);
+		lines.push(`- **Category**: ${def.category}`);
+		lines.push(`- **Maturity**: ${def.maturity}`);
+		if (def.minMemoryMB) lines.push(`- **Min Memory**: ${def.minMemoryMB}MB`);
+		if (def.ports.length > 0) {
+			lines.push("- **Ports**:");
+			for (const p of def.ports) lines.push(`  - \`${p.container}\` — ${p.description}${p.exposed ? "" : " (internal only)"}`);
+		}
+		lines.push(`- **Docs**: ${def.docsUrl}`);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+exports.generate = generate;
+exports.generateServicesDoc = generateServicesDoc;
+//# sourceMappingURL=generate.cjs.map

package/dist/generate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.cjs","names":["migrateConfig","resolve","StackConfigError","partitionBareMetal","resolvedWithOnlyServices","generateTraefikConfig","composeMultiFile","validate","ValidationError","generateEnvFiles","generateStackManifest","generateSkillFiles","generateOpenClawConfig","generateReadme","generateScripts","generateHealthCheck","generateN8nWorkflows","generatePostgresInit","generateCaddyfile","generatePrometheusConfig","generateGrafanaConfig","generateGrafanaDashboard","platformToNativePlatform","generateNativeInstallScripts","generateBareMetalInstall","generateGsdScripts","generateOpenclawInstallScript","generateCloudInit"],"sources":["../src/generate.ts"],"sourcesContent":["import {\n\tpartitionBareMetal,\n\tplatformToNativePlatform,\n\tresolvedWithOnlyServices,\n} from \"./bare-metal-partition.js\";\nimport { composeMultiFile } from \"./composer.js\";\nimport { StackConfigError, ValidationError } from \"./errors.js\";\nimport { generateBareMetalInstall } from \"./generators/bare-metal-install.js\";\nimport { generateCaddyfile } from \"./generators/caddy.js\";\nimport { generateCloudInit } from \"./generators/cloud-init.js\";\nimport { generateEnvFiles } from \"./generators/env.js\";\nimport { generateGsdScripts } from \"./generators/get-shit-done.js\";\nimport { generateGrafanaConfig, generateGrafanaDashboard } from \"./generators/grafana.js\";\nimport { generateHealthCheck } from \"./generators/health-check.js\";\nimport { generateN8nWorkflows } from \"./generators/n8n-workflows.js\";\nimport { generateNativeInstallScripts } from \"./generators/native-services.js\";\nimport { generateOpenclawInstallScript } from \"./generators/openclaw-install-script.js\";\nimport { generateOpenClawConfig } from \"./generators/openclaw-json.js\";\nimport { generatePostgresInit } from \"./generators/postgres-init.js\";\nimport { generatePrometheusConfig } from \"./generators/prometheus.js\";\nimport { generateReadme } from \"./generators/readme.js\";\nimport { generateScripts } from \"./generators/scripts.js\";\nimport { generateSkillFiles } from \"./generators/skills.js\";\nimport { generateStackManifest } from \"./generators/stack-manifest.js\";\nimport { generateTraefikConfig } from \"./generators/traefik.js\";\nimport { migrateConfig } from \"./migrations.js\";\nimport { resolve } from \"./resolver.js\";\nimport type {\n\tGeneratedFiles,\n\tGenerationInput,\n\tGenerationResult,\n\tPlatform,\n\tResolverInput,\n} from \"./types.js\";\nimport { validate } from \"./validator.js\";\n\n/** Resolver/compose only support linux image platforms; normalize for bare-metal (windows/macos). */\nfunction getComposePlatform(platform: Platform): \"linux/amd64\" | \"linux/arm64\" {\n\tif (platform === \"linux/amd64\" || platform === \"linux/arm64\") return platform;\n\treturn \"linux/amd64\";\n}\n\n/**\n * Main orchestration function: takes generation input, resolves dependencies,\n * generates all files, validates, and returns the complete file tree.\n */\nexport function generate(rawInput: GenerationInput): GenerationResult {\n\t// Apply config migrations if needed\n\tconst input = migrateConfig(rawInput as Record<string, unknown>) as GenerationInput;\n\n\tconst composePlatform = getComposePlatform(input.platform);\n\n\t// 1. Resolve dependencies\n\tconst resolverInput: ResolverInput = {\n\t\tservices: input.services,\n\t\tskillPacks: input.skillPacks,\n\t\taiProviders: input.aiProviders,\n\t\tproxy: input.proxy,\n\t\tgpu: input.gpu,\n\t\tplatform: composePlatform,\n\t\tmonitoring: input.monitoring,\n\t};\n\tconst resolved = resolve(resolverInput);\n\n\tif (!resolved.isValid) {\n\t\tthrow new StackConfigError(\n\t\t\t`Invalid stack configuration: ${resolved.errors.map((e) => e.message).join(\"; \")}`,\n\t\t);\n\t}\n\n\tconst isBareMetal = input.deploymentType === \"bare-metal\";\n\tlet resolvedForCompose = resolved;\n\tlet nativeIds = new Set<string>();\n\tlet nativeServices: typeof resolved.services = [];\n\tlet dockerOnlyServices: typeof resolved.services = [];\n\n\tif (isBareMetal) {\n\t\tconst partition = partitionBareMetal(resolved, input.platform);\n\t\tnativeServices = partition.nativeServices;\n\t\tdockerOnlyServices = partition.dockerOnlyServices;\n\t\tnativeIds = partition.nativeIds;\n\t\tif (nativeServices.length > 0) {\n\t\t\tresolvedForCompose = resolvedWithOnlyServices(resolved, dockerOnlyServices);\n\t\t}\n\t}\n\n\t// 2. Generate Docker Compose YAML (multi-file)\n\t// Compute Traefik labels before composing (labels get injected into docker-compose services)\n\tlet traefikOutput: ReturnType<typeof generateTraefikConfig> | undefined;\n\tif (input.proxy === \"traefik\" && input.domain) {\n\t\ttraefikOutput = generateTraefikConfig(resolvedForCompose, input.domain);\n\t}\n\n\tconst composeOptions = {\n\t\tprojectName: input.projectName,\n\t\tproxy: input.proxy,\n\t\tproxyHttpPort: input.proxyHttpPort,\n\t\tproxyHttpsPort: input.proxyHttpsPort,\n\t\tportOverrides: input.portOverrides,\n\t\tdomain: input.domain,\n\t\tgpu: input.gpu,\n\t\tplatform: composePlatform,\n\t\tdeployment: input.deployment,\n\t\topenclawVersion: input.openclawVersion,\n\t\tbareMetalNativeHost: isBareMetal && nativeIds.size > 0,\n\t\ttraefikLabels: traefikOutput?.serviceLabels,\n\t\topenclawImage: input.openclawImage ?? \"official\",\n\t\thardened: input.hardened ?? true,\n\t\topenclawInstallMethod: input.openclawInstallMethod ?? \"docker\",\n\t};\n\tconst composeResult = composeMultiFile(resolvedForCompose, composeOptions);\n\n\t// 3. Validate (using the base docker-compose.yml)\n\tconst validation = validate(resolvedForCompose, composeResult.files[\"docker-compose.yml\"] ?? \"\", {\n\t\tdomain: input.domain,\n\t\tgenerateSecrets: input.generateSecrets,\n\t});\n\tif (!validation.valid) {\n\t\tthrow new ValidationError(\n\t\t\t`Validation failed: ${validation.errors.map((e) => e.message).join(\"; \")}`,\n\t\t);\n\t}\n\n\t// 4. Generate all files\n\tconst files: GeneratedFiles = {};\n\n\t// Docker Compose (multi-file output)\n\tfor (const [filename, content] of Object.entries(composeResult.files)) {\n\t\tfiles[filename] = content;\n\t}\n\n\t// Environment files (when bare-metal with native services, host vars use host.docker.internal)\n\tconst envFiles = generateEnvFiles(resolved, {\n\t\tgenerateSecrets: input.generateSecrets,\n\t\tdomain: input.domain,\n\t\topenclawVersion: input.openclawVersion,\n\t\tnativeServiceIds: isBareMetal ? nativeIds : undefined,\n\t\tcomposeFiles: Object.keys(composeResult.files),\n\t\tcomposeProfiles: composeResult.profiles,\n\t\topenclawImage: input.openclawImage,\n\t});\n\tfiles[\".env.example\"] = envFiles.envExample;\n\tfiles[\".env\"] = envFiles.env;\n\n\t// .gitignore\n\tfiles[\".gitignore\"] = [\n\t\t\".env\",\n\t\t\".env.local\",\n\t\t\".env.*.local\",\n\t\t\"*.log\",\n\t\t\"docker-compose.override.yml\",\n\t].join(\"\\n\");\n\n\t// Stack manifest (consumed by Mission Control)\n\tconst manifestFiles = generateStackManifest(resolved, input);\n\tfor (const [path, content] of Object.entries(manifestFiles)) {\n\t\tfiles[path] = content;\n\t}\n\n\t// Skills\n\tconst skillFiles = generateSkillFiles(resolved);\n\tfor (const [path, content] of Object.entries(skillFiles)) {\n\t\tfiles[path] = content;\n\t}\n\n\t// OpenClaw Core Configuration\n\tfiles[\"openclaw/config/openclaw.json\"] = generateOpenClawConfig(resolved, {\n\t\tdeploymentType: input.deploymentType,\n\t\tgatewayPort: 18789,\n\t\topenclawVersion: input.openclawVersion,\n\t});\n\n\t// README\n\tfiles[\"README.md\"] = generateReadme(resolved, {\n\t\tprojectName: input.projectName,\n\t\tdomain: input.domain,\n\t\tproxy: input.proxy,\n\t\tdeploymentType: input.deploymentType,\n\t\thasNativeServices: isBareMetal && nativeServices.length > 0,\n\t\topenclawInstallMethod: input.openclawInstallMethod,\n\t});\n\n\t// Scripts\n\tconst scripts = generateScripts();\n\tfor (const [path, content] of Object.entries(scripts)) {\n\t\tfiles[path] = content;\n\t}\n\n\t// Health check scripts (dynamic, stack-specific)\n\tconst healthCheckFiles = generateHealthCheck(resolved, {\n\t\tprojectName: input.projectName,\n\t\tdeploymentType: input.deploymentType,\n\t});\n\tfor (const [path, content] of Object.entries(healthCheckFiles)) {\n\t\tfiles[path] = content;\n\t}\n\n\t// n8n workflows\n\tconst n8nWorkflows = generateN8nWorkflows(resolved);\n\tfor (const [path, content] of Object.entries(n8nWorkflows)) {\n\t\tfiles[path] = content;\n\t}\n\n\t// PostgreSQL init script (creates per-service databases and users)\n\tconst postgresInit = generatePostgresInit(resolved);\n\tif (postgresInit) {\n\t\tfiles[\"postgres/init-databases.sh\"] = postgresInit;\n\t}\n\n\t// Caddy config\n\tif (input.proxy === \"caddy\" && input.domain) {\n\t\tfiles[\"caddy/Caddyfile\"] = generateCaddyfile(resolved, input.domain);\n\t}\n\n\t// Traefik config (labels are already injected via composeOptions.traefikLabels)\n\tif (traefikOutput) {\n\t\tfiles[\"traefik/traefik.yml\"] = traefikOutput.staticConfig;\n\t}\n\n\t// Prometheus config\n\tconst hasPrometheus = resolved.services.some((s) => s.definition.id === \"prometheus\");\n\tif (hasPrometheus) {\n\t\tfiles[\"prometheus/prometheus.yml\"] = generatePrometheusConfig(resolved);\n\t}\n\n\t// Grafana config\n\tconst hasGrafana = resolved.services.some((s) => s.definition.id === \"grafana\");\n\tif (hasGrafana) {\n\t\tconst grafanaFiles = generateGrafanaConfig();\n\t\tfor (const [path, content] of Object.entries(grafanaFiles)) {\n\t\t\tfiles[path] = content;\n\t\t}\n\t\t// Grafana dashboard\n\t\tfiles[\"config/grafana/dashboards/openclaw-stack-overview.json\"] = generateGrafanaDashboard();\n\t}\n\n\t// Docker Compose override (empty template)\n\tfiles[\"docker-compose.override.yml\"] = [\n\t\t\"# Local overrides for docker-compose.yml\",\n\t\t\"# This file is gitignored — use it for personal port changes, extra volumes, etc.\",\n\t\t\"services: {}\",\n\t\t\"\",\n\t].join(\"\\n\");\n\n\t// SERVICES.md documentation\n\tfiles[\"docs/SERVICES.md\"] = generateServicesDoc(resolved);\n\n\t// Bare-metal: native install scripts + top-level installer\n\tif (isBareMetal) {\n\t\tif (nativeServices.length > 0) {\n\t\t\tconst nativePlatform = platformToNativePlatform(input.platform);\n\t\t\tconst nativeScripts = generateNativeInstallScripts({\n\t\t\t\tnativeServices,\n\t\t\t\tplatform: nativePlatform,\n\t\t\t\tprojectName: input.projectName,\n\t\t\t});\n\t\t\tfor (const [path, content] of Object.entries(nativeScripts)) {\n\t\t\t\tfiles[path] = content;\n\t\t\t}\n\t\t}\n\t\tconst bareMetalFiles = generateBareMetalInstall({\n\t\t\tplatform: input.platform,\n\t\t\tprojectName: input.projectName,\n\t\t\thasNativeServices: nativeServices.length > 0,\n\t\t});\n\t\tfor (const [path, content] of Object.entries(bareMetalFiles)) {\n\t\t\tfiles[path] = content;\n\t\t}\n\t}\n\n\t// Get-Shit-Done setup scripts\n\tif (input.gsdRuntimes && input.gsdRuntimes.length > 0) {\n\t\tconst gsdScripts = generateGsdScripts(input.gsdRuntimes);\n\t\tif (gsdScripts) {\n\t\t\tfiles[\"openclaw/scripts/setup-gsd.sh\"] = gsdScripts.sh;\n\t\t\tfiles[\"openclaw/scripts/setup-gsd.ps1\"] = gsdScripts.ps1;\n\t\t}\n\t}\n\n\t// OpenClaw direct install scripts (host-based, no Docker gateway)\n\tif (input.openclawInstallMethod === \"direct\") {\n\t\tconst installScripts = generateOpenclawInstallScript({\n\t\t\tprojectName: input.projectName,\n\t\t});\n\t\tfor (const [path, content] of Object.entries(installScripts)) {\n\t\t\tfiles[path] = content;\n\t\t}\n\t}\n\n\t// Cloud-init deploy target\n\tif (input.deployTarget === \"cloud-init\") {\n\t\tconst mainCompose = composeResult.files[\"docker-compose.yml\"] ?? \"\";\n\t\tfiles[\"cloud-init.yml\"] = generateCloudInit({\n\t\t\tcomposeYaml: mainCompose,\n\t\t\tenvContent: envFiles.env,\n\t\t\tprojectName: input.projectName,\n\t\t\tgatewayPort: 18789,\n\t\t});\n\t}\n\n\t// 5. Calculate metadata\n\tconst skillCount = resolved.services.reduce((sum, s) => sum + s.definition.skills.length, 0);\n\n\treturn {\n\t\tfiles,\n\t\tmetadata: {\n\t\t\tserviceCount: resolved.services.length,\n\t\t\tskillCount,\n\t\t\testimatedMemoryMB: resolved.estimatedMemoryMB,\n\t\t\tgeneratedAt: new Date().toISOString(),\n\t\t},\n\t};\n}\n\nexport function generateServicesDoc(resolved: import(\"./types.js\").ResolverOutput): string {\n\tconst lines: string[] = [\n\t\t\"# Service Reference\",\n\t\t\"\",\n\t\t\"This document describes all companion services in your OpenClaw stack.\",\n\t\t\"\",\n\t];\n\n\tfor (const svc of resolved.services) {\n\t\tconst def = svc.definition;\n\t\tlines.push(`## ${def.icon} ${def.name}`);\n\t\tlines.push(\"\");\n\t\tlines.push(def.description);\n\t\tlines.push(\"\");\n\t\tlines.push(`- **Image**: \\`${def.image}:${def.imageTag}\\``);\n\t\tlines.push(`- **Category**: ${def.category}`);\n\t\tlines.push(`- **Maturity**: ${def.maturity}`);\n\t\tif (def.minMemoryMB) {\n\t\t\tlines.push(`- **Min Memory**: ${def.minMemoryMB}MB`);\n\t\t}\n\t\tif (def.ports.length > 0) {\n\t\t\tlines.push(\"- **Ports**:\");\n\t\t\tfor (const p of def.ports) {\n\t\t\t\tlines.push(\n\t\t\t\t\t`  - \\`${p.container}\\` — ${p.description}${p.exposed ? \"\" : \" (internal only)\"}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tlines.push(`- **Docs**: ${def.docsUrl}`);\n\t\tlines.push(\"\");\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/generate.d.cts

@@ -0,0 +1,12 @@
+import { GenerationInput, GenerationResult, ResolverOutput } from "./types.cjs";
+
+//#region src/generate.d.ts
+/**
+ * Main orchestration function: takes generation input, resolves dependencies,
+ * generates all files, validates, and returns the complete file tree.
+ */
+declare function generate(rawInput: GenerationInput): GenerationResult;
+declare function generateServicesDoc(resolved: ResolverOutput): string;
+//#endregion
+export { generate, generateServicesDoc };
+//# sourceMappingURL=generate.d.cts.map

package/dist/generate.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.cts","names":[],"sources":["../src/generate.ts"],"mappings":";;;;;AA8CA;;iBAAgB,QAAA,CAAS,QAAA,EAAU,eAAA,GAAkB,gBAAA;AAAA,iBA4QrC,mBAAA,CAAoB,QAAA,EAAD,cAAA"}

package/dist/generate.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.mts","names":[],"sources":["../src/generate.ts"],"mappings":";;;;;AA2CA;;iBAAgB,QAAA,CAAS,QAAA,EAAU,eAAA,GAAkB,gBAAA;AAAA,iBAmOrC,mBAAA,CAAoB,QAAA,EAAD,cAAA"}
+{"version":3,"file":"generate.d.mts","names":[],"sources":["../src/generate.ts"],"mappings":";;;;;AA8CA;;iBAAgB,QAAA,CAAS,QAAA,EAAU,eAAA,GAAkB,gBAAA;AAAA,iBA4QrC,mBAAA,CAAoB,QAAA,EAAD,cAAA"}

package/dist/generate.mjs

@@ -1,21 +1,24 @@
 import { partitionBareMetal, platformToNativePlatform, resolvedWithOnlyServices } from "./bare-metal-partition.mjs";
 import { resolve } from "./resolver.mjs";
+import { generatePostgresInit } from "./generators/postgres-init.mjs";
 import { composeMultiFile } from "./composer.mjs";
 import { StackConfigError, ValidationError } from "./errors.mjs";
 import { generateBareMetalInstall } from "./generators/bare-metal-install.mjs";
 import { generateCaddyfile } from "./generators/caddy.mjs";
-import { generatePostgresInit } from "./generators/postgres-init.mjs";
+import { generateCloudInit } from "./generators/cloud-init.mjs";
 import { generateEnvFiles } from "./generators/env.mjs";
 import { generateGsdScripts } from "./generators/get-shit-done.mjs";
 import { generateGrafanaConfig, generateGrafanaDashboard } from "./generators/grafana.mjs";
 import { generateHealthCheck } from "./generators/health-check.mjs";
 import { generateN8nWorkflows } from "./generators/n8n-workflows.mjs";
 import { generateNativeInstallScripts } from "./generators/native-services.mjs";
+import { generateOpenclawInstallScript } from "./generators/openclaw-install-script.mjs";
 import { generateOpenClawConfig } from "./generators/openclaw-json.mjs";
 import { generatePrometheusConfig } from "./generators/prometheus.mjs";
 import { generateReadme } from "./generators/readme.mjs";
 import { generateScripts } from "./generators/scripts.mjs";
 import { generateSkillFiles } from "./generators/skills.mjs";
+import { generateStackManifest } from "./generators/stack-manifest.mjs";
 import { generateTraefikConfig } from "./generators/traefik.mjs";
 import { migrateConfig } from "./migrations.mjs";
 import { validate } from "./validator.mjs";
@@ -60,13 +63,19 @@ function generate(rawInput) {
 	const composeOptions = {
 		projectName: input.projectName,
 		proxy: input.proxy,
+		proxyHttpPort: input.proxyHttpPort,
+		proxyHttpsPort: input.proxyHttpsPort,
+		portOverrides: input.portOverrides,
 		domain: input.domain,
 		gpu: input.gpu,
 		platform: composePlatform,
 		deployment: input.deployment,
 		openclawVersion: input.openclawVersion,
 		bareMetalNativeHost: isBareMetal && nativeIds.size > 0,
-		traefikLabels: traefikOutput?.serviceLabels
+		traefikLabels: traefikOutput?.serviceLabels,
+		openclawImage: input.openclawImage ?? "official",
+		hardened: input.hardened ?? true,
+		openclawInstallMethod: input.openclawInstallMethod ?? "docker"
 	};
 	const composeResult = composeMultiFile(resolvedForCompose, composeOptions);
 	const validation = validate(resolvedForCompose, composeResult.files["docker-compose.yml"] ?? "", {
@@ -80,7 +89,10 @@ function generate(rawInput) {
 		generateSecrets: input.generateSecrets,
 		domain: input.domain,
 		openclawVersion: input.openclawVersion,
-		nativeServiceIds: isBareMetal ? nativeIds : void 0
+		nativeServiceIds: isBareMetal ? nativeIds : void 0,
+		composeFiles: Object.keys(composeResult.files),
+		composeProfiles: composeResult.profiles,
+		openclawImage: input.openclawImage
 	});
 	files[".env.example"] = envFiles.envExample;
 	files[".env"] = envFiles.env;
@@ -91,15 +103,22 @@ function generate(rawInput) {
 		"*.log",
 		"docker-compose.override.yml"
 	].join("\n");
+	const manifestFiles = generateStackManifest(resolved, input);
+	for (const [path, content] of Object.entries(manifestFiles)) files[path] = content;
 	const skillFiles = generateSkillFiles(resolved);
 	for (const [path, content] of Object.entries(skillFiles)) files[path] = content;
-	files["openclaw/config/openclaw.json"] = generateOpenClawConfig(resolved);
+	files["openclaw/config/openclaw.json"] = generateOpenClawConfig(resolved, {
+		deploymentType: input.deploymentType,
+		gatewayPort: 18789,
+		openclawVersion: input.openclawVersion
+	});
 	files["README.md"] = generateReadme(resolved, {
 		projectName: input.projectName,
 		domain: input.domain,
 		proxy: input.proxy,
 		deploymentType: input.deploymentType,
-		hasNativeServices: isBareMetal && nativeServices.length > 0
+		hasNativeServices: isBareMetal && nativeServices.length > 0,
+		openclawInstallMethod: input.openclawInstallMethod
 	});
 	const scripts = generateScripts();
 	for (const [path, content] of Object.entries(scripts)) files[path] = content;
@@ -151,6 +170,16 @@ function generate(rawInput) {
 			files["openclaw/scripts/setup-gsd.ps1"] = gsdScripts.ps1;
 		}
 	}
+	if (input.openclawInstallMethod === "direct") {
+		const installScripts = generateOpenclawInstallScript({ projectName: input.projectName });
+		for (const [path, content] of Object.entries(installScripts)) files[path] = content;
+	}
+	if (input.deployTarget === "cloud-init") files["cloud-init.yml"] = generateCloudInit({
+		composeYaml: composeResult.files["docker-compose.yml"] ?? "",
+		envContent: envFiles.env,
+		projectName: input.projectName,
+		gatewayPort: 18789
+	});
 	const skillCount = resolved.services.reduce((sum, s) => sum + s.definition.skills.length, 0);
 	return {
 		files,