Refactor xgit upload defaults to preserve history; add --message/--force controls

ReadMe.md

@@ -40,11 +40,18 @@ xgit download https://github.com/your-org/your-repo main path/to/your-folder/or-
 ### Upload folders to Git repositories
 
 ```shell
-# Upload a folder to a Git repository on a specific branch (force push)
+# Upload a folder to a Git repository on a specific branch
+# (default: preserve history, only overwrite files with same path/name)
 xgit upload path/to/source-folder https://github.com/your-org/your-repo target-branch
 
-# Upload to a specific directory in the repository (non-force push)
+# Upload to a specific directory in the repository
 xgit upload path/to/source-folder https://github.com/your-org/your-repo target-branch target/directory
+
+# Customize commit message
+xgit upload path/to/source-folder https://github.com/your-org/your-repo target-branch --message "chore: sync assets"
+
+# Discard history and force-push source folder
+xgit upload path/to/source-folder https://github.com/your-org/your-repo target-branch --force
 ```
 
 ### Manage Git submodules
@@ -60,7 +67,7 @@ xgit submodule remove path/to/submodule
 ## Commands
 
 - `xgit download <GitURL> [branchName] [folderOrFilePath] [targetFolder]` - Download folders or files from a Git repository
-- `xgit upload <sourceFolder> <GitURL> <targetBranch> [targetFolder]` - Upload a folder to a Git repository
+- `xgit upload <sourceFolder> <GitURL> <targetBranch> [targetFolder] [--message|-m <message>] [--force|-f]` - Upload a folder to a Git repository
 - `xgit submodule remove [path]` - Remove a Git submodule
 
 [1]: https://git-scm.com/

src/index.tsx

@@ -74,7 +74,9 @@ async function uploadFolder(
     sourceFolder: string,
     GitURL: string,
     targetBranch: string,
-    targetFolder?: string
+    targetFolder?: string,
+    message = 'upload by Git-utility CLI',
+    force = false
 ) {
     sourceFolder = path.resolve(sourceFolder);
 
@@ -89,24 +91,55 @@ async function uploadFolder(
 
         targetFolder = path.join(tempFolder, targetFolder);
 
-        await fs.remove(targetFolder);
         await fs.mkdirp(targetFolder);
-        await fs.copy(sourceFolder, targetFolder);
-        await fs.remove(path.join(targetFolder, '.git'));
+
+        for (const entry of await fs.readdir(sourceFolder))
+            if (entry !== '.git')
+                await fs.copy(
+                    path.join(sourceFolder, entry),
+                    path.join(targetFolder, entry),
+                    {
+                        overwrite: true
+                    }
+                );
 
         await $`git add .`;
-        await $`git commit -m "upload by Git-utility CLI"`;
+        await $`git commit -m ${message}`;
         await $`git push origin ${targetBranch}`;
     } else {
-        cd(sourceFolder);
-
-        await $`git init`;
-        await $`git remote add origin ${GitURL}`;
-        await $`git checkout -b ${targetBranch}`;
-        await $`git add .`;
-        await $`git commit -m "upload by Git-utility CLI"`;
-        await $`git push --set-upstream origin ${targetBranch} -f`;
-        await fs.remove('.git');
+        if (force) {
+            cd(sourceFolder);
+
+            await $`git init`;
+            await $`git remote add origin ${GitURL}`;
+            await $`git checkout -b ${targetBranch}`;
+            await $`git add .`;
+            await $`git commit -m ${message}`;
+            await $`git push --set-upstream origin ${targetBranch} -f`;
+            await fs.remove('.git');
+        } else {
+            const tempFolder = path.join(os.tmpdir(), new URL(GitURL).pathname);
+
+            await fs.remove(tempFolder);
+            await fs.mkdirp(tempFolder);
+            cd(tempFolder);
+
+            await $`git clone -b ${targetBranch} ${GitURL} .`;
+
+            for (const entry of await fs.readdir(sourceFolder))
+                if (entry !== '.git')
+                    await fs.copy(
+                        path.join(sourceFolder, entry),
+                        path.join(tempFolder, entry),
+                        {
+                            overwrite: true
+                        }
+                    );
+
+            await $`git add .`;
+            await $`git commit -m ${message}`;
+            await $`git push origin ${targetBranch}`;
+        }
     }
 }
 
@@ -135,13 +168,39 @@ Command.execute(
             name="upload"
             parameters="<sourceFolder> <GitURL> <targetBranch> [targetFolder]"
             description="Upload a folder to a Git repository"
+            options={{
+                message: {
+                    shortcut: 'm',
+                    parameters: '<message>',
+                    description: 'Custom commit message'
+                },
+                force: {
+                    shortcut: 'f',
+                    description:
+                        'Discard Git history and force-push source folder'
+                }
+            }}
             executor={(
-                _,
+                options,
                 sourceFolder: string,
                 GitURL: string,
                 targetBranch: string,
                 targetFolder?: string
-            ) => uploadFolder(sourceFolder, GitURL, targetBranch, targetFolder)}
+            ) => {
+                const message =
+                    typeof options.message === 'string'
+                        ? options.message
+                        : undefined;
+
+                return uploadFolder(
+                    sourceFolder,
+                    GitURL,
+                    targetBranch,
+                    targetFolder,
+                    message,
+                    options.force === true
+                );
+            }}
         />
         <Command name="submodule" description="Manage Git submodules">
             <Command