pi-ghwebhook 0.0.0-stage → 0.2.0

package/dist/types/enums.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Standard GitHub Webhook Event names as sent in the `X-GitHub-Event` HTTP header.
+ */
+export declare enum GitHubEvent {
+    WorkflowRun = "workflow_run",
+    WorkflowJob = "workflow_job",
+    PullRequest = "pull_request",
+    PullRequestReview = "pull_request_review",
+    PullRequestReviewComment = "pull_request_review_comment",
+    CheckSuite = "check_suite",
+    CheckRun = "check_run",
+    IssueComment = "issue_comment",
+    Issues = "issues",
+    Push = "push",
+    Release = "release"
+}
+/**
+ * Standard conclusions for GitHub Actions workflow runs and check suites,
+ * aligned with GitHub OpenAPI specification (@octokit/openapi-webhooks-types).
+ */
+export declare enum WorkflowConclusion {
+    Success = "success",
+    Failure = "failure",
+    Cancelled = "cancelled",
+    TimedOut = "timed_out",
+    Neutral = "neutral",
+    ActionRequired = "action_required",
+    Skipped = "skipped",
+    Stale = "stale",
+    StartupFailure = "startup_failure"
+}
+/**
+ * Review state for pull request reviews.
+ */
+export declare enum ReviewState {
+    Approved = "approved",
+    ChangesRequested = "changes_requested",
+    Commented = "commented",
+    Dismissed = "dismissed"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/types/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,iBAAiB,wBAAwB;IACzC,wBAAwB,gCAAgC;IACxD,UAAU,gBAAgB;IAC1B,QAAQ,cAAc;IACtB,YAAY,kBAAkB;IAC9B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,QAAQ,cAAc;IACtB,OAAO,YAAY;IACnB,cAAc,oBAAoB;IAClC,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,cAAc,oBAAoB;CACnC;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,QAAQ,aAAa;IACrB,gBAAgB,sBAAsB;IACtC,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB"}

package/dist/types/enums.js

@@ -0,0 +1,44 @@
+/**
+ * Standard GitHub Webhook Event names as sent in the `X-GitHub-Event` HTTP header.
+ */
+export var GitHubEvent;
+(function (GitHubEvent) {
+    GitHubEvent["WorkflowRun"] = "workflow_run";
+    GitHubEvent["WorkflowJob"] = "workflow_job";
+    GitHubEvent["PullRequest"] = "pull_request";
+    GitHubEvent["PullRequestReview"] = "pull_request_review";
+    GitHubEvent["PullRequestReviewComment"] = "pull_request_review_comment";
+    GitHubEvent["CheckSuite"] = "check_suite";
+    GitHubEvent["CheckRun"] = "check_run";
+    GitHubEvent["IssueComment"] = "issue_comment";
+    GitHubEvent["Issues"] = "issues";
+    GitHubEvent["Push"] = "push";
+    GitHubEvent["Release"] = "release";
+})(GitHubEvent || (GitHubEvent = {}));
+/**
+ * Standard conclusions for GitHub Actions workflow runs and check suites,
+ * aligned with GitHub OpenAPI specification (@octokit/openapi-webhooks-types).
+ */
+export var WorkflowConclusion;
+(function (WorkflowConclusion) {
+    WorkflowConclusion["Success"] = "success";
+    WorkflowConclusion["Failure"] = "failure";
+    WorkflowConclusion["Cancelled"] = "cancelled";
+    WorkflowConclusion["TimedOut"] = "timed_out";
+    WorkflowConclusion["Neutral"] = "neutral";
+    WorkflowConclusion["ActionRequired"] = "action_required";
+    WorkflowConclusion["Skipped"] = "skipped";
+    WorkflowConclusion["Stale"] = "stale";
+    WorkflowConclusion["StartupFailure"] = "startup_failure";
+})(WorkflowConclusion || (WorkflowConclusion = {}));
+/**
+ * Review state for pull request reviews.
+ */
+export var ReviewState;
+(function (ReviewState) {
+    ReviewState["Approved"] = "approved";
+    ReviewState["ChangesRequested"] = "changes_requested";
+    ReviewState["Commented"] = "commented";
+    ReviewState["Dismissed"] = "dismissed";
+})(ReviewState || (ReviewState = {}));
+//# sourceMappingURL=enums.js.map

package/dist/types/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,WAYX;AAZD,WAAY,WAAW;IACrB,2CAA4B,CAAA;IAC5B,2CAA4B,CAAA;IAC5B,2CAA4B,CAAA;IAC5B,wDAAyC,CAAA;IACzC,uEAAwD,CAAA;IACxD,yCAA0B,CAAA;IAC1B,qCAAsB,CAAA;IACtB,6CAA8B,CAAA;IAC9B,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,kCAAmB,CAAA;AACrB,CAAC,EAZW,WAAW,KAAX,WAAW,QAYtB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAUX;AAVD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;IACnB,6CAAuB,CAAA;IACvB,4CAAsB,CAAA;IACtB,yCAAmB,CAAA;IACnB,wDAAkC,CAAA;IAClC,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,wDAAkC,CAAA;AACpC,CAAC,EAVW,kBAAkB,KAAlB,kBAAkB,QAU7B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,oCAAqB,CAAA;IACrB,qDAAsC,CAAA;IACtC,sCAAuB,CAAA;IACvB,sCAAuB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/dist/types/payload.d.ts

@@ -0,0 +1,28 @@
+import type { components } from "@octokit/openapi-webhooks-types";
+export type WebhookSchemas = components["schemas"];
+export type WorkflowRunCompletedPayload = WebhookSchemas["webhook-workflow-run-completed"];
+export type WorkflowRunInProgressPayload = WebhookSchemas["webhook-workflow-run-in-progress"];
+export type WorkflowRunRequestedPayload = WebhookSchemas["webhook-workflow-run-requested"];
+export type WorkflowRunPayload = WorkflowRunCompletedPayload | WorkflowRunInProgressPayload | WorkflowRunRequestedPayload;
+export type PullRequestReviewSubmittedPayload = WebhookSchemas["webhook-pull-request-review-submitted"];
+export type PullRequestReviewEditedPayload = WebhookSchemas["webhook-pull-request-review-edited"];
+export type PullRequestReviewDismissedPayload = WebhookSchemas["webhook-pull-request-review-dismissed"];
+export type PullRequestReviewPayload = PullRequestReviewSubmittedPayload | PullRequestReviewEditedPayload | PullRequestReviewDismissedPayload;
+export type PullRequestReviewCommentCreatedPayload = WebhookSchemas["webhook-pull-request-review-comment-created"];
+export type PullRequestReviewCommentEditedPayload = WebhookSchemas["webhook-pull-request-review-comment-edited"];
+export type PullRequestReviewCommentDeletedPayload = WebhookSchemas["webhook-pull-request-review-comment-deleted"];
+export type PullRequestReviewCommentPayload = PullRequestReviewCommentCreatedPayload | PullRequestReviewCommentEditedPayload | PullRequestReviewCommentDeletedPayload;
+export type CheckSuiteCompletedPayload = WebhookSchemas["webhook-check-suite-completed"];
+export type CheckSuiteRequestedPayload = WebhookSchemas["webhook-check-suite-requested"];
+export type CheckSuiteRerequestedPayload = WebhookSchemas["webhook-check-suite-rerequested"];
+export type CheckSuitePayload = CheckSuiteCompletedPayload | CheckSuiteRequestedPayload | CheckSuiteRerequestedPayload;
+export type IssueCommentCreatedPayload = WebhookSchemas["webhook-issue-comment-created"];
+export type IssueCommentEditedPayload = WebhookSchemas["webhook-issue-comment-edited"];
+export type IssueCommentDeletedPayload = WebhookSchemas["webhook-issue-comment-deleted"];
+export type IssueCommentPayload = IssueCommentCreatedPayload | IssueCommentEditedPayload | IssueCommentDeletedPayload;
+export type SupportedWebhookPayload = WorkflowRunPayload | PullRequestReviewPayload | PullRequestReviewCommentPayload | CheckSuitePayload | IssueCommentPayload;
+/**
+ * Fallback generic webhook payload structure for unknown or untyped events.
+ */
+export type WebhookPayload = Record<string, any>;
+//# sourceMappingURL=payload.d.ts.map

package/dist/types/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/types/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AAGnD,MAAM,MAAM,2BAA2B,GACrC,cAAc,CAAC,gCAAgC,CAAC,CAAC;AACnD,MAAM,MAAM,4BAA4B,GACtC,cAAc,CAAC,kCAAkC,CAAC,CAAC;AACrD,MAAM,MAAM,2BAA2B,GACrC,cAAc,CAAC,gCAAgC,CAAC,CAAC;AACnD,MAAM,MAAM,kBAAkB,GAC1B,2BAA2B,GAC3B,4BAA4B,GAC5B,2BAA2B,CAAC;AAGhC,MAAM,MAAM,iCAAiC,GAC3C,cAAc,CAAC,uCAAuC,CAAC,CAAC;AAC1D,MAAM,MAAM,8BAA8B,GACxC,cAAc,CAAC,oCAAoC,CAAC,CAAC;AACvD,MAAM,MAAM,iCAAiC,GAC3C,cAAc,CAAC,uCAAuC,CAAC,CAAC;AAC1D,MAAM,MAAM,wBAAwB,GAChC,iCAAiC,GACjC,8BAA8B,GAC9B,iCAAiC,CAAC;AAGtC,MAAM,MAAM,sCAAsC,GAChD,cAAc,CAAC,6CAA6C,CAAC,CAAC;AAChE,MAAM,MAAM,qCAAqC,GAC/C,cAAc,CAAC,4CAA4C,CAAC,CAAC;AAC/D,MAAM,MAAM,sCAAsC,GAChD,cAAc,CAAC,6CAA6C,CAAC,CAAC;AAChE,MAAM,MAAM,+BAA+B,GACvC,sCAAsC,GACtC,qCAAqC,GACrC,sCAAsC,CAAC;AAG3C,MAAM,MAAM,0BAA0B,GACpC,cAAc,CAAC,+BAA+B,CAAC,CAAC;AAClD,MAAM,MAAM,0BAA0B,GACpC,cAAc,CAAC,+BAA+B,CAAC,CAAC;AAClD,MAAM,MAAM,4BAA4B,GACtC,cAAc,CAAC,iCAAiC,CAAC,CAAC;AACpD,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,CAAC;AAGjC,MAAM,MAAM,0BAA0B,GACpC,cAAc,CAAC,+BAA+B,CAAC,CAAC;AAClD,MAAM,MAAM,yBAAyB,GACnC,cAAc,CAAC,8BAA8B,CAAC,CAAC;AACjD,MAAM,MAAM,0BAA0B,GACpC,cAAc,CAAC,+BAA+B,CAAC,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAC3B,0BAA0B,GAC1B,yBAAyB,GACzB,0BAA0B,CAAC;AAE/B,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,wBAAwB,GACxB,+BAA+B,GAC/B,iBAAiB,GACjB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}

