lucy-cli 2.0.0-alpha.7 → 2.0.0-beta.1

package/old/sync.js

@@ -0,0 +1,88 @@
+import chalk from "chalk";
+import { green, orange, red } from "./index.js";
+import readline from 'node:readline';
+import veloAPI from 'velo-sync/dist/velo/velo-api.js';
+import syncTask from 'velo-sync/dist/tasks/sync-task.js';
+import { readConfig, saveConfig } from "./helpers.js";
+import optimist from 'optimist';
+import migrateFileCache from 'velo-sync/dist/tasks/migrate-files-cache-task.js';
+function printUsage() {
+    console.log('Usage:  ');
+    console.log('');
+    console.log('Commands:');
+    console.log('  init          generates a config file for the import / export / sync process');
+    console.log('  is-alive      tests the config and the connection to the site');
+    console.log('  sync          runs the sync process');
+    console.log('  import        runs an import process');
+    console.log('  migrate       migrate existing nedb cache to sqlite cache (.upload-cache.db => .upload-cache.sqlite.db)');
+}
+function syncOrImportTask(importOnly) {
+    let argv = optimist
+        .usage(`Usage: $0 ${importOnly ? 'import' : 'sync'} -f <scv filename> -c <collection>`)
+        .demand('f')
+        .alias('f', 'filename')
+        .describe('f', 'csv filename to import')
+        .demand('c')
+        .describe('c', 'the name of the collection to import into')
+        .alias('c', 'collection')
+        .demand('s')
+        .describe('s', 'schema file describing the fields of the collection')
+        .alias('s', 'schema')
+        .describe('dry', 'dry-run that does not upload any data or files, and does not remove or update anything on the site')
+        .alias('dry', 'dryrun')
+        .parse(process.argv.slice(3));
+    let filename = argv.filename;
+    let collection = argv.collection;
+    let schema = argv.schema;
+    let dryrun = argv.dryrun;
+    //@ts-ignore
+    syncTask.default(filename, collection, schema, importOnly, dryrun);
+}
+export async function sync(moduleSettings, projectSettings) {
+    if (moduleSettings.args.includes('-h') || moduleSettings.args.includes('help'))
+        return printUsage();
+    if (moduleSettings.args.includes('init')) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true
+        });
+        async function askQuestion(query) {
+            return new Promise((resolve) => rl.question(query, (answer) => resolve(answer)));
+        }
+        console.log(chalk.yellow('hello to velo-sync init'));
+        let siteUrl = await askQuestion(orange('what is the url of the site homepage? '));
+        let secret = await askQuestion(orange('what is the velo-sync secret? '));
+        rl.close();
+        let config = { siteUrl, secret };
+        await saveConfig(config, moduleSettings.veloConfigName);
+        return console.log(chalk.green("🐕" + ' => config saved!'));
+    }
+    if (moduleSettings.args.includes('is-alive')) {
+        try {
+            let config = await readConfig(moduleSettings.veloConfigName);
+            console.log("🐕" + green(` => checking if the API for site ${chalk.greenBright(config.siteUrl)} is alive...`));
+            await veloAPI.isAlive(config);
+            return console.log(chalk.green("🐕" + ` => API of site ${chalk.greenBright(config.siteUrl)} is working and alive!!!`));
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                return console.log((`💩 ${red.underline.bold("=> Failed to check endpoint")} ${orange(e.message)}`));
+            }
+        }
+    }
+    if (moduleSettings.args.includes('sync')) {
+        return syncOrImportTask(false);
+    }
+    if (moduleSettings.args.includes('import')) {
+        return syncOrImportTask(true);
+    }
+    if (moduleSettings.args.includes('export')) {
+        return console.log((`💩 ${red.underline.bold("=> Not implemented")}`));
+    }
+    if (moduleSettings.args.includes('migrate')) {
+        //@ts-ignore
+        migrateFileCache.default();
+    }
+}
+//# sourceMappingURL=sync.js.map

