Official VS Code extension for the Agnostic Trigger System. This extension provides rich language support for YAML-based trigger rules, making it easier to build, debug, and maintain complex event-driven logic.
🌟 Overview
The Trigger System is a protocol-agnostic, event-driven engine designed to execute dynamic logic in real-time. This extension transforms VS Code into a first-class IDE for writing these rules by providing deep integration with the system's schema and data context.
Whether you are building complex game mechanics, payment workflows, or IoT automation, this extension ensures your rules are syntactically correct and perfectly typed before they ever reach production.
Features
🔍 Real-time Validation
Instant feedback on YAML syntax errors.
Deep schema validation using ArkType.
Highlight missing required fields (like id, on, do).
⌨️ Smart Autocompletion
Suggestions for core operators: on, if, do, when.
Context-aware completions for condition operators (e.g., EQ, GT, MATCHES).
Suggestions for schema keys and common values.
ℹ️ Hover Documentation
Detailed descriptions for every field in the rule schema.
Instant access to documentation for operators and action types.
🎯 Data Context & Templates
Intelligent suggestions for template variables (e.g., ${data.percentage}).
Previews of variable values from your data source.
🛠️ Directive Support
Control the linter with comments:
# @disable-lint: Disable all diagnostics for a file.
# @disable-rule <id>: Disable a specific validation rule.
Getting Started
Install the extension from the VS Code Marketplace or by installing the .vsix file.
Open any .yaml or .yml file containing Trigger Rules.
The extension will automatically activate for files with trigger system structures.
Extension Settings
This extension contributes the following settings:
triggerSystem.lsp.trace.server: Traces the communication between VS Code and the language server.
Requirements
VS Code version 1.75.0 or higher.
(Recommended) The Agnostic Trigger System core library installed in your workspace.
Development
If you want to build the extension from source:
Clone the repository.
Run bun install in the root and in vscode-extension/.
Run bun run build:all to bundle the server and client.