package/dist/types/payload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payload.js.map

package/dist/types/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/types/payload.ts"],"names":[],"mappings":""}

package/dist/types/schema.d.ts

@@ -0,0 +1,33 @@
+import { Type, type Static } from "typebox";
+export declare const EventTriggerSchema: Type.TObject<{
+    types: Type.TOptional<Type.TArray<Type.TString>>;
+    branches: Type.TOptional<Type.TArray<Type.TString>>;
+    workflows: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export type EventTriggerConfig = Static<typeof EventTriggerSchema>;
+export declare const JobSchema: Type.TObject<{
+    name: Type.TOptional<Type.TString>;
+    if: Type.TOptional<Type.TString>;
+    prompt: Type.TString;
+    deliverAs: Type.TOptional<Type.TUnion<[Type.TLiteral<"steer">, Type.TLiteral<"followUp">]>>;
+}>;
+export type JobConfig = Static<typeof JobSchema>;
+export declare const WorkflowSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    name: Type.TOptional<Type.TString>;
+    repo: Type.TOptional<Type.TString>;
+    secret: Type.TOptional<Type.TString>;
+    on: Type.TUnion<[Type.TString, Type.TArray<Type.TString>, Type.TRecord<"^.*$", Type.TUnion<[Type.TNull, Type.TObject<{
+        types: Type.TOptional<Type.TArray<Type.TString>>;
+        branches: Type.TOptional<Type.TArray<Type.TString>>;
+        workflows: Type.TOptional<Type.TArray<Type.TString>>;
+    }>]>>]>;
+    jobs: Type.TRecord<"^.*$", Type.TObject<{
+        name: Type.TOptional<Type.TString>;
+        if: Type.TOptional<Type.TString>;
+        prompt: Type.TString;
+        deliverAs: Type.TOptional<Type.TUnion<[Type.TLiteral<"steer">, Type.TLiteral<"followUp">]>>;
+    }>>;
+}>;
+export type GhWebhookWorkflow = Static<typeof WorkflowSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,kBAAkB;;;;EAe9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,eAAO,MAAM,SAAS;;;;;EAkBrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAC;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;EA2B1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/types/schema.js