package/old/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["sync.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "type": "module",
   "name": "lucy-cli",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.0-beta.1",
   "description": "Lucy Framework for WIX Studio Editor",
   "main": ".dist/index.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
     "build": "tsc",
-    "dev": "tsc -w"
+    "dev": "tsc -w",
+    "postinstall": "patch-package"
   },
   "repository": {
     "type": "git",
@@ -36,14 +36,17 @@
     "@effect/platform-node": "^0.94.0",
     "@swc/core": "^1.9.3",
     "@wix/cli": "^1.0.83",
+    "@wix/data": "^1.0.270",
     "@wix/eslint-plugin-cli": "^1.0.1",
+    "@wix/sdk": "^1.15.26",
+    "@wix/sites": "^1.0.24",
     "chalk": "^5.3.0",
     "effect": "^3.17.1",
     "enquirer": "^2.4.1",
     "glob": "11.0.3",
     "gulp": "5.0.1",
     "gulp-clean": "^0.4.0",
-    "gulp-cli": "3.0.0",
+    "gulp-cli": "3.1.0",
     "gulp-concat": "^2.6.1",
     "gulp-exec": "^5.0.0",
     "gulp-flatmap": "^1.0.2",
@@ -62,22 +65,22 @@
     "gulp-typescript": "5.0.1",
     "gulp-wait": "^0.0.2",
     "jest": "30.0.5",
-    "merge-stream": "^2.0.0",
     "merge2": "^1.4.1",
     "optimist": "^0.6.1",
+    "patch-package": "^8.0.0",
     "prettier": "^3.0.3",
     "sass": "^1.65.1",
     "simple-git": "^3.20.0",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.1",
-    "typedoc": "0.26.11",
-    "typescript": "^5.6.3",
+    "typedoc": "0.28.9",
+    "typescript": "5.9.2",
     "velo-sync": "^0.0.9",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "@types/glob": "9.0.0",
+    "@types/glob": "8.1.0",
     "@types/gulp": "^4.0.17",
     "@types/gulp-concat": "^0.0.37",
     "@types/gulp-insert": "^0.5.13",
@@ -87,21 +90,17 @@
     "@types/gulp-sass": "^5.0.4",
     "@types/gulp-tap": "^1.0.5",
     "@types/jest": "30.0.0",
-    "@types/merge-stream": "2.0.0",
     "@types/merge2": "^1.4.4",
     "@types/optimist": "^0.0.33",
     "@types/yargs": "^17.0.33",
-    "@typescript-eslint/eslint-plugin": "8.14.0",
-    "@typescript-eslint/parser": "8.14.0",
-    "@typescript-eslint/utils": "8.14.0",
-    "eslint": "9.14.0",
+    "@typescript-eslint/eslint-plugin": "8.39.0",
+    "@typescript-eslint/parser": "8.39.0",
+    "@typescript-eslint/utils": "8.39.0",
+    "eslint": "9.32.0",
     "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-jsdoc": "51.4.1",
+    "eslint-plugin-jsdoc": "52.0.4",
     "eslint-plugin-named-import-spacing": "^1.0.3",
     "eslint-plugin-simple-import-sort": "12.1.1",
-    "i": "^0.3.7",
-    "npm": "^11.0.0",
-    "ts-node": "^10.9.1"
-  },
-  "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"
+    "ts-node": "10.9.2"
+  }
 }

package/patches/velo-sync+0.0.9.patch

