@better-openclaw/core 1.0.26 → 1.0.31

package/dist/generators/postgres-init.test.mjs

@@ -0,0 +1,112 @@
+import { a as describe, o as it, t as globalExpect } from "../test.CTcmp4Su-BRa7-bTj.mjs";
+import { generatePostgresInit, getDbRequirements } from "./postgres-init.mjs";
+//#region src/generators/postgres-init.test.ts
+function makeResolved(serviceIds) {
+	return {
+		services: serviceIds.map((id) => ({
+			definition: {
+				id,
+				name: id.charAt(0).toUpperCase() + id.slice(1),
+				description: "",
+				icon: "",
+				category: "test",
+				image: `${id}:latest`,
+				ports: [],
+				volumes: [],
+				environment: [],
+				dependencies: [],
+				conflicts: [],
+				skills: [],
+				memoryMB: 256,
+				docsUrl: ""
+			},
+			addedBy: "user"
+		})),
+		addedDependencies: [],
+		estimatedMemoryMB: 512
+	};
+}
+describe("getDbRequirements", () => {
+	it("returns empty array when no services need a DB", () => {
+		globalExpect(getDbRequirements(makeResolved(["redis", "minio"]))).toEqual([]);
+	});
+	it("returns requirements for n8n", () => {
+		const reqs = getDbRequirements(makeResolved(["n8n", "redis"]));
+		globalExpect(reqs).toHaveLength(1);
+		globalExpect(reqs[0]).toEqual({
+			serviceId: "n8n",
+			serviceName: "N8n",
+			dbName: "n8n",
+			dbUser: "n8n",
+			passwordEnvVar: "N8N_DB_PASSWORD"
+		});
+	});
+	it("returns requirements for multiple services", () => {
+		const reqs = getDbRequirements(makeResolved([
+			"n8n",
+			"outline",
+			"postiz",
+			"redis"
+		]));
+		globalExpect(reqs).toHaveLength(3);
+		const ids = reqs.map((r) => r.serviceId);
+		globalExpect(ids).toContain("n8n");
+		globalExpect(ids).toContain("outline");
+		globalExpect(ids).toContain("postiz");
+	});
+});
+describe("generatePostgresInit", () => {
+	it("returns null when PostgreSQL is not in the stack", () => {
+		globalExpect(generatePostgresInit(makeResolved(["n8n", "redis"]))).toBeNull();
+	});
+	it("returns null when PostgreSQL is present but no services need DBs", () => {
+		globalExpect(generatePostgresInit(makeResolved([
+			"postgresql",
+			"redis",
+			"minio"
+		]))).toBeNull();
+	});
+	it("generates init script when PostgreSQL and DB-needing services are present", () => {
+		const script = generatePostgresInit(makeResolved(["postgresql", "n8n"]));
+		globalExpect(script).not.toBeNull();
+		globalExpect(script).toContain("#!/bin/bash");
+		globalExpect(script).toContain("create_db_and_user");
+		globalExpect(script).toContain("\"n8n\"");
+		globalExpect(script).toContain("N8N_DB_PASSWORD");
+	});
+	it("includes all services that need DBs", () => {
+		const script = generatePostgresInit(makeResolved([
+			"postgresql",
+			"n8n",
+			"outline",
+			"dify"
+		]));
+		globalExpect(script).toContain("\"n8n\"");
+		globalExpect(script).toContain("\"outline\"");
+		globalExpect(script).toContain("\"dify\"");
+	});
+	it("uses environment variable substitution for passwords (not literals)", () => {
+		globalExpect(generatePostgresInit(makeResolved(["postgresql", "n8n"]))).toContain("${N8N_DB_PASSWORD:-$POSTGRES_PASSWORD}");
+	});
+	it("script uses psql with ON_ERROR_STOP", () => {
+		globalExpect(generatePostgresInit(makeResolved(["postgresql", "n8n"]))).toContain("ON_ERROR_STOP=1");
+	});
+	it("script creates user with IF NOT EXISTS check", () => {
+		const script = generatePostgresInit(makeResolved(["postgresql", "n8n"]));
+		globalExpect(script).toContain("IF NOT EXISTS");
+		globalExpect(script).toContain("CREATE ROLE");
+	});
+	it("includes service names in summary line", () => {
+		const script = generatePostgresInit(makeResolved([
+			"postgresql",
+			"n8n",
+			"outline"
+		]));
+		globalExpect(script).toContain("N8n");
+		globalExpect(script).toContain("Outline");
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=postgres-init.test.mjs.map

package/dist/generators/postgres-init.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-init.test.mjs","names":[],"sources":["../../src/generators/postgres-init.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport type { ResolverOutput } from \"../types.js\";\nimport { generatePostgresInit, getDbRequirements } from \"./postgres-init.js\";\n\nfunction makeResolved(serviceIds: string[]): ResolverOutput {\n\treturn {\n\t\tservices: serviceIds.map((id) => ({\n\t\t\tdefinition: {\n\t\t\t\tid,\n\t\t\t\tname: id.charAt(0).toUpperCase() + id.slice(1),\n\t\t\t\tdescription: \"\",\n\t\t\t\ticon: \"\",\n\t\t\t\tcategory: \"test\",\n\t\t\t\timage: `${id}:latest`,\n\t\t\t\tports: [],\n\t\t\t\tvolumes: [],\n\t\t\t\tenvironment: [],\n\t\t\t\tdependencies: [],\n\t\t\t\tconflicts: [],\n\t\t\t\tskills: [],\n\t\t\t\tmemoryMB: 256,\n\t\t\t\tdocsUrl: \"\",\n\t\t\t},\n\t\t\taddedBy: \"user\" as const,\n\t\t})),\n\t\taddedDependencies: [],\n\t\testimatedMemoryMB: 512,\n\t} as unknown as ResolverOutput;\n}\n\ndescribe(\"getDbRequirements\", () => {\n\tit(\"returns empty array when no services need a DB\", () => {\n\t\tconst resolved = makeResolved([\"redis\", \"minio\"]);\n\t\texpect(getDbRequirements(resolved)).toEqual([]);\n\t});\n\n\tit(\"returns requirements for n8n\", () => {\n\t\tconst resolved = makeResolved([\"n8n\", \"redis\"]);\n\t\tconst reqs = getDbRequirements(resolved);\n\t\texpect(reqs).toHaveLength(1);\n\t\texpect(reqs[0]).toEqual({\n\t\t\tserviceId: \"n8n\",\n\t\t\tserviceName: \"N8n\",\n\t\t\tdbName: \"n8n\",\n\t\t\tdbUser: \"n8n\",\n\t\t\tpasswordEnvVar: \"N8N_DB_PASSWORD\",\n\t\t});\n\t});\n\n\tit(\"returns requirements for multiple services\", () => {\n\t\tconst resolved = makeResolved([\"n8n\", \"outline\", \"postiz\", \"redis\"]);\n\t\tconst reqs = getDbRequirements(resolved);\n\t\texpect(reqs).toHaveLength(3);\n\t\tconst ids = reqs.map((r) => r.serviceId);\n\t\texpect(ids).toContain(\"n8n\");\n\t\texpect(ids).toContain(\"outline\");\n\t\texpect(ids).toContain(\"postiz\");\n\t});\n});\n\ndescribe(\"generatePostgresInit\", () => {\n\tit(\"returns null when PostgreSQL is not in the stack\", () => {\n\t\tconst resolved = makeResolved([\"n8n\", \"redis\"]);\n\t\texpect(generatePostgresInit(resolved)).toBeNull();\n\t});\n\n\tit(\"returns null when PostgreSQL is present but no services need DBs\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"redis\", \"minio\"]);\n\t\texpect(generatePostgresInit(resolved)).toBeNull();\n\t});\n\n\tit(\"generates init script when PostgreSQL and DB-needing services are present\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"n8n\"]);\n\t\tconst script = generatePostgresInit(resolved);\n\t\texpect(script).not.toBeNull();\n\t\texpect(script).toContain(\"#!/bin/bash\");\n\t\texpect(script).toContain(\"create_db_and_user\");\n\t\texpect(script).toContain('\"n8n\"');\n\t\texpect(script).toContain(\"N8N_DB_PASSWORD\");\n\t});\n\n\tit(\"includes all services that need DBs\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"n8n\", \"outline\", \"dify\"]);\n\t\tconst script = generatePostgresInit(resolved)!;\n\t\texpect(script).toContain('\"n8n\"');\n\t\texpect(script).toContain('\"outline\"');\n\t\texpect(script).toContain('\"dify\"');\n\t});\n\n\tit(\"uses environment variable substitution for passwords (not literals)\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"n8n\"]);\n\t\tconst script = generatePostgresInit(resolved)!;\n\t\t// Passwords should be referenced as env vars, not hardcoded\n\t\texpect(script).toContain(\"${N8N_DB_PASSWORD:-$POSTGRES_PASSWORD}\");\n\t});\n\n\tit(\"script uses psql with ON_ERROR_STOP\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"n8n\"]);\n\t\tconst script = generatePostgresInit(resolved)!;\n\t\texpect(script).toContain(\"ON_ERROR_STOP=1\");\n\t});\n\n\tit(\"script creates user with IF NOT EXISTS check\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"n8n\"]);\n\t\tconst script = generatePostgresInit(resolved)!;\n\t\texpect(script).toContain(\"IF NOT EXISTS\");\n\t\texpect(script).toContain(\"CREATE ROLE\");\n\t});\n\n\tit(\"includes service names in summary line\", () => {\n\t\tconst resolved = makeResolved([\"postgresql\", \"n8n\", \"outline\"]);\n\t\tconst script = generatePostgresInit(resolved)!;\n\t\texpect(script).toContain(\"N8n\");\n\t\texpect(script).toContain(\"Outline\");\n\t});\n});\n"],"mappings":"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"}

package/dist/generators/prometheus.d.cts

@@ -1,4 +1,4 @@
-import { ResolverOutput } from "../types.cjs";
+import { B as ResolverOutput } from "../types-Bsn0XzSP.cjs";
 
 //#region src/generators/prometheus.d.ts
 /**

package/dist/generators/prometheus.d.mts

@@ -1,4 +1,4 @@
-import { ResolverOutput } from "../types.mjs";
+import { B as ResolverOutput } from "../types-DwTKyCZ9.mjs";
 
 //#region src/generators/prometheus.d.ts
 /**

package/dist/generators/prometheus.test.cjs

@@ -0,0 +1,99 @@
+require("../skills-uPxJVmKk.cjs");
+const require_test_CTcmp4Su = require("../test.CTcmp4Su-BWSPM8ZQ.cjs");
+const require_generators_prometheus = require("./prometheus.cjs");
+const require_generate = require("../generate.cjs");
+let yaml = require("yaml");
+//#region src/generators/prometheus.test.ts
+function makeResolved(serviceIds) {
+	return {
+		services: serviceIds.map((id) => ({
+			definition: {
+				id,
+				name: id.charAt(0).toUpperCase() + id.slice(1),
+				description: "",
+				icon: "📦",
+				category: "test",
+				image: `${id}:latest`,
+				ports: [],
+				volumes: [],
+				environment: [],
+				dependencies: [],
+				conflicts: [],
+				skills: [],
+				memoryMB: 256,
+				docsUrl: ""
+			},
+			addedBy: "user"
+		})),
+		addedDependencies: [],
+		estimatedMemoryMB: 512
+	};
+}
+require_test_CTcmp4Su.describe("generatePrometheusConfig", () => {
+	require_test_CTcmp4Su.it("always includes prometheus self-monitoring", () => {
+		const config = require_generators_prometheus.generatePrometheusConfig(makeResolved(["redis"]));
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"prometheus\"");
+		require_test_CTcmp4Su.globalExpect(config).toContain("localhost:9090");
+	});
+	require_test_CTcmp4Su.it("includes scrape config for redis", () => {
+		const config = require_generators_prometheus.generatePrometheusConfig(makeResolved(["redis"]));
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"redis\"");
+		require_test_CTcmp4Su.globalExpect(config).toContain("redis:9121");
+	});
+	require_test_CTcmp4Su.it("includes scrape config for postgresql", () => {
+		const config = require_generators_prometheus.generatePrometheusConfig(makeResolved(["postgresql"]));
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"postgresql\"");
+		require_test_CTcmp4Su.globalExpect(config).toContain("postgresql:9187");
+	});
+	require_test_CTcmp4Su.it("includes scrape configs for multiple services", () => {
+		const config = require_generators_prometheus.generatePrometheusConfig(makeResolved([
+			"redis",
+			"n8n",
+			"minio"
+		]));
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"redis\"");
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"n8n\"");
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"minio\"");
+	});
+	require_test_CTcmp4Su.it("skips services without known metrics endpoints", () => {
+		require_test_CTcmp4Su.globalExpect(require_generators_prometheus.generatePrometheusConfig(makeResolved(["ffmpeg"]))).not.toContain("job_name: \"ffmpeg\"");
+	});
+	require_test_CTcmp4Su.it("does not duplicate prometheus job", () => {
+		require_test_CTcmp4Su.globalExpect(require_generators_prometheus.generatePrometheusConfig(makeResolved(["prometheus", "redis"])).match(/job_name: "prometheus"/g)).toHaveLength(1);
+	});
+	require_test_CTcmp4Su.it("always includes openclaw gateway metrics", () => {
+		const config = require_generators_prometheus.generatePrometheusConfig(makeResolved(["redis"]));
+		require_test_CTcmp4Su.globalExpect(config).toContain("job_name: \"openclaw-gateway\"");
+		require_test_CTcmp4Su.globalExpect(config).toContain("openclaw:18789");
+	});
+	require_test_CTcmp4Su.it("is valid YAML", () => {
+		const parsed = (0, yaml.parse)(require_generators_prometheus.generatePrometheusConfig(makeResolved(["redis", "postgresql"])));
+		require_test_CTcmp4Su.globalExpect(parsed).toBeDefined();
+		require_test_CTcmp4Su.globalExpect(parsed.global).toBeDefined();
+		require_test_CTcmp4Su.globalExpect(parsed.scrape_configs).toBeInstanceOf(Array);
+	});
+	require_test_CTcmp4Su.it("sets correct metrics paths per service", () => {
+		require_test_CTcmp4Su.globalExpect(require_generators_prometheus.generatePrometheusConfig(makeResolved(["minio"]))).toContain("/minio/v2/metrics/cluster");
+	});
+});
+require_test_CTcmp4Su.describe("prometheus via generate()", () => {
+	require_test_CTcmp4Su.it("generates prometheus config when monitoring is enabled", () => {
+		const result = require_generate.generate({
+			projectName: "prom-test",
+			services: ["redis"],
+			skillPacks: [],
+			proxy: "none",
+			gpu: false,
+			platform: "linux/amd64",
+			deployment: "local",
+			generateSecrets: true,
+			openclawVersion: "latest",
+			monitoring: true
+		});
+		require_test_CTcmp4Su.globalExpect(result.files).toHaveProperty("prometheus/prometheus.yml");
+		require_test_CTcmp4Su.globalExpect((0, yaml.parse)(result.files["prometheus/prometheus.yml"]).scrape_configs.length).toBeGreaterThan(0);
+	});
+});
+//#endregion
+
+//# sourceMappingURL=prometheus.test.cjs.map

package/dist/generators/prometheus.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.test.cjs","names":["describe","generatePrometheusConfig","generate"],"sources":["../../src/generators/prometheus.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { parse } from \"yaml\";\nimport { generate } from \"../generate.js\";\nimport type { ResolverOutput } from \"../types.js\";\nimport { generatePrometheusConfig } from \"./prometheus.js\";\n\nfunction makeResolved(serviceIds: string[]): ResolverOutput {\n\treturn {\n\t\tservices: serviceIds.map((id) => ({\n\t\t\tdefinition: {\n\t\t\t\tid,\n\t\t\t\tname: id.charAt(0).toUpperCase() + id.slice(1),\n\t\t\t\tdescription: \"\",\n\t\t\t\ticon: \"📦\",\n\t\t\t\tcategory: \"test\",\n\t\t\t\timage: `${id}:latest`,\n\t\t\t\tports: [],\n\t\t\t\tvolumes: [],\n\t\t\t\tenvironment: [],\n\t\t\t\tdependencies: [],\n\t\t\t\tconflicts: [],\n\t\t\t\tskills: [],\n\t\t\t\tmemoryMB: 256,\n\t\t\t\tdocsUrl: \"\",\n\t\t\t},\n\t\t\taddedBy: \"user\" as const,\n\t\t})),\n\t\taddedDependencies: [],\n\t\testimatedMemoryMB: 512,\n\t} as unknown as ResolverOutput;\n}\n\ndescribe(\"generatePrometheusConfig\", () => {\n\tit(\"always includes prometheus self-monitoring\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\"]));\n\t\texpect(config).toContain('job_name: \"prometheus\"');\n\t\texpect(config).toContain(\"localhost:9090\");\n\t});\n\n\tit(\"includes scrape config for redis\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\"]));\n\t\texpect(config).toContain('job_name: \"redis\"');\n\t\texpect(config).toContain(\"redis:9121\");\n\t});\n\n\tit(\"includes scrape config for postgresql\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"postgresql\"]));\n\t\texpect(config).toContain('job_name: \"postgresql\"');\n\t\texpect(config).toContain(\"postgresql:9187\");\n\t});\n\n\tit(\"includes scrape configs for multiple services\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\", \"n8n\", \"minio\"]));\n\t\texpect(config).toContain('job_name: \"redis\"');\n\t\texpect(config).toContain('job_name: \"n8n\"');\n\t\texpect(config).toContain('job_name: \"minio\"');\n\t});\n\n\tit(\"skips services without known metrics endpoints\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"ffmpeg\"]));\n\t\texpect(config).not.toContain('job_name: \"ffmpeg\"');\n\t});\n\n\tit(\"does not duplicate prometheus job\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"prometheus\", \"redis\"]));\n\t\tconst matches = config.match(/job_name: \"prometheus\"/g);\n\t\texpect(matches).toHaveLength(1);\n\t});\n\n\tit(\"always includes openclaw gateway metrics\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\"]));\n\t\texpect(config).toContain('job_name: \"openclaw-gateway\"');\n\t\texpect(config).toContain(\"openclaw:18789\");\n\t});\n\n\tit(\"is valid YAML\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\", \"postgresql\"]));\n\t\tconst parsed = parse(config);\n\t\texpect(parsed).toBeDefined();\n\t\texpect(parsed.global).toBeDefined();\n\t\texpect(parsed.scrape_configs).toBeInstanceOf(Array);\n\t});\n\n\tit(\"sets correct metrics paths per service\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"minio\"]));\n\t\texpect(config).toContain(\"/minio/v2/metrics/cluster\");\n\t});\n});\n\ndescribe(\"prometheus via generate()\", () => {\n\tit(\"generates prometheus config when monitoring is enabled\", () => {\n\t\tconst result = generate({\n\t\t\tprojectName: \"prom-test\",\n\t\t\tservices: [\"redis\"],\n\t\t\tskillPacks: [],\n\t\t\tproxy: \"none\",\n\t\t\tgpu: false,\n\t\t\tplatform: \"linux/amd64\",\n\t\t\tdeployment: \"local\",\n\t\t\tgenerateSecrets: true,\n\t\t\topenclawVersion: \"latest\",\n\t\t\tmonitoring: true,\n\t\t});\n\t\texpect(result.files).toHaveProperty(\"prometheus/prometheus.yml\");\n\t\tconst promConfig = parse(result.files[\"prometheus/prometheus.yml\"]!);\n\t\texpect(promConfig.scrape_configs.length).toBeGreaterThan(0);\n\t});\n});\n"],"mappings":"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"}

package/dist/generators/prometheus.test.d.cts

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

package/dist/generators/prometheus.test.d.mts

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

package/dist/generators/prometheus.test.mjs

@@ -0,0 +1,99 @@
+import { a as describe, o as it, t as globalExpect } from "../test.CTcmp4Su-BRa7-bTj.mjs";
+import { generatePrometheusConfig } from "./prometheus.mjs";
+import { generate } from "../generate.mjs";
+import { parse } from "yaml";
+//#region src/generators/prometheus.test.ts
+function makeResolved(serviceIds) {
+	return {
+		services: serviceIds.map((id) => ({
+			definition: {
+				id,
+				name: id.charAt(0).toUpperCase() + id.slice(1),
+				description: "",
+				icon: "📦",
+				category: "test",
+				image: `${id}:latest`,
+				ports: [],
+				volumes: [],
+				environment: [],
+				dependencies: [],
+				conflicts: [],
+				skills: [],
+				memoryMB: 256,
+				docsUrl: ""
+			},
+			addedBy: "user"
+		})),
+		addedDependencies: [],
+		estimatedMemoryMB: 512
+	};
+}
+describe("generatePrometheusConfig", () => {
+	it("always includes prometheus self-monitoring", () => {
+		const config = generatePrometheusConfig(makeResolved(["redis"]));
+		globalExpect(config).toContain("job_name: \"prometheus\"");
+		globalExpect(config).toContain("localhost:9090");
+	});
+	it("includes scrape config for redis", () => {
+		const config = generatePrometheusConfig(makeResolved(["redis"]));
+		globalExpect(config).toContain("job_name: \"redis\"");
+		globalExpect(config).toContain("redis:9121");
+	});
+	it("includes scrape config for postgresql", () => {
+		const config = generatePrometheusConfig(makeResolved(["postgresql"]));
+		globalExpect(config).toContain("job_name: \"postgresql\"");
+		globalExpect(config).toContain("postgresql:9187");
+	});
+	it("includes scrape configs for multiple services", () => {
+		const config = generatePrometheusConfig(makeResolved([
+			"redis",
+			"n8n",
+			"minio"
+		]));
+		globalExpect(config).toContain("job_name: \"redis\"");
+		globalExpect(config).toContain("job_name: \"n8n\"");
+		globalExpect(config).toContain("job_name: \"minio\"");
+	});
+	it("skips services without known metrics endpoints", () => {
+		globalExpect(generatePrometheusConfig(makeResolved(["ffmpeg"]))).not.toContain("job_name: \"ffmpeg\"");
+	});
+	it("does not duplicate prometheus job", () => {
+		globalExpect(generatePrometheusConfig(makeResolved(["prometheus", "redis"])).match(/job_name: "prometheus"/g)).toHaveLength(1);
+	});
+	it("always includes openclaw gateway metrics", () => {
+		const config = generatePrometheusConfig(makeResolved(["redis"]));
+		globalExpect(config).toContain("job_name: \"openclaw-gateway\"");
+		globalExpect(config).toContain("openclaw:18789");
+	});
+	it("is valid YAML", () => {
+		const parsed = parse(generatePrometheusConfig(makeResolved(["redis", "postgresql"])));
+		globalExpect(parsed).toBeDefined();
+		globalExpect(parsed.global).toBeDefined();
+		globalExpect(parsed.scrape_configs).toBeInstanceOf(Array);
+	});
+	it("sets correct metrics paths per service", () => {
+		globalExpect(generatePrometheusConfig(makeResolved(["minio"]))).toContain("/minio/v2/metrics/cluster");
+	});
+});
+describe("prometheus via generate()", () => {
+	it("generates prometheus config when monitoring is enabled", () => {
+		const result = generate({
+			projectName: "prom-test",
+			services: ["redis"],
+			skillPacks: [],
+			proxy: "none",
+			gpu: false,
+			platform: "linux/amd64",
+			deployment: "local",
+			generateSecrets: true,
+			openclawVersion: "latest",
+			monitoring: true
+		});
+		globalExpect(result.files).toHaveProperty("prometheus/prometheus.yml");
+		globalExpect(parse(result.files["prometheus/prometheus.yml"]).scrape_configs.length).toBeGreaterThan(0);
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=prometheus.test.mjs.map

package/dist/generators/prometheus.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.test.mjs","names":[],"sources":["../../src/generators/prometheus.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { parse } from \"yaml\";\nimport { generate } from \"../generate.js\";\nimport type { ResolverOutput } from \"../types.js\";\nimport { generatePrometheusConfig } from \"./prometheus.js\";\n\nfunction makeResolved(serviceIds: string[]): ResolverOutput {\n\treturn {\n\t\tservices: serviceIds.map((id) => ({\n\t\t\tdefinition: {\n\t\t\t\tid,\n\t\t\t\tname: id.charAt(0).toUpperCase() + id.slice(1),\n\t\t\t\tdescription: \"\",\n\t\t\t\ticon: \"📦\",\n\t\t\t\tcategory: \"test\",\n\t\t\t\timage: `${id}:latest`,\n\t\t\t\tports: [],\n\t\t\t\tvolumes: [],\n\t\t\t\tenvironment: [],\n\t\t\t\tdependencies: [],\n\t\t\t\tconflicts: [],\n\t\t\t\tskills: [],\n\t\t\t\tmemoryMB: 256,\n\t\t\t\tdocsUrl: \"\",\n\t\t\t},\n\t\t\taddedBy: \"user\" as const,\n\t\t})),\n\t\taddedDependencies: [],\n\t\testimatedMemoryMB: 512,\n\t} as unknown as ResolverOutput;\n}\n\ndescribe(\"generatePrometheusConfig\", () => {\n\tit(\"always includes prometheus self-monitoring\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\"]));\n\t\texpect(config).toContain('job_name: \"prometheus\"');\n\t\texpect(config).toContain(\"localhost:9090\");\n\t});\n\n\tit(\"includes scrape config for redis\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\"]));\n\t\texpect(config).toContain('job_name: \"redis\"');\n\t\texpect(config).toContain(\"redis:9121\");\n\t});\n\n\tit(\"includes scrape config for postgresql\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"postgresql\"]));\n\t\texpect(config).toContain('job_name: \"postgresql\"');\n\t\texpect(config).toContain(\"postgresql:9187\");\n\t});\n\n\tit(\"includes scrape configs for multiple services\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\", \"n8n\", \"minio\"]));\n\t\texpect(config).toContain('job_name: \"redis\"');\n\t\texpect(config).toContain('job_name: \"n8n\"');\n\t\texpect(config).toContain('job_name: \"minio\"');\n\t});\n\n\tit(\"skips services without known metrics endpoints\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"ffmpeg\"]));\n\t\texpect(config).not.toContain('job_name: \"ffmpeg\"');\n\t});\n\n\tit(\"does not duplicate prometheus job\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"prometheus\", \"redis\"]));\n\t\tconst matches = config.match(/job_name: \"prometheus\"/g);\n\t\texpect(matches).toHaveLength(1);\n\t});\n\n\tit(\"always includes openclaw gateway metrics\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\"]));\n\t\texpect(config).toContain('job_name: \"openclaw-gateway\"');\n\t\texpect(config).toContain(\"openclaw:18789\");\n\t});\n\n\tit(\"is valid YAML\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"redis\", \"postgresql\"]));\n\t\tconst parsed = parse(config);\n\t\texpect(parsed).toBeDefined();\n\t\texpect(parsed.global).toBeDefined();\n\t\texpect(parsed.scrape_configs).toBeInstanceOf(Array);\n\t});\n\n\tit(\"sets correct metrics paths per service\", () => {\n\t\tconst config = generatePrometheusConfig(makeResolved([\"minio\"]));\n\t\texpect(config).toContain(\"/minio/v2/metrics/cluster\");\n\t});\n});\n\ndescribe(\"prometheus via generate()\", () => {\n\tit(\"generates prometheus config when monitoring is enabled\", () => {\n\t\tconst result = generate({\n\t\t\tprojectName: \"prom-test\",\n\t\t\tservices: [\"redis\"],\n\t\t\tskillPacks: [],\n\t\t\tproxy: \"none\",\n\t\t\tgpu: false,\n\t\t\tplatform: \"linux/amd64\",\n\t\t\tdeployment: \"local\",\n\t\t\tgenerateSecrets: true,\n\t\t\topenclawVersion: \"latest\",\n\t\t\tmonitoring: true,\n\t\t});\n\t\texpect(result.files).toHaveProperty(\"prometheus/prometheus.yml\");\n\t\tconst promConfig = parse(result.files[\"prometheus/prometheus.yml\"]!);\n\t\texpect(promConfig.scrape_configs.length).toBeGreaterThan(0);\n\t});\n});\n"],"mappings":";;;;;AAMA,SAAS,aAAa,YAAsC;AAC3D,QAAO;EACN,UAAU,WAAW,KAAK,QAAQ;GACjC,YAAY;IACX;IACA,MAAM,GAAG,OAAO,EAAE,CAAC,aAAa,GAAG,GAAG,MAAM,EAAE;IAC9C,aAAa;IACb,MAAM;IACN,UAAU;IACV,OAAO,GAAG,GAAG;IACb,OAAO,EAAE;IACT,SAAS,EAAE;IACX,aAAa,EAAE;IACf,cAAc,EAAE;IAChB,WAAW,EAAE;IACb,QAAQ,EAAE;IACV,UAAU;IACV,SAAS;IACT;GACD,SAAS;GACT,EAAE;EACH,mBAAmB,EAAE;EACrB,mBAAmB;EACnB;;AAGF,SAAS,kCAAkC;AAC1C,IAAG,oDAAoD;EACtD,MAAM,SAAS,yBAAyB,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChE,eAAO,OAAO,CAAC,UAAU,2BAAyB;AAClD,eAAO,OAAO,CAAC,UAAU,iBAAiB;GACzC;AAEF,IAAG,0CAA0C;EAC5C,MAAM,SAAS,yBAAyB,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChE,eAAO,OAAO,CAAC,UAAU,sBAAoB;AAC7C,eAAO,OAAO,CAAC,UAAU,aAAa;GACrC;AAEF,IAAG,+CAA+C;EACjD,MAAM,SAAS,yBAAyB,aAAa,CAAC,aAAa,CAAC,CAAC;AACrE,eAAO,OAAO,CAAC,UAAU,2BAAyB;AAClD,eAAO,OAAO,CAAC,UAAU,kBAAkB;GAC1C;AAEF,IAAG,uDAAuD;EACzD,MAAM,SAAS,yBAAyB,aAAa;GAAC;GAAS;GAAO;GAAQ,CAAC,CAAC;AAChF,eAAO,OAAO,CAAC,UAAU,sBAAoB;AAC7C,eAAO,OAAO,CAAC,UAAU,oBAAkB;AAC3C,eAAO,OAAO,CAAC,UAAU,sBAAoB;GAC5C;AAEF,IAAG,wDAAwD;AAE1D,eADe,yBAAyB,aAAa,CAAC,SAAS,CAAC,CAAC,CACnD,CAAC,IAAI,UAAU,uBAAqB;GACjD;AAEF,IAAG,2CAA2C;AAG7C,eAFe,yBAAyB,aAAa,CAAC,cAAc,QAAQ,CAAC,CAAC,CACvD,MAAM,0BAA0B,CACxC,CAAC,aAAa,EAAE;GAC9B;AAEF,IAAG,kDAAkD;EACpD,MAAM,SAAS,yBAAyB,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChE,eAAO,OAAO,CAAC,UAAU,iCAA+B;AACxD,eAAO,OAAO,CAAC,UAAU,iBAAiB;GACzC;AAEF,IAAG,uBAAuB;EAEzB,MAAM,SAAS,MADA,yBAAyB,aAAa,CAAC,SAAS,aAAa,CAAC,CAAC,CAClD;AAC5B,eAAO,OAAO,CAAC,aAAa;AAC5B,eAAO,OAAO,OAAO,CAAC,aAAa;AACnC,eAAO,OAAO,eAAe,CAAC,eAAe,MAAM;GAClD;AAEF,IAAG,gDAAgD;AAElD,eADe,yBAAyB,aAAa,CAAC,QAAQ,CAAC,CAAC,CAClD,CAAC,UAAU,4BAA4B;GACpD;EACD;AAEF,SAAS,mCAAmC;AAC3C,IAAG,gEAAgE;EAClE,MAAM,SAAS,SAAS;GACvB,aAAa;GACb,UAAU,CAAC,QAAQ;GACnB,YAAY,EAAE;GACd,OAAO;GACP,KAAK;GACL,UAAU;GACV,YAAY;GACZ,iBAAiB;GACjB,iBAAiB;GACjB,YAAY;GACZ,CAAC;AACF,eAAO,OAAO,MAAM,CAAC,eAAe,4BAA4B;AAEhE,eADmB,MAAM,OAAO,MAAM,6BAA8B,CAClD,eAAe,OAAO,CAAC,gBAAgB,EAAE;GAC1D;EACD"}

package/dist/generators/readme.cjs

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_frameworks_registry = require("../frameworks/registry.cjs");
+require("../frameworks/index.cjs");
 //#region src/generators/readme.ts
 /**
 * Generates a comprehensive README.md for the OpenClaw project.
@@ -7,15 +9,17 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 * service URLs, skill packs, and scripts documentation.
 */
 function generateReadme(resolved, options) {
-	const { projectName, domain, proxy, deploymentType, hasNativeServices, openclawInstallMethod } = options;
+	const { projectName, domain, proxy, deploymentType, hasNativeServices, openclawInstallMethod, primaryFramework } = options;
 	const isDirectInstall = openclawInstallMethod === "direct";
+	const frameworkName = require_frameworks_registry.getFrameworkById(primaryFramework ?? "openclaw")?.name ?? "OpenClaw";
+	const isOpenClaw = (primaryFramework ?? "openclaw") === "openclaw";
 	const sections = [];
 	sections.push(`# ${projectName}
 
-> Self-hosted AI agent infrastructure powered by [OpenClaw](https://openclaw.dev).
+> Self-hosted AI agent infrastructure powered by **${frameworkName}**${isOpenClaw ? " — [openclaw.dev](https://openclaw.dev)" : ""}.
 
-This project provides a fully configured Docker Compose stack with ${resolved.services.length} services, ready to deploy on any server.${isDirectInstall ? " OpenClaw itself runs directly on the host (not in Docker)." : ""}
-${deploymentType === "bare-metal" && hasNativeServices ? "\n\n**Bare-metal (native + Docker):** Some services run natively on the host; the rest (including the OpenClaw gateway) run in Docker. Use the top-level `install.sh` or `install.ps1` to install/start native services first, then start the Docker stack." : ""}
+This project provides a fully configured Docker Compose stack with ${resolved.services.length} services, ready to deploy on any server.${isDirectInstall ? ` ${frameworkName} itself runs directly on the host (not in Docker).` : ""}
+${deploymentType === "bare-metal" && hasNativeServices ? `\n\n**Bare-metal (native + Docker):** Some services run natively on the host; the rest (including the ${frameworkName} gateway) run in Docker. Use the top-level \`install.sh\` or \`install.ps1\` to install/start native services first, then start the Docker stack.` : ""}
 
 ---`);
 	const serviceRows = resolved.services.map(({ definition }) => {
@@ -96,7 +100,7 @@ docker compose ps
 ### 5. View Logs
 
 \`\`\`bash
-docker compose logs -f openclaw-gateway
+docker compose logs -f ${primaryFramework ?? "openclaw"}-gateway
 \`\`\`
 `}
 All services should show a healthy status within 1–2 minutes.
@@ -158,7 +162,46 @@ ${skillRows}
 Skills are located in \`openclaw/workspace/skills/\`. Each skill provides a \`SKILL.md\` with usage instructions.
 `);
 	}
