@teambit/harmony.content.cli-reference 1.95.74 → 1.95.76

package/dist/cli-reference.json

@@ -1281,6 +1281,68 @@
             }
         ]
     },
+    {
+        "name": "resume-export <export-id> <remotes...>",
+        "alias": "",
+        "options": [],
+        "description": "EXPERIMENTAL. resume failed export",
+        "extendedDescription": "resume failed export to persist the pending objects on the given remotes.\nthe export-id is the id the client got in the error message during the failure.\nalternatively, exporting to any one of the failed scopes, throws server-is-busy error with the export-id",
+        "group": "collaborate",
+        "private": true,
+        "remoteOp": true
+    },
+    {
+        "name": "export [component-patterns...]",
+        "alias": "e",
+        "options": [
+            [
+                "e",
+                "eject",
+                "replace the exported components with their corresponding packages (to use these components without further maintaining them)"
+            ],
+            [
+                "a",
+                "all",
+                "export all components, including non-staged (useful when components in the remote scope are corrupted or missing)"
+            ],
+            [
+                "",
+                "all-versions",
+                "export not only staged versions but all of them (useful when versions in the remote scope are corrupted or missing)"
+            ],
+            [
+                "",
+                "origin-directly",
+                "EXPERIMENTAL. avoid export to the central hub, instead, export directly to the original scopes. not recommended!"
+            ],
+            [
+                "",
+                "resume <string>",
+                "in case the previous export failed and suggested to resume with an export-id, enter the id"
+            ],
+            [
+                "",
+                "ignore-missing-artifacts",
+                "EXPERIMENTAL. don't throw an error when artifact files are missing. not recommended, unless you're sure the artifacts are in the remote"
+            ],
+            [
+                "j",
+                "json",
+                "show output in json format"
+            ]
+        ],
+        "description": "export components from the workspace to remote scopes",
+        "extendedDescription": "bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well\n  `bit export [id...]` => export the given ids to their current scope\n  you can use a pattern for multiple ids, such as bit export remote-scope \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
+        "group": "collaborate",
+        "private": false,
+        "remoteOp": true,
+        "arguments": [
+            {
+                "name": "component-patterns...",
+                "description": "component IDs, component names, or component patterns (separated by space). Use patterns to export groups of components using a common scope or namespace. E.g., \"utils/*\" (wrap with double quotes)"
+            }
+        ]
+    },
     {
         "name": "import [component-patterns...]",
         "alias": "",
@@ -1510,130 +1572,350 @@
         ]
     },
     {
-        "name": "insights [names...]",
+        "name": "create <template-name> <component-names...>",
         "alias": "",
         "options": [
             [
-                "l",
-                "list",
-                "list all insights"
+                "n",
+                "namespace <string>",
+                "sets the component's namespace and nested dirs inside the scope"
             ],
             [
-                "j",
-                "json",
-                "return the insights in json format"
+                "s",
+                "scope <string>",
+                "sets the component's scope-name. if not entered, the default-scope will be used"
+            ],
+            [
+                "a",
+                "aspect <string>",
+                "aspect-id of the template. helpful when multiple aspects use the same template name"
+            ],
+            [
+                "p",
+                "path <string>",
+                "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
+            ],
+            [
+                "e",
+                "env <string>",
+                "set the component's environment. (overrides the env from variants and the template)"
             ]
         ],
-        "description": "Insights on component graph",
+        "description": "create a new component (source files and config) using a template.",
         "extendedDescription": "",
         "group": "development",
-        "private": true
+        "private": false,
+        "arguments": [
+            {
+                "name": "template-name",
+                "description": "the template for generating the component \n(run 'bit templates' for a list of available templates)"
+            },
+            {
+                "name": "component-names...",
+                "description": "a list of component names to generate"
+            }
+        ],
+        "examples": [
+            {
+                "cmd": "bit create react ui/button",
+                "description": "creates a component named 'ui/button' using the 'react' template"
+            },
+            {
+                "cmd": "bit create react ui/button pages/register",
+                "description": "creates two components, 'ui/button' and 'pages/register', using the 'react' template"
+            },
+            {
+                "cmd": "bit create react ui/button --scope my-org.my-scope",
+                "description": "creates a component named 'ui/button' and sets it scope to 'my-org.my-scope'. \nby default, the scope is the `defaultScope` value, configured in your `workspace.jsonc`."
+            },
+            {
+                "cmd": "bit create react ui/button --env teambit.community/envs/community-react@1.95.13",
+                "description": "creates a component named 'ui/button' and sets it to use the 'community-react' env. \n(the template's default env is 'teambit.react/react')."
+            }
+        ]
     },
     {
-        "name": "component-issues",
+        "name": "templates",
         "alias": "",
         "options": [
             [
-                "j",
-                "json",
-                "json format"
+                "s",
+                "show-all",
+                "show hidden templates"
             ]
         ],
-        "description": "list available component-issues",
-        "extendedDescription": "",
+        "description": "list templates for \"bit create\" and \"bit new\"",
+        "extendedDescription": "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)",
         "group": "development",
         "private": false
     },
     {
-        "name": "tag [component-patterns...]",
-        "alias": "t",
+        "name": "new <template-name> <workspace-name>",
+        "alias": "",
         "options": [
             [
-                "m",
-                "message <message>",
-                "a log message describing latest changes"
+                "a",
+                "aspect <aspect-id>",
+                "aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision"
             ],
             [
-                "",
-                "unmodified",
-                "include unmodified components (by default, only new and modified components are tagged)"
+                "d",
+                "default-scope <scope-name>",
+                "set defaultScope in the new workspace.jsonc"
             ],
             [
                 "",
-                "editor [editor]",
-                "EXPERIMENTAL. open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim)."
+                "standalone",
+                "DEPRECATED. use --skip-git instead"
             ],
             [
-                "v",
-                "ver <version>",
-                "tag with the given version"
+                "s",
+                "skip-git",
+                "skip generation of Git repository"
             ],
             [
-                "l",
-                "increment <level>",
-                "options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch"
+                "e",
+                "empty",
+                "empty workspace with no components (relevant for templates that add components by default)"
             ],
             [
                 "",
-                "prerelease-id <id>",
-                "prerelease identifier (e.g. \"dev\" to get \"1.0.0-dev.1\")"
+                "load-from <path-to-template>",
+                "path to the workspace containing the template. helpful during a development of a workspace-template"
+            ]
+        ],
+        "description": "create a new workspace from a template",
+        "extendedDescription": "",
+        "group": "start",
+        "private": false,
+        "arguments": [
+            {
+                "name": "template-name",
+                "description": "the name of the workspace template (run 'bit templates', outside of a workspace, to get a list of available templates)"
+            },
+            {
+                "name": "workspace-name",
+                "description": "the name for the new workspace and workspace directory"
+            }
+        ]
+    },
+    {
+        "name": "build [component-pattern]",
+        "alias": "",
+        "options": [
+            [
+                "a",
+                "all",
+                "build all components, not only modified and new"
             ],
             [
-                "p",
-                "patch",
-                "syntactic sugar for \"--increment patch\""
+                "d",
+                "dev",
+                "run the pipeline in dev mode"
             ],
             [
                 "",
-                "minor",
-                "syntactic sugar for \"--increment minor\""
+                "install",
+                "install core aspects in capsules"
             ],
             [
                 "",
-                "major",
-                "syntactic sugar for \"--increment major\""
+                "reuse-capsules",
+                "avoid deleting the capsules root-dir before starting the build"
             ],
             [
                 "",
-                "pre-release [identifier]",
-                "syntactic sugar for \"--increment prerelease\" and `--prerelease-id <identifier>`"
+                "tasks <string>",
+                "build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.\nspecify the task-name (e.g. \"TypescriptCompiler\") or the task-aspect-id (e.g. teambit.compilation/compiler)"
             ],
             [
                 "",
-                "snapped",
-                "EXPERIMENTAL. tag components that their head is a snap (not a tag)"
+                "cache-packages-on-capsule-root",
+                "set the package-manager cache on the capsule root"
             ],
             [
                 "",
-                "unmerged",
-                "EXPERIMENTAL. complete a merge process by tagging the unmerged components"
+                "list-tasks <string>",
+                "list tasks of an env or a component-id for each one of the pipelines: build, tag and snap"
             ],
             [
                 "",
                 "skip-tests",
                 "skip running component tests during tag process"
-            ],
+            ]
+        ],
+        "description": "run set of tasks for build",
+        "extendedDescription": "",
+        "group": "development",
+        "private": false,
+        "arguments": [
+            {
+                "name": "component-pattern",
+                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+            }
+        ]
+    },
+    {
+        "name": "artifacts <component-pattern>",
+        "alias": "",
+        "options": [
             [
                 "",
-                "skip-auto-tag",
-                "skip auto tagging dependents"
+                "aspect <aspect-id>",
+                "show/download only artifacts generated by this aspect-id"
             ],
             [
                 "",
-                "soft",
-                "do not persist. only keep note of the changes to be made"
+                "task <task-id>",
+                "show/download only artifacts generated by this task-id"
             ],
             [
                 "",
-                "persist",
-                "persist the changes generated by --soft tag"
+                "files <glob>",
+                "show/download only artifacts matching the given files or the glob pattern (wrap glob patterns in quotes)"
             ],
             [
                 "",
-                "disable-tag-pipeline",
-                "skip the tag pipeline to avoid publishing the components"
-            ],
-            [
+                "out-dir <string>",
+                "download the files to the specified dir"
+            ]
+        ],
+        "description": "EXPERIMENTAL. list and download components artifacts",
+        "extendedDescription": "artifacts are created on isolated capsules during tag or snap commands.\nexample of artifacts are dists files generated by a compiler, a JUnit.xml file generated by a tester\nand a package.tgz file generated by pkg aspect.\n",
+        "group": "development",
+        "private": false,
+        "arguments": [
+            {
+                "name": "component-pattern",
+                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+            }
+        ]
+    },
+    {
+        "name": "insights [names...]",
+        "alias": "",
+        "options": [
+            [
+                "l",
+                "list",
+                "list all insights"
+            ],
+            [
+                "j",
+                "json",
+                "return the insights in json format"
+            ]
+        ],
+        "description": "Insights on component graph",
+        "extendedDescription": "",
+        "group": "development",
+        "private": true
+    },
+    {
+        "name": "component-issues",
+        "alias": "",
+        "options": [
+            [
+                "j",
+                "json",
+                "json format"
+            ]
+        ],
+        "description": "list available component-issues",
+        "extendedDescription": "",
+        "group": "development",
+        "private": false
+    },
+    {
+        "name": "tag [component-patterns...]",
+        "alias": "t",
+        "options": [
+            [
+                "m",
+                "message <message>",
+                "a log message describing latest changes"
+            ],
+            [
+                "",
+                "unmodified",
+                "include unmodified components (by default, only new and modified components are tagged)"
+            ],
+            [
+                "",
+                "editor [editor]",
+                "EXPERIMENTAL. open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim)."
+            ],
+            [
+                "v",
+                "ver <version>",
+                "tag with the given version"
+            ],
+            [
+                "l",
+                "increment <level>",
+                "options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch"
+            ],
+            [
+                "",
+                "prerelease-id <id>",
+                "prerelease identifier (e.g. \"dev\" to get \"1.0.0-dev.1\")"
+            ],
+            [
+                "p",
+                "patch",
+                "syntactic sugar for \"--increment patch\""
+            ],
+            [
+                "",
+                "minor",
+                "syntactic sugar for \"--increment minor\""
+            ],
+            [
+                "",
+                "major",
+                "syntactic sugar for \"--increment major\""
+            ],
+            [
+                "",
+                "pre-release [identifier]",
+                "syntactic sugar for \"--increment prerelease\" and `--prerelease-id <identifier>`"
+            ],
+            [
+                "",
+                "snapped",
+                "EXPERIMENTAL. tag components that their head is a snap (not a tag)"
+            ],
+            [
+                "",
+                "unmerged",
+                "EXPERIMENTAL. complete a merge process by tagging the unmerged components"
+            ],
+            [
+                "",
+                "skip-tests",
+                "skip running component tests during tag process"
+            ],
+            [
+                "",
+                "skip-auto-tag",
+                "skip auto tagging dependents"
+            ],
+            [
+                "",
+                "soft",
+                "do not persist. only keep note of the changes to be made"
+            ],
+            [
+                "",
+                "persist",
+                "persist the changes generated by --soft tag"
+            ],
+            [
+                "",
+                "disable-tag-pipeline",
+                "skip the tag pipeline to avoid publishing the components"
+            ],
+            [
                 "",
                 "force-deploy",
                 "run the tag pipeline although the build failed"
@@ -1808,6 +2090,97 @@
             }
         ]
     },
