@warlock.js/core 5.0.1 → 5.1.0

package/esm/generations/add-command.action.mjs

@@ -2,585 +2,12 @@ import { rootPath, srcPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
 import { getWarlockVersion } from "../utils/framework-vesion.mjs";
 import { detectPackageManager, getAddCommand } from "../updater/package-manager.mjs";
-import { accessConfigStub, accessResolverStub, accessRoleMigrationStub, accessRoleModelIndexStub, accessRoleModelStub, accessUserRoleMigrationStub, accessUserRoleModelIndexStub, accessUserRoleModelStub, aiConfigStub, communicatorsConfigStub, notificationControllersStub, notificationMigrationStub, notificationModelStub, notificationRoutesStub, notificationsConfigStub, socketConfigStub, webHomePageStub, webRootStub } from "./stubs.mjs";
+import { featuresMap } from "./features/index.mjs";
 import { colors } from "@mongez/copper";
-import { ensureDirectoryAsync, fileExistsAsync, getFileAsync, getJsonFileAsync, putFileAsync, putJsonFileAsync } from "@warlock.js/fs";
+import { fileExistsAsync, getJsonFileAsync, putFileAsync, putJsonFileAsync } from "@warlock.js/fs";
 import { execSync } from "node:child_process";
 
 //#region ../core/src/generations/add-command.action.ts
-/**
-* Build a migration filename timestamp prefix in the framework's
-* MM-DD-YYYY_HH-MM-SS form. Cascade infers a migration's createdAt from this
-* prefix and orders migrations deterministically by it. Pass `offsetSeconds` to
-* stamp sibling migrations created in the same scaffold a second apart so they
-* never collide and keep a stable relative order.
-*/
-function migrationTimestamp(offsetSeconds = 0) {
-	const now = new Date(Date.now() + offsetSeconds * 1e3);
-	const pad = (value) => String(value).padStart(2, "0");
-	return `${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${now.getFullYear()}_${pad(now.getHours())}-${pad(now.getMinutes())}-${pad(now.getSeconds())}`;
-}
-async function completeTestInstallation(options) {
-	const testGlobalSetupPath = srcPath("test-global-setup.ts");
-	if (!await fileExistsAsync(testGlobalSetupPath)) {
-		await putFileAsync(testGlobalSetupPath, `/**
- * Global Test Setup
- *
- * Runs ONCE before all test workers.
- * Starts the HTTP server for integration tests.
- */
-import { startHttpTestServer, stopHttpTestServer } from "@warlock.js/core/tests";
-
-export async function setup() {
-  await startHttpTestServer();
-}
-
-export async function teardown() {
-  await stopHttpTestServer();
-}
-`);
-		console.log(`${colors.green("✓")} Created src/test-global-setup.ts`);
-	}
-	const testSetupPath = srcPath("test-setup.ts");
-	if (!await fileExistsAsync(testSetupPath)) {
-		await putFileAsync(testSetupPath, `/**
- * Test Setup - runs before EVERY test file
- *
- * Vitest runs setupFiles before each test file and rebuilds the module
- * registry with it, so this pair boots and closes the test runtime once per
- * test file.
- *
- * setupTest() is called with no options on purpose: an explicit connectors
- * value outranks tests.connectors from src/config/tests.ts, so passing one
- * here would erase your project config. Omitting it leaves the config in
- * charge.
- *
- * afterAll(teardownTest) is the other half of the pair: whoever calls
- * setupTest() owns closing it in the same runtime context.
- */
-import { setupTest, teardownTest } from "@warlock.js/core/tests";
-import { afterAll } from "vitest";
-
-await setupTest();
-
-afterAll(teardownTest);
-`);
-		console.log(`${colors.green("✓")} Created src/test-setup.ts`);
-	}
-	const viteConfigPath = rootPath("vite.config.ts");
-	if (!await fileExistsAsync(viteConfigPath)) {
-		await putFileAsync(viteConfigPath, `import { lowerStage3Decorators } from "@warlock.js/core/vite";
-import mongezVite from "@mongez/vite";
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  // lowerStage3Decorators MUST come first: it lowers native (@RegisterModel, …)
-  // decorators with esbuild before oxc / the SSR rewrite can mangle them, so
-  // decorated Cascade models load under Vitest.
-  plugins: [lowerStage3Decorators(), mongezVite()],
-  test: {
-    globalSetup: "./src/test-global-setup.ts", // HTTP server - runs once
-    setupFiles: ["./src/test-setup.ts"],       // DB/cache - runs per test file
-    environment: "node",
-    globals: false,
-    include: ["src/app/**/*.test.ts"],
-  },
-});
-`);
-		console.log(`${colors.green("✓")} Created vite.config.ts`);
-	}
-}
-async function completeReactEmailInstallation(_options) {
-	const emailsFolderPath = rootPath("emails");
-	const sampleEmailPath = rootPath("emails/welcome-email.tsx");
-	if (!await fileExistsAsync(sampleEmailPath)) {
-		await ensureDirectoryAsync(emailsFolderPath);
-		await putFileAsync(sampleEmailPath, `import { Body, Container, Head, Html, Text } from "@react-email/components";
-import { Tailwind } from "@react-email/tailwind";
-
-interface WelcomeEmailProps {
-  name: string;
-}
-
-/**
- * Sample welcome email component.
- * Preview with: yarn email:preview
- */
-export default function WelcomeEmail({ name }: WelcomeEmailProps) {
-  return (
-    <Html>
-      <Head />
-      <Tailwind>
-        <Body className="bg-gray-100 font-sans">
-          <Container className="mx-auto max-w-xl py-8 px-4">
-            <Text className="text-2xl font-bold text-gray-900">
-              Welcome, {name}!
-            </Text>
-            <Text className="text-gray-600 mt-2">
-              You're all set. We're glad to have you on board.
-            </Text>
-          </Container>
-        </Body>
-      </Tailwind>
-    </Html>
-  );
-}
-`);
-		console.log(`${colors.green("✓")} Created emails/welcome-email.tsx`);
-	}
-	const tsconfigPath = rootPath("tsconfig.json");
-	const tsconfig = await getJsonFileAsync(tsconfigPath);
-	if (!tsconfig.include) tsconfig.include = [];
-	if (!tsconfig.include.includes("emails")) {
-		tsconfig.include.push("emails");
-		await putJsonFileAsync(tsconfigPath, tsconfig);
-		console.log(`${colors.green("✓")} Added "emails" to tsconfig.json include`);
-	}
-}
-async function completeNotificationsInstallation(_options) {
-	const modelPath = srcPath("app/notifications/notification.model.ts");
-	if (await fileExistsAsync(modelPath)) {
-		console.log(`${colors.yellowBright("src/app/notifications")} already scaffolded, skipping model + migration...`);
-		return;
-	}
-	await ensureDirectoryAsync(srcPath("app/notifications"));
-	await putFileAsync(modelPath, notificationModelStub);
-	console.log(`${colors.green("✓")} Created src/app/notifications/notification.model.ts`);
-	await ensureDirectoryAsync(srcPath("app/notifications/migrations"));
-	const migrationFile = `${migrationTimestamp()}-notification.migration.ts`;
-	await putFileAsync(srcPath("app/notifications/migrations", migrationFile), notificationMigrationStub);
-	console.log(`${colors.green("✓")} Created src/app/notifications/migrations/${migrationFile}`);
-	await ensureDirectoryAsync(srcPath("app/notifications/controllers"));
-	await putFileAsync(srcPath("app/notifications/controllers/notifications.controller.ts"), notificationControllersStub);
-	await putFileAsync(srcPath("app/notifications/routes.ts"), notificationRoutesStub);
-	console.log(`${colors.green("✓")} Created src/app/notifications/routes.ts + controllers`);
-}
-async function registerAccessLocale() {
-	const localesPath = srcPath("app/shared/utils/locales.ts");
-	const accessLocale = `groupedTranslations("access", {
-  errors: {
-    forbidden: {
-      en: "You do not have permission to perform this action.",
-      ar: "ليس لديك صلاحية لتنفيذ هذا الإجراء.",
-    },
-  },
-});
-`;
-	if (await fileExistsAsync(localesPath)) {
-		const current = await getFileAsync(localesPath);
-		if (current.includes(`groupedTranslations("access"`)) {
-			console.log(`${colors.yellowBright("access")} locale already registered, skipping...`);
-			return;
-		}
-		await putFileAsync(localesPath, `${current.includes("groupedTranslations(") ? "" : `import { groupedTranslations } from "@warlock.js/core";\n\n`}${current.trimEnd()}\n\n${accessLocale}`);
-		console.log(`${colors.green("✓")} Registered the access locale in src/app/shared/utils/locales.ts`);
-		return;
-	}
-	await ensureDirectoryAsync(srcPath("app/shared/utils"));
-	await putFileAsync(localesPath, `import { groupedTranslations } from "@warlock.js/core";\n\n${accessLocale}`);
-	console.log(`${colors.green("✓")} Created src/app/shared/utils/locales.ts with the access locale`);
-}
-async function scaffoldAccessFiles() {
-	const resolverPath = srcPath("app/access/services/access-resolver.ts");
-	if (await fileExistsAsync(resolverPath)) {
-		console.log(`${colors.yellowBright("src/app/access")} already scaffolded, skipping resolver + role tables...`);
-		return;
-	}
-	await ensureDirectoryAsync(srcPath("app/access/models/role"));
-	await putFileAsync(srcPath("app/access/models/role/role.model.ts"), accessRoleModelStub);
-	await putFileAsync(srcPath("app/access/models/role/index.ts"), accessRoleModelIndexStub);
-	console.log(`${colors.green("✓")} Created src/app/access/models/role`);
-	await ensureDirectoryAsync(srcPath("app/access/models/role/migrations"));
-	const roleMigrationFile = `${migrationTimestamp()}-role.migration.ts`;
-	await putFileAsync(srcPath("app/access/models/role/migrations", roleMigrationFile), accessRoleMigrationStub);
-	console.log(`${colors.green("✓")} Created src/app/access/models/role/migrations/${roleMigrationFile}`);
-	await ensureDirectoryAsync(srcPath("app/access/models/user-role"));
-	await putFileAsync(srcPath("app/access/models/user-role/user-role.model.ts"), accessUserRoleModelStub);
-	await putFileAsync(srcPath("app/access/models/user-role/index.ts"), accessUserRoleModelIndexStub);
-	console.log(`${colors.green("✓")} Created src/app/access/models/user-role`);
-	await ensureDirectoryAsync(srcPath("app/access/models/user-role/migrations"));
-	const userRoleMigrationFile = `${migrationTimestamp(1)}-user-role.migration.ts`;
-	await putFileAsync(srcPath("app/access/models/user-role/migrations", userRoleMigrationFile), accessUserRoleMigrationStub);
-	console.log(`${colors.green("✓")} Created src/app/access/models/user-role/migrations/${userRoleMigrationFile}`);
-	await ensureDirectoryAsync(srcPath("app/access/services"));
-	await putFileAsync(resolverPath, accessResolverStub);
-	console.log(`${colors.green("✓")} Created src/app/access/services/access-resolver.ts`);
-}
-/**
-* Register the WebConnector in `warlock.config.ts`, and ONLY there.
-*
-* It belongs to the config array or to app code, never both. Both halves are
-* registered before app code loads — the CLI preloader in dev, the generated
-* entry in production — so also calling `connectorsManager.register(...)` in
-* `src/app/main.ts` boots the connector twice and installs every page route
-* twice. That surfaces at PRODUCTION boot as `Route name "..." is already
-* taken`, because pages and API routes share one route-name namespace.
-*
-* The config array is the half to prefer: `warlock build` reads the same array
-* to drain each connector's build contribution, so "built for" and "boots with"
-* cannot drift.
-*
-* String surgery rather than a TypeScript parse: `warlock.config.ts` is an
-* app-owned file that may carry any formatting, and a parse-and-print would
-* reformat the parts we did not come to change.
-*/
-async function registerWebConnector() {
-	const configPath = rootPath("warlock.config.ts");
-	if (!await fileExistsAsync(configPath)) {
-		console.log(`${colors.yellowBright("warlock.config.ts")} not found — add this yourself:\n  import { webConnector } from "@warlock.js/web/connector";\n  export default defineConfig({ connectors: [webConnector()] });`);
-		return;
-	}
-	const current = await getFileAsync(configPath);
-	if (current.includes("webConnector")) {
-		console.log(`${colors.yellowBright("webConnector")} already registered, skipping...`);
-		return;
-	}
-	const importLine = "import { webConnector } from \"@warlock.js/web/connector\";";
-	let next = current.includes(importLine) ? current : `${importLine}\n${current}`;
-	if (/connectors:\s*\[/.test(next)) next = next.replace(/connectors:\s*\[/, "connectors: [webConnector(),");
-	else if (next.includes("defineConfig({")) next = next.replace("defineConfig({", "defineConfig({\n  connectors: [webConnector()],");
-	else {
-		console.log(`${colors.yellowBright("warlock.config.ts")} has no recognisable defineConfig({...}) — add \`connectors: [webConnector()]\` yourself.`);
-		return;
-	}
-	await putFileAsync(configPath, next);
-	console.log(`${colors.green("✓")} Registered webConnector in warlock.config.ts`);
-}
-/**
-* The app routes file the project template registers `GET /` in. Only this one
-* path is inspected: `warlock add web` is not a codebase-wide route auditor, and
-* a project that keeps its routes elsewhere lands on the `absent` outcome below,
-* which writes the page exactly as before.
-*/
-const APP_ROUTES_FILE = "app/shared/routes.ts";
-/**
-* A TOP-LEVEL `router.get("/", ...)` — anchored at column 0 on purpose.
-*
-* Routes nested in a `router.group({ prefix: "/x" }, ...)` are indented by every
-* formatter this codebase runs, and their real path is `/x`, not `/`. Anchoring
-* is what keeps the notifications feature's own `router.get("/", ...)` (inside
-* the `/notifications` group) from reading as a homepage collision.
-*
-* Only the path literal is captured. The handler — a bare identifier in the
-* template, but possibly an inline arrow spanning lines — is never matched, so
-* the rewrite below cannot damage it.
-*/
-const TOP_LEVEL_ROOT_GET = /^router\s*\.\s*get\(\s*(["'`])\/\1/gm;
-/**
-* Whether `/welcome` is already spoken for, so relocating onto it would trade
-* one duplicate-route 500 for another.
-*/
-const TOP_LEVEL_WELCOME_GET = /^router\s*\.\s*get\(\s*(["'`])\/welcome\1/m;
-/**
-* Make room for a page that declares `route = "/"`.
-*
-* The project template registers `router.get("/", homePageController)` and the
-* page stub declares `route = "/"`. Fastify rejects the second registration
-* (`Method 'GET' already declared for route '/'`) and the homepage 500s at
-* request time — so `warlock add web` cannot just write the page and hope.
-*
-* Of the three ways out, this RELOCATES the JSON route to `/welcome` rather than
-* deleting it or refusing to scaffold:
-*
-* - Deleting the controller is what the scaffolder's own `react` feature does,
-*   but it may do that: it owns the file it is deleting, seconds after writing
-*   it. `warlock add web` runs against a project a human has been living in, and
-*   silently unlinking their code is not a thing an `add` command gets to do.
-* - Writing the page anyway and printing a warning ships a project whose
-*   homepage 500s. A warning above a broken app is still a broken app.
-* - Relocating keeps BOTH surfaces working: the React homepage takes `/`, the
-*   JSON welcome answers at `/welcome`, and no line of user code disappears.
-*
-* Only the exact top-level shape is rewritten, and only the path literal inside
-* it. Anything else that claims `/` is reported and left completely alone — we
-* do not guess at code we cannot recognise.
-*/
-async function relocateConflictingHomeRoute() {
-	const routesPath = srcPath(APP_ROUTES_FILE);
-	if (!await fileExistsAsync(routesPath)) return { outcome: "absent" };
-	let current;
-	try {
-		current = await getFileAsync(routesPath);
-	} catch (error) {
-		return {
-			outcome: "failed",
-			reason: `could not be read (${error.message})`
-		};
-	}
-	const matches = current.match(TOP_LEVEL_ROOT_GET) ?? [];
-	if (matches.length === 0) return { outcome: "absent" };
-	if (matches.length > 1) return {
-		outcome: "conflict",
-		reason: `declares ${matches.length} top-level GET "/" routes`
-	};
-	if (TOP_LEVEL_WELCOME_GET.test(current)) return {
-		outcome: "conflict",
-		reason: "already declares GET \"/welcome\", so the usual relocation target is taken"
-	};
-	const next = current.replace(TOP_LEVEL_ROOT_GET, (match, quote) => match.replace(`${quote}/${quote}`, `${quote}/welcome${quote}`));
-	if (next === current) return {
-		outcome: "conflict",
-		reason: "its GET \"/\" route could not be rewritten"
-	};
-	try {
-		await putFileAsync(routesPath, next);
-	} catch (error) {
-		return {
-			outcome: "failed",
-			reason: `could not be written (${error.message})`
-		};
-	}
-	return { outcome: "relocated" };
-}
-/**
-* Scaffold the smallest page layer that renders, and register the connector.
-*
-* `src/web/root.tsx` is the sentinel for "already scaffolded" — the framework
-* ships a default root, so its presence means a human has been here.
-*/
-async function completeWebInstallation(_options) {
-	const rootFile = srcPath("web/root.tsx");
-	if (await fileExistsAsync(rootFile)) console.log(`${colors.yellowBright("src/web")} already scaffolded, skipping...`);
-	else {
-		await ensureDirectoryAsync(srcPath("web"));
-		await putFileAsync(rootFile, webRootStub);
-		console.log(`${colors.green("✓")} Created src/web/root.tsx`);
-		const collision = await relocateConflictingHomeRoute();
-		if (collision.outcome === "relocated") console.log(`${colors.green("✓")} Moved the existing ${colors.yellowBright("GET \"/\"")} route to ${colors.yellowBright("\"/welcome\"")} in ${colors.yellowBright(`src/${APP_ROUTES_FILE}`)} — the new page owns \`/\` now, and the JSON welcome route still answers at /welcome.`);
-		if (collision.outcome === "conflict" || collision.outcome === "failed") {
-			const verb = collision.outcome === "failed" ? colors.redBright("✗") : colors.yellowBright("!");
-			console.log(`${verb} Did not create src/web/home.page.tsx: ${colors.yellowBright(`src/${APP_ROUTES_FILE}`)} ${collision.reason}.\n  The page stub declares ${colors.yellowBright("route = \"/\"")}, and two handlers on one path is a 500 at request time, not a startup error.
-  Free up ${colors.yellowBright("GET \"/\"")} in that file — move it to a path of its own, or remove it — then create src/web/home.page.tsx yourself. Giving the page a \`route\` other than \`/\` works too.`);
-			process.exitCode = 1;
-		} else {
-			await putFileAsync(srcPath("web/home.page.tsx"), webHomePageStub);
-			console.log(`${colors.green("✓")} Created src/web/home.page.tsx`);
-		}
-	}
-	await registerWebConnector();
-}
-async function completeAccessInstallation(_options) {
-	await registerAccessLocale();
-	await scaffoldAccessFiles();
-}
-/**
-* Link a satellite AI package into src/config/ai.ts via a side-effect import.
-*
-* The satellites (@warlock.js/ai-tools, ai-panoptic, ai-workspace) augment the
-* `ai` object on import — they register their runtime surface (ai.tools / ai.mcp,
-* ai.workspace, panoptic's ai.config({ panoptic }) wiring) AND the matching TS
-* declaration-merging so ai.* members resolve. config-loader runs config/ai.ts at
-* boot, so dropping a bare `import "<specifier>";` at the top of that file is what
-* actually loads the augmentation before the ai connector applies the config.
-*
-* No-op if config/ai.ts is missing (the `ai` feature ejects it) or the import is
-* already present. Inserts right after the `warlock:ai-packages` marker when it
-* exists so the satellite imports stay grouped; otherwise prepends to the top.
-*/
-async function linkAiPackageImport(specifier) {
-	const aiConfigPath = srcPath("config/ai.ts");
-	if (!await fileExistsAsync(aiConfigPath)) return;
-	const current = await getFileAsync(aiConfigPath);
-	const importLine = `import "${specifier}";`;
-	if (current.includes(importLine)) return;
-	const marker = "// >>> warlock:ai-packages (auto-managed) >>>";
-	let next;
-	if (current.includes(marker)) next = current.replace(marker, `${marker}\n${importLine}`);
-	else next = `${importLine}\n${current}`;
-	await putFileAsync(aiConfigPath, next);
-	console.log(`${colors.green("✓")} Linked ${specifier} in src/config/ai.ts`);
-}
-const featuresMap = {
-	"react-email": {
-		description: "Installs react-email for building email templates with React and Tailwind",
-		requires: ["mail", "react"],
-		dependencies: {
-			"react-email": "^5.2.10",
-			"@react-email/components": "^1.0.11",
-			"@react-email/render": "^2.0.5",
-			"@react-email/tailwind": "^2.0.7"
-		},
-		devDependencies: { "@react-email/preview-server": "5.2.10" },
-		script: { "email:preview": "npx react-email dev" },
-		onExecuting: completeReactEmailInstallation
-	},
-	react: {
-		description: "Installs React and React dom for rendering React components (non-interactive), useful for sending mails and generating HTML",
-		dependencies: {
-			react: "^19.2.3",
-			"react-dom": "^19.2.3"
-		},
-		devDependencies: {
-			"@types/react": "^19.2.7",
-			"@types/react-dom": "^19.2.3"
-		}
-	},
-	image: {
-		description: "Installs sharp for image processing",
-		dependencies: { sharp: "^0.34.5" }
-	},
-	mail: {
-		description: "Installs nodemailer for sending emails",
-		dependencies: { nodemailer: "^8.0.5" },
-		devDependencies: { "@types/nodemailer": "^8.0.0" }
-	},
-	ses: {
-		description: "Installs AWS SES SDK for sending emails via Amazon SES",
-		dependencies: { "@aws-sdk/client-sesv2": "^3.1025.0" }
-	},
-	mongodb: {
-		description: "Installs mongodb driver for database driver (Cascade Package)",
-		dependencies: { mongodb: "^7.0.0" }
-	},
-	scheduler: {
-		description: "Installs warlock scheduler for scheduling tasks",
-		dependencies: { "@warlock.js/scheduler": "~4.0.0" }
-	},
-	postgres: {
-		description: "Installs pg for Postgres database (Cascade Package)",
-		dependencies: { pg: "^8.11.0" }
-	},
-	mysql: {
-		description: "Installs mysql2 for MySQL database driver (Cascade Package)",
-		dependencies: { mysql2: "^3.5.0" }
-	},
-	redis: {
-		description: "Installs redis for Redis cache driver (Cache Package)",
-		dependencies: { redis: "^4.6.13" }
-	},
-	s3: {
-		description: "Installs AWS SDK for Cloud storage (Storage Package)",
-		dependencies: {
-			"@aws-sdk/client-s3": "^3.955.0",
-			"@aws-sdk/lib-storage": "^3.955.0",
-			"@aws-sdk/s3-request-presigner": "^3.955.0"
-		}
-	},
-	test: {
-		description: "Installs warlock test for testing",
-		onExecuting: completeTestInstallation,
-		script: {
-			test: "vitest run",
-			"test:coverage": "vitest run --coverage",
-			"test:ui": "vitest --ui",
-			"test:watch": "vitest --watch"
-		},
-		devDependencies: {
-			"@mongez/vite": "^2.0.4",
-			vite: "^8.0.16",
-			vitest: "^4.1.8",
-			"@vitest/coverage-v8": "^4.1.8"
-		}
-	},
-	web: {
-		description: "Installs @warlock.js/web — SSR React pages served by the Warlock HTTP server. Scaffolds src/web (root.tsx + a home page) and registers the WebConnector in warlock.config.ts. Pages are opt-in: a Warlock app is an API until you add this.",
-		dependencies: {
-			"@warlock.js/web": "~4.0.0",
-			react: "^19.2.3",
-			"react-dom": "^19.2.3"
-		},
-		devDependencies: {
-			"@types/react": "^19.2.7",
-			"@types/react-dom": "^19.2.3",
-			vite: "^7.3.5",
-			"@vitejs/plugin-react": "^5.2.0"
-		},
-		onExecuting: completeWebInstallation
-	},
-	herald: {
-		description: "Installs herald for message broker (Herald Package)",
-		dependencies: {
-			"@warlock.js/herald": "~4.0.0",
-			amqplib: "^0.10.0"
-		},
-		devDependencies: { "@types/amqplib": "^0.10.0" },
-		ejectConfig: {
-			content: communicatorsConfigStub,
-			name: "herald"
-		}
-	},
-	socket: {
-		description: "Installs socket.io for the realtime socket server (Socket Connector)",
-		dependencies: { "socket.io": "^4.8.3" },
-		ejectConfig: {
-			content: socketConfigStub,
-			name: "socket"
-		}
-	},
-	notifications: {
-		description: "Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds the Notification model + migration plus the recipient-scoped read/dismiss routes + controllers into src/app/notifications",
-		requires: ["mail"],
-		dependencies: {
-			"@warlock.js/notifications": "~4.0.0",
-			"@warlock.js/auth": "~4.0.0"
-		},
-		ejectConfig: {
-			content: notificationsConfigStub,
-			name: "notifications"
-		},
-		onExecuting: completeNotificationsInstallation
-	},
-	access: {
-		description: "Installs @warlock.js/access — authorization (RBAC + ABAC): permission checks, ABAC policies, and roles. Ejects config/access.ts, the DatabaseAccessResolver + Role/UserRole models and migrations into src/app/access, and registers the access locale in src/app/shared/utils/locales.ts",
-		dependencies: { "@warlock.js/access": "~4.0.0" },
-		ejectConfig: {
-			content: accessConfigStub,
-			name: "access"
-		},
-		onExecuting: completeAccessInstallation
-	},
-	ai: {
-		description: "Installs @warlock.js/ai — the core AI toolkit (agents, tools, workflows)",
-		dependencies: { "@warlock.js/ai": "~4.0.0" },
-		ejectConfig: {
-			content: aiConfigStub,
-			name: "ai"
-		}
-	},
-	"ai-openai": {
-		description: "OpenAI provider for @warlock.js/ai (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-openai": "~4.0.0" }
-	},
-	"ai-google": {
-		description: "Google (Gemini) provider for @warlock.js/ai (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-google": "~4.0.0" }
-	},
-	"ai-anthropic": {
-		description: "Anthropic (Claude) provider for @warlock.js/ai (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-anthropic": "~4.0.0" }
-	},
-	"ai-bedrock": {
-		description: "AWS Bedrock provider for @warlock.js/ai (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-bedrock": "~4.0.0" }
-	},
-	"ai-ollama": {
-		description: "Ollama provider for @warlock.js/ai (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-ollama": "~4.0.0" }
-	},
-	"ai-tools": {
-		description: "Installs @warlock.js/ai-tools — ready-made agent tools (web search, fetch, HTTP, calculator, date-time) + an MCP client/server, under ai.tools.* / ai.mcp (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-tools": "~4.0.0" },
-		onExecuting: () => linkAiPackageImport("@warlock.js/ai-tools")
-	},
-	"ai-panoptic": {
-		description: "Installs @warlock.js/ai-panoptic — observability for @warlock.js/ai (collector, exporters, zero-setup local dashboard) via ai.config({ panoptic }) (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-panoptic": "~4.0.0" },
-		onExecuting: () => linkAiPackageImport("@warlock.js/ai-panoptic")
-	},
-	"ai-workspace": {
-		description: "Installs @warlock.js/ai-workspace — a policy-jailed filesystem + shell workspace for coding agents, as ai.workspace (pulls the core ai package)",
-		requires: ["ai"],
-		dependencies: { "@warlock.js/ai-workspace": "~4.0.0" },
-		onExecuting: () => linkAiPackageImport("@warlock.js/ai-workspace")
-	}
-};
 const allowedFeatures = Object.keys(featuresMap);
 function resolveFeatures(features, visited = /* @__PURE__ */ new Set()) {
 	const resolved = [];