-	if (isDirectInstall) sections.push(`## OpenClaw Setup
+	const memoryServiceIds = [
+		"mem0",
+		"memu",
+		"hindsight"
+	];
+	const vectorDbIds = [
+		"qdrant",
+		"chromadb",
+		"weaviate",
+		"milvus"
+	];
+	const memoryServices = resolved.services.filter(({ definition }) => memoryServiceIds.includes(definition.id));
+	const vectorDbs = resolved.services.filter(({ definition }) => vectorDbIds.includes(definition.id));
+	if (memoryServices.length > 0 || vectorDbs.length > 0) {
+		let memSection = `## AI Memory Integration
+
+This stack includes integrated AI memory services. The ${frameworkName} agent framework is automatically configured to use them via \`openclaw/config/openclaw.json\`.
+`;
+		if (memoryServices.length > 0) {
+			const memList = memoryServices.map(({ definition }) => `- ${definition.icon} **${definition.name}** — ${definition.description.split(".")[0]}`).join("\n");
+			memSection += `
+### Memory Services
+
+${memList}
+`;
+		}
+		if (vectorDbs.length > 0) {
+			const vecList = vectorDbs.map(({ definition }) => `- ${definition.icon} **${definition.name}** — ${definition.description.split(".")[0]}`).join("\n");
+			memSection += `
+### Vector Databases
+
+${vecList}
+`;
+		}
+		memSection += `
+Skills for interacting with these services are in \`openclaw/workspace/skills/\`.
+`;
+		sections.push(memSection);
+	}
+	if (isOpenClaw && isDirectInstall) sections.push(`## OpenClaw Setup
 
 OpenClaw is installed directly on the host (not in Docker). After running the install script:\n
 \`\`\`bash
@@ -189,7 +232,7 @@ openclaw channels add --channel discord --token <BOT_TOKEN>
 
 See [Channel Docs](https://docs.openclaw.ai/channels) for more providers.
 `);