+    {
+        "name": "_tag <component-id...>",
+        "alias": "",
+        "options": [
+            [
+                "",
+                "push",
+                "export the updated objects to the original scopes once done"
+            ],
+            [
+                "m",
+                "message <message>",
+                "a log message describing latest changes"
+            ],
+            [
+                "v",
+                "ver <version>",
+                "tag with the given version"
+            ],
+            [
+                "l",
+                "increment <level>",
+                "options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch"
+            ],
+            [
+                "",
+                "prerelease-id <id>",
+                "prerelease identifier (e.g. \"dev\" to get \"1.0.0-dev.1\")"
+            ],
+            [
+                "p",
+                "patch",
+                "syntactic sugar for \"--increment patch\""
+            ],
+            [
+                "",
+                "minor",
+                "syntactic sugar for \"--increment minor\""
+            ],
+            [
+                "",
+                "major",
+                "syntactic sugar for \"--increment major\""
+            ],
+            [
+                "",
+                "pre-release [identifier]",
+                "syntactic sugar for \"--increment prerelease\" and `--prerelease-id <identifier>`"
+            ],
+            [
+                "",
+                "skip-tests",
+                "skip running component tests during tag process"
+            ],
+            [
+                "",
+                "disable-tag-pipeline",
+                "skip the tag pipeline to avoid publishing the components"
+            ],
+            [
+                "",
+                "force-deploy",
+                "run the tag pipeline although the build failed"
+            ],
+            [
+                "",
+                "increment-by <number>",
+                "(default to 1) increment semver flag (patch/minor/major) by. e.g. incrementing patch by 2: 0.0.1 -> 0.0.3."
+            ],
+            [
+                "i",
+                "ignore-issues [issues]",
+                "ignore component issues (shown in \"bit status\" as \"issues found\"), issues to ignore:\n[MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]\nto ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify \"*\"."
+            ],
+            [
+                "I",
+                "ignore-newest-version",
+                "ignore existing of newer versions (default = false)"
+            ],
+            [
+                "b",
+                "build",
+                "EXPERIMENTAL. not needed for now. run the pipeline build and complete the tag"
+            ]
+        ],
+        "description": "create an immutable and exportable component snapshot, tagged with a release version.",
+        "extendedDescription": "you can specify a version per id using \"@\" sign, e.g. bit tag foo@1.0.0 bar@minor baz@major",
+        "group": "development",
+        "private": true,
+        "remoteOp": true
+    },
     {
         "name": "merge [values...]",
         "alias": "",
@@ -2260,381 +2633,207 @@
             [
                 "n",
                 "alias <string>",
-                "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
-            ],
-            [
-                "m",
-                "merge [strategy]",
-                "merge local changes with the checked out version. strategy should be \"theirs\", \"ours\" or \"manual\""
-            ],
-            [
-                "a",
-                "get-all",
-                "checkout all components in a lane include ones that do not exist in the workspace"
-            ],
-            [
-                "",
-                "skip-dependency-installation",
-                "do not install packages of the imported components"
-            ],
-            [
-                "j",
-                "json",
-                "return the output as JSON"
-            ]
-        ],
-        "description": "switch to the specified lane",
-        "extendedDescription": "",
-        "group": "ungrouped",
-        "private": true
-    },
-    {
-        "name": "dependencies <sub-command>",
-        "alias": "deps",
-        "options": [],
-        "description": "manage dependencies",
-        "extendedDescription": "",
-        "group": "info",
-        "private": false,
-        "commands": [
-            {
-                "name": "get <component-name>",
-                "alias": "",
-                "options": [
-                    [
-                        "t",
-                        "tree",
-                        "EXPERIMENTAL. render dependencies as a tree, similar to \"npm ls\""
-                    ]
-                ],
-                "description": "show direct and indirect dependencies of the given component",
-                "extendedDescription": "",
-                "group": "info",
-                "private": false,
-                "arguments": [
-                    {
-                        "name": "component-name",
-                        "description": "component name or component id"
-                    }
-                ]
-            },
-            {
-                "name": "remove <component-pattern> <package...>",
-                "alias": "",
-                "options": [],
-                "description": "remove a dependency to component(s)",
-                "extendedDescription": "",
-                "group": "info",
-                "private": false,
-                "arguments": [
-                    {
-                        "name": "component-pattern",
-                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
-                    },
-                    {
-                        "name": "package",
-                        "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will remove all lodash instances of any version"
-                    }
-                ]
-            },
-            {
-                "name": "debug <component-name>",
-                "alias": "",
-                "options": [],
-                "description": "show the immediate dependencies and how their versions were determined",
-                "extendedDescription": "",
-                "group": "info",
-                "private": false,
-                "arguments": [
-                    {
-                        "name": "component-name",
-                        "description": "component name or component id"
-                    }
-                ]
-            },
-            {
-                "name": "set <component-pattern> <package...>",
-                "alias": "",
-                "options": [
-                    [
-                        "d",
-                        "dev",
-                        "add to the devDependencies"
-                    ],
-                    [
-                        "p",
-                        "peer",
-                        "add to the peerDependencies"
-                    ]
-                ],
-                "description": "set a dependency to component(s)",
-                "extendedDescription": "",
-                "group": "info",
-                "private": false,
-                "arguments": [
-                    {
-                        "name": "component-pattern",
-                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
-                    },
-                    {
-                        "name": "package",
-                        "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will be resolved to the latest"
-                    }
-                ]
-            }
-        ]
-    },
-    {
-        "name": "list [remote-scope]",
-        "alias": "ls",
-        "options": [
-            [
-                "i",
-                "ids",
-                "show only component ids unformatted"
-            ],
-            [
-                "s",
-                "scope",
-                "show only components stored in the local scope, including indirect dependencies"
-            ],
-            [
-                "o",
-                "outdated",
-                "show latest versions from remotes"
-            ],
-            [
-                "j",
-                "json",
-                "show the output in JSON format"
-            ],
-            [
-                "n",
-                "namespace <string>",
-                "show only specified namespace by using wildcards"
-            ]
-        ],
-        "description": "list components on a workspace, local scope or a remote scope.",
-        "extendedDescription": "https://bit.dev/docs/reference/cli-reference#list",
-        "group": "discover",
-        "private": false,
-        "remoteOp": true,
-        "skipWorkspace": true
-    },
-    {
-        "name": "create <template-name> <component-names...>",
-        "alias": "",
-        "options": [
-            [
-                "n",
-                "namespace <string>",
-                "sets the component's namespace and nested dirs inside the scope"
-            ],
-            [
-                "s",
-                "scope <string>",
-                "sets the component's scope-name. if not entered, the default-scope will be used"
-            ],
-            [
-                "a",
-                "aspect <string>",
-                "aspect-id of the template. helpful when multiple aspects use the same template name"
-            ],
-            [
-                "p",
-                "path <string>",
-                "relative path in the workspace. by default the path is `<scope>/<namespace>/<name>`"
-            ],
-            [
-                "e",
-                "env <string>",
-                "set the component's environment. (overrides the env from variants and the template)"
-            ]
-        ],
-        "description": "create a new component (source files and config) using a template.",
-        "extendedDescription": "",
-        "group": "development",
-        "private": false,
-        "arguments": [
-            {
-                "name": "template-name",
-                "description": "the template for generating the component \n(run 'bit templates' for a list of available templates)"
-            },
-            {
-                "name": "component-names...",
-                "description": "a list of component names to generate"
-            }
-        ],
-        "examples": [
-            {
-                "cmd": "bit create react ui/button",
-                "description": "creates a component named 'ui/button' using the 'react' template"
-            },
-            {
-                "cmd": "bit create react ui/button pages/register",
-                "description": "creates two components, 'ui/button' and 'pages/register', using the 'react' template"
-            },
-            {
-                "cmd": "bit create react ui/button --scope my-org.my-scope",
-                "description": "creates a component named 'ui/button' and sets it scope to 'my-org.my-scope'. \nby default, the scope is the `defaultScope` value, configured in your `workspace.jsonc`."
-            },
-            {
-                "cmd": "bit create react ui/button --env teambit.community/envs/community-react@1.95.13",
-                "description": "creates a component named 'ui/button' and sets it to use the 'community-react' env. \n(the template's default env is 'teambit.react/react')."
-            }
-        ]
-    },
-    {
-        "name": "templates",
-        "alias": "",
-        "options": [
-            [
-                "s",
-                "show-all",
-                "show hidden templates"
-            ]
-        ],
-        "description": "list templates for \"bit create\" and \"bit new\"",
-        "extendedDescription": "list components templates when inside bit-workspace (for bit-create), otherwise, list workspace templates (for bit-new)",
-        "group": "development",
-        "private": false
-    },
-    {
-        "name": "new <template-name> <workspace-name>",
-        "alias": "",
-        "options": [
-            [
-                "a",
-                "aspect <aspect-id>",
-                "aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision"
-            ],
-            [
-                "d",
-                "default-scope <scope-name>",
-                "set defaultScope in the new workspace.jsonc"
-            ],
-            [
-                "",
-                "standalone",
-                "DEPRECATED. use --skip-git instead"
-            ],
-            [
-                "s",
-                "skip-git",
-                "skip generation of Git repository"
-            ],
-            [
-                "e",
-                "empty",
-                "empty workspace with no components (relevant for templates that add components by default)"
-            ],
-            [
-                "",
-                "load-from <path-to-template>",
-                "path to the workspace containing the template. helpful during a development of a workspace-template"
-            ]
-        ],
-        "description": "create a new workspace from a template",
-        "extendedDescription": "",
-        "group": "start",
-        "private": false,
-        "arguments": [
-            {
-                "name": "template-name",
-                "description": "the name of the workspace template (run 'bit templates', outside of a workspace, to get a list of available templates)"
-            },
-            {
-                "name": "workspace-name",
-                "description": "the name for the new workspace and workspace directory"
-            }
-        ]
-    },
-    {
-        "name": "build [component-pattern]",
-        "alias": "",
-        "options": [
+                "relevant when the specified lane is a remote late. name a local lane differently than the remote lane"
+            ],
             [
-                "a",
-                "all",
-                "build all components, not only modified and new"
+                "m",
+                "merge [strategy]",
+                "merge local changes with the checked out version. strategy should be \"theirs\", \"ours\" or \"manual\""
             ],
             [
-                "d",
-                "dev",
-                "run the pipeline in dev mode"
+                "a",
+                "get-all",
+                "checkout all components in a lane include ones that do not exist in the workspace"
             ],
             [
                 "",
-                "install",
-                "install core aspects in capsules"
+                "skip-dependency-installation",
+                "do not install packages of the imported components"
             ],
+            [
+                "j",
+                "json",
+                "return the output as JSON"
+            ]
+        ],
+        "description": "switch to the specified lane",
+        "extendedDescription": "",
+        "group": "ungrouped",
+        "private": true
+    },
+    {
+        "name": "_merge-lane <lane> [pattern]",
+        "alias": "",
+        "options": [
             [
                 "",
-                "reuse-capsules",
-                "avoid deleting the capsules root-dir before starting the build"
+                "push",
+                "export the updated objects to the original scopes once done"
             ],
             [
                 "",
-                "tasks <string>",
-                "build the specified task(s) only. for multiple tasks, separate by a comma and wrap with quotes.\nspecify the task-name (e.g. \"TypescriptCompiler\") or the task-aspect-id (e.g. teambit.compilation/compiler)"
+                "keep-readme",
+                "skip deleting the lane readme component after merging"
             ],
             [
                 "",
-                "cache-packages-on-capsule-root",
-                "set the package-manager cache on the capsule root"
+                "no-squash",
+                "EXPERIMENTAL. relevant for merging lanes into main, which by default squash."
             ],
             [
                 "",
-                "list-tasks <string>",
-                "list tasks of an env or a component-id for each one of the pipelines: build, tag and snap"
+                "include-deps",
+                "EXPERIMENTAL. relevant for \"--pattern\". merge also dependencies of the given components"
             ]
         ],
-        "description": "run set of tasks for build",
+        "description": "merge a remote lane into main via a bare-scope (not workspace)",
+        "extendedDescription": "to merge from a workspace, use \"bit lane merge\" command.\nthis is intended to use from the UI, which will have a button to merge an existing lane into main.\nthe lane must be up-to-date with main, otherwise, conflicts might occur which are not handled in this command",
+        "group": "ungrouped",
+        "private": true,
+        "remoteOp": true,
+        "arguments": [
+            {
+                "name": "lane",
+                "description": "lane-id to merge to main"
+            },
+            {
+                "name": "pattern",
+                "description": "EXPERIMENTAL. partially merge the lane with the specified component-pattern"
+            }
+        ]
+    },
+    {
+        "name": "dependencies <sub-command>",
+        "alias": "deps",
+        "options": [],
+        "description": "manage dependencies",
         "extendedDescription": "",
-        "group": "development",
+        "group": "info",
         "private": false,
-        "arguments": [
+        "commands": [
             {
-                "name": "component-pattern",
-                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                "name": "get <component-name>",
+                "alias": "",
+                "options": [
+                    [
+                        "t",
+                        "tree",
+                        "EXPERIMENTAL. render dependencies as a tree, similar to \"npm ls\""
+                    ]
+                ],
+                "description": "show direct and indirect dependencies of the given component",
+                "extendedDescription": "",
+                "group": "info",
+                "private": false,
+                "arguments": [
+                    {
+                        "name": "component-name",
+                        "description": "component name or component id"
+                    }
+                ]
+            },
+            {
+                "name": "remove <component-pattern> <package...>",
+                "alias": "",
+                "options": [],
+                "description": "remove a dependency to component(s)",
+                "extendedDescription": "",
+                "group": "info",
+                "private": false,
+                "arguments": [
+                    {
+                        "name": "component-pattern",
+                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                    },
+                    {
+                        "name": "package",
+                        "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will remove all lodash instances of any version"
+                    }
+                ]
+            },
+            {
+                "name": "debug <component-name>",
+                "alias": "",
+                "options": [],
+                "description": "show the immediate dependencies and how their versions were determined",
+                "extendedDescription": "",
+                "group": "info",
+                "private": false,
+                "arguments": [
+                    {
+                        "name": "component-name",
+                        "description": "component name or component id"
+                    }
+                ]
+            },
+            {
+                "name": "set <component-pattern> <package...>",
+                "alias": "",
+                "options": [
+                    [
+                        "d",
+                        "dev",
+                        "add to the devDependencies"
+                    ],
+                    [
+                        "p",
+                        "peer",
+                        "add to the peerDependencies"
+                    ]
+                ],
+                "description": "set a dependency to component(s)",
+                "extendedDescription": "",
+                "group": "info",
+                "private": false,
+                "arguments": [
+                    {
+                        "name": "component-pattern",
+                        "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
+                    },
+                    {
+                        "name": "package",
+                        "description": "package name with or without a version, e.g. \"lodash@1.0.0\" or just \"lodash\" which will be resolved to the latest"
+                    }
+                ]
             }
         ]
     },
     {
-        "name": "artifacts <component-pattern>",
-        "alias": "",
+        "name": "list [remote-scope]",
+        "alias": "ls",
         "options": [
             [
-                "",
-                "aspect <aspect-id>",
-                "show/download only artifacts generated by this aspect-id"
+                "i",
+                "ids",
+                "show only component ids unformatted"
             ],
             [
-                "",
-                "task <task-id>",
-                "show/download only artifacts generated by this task-id"
+                "s",
+                "scope",
+                "show only components stored in the local scope, including indirect dependencies"
             ],
             [
-                "",
-                "files <glob>",
-                "show/download only artifacts matching the given files or the glob pattern (wrap glob patterns in quotes)"
+                "o",
+                "outdated",
+                "show latest versions from remotes"
             ],
             [
-                "",
-                "out-dir <string>",
-                "download the files to the specified dir"
+                "j",
+                "json",
+                "show the output in JSON format"
+            ],
+            [
+                "n",
+                "namespace <string>",
+                "show only specified namespace by using wildcards"
             ]
         ],
-        "description": "EXPERIMENTAL. list and download components artifacts",
-        "extendedDescription": "artifacts are created on isolated capsules during tag or snap commands.\nexample of artifacts are dists files generated by a compiler, a JUnit.xml file generated by a tester\nand a package.tgz file generated by pkg aspect.\n",
-        "group": "development",
+        "description": "list components on a workspace, local scope or a remote scope.",
+        "extendedDescription": "https://bit.dev/docs/reference/cli-reference#list",
+        "group": "discover",
         "private": false,
-        "arguments": [
-            {
-                "name": "component-pattern",
-                "description": "component name, component id, or component pattern. use component pattern to select multiple components.\nuse comma to separate patterns and \"!\" to exclude. e.g. \"ui/**, !ui/button\"\nwrap the pattern with quotes"
-            }
-        ]
+        "remoteOp": true,
+        "skipWorkspace": true
     },
     {
         "name": "pack <componentId> [scopePath]",
@@ -3316,68 +3515,6 @@
             }
         ]
     },
