@warlock.js/core 4.15.0 → 5.0.0

package/esm/dev-server/type-generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-generator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/type-generator.ts"],"sourcesContent":["import { env } from \"@mongez/dotenv\";\nimport { ensureDirectoryAsync } from \"@warlock.js/fs\";\nimport { spawn } from \"child_process\";\nimport { constants } from \"fs\";\nimport { access, readFile, writeFile } from \"fs/promises\";\nimport { join, resolve } from \"path\";\nimport ts from \"typescript\";\nimport { warlockPath } from \"../utils\";\nimport { devLogError, devLogInfo, devLogSuccess, devServeLog } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Typings manifest structure for tracking file hashes\n */\ntype TypingsManifest = {\n  version: string;\n  lastBuildTime: number;\n  storage: {\n    sourceHash: string;\n    drivers: string[];\n  } | null;\n  config: Record<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >;\n};\n\n/**\n * TypeGenerator - Generates TypeScript type definitions from config files\n *\n * Parses source config files using the TypeScript Compiler API to extract\n * keys and generate module augmentation types for IDE autocomplete.\n *\n * Uses manifest-based reconciliation to only regenerate when source files change.\n */\nexport class TypeGenerator {\n  /**\n   * Output directory for generated typings\n   */\n  private outputDir = warlockPath(\"typings\");\n\n  /**\n   * Path to typings manifest file\n   */\n  private manifestPath = join(this.outputDir, \"typings-manifest.json\");\n\n  /**\n   * Cached manifest data\n   */\n  private manifest: TypingsManifest | null = null;\n\n  /**\n   * Cache for config type info and keys\n   */\n  private configCache = new Map<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >();\n\n  /**\n   * Generate all framework type definitions\n   *\n   * Uses manifest-based reconciliation:\n   * - If output files don't exist: full regeneration\n   * - If files exist: only regenerate changed configs\n   */\n  public async generateAll(): Promise<void> {\n    await this.ensureOutputDir();\n\n    const storageFile = join(this.outputDir, \"storage.d.ts\");\n    const configFile = join(this.outputDir, \"config.d.ts\");\n\n    const [manifestExists, storageExists, configExists] = await Promise.all([\n      this.exists(this.manifestPath),\n      this.exists(storageFile),\n      this.exists(configFile),\n    ]);\n\n    if (!manifestExists || !storageExists || !configExists) {\n      // Full regeneration (first run or files deleted)\n      await this.fullGeneration();\n    } else {\n      // Load manifest for hash comparison\n      await this.loadManifest();\n      // Reconciliation: only regenerate changed files\n      await this.reconcile();\n    }\n\n    await this.saveManifest();\n  }\n\n  /**\n   * Full regeneration of all type files\n   */\n  private async fullGeneration(): Promise<void> {\n    // Generate storage types\n    const storageConfigPath = await this.findConfigFile(\"storage\");\n    if (storageConfigPath) {\n      this.generateStorageTypes(storageConfigPath);\n    }\n\n    // Generate config types\n    await this.generateConfigTypes();\n  }\n\n  /**\n   * Reconcile: only regenerate changed files\n   */\n  private async reconcile(): Promise<void> {\n    const files = filesOrchestrator.getFiles();\n    let storageChanged = false;\n    let configChanged = false;\n    let unchangedCount = 0;\n\n    // Check storage config\n    for (const [path, fileManager] of files) {\n      if (path.startsWith(\"src/config/storage\")) {\n        const manifestEntry = this.manifest?.storage;\n        if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n          storageChanged = true;\n          await this.generateStorageTypes(path);\n        }\n        break;\n      }\n    }\n\n    // Check config files\n    for (const [path, fileManager] of files) {\n      if (!path.startsWith(\"src/config/\")) continue;\n      if (path.includes(\"index\")) continue;\n\n      // Extract config name (remove dir prefix and extension)\n      const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n      const manifestEntry = this.manifest?.config[configName];\n\n      if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n        // File changed or new - regenerate\n        configChanged = true;\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      } else {\n        // Unchanged - load from manifest\n        unchangedCount++;\n        this.configCache.set(configName, manifestEntry);\n      }\n    }\n\n    if (configChanged) {\n      await this.writeConfigTypesFromCache();\n    } else {\n      devLogInfo(`Config types unchanged (${unchangedCount} configs cached)`);\n    }\n  }\n\n  /**\n   * Generate storage driver name types\n   */\n  public async generateStorageTypes(configPath: string): Promise<void> {\n    try {\n      const driverKeys = await this.extractStorageDriverKeys(configPath);\n\n      if (driverKeys.length === 0) {\n        devServeLog(\"⚠️ No storage drivers found in config\");\n        return;\n      }\n\n      // Get file hash from filesOrchestrator\n      const fileManager = filesOrchestrator.getFiles().get(configPath);\n      const sourceHash = fileManager?.hash || \"\";\n\n      // Update manifest\n      if (!this.manifest) {\n        this.manifest = this.createEmptyManifest();\n      }\n      this.manifest.storage = {\n        sourceHash,\n        drivers: driverKeys,\n      };\n\n      const interfaceContent = driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join(\"\\n\");\n\n      const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Generated from: ${configPath}\n// Regenerates on dev-server start and when storage config changes\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface StorageDriverRegistry {\n${interfaceContent}\n  }\n}\n`;\n\n      const outputPath = join(this.outputDir, \"storage.d.ts\");\n      await writeFile(outputPath, content, \"utf-8\");\n\n      devLogSuccess(`Generated storage types: ${driverKeys.join(\", \")}`);\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate storage types: ${error}`);\n    }\n  }\n\n  /**\n   * Check if a file change should trigger type regeneration\n   */\n  public shouldRegenerateTypes(changedPath: string): boolean {\n    return changedPath.includes(\"src/config/\") || changedPath.includes(\"config/\");\n  }\n\n  /**\n   * Handle file change - uses incremental update via cache\n   */\n  public async handleFileChange(changedPath: string): Promise<void> {\n    if (!this.shouldRegenerateTypes(changedPath)) {\n      return;\n    }\n\n    // Regenerate storage types if storage config changed\n    if (changedPath.includes(\"config/storage\")) {\n      await this.generateStorageTypes(changedPath);\n      await this.saveManifest();\n      return;\n    }\n\n    // Extract config name from path\n    const match = changedPath.match(/config\\/([^/]+)\\.[^.]+$/);\n    if (!match) {\n      return;\n    }\n\n    const configName = match[1];\n    if (configName === \"index\") return;\n\n    devLogInfo(`Config changed: ${configName}, updating...`);\n\n    // Get file manager for hash\n    const fileManager = filesOrchestrator.getFiles().get(changedPath);\n    const sourceHash = fileManager?.hash || Date.now().toString();\n\n    // Update only the changed config in cache (use optimized combined extraction)\n    const configDir = join(process.cwd(), \"src/config\");\n    const configPath = join(configDir, `${configName}.ts`);\n\n    const info = await this.extractConfigInfo(configPath, configName);\n\n    this.configCache.set(configName, {\n      sourceHash,\n      typeName: info.typeName,\n      importSource: info.importSource,\n      keys: info.keys,\n    });\n\n    // Regenerate config.d.ts from cache\n    await this.writeConfigTypesFromCache();\n    await this.saveManifest();\n  }\n\n  /**\n   * Generate config types - populates cache and writes file\n   */\n  public async generateConfigTypes(): Promise<void> {\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      // Clear and repopulate cache\n      this.configCache.clear();\n\n      for (const [path, fileManager] of files) {\n        if (!path.startsWith(\"src/config/\")) continue;\n        if (path.includes(\"index\")) continue;\n\n        // Extract config name\n        const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n        // Use optimized combined extraction (single ts.createProgram call)\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      }\n\n      await this.writeConfigTypesFromCache();\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate config types: ${error}`);\n    }\n  }\n\n  /**\n   * Quote an interface key that isn't a valid JS identifier (e.g. a config\n   * named `use-cases` or a storage driver `do-spaces`) so the generated\n   * `.d.ts` stays syntactically valid. Identifier-safe names are left bare\n   * to keep the output clean.\n   */\n  private toInterfaceKey(name: string): string {\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\n  }\n\n  /**\n   * Write config.d.ts from cached data\n   */\n  private async writeConfigTypesFromCache(): Promise<void> {\n    const configTypeInfos: Array<{\n      name: string;\n      typeName: string | null;\n      importSource: string | null;\n    }> = [];\n    const allKeys: string[] = [];\n\n    // Update manifest config section\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.config = {};\n\n    for (const [name, data] of this.configCache) {\n      configTypeInfos.push({\n        name,\n        typeName: data.typeName,\n        importSource: data.importSource,\n      });\n      allKeys.push(...data.keys);\n\n      // Store in manifest\n      this.manifest.config[name] = data;\n    }\n\n    // Group imports by source\n    const imports = new Map<string, Set<string>>();\n    for (const info of configTypeInfos) {\n      if (info.typeName && info.importSource) {\n        if (!imports.has(info.importSource)) {\n          imports.set(info.importSource, new Set());\n        }\n        imports.get(info.importSource)!.add(info.typeName);\n      }\n    }\n\n    const importStatements = Array.from(imports.entries())\n      .map(([source, types]) => `import type { ${Array.from(types).join(\", \")} } from \"${source}\";`)\n      .join(\"\\n\");\n\n    const configEntries = configTypeInfos\n      .map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.typeName || \"unknown\"};`)\n      .join(\"\\n\");\n\n    const keyEntries = allKeys.map((key) => `    \"${key}\": true;`).join(\"\\n\");\n\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Regenerates on dev-server start and when config files change\n\n${importStatements}\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ConfigRegistry {\n${configEntries}\n  }\n\n  interface ConfigKeyRegistry {\n${keyEntries}\n  }\n}\n`;\n\n    const outputPath = join(this.outputDir, \"config.d.ts\");\n    await writeFile(outputPath, content, \"utf-8\");\n\n    devLogSuccess(\n      `Generated config types: ${this.configCache.size} configs, ${allKeys.length} keys`,\n    );\n  }\n\n  // ============================================================\n  // Manifest Management\n  // ============================================================\n\n  /**\n   * Load manifest from disk\n   */\n  private async loadManifest(): Promise<boolean> {\n    try {\n      if (await this.exists(this.manifestPath)) {\n        const content = await readFile(this.manifestPath, \"utf-8\");\n        this.manifest = JSON.parse(content);\n        return true;\n      }\n    } catch {\n      // Manifest corrupted or missing\n    }\n    this.manifest = null;\n    return false;\n  }\n\n  /**\n   * Save manifest to disk\n   */\n  private async saveManifest(): Promise<void> {\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.lastBuildTime = Date.now();\n\n    await writeFile(this.manifestPath, JSON.stringify(this.manifest, null, 2), \"utf-8\");\n  }\n\n  /**\n   * Create empty manifest structure\n   */\n  private createEmptyManifest(): TypingsManifest {\n    return {\n      version: \"1.0.0\",\n      lastBuildTime: Date.now(),\n      storage: null,\n      config: {},\n    };\n  }\n\n  // ============================================================\n  // Type Extraction Methods\n  // ============================================================\n\n  /**\n   * Extract BOTH type info AND keys in a single pass\n   *\n   * This is optimized to create ts.createProgram() only ONCE per file\n   * instead of twice (once for type extraction, once for keys).\n   * This reduces parsing time by ~50%.\n   *\n   * @param configPath Absolute path to the config file\n   * @param configName Config name (e.g., \"auth\", \"notifications\")\n   * @returns Combined result with type info and keys\n   */\n  private async extractConfigInfo(\n    configPath: string,\n    configName: string,\n  ): Promise<{\n    typeName: string | null;\n    importSource: string | null;\n    keys: string[];\n  }> {\n    if (!(await this.exists(configPath))) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // Create program ONCE (this is the expensive operation)\n    const program = ts.createProgram([configPath], {\n      target: ts.ScriptTarget.ESNext,\n      module: ts.ModuleKind.ESNext,\n      moduleResolution: ts.ModuleResolutionKind.NodeJs,\n    });\n\n    const sourceFile = program.getSourceFile(configPath);\n    if (!sourceFile) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // === Type Info Extraction ===\n    const importedTypes = new Map<string, string>();\n    const localExportedTypes = new Set<string>();\n    let foundTypeName: string | null = null;\n\n    // === Keys Extraction ===\n    const keys: string[] = [];\n\n    const visitForTypes = (node: ts.Node): void => {\n      // Collect imported types\n      if (ts.isImportDeclaration(node)) {\n        const moduleSpecifier = node.moduleSpecifier;\n        if (ts.isStringLiteral(moduleSpecifier)) {\n          const source = moduleSpecifier.text;\n          const importClause = node.importClause;\n          if (importClause?.namedBindings && ts.isNamedImports(importClause.namedBindings)) {\n            for (const element of importClause.namedBindings.elements) {\n              importedTypes.set(element.name.text, source);\n            }\n          }\n        }\n      }\n\n      // Collect locally exported types\n      if (ts.isTypeAliasDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Collect locally exported interfaces\n      if (ts.isInterfaceDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Find type used on config variable + extract keys\n      if (ts.isVariableDeclaration(node)) {\n        // Type info\n        if (node.type && ts.isTypeReferenceNode(node.type)) {\n          foundTypeName = node.type.typeName.getText(sourceFile);\n        }\n\n        // Keys extraction\n        if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\n          const visitKeys = (objNode: ts.ObjectLiteralExpression, prefix: string): void => {\n            for (const prop of objNode.properties) {\n              if (ts.isPropertyAssignment(prop) && prop.name) {\n                const keyName = prop.name.getText(sourceFile);\n                const fullKey = prefix ? `${prefix}.${keyName}` : keyName;\n                keys.push(fullKey);\n                if (ts.isObjectLiteralExpression(prop.initializer)) {\n                  visitKeys(prop.initializer, fullKey);\n                }\n              }\n            }\n          };\n          visitKeys(node.initializer, configName);\n        }\n      }\n\n      ts.forEachChild(node, visitForTypes);\n    };\n\n    ts.forEachChild(sourceFile, visitForTypes);\n\n    // Resolve type info\n    let typeName: string | null = null;\n    let importSource: string | null = null;\n\n    if (foundTypeName) {\n      if (importedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        importSource = importedTypes.get(foundTypeName)!;\n      } else if (localExportedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        const relativePath = Path.toRelative(configPath).replace(/\\.(ts|tsx)$/, \"\");\n        importSource = `../../${relativePath}`;\n      }\n    }\n\n    return { typeName, importSource, keys };\n  }\n\n  /**\n   * Extract driver keys from storage config\n   */\n  private async extractStorageDriverKeys(configPath: string): Promise<string[]> {\n    const absolutePath = resolve(configPath);\n\n    if (!(await this.exists(absolutePath))) {\n      devServeLog(`⚠️ Storage config not found: ${absolutePath}`);\n      return [];\n    }\n\n    const program = ts.createProgram([absolutePath], {\n      target: ts.ScriptTarget.ESNext,\n      module: ts.ModuleKind.ESNext,\n      moduleResolution: ts.ModuleResolutionKind.NodeJs,\n    });\n\n    const sourceFile = program.getSourceFile(absolutePath);\n\n    if (!sourceFile) {\n      devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);\n      return [];\n    }\n\n    const keys: string[] = [];\n\n    const visit = (node: ts.Node): void => {\n      if (ts.isPropertyAssignment(node)) {\n        const propName = node.name.getText(sourceFile);\n\n        if (propName === \"drivers\" && ts.isObjectLiteralExpression(node.initializer)) {\n          for (const prop of node.initializer.properties) {\n            if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {\n              const keyName = prop.name?.getText(sourceFile);\n\n              if (keyName) {\n                keys.push(keyName);\n              }\n            }\n          }\n        }\n      }\n\n      ts.forEachChild(node, visit);\n    };\n\n    ts.forEachChild(sourceFile, visit);\n\n    return keys;\n  }\n\n  /**\n   * Find a config file by name\n   */\n  private async findConfigFile(configName: string): Promise<string | undefined> {\n    const possiblePaths = [`src/config/${configName}.ts`, `config/${configName}.ts`];\n\n    for (const path of possiblePaths) {\n      const fullPath = join(process.cwd(), path);\n\n      if (await this.exists(fullPath)) {\n        return path;\n      }\n    }\n\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      for (const [filePath] of files) {\n        if (filePath.includes(`config/${configName}`)) {\n          return filePath;\n        }\n      }\n    } catch {\n      // Files orchestrator not initialized yet\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Ensure output directory exists\n   */\n  private async ensureOutputDir(): Promise<void> {\n    await ensureDirectoryAsync(this.outputDir);\n  }\n\n  /**\n   * Check if a path exists (async wrapper)\n   */\n  private async exists(path: string): Promise<boolean> {\n    try {\n      await access(path, constants.F_OK);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Execute generateAll command using spawn\n   */\n  public async executeGenerateAllCommand(): Promise<void> {\n    devLogInfo(\"Checking for types generation\");\n    const isDevServeCore = env(\"DEV_SERVER_CORE\");\n    const childProcess = spawn(\n      isDevServeCore ? \"yarn\" : \"npx\",\n      [isDevServeCore ? \"cli\" : \"warlock\", \"generate.typings\"],\n      {\n        // const childProcess = spawn(\"yarn\", [\"cli\", \"generate.typings\"], {\n        stdio: \"inherit\",\n        cwd: process.cwd(),\n        shell: true, // Required on Windows to find yarn in PATH\n      },\n    );\n\n    childProcess.on(\"exit\", (code) => {\n      if (code === 0) {\n        devLogSuccess(\"Types generated successfully\");\n      } else {\n        devLogError(\"Failed to generate types\");\n      }\n    });\n  }\n\n  /**\n   * Execute a typings generator for the given files\n   */\n  public async executeTypingsGenerator(upcomingFiles: string[]): Promise<void> {\n    const uniqueFiles = Array.from(new Set(upcomingFiles));\n\n    const configFilesOnly = uniqueFiles.filter((file) =>\n      Path.normalize(file).includes(\"src/config/\"),\n    );\n\n    if (configFilesOnly.length === 0) return;\n\n    const files = configFilesOnly.map((file) => \"./\" + Path.toRelative(file));\n\n    const isDevServeCore = env(\"DEV_SERVER_CORE\");\n\n    const childProcess = spawn(\n      isDevServeCore ? \"yarn\" : \"npx\",\n      [isDevServeCore ? \"cli\" : \"warlock\", \"generate.typings\"],\n      {\n        stdio: \"inherit\",\n        cwd: process.cwd(),\n        shell: true, // Required on Windows to find yarn in PATH\n      },\n    );\n\n    childProcess.on(\"exit\", (code) => {\n      if (code === 0) {\n        devLogSuccess(\"Types generated successfully\");\n      } else {\n        devLogError(\"Failed to generate types\");\n      }\n    });\n  }\n}\n\n/**\n * Singleton instance for use throughout dev-server\n */\nexport const typeGenerator = new TypeGenerator();\n"],"mappings":"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"}
+{"version":3,"file":"type-generator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/type-generator.ts"],"sourcesContent":["import { ensureDirectoryAsync } from \"@warlock.js/fs\";\nimport { constants } from \"fs\";\nimport { access, readFile, writeFile } from \"fs/promises\";\nimport { join, resolve } from \"path\";\nimport ts from \"typescript\";\nimport { warlockPath } from \"../utils\";\nimport { devLogError, devLogInfo, devLogSuccess, devServeLog } from \"./dev-logger\";\nimport { readConfigAst } from \"./read-config-ast\";\nimport { runTypingsGeneration, type TypingsGenerationPorts } from \"./run-typings-generation\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Typings manifest structure for tracking file hashes\n */\ntype TypingsManifest = {\n  version: string;\n  lastBuildTime: number;\n  storage: {\n    sourceHash: string;\n    drivers: string[];\n  } | null;\n  config: Record<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >;\n};\n\n/**\n * TypeGenerator - Generates TypeScript type definitions from config files\n *\n * Parses source config files using the TypeScript Compiler API to extract\n * keys and generate module augmentation types for IDE autocomplete.\n *\n * Uses manifest-based reconciliation to only regenerate when source files change.\n */\nexport class TypeGenerator {\n  /**\n   * Output directory for generated typings\n   */\n  private outputDir = warlockPath(\"typings\");\n\n  /**\n   * Path to typings manifest file\n   */\n  private manifestPath = join(this.outputDir, \"typings-manifest.json\");\n\n  /**\n   * Cached manifest data\n   */\n  private manifest: TypingsManifest | null = null;\n\n  /**\n   * Cache for config type info and keys\n   */\n  private configCache = new Map<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >();\n\n  /**\n   * Generate all framework type definitions\n   *\n   * Uses manifest-based reconciliation:\n   * - If output files don't exist: full regeneration\n   * - If files exist: only regenerate changed configs\n   */\n  public async generateAll(): Promise<void> {\n    await this.ensureOutputDir();\n\n    const storageFile = join(this.outputDir, \"storage.d.ts\");\n    const configFile = join(this.outputDir, \"config.d.ts\");\n\n    const [manifestExists, storageExists, configExists] = await Promise.all([\n      this.exists(this.manifestPath),\n      this.exists(storageFile),\n      this.exists(configFile),\n    ]);\n\n    if (!manifestExists || !storageExists || !configExists) {\n      // Full regeneration (first run or files deleted)\n      await this.fullGeneration();\n    } else {\n      // Load manifest for hash comparison\n      await this.loadManifest();\n      // Reconciliation: only regenerate changed files\n      await this.reconcile();\n    }\n\n    await this.saveManifest();\n  }\n\n  /**\n   * Full regeneration of all type files\n   */\n  private async fullGeneration(): Promise<void> {\n    // Generate storage types\n    const storageConfigPath = await this.findConfigFile(\"storage\");\n    if (storageConfigPath) {\n      this.generateStorageTypes(storageConfigPath);\n    }\n\n    // Generate config types\n    await this.generateConfigTypes();\n  }\n\n  /**\n   * Reconcile: only regenerate changed files\n   */\n  private async reconcile(): Promise<void> {\n    const files = filesOrchestrator.getFiles();\n    let storageChanged = false;\n    let configChanged = false;\n    let unchangedCount = 0;\n\n    // Check storage config\n    for (const [path, fileManager] of files) {\n      if (path.startsWith(\"src/config/storage\")) {\n        const manifestEntry = this.manifest?.storage;\n        if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n          storageChanged = true;\n          await this.generateStorageTypes(path);\n        }\n        break;\n      }\n    }\n\n    // Check config files\n    for (const [path, fileManager] of files) {\n      if (!path.startsWith(\"src/config/\")) continue;\n      if (path.includes(\"index\")) continue;\n\n      // Extract config name (remove dir prefix and extension)\n      const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n      const manifestEntry = this.manifest?.config[configName];\n\n      if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n        // File changed or new - regenerate\n        configChanged = true;\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      } else {\n        // Unchanged - load from manifest\n        unchangedCount++;\n        this.configCache.set(configName, manifestEntry);\n      }\n    }\n\n    if (configChanged) {\n      await this.writeConfigTypesFromCache();\n    } else {\n      devLogInfo(`Config types unchanged (${unchangedCount} configs cached)`);\n    }\n  }\n\n  /**\n   * Generate storage driver name types\n   */\n  public async generateStorageTypes(configPath: string): Promise<void> {\n    try {\n      const driverKeys = await this.extractStorageDriverKeys(configPath);\n\n      if (driverKeys.length === 0) {\n        devServeLog(\"⚠️ No storage drivers found in config\");\n        return;\n      }\n\n      // Get file hash from filesOrchestrator\n      const fileManager = filesOrchestrator.getFiles().get(configPath);\n      const sourceHash = fileManager?.hash || \"\";\n\n      // Update manifest\n      if (!this.manifest) {\n        this.manifest = this.createEmptyManifest();\n      }\n      this.manifest.storage = {\n        sourceHash,\n        drivers: driverKeys,\n      };\n\n      const interfaceContent = driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join(\"\\n\");\n\n      const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Generated from: ${configPath}\n// Regenerates on dev-server start and when storage config changes\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface StorageDriverRegistry {\n${interfaceContent}\n  }\n}\n`;\n\n      const outputPath = join(this.outputDir, \"storage.d.ts\");\n      await writeFile(outputPath, content, \"utf-8\");\n\n      devLogSuccess(`Generated storage types: ${driverKeys.join(\", \")}`);\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate storage types: ${error}`);\n    }\n  }\n\n  /**\n   * Check if a file change should trigger type regeneration\n   */\n  public shouldRegenerateTypes(changedPath: string): boolean {\n    return changedPath.includes(\"src/config/\") || changedPath.includes(\"config/\");\n  }\n\n  /**\n   * Handle file change - uses incremental update via cache\n   */\n  public async handleFileChange(changedPath: string): Promise<void> {\n    if (!this.shouldRegenerateTypes(changedPath)) {\n      return;\n    }\n\n    // Regenerate storage types if storage config changed\n    if (changedPath.includes(\"config/storage\")) {\n      await this.generateStorageTypes(changedPath);\n      await this.saveManifest();\n      return;\n    }\n\n    // Extract config name from path\n    const match = changedPath.match(/config\\/([^/]+)\\.[^.]+$/);\n    if (!match) {\n      return;\n    }\n\n    const configName = match[1];\n    if (configName === \"index\") return;\n\n    devLogInfo(`Config changed: ${configName}, updating...`);\n\n    // Get file manager for hash\n    const fileManager = filesOrchestrator.getFiles().get(changedPath);\n    const sourceHash = fileManager?.hash || Date.now().toString();\n\n    // Update only the changed config in cache (use optimized combined extraction)\n    const configDir = join(process.cwd(), \"src/config\");\n    const configPath = join(configDir, `${configName}.ts`);\n\n    const info = await this.extractConfigInfo(configPath, configName);\n\n    this.configCache.set(configName, {\n      sourceHash,\n      typeName: info.typeName,\n      importSource: info.importSource,\n      keys: info.keys,\n    });\n\n    // Regenerate config.d.ts from cache\n    await this.writeConfigTypesFromCache();\n    await this.saveManifest();\n  }\n\n  /**\n   * Generate config types - populates cache and writes file\n   */\n  public async generateConfigTypes(): Promise<void> {\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      // Clear and repopulate cache\n      this.configCache.clear();\n\n      for (const [path, fileManager] of files) {\n        if (!path.startsWith(\"src/config/\")) continue;\n        if (path.includes(\"index\")) continue;\n\n        // Extract config name\n        const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n        // One parse per config, both extractions off it — see `read-config-ast.ts`.\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      }\n\n      await this.writeConfigTypesFromCache();\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate config types: ${error}`);\n    }\n  }\n\n  /**\n   * Quote an interface key that isn't a valid JS identifier (e.g. a config\n   * named `use-cases` or a storage driver `do-spaces`) so the generated\n   * `.d.ts` stays syntactically valid. Identifier-safe names are left bare\n   * to keep the output clean.\n   */\n  private toInterfaceKey(name: string): string {\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\n  }\n\n  /**\n   * Write config.d.ts from cached data\n   */\n  private async writeConfigTypesFromCache(): Promise<void> {\n    const configTypeInfos: Array<{\n      name: string;\n      typeName: string | null;\n      importSource: string | null;\n    }> = [];\n    const allKeys: string[] = [];\n\n    // Update manifest config section\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.config = {};\n\n    for (const [name, data] of this.configCache) {\n      configTypeInfos.push({\n        name,\n        typeName: data.typeName,\n        importSource: data.importSource,\n      });\n      allKeys.push(...data.keys);\n\n      // Store in manifest\n      this.manifest.config[name] = data;\n    }\n\n    // Group imports by source\n    const imports = new Map<string, Set<string>>();\n    for (const info of configTypeInfos) {\n      if (info.typeName && info.importSource) {\n        if (!imports.has(info.importSource)) {\n          imports.set(info.importSource, new Set());\n        }\n        imports.get(info.importSource)!.add(info.typeName);\n      }\n    }\n\n    const importStatements = Array.from(imports.entries())\n      .map(([source, types]) => `import type { ${Array.from(types).join(\", \")} } from \"${source}\";`)\n      .join(\"\\n\");\n\n    const configEntries = configTypeInfos\n      .map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.typeName || \"unknown\"};`)\n      .join(\"\\n\");\n\n    const keyEntries = allKeys.map((key) => `    \"${key}\": true;`).join(\"\\n\");\n\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Regenerates on dev-server start and when config files change\n\n${importStatements}\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ConfigRegistry {\n${configEntries}\n  }\n\n  interface ConfigKeyRegistry {\n${keyEntries}\n  }\n}\n`;\n\n    const outputPath = join(this.outputDir, \"config.d.ts\");\n    await writeFile(outputPath, content, \"utf-8\");\n\n    devLogSuccess(\n      `Generated config types: ${this.configCache.size} configs, ${allKeys.length} keys`,\n    );\n  }\n\n  // ============================================================\n  // Manifest Management\n  // ============================================================\n\n  /**\n   * Load manifest from disk\n   */\n  private async loadManifest(): Promise<boolean> {\n    try {\n      if (await this.exists(this.manifestPath)) {\n        const content = await readFile(this.manifestPath, \"utf-8\");\n        this.manifest = JSON.parse(content);\n        return true;\n      }\n    } catch {\n      // Manifest corrupted or missing\n    }\n    this.manifest = null;\n    return false;\n  }\n\n  /**\n   * Save manifest to disk\n   */\n  private async saveManifest(): Promise<void> {\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.lastBuildTime = Date.now();\n\n    await writeFile(this.manifestPath, JSON.stringify(this.manifest, null, 2), \"utf-8\");\n  }\n\n  /**\n   * Create empty manifest structure\n   */\n  private createEmptyManifest(): TypingsManifest {\n    return {\n      version: \"1.0.0\",\n      lastBuildTime: Date.now(),\n      storage: null,\n      config: {},\n    };\n  }\n\n  // ============================================================\n  // Type Extraction Methods\n  // ============================================================\n\n  /**\n   * Extract BOTH type info AND keys in a single pass\n   *\n   * One parse serves both extractions. It used to be one whole TypeScript\n   * Program per file — halved from two by an earlier pass, which optimised\n   * inside a premise that did not need to hold. `read-config-ast.ts` has the\n   * numbers.\n   *\n   * @param configPath Absolute path to the config file\n   * @param configName Config name (e.g., \"auth\", \"notifications\")\n   * @returns Combined result with type info and keys\n   */\n  private async extractConfigInfo(\n    configPath: string,\n    configName: string,\n  ): Promise<{\n    typeName: string | null;\n    importSource: string | null;\n    keys: string[];\n  }> {\n    if (!(await this.exists(configPath))) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // Parse, do not resolve — `read-config-ast.ts` explains why, with numbers.\n    const sourceFile = await readConfigAst(configPath);\n\n    if (!sourceFile) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // === Type Info Extraction ===\n    const importedTypes = new Map<string, string>();\n    const localExportedTypes = new Set<string>();\n    let foundTypeName: string | null = null;\n\n    // === Keys Extraction ===\n    const keys: string[] = [];\n\n    const visitForTypes = (node: ts.Node): void => {\n      // Collect imported types\n      if (ts.isImportDeclaration(node)) {\n        const moduleSpecifier = node.moduleSpecifier;\n        if (ts.isStringLiteral(moduleSpecifier)) {\n          const source = moduleSpecifier.text;\n          const importClause = node.importClause;\n          if (importClause?.namedBindings && ts.isNamedImports(importClause.namedBindings)) {\n            for (const element of importClause.namedBindings.elements) {\n              importedTypes.set(element.name.text, source);\n            }\n          }\n        }\n      }\n\n      // Collect locally exported types\n      if (ts.isTypeAliasDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Collect locally exported interfaces\n      if (ts.isInterfaceDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Find type used on config variable + extract keys\n      if (ts.isVariableDeclaration(node)) {\n        // Type info\n        if (node.type && ts.isTypeReferenceNode(node.type)) {\n          foundTypeName = node.type.typeName.getText(sourceFile);\n        }\n\n        // Keys extraction\n        if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\n          const visitKeys = (objNode: ts.ObjectLiteralExpression, prefix: string): void => {\n            for (const prop of objNode.properties) {\n              if (ts.isPropertyAssignment(prop) && prop.name) {\n                const keyName = prop.name.getText(sourceFile);\n                const fullKey = prefix ? `${prefix}.${keyName}` : keyName;\n                keys.push(fullKey);\n                if (ts.isObjectLiteralExpression(prop.initializer)) {\n                  visitKeys(prop.initializer, fullKey);\n                }\n              }\n            }\n          };\n          visitKeys(node.initializer, configName);\n        }\n      }\n\n      ts.forEachChild(node, visitForTypes);\n    };\n\n    ts.forEachChild(sourceFile, visitForTypes);\n\n    // Resolve type info\n    let typeName: string | null = null;\n    let importSource: string | null = null;\n\n    if (foundTypeName) {\n      if (importedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        importSource = importedTypes.get(foundTypeName)!;\n      } else if (localExportedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        const relativePath = Path.toRelative(configPath).replace(/\\.(ts|tsx)$/, \"\");\n        importSource = `../../${relativePath}`;\n      }\n    }\n\n    return { typeName, importSource, keys };\n  }\n\n  /**\n   * Extract driver keys from storage config\n   */\n  private async extractStorageDriverKeys(configPath: string): Promise<string[]> {\n    const absolutePath = resolve(configPath);\n\n    if (!(await this.exists(absolutePath))) {\n      devServeLog(`⚠️ Storage config not found: ${absolutePath}`);\n      return [];\n    }\n\n    const sourceFile = await readConfigAst(absolutePath);\n\n    if (!sourceFile) {\n      devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);\n      return [];\n    }\n\n    const keys: string[] = [];\n\n    const visit = (node: ts.Node): void => {\n      if (ts.isPropertyAssignment(node)) {\n        const propName = node.name.getText(sourceFile);\n\n        if (propName === \"drivers\" && ts.isObjectLiteralExpression(node.initializer)) {\n          for (const prop of node.initializer.properties) {\n            if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {\n              const keyName = prop.name?.getText(sourceFile);\n\n              if (keyName) {\n                keys.push(keyName);\n              }\n            }\n          }\n        }\n      }\n\n      ts.forEachChild(node, visit);\n    };\n\n    ts.forEachChild(sourceFile, visit);\n\n    return keys;\n  }\n\n  /**\n   * Find a config file by name\n   */\n  private async findConfigFile(configName: string): Promise<string | undefined> {\n    const possiblePaths = [`src/config/${configName}.ts`, `config/${configName}.ts`];\n\n    for (const path of possiblePaths) {\n      const fullPath = join(process.cwd(), path);\n\n      if (await this.exists(fullPath)) {\n        return path;\n      }\n    }\n\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      for (const [filePath] of files) {\n        if (filePath.includes(`config/${configName}`)) {\n          return filePath;\n        }\n      }\n    } catch {\n      // Files orchestrator not initialized yet\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Ensure output directory exists\n   */\n  private async ensureOutputDir(): Promise<void> {\n    await ensureDirectoryAsync(this.outputDir);\n  }\n\n  /**\n   * Check if a path exists (async wrapper)\n   */\n  private async exists(path: string): Promise<boolean> {\n    try {\n      await access(path, constants.F_OK);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * The ports `runTypingsGeneration` needs, bound to this instance and this\n   * package's dev logger.\n   */\n  private get typingsGenerationPorts(): TypingsGenerationPorts {\n    return {\n      generate: () => this.generateAll(),\n      info: (message) => devLogInfo(message),\n      success: (message) => devLogSuccess(message),\n      error: (message) => devLogError(message),\n    };\n  }\n\n  /**\n   * Generate every config's typings.\n   *\n   * Runs IN THIS PROCESS. It used to spawn `npx warlock generate.typings`,\n   * which could not resolve in a source checkout — see\n   * `run-typings-generation.ts` for the whole story.\n   */\n  public async executeGenerateAllCommand(): Promise<void> {\n    await runTypingsGeneration(this.typingsGenerationPorts);\n  }\n\n  /**\n   * Regenerate typings after a batch reload — but only when the batch actually\n   * touched a config file, since nothing else contributes to them.\n   */\n  public async executeTypingsGenerator(upcomingFiles: string[]): Promise<void> {\n    const touchedAConfig = Array.from(new Set(upcomingFiles)).some((file) =>\n      Path.normalize(file).includes(\"src/config/\"),\n    );\n\n    if (!touchedAConfig) return;\n\n    /*\n      The changed paths are deliberately NOT passed along. The previous version\n      built a `files` array here and then threw it away, spawning the same\n      whole-project command as the branch above — so \"incremental\" was a name,\n      not a behaviour. `generateAll()` reads the orchestrator, which the batch\n      reload has already updated, so the full pass is both correct and the only\n      pass that ever actually ran.\n    */\n    await runTypingsGeneration(this.typingsGenerationPorts);\n  }\n}\n\n/**\n * Singleton instance for use throughout dev-server\n */\nexport const typeGenerator = new TypeGenerator();\n"],"mappings":"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"}

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