-	else sections.push(`## Onboarding & Channel Setup
+	else if (isOpenClaw) sections.push(`## Onboarding & Channel Setup
 
 After starting the stack, complete the gateway onboarding:
 

package/dist/generators/readme.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"readme.cjs","names":[],"sources":["../../src/generators/readme.ts"],"sourcesContent":["import type { ResolverOutput } from \"../types.js\";\n\n/**\n * Options for README generation.\n */\nexport interface ReadmeOptions {\n\tprojectName: string;\n\tdomain?: string;\n\tproxy?: string;\n\t/** When \"bare-metal\", the stack uses native + Docker hybrid. */\n\tdeploymentType?: \"docker\" | \"bare-metal\" | \"local\";\n\t/** True when some services run natively on the host (bare-metal only). */\n\thasNativeServices?: boolean;\n\t/** How OpenClaw itself is installed: docker (container) or direct (host). */\n\topenclawInstallMethod?: \"docker\" | \"direct\";\n}\n\n/**\n * Generates a comprehensive README.md for the OpenClaw project.\n *\n * Includes: project description, service table, quick start instructions,\n * service URLs, skill packs, and scripts documentation.\n */\nexport function generateReadme(resolved: ResolverOutput, options: ReadmeOptions): string {\n\tconst { projectName, domain, proxy, deploymentType, hasNativeServices, openclawInstallMethod } =\n\t\toptions;\n\tconst isDirectInstall = openclawInstallMethod === \"direct\";\n\tconst sections: string[] = [];\n\n\t// ── Title & Description ─────────────────────────────────────────────────\n\n\tsections.push(`# ${projectName}\n\n> Self-hosted AI agent infrastructure powered by [OpenClaw](https://openclaw.dev).\n\nThis project provides a fully configured Docker Compose stack with ${resolved.services.length} services, ready to deploy on any server.${isDirectInstall ? \" OpenClaw itself runs directly on the host (not in Docker).\" : \"\"}\n${deploymentType === \"bare-metal\" && hasNativeServices ? \"\\n\\n**Bare-metal (native + Docker):** Some services run natively on the host; the rest (including the OpenClaw gateway) run in Docker. Use the top-level `install.sh` or `install.ps1` to install/start native services first, then start the Docker stack.\" : \"\"}\n\n---`);\n\n\t// ── Service Table ────────────────────────────────────────────────────────\n\n\tconst serviceRows = resolved.services\n\t\t.map(({ definition }) => {\n\t\t\tconst mainPort = definition.ports.find((p) => p.exposed);\n\t\t\tconst url = mainPort\n\t\t\t\t? domain\n\t\t\t\t\t? `https://${definition.id}.${domain}`\n\t\t\t\t\t: `http://localhost:${mainPort.host}`\n\t\t\t\t: \"N/A (internal)\";\n\t\t\treturn `| ${definition.icon} | **${definition.name}** | ${url} | ${definition.description} |`;\n\t\t})\n\t\t.join(\"\\n\");\n\n\tsections.push(`## Services\n\n| | Service | URL | Description |\n|---|---------|-----|-------------|\n${serviceRows}\n`);\n\n\t// ── Quick Start ──────────────────────────────────────────────────────────\n\n\tsections.push(`## Quick Start\n\n### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/) (v24+)\n- [Docker Compose](https://docs.docker.com/compose/install/) (v2+)\n- At least ${Math.ceil(resolved.estimatedMemoryMB / 1024)}GB of RAM available\n${isDirectInstall ? \"- Node.js 22+ (installed automatically by the OpenClaw installer)\" : \"\"}\n\n### 1. Extract the ZIP\n\n\\`\\`\\`bash\nunzip ${projectName}.zip\ncd ${projectName}\n\\`\\`\\`\n\n### 2. Configure Environment\n\n\\`\\`\\`bash\ncp .env.example .env\n\\`\\`\\`\n\nEdit \\`.env\\` and update any values as needed. Secret values have been pre-generated — review and change them for production use.\n${\n\tisDirectInstall\n\t\t? `\n### 3. Install OpenClaw on the Host\n\n\\`\\`\\`bash\nchmod +x scripts/install-openclaw.sh\n./scripts/install-openclaw.sh\n\\`\\`\\`\n\nThis downloads and runs the official installer, which sets up Node.js 22+ and OpenClaw globally.\n\n### 4. Start Companion Services\n\n\\`\\`\\`bash\ndocker compose up -d\n\\`\\`\\`\n\n### 5. Run Onboarding\n\n\\`\\`\\`bash\nopenclaw onboard\n\\`\\`\\`\n`\n\t\t: `\n### 3. Start Services\n\n\\`\\`\\`bash\ndocker compose up -d\n\\`\\`\\`\n\nOr use the provided start script:\n\n\\`\\`\\`bash\nchmod +x scripts/*.sh\n./scripts/start.sh\n\\`\\`\\`\n\n### 4. Check Status\n\n\\`\\`\\`bash\ndocker compose ps\n\\`\\`\\`\n\n### 5. View Logs\n\n\\`\\`\\`bash\ndocker compose logs -f openclaw-gateway\n\\`\\`\\`\n`\n}\nAll services should show a healthy status within 1–2 minutes.\n`);\n\n\t// ── Docker Compose Profiles ──────────────────────────────────────────────\n\n\tsections.push(`## Using Docker Compose Profiles\n\nYour stack may include profile-based compose files for optional service groups. Only the base services start by default — use profiles to activate additional groups:\n\n\\`\\`\\`bash\n# Start base services only\ndocker compose up -d\n\n# Start base + AI services (Ollama, Open WebUI, etc.)\ndocker compose -f docker-compose.yml -f docker-compose.ai.yml --profile ai up -d\n\n# Start base + monitoring (Grafana, Prometheus, Uptime Kuma)\ndocker compose -f docker-compose.yml -f docker-compose.monitoring.yml --profile monitoring up -d\n\n# Start base + AI + dev tools\ndocker compose -f docker-compose.yml -f docker-compose.ai.yml -f docker-compose.tools.yml --profile ai --profile tools up -d\n\\`\\`\\`\n\nAvailable profile files (if generated):\n| File | Profile | Services |\n|------|---------|----------|\n| \\`docker-compose.ai.yml\\` | \\`ai\\` | AI models, chat UIs, LLM platforms |\n| \\`docker-compose.media.yml\\` | \\`media\\` | FFmpeg, Remotion, Motion Canvas |\n| \\`docker-compose.monitoring.yml\\` | \\`monitoring\\` | Grafana, Prometheus, Uptime Kuma, analytics |\n| \\`docker-compose.tools.yml\\` | \\`tools\\` | Gitea, code-server, Portainer, coding agents |\n| \\`docker-compose.social.yml\\` | \\`social\\` | Postiz, Mixpost |\n| \\`docker-compose.knowledge.yml\\` | \\`knowledge\\` | Outline, Paperless-ngx, NocoDB |\n| \\`docker-compose.communication.yml\\` | \\`communication\\` | Matrix, Rocket.Chat, Mattermost |\n`);\n\n\t// ── Service URLs & Ports ─────────────────────────────────────────────────\n\n\tconst portRows = resolved.services\n\t\t.filter(({ definition }) => definition.ports.length > 0)\n\t\t.map(({ definition }) => {\n\t\t\tconst ports = definition.ports\n\t\t\t\t.map((p) => `\\`${p.host}\\` → \\`${p.container}\\` (${p.description})`)\n\t\t\t\t.join(\", \");\n\t\t\treturn `| ${definition.icon} ${definition.name} | ${ports} |`;\n\t\t})\n\t\t.join(\"\\n\");\n\n\tif (portRows) {\n\t\tsections.push(`## Ports\n\n| Service | Ports |\n|---------|-------|\n${portRows}\n`);\n\t}\n\n\t// ── Skill Packs ─────────────────────────────────────────────────────────\n\n\tconst allSkills = resolved.services.flatMap(({ definition }) =>\n\t\tdefinition.skills.map((s) => ({\n\t\t\tskillId: s.skillId,\n\t\t\tserviceName: definition.name,\n\t\t\tserviceIcon: definition.icon,\n\t\t})),\n\t);\n\n\tif (allSkills.length > 0) {\n\t\tconst skillRows = allSkills\n\t\t\t.map((s) => `| \\`${s.skillId}\\` | ${s.serviceIcon} ${s.serviceName} |`)\n\t\t\t.join(\"\\n\");\n\n\t\tsections.push(`## Skills\n\nThe following OpenClaw skills are automatically installed:\n\n| Skill | Service |\n|-------|---------|\n${skillRows}\n\nSkills are located in \\`openclaw/workspace/skills/\\`. Each skill provides a \\`SKILL.md\\` with usage instructions.\n`);\n\t}\n\n\t// ── Onboarding & Channels ──────────────────────────────────────────────\n\t// Based on openclaw_docker-setup.sh post-deploy instructions\n\n\tif (isDirectInstall) {\n\t\tsections.push(`## OpenClaw Setup\n\nOpenClaw is installed directly on the host (not in Docker). After running the install script:\\n\n\\`\\`\\`bash\n# Run onboarding to configure the gateway\nopenclaw onboard\n\n# Launch the dashboard\nopenclaw dashboard\n\\`\\`\\`\n\nWhen prompted during onboarding:\n- **Gateway bind:** \\`lan\\`\n- **Gateway auth:** \\`token\\`\n- **Gateway token:** (use the value from \\`.env\\` → \\`OPENCLAW_GATEWAY_TOKEN\\`)\n\n### Connect Messaging Channels (optional)\n\n\\`\\`\\`bash\n# WhatsApp (scan QR code)\nopenclaw channels login\n\n# Telegram\nopenclaw channels add --channel telegram --token <BOT_TOKEN>\n\n# Discord\nopenclaw channels add --channel discord --token <BOT_TOKEN>\n\\`\\`\\`\n\nSee [Channel Docs](https://docs.openclaw.ai/channels) for more providers.\n`);\n\t} else {\n\t\tsections.push(`## Onboarding & Channel Setup\n\nAfter starting the stack, complete the gateway onboarding:\n\n\\`\\`\\`bash\n# Interactive onboarding (sets up gateway auth and config)\ndocker compose run --rm openclaw-cli onboard --no-install-daemon\n\\`\\`\\`\n\nWhen prompted:\n- **Gateway bind:** \\`lan\\`\n- **Gateway auth:** \\`token\\`\n- **Gateway token:** (use the value from \\`.env\\` → \\`OPENCLAW_GATEWAY_TOKEN\\`)\n- **Tailscale exposure:** Off\n- **Install Gateway daemon:** No\n\n### Connect Messaging Channels (optional)\n\n\\`\\`\\`bash\n# WhatsApp (scan QR code)\ndocker compose run --rm openclaw-cli channels login\n\n# Telegram\ndocker compose run --rm openclaw-cli channels add --channel telegram --token <BOT_TOKEN>\n\n# Discord\ndocker compose run --rm openclaw-cli channels add --channel discord --token <BOT_TOKEN>\n\\`\\`\\`\n\nSee [Channel Docs](https://docs.openclaw.ai/channels) for more providers.\n`);\n\t}\n\n\t// ── Proxy Configuration ─────────────────────────────────────────────────\n\n\tif (proxy && proxy !== \"none\") {\n\t\tconst proxyName = proxy === \"caddy\" ? \"Caddy\" : \"Traefik\";\n\t\tsections.push(`## Reverse Proxy\n\nThis stack uses **${proxyName}** as a reverse proxy.${domain ? ` All services are available under \\`${domain}\\`.` : \"\"}\n\n${proxy === \"caddy\" ? \"The Caddyfile is located at `config/Caddyfile`.\" : \"Traefik configuration is handled via Docker labels.\"}\n`);\n\t}\n\n\t// ── Scripts ──────────────────────────────────────────────────────────────\n\n\tsections.push(`## Management Scripts\n\n\\`\\`\\`bash\nchmod +x scripts/*.sh     # Make scripts executable (first time only)\n\\`\\`\\`\n\n| Script | Description |\n|--------|-------------|\n| \\`./scripts/start.sh\\` | Validates .env, auto-generates gateway token, creates dirs, starts all services with health checks |\n| \\`./scripts/stop.sh\\` | Gracefully stops all services |\n| \\`./scripts/update.sh\\` | Pulls latest Docker images and restarts services |\n| \\`./scripts/backup.sh\\` | Backs up all named Docker volumes to timestamped archives |\n| \\`./scripts/status.sh\\` | Shows current service status, resource usage, and disk |\n`);\n\n\t// ── Data & Volumes ──────────────────────────────────────────────────────\n\n\tconst volumeRows = resolved.services.flatMap(({ definition }) =>\n\t\tdefinition.volumes.map((v) => ({\n\t\t\tname: v.name,\n\t\t\tpath: v.containerPath,\n\t\t\tdescription: v.description,\n\t\t\tserviceName: definition.name,\n\t\t})),\n\t);\n\n\tif (volumeRows.length > 0) {\n\t\tconst rows = volumeRows\n\t\t\t.map((v) => `| \\`${v.name}\\` | ${v.serviceName} | ${v.description} |`)\n\t\t\t.join(\"\\n\");\n\n\t\tsections.push(`## Volumes\n\n| Volume | Service | Description |\n|--------|---------|-------------|\n${rows}\n\n> **Tip:** Use \\`scripts/backup.sh\\` to back up all volumes before updates.\n`);\n\t}\n\n\t// ── Estimated Resources ─────────────────────────────────────────────────\n\n\tsections.push(`## Resource Estimates\n\n- **Services:** ${resolved.services.length}\n- **Estimated RAM:** ~${(resolved.estimatedMemoryMB / 1024).toFixed(1)}GB\n- **Recommended minimum:** ${Math.ceil(resolved.estimatedMemoryMB / 1024) + 2}GB RAM\n`);\n\n\t// ── Warnings ─────────────────────────────────────────────────────────────\n\n\tif (resolved.warnings.length > 0) {\n\t\tconst warningList = resolved.warnings.map((w) => `- ⚠️ ${w.message}`).join(\"\\n\");\n\n\t\tsections.push(`## Warnings\n\n${warningList}\n`);\n\t}\n\n\t// ── Footer ──────────────────────────────────────────────────────────────\n\n\tsections.push(`---\n\nGenerated by [better-openclaw](https://better-openclaw.dev) • ${new Date().toISOString().split(\"T\")[0]}\nDeploy without managing servers: [Clawexa Cloud](https://clawexa.net)\n`);\n\n\treturn sections.join(\"\\n\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"readme.cjs","names":["getFrameworkById"],"sources":["../../src/generators/readme.ts"],"sourcesContent":["import { getFrameworkById } from \"../frameworks/index.js\";\nimport type { ResolverOutput } from \"../types.js\";\n\n/**\n * Options for README generation.\n */\nexport interface ReadmeOptions {\n\tprojectName: string;\n\tdomain?: string;\n\tproxy?: string;\n\t/** When \"bare-metal\", the stack uses native + Docker hybrid. */\n\tdeploymentType?: \"docker\" | \"bare-metal\" | \"local\";\n\t/** True when some services run natively on the host (bare-metal only). */\n\thasNativeServices?: boolean;\n\t/** How OpenClaw itself is installed: docker (container) or direct (host). */\n\topenclawInstallMethod?: \"docker\" | \"direct\";\n\t/** Primary agent framework (defaults to \"openclaw\"). */\n\tprimaryFramework?: string;\n}\n\n/**\n * Generates a comprehensive README.md for the OpenClaw project.\n *\n * Includes: project description, service table, quick start instructions,\n * service URLs, skill packs, and scripts documentation.\n */\nexport function generateReadme(resolved: ResolverOutput, options: ReadmeOptions): string {\n\tconst {\n\t\tprojectName,\n\t\tdomain,\n\t\tproxy,\n\t\tdeploymentType,\n\t\thasNativeServices,\n\t\topenclawInstallMethod,\n\t\tprimaryFramework,\n\t} = options;\n\tconst isDirectInstall = openclawInstallMethod === \"direct\";\n\tconst framework = getFrameworkById(primaryFramework ?? \"openclaw\");\n\tconst frameworkName = framework?.name ?? \"OpenClaw\";\n\tconst isOpenClaw = (primaryFramework ?? \"openclaw\") === \"openclaw\";\n\tconst sections: string[] = [];\n\n\t// ── Title & Description ─────────────────────────────────────────────────\n\n\tsections.push(`# ${projectName}\n\n> Self-hosted AI agent infrastructure powered by **${frameworkName}**${isOpenClaw ? \" — [openclaw.dev](https://openclaw.dev)\" : \"\"}.\n\nThis project provides a fully configured Docker Compose stack with ${resolved.services.length} services, ready to deploy on any server.${isDirectInstall ? ` ${frameworkName} itself runs directly on the host (not in Docker).` : \"\"}\n${deploymentType === \"bare-metal\" && hasNativeServices ? `\\n\\n**Bare-metal (native + Docker):** Some services run natively on the host; the rest (including the ${frameworkName} gateway) run in Docker. Use the top-level \\`install.sh\\` or \\`install.ps1\\` to install/start native services first, then start the Docker stack.` : \"\"}\n\n---`);\n\n\t// ── Service Table ────────────────────────────────────────────────────────\n\n\tconst serviceRows = resolved.services\n\t\t.map(({ definition }) => {\n\t\t\tconst mainPort = definition.ports.find((p) => p.exposed);\n\t\t\tconst url = mainPort\n\t\t\t\t? domain\n\t\t\t\t\t? `https://${definition.id}.${domain}`\n\t\t\t\t\t: `http://localhost:${mainPort.host}`\n\t\t\t\t: \"N/A (internal)\";\n\t\t\treturn `| ${definition.icon} | **${definition.name}** | ${url} | ${definition.description} |`;\n\t\t})\n\t\t.join(\"\\n\");\n\n\tsections.push(`## Services\n\n| | Service | URL | Description |\n|---|---------|-----|-------------|\n${serviceRows}\n`);\n\n\t// ── Quick Start ──────────────────────────────────────────────────────────\n\n\tsections.push(`## Quick Start\n\n### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/) (v24+)\n- [Docker Compose](https://docs.docker.com/compose/install/) (v2+)\n- At least ${Math.ceil(resolved.estimatedMemoryMB / 1024)}GB of RAM available\n${isDirectInstall ? \"- Node.js 22+ (installed automatically by the OpenClaw installer)\" : \"\"}\n\n### 1. Extract the ZIP\n\n\\`\\`\\`bash\nunzip ${projectName}.zip\ncd ${projectName}\n\\`\\`\\`\n\n### 2. Configure Environment\n\n\\`\\`\\`bash\ncp .env.example .env\n\\`\\`\\`\n\nEdit \\`.env\\` and update any values as needed. Secret values have been pre-generated — review and change them for production use.\n${\n\tisDirectInstall\n\t\t? `\n### 3. Install OpenClaw on the Host\n\n\\`\\`\\`bash\nchmod +x scripts/install-openclaw.sh\n./scripts/install-openclaw.sh\n\\`\\`\\`\n\nThis downloads and runs the official installer, which sets up Node.js 22+ and OpenClaw globally.\n\n### 4. Start Companion Services\n\n\\`\\`\\`bash\ndocker compose up -d\n\\`\\`\\`\n\n### 5. Run Onboarding\n\n\\`\\`\\`bash\nopenclaw onboard\n\\`\\`\\`\n`\n\t\t: `\n### 3. Start Services\n\n\\`\\`\\`bash\ndocker compose up -d\n\\`\\`\\`\n\nOr use the provided start script:\n\n\\`\\`\\`bash\nchmod +x scripts/*.sh\n./scripts/start.sh\n\\`\\`\\`\n\n### 4. Check Status\n\n\\`\\`\\`bash\ndocker compose ps\n\\`\\`\\`\n\n### 5. View Logs\n\n\\`\\`\\`bash\ndocker compose logs -f ${primaryFramework ?? \"openclaw\"}-gateway\n\\`\\`\\`\n`\n}\nAll services should show a healthy status within 1–2 minutes.\n`);\n\n\t// ── Docker Compose Profiles ──────────────────────────────────────────────\n\n\tsections.push(`## Using Docker Compose Profiles\n\nYour stack may include profile-based compose files for optional service groups. Only the base services start by default — use profiles to activate additional groups:\n\n\\`\\`\\`bash\n# Start base services only\ndocker compose up -d\n\n# Start base + AI services (Ollama, Open WebUI, etc.)\ndocker compose -f docker-compose.yml -f docker-compose.ai.yml --profile ai up -d\n\n# Start base + monitoring (Grafana, Prometheus, Uptime Kuma)\ndocker compose -f docker-compose.yml -f docker-compose.monitoring.yml --profile monitoring up -d\n\n# Start base + AI + dev tools\ndocker compose -f docker-compose.yml -f docker-compose.ai.yml -f docker-compose.tools.yml --profile ai --profile tools up -d\n\\`\\`\\`\n\nAvailable profile files (if generated):\n| File | Profile | Services |\n|------|---------|----------|\n| \\`docker-compose.ai.yml\\` | \\`ai\\` | AI models, chat UIs, LLM platforms |\n| \\`docker-compose.media.yml\\` | \\`media\\` | FFmpeg, Remotion, Motion Canvas |\n| \\`docker-compose.monitoring.yml\\` | \\`monitoring\\` | Grafana, Prometheus, Uptime Kuma, analytics |\n| \\`docker-compose.tools.yml\\` | \\`tools\\` | Gitea, code-server, Portainer, coding agents |\n| \\`docker-compose.social.yml\\` | \\`social\\` | Postiz, Mixpost |\n| \\`docker-compose.knowledge.yml\\` | \\`knowledge\\` | Outline, Paperless-ngx, NocoDB |\n| \\`docker-compose.communication.yml\\` | \\`communication\\` | Matrix, Rocket.Chat, Mattermost |\n`);\n\n\t// ── Service URLs & Ports ─────────────────────────────────────────────────\n\n\tconst portRows = resolved.services\n\t\t.filter(({ definition }) => definition.ports.length > 0)\n\t\t.map(({ definition }) => {\n\t\t\tconst ports = definition.ports\n\t\t\t\t.map((p) => `\\`${p.host}\\` → \\`${p.container}\\` (${p.description})`)\n\t\t\t\t.join(\", \");\n\t\t\treturn `| ${definition.icon} ${definition.name} | ${ports} |`;\n\t\t})\n\t\t.join(\"\\n\");\n\n\tif (portRows) {\n\t\tsections.push(`## Ports\n\n| Service | Ports |\n|---------|-------|\n${portRows}\n`);\n\t}\n\n\t// ── Skill Packs ─────────────────────────────────────────────────────────\n\n\tconst allSkills = resolved.services.flatMap(({ definition }) =>\n\t\tdefinition.skills.map((s) => ({\n\t\t\tskillId: s.skillId,\n\t\t\tserviceName: definition.name,\n\t\t\tserviceIcon: definition.icon,\n\t\t})),\n\t);\n\n\tif (allSkills.length > 0) {\n\t\tconst skillRows = allSkills\n\t\t\t.map((s) => `| \\`${s.skillId}\\` | ${s.serviceIcon} ${s.serviceName} |`)\n\t\t\t.join(\"\\n\");\n\n\t\tsections.push(`## Skills\n\nThe following OpenClaw skills are automatically installed:\n\n| Skill | Service |\n|-------|---------|\n${skillRows}\n\nSkills are located in \\`openclaw/workspace/skills/\\`. Each skill provides a \\`SKILL.md\\` with usage instructions.\n`);\n\t}\n\n\t// ── AI Memory Integration ──────────────────────────────────────────────\n\n\tconst memoryServiceIds = [\"mem0\", \"memu\", \"hindsight\"];\n\tconst vectorDbIds = [\"qdrant\", \"chromadb\", \"weaviate\", \"milvus\"];\n\n\tconst memoryServices = resolved.services.filter(({ definition }) =>\n\t\tmemoryServiceIds.includes(definition.id),\n\t);\n\tconst vectorDbs = resolved.services.filter(({ definition }) =>\n\t\tvectorDbIds.includes(definition.id),\n\t);\n\n\tif (memoryServices.length > 0 || vectorDbs.length > 0) {\n\t\tlet memSection = `## AI Memory Integration\n\nThis stack includes integrated AI memory services. The ${frameworkName} agent framework is automatically configured to use them via \\`openclaw/config/openclaw.json\\`.\n`;\n\n\t\tif (memoryServices.length > 0) {\n\t\t\tconst memList = memoryServices\n\t\t\t\t.map(\n\t\t\t\t\t({ definition }) =>\n\t\t\t\t\t\t`- ${definition.icon} **${definition.name}** — ${definition.description.split(\".\")[0]}`,\n\t\t\t\t)\n\t\t\t\t.join(\"\\n\");\n\t\t\tmemSection += `\n### Memory Services\n\n${memList}\n`;\n\t\t}\n\n\t\tif (vectorDbs.length > 0) {\n\t\t\tconst vecList = vectorDbs\n\t\t\t\t.map(\n\t\t\t\t\t({ definition }) =>\n\t\t\t\t\t\t`- ${definition.icon} **${definition.name}** — ${definition.description.split(\".\")[0]}`,\n\t\t\t\t)\n\t\t\t\t.join(\"\\n\");\n\t\t\tmemSection += `\n### Vector Databases\n\n${vecList}\n`;\n\t\t}\n\n\t\tmemSection += `\nSkills for interacting with these services are in \\`openclaw/workspace/skills/\\`.\n`;\n\n\t\tsections.push(memSection);\n\t}\n\n\t// ── Onboarding & Channels ──────────────────────────────────────────────\n\t// Only show OpenClaw-specific onboarding instructions for OpenClaw stacks\n\n\tif (isOpenClaw && isDirectInstall) {\n\t\tsections.push(`## OpenClaw Setup\n\nOpenClaw is installed directly on the host (not in Docker). After running the install script:\\n\n\\`\\`\\`bash\n# Run onboarding to configure the gateway\nopenclaw onboard\n\n# Launch the dashboard\nopenclaw dashboard\n\\`\\`\\`\n\nWhen prompted during onboarding:\n- **Gateway bind:** \\`lan\\`\n- **Gateway auth:** \\`token\\`\n- **Gateway token:** (use the value from \\`.env\\` → \\`OPENCLAW_GATEWAY_TOKEN\\`)\n\n### Connect Messaging Channels (optional)\n\n\\`\\`\\`bash\n# WhatsApp (scan QR code)\nopenclaw channels login\n\n# Telegram\nopenclaw channels add --channel telegram --token <BOT_TOKEN>\n\n# Discord\nopenclaw channels add --channel discord --token <BOT_TOKEN>\n\\`\\`\\`\n\nSee [Channel Docs](https://docs.openclaw.ai/channels) for more providers.\n`);\n\t} else if (isOpenClaw) {\n\t\tsections.push(`## Onboarding & Channel Setup\n\nAfter starting the stack, complete the gateway onboarding:\n\n\\`\\`\\`bash\n# Interactive onboarding (sets up gateway auth and config)\ndocker compose run --rm openclaw-cli onboard --no-install-daemon\n\\`\\`\\`\n\nWhen prompted:\n- **Gateway bind:** \\`lan\\`\n- **Gateway auth:** \\`token\\`\n- **Gateway token:** (use the value from \\`.env\\` → \\`OPENCLAW_GATEWAY_TOKEN\\`)\n- **Tailscale exposure:** Off\n- **Install Gateway daemon:** No\n\n### Connect Messaging Channels (optional)\n\n\\`\\`\\`bash\n# WhatsApp (scan QR code)\ndocker compose run --rm openclaw-cli channels login\n\n# Telegram\ndocker compose run --rm openclaw-cli channels add --channel telegram --token <BOT_TOKEN>\n\n# Discord\ndocker compose run --rm openclaw-cli channels add --channel discord --token <BOT_TOKEN>\n\\`\\`\\`\n\nSee [Channel Docs](https://docs.openclaw.ai/channels) for more providers.\n`);\n\t}\n\n\t// ── Proxy Configuration ─────────────────────────────────────────────────\n\n\tif (proxy && proxy !== \"none\") {\n\t\tconst proxyName = proxy === \"caddy\" ? \"Caddy\" : \"Traefik\";\n\t\tsections.push(`## Reverse Proxy\n\nThis stack uses **${proxyName}** as a reverse proxy.${domain ? ` All services are available under \\`${domain}\\`.` : \"\"}\n\n${proxy === \"caddy\" ? \"The Caddyfile is located at `config/Caddyfile`.\" : \"Traefik configuration is handled via Docker labels.\"}\n`);\n\t}\n\n\t// ── Scripts ──────────────────────────────────────────────────────────────\n\n\tsections.push(`## Management Scripts\n\n\\`\\`\\`bash\nchmod +x scripts/*.sh     # Make scripts executable (first time only)\n\\`\\`\\`\n\n| Script | Description |\n|--------|-------------|\n| \\`./scripts/start.sh\\` | Validates .env, auto-generates gateway token, creates dirs, starts all services with health checks |\n| \\`./scripts/stop.sh\\` | Gracefully stops all services |\n| \\`./scripts/update.sh\\` | Pulls latest Docker images and restarts services |\n| \\`./scripts/backup.sh\\` | Backs up all named Docker volumes to timestamped archives |\n| \\`./scripts/status.sh\\` | Shows current service status, resource usage, and disk |\n`);\n\n\t// ── Data & Volumes ──────────────────────────────────────────────────────\n\n\tconst volumeRows = resolved.services.flatMap(({ definition }) =>\n\t\tdefinition.volumes.map((v) => ({\n\t\t\tname: v.name,\n\t\t\tpath: v.containerPath,\n\t\t\tdescription: v.description,\n\t\t\tserviceName: definition.name,\n\t\t})),\n\t);\n\n\tif (volumeRows.length > 0) {\n\t\tconst rows = volumeRows\n\t\t\t.map((v) => `| \\`${v.name}\\` | ${v.serviceName} | ${v.description} |`)\n\t\t\t.join(\"\\n\");\n\n\t\tsections.push(`## Volumes\n\n| Volume | Service | Description |\n|--------|---------|-------------|\n${rows}\n\n> **Tip:** Use \\`scripts/backup.sh\\` to back up all volumes before updates.\n`);\n\t}\n\n\t// ── Estimated Resources ─────────────────────────────────────────────────\n\n\tsections.push(`## Resource Estimates\n\n- **Services:** ${resolved.services.length}\n- **Estimated RAM:** ~${(resolved.estimatedMemoryMB / 1024).toFixed(1)}GB\n- **Recommended minimum:** ${Math.ceil(resolved.estimatedMemoryMB / 1024) + 2}GB RAM\n`);\n\n\t// ── Warnings ─────────────────────────────────────────────────────────────\n\n\tif (resolved.warnings.length > 0) {\n\t\tconst warningList = resolved.warnings.map((w) => `- ⚠️ ${w.message}`).join(\"\\n\");\n\n\t\tsections.push(`## Warnings\n\n${warningList}\n`);\n\t}\n\n\t// ── Footer ──────────────────────────────────────────────────────────────\n\n\tsections.push(`---\n\nGenerated by [better-openclaw](https://better-openclaw.dev) • ${new Date().toISOString().split(\"T\")[0]}\nDeploy without managing servers: [Clawexa Cloud](https://clawexa.net)\n`);\n\n\treturn sections.join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/generators/readme.d.cts

@@ -1,4 +1,4 @@
-import { ResolverOutput } from "../types.cjs";
+import { B as ResolverOutput } from "../types-Bsn0XzSP.cjs";
 
 //#region src/generators/readme.d.ts
 /**
@@ -14,6 +14,8 @@ interface ReadmeOptions {
   hasNativeServices?: boolean;
   /** How OpenClaw itself is installed: docker (container) or direct (host). */
   openclawInstallMethod?: "docker" | "direct";
+  /** Primary agent framework (defaults to "openclaw"). */
+  primaryFramework?: string;
 }
 /**
  * Generates a comprehensive README.md for the OpenClaw project.

package/dist/generators/readme.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"readme.d.cts","names":[],"sources":["../../src/generators/readme.ts"],"mappings":";;;;;AAKA;UAAiB,aAAA;EAChB,WAAA;EACA,MAAA;EACA,KAAA;EADA;EAGA,cAAA;EAAA;EAEA,iBAAA;EAEA;EAAA,qBAAA;AAAA;AASD;;;;;;AAAA,iBAAgB,cAAA,CAAe,QAAA,EAAU,cAAA,EAAgB,OAAA,EAAS,aAAA"}
+{"version":3,"file":"readme.d.cts","names":[],"sources":["../../src/generators/readme.ts"],"mappings":";;;;;AAMA;UAAiB,aAAA;EAChB,WAAA;EACA,MAAA;EACA,KAAA;EADA;EAGA,cAAA;EAAA;EAEA,iBAAA;EAEA;EAAA,qBAAA;EAEgB;EAAhB,gBAAA;AAAA;;;;;;;iBASe,cAAA,CAAe,QAAA,EAAU,cAAA,EAAgB,OAAA,EAAS,aAAA"}

package/dist/generators/readme.d.mts

@@ -1,4 +1,4 @@
-import { ResolverOutput } from "../types.mjs";
+import { B as ResolverOutput } from "../types-DwTKyCZ9.mjs";
 
 //#region src/generators/readme.d.ts
 /**
@@ -14,6 +14,8 @@ interface ReadmeOptions {
   hasNativeServices?: boolean;
   /** How OpenClaw itself is installed: docker (container) or direct (host). */
   openclawInstallMethod?: "docker" | "direct";
+  /** Primary agent framework (defaults to "openclaw"). */
+  primaryFramework?: string;
 }
 /**
  * Generates a comprehensive README.md for the OpenClaw project.

package/dist/generators/readme.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"readme.d.mts","names":[],"sources":["../../src/generators/readme.ts"],"mappings":";;;;;;UAKiB,aAAA;EAChB,WAAA;EACA,MAAA;EACA,KAAA;EAFA;EAIA,cAAA;EAFA;EAIA,iBAAA;EAAA;EAEA,qBAAA;AAAA;;AASD;;;;;iBAAgB,cAAA,CAAe,QAAA,EAAU,cAAA,EAAgB,OAAA,EAAS,aAAA"}
+{"version":3,"file":"readme.d.mts","names":[],"sources":["../../src/generators/readme.ts"],"mappings":";;;;;;UAMiB,aAAA;EAChB,WAAA;EACA,MAAA;EACA,KAAA;EAFA;EAIA,cAAA;EAFA;EAIA,iBAAA;EAAA;EAEA,qBAAA;EAEA;EAAA,gBAAA;AAAA;AASD;;;;;;AAAA,iBAAgB,cAAA,CAAe,QAAA,EAAU,cAAA,EAAgB,OAAA,EAAS,aAAA"}