@@ -0,0 +1,35 @@
+import { Type } from "typebox";
+export const EventTriggerSchema = Type.Object({
+    types: Type.Optional(Type.Array(Type.String(), { description: "Event activity types" })),
+    branches: Type.Optional(Type.Array(Type.String(), {
+        description: "Branch filters, supports '@current' and globs",
+    })),
+    workflows: Type.Optional(Type.Array(Type.String(), { description: "Workflow names filter" })),
+}, { additionalProperties: true });
+export const JobSchema = Type.Object({
+    name: Type.Optional(Type.String({ description: "Optional job name" })),
+    if: Type.Optional(Type.String({
+        description: "Condition expression (e.g. \"conclusion == 'failure'\")",
+    })),
+    prompt: Type.String({ description: "Template string sent to Pi Agent" }),
+    deliverAs: Type.Optional(Type.Union([Type.Literal("steer"), Type.Literal("followUp")], {
+        description: "Delivery urgency: steer interrupts turn, followUp queues next",
+        default: "followUp",
+    })),
+}, { additionalProperties: false });
+export const WorkflowSchema = Type.Object({
+    $schema: Type.Optional(Type.String()),
+    name: Type.Optional(Type.String({ description: "Workflow display name" })),
+    repo: Type.Optional(Type.String({
+        default: "auto",
+        description: "Target GitHub repo (owner/repo or 'auto')",
+    })),
+    secret: Type.Optional(Type.String({ description: "Optional Webhook HMAC secret" })),
+    on: Type.Union([
+        Type.String(),
+        Type.Array(Type.String()),
+        Type.Record(Type.String(), Type.Union([Type.Null(), EventTriggerSchema])),
+    ], { description: "GitHub event triggers specification" }),
+    jobs: Type.Record(Type.String(), JobSchema, { description: "Jobs map" }),
+}, { additionalProperties: false });
+//# sourceMappingURL=schema.js.map

