oh-my-claude-sisyphus 3.7.6 → 3.7.8

package/dist/hooks/github-auto-responder/responder.d.ts

@@ -0,0 +1,122 @@
+/**
+ * GitHub Auto Responder - Main Orchestrator
+ *
+ * Core pipeline that ties together filtering, classification, prompt building,
+ * LLM generation, template fallbacks, and GitHub comment posting.
+ *
+ * Processing pipeline:
+ * 1. Idempotency check (skip duplicates)
+ * 2. Filter pipeline (bot, self, action, label, spam)
+ * 3. Classify event (bug, feature, question, pr)
+ * 4. Build persona-driven prompts
+ * 5. Generate response via Anthropic API (with template fallback)
+ * 6. Post comment to GitHub (auto mode) or log (draft mode)
+ * 7. Mark as processed for deduplication
+ */
+import type { AutoResponderConfig, ResponseCategory, WebhookPayload } from './types.js';
+/**
+ * Result of processing a single webhook delivery
+ */
+export interface ResponderResult {
+    /** Whether the webhook was fully processed */
+    processed: boolean;
+    /** Whether processing was skipped */
+    skipped: boolean;
+    /** Reason for skipping (if skipped) */
+    skipReason?: string;
+    /** Classified response category */
+    category?: ResponseCategory;
+    /** Whether a response was posted to GitHub */
+    responsePosted?: boolean;
+    /** URL of the posted comment */
+    responseUrl?: string;
+    /** Error message if processing failed */
+    error?: string;
+    /** Whether the fallback template was used instead of LLM */
+    usedFallback?: boolean;
+}
+/**
+ * Main auto-responder orchestrator.
+ *
+ * Manages the full lifecycle of webhook processing: initialization,
+ * filtering, classification, response generation, and posting.
+ *
+ * @example
+ * ```typescript
+ * const responder = createAutoResponder(config);
+ * await responder.init();
+ *
+ * const result = await responder.processWebhook(deliveryId, payload);
+ * if (result.processed) {
+ *   console.log('Response posted:', result.responseUrl);
+ * }
+ *
+ * await responder.close();
+ * ```
+ */
+export declare class AutoResponder {
+    private readonly config;
+    /** Idempotency store for deduplication */
+    private idempotencyStore;
+    /** GitHub API client */
+    private githubClient;
+    /** Filter pipeline function */
+    private filterPipeline;
+    /** Whether the responder has been initialized */
+    private initialized;
+    /**
+     * Create a new AutoResponder instance.
+     *
+     * @param config - Full auto-responder configuration
+     */
+    constructor(config: AutoResponderConfig);
+    /**
+     * Initialize the responder (must be called before processing webhooks).
+     *
+     * Sets up the idempotency store database connection and schema.
+     * Safe to call multiple times (no-op after first initialization).
+     */
+    init(): Promise<void>;
+    /**
+     * Process a single GitHub webhook delivery through the full pipeline.
+     *
+     * Pipeline stages:
+     * 1. **Idempotency** - Skip if delivery ID already processed
+     * 2. **Filter** - Skip bots, self, non-opened actions, excluded labels, spam
+     * 3. **Classify** - Determine response category (bug/feature/question/pr)
+     * 4. **Prompt** - Build persona-driven system and user prompts
+     * 5. **Generate** - Call Anthropic API (fall back to template on failure)
+     * 6. **Post** - Post comment to GitHub (auto mode) or log (draft mode)
+     * 7. **Record** - Mark delivery ID as processed
+     *
+     * @param deliveryId - GitHub webhook delivery ID (for idempotency)
+     * @param payload - Parsed webhook payload
+     * @returns Processing result with status, category, and response details
+     */
+    processWebhook(deliveryId: string, payload: WebhookPayload): Promise<ResponderResult>;
+    /**
+     * Gracefully shut down the responder.
+     *
+     * Closes the idempotency store database connection. Safe to call
+     * multiple times. Should be called when the server shuts down.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Factory function to create a new AutoResponder instance.
+ *
+ * @param config - Full auto-responder configuration
+ * @returns New AutoResponder instance (call init() before use)
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from './config.js';
+ * import { createAutoResponder } from './responder.js';
+ *
+ * const config = loadConfig();
+ * const responder = createAutoResponder(config);
+ * await responder.init();
+ * ```
+ */
+export declare function createAutoResponder(config: AutoResponderConfig): AutoResponder;
+//# sourceMappingURL=responder.d.ts.map

package/dist/hooks/github-auto-responder/responder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder.d.ts","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/responder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EAEf,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IAeZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdnC,0CAA0C;IAC1C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,wBAAwB;IACxB,OAAO,CAAC,YAAY,CAAe;IACnC,+BAA+B;IAC/B,OAAO,CAAC,cAAc,CAA0C;IAChE,iDAAiD;IACjD,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBAC0B,MAAM,EAAE,mBAAmB;IAcxD;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAiH3B;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAEf"}

package/dist/hooks/github-auto-responder/responder.js

@@ -0,0 +1,264 @@
+/**
+ * GitHub Auto Responder - Main Orchestrator
+ *
+ * Core pipeline that ties together filtering, classification, prompt building,
+ * LLM generation, template fallbacks, and GitHub comment posting.
+ *
+ * Processing pipeline:
+ * 1. Idempotency check (skip duplicates)
+ * 2. Filter pipeline (bot, self, action, label, spam)
+ * 3. Classify event (bug, feature, question, pr)
+ * 4. Build persona-driven prompts
+ * 5. Generate response via Anthropic API (with template fallback)
+ * 6. Post comment to GitHub (auto mode) or log (draft mode)
+ * 7. Mark as processed for deduplication
+ */
+import { ANTHROPIC_API_URL, RESPONSE_TIMEOUT_MS } from './constants.js';
+import { createFilterPipeline } from './filters.js';
+import { classify } from './classifier.js';
+import { buildPrompt } from './persona.js';
+import { getTemplate } from './templates.js';
+import { GitHubClient } from './github-client.js';
+import { IdempotencyStore } from './idempotency.js';
+import { isIssuePayload } from './filters.js';
+/**
+ * Call the Anthropic Messages API to generate a response.
+ *
+ * Uses native fetch with an AbortController timeout. Returns null on any
+ * failure so the caller can fall back to a static template.
+ *
+ * @param config - Auto responder configuration (API key, model, max tokens)
+ * @param systemPrompt - System prompt encoding persona and guidelines
+ * @param userPrompt - User prompt with issue/PR context
+ * @returns Generated response text, or null if the API call fails
+ */
+async function callAnthropicAPI(config, systemPrompt, userPrompt) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), RESPONSE_TIMEOUT_MS);
+    try {
+        const response = await fetch(ANTHROPIC_API_URL, {
+            method: 'POST',
+            headers: {
+                'x-api-key': config.anthropicApiKey,
+                'anthropic-version': '2023-06-01',
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: config.llmModel,
+                max_tokens: config.maxResponseTokens,
+                system: systemPrompt,
+                messages: [{ role: 'user', content: userPrompt }],
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            console.error(`[auto-responder] Anthropic API error (${response.status}): ${errorText}`);
+            return null;
+        }
+        const data = (await response.json());
+        const textBlock = data.content?.find((block) => block.type === 'text');
+        return textBlock?.text ?? null;
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            console.error(`[auto-responder] Anthropic API timed out after ${RESPONSE_TIMEOUT_MS}ms`);
+        }
+        else {
+            console.error('[auto-responder] Anthropic API call failed:', error);
+        }
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Main auto-responder orchestrator.
+ *
+ * Manages the full lifecycle of webhook processing: initialization,
+ * filtering, classification, response generation, and posting.
+ *
+ * @example
+ * ```typescript
+ * const responder = createAutoResponder(config);
+ * await responder.init();
+ *
+ * const result = await responder.processWebhook(deliveryId, payload);
+ * if (result.processed) {
+ *   console.log('Response posted:', result.responseUrl);
+ * }
+ *
+ * await responder.close();
+ * ```
+ */
+export class AutoResponder {
+    config;
+    /** Idempotency store for deduplication */
+    idempotencyStore;
+    /** GitHub API client */
+    githubClient;
+    /** Filter pipeline function */
+    filterPipeline;
+    /** Whether the responder has been initialized */
+    initialized = false;
+    /**
+     * Create a new AutoResponder instance.
+     *
+     * @param config - Full auto-responder configuration
+     */
+    constructor(config) {
+        this.config = config;
+        this.idempotencyStore = new IdempotencyStore(config.idempotencyDbPath);
+        this.githubClient = new GitHubClient(config.githubToken);
+        this.filterPipeline = createFilterPipeline(config.selfLogin, config.skipLabels, config.spamPatterns
+            ? config.spamPatterns.map((p) => typeof p === 'string' ? new RegExp(p, 'i') : p)
+            : undefined);
+    }
+    /**
+     * Initialize the responder (must be called before processing webhooks).
+     *
+     * Sets up the idempotency store database connection and schema.
+     * Safe to call multiple times (no-op after first initialization).
+     */
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        await this.idempotencyStore.init();
+        this.initialized = true;
+        console.log(`[auto-responder] Initialized (mode=${this.config.mode}, model=${this.config.llmModel})`);
+    }
+    /**
+     * Process a single GitHub webhook delivery through the full pipeline.
+     *
+     * Pipeline stages:
+     * 1. **Idempotency** - Skip if delivery ID already processed
+     * 2. **Filter** - Skip bots, self, non-opened actions, excluded labels, spam
+     * 3. **Classify** - Determine response category (bug/feature/question/pr)
+     * 4. **Prompt** - Build persona-driven system and user prompts
+     * 5. **Generate** - Call Anthropic API (fall back to template on failure)
+     * 6. **Post** - Post comment to GitHub (auto mode) or log (draft mode)
+     * 7. **Record** - Mark delivery ID as processed
+     *
+     * @param deliveryId - GitHub webhook delivery ID (for idempotency)
+     * @param payload - Parsed webhook payload
+     * @returns Processing result with status, category, and response details
+     */
+    async processWebhook(deliveryId, payload) {
+        if (!this.initialized) {
+            return {
+                processed: false,
+                skipped: false,
+                error: 'AutoResponder not initialized. Call init() first.',
+            };
+        }
+        // Step 1: Idempotency check
+        if (this.idempotencyStore.isProcessed(deliveryId)) {
+            return {
+                processed: false,
+                skipped: true,
+                skipReason: `Delivery ${deliveryId} already processed`,
+            };
+        }
+        // Step 2: Run filter pipeline
+        const filterResult = await this.filterPipeline(payload);
+        if (filterResult.skip) {
+            // Mark as processed even when skipped to avoid re-evaluation
+            this.idempotencyStore.markProcessed(deliveryId);
+            return {
+                processed: true,
+                skipped: true,
+                skipReason: filterResult.reason,
+            };
+        }
+        // Step 3: Classify the event
+        const classification = classify(payload);
+        const category = classification.category;
+        console.log(`[auto-responder] Classified as "${category}" (confidence=${classification.confidence.toFixed(2)}, reason="${classification.reason}")`);
+        // Step 4: Build prompts
+        const prompts = buildPrompt(this.config.persona, category, payload);
+        // Step 5: Try LLM generation, fall back to template
+        let responseText;
+        let usedFallback = false;
+        const llmResponse = await callAnthropicAPI(this.config, prompts.system, prompts.user);
+        if (llmResponse) {
+            responseText = llmResponse;
+        }
+        else {
+            responseText = getTemplate(category, this.config.persona);
+            usedFallback = true;
+            console.warn('[auto-responder] LLM generation failed, using fallback template');
+        }
+        // Step 6: Post comment or log in draft mode
+        let responsePosted = false;
+        let responseUrl;
+        let postError;
+        if (this.config.mode === 'auto') {
+            const repo = payload.repository.full_name;
+            const itemNumber = isIssuePayload(payload)
+                ? payload.issue.number
+                : payload.pull_request.number;
+            const commentResult = isIssuePayload(payload)
+                ? await this.githubClient.postIssueComment(repo, itemNumber, responseText)
+                : await this.githubClient.postPRComment(repo, itemNumber, responseText);
+            if (commentResult.success) {
+                responsePosted = true;
+                responseUrl = commentResult.url;
+                console.log(`[auto-responder] Posted comment: ${responseUrl}`);
+            }
+            else {
+                postError = commentResult.error;
+                console.error(`[auto-responder] Failed to post comment: ${postError}`);
+            }
+        }
+        else {
+            // Draft mode: log the response without posting
+            console.log(`[auto-responder] [DRAFT] Would post to ${payload.repository.full_name}:`);
+            console.log(`[auto-responder] [DRAFT] Category: ${category}`);
+            console.log(`[auto-responder] [DRAFT] Response (${usedFallback ? 'template' : 'LLM'}):\n${responseText}`);
+        }
+        // Step 7: Mark as processed
+        this.idempotencyStore.markProcessed(deliveryId);
+        return {
+            processed: true,
+            skipped: false,
+            category,
+            responsePosted,
+            responseUrl,
+            usedFallback,
+            error: postError,
+        };
+    }
+    /**
+     * Gracefully shut down the responder.
+     *
+     * Closes the idempotency store database connection. Safe to call
+     * multiple times. Should be called when the server shuts down.
+     */
+    async close() {
+        this.idempotencyStore.close();
+        this.initialized = false;
+        console.log('[auto-responder] Closed');
+    }
+}
+/**
+ * Factory function to create a new AutoResponder instance.
+ *
+ * @param config - Full auto-responder configuration
+ * @returns New AutoResponder instance (call init() before use)
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from './config.js';
+ * import { createAutoResponder } from './responder.js';
+ *
+ * const config = loadConfig();
+ * const responder = createAutoResponder(config);
+ * await responder.init();
+ * ```
+ */
+export function createAutoResponder(config) {
+    return new AutoResponder(config);
+}
+//# sourceMappingURL=responder.js.map

package/dist/hooks/github-auto-responder/responder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder.js","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/responder.ts"],"names":[],"mappings":"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"}

package/dist/hooks/github-auto-responder/server.d.ts

@@ -0,0 +1,140 @@
+/**
+ * GitHub Auto Responder - HTTP Webhook Server
+ *
+ * HTTP server that receives GitHub webhook events, verifies signatures,
+ * and delegates to the AutoResponder for processing.
+ *
+ * Features:
+ * - HMAC-SHA256 signature verification for security
+ * - 1MB body size limit to prevent memory exhaustion
+ * - Graceful shutdown on SIGTERM/SIGINT
+ * - Health check endpoint for monitoring
+ * - Fire-and-forget webhook processing (responds 200 immediately)
+ * - JSON responses for all endpoints
+ */
+import type { AutoResponder } from './responder.js';
+import type { AutoResponderConfig } from './types.js';
+/**
+ * HTTP webhook server for GitHub events.
+ *
+ * Endpoints:
+ * - GET /health - Health check (returns 200 with status)
+ * - POST /webhook - Webhook receiver (signature verification + processing)
+ * - Other routes - 404 Not Found
+ *
+ * Webhook processing is fire-and-forget: the server responds 200 immediately
+ * after signature verification, then processes asynchronously. Errors during
+ * processing are logged but don't affect the HTTP response.
+ *
+ * @example
+ * ```typescript
+ * const responder = createAutoResponder(config);
+ * await responder.init();
+ *
+ * const server = createWebhookServer(responder, config);
+ * await server.start();
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+export declare class WebhookServer {
+    private readonly responder;
+    private readonly config;
+    /** HTTP server instance */
+    private server;
+    /** Whether the server is currently running */
+    private running;
+    /**
+     * Create a new webhook server.
+     *
+     * @param responder - AutoResponder instance for webhook processing
+     * @param config - Server configuration (port, webhook secret, etc.)
+     */
+    constructor(responder: AutoResponder, config: AutoResponderConfig);
+    /**
+     * Start the HTTP server and listen on configured port.
+     *
+     * @throws Error if server is already running or fails to bind
+     */
+    start(): Promise<void>;
+    /**
+     * Route incoming requests to appropriate handlers.
+     *
+     * Routes:
+     * - GET /health → handleHealth()
+     * - POST /webhook → handleWebhook()
+     * - Other → 404
+     *
+     * @param req - HTTP request
+     * @param res - HTTP response
+     */
+    private handleRequest;
+    /**
+     * Handle health check requests.
+     *
+     * Returns 200 with JSON status payload.
+     *
+     * @param res - HTTP response
+     */
+    private handleHealth;
+    /**
+     * Handle webhook POST requests.
+     *
+     * Processing pipeline:
+     * 1. Read raw request body as Buffer
+     * 2. Verify HMAC-SHA256 signature
+     * 3. Parse JSON payload
+     * 4. Extract event type and delivery ID from headers
+     * 5. Respond 200 OK immediately
+     * 6. Process webhook asynchronously (fire-and-forget)
+     *
+     * Errors during validation return appropriate HTTP status codes.
+     * Errors during async processing are logged but don't affect the response.
+     *
+     * @param req - HTTP request
+     * @param res - HTTP response
+     */
+    private handleWebhook;
+    /**
+     * Gracefully shut down the server.
+     *
+     * Stops accepting new connections and waits for existing requests
+     * to complete. Also closes the AutoResponder.
+     *
+     * Safe to call multiple times.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Factory function to create a new webhook server.
+ *
+ * @param responder - AutoResponder instance for webhook processing
+ * @param config - Server configuration
+ * @returns New WebhookServer instance (call start() to begin listening)
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from './config.js';
+ * import { createAutoResponder } from './responder.js';
+ * import { createWebhookServer } from './server.js';
+ *
+ * const config = loadConfig();
+ * const responder = createAutoResponder(config);
+ * await responder.init();
+ *
+ * const server = createWebhookServer(responder, config);
+ * await server.start();
+ * ```
+ */
+export declare function createWebhookServer(responder: AutoResponder, config: AutoResponderConfig): WebhookServer;
+/**
+ * Register signal handlers for graceful shutdown.
+ *
+ * Listens for SIGTERM and SIGINT (Ctrl+C) and gracefully shuts down
+ * the server before exiting.
+ *
+ * @param server - Webhook server to shut down
+ */
+export declare function registerShutdownHandlers(server: WebhookServer): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/hooks/github-auto-responder/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,YAAY,CAAC;AAyCtE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,aAAa;IAatB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,2BAA2B;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;OAKG;gBAEgB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,mBAAmB;IAK9C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,aAAa;IAmBrB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;;;;;;;;;;;;;OAgBG;YACW,aAAa;IAkF3B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAEf;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAcpE"}