pi-ghwebhook 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-11-09
+
+### Added
+
+- **Built-in `setup-ghwebhook` Skill**: Packaged an interactive setup skill that auto-detects `gh` CLI credentials, auto-heals missing `cli/gh-webhook` extensions, senses repo workflow and review bot configs, and scaffolds tailored `.pi/ghwebhook.json` rules.
+
 ## [0.1.0] - 2026-11-09
 
 ### Added

package/README.md

@@ -16,17 +16,17 @@ English | [中文](README_zh.md)
 
 ## Overview
 
-pi-ghwebhook eliminates manual polling and terminal switching after pushing code or creating pull requests. By hosting an in-process loopback server connected to GitHub CLI's `gh webhook forward` reverse tunnel, it receives real-time GitHub Webhook events, evaluates declarative filters, and wakes up the Pi Agent via `pi.sendUserMessage()` to close the loop.
+pi-ghwebhook eliminates manual polling and terminal switching after pushing code or creating pull requests. By hosting an in-process loopback server connected to GitHub CLI's `gh webhook forward` reverse tunnel, it receives real-time GitHub Webhook events, evaluates GitHub Actions Workflow-style trigger rules, and wakes up the Pi Agent via `pi.sendUserMessage()` to close the loop.
 
 ## Key Architecture
 
-- Upstream wire protocol: directly matches GitHub Webhook events (`<event>` or `<event>.<action>`). Supports all 100+ GitHub Webhook events.
-- Declarative filters: condition evaluation (`branch`, `conclusion`, `workflow`, `state`, `senders`, `isBot`, `match`) is offloaded to configuration rules rather than rigid code branches.
-- Zero public exposure: uses `gh webhook forward --events=*` local reverse tunnels. No public server, ngrok, or exposed port required.
-- Dynamic port allocation: binds to `127.0.0.1:0`. The OS kernel dynamically assigns an unused port, eliminating port contention across concurrent sessions.
-- Table-driven dispatch: O(1) hash map routing with strict complexity constraints (CCN <= 15, CogC <= 15).
-- Workspace detection: probes `.pi/ghwebhook.json` on `session_start`. If absent, sleeps silently with zero resource consumption.
-- Clean teardown: hooks into `session_shutdown` and process exit to terminate child processes and servers idempotently.
+- 100% GitHub Actions Workflow Specification: Uses official `on` and `jobs` syntax. Zero invented intermediate concepts.
+- JSON Schema Autocompletion: Includes an official schema (`$schema`) for instant editor IntelliSense and validation.
+- Zero Public Exposure: Uses `gh webhook forward --events=*` local reverse tunnels. No public server, ngrok, or exposed port required.
+- Dynamic Port Allocation: Binds to `127.0.0.1:0`. The OS kernel dynamically assigns an unused port, eliminating port contention across concurrent sessions.
+- Table-Driven Dispatch: O(1) event routing with strict complexity constraints (CCN <= 15, CogC <= 15).
+- Workspace Detection: Probes `.pi/ghwebhook.json` on `session_start`. If absent, sleeps silently with zero resource consumption.
+- Clean Teardown: Hooks into `session_shutdown` and process exit to terminate child processes and servers idempotently.
 
 ## Installation
 
@@ -50,108 +50,82 @@ pi -e /path/to/pi-ghwebhook
 
 ## Configuration (`.pi/ghwebhook.json`)
 
