@profoundlogic/coderflow-server 0.7.5 → 0.7.7

package/dist/shipped-skills/environment-templates/SKILL.md

@@ -67,20 +67,119 @@ Templates consist of two files:
 2. **`<name>.json`** (optional) - Template metadata (description, parameters)
 
 ### Metadata JSON Structure
+
+The metadata JSON has a `description` string and an optional `parameters` object. **Parameters are keyed by name** (an object map, not an array).
+
 ```json
 {
   "description": "Brief description shown in template picker",
-  "parameters": [
-    {
-      "name": "feature_name",
-      "label": "Feature Name",
-      "type": "string",
-      "required": true
+  "parameters": {
+    "feature_name": {
+      "required": true,
+      "description": "Help text shown in the UI",
+      "default": "optional default value"
+    }
+  }
+}
+```
+
+#### Parameter Fields
+
+Each parameter supports:
+- `required` (boolean) - Whether the parameter must be filled in. Default: `false`
+- `description` (string) - Help text shown in the UI
+- `default` (string) - Default value if not provided
+- `prompt` (object) - Interactive selection configuration (see below)
+
+Parameters without a `prompt` are rendered as plain text inputs.
+
+#### Prompt Configuration (Interactive Selection)
+
+Add a `prompt` object to a parameter to render it as an interactive selector instead of a text input.
+
+**Common prompt fields (all prompt types):**
+- `type` (required) - One of: `"list"`, `"command"`, `"files"`
+- `label` (string) - Label shown on the prompt button/dialog
+- `multiSelect` (boolean) - Allow selecting multiple values. Default: `false`. Max 4 multi-select parameters per template. Selected values are joined as a comma-separated string.
+
+#### Prompt Type: `list` (hard-coded options)
+
+```json
+{
+  "parameters": {
+    "output_format": {
+      "required": true,
+      "description": "Output format to generate",
+      "prompt": {
+        "type": "list",
+        "label": "Select Format",
+        "multiSelect": true,
+        "options": [
+          { "value": "json", "label": "JSON", "description": "Standard JSON output" },
+          { "value": "csv", "label": "CSV", "description": "Comma-separated values" },
+          { "value": "xml", "label": "XML" }
+        ]
+      }
+    }
+  }
+}
+```
+
+- `options` (required) - Array of choices. Each requires `value` (string). Optional: `label` (display text, defaults to value), `description` (smaller helper text).
+
+#### Prompt Type: `command` (dynamic options from shell command)
+
+```json
+{
+  "parameters": {
+    "branch": {
+      "required": true,
+      "description": "Git branch to work on",
+      "prompt": {
+        "type": "command",
+        "label": "Select Branch",
+        "command": "git branch -a",
+        "parser": "git-branches"
+      }
+    }
+  }
+}
+```
+
+- `command` (required) - Shell command to run in the container to generate choices
+- `parser` - How to parse output. One of: `"json"` (default, expects `[{value, label?, description?}, ...]`), `"lines"` (newline-separated values), `"git-branches"` (parses git branch output), `"files"` (parses file paths)
+- `repos` (array of strings) - Optional repo names to scope the command to
+
+#### Prompt Type: `files` (file/directory browser)
+
+```json
+{
+  "parameters": {
+    "source_file": {
+      "required": true,
+      "description": "Source file to process",
+      "prompt": {
+        "type": "files",
+        "label": "Select File",
+        "multiSelect": true,
+        "path": "src/",
+        "include": "files",
+        "pattern": "*.{js,ts,tsx}"
+      }
     }
-  ]
+  }
 }
 ```
 
+- `path` (required) - Directory path relative to `/workspace`
+- `include` - What to show: `"files"` (default), `"directories"`, or `"both"`
+- `pattern` (string) - Optional glob pattern filter (e.g., `"*.{rpg,rpgle,sqlrpgle}"`)
+- `repos` (array of strings) - Optional repo names to scope to
+
+#### Multi-Select and Batch Processing
+
+When `multiSelect: true`, the UI renders checkboxes instead of radio buttons. If multiple parameters have `multiSelect` enabled, the system generates a cartesian product of all selected values, creating a separate task for each combination. Max 4 multi-select parameters per template, max 100 total combinations.
+
 ### Template Content Syntax
 
 **CRITICAL**: Template parameters must use `${parameter_name}` syntax (dollar sign + curly braces), NOT `{{parameter_name}}`.
@@ -153,14 +252,33 @@ curl -s "${CODERFLOW_SERVER_URL}/api/environment-management/templates/bug-fix" \
 # Create a temporary file with the complete JSON payload
 cat > /tmp/template-payload.json <<'EOF'
 {
-  "content": "# API Endpoint Implementation\n\n...",
+  "content": "# API Endpoint Implementation\n\nCreate a ${http_method} endpoint at ${endpoint_path}.\n\n${description}",
   "metadata": {
     "description": "Create a new API endpoint",
-    "parameters": [
-      {"name": "endpoint_path", "label": "Endpoint Path", "type": "string", "required": true},
-      {"name": "http_method", "label": "HTTP Method", "type": "string", "required": true},
-      {"name": "description", "label": "Description", "type": "string", "required": false}
-    ]
+    "parameters": {
+      "endpoint_path": {
+        "required": true,
+        "description": "URL path for the endpoint (e.g., /api/users)"
+      },
+      "http_method": {
+        "required": true,
+        "description": "HTTP method",
+        "prompt": {
+          "type": "list",
+          "label": "Select HTTP Method",
+          "options": [
+            { "value": "GET" },
+            { "value": "POST" },
+            { "value": "PUT" },
+            { "value": "DELETE" }
+          ]
+        }
+      },
+      "description": {
+        "required": false,
+        "description": "Additional context for the endpoint"
+      }
+    }
   }
 }
 EOF
@@ -179,12 +297,29 @@ curl -s -X PUT "${CODERFLOW_SERVER_URL}/api/environment-management/templates/api
   -H "X-Task-Id: ${TASK_ID}" \
   -d @- <<'EOF'
 {
-  "content": "# API Endpoint Implementation\n\n...",
+  "content": "# API Endpoint Implementation\n\nCreate a ${http_method} endpoint at ${endpoint_path}.",
   "metadata": {
     "description": "Create a new API endpoint",
-    "parameters": [
-      {"name": "endpoint_path", "label": "Endpoint Path", "type": "string", "required": true}
-    ]
+    "parameters": {
+      "endpoint_path": {
+        "required": true,
+        "description": "URL path for the endpoint"
+      },
+      "http_method": {
+        "required": true,
+        "description": "HTTP method",
+        "prompt": {
+          "type": "list",
+          "label": "Select HTTP Method",
+          "options": [
+            { "value": "GET" },
+            { "value": "POST" },
+            { "value": "PUT" },
+            { "value": "DELETE" }
+          ]
+        }
+      }
+    }
   }
 }
 EOF