@@ -2,7 +2,7 @@ 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 } from "./stubs.mjs";
+import { accessConfigStub, accessResolverStub, accessRoleMigrationStub, accessRoleModelIndexStub, accessRoleModelStub, accessUserRoleMigrationStub, accessUserRoleModelIndexStub, accessUserRoleModelStub, aiConfigStub, communicatorsConfigStub, notificationControllersStub, notificationMigrationStub, notificationModelStub, notificationRoutesStub, notificationsConfigStub, socketConfigStub, webHomePageStub, webRootStub } from "./stubs.mjs";
 import { colors } from "@mongez/copper";
 import { ensureDirectoryAsync, fileExistsAsync, getFileAsync, getJsonFileAsync, putFileAsync, putJsonFileAsync } from "@warlock.js/fs";
 import { execSync } from "node:child_process";
@@ -206,6 +206,159 @@ async function scaffoldAccessFiles() {
 	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();
@@ -319,6 +472,21 @@ const featuresMap = {
 			"@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: {

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

@@ -1 +1 @@
-{"version":3,"file":"add-command.action.mjs","names":[],"sources":["../../../../../../../core/src/generations/add-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  ensureDirectoryAsync,\r\n  fileExistsAsync,\r\n  getFileAsync,\r\n  getJsonFileAsync,\r\n  putFileAsync,\r\n  putJsonFileAsync,\r\n} from \"@warlock.js/fs\";\r\nimport { execSync } from \"node:child_process\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport {\r\n  detectPackageManager,\r\n  getAddCommand,\r\n  type PackageManager,\r\n} from \"../updater/package-manager\";\r\nimport { rootPath, srcPath } from \"../utils\";\r\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\r\nimport {\r\n  accessConfigStub,\r\n  aiConfigStub,\r\n  accessResolverStub,\r\n  accessRoleMigrationStub,\r\n  accessRoleModelIndexStub,\r\n  accessRoleModelStub,\r\n  accessUserRoleMigrationStub,\r\n  accessUserRoleModelIndexStub,\r\n  accessUserRoleModelStub,\r\n  communicatorsConfigStub,\r\n  notificationControllersStub,\r\n  notificationMigrationStub,\r\n  notificationModelStub,\r\n  notificationRoutesStub,\r\n  notificationsConfigStub,\r\n  socketConfigStub,\r\n} from \"./stubs\";\r\n\r\n/**\r\n * The parts of a project `package.json` this action reads or writes. Deliberately\r\n * partial — it describes what we touch, not the whole manifest.\r\n */\r\ntype ProjectPackageJson = {\r\n  dependencies?: Record<string, string>;\r\n  devDependencies?: Record<string, string>;\r\n  scripts?: Record<string, string>;\r\n};\r\n\r\n/**\r\n * The part of a project `tsconfig.json` this action patches.\r\n */\r\ntype ProjectTsConfig = {\r\n  include?: string[];\r\n};\r\n\r\n/**\r\n * Build a migration filename timestamp prefix in the framework's\r\n * MM-DD-YYYY_HH-MM-SS form. Cascade infers a migration's createdAt from this\r\n * prefix and orders migrations deterministically by it. Pass `offsetSeconds` to\r\n * stamp sibling migrations created in the same scaffold a second apart so they\r\n * never collide and keep a stable relative order.\r\n */\r\nfunction migrationTimestamp(offsetSeconds = 0): string {\r\n  const now = new Date(Date.now() + offsetSeconds * 1000);\r\n  const pad = (value: number) => String(value).padStart(2, \"0\");\r\n\r\n  return (\r\n    `${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${now.getFullYear()}_` +\r\n    `${pad(now.getHours())}-${pad(now.getMinutes())}-${pad(now.getSeconds())}`\r\n  );\r\n}\r\n\r\nasync function completeTestInstallation(options: CommandActionData) {\r\n  // Create test-global-setup.ts (runs once before all tests)\r\n  const testGlobalSetupPath = srcPath(\"test-global-setup.ts\");\r\n  const testGlobalSetupExists = await fileExistsAsync(testGlobalSetupPath);\r\n\r\n  if (!testGlobalSetupExists) {\r\n    await putFileAsync(\r\n      testGlobalSetupPath,\r\n      `/**\r\n * Global Test Setup\r\n *\r\n * Runs ONCE before all test workers.\r\n * Starts the HTTP server for integration tests.\r\n */\r\nimport { startHttpTestServer, stopHttpTestServer } from \"@warlock.js/core/tests\";\r\n\r\nexport async function setup() {\r\n  await startHttpTestServer();\r\n}\r\n\r\nexport async function teardown() {\r\n  await stopHttpTestServer();\r\n}\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created src/test-global-setup.ts`);\r\n  }\r\n\r\n  // Create test-setup.ts (runs before EVERY test file)\r\n  const testSetupPath = srcPath(\"test-setup.ts\");\r\n  const testSetupExists = await fileExistsAsync(testSetupPath);\r\n\r\n  if (!testSetupExists) {\r\n    await putFileAsync(\r\n      testSetupPath,\r\n      `/**\r\n * Test Setup - runs before EVERY test file\r\n *\r\n * Vitest runs setupFiles before each test file and rebuilds the module\r\n * registry with it, so this pair boots and closes the test runtime once per\r\n * test file.\r\n *\r\n * setupTest() is called with no options on purpose: an explicit connectors\r\n * value outranks tests.connectors from src/config/tests.ts, so passing one\r\n * here would erase your project config. Omitting it leaves the config in\r\n * charge.\r\n *\r\n * afterAll(teardownTest) is the other half of the pair: whoever calls\r\n * setupTest() owns closing it in the same runtime context.\r\n */\r\nimport { setupTest, teardownTest } from \"@warlock.js/core/tests\";\r\nimport { afterAll } from \"vitest\";\r\n\r\nawait setupTest();\r\n\r\nafterAll(teardownTest);\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created src/test-setup.ts`);\r\n  }\r\n\r\n  // Create vite.config.ts\r\n  const viteConfigPath = rootPath(\"vite.config.ts\");\r\n  const viteConfigExists = await fileExistsAsync(viteConfigPath);\r\n\r\n  if (!viteConfigExists) {\r\n    await putFileAsync(\r\n      viteConfigPath,\r\n      `import { lowerStage3Decorators } from \"@warlock.js/core/vite\";\r\nimport mongezVite from \"@mongez/vite\";\r\nimport { defineConfig } from \"vitest/config\";\r\n\r\nexport default defineConfig({\r\n  // lowerStage3Decorators MUST come first: it lowers native (@RegisterModel, …)\r\n  // decorators with esbuild before oxc / the SSR rewrite can mangle them, so\r\n  // decorated Cascade models load under Vitest.\r\n  plugins: [lowerStage3Decorators(), mongezVite()],\r\n  test: {\r\n    globalSetup: \"./src/test-global-setup.ts\", // HTTP server - runs once\r\n    setupFiles: [\"./src/test-setup.ts\"],       // DB/cache - runs per test file\r\n    environment: \"node\",\r\n    globals: false,\r\n    include: [\"src/app/**/*.test.ts\"],\r\n  },\r\n});\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created vite.config.ts`);\r\n  }\r\n}\r\n\r\nasync function completeReactEmailInstallation(_options: CommandActionData) {\r\n  // 1. Create emails/ folder with a sample component\r\n  const emailsFolderPath = rootPath(\"emails\");\r\n  const sampleEmailPath = rootPath(\"emails/welcome-email.tsx\");\r\n\r\n  if (!(await fileExistsAsync(sampleEmailPath))) {\r\n    await ensureDirectoryAsync(emailsFolderPath);\r\n    await putFileAsync(\r\n      sampleEmailPath,\r\n      `import { Body, Container, Head, Html, Text } from \"@react-email/components\";\r\nimport { Tailwind } from \"@react-email/tailwind\";\r\n\r\ninterface WelcomeEmailProps {\r\n  name: string;\r\n}\r\n\r\n/**\r\n * Sample welcome email component.\r\n * Preview with: yarn email:preview\r\n */\r\nexport default function WelcomeEmail({ name }: WelcomeEmailProps) {\r\n  return (\r\n    <Html>\r\n      <Head />\r\n      <Tailwind>\r\n        <Body className=\"bg-gray-100 font-sans\">\r\n          <Container className=\"mx-auto max-w-xl py-8 px-4\">\r\n            <Text className=\"text-2xl font-bold text-gray-900\">\r\n              Welcome, {name}!\r\n            </Text>\r\n            <Text className=\"text-gray-600 mt-2\">\r\n              You're all set. We're glad to have you on board.\r\n            </Text>\r\n          </Container>\r\n        </Body>\r\n      </Tailwind>\r\n    </Html>\r\n  );\r\n}\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created emails/welcome-email.tsx`);\r\n  }\r\n\r\n  // 2. Patch tsconfig.json — add \"emails\" to include if missing\r\n  const tsconfigPath = rootPath(\"tsconfig.json\");\r\n  const tsconfig = await getJsonFileAsync<ProjectTsConfig>(tsconfigPath);\r\n\r\n  if (!tsconfig.include) {\r\n    tsconfig.include = [];\r\n  }\r\n\r\n  if (!tsconfig.include.includes(\"emails\")) {\r\n    tsconfig.include.push(\"emails\");\r\n    await putJsonFileAsync(tsconfigPath, tsconfig);\r\n    console.log(`${colors.green(\"✓\")} Added \"emails\" to tsconfig.json include`);\r\n  }\r\n}\r\n\r\nasync function completeNotificationsInstallation(_options: CommandActionData) {\r\n  const modelPath = srcPath(\"app/notifications/notification.model.ts\");\r\n\r\n  // The model file is the sentinel for \"notifications already scaffolded\" —\r\n  // its presence means the migration was created too (timestamped, so we must\r\n  // not re-emit a duplicate on a second run).\r\n  if (await fileExistsAsync(modelPath)) {\r\n    console.log(\r\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping model + migration...`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  // 1. Notification model — extends the package's DatabaseNotification base.\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications\"));\r\n  await putFileAsync(modelPath, notificationModelStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/notification.model.ts`);\r\n\r\n  // 2. Migration — timestamped MM-DD-YYYY_HH-MM-SS prefix so cascade infers its\r\n  //    createdAt and orders it deterministically (migrate-action discovers\r\n  //    src/app/*/migrations/*).\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications/migrations\"));\r\n\r\n  const migrationFile = `${migrationTimestamp()}-notification.migration.ts`;\r\n\r\n  await putFileAsync(\r\n    srcPath(\"app/notifications/migrations\", migrationFile),\r\n    notificationMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/notifications/migrations/${migrationFile}`,\r\n  );\r\n\r\n  // 3. HTTP surface — the in-app read/dismiss endpoints (routes + controllers),\r\n  //    gated by authMiddleware. Delete if the app exposes notifications another way.\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications/controllers\"));\r\n  await putFileAsync(\r\n    srcPath(\"app/notifications/controllers/notifications.controller.ts\"),\r\n    notificationControllersStub,\r\n  );\r\n  await putFileAsync(srcPath(\"app/notifications/routes.ts\"), notificationRoutesStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/routes.ts + controllers`);\r\n}\r\n\r\nasync function registerAccessLocale() {\r\n  // Register the access locale in the project's shared translations file so a\r\n  // denied check returns a real sentence, not the raw \"access.errors.forbidden\"\r\n  // key. Append when the file exists, create it otherwise; skip if already there.\r\n  const localesPath = srcPath(\"app/shared/utils/locales.ts\");\r\n\r\n  const accessLocale = `groupedTranslations(\"access\", {\r\n  errors: {\r\n    forbidden: {\r\n      en: \"You do not have permission to perform this action.\",\r\n      ar: \"ليس لديك صلاحية لتنفيذ هذا الإجراء.\",\r\n    },\r\n  },\r\n});\r\n`;\r\n\r\n  if (await fileExistsAsync(localesPath)) {\r\n    const current = await getFileAsync(localesPath);\r\n\r\n    if (current.includes(`groupedTranslations(\"access\"`)) {\r\n      console.log(`${colors.yellowBright(\"access\")} locale already registered, skipping...`);\r\n\r\n      return;\r\n    }\r\n\r\n    // The file uses groupedTranslations already iff it calls it — only inject the\r\n    // import when no call is present yet.\r\n    const importLine = `import { groupedTranslations } from \"@warlock.js/core\";`;\r\n    const prefix = current.includes(\"groupedTranslations(\") ? \"\" : `${importLine}\\n\\n`;\r\n\r\n    await putFileAsync(localesPath, `${prefix}${current.trimEnd()}\\n\\n${accessLocale}`);\r\n\r\n    console.log(\r\n      `${colors.green(\"✓\")} Registered the access locale in src/app/shared/utils/locales.ts`,\r\n    );\r\n\r\n    return;\r\n  }\r\n\r\n  await ensureDirectoryAsync(srcPath(\"app/shared/utils\"));\r\n\r\n  await putFileAsync(\r\n    localesPath,\r\n    `import { groupedTranslations } from \"@warlock.js/core\";\\n\\n${accessLocale}`,\r\n  );\r\n\r\n  console.log(`${colors.green(\"✓\")} Created src/app/shared/utils/locales.ts with the access locale`);\r\n}\r\n\r\nasync function scaffoldAccessFiles() {\r\n  // The resolver file is the sentinel for \"access already scaffolded\" — its\r\n  // presence means the role/user-role model folders and their timestamped\r\n  // migrations were created too, so we must not re-emit duplicate migrations on\r\n  // a second run.\r\n  const resolverPath = srcPath(\"app/access/services/access-resolver.ts\");\r\n\r\n  if (await fileExistsAsync(resolverPath)) {\r\n    console.log(\r\n      `${colors.yellowBright(\"src/app/access\")} already scaffolded, skipping resolver + role tables...`,\r\n    );\r\n\r\n    return;\r\n  }\r\n\r\n  // 1. Role catalog model folder (model + barrel + migration). The catalog row\r\n  //    is role name → granted permissions; managed at runtime in the DB.\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/role\"));\r\n  await putFileAsync(srcPath(\"app/access/models/role/role.model.ts\"), accessRoleModelStub);\r\n  await putFileAsync(srcPath(\"app/access/models/role/index.ts\"), accessRoleModelIndexStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/access/models/role`);\r\n\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/role/migrations\"));\r\n\r\n  // Migration filenames carry a MM-DD-YYYY_HH-MM-SS prefix so cascade infers\r\n  // their createdAt and orders them deterministically (the migrate action\r\n  // discovers src/app/*/models/*/migrations/*). The two tables are independent\r\n  // (no FK between them), but the user-role migration is stamped a second later\r\n  // so the relative order is stable.\r\n  const roleMigrationFile = `${migrationTimestamp()}-role.migration.ts`;\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/role/migrations\", roleMigrationFile),\r\n    accessRoleMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/access/models/role/migrations/${roleMigrationFile}`,\r\n  );\r\n\r\n  // 2. UserRole assignment model folder (model + barrel + migration). The model\r\n  //    statics scope an unresolved tenant to GLOBAL rows only (security\r\n  //    invariant) — see the stub for the reasoning.\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/user-role\"));\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/user-role/user-role.model.ts\"),\r\n    accessUserRoleModelStub,\r\n  );\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/user-role/index.ts\"),\r\n    accessUserRoleModelIndexStub,\r\n  );\r\n  console.log(`${colors.green(\"✓\")} Created src/app/access/models/user-role`);\r\n\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/user-role/migrations\"));\r\n\r\n  const userRoleMigrationFile = `${migrationTimestamp(1)}-user-role.migration.ts`;\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/user-role/migrations\", userRoleMigrationFile),\r\n    accessUserRoleMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/access/models/user-role/migrations/${userRoleMigrationFile}`,\r\n  );\r\n\r\n  // 3. The DatabaseAccessResolver — the one required config seam, wired into\r\n  //    config/access.ts by the ejected stub.\r\n  await ensureDirectoryAsync(srcPath(\"app/access/services\"));\r\n  await putFileAsync(resolverPath, accessResolverStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/access/services/access-resolver.ts`);\r\n}\r\n\r\nasync function completeAccessInstallation(_options: CommandActionData) {\r\n  await registerAccessLocale();\r\n  await scaffoldAccessFiles();\r\n}\r\n\r\n/**\r\n * Link a satellite AI package into src/config/ai.ts via a side-effect import.\r\n *\r\n * The satellites (@warlock.js/ai-tools, ai-panoptic, ai-workspace) augment the\r\n * `ai` object on import — they register their runtime surface (ai.tools / ai.mcp,\r\n * ai.workspace, panoptic's ai.config({ panoptic }) wiring) AND the matching TS\r\n * declaration-merging so ai.* members resolve. config-loader runs config/ai.ts at\r\n * boot, so dropping a bare `import \"<specifier>\";` at the top of that file is what\r\n * actually loads the augmentation before the ai connector applies the config.\r\n *\r\n * No-op if config/ai.ts is missing (the `ai` feature ejects it) or the import is\r\n * already present. Inserts right after the `warlock:ai-packages` marker when it\r\n * exists so the satellite imports stay grouped; otherwise prepends to the top.\r\n */\r\nasync function linkAiPackageImport(specifier: string): Promise<void> {\r\n  const aiConfigPath = srcPath(\"config/ai.ts\");\r\n\r\n  if (!(await fileExistsAsync(aiConfigPath))) {\r\n    return;\r\n  }\r\n\r\n  const current = await getFileAsync(aiConfigPath);\r\n  const importLine = `import \"${specifier}\";`;\r\n\r\n  if (current.includes(importLine)) {\r\n    return;\r\n  }\r\n\r\n  const marker = \"// >>> warlock:ai-packages (auto-managed) >>>\";\r\n  let next: string;\r\n\r\n  if (current.includes(marker)) {\r\n    next = current.replace(marker, `${marker}\\n${importLine}`);\r\n  } else {\r\n    next = `${importLine}\\n${current}`;\r\n  }\r\n\r\n  await putFileAsync(aiConfigPath, next);\r\n\r\n  console.log(`${colors.green(\"✓\")} Linked ${specifier} in src/config/ai.ts`);\r\n}\r\n\r\nexport const featuresMap: Record<\r\n  string,\r\n  {\r\n    dependencies?: Record<string, string>;\r\n    devDependencies?: Record<string, string>;\r\n    description: string;\r\n    requires?: string[];\r\n    script?: Record<string, string>;\r\n    onExecuting?: (options: CommandActionData) => Promise<any>;\r\n    ejectConfig?: {\r\n      content: string;\r\n      name: string;\r\n    };\r\n  }\r\n> = {\r\n  \"react-email\": {\r\n    description: \"Installs react-email for building email templates with React and Tailwind\",\r\n    requires: [\"mail\", \"react\"],\r\n    dependencies: {\r\n      \"react-email\": \"^5.2.10\",\r\n      \"@react-email/components\": \"^1.0.11\",\r\n      \"@react-email/render\": \"^2.0.5\",\r\n      \"@react-email/tailwind\": \"^2.0.7\",\r\n    },\r\n    devDependencies: {\r\n      \"@react-email/preview-server\": \"5.2.10\",\r\n    },\r\n    script: {\r\n      \"email:preview\": \"npx react-email dev\",\r\n    },\r\n    onExecuting: completeReactEmailInstallation,\r\n  },\r\n  react: {\r\n    description:\r\n      \"Installs React and React dom for rendering React components (non-interactive), useful for sending mails and generating HTML\",\r\n    dependencies: {\r\n      react: \"^19.2.3\",\r\n      \"react-dom\": \"^19.2.3\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/react\": \"^19.2.7\",\r\n      \"@types/react-dom\": \"^19.2.3\",\r\n    },\r\n  },\r\n  image: {\r\n    description: \"Installs sharp for image processing\",\r\n    dependencies: {\r\n      sharp: \"^0.34.5\",\r\n    },\r\n  },\r\n  mail: {\r\n    description: \"Installs nodemailer for sending emails\",\r\n    dependencies: {\r\n      nodemailer: \"^8.0.5\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/nodemailer\": \"^8.0.0\",\r\n    },\r\n  },\r\n  ses: {\r\n    description: \"Installs AWS SES SDK for sending emails via Amazon SES\",\r\n    dependencies: {\r\n      \"@aws-sdk/client-sesv2\": \"^3.1025.0\",\r\n    },\r\n  },\r\n  mongodb: {\r\n    description: \"Installs mongodb driver for database driver (Cascade Package)\",\r\n    dependencies: {\r\n      mongodb: \"^7.0.0\",\r\n    },\r\n  },\r\n  scheduler: {\r\n    description: \"Installs warlock scheduler for scheduling tasks\",\r\n    dependencies: {\r\n      \"@warlock.js/scheduler\": \"~4.0.0\",\r\n    },\r\n  },\r\n  // swagger / postman intentionally omitted — those packages do not exist yet;\r\n  // they will ship together in the unified @warlock.js/api-docs package.\r\n  postgres: {\r\n    description: \"Installs pg for Postgres database (Cascade Package)\",\r\n    dependencies: {\r\n      pg: \"^8.11.0\",\r\n    },\r\n  },\r\n  mysql: {\r\n    description: \"Installs mysql2 for MySQL database driver (Cascade Package)\",\r\n    dependencies: {\r\n      mysql2: \"^3.5.0\",\r\n    },\r\n  },\r\n  redis: {\r\n    description: \"Installs redis for Redis cache driver (Cache Package)\",\r\n    dependencies: {\r\n      redis: \"^4.6.13\",\r\n    },\r\n  },\r\n  s3: {\r\n    description: \"Installs AWS SDK for Cloud storage (Storage Package)\",\r\n    dependencies: {\r\n      \"@aws-sdk/client-s3\": \"^3.955.0\",\r\n      \"@aws-sdk/lib-storage\": \"^3.955.0\",\r\n      \"@aws-sdk/s3-request-presigner\": \"^3.955.0\",\r\n    },\r\n  },\r\n  test: {\r\n    description: \"Installs warlock test for testing\",\r\n    onExecuting: completeTestInstallation,\r\n    script: {\r\n      test: \"vitest run\",\r\n      \"test:coverage\": \"vitest run --coverage\",\r\n      \"test:ui\": \"vitest --ui\",\r\n      \"test:watch\": \"vitest --watch\",\r\n    },\r\n    devDependencies: {\r\n      \"@mongez/vite\": \"^2.0.4\",\r\n      vite: \"^8.0.16\",\r\n      vitest: \"^4.1.8\",\r\n      \"@vitest/coverage-v8\": \"^4.1.8\",\r\n    },\r\n  },\r\n  herald: {\r\n    description: \"Installs herald for message broker (Herald Package)\",\r\n    dependencies: {\r\n      \"@warlock.js/herald\": \"~4.0.0\",\r\n      amqplib: \"^0.10.0\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/amqplib\": \"^0.10.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: communicatorsConfigStub,\r\n      name: \"herald\",\r\n    },\r\n  },\r\n  socket: {\r\n    description: \"Installs socket.io for the realtime socket server (Socket Connector)\",\r\n    dependencies: {\r\n      \"socket.io\": \"^4.8.3\",\r\n    },\r\n    ejectConfig: {\r\n      content: socketConfigStub,\r\n      name: \"socket\",\r\n    },\r\n  },\r\n  notifications: {\r\n    description:\r\n      \"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\",\r\n    // The ejected config wires a `mail` channel by default (needs nodemailer,\r\n    // via the `mail` feature); the scaffolded routes are gated by\r\n    // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\r\n    requires: [\"mail\"],\r\n    dependencies: {\r\n      \"@warlock.js/notifications\": \"~4.0.0\",\r\n      \"@warlock.js/auth\": \"~4.0.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: notificationsConfigStub,\r\n      name: \"notifications\",\r\n    },\r\n    onExecuting: completeNotificationsInstallation,\r\n  },\r\n  access: {\r\n    description:\r\n      \"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\",\r\n    dependencies: {\r\n      \"@warlock.js/access\": \"~4.0.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: accessConfigStub,\r\n      name: \"access\",\r\n    },\r\n    onExecuting: completeAccessInstallation,\r\n  },\r\n  ai: {\r\n    description: \"Installs @warlock.js/ai — the core AI toolkit (agents, tools, workflows)\",\r\n    dependencies: {\r\n      \"@warlock.js/ai\": \"~4.0.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: aiConfigStub,\r\n      name: \"ai\",\r\n    },\r\n  },\r\n  \"ai-openai\": {\r\n    description: \"OpenAI provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-openai\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-google\": {\r\n    description: \"Google (Gemini) provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-google\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-anthropic\": {\r\n    description: \"Anthropic (Claude) provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-anthropic\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-bedrock\": {\r\n    description: \"AWS Bedrock provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-bedrock\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-ollama\": {\r\n    description: \"Ollama provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-ollama\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-tools\": {\r\n    description:\r\n      \"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)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-tools\": \"~4.0.0\",\r\n    },\r\n    onExecuting: () => linkAiPackageImport(\"@warlock.js/ai-tools\"),\r\n  },\r\n  \"ai-panoptic\": {\r\n    description:\r\n      \"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)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-panoptic\": \"~4.0.0\",\r\n    },\r\n    onExecuting: () => linkAiPackageImport(\"@warlock.js/ai-panoptic\"),\r\n  },\r\n  \"ai-workspace\": {\r\n    description:\r\n      \"Installs @warlock.js/ai-workspace — a policy-jailed filesystem + shell workspace for coding agents, as ai.workspace (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-workspace\": \"~4.0.0\",\r\n    },\r\n    onExecuting: () => linkAiPackageImport(\"@warlock.js/ai-workspace\"),\r\n  },\r\n};\r\n\r\nexport const allowedFeatures = Object.keys(featuresMap);\r\n\r\nfunction resolveFeatures(features: string[], visited = new Set<string>()): string[] {\r\n  const resolved: string[] = [];\r\n\r\n  for (const feature of features) {\r\n    if (visited.has(feature)) continue;\r\n    visited.add(feature);\r\n\r\n    const def = featuresMap[feature];\r\n\r\n    if (def.requires?.length) {\r\n      resolved.push(...resolveFeatures(def.requires, visited));\r\n    }\r\n\r\n    resolved.push(feature);\r\n  }\r\n\r\n  return resolved;\r\n}\r\n\r\nexport async function addCommandAction(options: CommandActionData) {\r\n  const features = options.args;\r\n  const { packageManager, list, noInstall } = options.options;\r\n\r\n  if (list) {\r\n    console.log(\"Available Features:\");\r\n\r\n    for (const feature of allowedFeatures) {\r\n      console.log(\r\n        `- ${colors.yellowBright(feature)}: ${colors.green(featuresMap[feature].description)}`,\r\n      );\r\n    }\r\n\r\n    process.exit(0);\r\n  }\r\n\r\n  validateFeatures(features);\r\n\r\n  const resolvedFeatures = resolveFeatures(features);\r\n\r\n  const dependencies: Record<string, string> = {};\r\n  const devDependencies: Record<string, string> = {};\r\n  const ejectConfigs: Record<string, { content: string; name: string }> = {};\r\n  const scripts: Record<string, string> = {};\r\n\r\n  for (const feature of resolvedFeatures) {\r\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\r\n    Object.assign(dependencies, featurePackages.dependencies);\r\n    if (featurePackages.devDependencies) {\r\n      Object.assign(devDependencies, featurePackages.devDependencies);\r\n    }\r\n\r\n    if (featurePackages.ejectConfig) {\r\n      ejectConfigs[featurePackages.ejectConfig.name] = featurePackages.ejectConfig;\r\n    }\r\n\r\n    if (featurePackages.script) {\r\n      Object.assign(scripts, featurePackages.script);\r\n    }\r\n  }\r\n\r\n  // Pin every @warlock.js/* feature package to the INSTALLED framework version so\r\n  // a scaffolded project's features match its core version instead of drifting to\r\n  // the feature map's static range.\r\n  const frameworkVersion = await getWarlockVersion();\r\n  for (const dependency of Object.keys(dependencies)) {\r\n    if (dependency.startsWith(\"@warlock.js/\")) {\r\n      dependencies[dependency] = frameworkVersion;\r\n    }\r\n  }\r\n\r\n  const currentPackageJson = await getJsonFileAsync<ProjectPackageJson>(rootPath(\"package.json\"));\r\n\r\n  // Fresh templates may omit one of the maps — guard before reading.\r\n  currentPackageJson.dependencies = currentPackageJson.dependencies ?? {};\r\n  currentPackageJson.devDependencies = currentPackageJson.devDependencies ?? {};\r\n\r\n  // Skip anything already present so we never downgrade an existing pin.\r\n  for (const dependency of Object.keys(dependencies)) {\r\n    if (currentPackageJson.dependencies[dependency]) {\r\n      console.log(`${colors.yellowBright(dependency)} is already installed, skipping...`);\r\n      delete dependencies[dependency];\r\n    }\r\n  }\r\n\r\n  for (const devDependency of Object.keys(devDependencies)) {\r\n    if (currentPackageJson.devDependencies[devDependency]) {\r\n      console.log(`${colors.yellowBright(devDependency)} is already installed, skipping...`);\r\n      delete devDependencies[devDependency];\r\n    }\r\n  }\r\n\r\n  if (noInstall) {\r\n    await recordDependencies(dependencies, devDependencies);\r\n  } else {\r\n    await installDependencies(packageManager as PackageManager | undefined, dependencies, devDependencies);\r\n  }\r\n\r\n  for (const [name, config] of Object.entries(ejectConfigs)) {\r\n    if (await fileExistsAsync(srcPath(`config/${name}.ts`))) {\r\n      console.log(`${colors.yellowBright(name)} config already exists, skipping...`);\r\n      continue;\r\n    }\r\n\r\n    console.log(`Creating ${colors.magenta(name)} config...`);\r\n\r\n    await putFileAsync(srcPath(`config/${name}.ts`), config.content);\r\n\r\n    console.log(`${colors.green(name)} config created successfully`);\r\n  }\r\n\r\n  // now loop again over features to execute onExecuting\r\n  for (const feature of resolvedFeatures) {\r\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\r\n    if (featurePackages.onExecuting) {\r\n      await featurePackages.onExecuting(options);\r\n    }\r\n  }\r\n\r\n  if (Object.keys(scripts).length > 0) {\r\n    console.log(`Adding scripts ${colors.magenta(Object.keys(scripts).join(\", \"))}`);\r\n    const packageJsonPath = rootPath(\"package.json\");\r\n    const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\r\n    packageJson.scripts = { ...(packageJson.scripts ?? {}), ...scripts };\r\n    await putJsonFileAsync(packageJsonPath, packageJson);\r\n\r\n    console.log(`Scripts added successfully ${colors.green(Object.keys(scripts).join(\", \"))}`);\r\n  }\r\n}\r\n\r\n/**\r\n * Install the resolved dependency sets through the project's package manager.\r\n * Runs two passes (prod then dev) so each lands in the correct section.\r\n */\r\nasync function installDependencies(\r\n  packageManager: PackageManager | undefined,\r\n  dependencies: Record<string, string>,\r\n  devDependencies: Record<string, string>,\r\n) {\r\n  // `--package-manager` is optional; without it, fall back to the lockfile.\r\n  const packageManagerCommand = getAddCommand(packageManager ?? (await detectPackageManager()));\r\n\r\n  if (Object.keys(dependencies).length > 0) {\r\n    console.log(`Installing dependencies ${colors.magenta(Object.keys(dependencies).join(\", \"))}`);\r\n\r\n    execSync(`${packageManagerCommand} ${Object.keys(dependencies).join(\" \")}`, {\r\n      cwd: process.cwd(),\r\n      stdio: \"inherit\",\r\n    });\r\n\r\n    console.log(\r\n      `Dependencies installed successfully ${colors.green(Object.keys(dependencies).join(\", \"))}`,\r\n    );\r\n  }\r\n\r\n  if (Object.keys(devDependencies).length > 0) {\r\n    console.log(\r\n      `Installing dev dependencies ${colors.magenta(Object.keys(devDependencies).join(\", \"))}`,\r\n    );\r\n\r\n    execSync(`${packageManagerCommand} ${Object.keys(devDependencies).join(\" \")} -D`, {\r\n      cwd: process.cwd(),\r\n      stdio: \"inherit\",\r\n    });\r\n\r\n    console.log(\r\n      `Dev dependencies installed successfully ${colors.green(Object.keys(devDependencies).join(\", \"))}`,\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Write the resolved dependency sets into package.json without installing.\r\n * Used by `--no-install` so a scaffolder can batch every feature into one\r\n * install pass after the command returns. Versions come from the feature map.\r\n */\r\nasync function recordDependencies(\r\n  dependencies: Record<string, string>,\r\n  devDependencies: Record<string, string>,\r\n) {\r\n  if (Object.keys(dependencies).length === 0 && Object.keys(devDependencies).length === 0) {\r\n    return;\r\n  }\r\n\r\n  const packageJsonPath = rootPath(\"package.json\");\r\n  const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\r\n\r\n  packageJson.dependencies = packageJson.dependencies ?? {};\r\n  packageJson.devDependencies = packageJson.devDependencies ?? {};\r\n\r\n  Object.assign(packageJson.dependencies, dependencies);\r\n  Object.assign(packageJson.devDependencies, devDependencies);\r\n\r\n  await putJsonFileAsync(packageJsonPath, packageJson);\r\n\r\n  const recorded = [...Object.keys(dependencies), ...Object.keys(devDependencies)];\r\n\r\n  console.log(\r\n    `Recorded ${colors.green(recorded.join(\", \"))} in package.json (install skipped via --no-install)`,\r\n  );\r\n}\r\n\r\nfunction validateFeatures(features: string[]) {\r\n  for (const feature of features) {\r\n    if (!allowedFeatures.includes(feature)) {\r\n      console.log(\r\n        `Feature ${colors.redBright(feature)} is not allowed, allowed features are: ${colors.green(allowedFeatures.join(\", \"))}`,\r\n      );\r\n      process.exit(1);\r\n    }\r\n  }\r\n}\r\n\r\n"],"mappings":"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"}
+{"version":3,"file":"add-command.action.mjs","names":[],"sources":["../../../../../../../core/src/generations/add-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  ensureDirectoryAsync,\r\n  fileExistsAsync,\r\n  getFileAsync,\r\n  getJsonFileAsync,\r\n  putFileAsync,\r\n  putJsonFileAsync,\r\n} from \"@warlock.js/fs\";\r\nimport { execSync } from \"node:child_process\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport {\r\n  detectPackageManager,\r\n  getAddCommand,\r\n  type PackageManager,\r\n} from \"../updater/package-manager\";\r\nimport { rootPath, srcPath } from \"../utils\";\r\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\r\nimport {\r\n  accessConfigStub,\r\n  aiConfigStub,\r\n  accessResolverStub,\r\n  accessRoleMigrationStub,\r\n  accessRoleModelIndexStub,\r\n  accessRoleModelStub,\r\n  accessUserRoleMigrationStub,\r\n  accessUserRoleModelIndexStub,\r\n  accessUserRoleModelStub,\r\n  communicatorsConfigStub,\r\n  notificationControllersStub,\r\n  notificationMigrationStub,\r\n  notificationModelStub,\r\n  notificationRoutesStub,\r\n  notificationsConfigStub,\r\n  socketConfigStub,\r\n  webHomePageStub,\r\n  webRootStub,\r\n} from \"./stubs\";\r\n\r\n/**\r\n * The parts of a project `package.json` this action reads or writes. Deliberately\r\n * partial — it describes what we touch, not the whole manifest.\r\n */\r\ntype ProjectPackageJson = {\r\n  dependencies?: Record<string, string>;\r\n  devDependencies?: Record<string, string>;\r\n  scripts?: Record<string, string>;\r\n};\r\n\r\n/**\r\n * The part of a project `tsconfig.json` this action patches.\r\n */\r\ntype ProjectTsConfig = {\r\n  include?: string[];\r\n};\r\n\r\n/**\r\n * Build a migration filename timestamp prefix in the framework's\r\n * MM-DD-YYYY_HH-MM-SS form. Cascade infers a migration's createdAt from this\r\n * prefix and orders migrations deterministically by it. Pass `offsetSeconds` to\r\n * stamp sibling migrations created in the same scaffold a second apart so they\r\n * never collide and keep a stable relative order.\r\n */\r\nfunction migrationTimestamp(offsetSeconds = 0): string {\r\n  const now = new Date(Date.now() + offsetSeconds * 1000);\r\n  const pad = (value: number) => String(value).padStart(2, \"0\");\r\n\r\n  return (\r\n    `${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${now.getFullYear()}_` +\r\n    `${pad(now.getHours())}-${pad(now.getMinutes())}-${pad(now.getSeconds())}`\r\n  );\r\n}\r\n\r\nasync function completeTestInstallation(options: CommandActionData) {\r\n  // Create test-global-setup.ts (runs once before all tests)\r\n  const testGlobalSetupPath = srcPath(\"test-global-setup.ts\");\r\n  const testGlobalSetupExists = await fileExistsAsync(testGlobalSetupPath);\r\n\r\n  if (!testGlobalSetupExists) {\r\n    await putFileAsync(\r\n      testGlobalSetupPath,\r\n      `/**\r\n * Global Test Setup\r\n *\r\n * Runs ONCE before all test workers.\r\n * Starts the HTTP server for integration tests.\r\n */\r\nimport { startHttpTestServer, stopHttpTestServer } from \"@warlock.js/core/tests\";\r\n\r\nexport async function setup() {\r\n  await startHttpTestServer();\r\n}\r\n\r\nexport async function teardown() {\r\n  await stopHttpTestServer();\r\n}\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created src/test-global-setup.ts`);\r\n  }\r\n\r\n  // Create test-setup.ts (runs before EVERY test file)\r\n  const testSetupPath = srcPath(\"test-setup.ts\");\r\n  const testSetupExists = await fileExistsAsync(testSetupPath);\r\n\r\n  if (!testSetupExists) {\r\n    await putFileAsync(\r\n      testSetupPath,\r\n      `/**\r\n * Test Setup - runs before EVERY test file\r\n *\r\n * Vitest runs setupFiles before each test file and rebuilds the module\r\n * registry with it, so this pair boots and closes the test runtime once per\r\n * test file.\r\n *\r\n * setupTest() is called with no options on purpose: an explicit connectors\r\n * value outranks tests.connectors from src/config/tests.ts, so passing one\r\n * here would erase your project config. Omitting it leaves the config in\r\n * charge.\r\n *\r\n * afterAll(teardownTest) is the other half of the pair: whoever calls\r\n * setupTest() owns closing it in the same runtime context.\r\n */\r\nimport { setupTest, teardownTest } from \"@warlock.js/core/tests\";\r\nimport { afterAll } from \"vitest\";\r\n\r\nawait setupTest();\r\n\r\nafterAll(teardownTest);\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created src/test-setup.ts`);\r\n  }\r\n\r\n  // Create vite.config.ts\r\n  const viteConfigPath = rootPath(\"vite.config.ts\");\r\n  const viteConfigExists = await fileExistsAsync(viteConfigPath);\r\n\r\n  if (!viteConfigExists) {\r\n    await putFileAsync(\r\n      viteConfigPath,\r\n      `import { lowerStage3Decorators } from \"@warlock.js/core/vite\";\r\nimport mongezVite from \"@mongez/vite\";\r\nimport { defineConfig } from \"vitest/config\";\r\n\r\nexport default defineConfig({\r\n  // lowerStage3Decorators MUST come first: it lowers native (@RegisterModel, …)\r\n  // decorators with esbuild before oxc / the SSR rewrite can mangle them, so\r\n  // decorated Cascade models load under Vitest.\r\n  plugins: [lowerStage3Decorators(), mongezVite()],\r\n  test: {\r\n    globalSetup: \"./src/test-global-setup.ts\", // HTTP server - runs once\r\n    setupFiles: [\"./src/test-setup.ts\"],       // DB/cache - runs per test file\r\n    environment: \"node\",\r\n    globals: false,\r\n    include: [\"src/app/**/*.test.ts\"],\r\n  },\r\n});\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created vite.config.ts`);\r\n  }\r\n}\r\n\r\nasync function completeReactEmailInstallation(_options: CommandActionData) {\r\n  // 1. Create emails/ folder with a sample component\r\n  const emailsFolderPath = rootPath(\"emails\");\r\n  const sampleEmailPath = rootPath(\"emails/welcome-email.tsx\");\r\n\r\n  if (!(await fileExistsAsync(sampleEmailPath))) {\r\n    await ensureDirectoryAsync(emailsFolderPath);\r\n    await putFileAsync(\r\n      sampleEmailPath,\r\n      `import { Body, Container, Head, Html, Text } from \"@react-email/components\";\r\nimport { Tailwind } from \"@react-email/tailwind\";\r\n\r\ninterface WelcomeEmailProps {\r\n  name: string;\r\n}\r\n\r\n/**\r\n * Sample welcome email component.\r\n * Preview with: yarn email:preview\r\n */\r\nexport default function WelcomeEmail({ name }: WelcomeEmailProps) {\r\n  return (\r\n    <Html>\r\n      <Head />\r\n      <Tailwind>\r\n        <Body className=\"bg-gray-100 font-sans\">\r\n          <Container className=\"mx-auto max-w-xl py-8 px-4\">\r\n            <Text className=\"text-2xl font-bold text-gray-900\">\r\n              Welcome, {name}!\r\n            </Text>\r\n            <Text className=\"text-gray-600 mt-2\">\r\n              You're all set. We're glad to have you on board.\r\n            </Text>\r\n          </Container>\r\n        </Body>\r\n      </Tailwind>\r\n    </Html>\r\n  );\r\n}\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created emails/welcome-email.tsx`);\r\n  }\r\n\r\n  // 2. Patch tsconfig.json — add \"emails\" to include if missing\r\n  const tsconfigPath = rootPath(\"tsconfig.json\");\r\n  const tsconfig = await getJsonFileAsync<ProjectTsConfig>(tsconfigPath);\r\n\r\n  if (!tsconfig.include) {\r\n    tsconfig.include = [];\r\n  }\r\n\r\n  if (!tsconfig.include.includes(\"emails\")) {\r\n    tsconfig.include.push(\"emails\");\r\n    await putJsonFileAsync(tsconfigPath, tsconfig);\r\n    console.log(`${colors.green(\"✓\")} Added \"emails\" to tsconfig.json include`);\r\n  }\r\n}\r\n\r\nasync function completeNotificationsInstallation(_options: CommandActionData) {\r\n  const modelPath = srcPath(\"app/notifications/notification.model.ts\");\r\n\r\n  // The model file is the sentinel for \"notifications already scaffolded\" —\r\n  // its presence means the migration was created too (timestamped, so we must\r\n  // not re-emit a duplicate on a second run).\r\n  if (await fileExistsAsync(modelPath)) {\r\n    console.log(\r\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping model + migration...`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  // 1. Notification model — extends the package's DatabaseNotification base.\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications\"));\r\n  await putFileAsync(modelPath, notificationModelStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/notification.model.ts`);\r\n\r\n  // 2. Migration — timestamped MM-DD-YYYY_HH-MM-SS prefix so cascade infers its\r\n  //    createdAt and orders it deterministically (migrate-action discovers\r\n  //    src/app/*/migrations/*).\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications/migrations\"));\r\n\r\n  const migrationFile = `${migrationTimestamp()}-notification.migration.ts`;\r\n\r\n  await putFileAsync(\r\n    srcPath(\"app/notifications/migrations\", migrationFile),\r\n    notificationMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/notifications/migrations/${migrationFile}`,\r\n  );\r\n\r\n  // 3. HTTP surface — the in-app read/dismiss endpoints (routes + controllers),\r\n  //    gated by authMiddleware. Delete if the app exposes notifications another way.\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications/controllers\"));\r\n  await putFileAsync(\r\n    srcPath(\"app/notifications/controllers/notifications.controller.ts\"),\r\n    notificationControllersStub,\r\n  );\r\n  await putFileAsync(srcPath(\"app/notifications/routes.ts\"), notificationRoutesStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/routes.ts + controllers`);\r\n}\r\n\r\nasync function registerAccessLocale() {\r\n  // Register the access locale in the project's shared translations file so a\r\n  // denied check returns a real sentence, not the raw \"access.errors.forbidden\"\r\n  // key. Append when the file exists, create it otherwise; skip if already there.\r\n  const localesPath = srcPath(\"app/shared/utils/locales.ts\");\r\n\r\n  const accessLocale = `groupedTranslations(\"access\", {\r\n  errors: {\r\n    forbidden: {\r\n      en: \"You do not have permission to perform this action.\",\r\n      ar: \"ليس لديك صلاحية لتنفيذ هذا الإجراء.\",\r\n    },\r\n  },\r\n});\r\n`;\r\n\r\n  if (await fileExistsAsync(localesPath)) {\r\n    const current = await getFileAsync(localesPath);\r\n\r\n    if (current.includes(`groupedTranslations(\"access\"`)) {\r\n      console.log(`${colors.yellowBright(\"access\")} locale already registered, skipping...`);\r\n\r\n      return;\r\n    }\r\n\r\n    // The file uses groupedTranslations already iff it calls it — only inject the\r\n    // import when no call is present yet.\r\n    const importLine = `import { groupedTranslations } from \"@warlock.js/core\";`;\r\n    const prefix = current.includes(\"groupedTranslations(\") ? \"\" : `${importLine}\\n\\n`;\r\n\r\n    await putFileAsync(localesPath, `${prefix}${current.trimEnd()}\\n\\n${accessLocale}`);\r\n\r\n    console.log(\r\n      `${colors.green(\"✓\")} Registered the access locale in src/app/shared/utils/locales.ts`,\r\n    );\r\n\r\n    return;\r\n  }\r\n\r\n  await ensureDirectoryAsync(srcPath(\"app/shared/utils\"));\r\n\r\n  await putFileAsync(\r\n    localesPath,\r\n    `import { groupedTranslations } from \"@warlock.js/core\";\\n\\n${accessLocale}`,\r\n  );\r\n\r\n  console.log(`${colors.green(\"✓\")} Created src/app/shared/utils/locales.ts with the access locale`);\r\n}\r\n\r\nasync function scaffoldAccessFiles() {\r\n  // The resolver file is the sentinel for \"access already scaffolded\" — its\r\n  // presence means the role/user-role model folders and their timestamped\r\n  // migrations were created too, so we must not re-emit duplicate migrations on\r\n  // a second run.\r\n  const resolverPath = srcPath(\"app/access/services/access-resolver.ts\");\r\n\r\n  if (await fileExistsAsync(resolverPath)) {\r\n    console.log(\r\n      `${colors.yellowBright(\"src/app/access\")} already scaffolded, skipping resolver + role tables...`,\r\n    );\r\n\r\n    return;\r\n  }\r\n\r\n  // 1. Role catalog model folder (model + barrel + migration). The catalog row\r\n  //    is role name → granted permissions; managed at runtime in the DB.\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/role\"));\r\n  await putFileAsync(srcPath(\"app/access/models/role/role.model.ts\"), accessRoleModelStub);\r\n  await putFileAsync(srcPath(\"app/access/models/role/index.ts\"), accessRoleModelIndexStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/access/models/role`);\r\n\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/role/migrations\"));\r\n\r\n  // Migration filenames carry a MM-DD-YYYY_HH-MM-SS prefix so cascade infers\r\n  // their createdAt and orders them deterministically (the migrate action\r\n  // discovers src/app/*/models/*/migrations/*). The two tables are independent\r\n  // (no FK between them), but the user-role migration is stamped a second later\r\n  // so the relative order is stable.\r\n  const roleMigrationFile = `${migrationTimestamp()}-role.migration.ts`;\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/role/migrations\", roleMigrationFile),\r\n    accessRoleMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/access/models/role/migrations/${roleMigrationFile}`,\r\n  );\r\n\r\n  // 2. UserRole assignment model folder (model + barrel + migration). The model\r\n  //    statics scope an unresolved tenant to GLOBAL rows only (security\r\n  //    invariant) — see the stub for the reasoning.\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/user-role\"));\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/user-role/user-role.model.ts\"),\r\n    accessUserRoleModelStub,\r\n  );\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/user-role/index.ts\"),\r\n    accessUserRoleModelIndexStub,\r\n  );\r\n  console.log(`${colors.green(\"✓\")} Created src/app/access/models/user-role`);\r\n\r\n  await ensureDirectoryAsync(srcPath(\"app/access/models/user-role/migrations\"));\r\n\r\n  const userRoleMigrationFile = `${migrationTimestamp(1)}-user-role.migration.ts`;\r\n  await putFileAsync(\r\n    srcPath(\"app/access/models/user-role/migrations\", userRoleMigrationFile),\r\n    accessUserRoleMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/access/models/user-role/migrations/${userRoleMigrationFile}`,\r\n  );\r\n\r\n  // 3. The DatabaseAccessResolver — the one required config seam, wired into\r\n  //    config/access.ts by the ejected stub.\r\n  await ensureDirectoryAsync(srcPath(\"app/access/services\"));\r\n  await putFileAsync(resolverPath, accessResolverStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/access/services/access-resolver.ts`);\r\n}\r\n\r\n/**\r\n * Register the WebConnector in `warlock.config.ts`, and ONLY there.\r\n *\r\n * It belongs to the config array or to app code, never both. Both halves are\r\n * registered before app code loads — the CLI preloader in dev, the generated\r\n * entry in production — so also calling `connectorsManager.register(...)` in\r\n * `src/app/main.ts` boots the connector twice and installs every page route\r\n * twice. That surfaces at PRODUCTION boot as `Route name \"...\" is already\r\n * taken`, because pages and API routes share one route-name namespace.\r\n *\r\n * The config array is the half to prefer: `warlock build` reads the same array\r\n * to drain each connector's build contribution, so \"built for\" and \"boots with\"\r\n * cannot drift.\r\n *\r\n * String surgery rather than a TypeScript parse: `warlock.config.ts` is an\r\n * app-owned file that may carry any formatting, and a parse-and-print would\r\n * reformat the parts we did not come to change.\r\n */\r\nasync function registerWebConnector(): Promise<void> {\r\n  const configPath = rootPath(\"warlock.config.ts\");\r\n\r\n  if (!(await fileExistsAsync(configPath))) {\r\n    console.log(\r\n      `${colors.yellowBright(\"warlock.config.ts\")} not found — add this yourself:\\n` +\r\n        `  import { webConnector } from \"@warlock.js/web/connector\";\\n` +\r\n        `  export default defineConfig({ connectors: [webConnector()] });`,\r\n    );\r\n\r\n    return;\r\n  }\r\n\r\n  const current = await getFileAsync(configPath);\r\n\r\n  if (current.includes(\"webConnector\")) {\r\n    console.log(`${colors.yellowBright(\"webConnector\")} already registered, skipping...`);\r\n\r\n    return;\r\n  }\r\n\r\n  const importLine = 'import { webConnector } from \"@warlock.js/web/connector\";';\r\n  let next = current.includes(importLine) ? current : `${importLine}\\n${current}`;\r\n\r\n  // An existing `connectors: [` gains one entry; otherwise the key is added to\r\n  // the object `defineConfig` receives.\r\n  if (/connectors:\\s*\\[/.test(next)) {\r\n    next = next.replace(/connectors:\\s*\\[/, \"connectors: [webConnector(),\");\r\n  } else if (next.includes(\"defineConfig({\")) {\r\n    next = next.replace(\"defineConfig({\", \"defineConfig({\\n  connectors: [webConnector()],\");\r\n  } else {\r\n    console.log(\r\n      `${colors.yellowBright(\"warlock.config.ts\")} has no recognisable defineConfig({...}) — ` +\r\n        \"add `connectors: [webConnector()]` yourself.\",\r\n    );\r\n\r\n    return;\r\n  }\r\n\r\n  await putFileAsync(configPath, next);\r\n  console.log(`${colors.green(\"✓\")} Registered webConnector in warlock.config.ts`);\r\n}\r\n\r\n/**\r\n * The app routes file the project template registers `GET /` in. Only this one\r\n * path is inspected: `warlock add web` is not a codebase-wide route auditor, and\r\n * a project that keeps its routes elsewhere lands on the `absent` outcome below,\r\n * which writes the page exactly as before.\r\n */\r\nconst APP_ROUTES_FILE = \"app/shared/routes.ts\";\r\n\r\n/**\r\n * A TOP-LEVEL `router.get(\"/\", ...)` — anchored at column 0 on purpose.\r\n *\r\n * Routes nested in a `router.group({ prefix: \"/x\" }, ...)` are indented by every\r\n * formatter this codebase runs, and their real path is `/x`, not `/`. Anchoring\r\n * is what keeps the notifications feature's own `router.get(\"/\", ...)` (inside\r\n * the `/notifications` group) from reading as a homepage collision.\r\n *\r\n * Only the path literal is captured. The handler — a bare identifier in the\r\n * template, but possibly an inline arrow spanning lines — is never matched, so\r\n * the rewrite below cannot damage it.\r\n */\r\nconst TOP_LEVEL_ROOT_GET = /^router\\s*\\.\\s*get\\(\\s*([\"'`])\\/\\1/gm;\r\n\r\n/**\r\n * Whether `/welcome` is already spoken for, so relocating onto it would trade\r\n * one duplicate-route 500 for another.\r\n */\r\nconst TOP_LEVEL_WELCOME_GET = /^router\\s*\\.\\s*get\\(\\s*([\"'`])\\/welcome\\1/m;\r\n\r\ntype HomeRouteCollision =\r\n  /** No app routes file, or nothing claims `/` — write the page as normal. */\r\n  | { outcome: \"absent\" }\r\n  /** The template's `GET /` was moved to `/welcome`; the page is safe to write. */\r\n  | { outcome: \"relocated\" }\r\n  /** Something claims `/` that we will not rewrite. The page is NOT written. */\r\n  | { outcome: \"conflict\"; reason: string }\r\n  /** We tried to relocate and could not. The page is NOT written. */\r\n  | { outcome: \"failed\"; reason: string };\r\n\r\n/**\r\n * Make room for a page that declares `route = \"/\"`.\r\n *\r\n * The project template registers `router.get(\"/\", homePageController)` and the\r\n * page stub declares `route = \"/\"`. Fastify rejects the second registration\r\n * (`Method 'GET' already declared for route '/'`) and the homepage 500s at\r\n * request time — so `warlock add web` cannot just write the page and hope.\r\n *\r\n * Of the three ways out, this RELOCATES the JSON route to `/welcome` rather than\r\n * deleting it or refusing to scaffold:\r\n *\r\n * - Deleting the controller is what the scaffolder's own `react` feature does,\r\n *   but it may do that: it owns the file it is deleting, seconds after writing\r\n *   it. `warlock add web` runs against a project a human has been living in, and\r\n *   silently unlinking their code is not a thing an `add` command gets to do.\r\n * - Writing the page anyway and printing a warning ships a project whose\r\n *   homepage 500s. A warning above a broken app is still a broken app.\r\n * - Relocating keeps BOTH surfaces working: the React homepage takes `/`, the\r\n *   JSON welcome answers at `/welcome`, and no line of user code disappears.\r\n *\r\n * Only the exact top-level shape is rewritten, and only the path literal inside\r\n * it. Anything else that claims `/` is reported and left completely alone — we\r\n * do not guess at code we cannot recognise.\r\n */\r\nasync function relocateConflictingHomeRoute(): Promise<HomeRouteCollision> {\r\n  const routesPath = srcPath(APP_ROUTES_FILE);\r\n\r\n  // Not every project comes from the template. No file is not a problem.\r\n  if (!(await fileExistsAsync(routesPath))) {\r\n    return { outcome: \"absent\" };\r\n  }\r\n\r\n  let current: string;\r\n\r\n  try {\r\n    current = await getFileAsync(routesPath);\r\n  } catch (error) {\r\n    return {\r\n      outcome: \"failed\",\r\n      reason: `could not be read (${(error as Error).message})`,\r\n    };\r\n  }\r\n\r\n  const matches = current.match(TOP_LEVEL_ROOT_GET) ?? [];\r\n\r\n  if (matches.length === 0) {\r\n    return { outcome: \"absent\" };\r\n  }\r\n\r\n  if (matches.length > 1) {\r\n    return {\r\n      outcome: \"conflict\",\r\n      reason: `declares ${matches.length} top-level GET \"/\" routes`,\r\n    };\r\n  }\r\n\r\n  if (TOP_LEVEL_WELCOME_GET.test(current)) {\r\n    return {\r\n      outcome: \"conflict\",\r\n      reason: 'already declares GET \"/welcome\", so the usual relocation target is taken',\r\n    };\r\n  }\r\n\r\n  const next = current.replace(TOP_LEVEL_ROOT_GET, (match, quote: string) =>\r\n    match.replace(`${quote}/${quote}`, `${quote}/welcome${quote}`),\r\n  );\r\n\r\n  if (next === current) {\r\n    return { outcome: \"conflict\", reason: 'its GET \"/\" route could not be rewritten' };\r\n  }\r\n\r\n  try {\r\n    await putFileAsync(routesPath, next);\r\n  } catch (error) {\r\n    return {\r\n      outcome: \"failed\",\r\n      reason: `could not be written (${(error as Error).message})`,\r\n    };\r\n  }\r\n\r\n  return { outcome: \"relocated\" };\r\n}\r\n\r\n/**\r\n * Scaffold the smallest page layer that renders, and register the connector.\r\n *\r\n * `src/web/root.tsx` is the sentinel for \"already scaffolded\" — the framework\r\n * ships a default root, so its presence means a human has been here.\r\n */\r\nasync function completeWebInstallation(_options: CommandActionData) {\r\n  const rootFile = srcPath(\"web/root.tsx\");\r\n\r\n  if (await fileExistsAsync(rootFile)) {\r\n    console.log(`${colors.yellowBright(\"src/web\")} already scaffolded, skipping...`);\r\n  } else {\r\n    await ensureDirectoryAsync(srcPath(\"web\"));\r\n    await putFileAsync(rootFile, webRootStub);\r\n    console.log(`${colors.green(\"✓\")} Created src/web/root.tsx`);\r\n\r\n    const collision = await relocateConflictingHomeRoute();\r\n\r\n    if (collision.outcome === \"relocated\") {\r\n      console.log(\r\n        `${colors.green(\"✓\")} Moved the existing ${colors.yellowBright('GET \"/\"')} route to ` +\r\n          `${colors.yellowBright('\"/welcome\"')} in ${colors.yellowBright(`src/${APP_ROUTES_FILE}`)} — ` +\r\n          \"the new page owns `/` now, and the JSON welcome route still answers at /welcome.\",\r\n      );\r\n    }\r\n\r\n    // The page is written ONLY when `/` is provably free. Writing it while\r\n    // another handler holds `/` produces a homepage that 500s on first request,\r\n    // which is precisely the outcome a scaffolder must never hand back.\r\n    if (collision.outcome === \"conflict\" || collision.outcome === \"failed\") {\r\n      const verb = collision.outcome === \"failed\" ? colors.redBright(\"✗\") : colors.yellowBright(\"!\");\r\n\r\n      console.log(\r\n        `${verb} Did not create src/web/home.page.tsx: ` +\r\n          `${colors.yellowBright(`src/${APP_ROUTES_FILE}`)} ${collision.reason}.\\n` +\r\n          `  The page stub declares ${colors.yellowBright('route = \"/\"')}, and two handlers on one ` +\r\n          \"path is a 500 at request time, not a startup error.\\n\" +\r\n          `  Free up ${colors.yellowBright('GET \"/\"')} in that file — move it to a path of its own, ` +\r\n          \"or remove it — then create src/web/home.page.tsx yourself. Giving the page a `route` other \" +\r\n          \"than `/` works too.\",\r\n      );\r\n\r\n      // Non-zero on BOTH branches. The page layer this command exists to\r\n      // scaffold was not scaffolded, and a 0 here is the exact \"looked like it\r\n      // worked\" signal that put `/` in this state to begin with — a conflict we\r\n      // declined to guess at is still an incomplete install, not a success.\r\n      //\r\n      // `exitCode` rather than `exit(1)`: the connector below still has to be\r\n      // registered, and any other feature in the same `warlock add` invocation\r\n      // still has to install, or the project is left half-wired on top of this.\r\n      process.exitCode = 1;\r\n    } else {\r\n      await putFileAsync(srcPath(\"web/home.page.tsx\"), webHomePageStub);\r\n      console.log(`${colors.green(\"✓\")} Created src/web/home.page.tsx`);\r\n    }\r\n  }\r\n\r\n  await registerWebConnector();\r\n}\r\n\r\nasync function completeAccessInstallation(_options: CommandActionData) {\r\n  await registerAccessLocale();\r\n  await scaffoldAccessFiles();\r\n}\r\n\r\n/**\r\n * Link a satellite AI package into src/config/ai.ts via a side-effect import.\r\n *\r\n * The satellites (@warlock.js/ai-tools, ai-panoptic, ai-workspace) augment the\r\n * `ai` object on import — they register their runtime surface (ai.tools / ai.mcp,\r\n * ai.workspace, panoptic's ai.config({ panoptic }) wiring) AND the matching TS\r\n * declaration-merging so ai.* members resolve. config-loader runs config/ai.ts at\r\n * boot, so dropping a bare `import \"<specifier>\";` at the top of that file is what\r\n * actually loads the augmentation before the ai connector applies the config.\r\n *\r\n * No-op if config/ai.ts is missing (the `ai` feature ejects it) or the import is\r\n * already present. Inserts right after the `warlock:ai-packages` marker when it\r\n * exists so the satellite imports stay grouped; otherwise prepends to the top.\r\n */\r\nasync function linkAiPackageImport(specifier: string): Promise<void> {\r\n  const aiConfigPath = srcPath(\"config/ai.ts\");\r\n\r\n  if (!(await fileExistsAsync(aiConfigPath))) {\r\n    return;\r\n  }\r\n\r\n  const current = await getFileAsync(aiConfigPath);\r\n  const importLine = `import \"${specifier}\";`;\r\n\r\n  if (current.includes(importLine)) {\r\n    return;\r\n  }\r\n\r\n  const marker = \"// >>> warlock:ai-packages (auto-managed) >>>\";\r\n  let next: string;\r\n\r\n  if (current.includes(marker)) {\r\n    next = current.replace(marker, `${marker}\\n${importLine}`);\r\n  } else {\r\n    next = `${importLine}\\n${current}`;\r\n  }\r\n\r\n  await putFileAsync(aiConfigPath, next);\r\n\r\n  console.log(`${colors.green(\"✓\")} Linked ${specifier} in src/config/ai.ts`);\r\n}\r\n\r\nexport const featuresMap: Record<\r\n  string,\r\n  {\r\n    dependencies?: Record<string, string>;\r\n    devDependencies?: Record<string, string>;\r\n    description: string;\r\n    requires?: string[];\r\n    script?: Record<string, string>;\r\n    onExecuting?: (options: CommandActionData) => Promise<any>;\r\n    ejectConfig?: {\r\n      content: string;\r\n      name: string;\r\n    };\r\n  }\r\n> = {\r\n  \"react-email\": {\r\n    description: \"Installs react-email for building email templates with React and Tailwind\",\r\n    requires: [\"mail\", \"react\"],\r\n    dependencies: {\r\n      \"react-email\": \"^5.2.10\",\r\n      \"@react-email/components\": \"^1.0.11\",\r\n      \"@react-email/render\": \"^2.0.5\",\r\n      \"@react-email/tailwind\": \"^2.0.7\",\r\n    },\r\n    devDependencies: {\r\n      \"@react-email/preview-server\": \"5.2.10\",\r\n    },\r\n    script: {\r\n      \"email:preview\": \"npx react-email dev\",\r\n    },\r\n    onExecuting: completeReactEmailInstallation,\r\n  },\r\n  react: {\r\n    description:\r\n      \"Installs React and React dom for rendering React components (non-interactive), useful for sending mails and generating HTML\",\r\n    dependencies: {\r\n      react: \"^19.2.3\",\r\n      \"react-dom\": \"^19.2.3\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/react\": \"^19.2.7\",\r\n      \"@types/react-dom\": \"^19.2.3\",\r\n    },\r\n  },\r\n  image: {\r\n    description: \"Installs sharp for image processing\",\r\n    dependencies: {\r\n      sharp: \"^0.34.5\",\r\n    },\r\n  },\r\n  mail: {\r\n    description: \"Installs nodemailer for sending emails\",\r\n    dependencies: {\r\n      nodemailer: \"^8.0.5\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/nodemailer\": \"^8.0.0\",\r\n    },\r\n  },\r\n  ses: {\r\n    description: \"Installs AWS SES SDK for sending emails via Amazon SES\",\r\n    dependencies: {\r\n      \"@aws-sdk/client-sesv2\": \"^3.1025.0\",\r\n    },\r\n  },\r\n  mongodb: {\r\n    description: \"Installs mongodb driver for database driver (Cascade Package)\",\r\n    dependencies: {\r\n      mongodb: \"^7.0.0\",\r\n    },\r\n  },\r\n  scheduler: {\r\n    description: \"Installs warlock scheduler for scheduling tasks\",\r\n    dependencies: {\r\n      \"@warlock.js/scheduler\": \"~4.0.0\",\r\n    },\r\n  },\r\n  // swagger / postman intentionally omitted — those packages do not exist yet;\r\n  // they will ship together in the unified @warlock.js/api-docs package.\r\n  postgres: {\r\n    description: \"Installs pg for Postgres database (Cascade Package)\",\r\n    dependencies: {\r\n      pg: \"^8.11.0\",\r\n    },\r\n  },\r\n  mysql: {\r\n    description: \"Installs mysql2 for MySQL database driver (Cascade Package)\",\r\n    dependencies: {\r\n      mysql2: \"^3.5.0\",\r\n    },\r\n  },\r\n  redis: {\r\n    description: \"Installs redis for Redis cache driver (Cache Package)\",\r\n    dependencies: {\r\n      redis: \"^4.6.13\",\r\n    },\r\n  },\r\n  s3: {\r\n    description: \"Installs AWS SDK for Cloud storage (Storage Package)\",\r\n    dependencies: {\r\n      \"@aws-sdk/client-s3\": \"^3.955.0\",\r\n      \"@aws-sdk/lib-storage\": \"^3.955.0\",\r\n      \"@aws-sdk/s3-request-presigner\": \"^3.955.0\",\r\n    },\r\n  },\r\n  test: {\r\n    description: \"Installs warlock test for testing\",\r\n    onExecuting: completeTestInstallation,\r\n    script: {\r\n      test: \"vitest run\",\r\n      \"test:coverage\": \"vitest run --coverage\",\r\n      \"test:ui\": \"vitest --ui\",\r\n      \"test:watch\": \"vitest --watch\",\r\n    },\r\n    devDependencies: {\r\n      \"@mongez/vite\": \"^2.0.4\",\r\n      vite: \"^8.0.16\",\r\n      vitest: \"^4.1.8\",\r\n      \"@vitest/coverage-v8\": \"^4.1.8\",\r\n    },\r\n  },\r\n  web: {\r\n    description:\r\n      \"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.\",\r\n    dependencies: {\r\n      \"@warlock.js/web\": \"~4.0.0\",\r\n      react: \"^19.2.3\",\r\n      \"react-dom\": \"^19.2.3\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/react\": \"^19.2.7\",\r\n      \"@types/react-dom\": \"^19.2.3\",\r\n      // Loaded through `await import()` by the dev server only, so both are\r\n      // optional peers of `web` rather than hard dependencies.\r\n      vite: \"^7.3.5\",\r\n      \"@vitejs/plugin-react\": \"^5.2.0\",\r\n    },\r\n    onExecuting: completeWebInstallation,\r\n  },\r\n  herald: {\r\n    description: \"Installs herald for message broker (Herald Package)\",\r\n    dependencies: {\r\n      \"@warlock.js/herald\": \"~4.0.0\",\r\n      amqplib: \"^0.10.0\",\r\n    },\r\n    devDependencies: {\r\n      \"@types/amqplib\": \"^0.10.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: communicatorsConfigStub,\r\n      name: \"herald\",\r\n    },\r\n  },\r\n  socket: {\r\n    description: \"Installs socket.io for the realtime socket server (Socket Connector)\",\r\n    dependencies: {\r\n      \"socket.io\": \"^4.8.3\",\r\n    },\r\n    ejectConfig: {\r\n      content: socketConfigStub,\r\n      name: \"socket\",\r\n    },\r\n  },\r\n  notifications: {\r\n    description:\r\n      \"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\",\r\n    // The ejected config wires a `mail` channel by default (needs nodemailer,\r\n    // via the `mail` feature); the scaffolded routes are gated by\r\n    // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\r\n    requires: [\"mail\"],\r\n    dependencies: {\r\n      \"@warlock.js/notifications\": \"~4.0.0\",\r\n      \"@warlock.js/auth\": \"~4.0.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: notificationsConfigStub,\r\n      name: \"notifications\",\r\n    },\r\n    onExecuting: completeNotificationsInstallation,\r\n  },\r\n  access: {\r\n    description:\r\n      \"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\",\r\n    dependencies: {\r\n      \"@warlock.js/access\": \"~4.0.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: accessConfigStub,\r\n      name: \"access\",\r\n    },\r\n    onExecuting: completeAccessInstallation,\r\n  },\r\n  ai: {\r\n    description: \"Installs @warlock.js/ai — the core AI toolkit (agents, tools, workflows)\",\r\n    dependencies: {\r\n      \"@warlock.js/ai\": \"~4.0.0\",\r\n    },\r\n    ejectConfig: {\r\n      content: aiConfigStub,\r\n      name: \"ai\",\r\n    },\r\n  },\r\n  \"ai-openai\": {\r\n    description: \"OpenAI provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-openai\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-google\": {\r\n    description: \"Google (Gemini) provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-google\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-anthropic\": {\r\n    description: \"Anthropic (Claude) provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-anthropic\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-bedrock\": {\r\n    description: \"AWS Bedrock provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-bedrock\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-ollama\": {\r\n    description: \"Ollama provider for @warlock.js/ai (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-ollama\": \"~4.0.0\",\r\n    },\r\n  },\r\n  \"ai-tools\": {\r\n    description:\r\n      \"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)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-tools\": \"~4.0.0\",\r\n    },\r\n    onExecuting: () => linkAiPackageImport(\"@warlock.js/ai-tools\"),\r\n  },\r\n  \"ai-panoptic\": {\r\n    description:\r\n      \"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)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-panoptic\": \"~4.0.0\",\r\n    },\r\n    onExecuting: () => linkAiPackageImport(\"@warlock.js/ai-panoptic\"),\r\n  },\r\n  \"ai-workspace\": {\r\n    description:\r\n      \"Installs @warlock.js/ai-workspace — a policy-jailed filesystem + shell workspace for coding agents, as ai.workspace (pulls the core ai package)\",\r\n    requires: [\"ai\"],\r\n    dependencies: {\r\n      \"@warlock.js/ai-workspace\": \"~4.0.0\",\r\n    },\r\n    onExecuting: () => linkAiPackageImport(\"@warlock.js/ai-workspace\"),\r\n  },\r\n};\r\n\r\nexport const allowedFeatures = Object.keys(featuresMap);\r\n\r\nfunction resolveFeatures(features: string[], visited = new Set<string>()): string[] {\r\n  const resolved: string[] = [];\r\n\r\n  for (const feature of features) {\r\n    if (visited.has(feature)) continue;\r\n    visited.add(feature);\r\n\r\n    const def = featuresMap[feature];\r\n\r\n    if (def.requires?.length) {\r\n      resolved.push(...resolveFeatures(def.requires, visited));\r\n    }\r\n\r\n    resolved.push(feature);\r\n  }\r\n\r\n  return resolved;\r\n}\r\n\r\nexport async function addCommandAction(options: CommandActionData) {\r\n  const features = options.args;\r\n  const { packageManager, list, noInstall } = options.options;\r\n\r\n  if (list) {\r\n    console.log(\"Available Features:\");\r\n\r\n    for (const feature of allowedFeatures) {\r\n      console.log(\r\n        `- ${colors.yellowBright(feature)}: ${colors.green(featuresMap[feature].description)}`,\r\n      );\r\n    }\r\n\r\n    process.exit(0);\r\n  }\r\n\r\n  validateFeatures(features);\r\n\r\n  const resolvedFeatures = resolveFeatures(features);\r\n\r\n  const dependencies: Record<string, string> = {};\r\n  const devDependencies: Record<string, string> = {};\r\n  const ejectConfigs: Record<string, { content: string; name: string }> = {};\r\n  const scripts: Record<string, string> = {};\r\n\r\n  for (const feature of resolvedFeatures) {\r\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\r\n    Object.assign(dependencies, featurePackages.dependencies);\r\n    if (featurePackages.devDependencies) {\r\n      Object.assign(devDependencies, featurePackages.devDependencies);\r\n    }\r\n\r\n    if (featurePackages.ejectConfig) {\r\n      ejectConfigs[featurePackages.ejectConfig.name] = featurePackages.ejectConfig;\r\n    }\r\n\r\n    if (featurePackages.script) {\r\n      Object.assign(scripts, featurePackages.script);\r\n    }\r\n  }\r\n\r\n  // Pin every @warlock.js/* feature package to the INSTALLED framework version so\r\n  // a scaffolded project's features match its core version instead of drifting to\r\n  // the feature map's static range.\r\n  const frameworkVersion = await getWarlockVersion();\r\n  for (const dependency of Object.keys(dependencies)) {\r\n    if (dependency.startsWith(\"@warlock.js/\")) {\r\n      dependencies[dependency] = frameworkVersion;\r\n    }\r\n  }\r\n\r\n  const currentPackageJson = await getJsonFileAsync<ProjectPackageJson>(rootPath(\"package.json\"));\r\n\r\n  // Fresh templates may omit one of the maps — guard before reading.\r\n  currentPackageJson.dependencies = currentPackageJson.dependencies ?? {};\r\n  currentPackageJson.devDependencies = currentPackageJson.devDependencies ?? {};\r\n\r\n  // Skip anything already present so we never downgrade an existing pin.\r\n  for (const dependency of Object.keys(dependencies)) {\r\n    if (currentPackageJson.dependencies[dependency]) {\r\n      console.log(`${colors.yellowBright(dependency)} is already installed, skipping...`);\r\n      delete dependencies[dependency];\r\n    }\r\n  }\r\n\r\n  for (const devDependency of Object.keys(devDependencies)) {\r\n    if (currentPackageJson.devDependencies[devDependency]) {\r\n      console.log(`${colors.yellowBright(devDependency)} is already installed, skipping...`);\r\n      delete devDependencies[devDependency];\r\n    }\r\n  }\r\n\r\n  if (noInstall) {\r\n    await recordDependencies(dependencies, devDependencies);\r\n  } else {\r\n    await installDependencies(packageManager as PackageManager | undefined, dependencies, devDependencies);\r\n  }\r\n\r\n  for (const [name, config] of Object.entries(ejectConfigs)) {\r\n    if (await fileExistsAsync(srcPath(`config/${name}.ts`))) {\r\n      console.log(`${colors.yellowBright(name)} config already exists, skipping...`);\r\n      continue;\r\n    }\r\n\r\n    console.log(`Creating ${colors.magenta(name)} config...`);\r\n\r\n    await putFileAsync(srcPath(`config/${name}.ts`), config.content);\r\n\r\n    console.log(`${colors.green(name)} config created successfully`);\r\n  }\r\n\r\n  // now loop again over features to execute onExecuting\r\n  for (const feature of resolvedFeatures) {\r\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\r\n    if (featurePackages.onExecuting) {\r\n      await featurePackages.onExecuting(options);\r\n    }\r\n  }\r\n\r\n  if (Object.keys(scripts).length > 0) {\r\n    console.log(`Adding scripts ${colors.magenta(Object.keys(scripts).join(\", \"))}`);\r\n    const packageJsonPath = rootPath(\"package.json\");\r\n    const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\r\n    packageJson.scripts = { ...(packageJson.scripts ?? {}), ...scripts };\r\n    await putJsonFileAsync(packageJsonPath, packageJson);\r\n\r\n    console.log(`Scripts added successfully ${colors.green(Object.keys(scripts).join(\", \"))}`);\r\n  }\r\n}\r\n\r\n/**\r\n * Install the resolved dependency sets through the project's package manager.\r\n * Runs two passes (prod then dev) so each lands in the correct section.\r\n */\r\nasync function installDependencies(\r\n  packageManager: PackageManager | undefined,\r\n  dependencies: Record<string, string>,\r\n  devDependencies: Record<string, string>,\r\n) {\r\n  // `--package-manager` is optional; without it, fall back to the lockfile.\r\n  const packageManagerCommand = getAddCommand(packageManager ?? (await detectPackageManager()));\r\n\r\n  if (Object.keys(dependencies).length > 0) {\r\n    console.log(`Installing dependencies ${colors.magenta(Object.keys(dependencies).join(\", \"))}`);\r\n\r\n    execSync(`${packageManagerCommand} ${Object.keys(dependencies).join(\" \")}`, {\r\n      cwd: process.cwd(),\r\n      stdio: \"inherit\",\r\n    });\r\n\r\n    console.log(\r\n      `Dependencies installed successfully ${colors.green(Object.keys(dependencies).join(\", \"))}`,\r\n    );\r\n  }\r\n\r\n  if (Object.keys(devDependencies).length > 0) {\r\n    console.log(\r\n      `Installing dev dependencies ${colors.magenta(Object.keys(devDependencies).join(\", \"))}`,\r\n    );\r\n\r\n    execSync(`${packageManagerCommand} ${Object.keys(devDependencies).join(\" \")} -D`, {\r\n      cwd: process.cwd(),\r\n      stdio: \"inherit\",\r\n    });\r\n\r\n    console.log(\r\n      `Dev dependencies installed successfully ${colors.green(Object.keys(devDependencies).join(\", \"))}`,\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Write the resolved dependency sets into package.json without installing.\r\n * Used by `--no-install` so a scaffolder can batch every feature into one\r\n * install pass after the command returns. Versions come from the feature map.\r\n */\r\nasync function recordDependencies(\r\n  dependencies: Record<string, string>,\r\n  devDependencies: Record<string, string>,\r\n) {\r\n  if (Object.keys(dependencies).length === 0 && Object.keys(devDependencies).length === 0) {\r\n    return;\r\n  }\r\n\r\n  const packageJsonPath = rootPath(\"package.json\");\r\n  const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\r\n\r\n  packageJson.dependencies = packageJson.dependencies ?? {};\r\n  packageJson.devDependencies = packageJson.devDependencies ?? {};\r\n\r\n  Object.assign(packageJson.dependencies, dependencies);\r\n  Object.assign(packageJson.devDependencies, devDependencies);\r\n\r\n  await putJsonFileAsync(packageJsonPath, packageJson);\r\n\r\n  const recorded = [...Object.keys(dependencies), ...Object.keys(devDependencies)];\r\n\r\n  console.log(\r\n    `Recorded ${colors.green(recorded.join(\", \"))} in package.json (install skipped via --no-install)`,\r\n  );\r\n}\r\n\r\nfunction validateFeatures(features: string[]) {\r\n  for (const feature of features) {\r\n    if (!allowedFeatures.includes(feature)) {\r\n      console.log(\r\n        `Feature ${colors.redBright(feature)} is not allowed, allowed features are: ${colors.green(allowedFeatures.join(\", \"))}`,\r\n      );\r\n      process.exit(1);\r\n    }\r\n  }\r\n}\r\n\r\n"],"mappings":"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"}