keystone-cli 2.1.7 → 2.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keystone-cli",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "description": "A local-first, declarative, agentic workflow orchestrator built on Bun",
   "type": "module",
   "bin": {
@@ -16,13 +16,7 @@
     "format": "biome format --write .",
     "schema:generate": "bun run src/scripts/generate-schemas.ts"
   },
-  "keywords": [
-    "workflow",
-    "orchestrator",
-    "agentic",
-    "automation",
-    "bun"
-  ],
+  "keywords": ["workflow", "orchestrator", "agentic", "automation", "bun"],
   "author": "Mark Hingston",
   "license": "MIT",
   "repository": {
@@ -30,12 +24,7 @@
     "url": "https://github.com/mhingston/keystone-cli.git"
   },
   "homepage": "https://github.com/mhingston/keystone-cli#readme",
-  "files": [
-    "src",
-    "README.md",
-    "LICENSE",
-    "logo.png"
-  ],
+  "files": ["src", "README.md", "LICENSE", "logo.png"],
   "dependencies": {
     "@ast-grep/cli": "^0.40.3",
     "@ast-grep/napi": "^0.40.3",

package/src/templates/scaffolding/scaffold-feature.yaml

@@ -37,10 +37,85 @@ steps:
     outputMapping:
       files: files
 
+  - id: validate_workflows
+    type: shell
+    needs: [generate]
+    foreach: ${{ steps.generate.outputs.files.filter(f => f.path.endsWith('.yaml') && f.path.includes('workflows')) }}
+    run: |
+      echo "${{ item.content }}" | npx tsx src/cli.ts validate --stdin --type workflow
+    allowFailure: true
+    transform: |
+      {
+        path: item.path,
+        content: item.content,
+        valid: result.exitCode === 0,
+        error: result.exitCode !== 0 ? result.stderr : null
+      }
+
+  - id: repair_workflows
+    type: llm
+    needs: [validate_workflows]
+    foreach: ${{ steps.validate_workflows.output.filter(f => !f.valid) }}
+    agent: software-engineer
+    prompt: |
+      A generated workflow file failed schema validation. Please fix it.
+
+      File path: ${{ item.path }}
+      
+      Validation error:
+      ${{ item.error }}
+
+      Current content:
+      ```yaml
+      ${{ item.content }}
+      ```
+
+      The workflow schema requires:
+      1. A top-level `name` field (string, required)
+      2. A top-level `$schema` field pointing to: https://raw.githubusercontent.com/mhingston/keystone-cli/main/schemas/workflow.json
+      3. A `steps` array with at least one step
+      4. Each step must have `id` and `type` fields
+
+      Please return the corrected YAML content that conforms to the schema. Return ONLY the fixed YAML content, nothing else.
+    outputSchema:
+      type: object
+      properties:
+        content:
+          type: string
+          description: The fixed YAML content
+      required: [content]
+
+  - id: merge_files
+    type: shell
+    needs: [validate_workflows, repair_workflows]
+    run: |
+      const generated = ${{ JSON.stringify(steps.generate.outputs.files) }};
+      const validated = ${{ JSON.stringify(steps.validate_workflows.output) }};
+      const repaired = ${{ JSON.stringify(steps.repair_workflows.output) }};
+      
+      const repairedMap = new Map();
+      if (Array.isArray(repaired)) {
+        repaired.forEach((r, idx) => {
+          const validatedItem = validated[idx];
+          if (validatedItem) {
+            repairedMap.set(validatedItem.path, r.content);
+          }
+        });
+      }
+      
+      const final = generated.map(file => {
+        if (repairedMap.has(file.path)) {
+          return { ...file, content: repairedMap.get(file.path) };
+        }
+        return file;
+      });
+      
+      return { files: final };
+
   - id: write_files
     type: file
-    needs: [generate]
-    foreach: ${{ steps.generate.outputs.files }}
+    needs: [merge_files]
+    foreach: ${{ steps.merge_files.output.files }}
     op: write
     path: ${{ item.path }}
     content: ${{ item.content }}

package/src/templates/scaffolding/scaffold-generate.yaml

@@ -31,6 +31,13 @@ steps:
       ${{ item }}
 
       Produce the full file content for the given path. Ensure it aligns with the architectural constraints and dependencies defined in the blueprint.
+      
+      IMPORTANT: If generating a workflow file (.yaml in workflows/):
+      - MUST include a top-level `$schema` field: $schema: https://raw.githubusercontent.com/mhingston/keystone-cli/main/schemas/workflow.json
+      - MUST include a top-level `name` field (string, required)
+      - MUST include a `steps` array with at least one step
+      - Each step MUST have `id` and `type` fields
+      
       Return only JSON with fields: path, content.
     outputSchema:
       type: object