-Place `.pi/ghwebhook.json` (or `.agents/ghwebhook.json`) in the root of any repository:
+Place `.pi/ghwebhook.json` in the root of any repository. Point `$schema` to the hosted JSON Schema for auto-completion in VS Code, Cursor, and other editors:
 
 ```json
 {
-  "version": 1,
-  "enabled": true,
-  "repo": "auto",
-  "subscriptions": [
-    {
-      "event": "workflow_run.completed",
-      "filters": {
-        "branch": "@current",
-        "workflow": "CI",
-        "conclusion": "failure"
-      },
-      "action": {
-        "deliverAs": "followUp",
-        "prompt": "CI run failed on branch {{ branch }}.\n\nRun URL: {{ run_url }}\nCommit: {{ head_sha }}\n\nPlease inspect the failed run logs and propose a fix."
-      }
+  "$schema": "https://raw.githubusercontent.com/xifan2333/pi-ghwebhook/main/schemas/ghwebhook.schema.json",
+  "name": "CI & Review Automation",
+  "on": {
+    "workflow_run": {
+      "workflows": ["CI"],
+      "types": ["completed"],
+      "branches": ["@current"]
     },
-    {
-      "event": "workflow_run.completed",
-      "filters": {
-        "branch": "@current",
-        "conclusion": "success"
-      },
-      "action": {
-        "deliverAs": "followUp",
-        "prompt": "Remote CI has passed on branch {{ branch }}.\n\nRun URL: {{ run_url }}\n\nPlease check PR status and verify if it is ready to merge."
-      }
+    "pull_request_review": {
+      "types": ["submitted"],
+      "branches": ["@current"]
     },
-    {
-      "event": "pull_request_review.submitted",
-      "filters": {
-        "branch": "@current",
-        "isBot": true,
-        "senders": ["coderabbitai[bot]", "greptile[bot]"]
-      },
-      "action": {
-        "deliverAs": "steer",
-        "prompt": "Received review feedback from {{ sender }}:\n\nState: {{ review_state }}\nDetails:\n{{ review_body }}\n\nPlease evaluate these comments critically: fix genuine issues and refute false positives."
-      }
+    "issues": {
+      "types": ["opened"]
     },
-    {
-      "event": "issues.opened",
-      "action": {
-        "prompt": "New issue opened #{{ issue_number }}: {{ issue_title }}\n\n{{ issue_body }}"
-      }
+    "push": {
+      "branches": ["main"]
+    }
+  },
+  "jobs": {
+    "ci-failure": {
+      "if": "github.event.workflow_run.conclusion == 'failure'",
+      "prompt": "CI run failed on branch {{ branch }}.\n\nRun URL: {{ run_url }}\nCommit: {{ head_sha }}\n\nPlease run `gh run view {{ run_id }} --log-failed` to diagnose the error and prepare a fix.",
+      "deliverAs": "followUp"
+    },
+    "ci-success": {
+      "if": "github.event.workflow_run.conclusion == 'success'",
+      "prompt": "Remote CI has passed on branch {{ branch }}.\n\nRun URL: {{ run_url }}\n\nPlease check PR checks status and verify if it is ready to merge.",
+      "deliverAs": "followUp"
+    },
+    "review-bot": {
+      "if": "github.event.review.user.type == 'Bot'",
+      "prompt": "Received review comments from {{ sender }}:\n\nState: {{ review_state }}\nDetails:\n{{ review_body }}\n\nPlease evaluate these comments critically: triage true issues to fix, and refute false positives.",
+      "deliverAs": "steer"
+    },
+    "new-issue": {
+      "prompt": "New issue opened #{{ issue_number }}: {{ issue_title }}\n\n{{ issue_body }}"
     },
-    {
-      "event": "push",
-      "filters": {
-        "branch": "main"
-      },
-      "action": {
-        "prompt": "New commit pushed to main: {{ head_sha }} - {{ commit_message }}"
-      }
+    "push-main": {
+      "prompt": "New commit pushed to main: {{ head_sha }} - {{ commit_message }}"
     }
-  ]
+  }
 }
 ```
 
 ### Configuration Fields
 
