@zibby/core 0.4.6 → 0.5.0

package/templates/browser-test-automation/run_test.json

@@ -1,358 +0,0 @@
-{
-  "nodes": [
-    {
-      "id": "preflight",
-      "type": "preflight",
-      "data": {
-        "nodeType": "preflight",
-        "label": "preflight"
-      }
-    },
-    {
-      "id": "execute_live",
-      "type": "execute_live",
-      "data": {
-        "nodeType": "execute_live",
-        "label": "execute_live"
-      }
-    },
-    {
-      "id": "generate_script",
-      "type": "generate_script",
-      "data": {
-        "nodeType": "generate_script",
-        "label": "generate_script"
-      }
-    }
-  ],
-  "edges": [
-    {
-      "source": "preflight",
-      "target": "execute_live"
-    },
-    {
-      "source": "generate_script",
-      "target": "END"
-    }
-  ],
-  "nodeConfigs": {
-    "preflight": {
-      "outputSchema": {
-        "jsonSchema": {
-          "type": "object",
-          "properties": {
-            "title": {
-              "type": "string",
-              "description": "Concise test title (5-10 words, action-oriented). Prefix with ticket ID if found."
-            },
-            "assertions": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "description": {
-                    "type": "string",
-                    "description": "What to verify (e.g., \"User is redirected to dashboard\")"
-                  },
-                  "expected": {
-                    "type": "string",
-                    "description": "What the expected outcome looks like (e.g., \"URL contains /dashboard\")"
-                  }
-                },
-                "required": [
-                  "description",
-                  "expected"
-                ],
-                "additionalProperties": false
-              },
-              "description": "Every expected result from the spec as a verifiable assertion"
-            }
-          },
-          "required": [
-            "title",
-            "assertions"
-          ],
-          "additionalProperties": false
-        },
-        "variables": [
-          {
-            "path": "title",
-            "type": "string",
-            "label": "Concise test title (5-10 words, action-oriented). Prefix with ticket ID if found.",
-            "optional": false
-          },
-          {
-            "path": "assertions",
-            "type": "array",
-            "label": "Every expected result from the spec as a verifiable assertion",
-            "optional": false
-          },
-          {
-            "path": "assertions[].description",
-            "type": "string",
-            "label": "What to verify (e.g., \"User is redirected to dashboard\")",
-            "optional": false
-          },
-          {
-            "path": "assertions[].expected",
-            "type": "string",
-            "label": "What the expected outcome looks like (e.g., \"URL contains /dashboard\")",
-            "optional": false
-          }
-        ]
-      }
-    },
-    "execute_live": {
-      "outputSchema": {
-        "jsonSchema": {
-          "type": "object",
-          "properties": {
-            "success": {
-              "type": "boolean",
-              "description": "Whether the test execution completed successfully"
-            },
-            "steps": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Array of test steps executed"
-            },
-            "finalUrl": {
-              "type": "string",
-              "description": "Final URL after test execution"
-            },
-            "actions": {
-              "type": "array",
-              "description": "Detailed array of actions performed with descriptions and reasoning"
-            },
-            "assertions": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "description": {
-                    "type": "string",
-                    "description": "What was verified"
-                  },
-                  "passed": {
-                    "type": "boolean",
-                    "description": "Whether the assertion passed"
-                  },
-                  "verifiedAfterAction": {
-                    "type": "number",
-                    "description": "Index of the action after which this was verified (0-based, matches actions array index) - REQUIRED"
-                  },
-                  "evidence": {
-                    "type": "string",
-                    "description": "Brief evidence of what was observed"
-                  }
-                },
-                "required": [
-                  "description",
-                  "passed",
-                  "verifiedAfterAction"
-                ],
-                "additionalProperties": false
-              },
-              "description": "Array of assertions made during test"
-            },
-            "waits": {
-              "type": "array",
-              "description": "Array of waits needed for proper test execution"
-            },
-            "evidenceScreenshots": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "filename": {
-                    "type": "string",
-                    "description": "Descriptive filename pattern: {step-number}-{action-or-state}.png"
-                  },
-                  "description": {
-                    "type": "string",
-                    "description": "What the screenshot shows and why it is evidence"
-                  },
-                  "verdict": {
-                    "type": "string",
-                    "enum": [
-                      "pass",
-                      "fail",
-                      "info"
-                    ],
-                    "description": "Test verdict: pass/fail for validation points, info for checkpoints"
-                  }
-                },
-                "required": [
-                  "filename",
-                  "description",
-                  "verdict"
-                ],
-                "additionalProperties": false
-              },
-              "description": "Array of screenshots taken at key validation points throughout the test"
-            },
-            "browserClosed": {
-              "type": "boolean",
-              "description": "Whether the browser was properly closed (should always be true)"
-            },
-            "notes": {
-              "type": "string",
-              "description": "Additional notes or observations. REQUIRED when success=false to explain why test failed or could not execute"
-            }
-          },
-          "required": [
-            "success",
-            "steps",
-            "browserClosed"
-          ],
-          "additionalProperties": false
-        },
-        "variables": [
-          {
-            "path": "success",
-            "type": "boolean",
-            "label": "Whether the test execution completed successfully",
-            "optional": false
-          },
-          {
-            "path": "steps",
-            "type": "array",
-            "label": "Array of test steps executed",
-            "optional": false
-          },
-          {
-            "path": "finalUrl",
-            "type": "string",
-            "label": "Final URL after test execution",
-            "optional": true
-          },
-          {
-            "path": "actions",
-            "type": "array",
-            "label": "Detailed array of actions performed with descriptions and reasoning",
-            "optional": true
-          },
-          {
-            "path": "assertions",
-            "type": "array",
-            "label": "Array of assertions made during test",
-            "optional": true
-          },
-          {
-            "path": "assertions[].description",
-            "type": "string",
-            "label": "What was verified",
-            "optional": false
-          },
-          {
-            "path": "assertions[].passed",
-            "type": "boolean",
-            "label": "Whether the assertion passed",
-            "optional": false
-          },
-          {
-            "path": "assertions[].verifiedAfterAction",
-            "type": "number",
-            "label": "Index of the action after which this was verified (0-based, matches actions array index) - REQUIRED",
-            "optional": false
-          },
-          {
-            "path": "assertions[].evidence",
-            "type": "string",
-            "label": "Brief evidence of what was observed",
-            "optional": true
-          },
-          {
-            "path": "waits",
-            "type": "array",
-            "label": "Array of waits needed for proper test execution",
-            "optional": true
-          },
-          {
-            "path": "evidenceScreenshots",
-            "type": "array",
-            "label": "Array of screenshots taken at key validation points throughout the test",
-            "optional": true
-          },
-          {
-            "path": "evidenceScreenshots[].filename",
-            "type": "string",
-            "label": "Descriptive filename pattern: {step-number}-{action-or-state}.png",
-            "optional": false
-          },
-          {
-            "path": "evidenceScreenshots[].description",
-            "type": "string",
-            "label": "What the screenshot shows and why it is evidence",
-            "optional": false
-          },
-          {
-            "path": "evidenceScreenshots[].verdict",
-            "type": "string",
-            "label": "Test verdict: pass/fail for validation points, info for checkpoints",
-            "optional": false
-          },
-          {
-            "path": "browserClosed",
-            "type": "boolean",
-            "label": "Whether the browser was properly closed (should always be true)",
-            "optional": false
-          },
-          {
-            "path": "notes",
-            "type": "string",
-            "label": "Additional notes or observations. REQUIRED when success=false to explain why test failed or could not execute",
-            "optional": true
-          }
-        ]
-      }
-    },
-    "generate_script": {
-      "outputSchema": {
-        "jsonSchema": {
-          "type": "object",
-          "properties": {
-            "success": {
-              "type": "boolean"
-            },
-            "scriptPath": {
-              "type": "string"
-            },
-            "method": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "success",
-            "scriptPath",
-            "method"
-          ],
-          "additionalProperties": false
-        },
-        "variables": [
-          {
-            "path": "success",
-            "type": "boolean",
-            "label": "Success",
-            "optional": false
-          },
-          {
-            "path": "scriptPath",
-            "type": "string",
-            "label": "Script Path",
-            "optional": false
-          },
-          {
-            "path": "method",
-            "type": "string",
-            "label": "Method",
-            "optional": false
-          }
-        ]
-      }
-    }
-  },
-  "stateSchema": null
-}