package/dist/types/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAC3C;IACE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC,CACnE;IACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;QACxB,WAAW,EAAE,+CAA+C;KAC7D,CAAC,CACH;IACD,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC,CACpE;CACF,EACD,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAC/B,CAAC;AAIF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAClC;IACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC;IACtE,EAAE,EAAE,IAAI,CAAC,QAAQ,CACf,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,yDAAyD;KACvE,CAAC,CACH;IACD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;IACxE,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE;QAC5D,WAAW,EACT,+DAA+D;QACjE,OAAO,EAAE,UAAU;KACpB,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CACvC;IACE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACrC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC1E,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC;QACV,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,2CAA2C;KACzD,CAAC,CACH;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC,CAC7D;IACD,EAAE,EAAE,IAAI,CAAC,KAAK,CACZ;QACE,IAAI,CAAC,MAAM,EAAE;QACb,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CACT,IAAI,CAAC,MAAM,EAAE,EACb,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAC9C;KACF,EACD,EAAE,WAAW,EAAE,qCAAqC,EAAE,CACvD;IACD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;CACzE,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "pi-ghwebhook",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Universal GitHub Webhook event bus and wake-up engine for Pi coding agent",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-coding-agent",
+    "pi-extension",
+    "extension",
+    "github",
+    "webhook",
+    "event-bus",
+    "automation"
+  ],
+  "homepage": "https://github.com/xifan2333/pi-ghwebhook#readme",
+  "bugs": {
+    "url": "https://github.com/xifan2333/pi-ghwebhook/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xifan2333/pi-ghwebhook.git"
+  },
+  "license": "MIT",
+  "author": "xifan",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "skills",
+    "schemas",
+    "README.md",
+    "README_zh.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "check": "mise run check",
+    "prepublishOnly": "npm run check && npm test",
+    "test": "mise run test"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^1.5.0",
+    "@octokit/openapi-webhooks-types": "^12.2.0",
+    "@types/node": "^22.13.0",
+    "typebox": "^1.3.27",
+    "typescript": "^5.8.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  }
+}