-| Field           | Type      | Default     | Description                                                                                              |
-| --------------- | --------- | ----------- | -------------------------------------------------------------------------------------------------------- |
-| `version`       | `1`       | `1`         | Schema version (must be 1).                                                                              |
-| `enabled`       | `boolean` | `true`      | Enable or disable the extension for this workspace.                                                      |
-| `repo`          | `string`  | `"auto"`    | Target GitHub repository (`owner/repo`). Resolved from `git remote get-url origin` when set to `"auto"`. |
-| `secret`        | `string`  | `undefined` | Optional webhook HMAC SHA-256 secret.                                                                    |
-| `subscriptions` | `Array`   | `[]`        | List of event subscription rules.                                                                        |
-
-### Subscription Rule Fields
-
-- `event`: Upstream GitHub Webhook event identifier (e.g., `workflow_run.completed`, `pull_request.opened`, `push`, `issues.labeled`).
-- `topic`: Optional alias for `event`.
-- `filters`: Declarative matching criteria.
-- `action`: Action payload containing `prompt` and optional `deliverAs` (`"steer"` or `"followUp"`).
-
-### Filters
-
-- `branch`: Target branch name or `@current` (dynamically resolved to current working branch).
-- `conclusion`: Workflow conclusion (`success`, `failure`, `cancelled`, `skipped`, etc.).
-- `workflow`: Workflow name (e.g., `CI`).
-- `state`: Review state (`approved`, `changes_requested`, `commented`) or PR state.
-- `senders`: Array of allowed sender logins (e.g., `["coderabbitai[bot]"]`).
-- `isBot`: Boolean flag matching Bot (`true`) or Human (`false`) senders.
-- `match`: Key-value map for matching nested payload fields using dot notation (e.g., `{"review.state": "changes_requested"}`).
+- `name`: Optional workflow name.
+- `repo`: GitHub repository (`owner/repo`). Defaults to `"auto"` (resolved from `git remote get-url origin`).
+- `secret`: Optional webhook HMAC SHA-256 verification secret.
+- `on`: GitHub Actions event triggers specification:
+  - `<event_name>`: Event name (e.g. `workflow_run`, `pull_request`, `push`, `issues`).
+  - `types`: Activity types filtering `payload.action` (e.g. `["completed"]`, `["opened"]`).
+  - `branches`: Branches filter supporting `@current` and globs (e.g. `["@current", "main", "feat/*"]`).
+  - `workflows`: Workflow names filter (e.g. `["CI"]`).
+- `jobs`: Map of jobs to execute:
+  - `if`: Conditional expression (e.g. `github.event.workflow_run.conclusion == 'failure'`).
+  - `prompt`: Prompt template sent to Pi Agent.
+  - `deliverAs`: Pi message delivery mode: `"followUp"` (default) or `"steer"`.
 
 ### Template Variables
 
-- `{{ branch }}`: Branch name
-- `{{ head_sha }}`: Commit SHA
-- `{{ commit_message }}`: Head commit message
-- `{{ repo }}` / `{{ repo_url }}`: Repository name and URL
-- `{{ run_id }}` / `{{ run_url }}` / `{{ workflow }}` / `{{ conclusion }}`: Workflow run metadata
-- `{{ pr_number }}` / `{{ pr_title }}` / `{{ pr_url }}`: Pull request details
-- `{{ issue_number }}` / `{{ issue_title }}` / `{{ issue_url }}` / `{{ issue_body }}`: Issue details
-- `{{ sender }}` / `{{ sender_type }}`: Triggering actor
-- `{{ review_state }}` / `{{ review_body }}` / `{{ review_url }}`: Review details
-- `{{ comment_body }}` / `{{ comment_url }}`: Comment details
-- `{{ action }}`: Payload action string
+- `{{ branch }}`: Current head branch.
+- `{{ head_sha }}`: Commit SHA.
+- `{{ commit_message }}`: Head commit message.
+- `{{ repo }}` / `{{ repo_url }}`: Repository name and URL.
+- `{{ run_id }}` / `{{ run_url }}` / `{{ workflow }}` / `{{ conclusion }}`: Workflow run metadata.
+- `{{ pr_number }}` / `{{ pr_title }}` / `{{ pr_url }}`: Pull request details.
+- `{{ issue_number }}` / `{{ issue_title }}` / `{{ issue_url }}` / `{{ issue_body }}`: Issue details.
+- `{{ sender }}` / `{{ sender_type }}`: Triggering actor.
+- `{{ review_state }}` / `{{ review_body }}` / `{{ review_url }}`: Review details.
+- `{{ comment_body }}` / `{{ comment_url }}`: Comment details.
 
 ## Development & Quality Gates
 

package/README_zh.md

@@ -16,14 +16,14 @@
 
 ## 概述
 
