@codemieai/cdk 0.1.288 → 0.1.290

package/README.md

@@ -78,6 +78,9 @@ The `.env` file is already added to `.gitignore` and should never be committed t
 ## Quick Start
 
 ```bash
+# Initialize a new Codemie IaC project (creates .env and codemie.yaml via wizard)
+codemie init
+
 # Full validation with API connectivity check (default, recommended)
 npm run validate
 
@@ -104,6 +107,22 @@ npm run <command>  --config codemie/iac.json
 ```
 **Note:** All commands work identically whether you use monolithic configuration or modular imports - the `$import` directives are automatically resolved during config loading.
 
+### Project Initialization (`codemie init`)
+
+Use the interactive wizard to scaffold a project:
+
+```bash
+codemie init
+```
+
+What it does:
+- Creates a `.env` template (with a safety prompt if it already exists)
+- Generates a minimal `codemie.yaml` using your project name and description
+- Saves an optional `appConfig` file when you pick non-default paths for config/state/backups
+- Prints next steps to validate and deploy
+
+If `.env` or `codemie.yaml` already exist, the wizard asks before overwriting and will keep your files if you decline.
+
 **Config file structure:**
 ```json
 {

package/dist/cli/index.js

@@ -9,10 +9,11 @@ import * as crypto from 'crypto';
 import * as yaml3 from 'yaml';
 import { CodeMieClient, DataSourceType } from 'codemie-sdk';
 import pLimit from 'p-limit';
+import * as readline from 'readline';
 
 // package.json
 var package_default = {
-  version: "0.1.288"};
+  version: "0.1.290"};
 var appConfigSchema = z.object({
   rootDir: z.string(),
   codemieConfig: z.string(),
@@ -1275,28 +1276,28 @@ Import chain: ${[...visitedFiles].join(" \u2192 ")} \u2192 ${normalizedPath}`
    * @param rootConfig - Root config object (constant reference for resolving paths like "imported.integrations.xxx")
    * @param path - Current path in config tree (for error messages, e.g., "resources.assistants[0].toolkits")
    */