package/templates/browser-test-automation/state.js

@@ -1,61 +0,0 @@
-/**
- * Browser Test Automation — Workflow State Schema
- *
- * Declares the input shape that nodes in this template actually read off
- * `state`. Wired into the graph via `graph.setStateSchema(...)` in
- * graph.mjs so that:
- *
- *   - `zibby workflow run <slug> -p testSpec=...` validates inputs
- *     against this schema before nodes ever execute.
- *   - The post-scaffold `Pass inputs:` cheatsheet reads top-level fields
- *     from this schema so the printed examples match what the template
- *     actually consumes (testSpec, model) instead of generic placeholders.
- *
- * Field provenance:
- *   - testSpec, model        — USER input (passed via -p / --input).
- *   - cwd, sessionPath,      — FRAMEWORK-injected by the workflow runner
- *     outputPath, context      (NOT user input). Declared optional so a
- *                              user-only payload validates cleanly.
- *   - preflight, execute_live — DOWNSTREAM node outputs (set by earlier
- *                              nodes during graph execution). Same: kept
- *                              optional so initial inputs validate.
- *
- * `zod` is imported directly from the `zod` package (not re-exported via
- * @zibby/core) — same convention as code-analysis/state.js. The
- * scaffolded user copy gets `zod` via the template's dep merge in
- * templates/index.js.
- */
-
-import { z } from 'zod';
-
-export const browserTestAutomationStateSchema = z.object({
-  // ---- USER INPUT (what `-p` / `--input` populates) ----
-  testSpec: z.string().describe(
-    'Plain-English description of the browser test to analyze + execute (REQUIRED).',
-  ),
-  model: z.string().default('auto').describe(
-    'Agent model override (e.g. "auto", "opus-4.6"). Defaults to "auto".',
-  ),
-
-  // ---- FRAMEWORK-INJECTED (set by the workflow runner, not the user) ----
-  cwd: z.string().optional().describe(
-    'Working directory the workflow runs in. Injected by the runner.',
-  ),
-  sessionPath: z.string().optional().describe(
-    'Per-run session directory under .zibby/output/. Injected by the runner.',
-  ),
-  outputPath: z.string().optional().describe(
-    'Target path for the generated Playwright test file. Injected by the runner.',
-  ),
-  context: z.any().optional().describe(
-    'Run context bag (project config, env, …). Injected by the runner.',
-  ),
-
-  // ---- DOWNSTREAM NODE OUTPUTS (populated mid-graph, not by the user) ----
-  preflight: z.any().optional().describe(
-    'Output of the preflight node (assertion checklist + title). Set during the run.',
-  ),
-  execute_live: z.any().optional().describe(
-    'Output of the execute_live node (recorded actions + steps). Set during the run.',
-  ),
-});