package/schemas/ghwebhook.schema.json

@@ -0,0 +1,225 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/xifan2333/pi-ghwebhook/main/schemas/ghwebhook.schema.json",
+  "title": "Pi GitHub Webhook Workflow Configuration",
+  "description": "GitHub Actions Workflow-compatible event automation configuration for Pi coding agent",
+  "type": "object",
+  "required": ["on", "jobs"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "URL of the JSON schema for validation and autocompletion"
+    },
+    "name": {
+      "type": "string",
+      "description": "Optional display name for this event automation workflow"
+    },
+    "repo": {
+      "type": "string",
+      "default": "auto",
+      "description": "Target GitHub repository in 'owner/repo' format, or 'auto' to detect from git remote"
+    },
+    "secret": {
+      "type": "string",
+      "description": "Optional Webhook HMAC SHA-256 verification secret"
+    },
+    "on": {
+      "description": "GitHub event triggers, matching GitHub Actions 'on' specification",
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Single GitHub event name, e.g. 'push' or 'workflow_run'"
+        },
+        {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of GitHub event names, e.g. ['push', 'pull_request']"
+        },
+        {
+          "type": "object",
+          "description": "Map of event names to their trigger filtering criteria",
+          "properties": {
+            "workflow_run": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["completed", "requested", "in_progress"]
+                  },
+                  "description": "Activity types that trigger the workflow"
+                },
+                "branches": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "description": "Branches to filter on (supports '@current' and globs like 'main', 'feat/*')"
+                },
+                "workflows": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "description": "Workflow names to filter on (e.g. ['CI'])"
+                }
+              },
+              "additionalProperties": false
+            },
+            "pull_request": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "opened",
+                      "edited",
+                      "closed",
+                      "reopened",
+                      "synchronize",
+                      "ready_for_review"
+                    ]
+                  }
+                },
+                "branches": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              },
+              "additionalProperties": false
+            },
+            "pull_request_review": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["submitted", "edited", "dismissed"]
+                  }
+                },
+                "branches": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              },
+              "additionalProperties": false
+            },
+            "pull_request_review_comment": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["created", "edited", "deleted"]
+                  }
+                }
+              },
+              "additionalProperties": false
+            },
+            "check_suite": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["completed", "requested", "rerequested"]
+                  }
+                },
+                "branches": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              },
+              "additionalProperties": false
+            },
+            "issues": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "opened",
+                      "edited",
+                      "deleted",
+                      "closed",
+                      "reopened",
+                      "assigned",
+                      "labeled"
+                    ]
+                  }
+                }
+              },
+              "additionalProperties": false
+            },
+            "issue_comment": {
+              "type": "object",
+              "properties": {
+                "types": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["created", "edited", "deleted"]
+                  }
+                }
+              },
+              "additionalProperties": false
+            },
+            "push": {
+              "type": "object",
+              "properties": {
+                "branches": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "types": { "type": "array", "items": { "type": "string" } },
+              "branches": { "type": "array", "items": { "type": "string" } },
+              "workflows": { "type": "array", "items": { "type": "string" } }
+            },
+            "additionalProperties": true
+          }
+        }
+      ]
+    },
+    "jobs": {
+      "type": "object",
+      "description": "Map of jobs to execute when matching events arrive",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["prompt"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Optional job title"
+          },
+          "if": {
+            "type": "string",
+            "description": "Conditional expression, e.g. \"github.event.workflow_run.conclusion == 'failure'\""
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Prompt template sent to Pi Agent, supporting {{ branch }}, {{ run_url }}, etc."
+          },
+          "deliverAs": {
+            "type": "string",
+            "enum": ["followUp", "steer"],
+            "default": "followUp",
+            "description": "Pi message delivery mode: 'followUp' (wait for agent to finish) or 'steer' (interrupt turn)"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}