lint and build docs

Author: vinit-chauhan

README.md

@@ -366,6 +366,24 @@ Use this command to export ingest pipelines with referenced pipelines from the E
 
 Use this command to download selected ingest pipelines and its referenced processor pipelines from Elasticsearch. Select data stream or the package root directories to download the pipelines. Pipelines are downloaded as is and will need adjustment to meet your package needs.
 
+### `elastic-package filter [flags]`
+
+_Context: package_
+
+This command gives you a list of all packages based on the given query
+
+### `elastic-package foreach [flags] -- <SUBCOMMAND>`
+
+_Context: package_
+
+Execute a command for each package matching the given filter criteria.
+
+This command combines filtering capabilities with command execution, allowing you to run
+any elastic-package subcommand across multiple packages in a single operation.
+
+The command uses the same filter flags as the 'filter' command to select packages, 
+then executes the specified subcommand for each matched package.
+
 ### `elastic-package format`
 
 _Context: package_

cmd/filter.go

@@ -11,10 +11,11 @@ import (
 	"os"
 	"slices"
 
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/filter"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 const filterLongDescription = `This command gives you a list of all packages based on the given query`

cmd/foreach.go

@@ -14,12 +14,13 @@ import (
 	"strings"
 	"sync"
 
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/filter"
 	"github.com/elastic/elastic-package/internal/logger"
 	"github.com/elastic/elastic-package/internal/multierror"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 const foreachLongDescription = `Execute a command for each package matching the given filter criteria.

internal/filter/category_flag.go

@@ -1,9 +1,14 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 type CategoryFlag struct {

internal/filter/codeowner_flag.go

@@ -1,12 +1,17 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
 	"fmt"
 
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/packages"
 	"github.com/elastic/elastic-package/internal/tui"
-	"github.com/spf13/cobra"
 )
 
 type CodeOwnerFlag struct {

internal/filter/input_flag.go

@@ -1,9 +1,14 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 type InputFlag struct {

internal/filter/integrationtype_flag.go

@@ -1,9 +1,14 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 type IntegrationTypeFlag struct {

internal/filter/packagename_flag.go

@@ -1,12 +1,17 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
 	"fmt"
 
-	"github.com/elastic/elastic-package/internal/cobraext"
-	"github.com/elastic/elastic-package/internal/packages"
 	"github.com/gobwas/glob"
 	"github.com/spf13/cobra"
+
+	"github.com/elastic/elastic-package/internal/cobraext"
+	"github.com/elastic/elastic-package/internal/packages"
 )
 
 type PackageNameFlag struct {

internal/filter/registry.go

@@ -1,12 +1,17 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
 	"fmt"
 
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/logger"
 	"github.com/elastic/elastic-package/internal/multierror"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 var registry = []Filter{

internal/filter/specversion_flag.go

@@ -1,12 +1,17 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License;
+// you may not use this file except in compliance with the Elastic License.
+
 package filter
 
 import (
 	"fmt"
 
 	"github.com/Masterminds/semver/v3"
+	"github.com/spf13/cobra"
+
 	"github.com/elastic/elastic-package/internal/cobraext"
 	"github.com/elastic/elastic-package/internal/packages"
-	"github.com/spf13/cobra"
 )
 
 type SpecVersionFlag struct {