package/templates/code-analysis/README.md

@@ -1,60 +0,0 @@
-# Code Analysis Template
-
-Multi-node workflow that analyzes a Jira ticket against a code repository
-and emits structured analysis + generated code + test cases.
-
-## Nodes
-
-- `setup` — clone repos into the workspace, snapshot baseline commit
-- `analyze_ticket` — LLM reads ticket + code, produces a validated
-  analysis (canProceed flag + reasoning)
-- `validation_check` — conditional decision: route to `generate_code`
-  if `canProceed`, else `finalize`
-- `generate_code` — LLM generates code changes scoped to the ticket
-- `generate_test_cases` — LLM generates test cases covering the changes
-- `finalize` — write outputs, mark complete
-
-## Required state inputs
-
-```js
-{
-  workspace: '/abs/path/to/workspace',          // local clone target
-  repos: [{
-    name: 'my-app',
-    url: 'https://github.com/org/my-app.git',
-    branch: 'main',
-    isPrimary: true,
-  }],
-  ticketContext: {
-    ticketKey: 'PROJ-123',
-    summary: 'short title',
-    description: 'long description',
-    acceptanceCriteria: 'optional',
-  },
-  githubToken: process.env.GITHUB_TOKEN,
-}
-```
-
-See `state.js` for the full Zod schema.
-
-## Customizing prompts
-
-The three LLM nodes load their prompts from `prompts/`:
-
-- `prompts/analyze-ticket.md`
-- `prompts/generate-code.md`
-- `prompts/generate-test-cases.md`
-
-Edit those files in your scaffolded copy to change agent behavior — no
-code changes needed. The graph reloads them at module-init time.
-
-## Cloud deployment
-
-```bash
-zibby workflow deploy <your-slug>
-zibby workflow trigger <uuid> --input '{"workspace": "...", ...}'
-```
-
-Cloud runs need network access for `git clone` (the `setup` node shells
-out to `git`). Default cloud egress works; pin to a specific IP via the
-dedicated-egress addon if you have firewalled git hosts.

package/templates/code-analysis/graph.js