@@ -0,0 +1,13 @@
+diff --git a/node_modules/velo-sync/dist/tasks/sync-task.js b/node_modules/velo-sync/dist/tasks/sync-task.js
+index bf9e91c..9a351ec 100644
+--- a/node_modules/velo-sync/dist/tasks/sync-task.js
++++ b/node_modules/velo-sync/dist/tasks/sync-task.js
+@@ -30,7 +30,7 @@ exports.default = syncTask;
+ function runImport(filename, collection, schemaFilename, importOnly, dryrun) {
+     return new Promise(async (resolve) => {
+         let stats = new statistics_1.LoggingStatistics();
+-        let config = await config_1.readConfig('config.json');
++        let config = await config_1.readConfig('wix-sync.json');
+         let schema = await schema_1.readSchema(schemaFilename);
+         let loggerRejectsReporter = new rejects_reporter_1.LoggerRejectsReporter(stats);
+         let uploadFileCache = new SQLiteFileUploadCache_1.SQLiteFileUploadCache('./.upload-cache.sqlite.db');

package/src/args.ts

@@ -1,36 +1,81 @@
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
+import { initTypes, LucyArgs, taskNames, syncActions } from "./schemas/types.js";
+import { createRequire } from "node:module";
 
-// It's a good practice to define an interface for your arguments
-// for type safety throughout your application.
-export interface LucyArgs {
-    [x: string]: unknown;
-    // This will hold the command used, e.g., 'init'
-    _: (string | number)[];
-    $0: string;
-    // Arguments for the 'init' command
-    type?: 'velo' | 'expo' | 'blocks';
-}
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
 
 export async function get_args(): Promise<LucyArgs> {
     const argv = await yargs(hideBin(process.argv))
         .usage('Usage: $0 <command> [options]')
-        .command('init <type>', 'Initialize a new Lucy project', (yargs) => {
-            return yargs.positional('type', {
+        .command('init <initType>', 'Initialize a new Lucy project', (yargs) => {
+            return yargs.positional('initType', {
                 describe: 'The type of project to initialize',
-                choices: ['velo', 'expo', 'blocks'] as const,
-                demandOption: true, // Makes this positional argument required
+                choices: initTypes,
+                demandOption: true,
+            })
+        }).option('force', {
+            alias: 'f',
+            type: 'boolean',
+            description: 'Run with force'
+        })
+        .command('open', 'Open the Lucy home directory')
+        .command('task <tasksName>', 'Run a task', (yargs) => {
+            return yargs.positional('tasksName', {
+                describe: 'The task to run',
+                choices: taskNames,
+                demandOption: true,
+            })
+        })
+        .command('wix-sync <syncAction>', 'Run a velo-sync action', (yargs) => {
+            return yargs.positional("syncAction", {
+                describe: "The velo-sync action to run",
+                choices: syncActions,
+                demandOption: true,
+            })
+            .option('input', {
+                alias: 'i',
+                type: 'string',
+                describe: 'The CSV file to import',
+                demandOption: false,
+            })
+            .option('c', {
+                alias: 'collection',
+                type: 'string',
+                describe: 'The name of the collection to import data into',
+                demandOption: false,
+            })
+            .option('s', {
+                alias: 'schema',
+                type: 'string',
+                describe: 'The schema file',
+                demandOption: false,
+            })
+            .option('d', {
+                type: 'boolean',
+                describe: 'Run in dry-run mode',
+                demandOption: false,
+            });
+        })
+        .command('wix-sdk <wixSDKAction>', 'Run a velo-sync action', (yargs) => {
+            return yargs.positional("wixSDKAction", {
+                describe: "The velo-sync action to run",
+                choices: syncActions,
+                demandOption: true,
             });
         })
-        // Enforce that a command must be provided (e.g., 'init')
         .demandCommand(1, 'You need to provide a command. Use --help for a list of commands.')
+        .version('v', 'Show version number', pkg.version)
+        .alias('v', 'version')
         .help()
         .alias('h', 'help')
         .strict()
-        .wrap(yargs().terminalWidth()) // Wrap help text to terminal width
-        .epilogue('For more information, visit https://github.com/your-repo/wix-lucy-cli') // Example of a relevant epilogue
+        .wrap(yargs().terminalWidth())
+        .epilogue('For more information, visit https://github.com/your-repo/wix-lucy-cli')
         .parseAsync();
 
     // The cast is now safer with the defined interface.
+    
     return argv as LucyArgs;
 }

package/src/commands/checks.ts

@@ -0,0 +1,51 @@
+import { Effect, Schema } from "effect/index";
+import { FileSystem, Path } from "@effect/platform"
+import { Config, lucyJsonName } from "../config.js";
+import { logger } from "../utils/logger.js";
+import { AppError } from "../error.js";
+import { JsonSchema } from "../schemas/index.js";
+
+export const isDirectoryClean =(excludes: string[] = []) => {
+    return Effect.gen(function*() {
+        const fs = yield* FileSystem.FileSystem;
+        const config = yield* Config;
+
+        const files = yield* fs.readDirectory(config.config.cwd);
+        const allExcludes = [...excludes, '.git', lucyJsonName];
+        const filteredFiles = files.filter(file => !allExcludes.includes(file));
+
+        return filteredFiles.length > 0 ? false : true;
+    });
+}
+
+export const checkForDirty = (excludes: string[] = []) => {
+    return Effect.gen(function*() {
+        const config = yield* Config;
+        const clean = yield* isDirectoryClean(excludes);
+        if(!clean && !config.config.force) {
+            logger.alert("The current directory is not empty. Please run this command in an empty directory.")
+            yield* Effect.fail(new AppError({ message: "Directory is not clean", cause: new Error("Directory is not clean") }));
+            return;
+        }
+        if(config.config.lucySettings.initialized && !config.config.force) {
+            logger.alert("Lucy is already initialized in this directory. Use --force to reinitialize.")
+            yield* Effect.fail(new AppError({ message: "Lucy is already initialized in this directory", cause: new Error("Lucy is already initialized in this directory") }));
+            return;
+        }
+
+        if ((!clean && config.config.force) || (config.config.lucySettings.initialized && config.config.force)) logger.alert("Forced initialization!")
+    });
+}
+export const checkForVelo = () => {
+    return Effect.gen(function*() {
+        const config = yield* Config;
+        const fs = yield* FileSystem.FileSystem;
+        const path = yield* Path.Path;
+
+        const wixConfigPath = path.join(config.config.cwd, 'wix.config.json'); 
+        const wixConfigRaw = yield* fs.readFileString(wixConfigPath);
+        const wixConfigJSON =( yield* Schema.decodeUnknown(JsonSchema)(wixConfigRaw)) as any;
+
+        if(!(wixConfigJSON.siteId)) return yield* Effect.fail(new AppError({ message: "This directory is not a Velo project. Please run this command in a Velo project directory.", cause: new Error("Not a Velo project") }));
+    });
+}

package/src/commands/cleanup.ts

@@ -0,0 +1,11 @@
+import { Effect } from "effect/index";
+import { Config } from "../config.js";
+import { FileSystem, Path } from "@effect/platform"
+
+export const cleanup = Effect.gen(function* () {
+    const config = yield* Config;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+
+    yield* fs.remove(path.join(config.config.cwd, "package-lock.json"), { force: true })
+});

package/src/commands/copy.ts

@@ -0,0 +1,28 @@
+import { Effect } from "effect/index";
+import { Path } from "@effect/platform"
+import { FileSystem } from "@effect/platform"
+import { Config, syncDataName, syncFilesSource } from "../config.js";
+
+export const copyTemplateFiles = Effect.gen(function*() {
+    const fs = yield* FileSystem.FileSystem;
+    const config = yield* Config;
+    const path = yield * Path.Path;
+
+    const templateFiles = yield* fs.readDirectory(config.config.templateFiles)
+    yield* Effect.forEach(
+        templateFiles,
+        (file) => fs.copy(path.join(config.config.templateFiles, file), path.join(config.config.cwd, file), { overwrite: true })
+    )
+})
+export const copySyncFiles = Effect.gen(function*() {
+    const fs = yield* FileSystem.FileSystem;
+    const config = yield* Config;
+    const path = yield * Path.Path;
+
+    const synDataFiles = yield* fs.readDirectory(syncFilesSource)
+    yield* fs.makeDirectory(path.join(config.config.cwd, syncDataName));
+    yield* Effect.forEach(
+        synDataFiles,
+        (file) => fs.copy(path.join(syncFilesSource, file), path.join(config.config.cwd, syncDataName, file), { overwrite: true })
+    )
+})

package/src/commands/edit.ts

@@ -0,0 +1,81 @@
+import { Effect, Schema } from "effect/index";
+import { Config, lucyJsonPath } from "../config.js";
+import { FileSystem, Path } from "@effect/platform"
+import { logger } from "../utils/logger.js";
+import { JsonSchema } from "../schemas/index.js";
+import { LucySettings } from "../schemas/lucy.js";
+
+export const editJson = (json: any, keys: string[], values: string[] | Object[]) => {
+    return Effect.gen(function*() {
+        const config = yield* Config;
+
+        for (const key of keys){
+			const index = keys.indexOf(key);
+			const value = values[index];
+			json[key] = value;
+		}
+    })
+}
+
+export const mergeLucySettings2PackageJson = Effect.gen(function*() {
+    const config = yield* Config;
+    const lucySettings = config.config.lucySettings;
+    const packageJson = config.config.packageJson;
+
+    if (Object.keys(lucySettings.scripts).length > 0) {
+        yield* editJson(packageJson, ['scripts'], [{...packageJson.scripts, ...lucySettings.scripts}]);
+    }
+})
+
+export const setModule = Effect.gen(function*() {
+    const config = yield* Config;
+    const lucySettings = config.config.lucySettings;
+    const packageJson = config.config.packageJson;
+
+	yield* editJson(packageJson, ['type'], ['module']);
+})
+
+export const mergeAdditions = Effect.gen(function*() {
+    const config = yield* Config;
+    const lucySettings = config.config.lucySettings;
+    const packageJson = config.config.packageJson;
+
+	config.config.packageJson = {
+        ...packageJson,
+        ...lucySettings.additionalPkgProps,
+    }
+})
+
+export const setProjectName = Effect.gen(function*() {
+    const config = yield* Config;
+    const packageJson = config.config.packageJson;
+
+	yield * editJson(packageJson, ["name"], [config.config.projectName]);
+})
+
+export const setInitialized = Effect.gen(function*() {
+    const fs = yield* FileSystem.FileSystem;
+    const lucyRaw = yield* fs.readFileString(lucyJsonPath);
+    const lucyJSON = (yield* Schema.decodeUnknown(JsonSchema)(lucyRaw)) as any;
+    lucyJSON.initialized = true;
+
+    yield* fs.writeFileString(lucyJsonPath, JSON.stringify(lucyJSON, null, 2));
+})
+
+export const stringReplace = (filePath: string, keys: string[], values: string[]) => {
+    return Effect.gen(function*() {
+        const fs = yield* FileSystem.FileSystem;
+        let modifiedContent: string = '';
+
+        logger.action(`Replacing ${keys} with ${values} in ${filePath}`);
+        const data = yield* fs.readFileString(filePath, 'utf8');
+        for (const key of keys){
+			const index = keys.indexOf(key);
+			const value = values[index];
+			const regex = new RegExp(`${key}`, 'g');
+			modifiedContent = data.replace(regex, `${value}`);
+		}
+        yield* fs.writeFileString(filePath, modifiedContent);
+        logger.info(`Updated file ${filePath}`);
+    })
+}

package/src/commands/exec.ts

@@ -0,0 +1,69 @@
+import { Effect, Schema } from "effect/index";
+import { Config } from "../config.js";
+import { Command } from "@effect/platform/index";
+import { logger } from "../utils/logger.js";
+import { FileSystem } from "@effect/platform"
+import Enquirer from "enquirer";
+import { AppError } from "../error.js";
+
+export const execCommand = Effect.gen(function*() {
+    const config = yield* Config;
+    const cmds = config.config.lucySettings.additionalCommands ?? [];
+    logger.info("Executing additional commands...", cmds);
+    if (cmds.length > 0) {
+        logger.info("Executing additional commands");
+      yield *
+        Effect.all([
+            ...cmds.map((cmd) => {
+            return Command.make(cmd[0], ...cmd.slice(1))
+                .pipe()
+                .pipe(Command.stdout("inherit"), Command.stderr("inherit"), Command.exitCode);
+            }),
+        ]);
+    }
+})
+
+export const open = Effect.scoped(Effect.gen(function*() {
+    const config = yield* Config;
+    const fs = yield* FileSystem.FileSystem
+    console.log("Opening Lucy home directory:", config.config.lucyHome);
+    let command: ReturnType<typeof Command.make>;
+    switch (process.platform) {
+        case 'darwin': command = Command.make('open', config.config.lucyHome); break;
+        case 'win32': command = Command.make('start', config.config.lucyHome); break;
+        default: command = Command.make('xdg-open', config.config.lucyHome); break;
+    }
+
+    command.pipe().pipe(Command.stdout("inherit"), Command.stderr("inherit"), Command.exitCode);
+    yield* command.pipe().pipe(Command.stdout("inherit"), Command.stderr("inherit"), Command.exitCode);
+}))
+
+export const openVSCode = Effect.gen(function*() {
+    const config = yield* Config;
+    const open = Command.make(
+        "code", 
+        config.config.cwd,
+        ).pipe(
+        Command.stdout("inherit"), // Stream stdout to process.stdout
+        Command.stderr("inherit"), // Stream stderr to process.stderr
+        Command.exitCode // Get the exit code
+    )
+    const overwriteQuestion = new Enquirer();
+    const openVScodeQuestion = yield* Effect.tryPromise({
+        try: () => overwriteQuestion.prompt({
+            type: 'confirm',
+            name: 'openVSCode',
+            message: `Do you want to open the project in VSCode?`,
+        }),
+        catch: (e) => {
+            return new AppError({
+                cause: e,
+                message: "Error opening VSCode",
+            });
+        }
+    })
+    const choice = yield* Schema.decodeUnknown(Schema.Struct({ openVSCode: Schema.Boolean }))(openVScodeQuestion);
+    if (choice.openVSCode) {
+        yield* open
+    }
+})

package/src/commands/git.ts

@@ -0,0 +1,113 @@
+import { Effect } from 'effect/index';
+import { simpleGit, SimpleGit } from 'simple-git';
+import { Config } from '../config.js';
+import { AppError } from '../error.js';
+import { logger } from '../utils/logger.js';
+import { FileSystem, Path } from "@effect/platform"
+
+export const isSubmoduleRegistered = (git: SimpleGit, submoduleName: string) => Effect.gen(function* () {
+    const value = yield* Effect.tryPromise({
+        try: () => git.getConfig(`submodule.${submoduleName}.url`),
+        catch: (error) => {
+            return new AppError({
+                cause: error,
+                message: "Failed to get submodule url",
+            });
+        }
+    })
+    return !!value.value;
+})
+
+export const gitInit = (update: boolean = false) => Effect.gen(function* () {
+    const config = yield* Config;
+    const git = simpleGit({ baseDir: config.config.cwd });
+    const path = yield * Path.Path;
+
+    const isGit = yield* Effect.tryPromise({
+        try: () => git.checkIsRepo(),
+        catch: (error) => {
+            return new AppError({
+                cause: error,
+                message: "Failed to check if the directory is a git repository",
+            });
+        }
+    })
+
+    if(!isGit) {
+        yield* Effect.tryPromise({
+            try: () => git.init(),
+            catch: (error) => {
+                return new AppError({
+                    cause: error,
+                    message: "Failed to initialize git repository",
+                });
+            }
+        })
+    }
+
+    if (!config.config.lucySettings.modules) {
+        logger.alert('No submodules defined in settings, skipping.');
+		return;
+	}
+    yield* initSubmodules(update);
+})
+
+export const initSubmodules = (update: boolean = false) => Effect.gen(function* () {
+    const config = yield* Config;
+    const git = simpleGit({ baseDir: config.config.cwd });
+    const path = yield* Path.Path;
+    const fs = yield* FileSystem.FileSystem;
+    const gitmodulesPath = path.join(config.config.cwd, ".gitmodules");
+
+    for (const [name, repo] of Object.entries(config.config.lucySettings.modules)) {
+        logger.action(`Processing submodule ${name}`);
+		const clonePath = repo.path || path.join(config.config.lucySettings.defaultModulePath ?? '', name);
+
+        const isRegistered = yield* isSubmoduleRegistered(git, clonePath);
+        const isConfiguredInFile = (yield* fs.exists(gitmodulesPath)) && (yield* fs.readFileString(gitmodulesPath, 'utf-8')).includes(`[submodule "${clonePath}"]`);
+
+        if (!isConfiguredInFile || config.config.force) {
+            logger.action(`Adding/updating submodule ${name} at ${clonePath}...`);
+            // If git already has a config entry, we must use --force to repair it.
+            const submoduleArgs = () => {
+                if (update) {
+                    return ['add', '--force', repo.source, clonePath];
+                }
+                return ['add', ...(config.config.force || isRegistered ? ['--force'] : []), repo.source, clonePath];
+            }
+            // await git.subModule(submoduleArgs);
+            yield* Effect.tryPromise({
+                try: () => git.subModule(submoduleArgs()),
+                catch: (error) => {
+                    return new AppError({
+                        cause: error,
+                        message: "Failed to add submodule",
+                    });
+                }
+            })
+        } else {
+            logger.alert(`Submodule ${name} at ${clonePath} already registered. Skipping add.`);
+        }
+
+        yield* Effect.tryPromise({
+            try: () => git.submoduleUpdate(['--init', '--recursive', clonePath]),
+            catch: (error) => {
+                return new AppError({
+                    cause: error,
+                    message: "Failed to update submodule",
+                });
+            }
+        })
+        yield* Effect.tryPromise({
+            try: () => simpleGit({ baseDir: path.join(config.config.cwd, clonePath) }).checkout(repo.branch),
+            catch: (error) => {
+                return new AppError({
+                    cause: error,
+                    message: `Failed to checkout submodule ${repo} branch ${repo.branch}`,
+                });
+            }
+        })
+    }
+    logger.success("All modules processed!");
+
+})