-pi-ghwebhook 旨在彻底消除提交代码或创建 Pull Request 后的人工轮询与终端反复切换。通过在进程内运行回环 HTTP 服务并托管 GitHub CLI 的 `gh webhook forward` 反向长连接隧道，它可以实时接收 GitHub Webhook 事件，依据声明式守卫规则进行快速匹配过滤，并通过 `pi.sendUserMessage()` 主动唤醒 Pi Agent 进入闭环处置。
+pi-ghwebhook 旨在彻底消除提交代码或创建 Pull Request 后的人工轮询与终端反复切换。通过在进程内运行回环 HTTP 服务并托管 GitHub CLI 的 `gh webhook forward` 反向长连接隧道，它可以实时接收 GitHub Webhook 事件，依据 GitHub Actions Workflow 官方规范解析规则，并通过 `pi.sendUserMessage()` 主动唤醒 Pi Agent 进入闭环处置。
 
 ## 核心架构特性
 
-- 上游协议 1:1 对齐：直接匹配 GitHub 官方线缆事件（`<event>` 或 `<event>.<action>`），天然支持所有 100+ 种 GitHub Webhook 事件。
-- 声明式灵活过滤：将状态与结论判断（`branch`、`conclusion`、`workflow`、`state`、`senders`、`isBot`、`match`）全部下沉至配置规则中，拒绝代码硬编码伪语义。
+- 100% 对齐 GitHub Actions Workflow 官方规范：完全采用官方标准的 `on` 触发器与 `jobs` 任务语法，零中间层生造概念。
+- JSON Schema 智能提示：提供官方 Schema（`$schema`），在 VS Code、Cursor 等现代编辑器中编写即享全字段类型补全与静态校验。
 - 零公网暴露：依托 `gh webhook forward --events=*` 反向隧道，无需公网服务器、固定 IP 或内网穿透工具。
-- 动态端口分配：监听 `127.0.0.1:0`，由操作系统内核分配空闲端口，杜绝多终端或多会话并发运行时的端口冲突。
+- 动态端口分配：监听 `127.0.0.1:0`，由操作系统内核动态分配空闲端口，杜绝多终端或多会话并发运行时的端口冲突。
 - 表驱动分发：基于哈希表实现 O(1) 路由分发，执行严格的复杂度门禁（CCN <= 15, CogC <= 15）。
 - 工作区自感知：在 `session_start` 生命周期探测 `.pi/ghwebhook.json`，无配置时静默休眠，零资源占用。
 - 幂等清理保障：深度绑定 `session_shutdown` 与进程退出钩子，确保子进程与本地服务干净释放，不留孤儿进程。
@@ -50,94 +50,69 @@ pi -e /path/to/pi-ghwebhook
 
 ## 配置契约 (`.pi/ghwebhook.json`)
 