@@ -1,72 +0,0 @@
-import { readFileSync, existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { setupNode } from './nodes/setup-node.js';
-import { analyzeTicketNode } from './nodes/analyze-ticket-node.js';
-import { generateCodeNode } from './nodes/generate-code-node.js';
-import { generateTestCasesNode } from './nodes/generate-test-cases-node.js';
-import { finalizeNode } from './nodes/finalize-node.js';
-import { analysisStateSchema } from './state.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const promptsDir = join(__dirname, 'prompts');
-
-// Helper to load prompt if file exists
-function loadPrompt(filename) {
-  const path = join(promptsDir, filename);
-  if (existsSync(path)) {
-    return readFileSync(path, 'utf-8');
-  }
-  return null;
-}
-
-// Load prompt templates at graph definition time
-const analyzeTicketPrompt = loadPrompt('analyze-ticket.md');
-const generateCodePrompt = loadPrompt('generate-code.md');
-const generateTestCasesPrompt = loadPrompt('generate-test-cases.md');
-
-export function buildAnalysisGraph(graph) {
-  graph.setStateSchema(analysisStateSchema);
-  
-  graph
-    .addNode('setup', setupNode)
-    .addNode('analyze_ticket', analyzeTicketNode, { 
-      prompt: analyzeTicketPrompt 
-    })
-    .addConditionalNode('validation_check', {
-      condition: (state) => {
-        const validation = state.analyze_ticket?.validation;
-        if (!validation?.canProceed) {
-          return 'finalize';
-        }
-        return 'generate_code';
-      }
-    })
-    .addNode('generate_code', generateCodeNode, { 
-      prompt: generateCodePrompt 
-    })
-    .addNode('generate_test_cases', generateTestCasesNode, {
-      prompt: generateTestCasesPrompt
-    })
-    .addNode('finalize', finalizeNode)
-    .setNodeType('validation_check', 'decision')
-    .setEntryPoint('setup')
-    .addEdge('setup', 'analyze_ticket')
-    .addEdge('analyze_ticket', 'validation_check')
-    .addConditionalEdges('validation_check', (state) => {
-      const validation = state.analyze_ticket?.validation || state.analyze_ticket_output?.validation;
-      if (validation?.canProceed) {
-        return 'generate_code';
-      }
-      return 'finalize';
-    }, {
-      labels: {
-        generate_code: 'if valid',
-        finalize: 'if invalid'
-      }
-    })
-    .addEdge('generate_code', 'generate_test_cases')
-    .addEdge('generate_test_cases', 'finalize');
-  
-  return graph;
-}

package/templates/code-analysis/graph.mjs

@@ -1,33 +0,0 @@
-/**
- * code-analysis template — scaffoldable WorkflowAgent wrapper.
- *
- * Why this file exists alongside graph.js:
- *   - graph.js exports `buildAnalysisGraph(graph)` — a builder
- *     function the existing `zibby analyze-graph` cli + backend
- *     analysis handlers consume directly. Its shape can't change
- *     without breaking those callers.
- *   - To make code-analysis scaffoldable via
- *     `zibby workflow new <slug> -t code-analysis` and runnable via
- *     `zibby workflow run <slug>` / `zibby workflow deploy <slug>`,
- *     the template needs to expose a WorkflowAgent class — same
- *     contract as browser-test-automation.
- *
- * This .mjs is the entry the user-facing scaffold uses; graph.js
- * stays put for internal callers.
- */
-
-import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
-import { buildAnalysisGraph } from './graph.js';
-
-export class CodeAnalysisAgent extends WorkflowAgent {
-  buildGraph() {
-    const graph = new WorkflowGraph();
-    buildAnalysisGraph(graph);
-    return graph;
-  }
-
-  async onComplete(result) {
-    const ok = result.success !== false;
-    console.log(`[code-analysis] complete — success: ${ok}`);
-  }
-}

package/templates/code-analysis/index.js

@@ -1,18 +0,0 @@
-/**
- * Code Analysis Module
- * Nodes for analyzing Jira tickets and generating code changes
- */
-
-// State Schema
-export { analysisStateSchema } from './state.js';
-
-// Nodes
-export { setupNode } from './nodes/setup-node.js';
-export { analyzeTicketNode } from './nodes/analyze-ticket-node.js';
-export { generateCodeNode, implementCodeNode } from './nodes/generate-code-node.js';
-export { generateTestCasesNode } from './nodes/generate-test-cases-node.js';
-export { createPRNode } from './nodes/create-pr-node.js';
-export { finalizeNode } from './nodes/finalize-node.js';
-
-// Graph Builder
-export { buildAnalysisGraph } from './graph.js';