feat: allow nameless execs with a namespace defined

jahvon · jahvon · commit 2c74ed56ea46 · 2025-07-30T09:13:43.000-04:00
diff --git a/.execs/build.flow b/.execs/build.flow
@@ -80,7 +80,7 @@ executables:
         else
           echo "npm dependencies already installed"
         fi
-        npm run generate-types
+        npm run generate-ts
 
   - verb: generate
     name: backend
diff --git a/.execs/desktop.flow b/.execs/desktop.flow
@@ -1,2 +1,3 @@
 # yaml-language-server: $schema=https://flowexec.io/schemas/flowfile_schema.json
+namespace: desktop
 imports: ["../desktop/package.json"]
diff --git a/.execs/setup.flow b/.execs/setup.flow
@@ -18,14 +18,6 @@ executables:
       dir: //
       cmd: go install ./...
 
-  - verb: install
-    name: npm
-    aliases: [node, modules]
-    tags: [npm, desktop]
-    exec:
-      dir: //desktop
-      cmd: npm install
-
   - verb: start
     name: site
     aliases: [docs]
diff --git a/cmd/internal/exec.go b/cmd/internal/exec.go
@@ -418,7 +418,7 @@ flow install
 
 **Execute a nameless flow in the 'ws' workspace with the 'test' verb**
 
-flow test ws
+flow test ws/
 
 **Execute the 'build' flow in the current workspace and namespace**
 
diff --git a/desktop/package.json b/desktop/package.json
@@ -5,15 +5,15 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "start-desktop": "tauri dev",
-    "build-desktop": "tsc && vite build",
-    "lint-ts": "npx eslint src",
-    "lint-ts:fix": "npx eslint src --fix",
+    "start": "tauri dev",
+    "build": "tsc && vite build",
+    "lint": "npx eslint src",
+    "lint:fix": "npx eslint src --fix",
     "prettier": "npx prettier src --check",
     "prettier:fix": "npx prettier src --write",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