-在需要启用事件驱动的仓库根目录下创建 `.pi/ghwebhook.json`（或 `.agents/ghwebhook.json`）：
+在仓库根目录下创建 `.pi/ghwebhook.json`。配置 `$schema` 即可享受现代 IDE 的实时悬浮提示与自动补全：
 
 ```json
 {
-  "version": 1,
-  "enabled": true,
-  "repo": "auto",
-  "subscriptions": [
-    {
-      "event": "workflow_run.completed",
-      "filters": {
-        "branch": "@current",
-        "workflow": "CI",
-        "conclusion": "failure"
-      },
-      "action": {
-        "deliverAs": "followUp",
-        "prompt": "分支 {{ branch }} 的 CI 运行失败。\n\n运行链接: {{ run_url }}\n提交哈希: {{ head_sha }}\n\n请查看失败日志并给出修复方案。"
-      }
+  "$schema": "https://raw.githubusercontent.com/xifan2333/pi-ghwebhook/main/schemas/ghwebhook.schema.json",
+  "name": "CI & Review Automation",
+  "on": {
+    "workflow_run": {
+      "workflows": ["CI"],
+      "types": ["completed"],
+      "branches": ["@current"]
     },
-    {
-      "event": "workflow_run.completed",
-      "filters": {
-        "branch": "@current",
-        "conclusion": "success"
-      },
-      "action": {
-        "deliverAs": "followUp",
-        "prompt": "分支 {{ branch }} 的远程 CI 已全部通过。\n\n运行链接: {{ run_url }}\n\n请检查 PR 状态并确认是否准备合入。"
-      }
+    "pull_request_review": {
+      "types": ["submitted"],
+      "branches": ["@current"]
     },
-    {
-      "event": "pull_request_review.submitted",
-      "filters": {
-        "branch": "@current",
-        "isBot": true,
-        "senders": ["coderabbitai[bot]", "greptile[bot]"]
-      },
-      "action": {
-        "deliverAs": "steer",
-        "prompt": "收到来自 {{ sender }} 的评审意见：\n\n评审状态: {{ review_state }}\n详情内容:\n{{ review_body }}\n\n请批判性评估上述审查意见：修复真实问题，驳回误报。"
-      }
+    "issues": {
+      "types": ["opened"]
     },
-    {
-      "event": "issues.opened",
-      "action": {
-        "prompt": "收到新 Issue #{{ issue_number }}: {{ issue_title }}\n\n{{ issue_body }}"
-      }
+    "push": {
+      "branches": ["main"]
+    }
+  },
+  "jobs": {
+    "ci-failure": {
+      "if": "github.event.workflow_run.conclusion == 'failure'",
+      "prompt": "分支 {{ branch }} 的 CI 运行失败。\n\n运行链接: {{ run_url }}\n提交哈希: {{ head_sha }}\n\n请使用 `gh run view {{ run_id }} --log-failed` 查看失败日志并进行修复。",
+      "deliverAs": "followUp"
+    },
+    "ci-success": {
+      "if": "github.event.workflow_run.conclusion == 'success'",
+      "prompt": "分支 {{ branch }} 的远程 CI 已全部通过。\n\n运行链接: {{ run_url }}\n\n请检查 PR 状态并确认是否准备合入。",
+      "deliverAs": "followUp"
+    },
+    "review-bot": {
+      "if": "github.event.review.user.type == 'Bot'",
+      "prompt": "收到来自 {{ sender }} 的审查意见：\n\n状态: {{ review_state }}\n详情:\n{{ review_body }}\n\n请批判性评估上述审查意见：修复真实问题，驳回误报。",
+      "deliverAs": "steer"
     },
-    {
-      "event": "push",
-      "filters": {
-        "branch": "main"
-      },
-      "action": {
-        "prompt": "main 分支收到新推送: {{ head_sha }} - {{ commit_message }}"
-      }
+    "new-issue": {
+      "prompt": "收到新 Issue #{{ issue_number }}: {{ issue_title }}\n\n{{ issue_body }}"
+    },
+    "push-main": {
+      "prompt": "main 分支收到新代码推送: {{ head_sha }} - {{ commit_message }}"
     }
-  ]
+  }
 }
 ```
 
