remove flow flag, update help in docs

.hof/shadow/cli/cmd/hof/cmd/flow.go

@@ -60,7 +60,7 @@ Arguments:
 
 func init() {
 
-	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.List), "list", "l", false, "list available pipelines")
+	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.List), "list", "", false, "list available pipelines")
 	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.Docs), "docs", "d", false, "print pipeline docs")
 	FlowCmd.Flags().StringSliceVarP(&(flags.FlowFlags.Flow), "flow", "f", nil, "flow labels to match and run")
 	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.Progress), "progress", "", false, "print task progress as it happens")

cmd/hof/cmd/flow.go

@@ -61,7 +61,7 @@ Arguments:
 
 func init() {
 
-	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.List), "list", "l", false, "list available pipelines")
+	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.List), "list", "", false, "list available pipelines")
 	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.Docs), "docs", "d", false, "print pipeline docs")
 	FlowCmd.Flags().StringSliceVarP(&(flags.FlowFlags.Flow), "flow", "f", nil, "flow labels to match and run")
 	FlowCmd.Flags().BoolVarP(&(flags.FlowFlags.Progress), "progress", "", false, "print task progress as it happens")

design/cmds/flow.cue

@@ -68,7 +68,6 @@ FlowCommand: schema.Command & {
 	Flags: [{
 		Name:    "list"
 		Long:    "list"
-		Short:   "l"
 		Type:    "bool"
 		Default: "false"
 		Help:    "list available pipelines"

docs/code/cmd-help/chat

@@ -72,6 +72,7 @@ Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/create

@@ -48,6 +48,7 @@ Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/dm

@@ -114,6 +114,7 @@ Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/flow

@@ -1,4 +1,4 @@
-run CUE pipelines with the hof/flow DAG engine
+run workflows and tasks powered by CUE
 
 Use hof/flow to transform data, call APIs, work with DBs,
 read and write files, call any program, handle events,
@@ -54,14 +54,15 @@ Flags:
   -d, --docs           print pipeline docs
   -f, --flow strings   flow labels to match and run
   -h, --help           help for flow
-  -l, --list           list available pipelines
+      --list           list available pipelines
       --progress       print task progress as it happens
   -s, --stats          Print final task statistics
 
 Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/fmt

@@ -22,6 +22,7 @@ Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/gen

@@ -99,6 +99,7 @@ Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/hof

@@ -6,13 +6,17 @@ Usage:
   hof [flags] [command] [args]
 
 Main commands:
-  create                dynamic app blueprints from any git repo
+  chat                  co-create with AI (alpha)
+  create                starter kits or blueprints from any git repo
   datamodel             manage, diff, and migrate your data models
-  gen                   modular and composable code gen: CUE & data + templates = _
-  flow                  run CUE pipelines with the hof/flow DAG engine
+  def                   print consolidated CUE definitions
+  eval                  evaluate and print CUE configuration
+  export                output data in a standard format
+  flow                  run workflows and tasks powered by CUE
   fmt                   format any code and manage the formatters
-  mod                   CUE dependency management based on Go mods
-  chat                  co-create with AI (alpha)
+  gen                   CUE powered code generation
+  mod                   CUE module dependency management
+  vet                   validate data with CUE
 
 Additional commands:
   help                  help about any command
@@ -26,6 +30,7 @@ Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output

docs/code/cmd-help/mod

@@ -109,6 +109,7 @@ Global Flags:
       --include-data     auto include all data files found with cue files
       --inject-env       inject all ENV VARs as default tag vars
   -p, --package string   the Cue package context to use during execution
+  -l, --path strings     CUE expression for single path component when placing data files
   -q, --quiet            turn off output and assume defaults at prompts
   -t, --tags strings     @tags() to be injected into CUE code
   -v, --verbosity int    set the verbosity of output