-  resolveReferencesRecursive(current, rootConfig, path13 = "") {
+  resolveReferencesRecursive(current, rootConfig, path15 = "") {
     if (!current || typeof current !== "object") {
       return;
     }
     if (Array.isArray(current)) {
-      this.resolveArrayReferences(current, rootConfig, path13);
+      this.resolveArrayReferences(current, rootConfig, path15);
       return;
     }
     if ("$ref" in current && typeof current.$ref === "string") {
-      this.resolveObjectReference(current, rootConfig, path13);
+      this.resolveObjectReference(current, rootConfig, path15);
       return;
     }
-    this.resolveObjectProperties(current, rootConfig, path13);
+    this.resolveObjectProperties(current, rootConfig, path15);
   }
   /**
    * Resolve $ref items in arrays and flatten if they point to arrays
    * Example: [{ $ref: "context_definitions.repos" }] where repos is [item1, item2]
    * becomes [item1, item2]
    */
-  resolveArrayReferences(arr, rootConfig, path13) {
+  resolveArrayReferences(arr, rootConfig, path15) {
     const result = arr.flatMap((item, i) => {
-      const contextPath = `${path13}[${i}]`;
+      const contextPath = `${path15}[${i}]`;
       if (!this.isRefObject(item) || item.$ref.startsWith("#")) {
         this.resolveReferencesRecursive(item, rootConfig, contextPath);
         return [item];
@@ -1314,9 +1315,9 @@ Import chain: ${[...visitedFiles].join(" \u2192 ")} \u2192 ${normalizedPath}`
    * Resolve object reference: { $ref: "path" }
    * Replaces object with resolved data (in-place mutation)
    */
-  resolveObjectReference(current, rootConfig, path13) {
+  resolveObjectReference(current, rootConfig, path15) {
     const refPath = current.$ref;
-    const contextPath = path13 || "root";
+    const contextPath = path15 || "root";
     if (refPath.startsWith("#")) {
       return;
     }
@@ -1326,24 +1327,24 @@ Import chain: ${[...visitedFiles].join(" \u2192 ")} \u2192 ${normalizedPath}`
       delete current[key];
     }
     Object.assign(current, filteredResolved);
-    this.resolveReferencesRecursive(current, rootConfig, path13);
+    this.resolveReferencesRecursive(current, rootConfig, path15);
   }
   /**
    * Resolve object properties recursively
    * Handles both nested objects and "$ref:path" string references
    */
-  resolveObjectProperties(current, rootConfig, path13) {
+  resolveObjectProperties(current, rootConfig, path15) {
     for (const [key, value] of Object.entries(current)) {
       if (typeof value === "string" && value.startsWith("$ref:")) {
         const refPath = value.slice(5);
         if (refPath.startsWith("#")) {
           continue;
         }
-        const contextPath = path13 ? `${path13}.${key}` : key;
+        const contextPath = path15 ? `${path15}.${key}` : key;
         const resolved = this.resolveReference(rootConfig, refPath, contextPath);
         current[key] = resolved;
       } else {
-        this.resolveReferencesRecursive(value, rootConfig, path13 ? `${path13}.${key}` : key);
+        this.resolveReferencesRecursive(value, rootConfig, path15 ? `${path15}.${key}` : key);
       }
     }
   }
@@ -1499,8 +1500,8 @@ async function withRetry(fn, operation, maxAttempts = RATE_LIMITING.RETRY_ATTEMP
       }
       const delayMs = RATE_LIMITING.RETRY_DELAY_MS * 2 ** (attempt - 1);
       logger.warn(`   \u26A0\uFE0F  Retry ${attempt}/${maxAttempts} for ${operation} after ${delayMs}ms...`);
-      await new Promise((resolve4) => {
-        const timerId = setTimeout(resolve4, delayMs);
+      await new Promise((resolve6) => {
+        const timerId = setTimeout(resolve6, delayMs);
         timerId.unref();
       });
     }
@@ -2853,13 +2854,13 @@ async function destroyResources(options) {
     if (force) {
       logger.info("\u{1F680} --force flag detected, skipping confirmation\n");
     } else {
-      const readline = await import('readline');
-      const rl = readline.createInterface({
+      const readline2 = await import('readline');
+      const rl = readline2.createInterface({
         input: process.stdin,
         output: process.stdout
       });
-      const answer = await new Promise((resolve4) => {
-        rl.question('Type "destroy" to confirm deletion: ', resolve4);
+      const answer = await new Promise((resolve6) => {
+        rl.question('Type "destroy" to confirm deletion: ', resolve6);
       });
       rl.close();
       if (answer.trim().toLowerCase() !== "destroy") {
@@ -2904,6 +2905,222 @@ async function main3(options) {
     process.exit(1);
   }
 }
+async function promptUser(question, defaultValue) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const displayQuestion = defaultValue ? `${question} (${defaultValue}): ` : `${question}: `;
+  const answer = await new Promise((resolve6) => {
+    rl.question(displayQuestion, resolve6);
+  });
+  rl.close();
+  const trimmedAnswer = answer.trim();
+  return trimmedAnswer || defaultValue || "";
+}
+async function confirmOverwrite(filename) {
+  const answer = await promptUser(`File '${filename}' already exists. Overwrite? (y/n)`);
+  return answer.toLowerCase() === "y";
+}
+
+// src/lib/initHelpers.ts
+function fileExists(filePath) {
+  return fs2.existsSync(filePath);
+}
+function generateEnvTemplate() {
+  return `# Codemie API Configuration
+# Replace these placeholder values with your actual Codemie instance details
+# DO NOT commit this file to Git!
+
+# Codemie API endpoint URL
+CODEMIE_API_URL=https://your-instance.codemie.ai/api
+
+# Keycloak authentication server URL
+CODEMIE_AUTH_URL=https://your-keycloak.auth.com
+
+# Keycloak realm name
+CODEMIE_REALM=codemie
+
+# Service account client ID
+CODEMIE_CLIENT_ID=your-client-id
+
+# Service account client secret (keep this secure!)
+CODEMIE_CLIENT_SECRET=your-client-secret
+`;
+}
+function generateMinimalCodemieYaml(projectName, projectDescription) {
+  return `# Codemie Infrastructure as Code Configuration
+# For detailed examples and documentation, see:
+# - examples/assistant-examples.yaml
+# - examples/datasource-examples.yaml
+# - examples/workflow-examples.yaml
+# - examples/toolkit-examples.yaml
+# - examples/modular-config-example/
+
+version: "1"
+
+# Project identification
+project:
+  name: ${projectName}
+  description: ${projectDescription}
+
+# Environment configuration (uses variables from .env file)
+environment:
+  codemie_api_url: \${CODEMIE_API_URL}
+  auth_server_url: \${CODEMIE_AUTH_URL}
+  auth_realm_name: \${CODEMIE_REALM}
+  client_id: \${CODEMIE_CLIENT_ID}
+  client_secret: \${CODEMIE_CLIENT_SECRET}
+
+# Imported resources from existing Codemie platform
+# Reference existing assistants, datasources, and integrations to use in your IaC configurations
+imported:
+  assistants: []
+  datasources: []
+  integrations: []
+
+# Resources to be managed by IaC
+# Add your assistants, datasources, and workflows here
+resources:
+  assistants: []
+  datasources: []
+  workflows: []
+`;
+}
+async function promptAppConfig() {
+  const rootDir = await promptUser("Root directory", defaultConfig.rootDir);
+  const codemieConfig = await promptUser("Codemie config file path", defaultConfig.codemieConfig);
+  const codemieState = await promptUser("Codemie state file path", defaultConfig.codemieState);
+  const backupsDirectory = await promptUser("Backups directory", defaultConfig.backupsDirectory);
+  return {
+    rootDir,
+    codemieConfig,
+    codemieState,
+    backupsDirectory
+  };
+}
+function compareConfigWithDefaults(userConfig) {
+  return userConfig.rootDir !== defaultConfig.rootDir || userConfig.codemieConfig !== defaultConfig.codemieConfig || userConfig.codemieState !== defaultConfig.codemieState || userConfig.backupsDirectory !== defaultConfig.backupsDirectory;
+}
+async function saveConfigFile(config, defaultFilename = "config.json") {
+  const configFilename = await promptUser(`Enter config file path`, defaultFilename);
+  const configPath = path6.resolve(process.cwd(), configFilename);
+  if (fileExists(configPath)) {
+    const shouldOverwrite = await confirmOverwrite(configFilename);
+    if (!shouldOverwrite) {
+      throw new Error(`Cancelled: Configuration file not saved.`);
+    }
+  }
+  fs2.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+  return configFilename;
+}
+function suggestConfigUsage(configFileName) {
+  logger.info("\n\u{1F4CB} To use this configuration with other commands, add the `-c` flag:\n");
+  logger.info(`  codemie deploy -c ${configFileName}`);
+  logger.info(`  codemie validate -c ${configFileName}`);
+  logger.info(`  codemie preview -c ${configFileName}`);
+  logger.info(`  codemie backup -c ${configFileName}`);
+  logger.info(`  codemie destroy -c ${configFileName}
+`);
+}
+
+// src/init.ts
+async function initProject(options) {
+  logger.info("\u{1F680} Initialize Codemie IaC Project\n\n");
+  try {
+    const { appConfig } = options;
+    const envPath = path6.resolve(appConfig.rootDir, ".env");
+    const configPath = path6.resolve(appConfig.rootDir, appConfig.codemieConfig);
+    logger.info("This wizard will create the following files:");
+    logger.info(`  \u{1F4C4} .env - Environment variables with API credentials`);
+    logger.info(`  \u{1F4C4} ${appConfig.codemieConfig} - Codemie IaC configuration
+
+`);
+    logger.info("\u{1F4DD} Project Information\n");
+    const projectName = await promptUser("Project name", "my-codemie-project");
+    const projectDescription = await promptUser(
+      "Project description",
+      "AI assistants and workflows managed with Codemie IaC"
+    );
+    logger.info("\n\u{1F4CB} Application Configuration\n");
+    logger.info("Configure where Codemie IaC will store files and state:\n");
+    const userAppConfig = await promptAppConfig();
+    let configFileName;
+    if (compareConfigWithDefaults(userAppConfig)) {
+      try {
+        configFileName = await saveConfigFile(userAppConfig);
+        logger.info(`\u2713 Configuration saved to ${configFileName}
+`);
+      } catch (error) {
+        logger.warn(`
+\u26A0\uFE0F  ${error instanceof Error ? error.message : String(error)}`);
+        logger.warn("Continuing with project initialization...\n");
+      }
+    } else {
+      logger.info("\u2713 Using default configuration\n");
+    }
+    let shouldCreateEnv = true;
+    if (fileExists(envPath)) {
+      logger.warn(`\u26A0\uFE0F  File '.env' already exists`);
+      shouldCreateEnv = await confirmOverwrite(".env");
+      if (!shouldCreateEnv) {
+        logger.info("   Keeping existing .env file\n");
+      }
+    }
+    let shouldCreateConfig = true;
+    if (fileExists(configPath)) {
+      logger.warn(`\u26A0\uFE0F  File '${appConfig.codemieConfig}' already exists`);
+      shouldCreateConfig = await confirmOverwrite(appConfig.codemieConfig);
+      if (!shouldCreateConfig) {
+        logger.info(`   Keeping existing ${appConfig.codemieConfig} file
+`);
+      }
+    }
+    if (!shouldCreateEnv && !shouldCreateConfig) {
+      logger.info("\u2713 No files created (all existing files kept)\n");
+      return;
+    }
+    logger.info("\n\u{1F4C1} Creating configuration files...\n");
+    if (shouldCreateEnv) {
+      const envContent = generateEnvTemplate();
+      fs2.writeFileSync(envPath, envContent, "utf-8");
+      logger.info(`\u2713 Created .env`);
+      logger.warn(`  \u26A0\uFE0F  Remember to fill in your actual credentials!`);
+      logger.warn(`  \u26A0\uFE0F  DO NOT commit .env to Git!
+`);
+    }
+    if (shouldCreateConfig) {
+      const configContent = generateMinimalCodemieYaml(projectName, projectDescription);
+      fs2.writeFileSync(configPath, configContent, "utf-8");
+      logger.info(`\u2713 Created ${appConfig.codemieConfig}`);
+      logger.info(`  See examples/ directory for detailed configuration examples
+
+`);
+    }
+    logger.info("\u{1F389} Initialization complete!\n");
+    logger.info("Next steps:");
+    logger.info("  1. Edit .env and add your Codemie API credentials");
+    logger.info(`  2. Edit ${appConfig.codemieConfig} and add your resources`);
+    logger.info('  3. Run "codemie validate" to check your configuration');
+    logger.info('  4. Run "codemie deploy" to deploy your resources\n');
+    if (configFileName) {
+      suggestConfigUsage(configFileName);
+    }
+    logger.info("\u{1F4DA} For examples and documentation, see:");
+    logger.info("  \u2022 examples/assistant-examples.yaml");
+    logger.info("  \u2022 examples/datasource-examples.yaml");
+    logger.info("  \u2022 examples/workflow-examples.yaml");
+    logger.info("  \u2022 examples/modular-config-example/\n");
+  } catch (error) {
+    logger.error(`
+\u274C Initialization failed: ${error instanceof Error ? error.message : String(error)}
+`);
+    process.exit(1);
+  }
+}
+async function main4(options) {
+  await initProject(options);
+}
 async function previewResource(resource, resourceType, getState, checkExists, calculateChecksums) {
   const existingState = getState(resource.name);
   if (existingState) {
@@ -3094,7 +3311,7 @@ async function previewChanges(appConfig, existingClient) {
     }
   };
 }
-async function main4(options) {
+async function main5(options) {
   logger.info("\u{1F4CB} Generating deployment preview...\n");
   try {
     const { appConfig } = options;
@@ -3202,10 +3419,10 @@ var DependencyValidator = class {
     const errors = [];
     const visited = /* @__PURE__ */ new Set();
     const recursionStack = /* @__PURE__ */ new Set();
-    const dfs = (name, path13) => {
+    const dfs = (name, path15) => {
       if (recursionStack.has(name)) {
-        const cycleStart = path13.indexOf(name);
-        const cycle = [...path13.slice(cycleStart), name];
+        const cycleStart = path15.indexOf(name);
+        const cycle = [...path15.slice(cycleStart), name];
         errors.push(`Cyclic dependency detected: ${cycle.join(" \u2192 ")}`);
         return true;
       }
@@ -3214,14 +3431,14 @@ var DependencyValidator = class {
       }
       visited.add(name);
       recursionStack.add(name);
-      path13.push(name);
+      path15.push(name);
       const assistant = assistantMap.get(name);
       const subAssistantRefs = assistant?.sub_assistants || [];
       for (const subRef of subAssistantRefs) {
         if (!assistantMap.has(subRef)) {
           continue;
         }
-        if (dfs(subRef, [...path13])) {
+        if (dfs(subRef, [...path15])) {
           return true;
         }
       }
@@ -3409,7 +3626,7 @@ async function validateConfig(options) {
   }
   return { success: errors.length === 0, errors };
 }
-async function main5(options) {
+async function main6(options) {
   const { checkApi = false, appConfig } = options;
   logger.info("\u{1F50D} Validating configuration...");
   if (checkApi) {
@@ -3454,6 +3671,10 @@ async function main5(options) {
 
 // src/cli/index.ts
 program.name("codemie").description("Infrastructure as Code for Codemie platform").version(package_default.version);
+program.command("init").description("Initialize a new Codemie IaC project").action(() => {
+  const appConfig = loadAppConfig();
+  void main4({ appConfig });
+});
 program.command("deploy").description("Deploy resources to Codemie platform").option("-p, --prune", "Delete orphaned resources").option("-c, --config <path>", "Configuration file").action((options) => {
   const configPath = options.config ? path6__default.resolve(options.config) : void 0;
   const appConfig = loadAppConfig(configPath);
@@ -3472,11 +3693,11 @@ program.command("destroy").description("Destroy all IaC-managed resources").opti
 program.command("preview").description("Preview changes without applying them").option("-c, --config <path>", "Configuration file").action((options) => {
   const appConfigPath = options.config ? path6__default.resolve(options.config) : void 0;
   const appConfig = loadAppConfig(appConfigPath);
-  void main4({ appConfig });
+  void main5({ appConfig });
 });
 program.command("validate").description("Validate configuration").option("-a, --check-api", "Check for API conflicts").option("-c, --config <path>", "Configuration file").action((options) => {
   const configPath = options.config ? path6__default.resolve(options.config) : void 0;
   const appConfig = loadAppConfig(configPath);
-  void main5({ appConfig, checkApi: options.checkApi });
+  void main6({ appConfig, checkApi: options.checkApi });
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemieai/cdk",
-  "version": "0.1.288",
+  "version": "0.1.290",
   "type": "module",
   "description": "Infrastructure as Code solution for managing Codemie AI assistants, datasources, and workflows through declarative YAML configuration",
   "main": "./dist/index.js",
@@ -32,7 +32,7 @@
     "format:check": "biome format ./src",
     "lint": "npm-run-all types:check biome:check format:check",
     "lint:check": "npm-run-all types:check biome:check",
-    "lint:fix": "npm-run-all types:check eslint format",
+    "lint:fix": "npm-run-all types:check biome format",
     "test": "jest --silent --passWithNoTests",
     "test:ci": "jest --silent --coverage --ci",
     "test:coverage": "jest --silent --coverage",