-### 顶层配置字段
-
-| 字段            | 类型      | 默认值      | 说明                                                                                        |
-| --------------- | --------- | ----------- | ------------------------------------------------------------------------------------------- |
-| `version`       | `1`       | `1`         | 契约版本号（必须为 1）。                                                                    |
-| `enabled`       | `boolean` | `true`      | 是否在当前工作区启用该扩展。                                                                |
-| `repo`          | `string`  | `"auto"`    | 目标 GitHub 仓库名（`owner/repo`）。为 `"auto"` 时自动从 `git remote get-url origin` 提取。 |
-| `secret`        | `string`  | `undefined` | 可选的 Webhook HMAC SHA-256 鉴权密钥。                                                      |
-| `subscriptions` | `Array`   | `[]`        | 声明式事件订阅规则列表。                                                                    |
-
-### 订阅规则字段
-
-- `event`: 上游 GitHub Webhook 事件名称（如 `workflow_run.completed`、`pull_request.opened`、`push`、`issues.labeled`）。
-- `topic`: `event` 字段的可选别名。
-- `filters`: 声明式过滤守卫。
-- `action`: 唤醒动作负载，包含 `prompt` 模板和可选的 `deliverAs`（`"steer"` 或 `"followUp"`）。
-
-### 过滤守卫 (Filters)
-
-- `branch`: 目标分支名称，或特殊符号 `@current`（动态解析为本地当前分支）。
-- `conclusion`: 工作流运行结论（`success`、`failure`、`cancelled`、`skipped` 等）。
-- `workflow`: 工作流名称（如 `CI`）。
-- `state`: 评审状态（`approved`、`changes_requested`、`commented`）或 PR 状态。
-- `senders`: 允许的发送者登录名数组（如 `["coderabbitai[bot]"]`）。
-- `isBot`: 布尔标志，匹配机器人（`true`）或人类（`false`）发送者。
-- `match`: 任意键值映射表，使用点路径语法匹配负载深层字段（如 `{"review.state": "changes_requested"}`）。
+### 字段说明
+
+- `name`: 可选的工作流名称。
+- `repo`: GitHub 仓库名（`owner/repo`）。默认为 `"auto"`（自动从 `git remote get-url origin` 提取）。
+- `secret`: 可选的 Webhook HMAC SHA-256 鉴权密钥。
+- `on`: GitHub Actions 事件触发器配置：
+  - `<event_name>`: 官方事件名称（如 `workflow_run`, `pull_request`, `push`, `issues`）。
+  - `types`: 官方活动类型过滤 `payload.action`（如 `["completed"]`, `["opened"]`）。
+  - `branches`: 分支过滤，支持 `@current` 动态分支与 glob（如 `["@current", "main", "feat/*"]`）。
+  - `workflows`: 工作流过滤（如 `["CI"]`）。
+- `jobs`: 触发时执行的任务字典：
+  - `if`: 表达式条件（如 `github.event.workflow_run.conclusion == 'failure'`）。
+  - `prompt`: 传给 Pi Agent 的提示词内容模板。
+  - `deliverAs`: Pi 消息投递模式：`"followUp"`（默认排队执行）或 `"steer"`（实时插话打断）。
 
 ### 模板插值变量
 
@@ -151,7 +126,6 @@ pi -e /path/to/pi-ghwebhook
 - `{{ sender }}` / `{{ sender_type }}`: 触发人或机器人
 - `{{ review_state }}` / `{{ review_body }}` / `{{ review_url }}`: 评审详情
 - `{{ comment_body }}` / `{{ comment_url }}`: 评论详情
-- `{{ action }}`: 负载操作动作名
 
 ## 开发与质量门禁
 

package/dist/bus/event-bus.d.ts

@@ -1,14 +1,14 @@
-import type { SubscriptionRule } from "../types/schema.js";
+import type { GhWebhookWorkflow } from "../types/schema.js";
 import type { WebhookPayload } from "../types/payload.js";
 export interface ActionPlan {
     prompt: string;
     deliverAs: "steer" | "followUp";
-    event: string;
+    jobId: string;
 }
 export declare class WebhookEventBus {
-    private readonly routes;
-    constructor(rules: SubscriptionRule[]);
-    getEvents(): string[];
-    dispatch(event: string, payload: WebhookPayload, currentBranch: string): ActionPlan[];
+    private readonly workflow;
+    constructor(workflow: GhWebhookWorkflow);
+    private getTriggerForEvent;
+    dispatch(incomingEvent: string, payload: WebhookPayload, currentBranch: string): ActionPlan[];
 }
 //# sourceMappingURL=event-bus.d.ts.map

package/dist/bus/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/bus/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAEpD,KAAK,EAAE,gBAAgB,EAAE;IAYrC,SAAS,IAAI,MAAM,EAAE;IAIrB,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE;CAoChB"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/bus/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iBAAiB;IAExD,OAAO,CAAC,kBAAkB;IAkB1B,QAAQ,CACN,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE;CA2BhB"}

package/dist/bus/event-bus.js