-    {
-        "name": "resume-export <export-id> <remotes...>",
-        "alias": "",
-        "options": [],
-        "description": "EXPERIMENTAL. resume failed export",
-        "extendedDescription": "resume failed export to persist the pending objects on the given remotes.\nthe export-id is the id the client got in the error message during the failure.\nalternatively, exporting to any one of the failed scopes, throws server-is-busy error with the export-id",
-        "group": "collaborate",
-        "private": true,
-        "remoteOp": true
-    },
-    {
-        "name": "export [component-patterns...]",
-        "alias": "e",
-        "options": [
-            [
-                "e",
-                "eject",
-                "replace the exported components with their corresponding packages (to use these components without further maintaining them)"
-            ],
-            [
-                "a",
-                "all",
-                "export all components, including non-staged (useful when components in the remote scope are corrupted or missing)"
-            ],
-            [
-                "",
-                "all-versions",
-                "export not only staged versions but all of them (useful when versions in the remote scope are corrupted or missing)"
-            ],
-            [
-                "",
-                "origin-directly",
-                "EXPERIMENTAL. avoid export to the central hub, instead, export directly to the original scopes. not recommended!"
-            ],
-            [
-                "",
-                "resume <string>",
-                "in case the previous export failed and suggested to resume with an export-id, enter the id"
-            ],
-            [
-                "",
-                "ignore-missing-artifacts",
-                "EXPERIMENTAL. don't throw an error when artifact files are missing. not recommended, unless you're sure the artifacts are in the remote"
-            ],
-            [
-                "j",
-                "json",
-                "show output in json format"
-            ]
-        ],
-        "description": "export components from the workspace to remote scopes",
-        "extendedDescription": "bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well\n  `bit export [id...]` => export the given ids to their current scope\n  you can use a pattern for multiple ids, such as bit export remote-scope \"utils/*\". (wrap the pattern with quotes to avoid collision with shell commands)",
-        "group": "collaborate",
-        "private": false,
-        "remoteOp": true,
-        "arguments": [
-            {
-                "name": "component-patterns...",
-                "description": "component IDs, component names, or component patterns (separated by space). Use patterns to export groups of components using a common scope or namespace. E.g., \"utils/*\" (wrap with double quotes)"
-            }
-        ]
-    },
     {
         "name": "update-dependencies <data>",
         "alias": "",