feat: workflow yaml schema

[tribhuwan-kumar]

fix: #298

on demand schema generation if required:

cargo run --bin  generate-schema

include the schema in workflow file:

# yaml-language-server: $schema=../../../schema/workflow-schema.yaml # or github raw url
variables:
  extension_dir:
    default: "%TEMP%\\terminator-bridge"
    label: Folder to load (will be created by the download step)
    type: string
  release_url:
    default: https://github.com/mediar-ai/terminator/releases/latest/download/terminator-browser-extension.zip
    label: GitHub Release asset URL (zip)
    type: string
  zip_path:
    default: "%TEMP%\\terminator-browser-extension.zip"
    label: Path to downloaded zip
    type: string
    .................
    .................

[louis030195]

not sure what's the use case?

[tribhuwan-kumar]

the schema will provide a base for workflow file, follows the correct data type and validation!

• validation: correct structure and data types, catching errors early before running the workflow.

• autocompletion: editors like vscode with LSP support would provide autocompletion for fields via yaml shcema, it makes easier and faster to write valid yaml.

• documentation: this schema will act as live documentation, describing what fields and values are allowed, reducing the need to constantly refer to external docs

• error highlighting: invalid or missing fields are highlighted in real-time, it would help us to fix mistakes instantly

• consistency: enforcing a schema ensures all workflow files across a project or organization follow the same conventions and standards

every standard workflow has their own schema, take a look at github action workflow schema https://www.schemastore.org/github-workflow.json

recording-2025-11-14-06-29-40.webm

vs code yaml LSP https://github.com/redhat-developer/vscode-yaml

@louis030195

[louis030195]

thats cool

i think in the future we want to keep supporting both yaml and typescript but remove the MCP tools and make AI only use directly run_command and execute_sequence so let me a bit more time to think about it