@@ -1,51 +1,44 @@
-import { evaluateGuards } from "./guards.js";
-import { normalizeEventKey, resolveIncomingEventKeys } from "./normalizer.js";
+import { isTriggerMatched, evaluateCondition } from "./matcher.js";
 import { extractVariables, renderTemplate } from "../template/renderer.js";
 export class WebhookEventBus {
-    routes = new Map();
-    constructor(rules) {
-        for (const rule of rules) {
-            const rawKey = rule.event ?? rule.topic;
-            if (!rawKey)
-                continue;
-            const normalizedKey = normalizeEventKey(rawKey);
-            const existing = this.routes.get(normalizedKey) ?? [];
-            existing.push(rule);
-            this.routes.set(normalizedKey, existing);
-        }
-    }
-    getEvents() {
-        return Array.from(this.routes.keys());
+    workflow;
+    constructor(workflow) {
+        this.workflow = workflow;
     }
-    dispatch(event, payload, currentBranch) {
-        const candidateKeys = resolveIncomingEventKeys(event, payload);
-        const seenRules = new Set();
-        const matchedRules = [];
-        for (const key of candidateKeys) {
-            const rules = this.routes.get(key);
-            if (!rules)
-                continue;
-            for (const rule of rules) {
-                if (!seenRules.has(rule)) {
-                    seenRules.add(rule);
-                    matchedRules.push(rule);
-                }
+    getTriggerForEvent(incomingEvent) {
+        const on = this.workflow.on;
+        if (typeof on === "string") {
+            return on === incomingEvent ? null : undefined;
+        }
+        if (Array.isArray(on)) {
+            return on.includes(incomingEvent) ? null : undefined;
+        }
+        if (typeof on === "object" && on !== null) {
+            if (Object.prototype.hasOwnProperty.call(on, incomingEvent)) {
+                return on[incomingEvent];
             }
         }
-        if (matchedRules.length === 0) {
+        return undefined;
+    }
+    dispatch(incomingEvent, payload, currentBranch) {
+        const trigger = this.getTriggerForEvent(incomingEvent);
+        if (trigger === undefined) {
+            return [];
+        }
+        if (!isTriggerMatched(trigger, payload, currentBranch)) {
             return [];
         }
-        const ctx = { currentBranch, payload };
         const vars = extractVariables(payload, currentBranch);
         const plans = [];
-        for (const rule of matchedRules) {
-            if (evaluateGuards(rule.filters, ctx)) {
-                plans.push({
-                    prompt: renderTemplate(rule.action.prompt, vars),
-                    deliverAs: rule.action.deliverAs ?? "followUp",
-                    event: rule.event ?? rule.topic ?? event,
-                });
+        for (const [jobId, job] of Object.entries(this.workflow.jobs)) {
+            if (!evaluateCondition(job.if, payload, currentBranch)) {
+                continue;
             }
+            plans.push({
+                prompt: renderTemplate(job.prompt, vars),
+                deliverAs: job.deliverAs ?? "followUp",
+                jobId,
+            });
         }
         return plans;
     }

package/dist/bus/event-bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/bus/event-bus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQ3E,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEhE,YAAY,KAAyB;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;YACxC,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,CACN,KAAa,EACb,OAAuB,EACvB,aAAqB;QAErB,MAAM,aAAa,GAAG,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC9C,MAAM,YAAY,GAAuB,EAAE,CAAC;QAE5C,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACpB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACtD,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC;oBACT,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;oBAChD,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,UAAU;oBAC9C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK;iBACzC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/bus/event-bus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQ3E,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,QAA2B;QAA3B,aAAQ,GAAR,QAAQ,CAAmB;IAAG,CAAC;IAEpD,kBAAkB,CACxB,aAAqB;QAErB,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACjD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC;gBAC5D,OAAO,EAAE,CAAC,aAAa,CAA8B,CAAC;YACxD,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CACN,aAAqB,EACrB,OAAuB,EACvB,aAAqB;QAErB,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACtD,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;gBACxC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,UAAU;gBACtC,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/bus/matcher.d.ts

@@ -0,0 +1,7 @@
+import type { WebhookPayload } from "../types/payload.js";
+import type { EventTriggerConfig } from "../types/schema.js";
+export declare function globMatch(pattern: string, text: string): boolean;
+export declare function resolvePayloadBranch(payload: WebhookPayload): string | undefined;
+export declare function isTriggerMatched(trigger: EventTriggerConfig | null | undefined, payload: WebhookPayload, currentBranch: string): boolean;
+export declare function evaluateCondition(expr: string | undefined, payload: WebhookPayload, currentBranch: string): boolean;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/bus/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/bus/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQhE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,GACtB,MAAM,GAAG,SAAS,CAUpB;AA8CD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAOT;AAmDD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CA0BT"}