-    "generate-types": "tsx scripts/generate-ts-types.ts"
+    "generate-ts": "tsx scripts/generate-ts-types.ts"
   },
   "dependencies": {
     "@mantine/core": "^8.0.2",
diff --git a/desktop/src-tauri/src/types/generated/flowfile.rs b/desktop/src-tauri/src/types/generated/flowfile.rs
@@ -228,7 +228,7 @@ impl ::std::default::Default for CommonVisibility {
 #[doc = "      \"$ref\": \"#/definitions/ExecutableLaunchExecutableType\""]
 #[doc = "    },"]
 #[doc = "    \"name\": {"]
-#[doc = "      \"description\": \"The name of the executable.\\n\\nName is used to reference the executable in the CLI using the format `workspace/namespace:name`.\\n[Verb group + Name] must be unique within the namespace of the workspace.\\nName is required if the executable is defined within a namespace.\\n\","]
+#[doc = "      \"description\": \"An optional name for the executable.\\n\\nName is used to reference the executable in the CLI using the format `workspace/namespace:name`.\\n[Verb group + Name] must be unique within the namespace of the workspace.\\n\","]
 #[doc = "      \"default\": \"\","]
 #[doc = "      \"type\": \"string\""]
 #[doc = "    },"]
@@ -282,7 +282,7 @@ pub struct Executable {
     pub exec: ::std::option::Option<ExecutableExecExecutableType>,
     #[serde(default, skip_serializing_if = "::std::option::Option::is_none")]
     pub launch: ::std::option::Option<ExecutableLaunchExecutableType>,
-    #[doc = "The name of the executable.\n\nName is used to reference the executable in the CLI using the format `workspace/namespace:name`.\n[Verb group + Name] must be unique within the namespace of the workspace.\nName is required if the executable is defined within a namespace.\n"]
+    #[doc = "An optional name for the executable.\n\nName is used to reference the executable in the CLI using the format `workspace/namespace:name`.\n[Verb group + Name] must be unique within the namespace of the workspace.\n"]
     #[serde(default)]
     pub name: ::std::string::String,
     #[serde(default, skip_serializing_if = "::std::option::Option::is_none")]
diff --git a/desktop/src/types/generated/flowfile.ts b/desktop/src/types/generated/flowfile.ts
@@ -100,11 +100,10 @@ export interface Executable {
   exec?: ExecutableExecExecutableType;
   launch?: ExecutableLaunchExecutableType;
   /**
-   * The name of the executable.
+   * An optional name for the executable.
    *
    * Name is used to reference the executable in the CLI using the format `workspace/namespace:name`.
    * [Verb group + Name] must be unique within the namespace of the workspace.
-   * Name is required if the executable is defined within a namespace.
    *
    */
   name?: string;
diff --git a/docs/cli/flow_exec.md b/docs/cli/flow_exec.md
@@ -22,7 +22,7 @@ flow install
 
 **Execute a nameless flow in the 'ws' workspace with the 'test' verb**
 
-flow test ws
+flow test ws/
 
 **Execute the 'build' flow in the current workspace and namespace**
 
diff --git a/docs/schemas/flowfile_schema.json b/docs/schemas/flowfile_schema.json
@@ -54,7 +54,7 @@
           "$ref": "#/definitions/ExecutableLaunchExecutableType"
         },
         "name": {
-          "description": "The name of the executable.\n\nName is used to reference the executable in the CLI using the format `workspace/namespace:name`.\n[Verb group + Name] must be unique within the namespace of the workspace.\nName is required if the executable is defined within a namespace.\n",
+          "description": "An optional name for the executable.\n\nName is used to reference the executable in the CLI using the format `workspace/namespace:name`.\n[Verb group + Name] must be unique within the namespace of the workspace.\n",
           "type": "string",
           "default": ""
         },
diff --git a/docs/types/flowfile.md b/docs/types/flowfile.md
@@ -85,7 +85,7 @@ Executables are the building blocks of workflows and are used to define the acti
 | `description` | A description of the executable. This description is rendered as markdown in the interactive UI.  | `string` |  |  |
 | `exec` |  | [ExecutableExecExecutableType](#ExecutableExecExecutableType) | <no value> |  |
 | `launch` |  | [ExecutableLaunchExecutableType](#ExecutableLaunchExecutableType) | <no value> |  |
-| `name` | The name of the executable.  Name is used to reference the executable in the CLI using the format `workspace/namespace:name`. [Verb group + Name] must be unique within the namespace of the workspace. Name is required if the executable is defined within a namespace.  | `string` |  |  |
+| `name` | An optional name for the executable.  Name is used to reference the executable in the CLI using the format `workspace/namespace:name`. [Verb group + Name] must be unique within the namespace of the workspace.  | `string` |  |  |
 | `parallel` |  | [ExecutableParallelExecutableType](#ExecutableParallelExecutableType) | <no value> |  |
 | `render` |  | [ExecutableRenderExecutableType](#ExecutableRenderExecutableType) | <no value> |  |
 | `request` |  | [ExecutableRequestExecutableType](#ExecutableRequestExecutableType) | <no value> |  |
diff --git a/internal/fileparser/ref.go b/internal/fileparser/ref.go
@@ -21,6 +21,8 @@ var verbPatterns = []struct {
 	{executable.VerbRemove, regexp.MustCompile(`^(remove|uninstall|delete)[\s:_-]?`)},
 	{executable.VerbUpdate, regexp.MustCompile(`^(update|upgrade)[\s:_-]?`)},
 	{executable.VerbAnalyze, regexp.MustCompile(`^(analyze|audit|inspect|scan)[\s:_-]?`)},
+	{executable.VerbConfigure, regexp.MustCompile(`^(configure|setup)[\s:_-]?`)},
+	{executable.VerbGenerate, regexp.MustCompile(`^(generate|gen)[\s:_-]?`)},
 }
 
 // InferVerb infers the most likely Executable verb from a script or makeTarget name.
diff --git a/types/executable/executable.gen.go b/types/executable/executable.gen.go
diff --git a/types/executable/executable.go b/types/executable/executable.go
@@ -247,9 +247,7 @@ func (e *Executable) Validate() error {
 	} else if err := e.Verb.Validate(); err != nil {
 		return err
 	}
-	if e.Name == "" && e.Namespace() != "" {
-		return fmt.Errorf("name cannot be empty when namespace is set")
-	} else if strings.Contains(e.Name, " ") {
+	if strings.Contains(e.Name, " ") {
 		return fmt.Errorf("name cannot contain spaces")
 	}
 
diff --git a/types/executable/executable_schema.yaml b/types/executable/executable_schema.yaml
@@ -629,11 +629,10 @@ properties:
   name:
     type: string
     description: |
-      The name of the executable.
+      An optional name for the executable.
 
       Name is used to reference the executable in the CLI using the format `workspace/namespace:name`.
       [Verb group + Name] must be unique within the namespace of the workspace.
-      Name is required if the executable is defined within a namespace.
     default: ""
   description:
     type: string

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,3 @@`
`1`	`1`	`# yaml-language-server: $schema=https://flowexec.io/schemas/flowfile_schema.json`
	`2`	`+namespace: desktop`
`2`	`3`	`imports: ["../desktop/package.json"]`
Original file line number	Diff line number	Diff line change
`@@ -100,11 +100,10 @@ export interface Executable {`
`100`	`100`	`exec?: ExecutableExecExecutableType;`
`101`	`101`	`launch?: ExecutableLaunchExecutableType;`
`102`	`102`	`/**`
`103`		`- * The name of the executable.`
	`103`	`+ * An optional name for the executable.`
`104`	`104`	`*`
`105`	`105`	* Name is used to reference the executable in the CLI using the format `workspace/namespace:name`.
`106`	`106`	`* [Verb group + Name] must be unique within the namespace of the workspace.`
`107`		`- * Name is required if the executable is defined within a namespace.`
`108`	`107`	`*`
`109`	`108`	`*/`
`110`	`109`	`name?: string;`