oh-my-claude-sisyphus 3.7.6 → 3.7.9

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

@@ -0,0 +1,140 @@
+/**
+ * GitHub Auto-Responder - Public API Entry Point
+ *
+ * This module provides a high-level API for creating and managing
+ * GitHub webhook auto-responders powered by Claude.
+ *
+ * @example Quick Start
+ * ```typescript
+ * import { startGitHubAutoResponder } from '@/hooks/github-auto-responder';
+ *
+ * // Start with environment variables
+ * const { server, responder, config, stop } = await startGitHubAutoResponder();
+ *
+ * // Or with config overrides
+ * const instance = await startGitHubAutoResponder({
+ *   mode: 'auto',
+ *   port: 3001,
+ * });
+ *
+ * // Later...
+ * await instance.stop();
+ * ```
+ *
+ * @example Manual Setup
+ * ```typescript
+ * import { createGitHubAutoResponder } from '@/hooks/github-auto-responder';
+ *
+ * const { server, responder, config } = createGitHubAutoResponder({
+ *   webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
+ *   githubToken: process.env.GITHUB_TOKEN!,
+ *   anthropicApiKey: process.env.ANTHROPIC_API_KEY!,
+ *   selfLogin: 'my-bot',
+ * });
+ *
+ * await responder.init();
+ * await server.start();
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+import type { AutoResponderConfig, PersonaConfig, ResponseCategory, ResponseMode, WebhookPayload, WebhookHeaders, GitHubUser, GitHubLabel, GitHubRepository, GitHubIssue, GitHubPullRequest, GitHubIssuePayload, GitHubPRPayload, FilterResult, WebhookFilter, IdempotencyRecord, LLMResponse, CommentResult } from './types.js';
+import { loadConfig, loadConfigFromEnv } from './config.js';
+import { DEFAULT_PERSONA, DEFAULT_SKIP_LABELS, DEFAULT_SPAM_PATTERNS, DEFAULT_PORT, DEFAULT_LLM_MODEL, DEFAULT_MAX_RESPONSE_TOKENS, GITHUB_API_BASE, ANTHROPIC_API_URL, RESPONSE_TIMEOUT_MS, IDEMPOTENCY_TTL_MS } from './constants.js';
+import { AutoResponder, createAutoResponder } from './responder.js';
+import type { ResponderResult } from './responder.js';
+import { WebhookServer, createWebhookServer, registerShutdownHandlers } from './server.js';
+export type { AutoResponderConfig, PersonaConfig, ResponseCategory, ResponseMode, WebhookPayload, WebhookHeaders, GitHubUser, GitHubLabel, GitHubRepository, GitHubIssue, GitHubPullRequest, GitHubIssuePayload, GitHubPRPayload, FilterResult, WebhookFilter, IdempotencyRecord, LLMResponse, CommentResult, ResponderResult, };
+export { loadConfig, loadConfigFromEnv };
+export { DEFAULT_PERSONA, DEFAULT_SKIP_LABELS, DEFAULT_SPAM_PATTERNS, DEFAULT_PORT, DEFAULT_LLM_MODEL, DEFAULT_MAX_RESPONSE_TOKENS, GITHUB_API_BASE, ANTHROPIC_API_URL, RESPONSE_TIMEOUT_MS, IDEMPOTENCY_TTL_MS, };
+export { AutoResponder, createAutoResponder };
+export { WebhookServer, createWebhookServer, registerShutdownHandlers };
+/**
+ * Result of creating a GitHub auto-responder instance.
+ */
+export interface GitHubAutoResponderInstance {
+    /** Auto-responder for webhook processing */
+    responder: AutoResponder;
+    /** HTTP webhook server */
+    server: WebhookServer;
+    /** Resolved configuration */
+    config: AutoResponderConfig;
+}
+/**
+ * Result of starting a GitHub auto-responder (includes stop function).
+ */
+export interface StartedGitHubAutoResponder extends GitHubAutoResponderInstance {
+    /** Stop the server and close the responder */
+    stop: () => Promise<void>;
+}
+/**
+ * Create a GitHub auto-responder instance (server + responder).
+ *
+ * This factory function creates both the webhook server and the auto-responder,
+ * but does NOT initialize or start them. You must call:
+ * 1. `responder.init()` to initialize the idempotency store
+ * 2. `server.start()` to begin listening for webhooks
+ *
+ * Use {@link startGitHubAutoResponder} if you want a fully initialized and
+ * running instance in a single call.
+ *
+ * @param configOverrides - Partial configuration to override defaults/env vars
+ * @returns Auto-responder instance with server, responder, and resolved config
+ *
+ * @example
+ * ```typescript
+ * const { server, responder, config } = createGitHubAutoResponder({
+ *   mode: 'draft', // Draft mode: log responses without posting
+ *   port: 3001,
+ * });
+ *
+ * await responder.init();
+ * await server.start();
+ *
+ * console.log(`Webhook server running on port ${config.port}`);
+ * ```
+ */
+export declare function createGitHubAutoResponder(configOverrides?: Partial<AutoResponderConfig>): GitHubAutoResponderInstance;
+/**
+ * Create and start a fully initialized GitHub auto-responder.
+ *
+ * This is the recommended high-level API for most use cases. It:
+ * 1. Loads configuration from environment + overrides
+ * 2. Creates the auto-responder and webhook server
+ * 3. Initializes the responder (idempotency store)
+ * 4. Starts the HTTP server
+ * 5. Returns a handle with a convenient `stop()` function
+ *
+ * @param configOverrides - Partial configuration to override defaults/env vars
+ * @returns Started instance with server, responder, config, and stop function
+ *
+ * @example
+ * ```typescript
+ * // Start in auto mode (post comments automatically)
+ * const instance = await startGitHubAutoResponder({ mode: 'auto' });
+ *
+ * console.log(`Listening on port ${instance.config.port}`);
+ *
+ * // Later: gracefully shut down
+ * await instance.stop();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Start in draft mode (log responses without posting)
+ * const instance = await startGitHubAutoResponder({
+ *   mode: 'draft',
+ *   port: 3001,
+ *   persona: {
+ *     tone: 'friendly',
+ *     technicalDepth: 'intermediate',
+ *     language: 'en',
+ *     signatureEmoji: '🤖',
+ *     maintainerName: 'Bot Master',
+ *   },
+ * });
+ * ```
+ */
+export declare function startGitHubAutoResponder(configOverrides?: Partial<AutoResponderConfig>): Promise<StartedGitHubAutoResponder>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,eAAe,GAChB,CAAC;AAGF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAGzC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,CAAC;AAGF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4CAA4C;IAC5C,SAAS,EAAE,aAAa,CAAC;IACzB,0BAA0B;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,6BAA6B;IAC7B,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,2BAA2B;IAC7E,8CAA8C;IAC9C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAC7C,2BAA2B,CAW7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,wBAAwB,CAC5C,eAAe,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAC7C,OAAO,CAAC,0BAA0B,CAAC,CAkBrC"}

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

@@ -0,0 +1,145 @@
+/**
+ * GitHub Auto-Responder - Public API Entry Point
+ *
+ * This module provides a high-level API for creating and managing
+ * GitHub webhook auto-responders powered by Claude.
+ *
+ * @example Quick Start
+ * ```typescript
+ * import { startGitHubAutoResponder } from '@/hooks/github-auto-responder';
+ *
+ * // Start with environment variables
+ * const { server, responder, config, stop } = await startGitHubAutoResponder();
+ *
+ * // Or with config overrides
+ * const instance = await startGitHubAutoResponder({
+ *   mode: 'auto',
+ *   port: 3001,
+ * });
+ *
+ * // Later...
+ * await instance.stop();
+ * ```
+ *
+ * @example Manual Setup
+ * ```typescript
+ * import { createGitHubAutoResponder } from '@/hooks/github-auto-responder';
+ *
+ * const { server, responder, config } = createGitHubAutoResponder({
+ *   webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
+ *   githubToken: process.env.GITHUB_TOKEN!,
+ *   anthropicApiKey: process.env.ANTHROPIC_API_KEY!,
+ *   selfLogin: 'my-bot',
+ * });
+ *
+ * await responder.init();
+ * await server.start();
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+import { loadConfig, loadConfigFromEnv } from './config.js';
+import { DEFAULT_PERSONA, DEFAULT_SKIP_LABELS, DEFAULT_SPAM_PATTERNS, DEFAULT_PORT, DEFAULT_LLM_MODEL, DEFAULT_MAX_RESPONSE_TOKENS, GITHUB_API_BASE, ANTHROPIC_API_URL, RESPONSE_TIMEOUT_MS, IDEMPOTENCY_TTL_MS, } from './constants.js';
+import { AutoResponder, createAutoResponder } from './responder.js';
+import { WebhookServer, createWebhookServer, registerShutdownHandlers, } from './server.js';
+// Re-export config utilities
+export { loadConfig, loadConfigFromEnv };
+// Re-export constants
+export { DEFAULT_PERSONA, DEFAULT_SKIP_LABELS, DEFAULT_SPAM_PATTERNS, DEFAULT_PORT, DEFAULT_LLM_MODEL, DEFAULT_MAX_RESPONSE_TOKENS, GITHUB_API_BASE, ANTHROPIC_API_URL, RESPONSE_TIMEOUT_MS, IDEMPOTENCY_TTL_MS, };
+// Re-export core classes and factories
+export { AutoResponder, createAutoResponder };
+export { WebhookServer, createWebhookServer, registerShutdownHandlers };
+/**
+ * Create a GitHub auto-responder instance (server + responder).
+ *
+ * This factory function creates both the webhook server and the auto-responder,
+ * but does NOT initialize or start them. You must call:
+ * 1. `responder.init()` to initialize the idempotency store
+ * 2. `server.start()` to begin listening for webhooks
+ *
+ * Use {@link startGitHubAutoResponder} if you want a fully initialized and
+ * running instance in a single call.
+ *
+ * @param configOverrides - Partial configuration to override defaults/env vars
+ * @returns Auto-responder instance with server, responder, and resolved config
+ *
+ * @example
+ * ```typescript
+ * const { server, responder, config } = createGitHubAutoResponder({
+ *   mode: 'draft', // Draft mode: log responses without posting
+ *   port: 3001,
+ * });
+ *
+ * await responder.init();
+ * await server.start();
+ *
+ * console.log(`Webhook server running on port ${config.port}`);
+ * ```
+ */
+export function createGitHubAutoResponder(configOverrides) {
+    // Load config from environment + overrides
+    const config = loadConfig(configOverrides);
+    // Create responder
+    const responder = createAutoResponder(config);
+    // Create webhook server
+    const server = createWebhookServer(responder, config);
+    return { responder, server, config };
+}
+/**
+ * Create and start a fully initialized GitHub auto-responder.
+ *
+ * This is the recommended high-level API for most use cases. It:
+ * 1. Loads configuration from environment + overrides
+ * 2. Creates the auto-responder and webhook server
+ * 3. Initializes the responder (idempotency store)
+ * 4. Starts the HTTP server
+ * 5. Returns a handle with a convenient `stop()` function
+ *
+ * @param configOverrides - Partial configuration to override defaults/env vars
+ * @returns Started instance with server, responder, config, and stop function
+ *
+ * @example
+ * ```typescript
+ * // Start in auto mode (post comments automatically)
+ * const instance = await startGitHubAutoResponder({ mode: 'auto' });
+ *
+ * console.log(`Listening on port ${instance.config.port}`);
+ *
+ * // Later: gracefully shut down
+ * await instance.stop();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Start in draft mode (log responses without posting)
+ * const instance = await startGitHubAutoResponder({
+ *   mode: 'draft',
+ *   port: 3001,
+ *   persona: {
+ *     tone: 'friendly',
+ *     technicalDepth: 'intermediate',
+ *     language: 'en',
+ *     signatureEmoji: '🤖',
+ *     maintainerName: 'Bot Master',
+ *   },
+ * });
+ * ```
+ */
+export async function startGitHubAutoResponder(configOverrides) {
+    const { responder, server, config } = createGitHubAutoResponder(configOverrides);
+    // Initialize responder (idempotency store)
+    await responder.init();
+    // Start HTTP server
+    await server.start();
+    // Return handle with convenient stop function
+    return {
+        responder,
+        server,
+        config,
+        stop: async () => {
+            await server.stop();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAwBH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAyBrB,6BAA6B;AAC7B,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAEzC,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,CAAC;AAEF,uCAAuC;AACvC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAC;AAsBxE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,yBAAyB,CACvC,eAA8C;IAE9C,2CAA2C;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAE3C,mBAAmB;IACnB,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE9C,wBAAwB;IACxB,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,eAA8C;IAE9C,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,yBAAyB,CAAC,eAAe,CAAC,CAAC;IAEjF,2CAA2C;IAC3C,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;IAEvB,oBAAoB;IACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,8CAA8C;IAC9C,OAAO;QACL,SAAS;QACT,MAAM;QACN,MAAM;QACN,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * GitHub Auto Responder - Persona & Prompt Building
+ *
+ * Constructs LLM prompts that encode maintainer persona and response guidelines.
+ */
+import type { ResponseCategory, PersonaConfig, WebhookPayload } from './types.js';
+/**
+ * Context for LLM prompt generation
+ */
+export interface PromptContext {
+    /** System prompt defining persona and guidelines */
+    system: string;
+    /** User prompt with issue/PR context */
+    user: string;
+}
+/**
+ * Builds the system prompt encoding maintainer persona and response guidelines.
+ *
+ * @param persona - Persona configuration
+ * @returns System prompt string
+ */
+export declare function buildSystemPrompt(persona: PersonaConfig): string;
+/**
+ * Builds the user prompt with issue/PR context.
+ *
+ * @param category - Classified response category
+ * @param payload - GitHub webhook payload
+ * @returns User prompt string
+ */
+export declare function buildUserPrompt(category: ResponseCategory, payload: WebhookPayload): string;
+/**
+ * Builds complete prompt context (system + user prompts).
+ *
+ * @param persona - Persona configuration
+ * @param category - Response category
+ * @param payload - GitHub webhook payload
+ * @returns Complete prompt context
+ */
+export declare function buildPrompt(persona: PersonaConfig, category: ResponseCategory, payload: WebhookPayload): PromptContext;
+//# sourceMappingURL=persona.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/persona.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA4ChE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,cAAc,GACtB,MAAM,CA8BR;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,cAAc,GACtB,aAAa,CAKf"}

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

@@ -0,0 +1,99 @@
+/**
+ * GitHub Auto Responder - Persona & Prompt Building
+ *
+ * Constructs LLM prompts that encode maintainer persona and response guidelines.
+ */
+/**
+ * Builds the system prompt encoding maintainer persona and response guidelines.
+ *
+ * @param persona - Persona configuration
+ * @returns System prompt string
+ */
+export function buildSystemPrompt(persona) {
+    const toneDescriptions = {
+        formal: 'professional and formal',
+        friendly: 'warm and approachable',
+        technical: 'direct and technical',
+        casual: 'relaxed and conversational',
+        direct: 'straightforward and to the point',
+    };
+    const depthDescriptions = {
+        beginner: 'accessible to beginners with clear explanations',
+        intermediate: 'assuming some technical knowledge',
+        expert: 'technical and detailed for experienced developers',
+        high: 'highly technical with advanced details',
+    };
+    const languageInstructions = {
+        en: 'Respond in English only.',
+        'ko-mix': 'You may use a mix of Korean and English. Use Korean for friendliness and English for technical terms.',
+    };
+    return `You are responding on behalf of ${persona.maintainerName}, maintainer of oh-my-claudecode, a multi-agent orchestration system for Claude Code.
+
+**Tone & Style:**
+- Be ${toneDescriptions[persona.tone]}
+- Make responses ${depthDescriptions[persona.technicalDepth]}
+- ${languageInstructions[persona.language]}
+- Use the emoji ${persona.signatureEmoji} once at the start of your response
+- Keep responses concise: 150-200 words maximum
+
+**Response Guidelines:**
+- Be friendly but professional
+- Acknowledge the contribution or concern
+- Ask clarifying questions if information is missing
+- For bug reports: request reproduction steps, environment details, logs
+- For feature requests: ask about use cases, priority, alternatives considered
+- For pull requests: note what you'll look for in review (tests, docs, breaking changes)
+- For questions: point to documentation first if available, then provide guidance
+
+**Important:**
+- Never commit to timelines or features without verification
+- Be honest about limitations or current project status
+- Thank contributors for their time and effort`;
+}
+/**
+ * Builds the user prompt with issue/PR context.
+ *
+ * @param category - Classified response category
+ * @param payload - GitHub webhook payload
+ * @returns User prompt string
+ */
+export function buildUserPrompt(category, payload) {
+    const isIssue = 'issue' in payload;
+    const item = isIssue
+        ? payload.issue
+        : payload.pull_request;
+    const eventType = isIssue ? 'Issue' : 'Pull Request';
+    const title = item.title;
+    const body = item.body || 'No description provided';
+    const labels = item.labels.map((l) => l.name).join(', ') || 'None';
+    const author = item.user.login;
+    let contextParts = [
+        `**Event Type:** ${eventType}`,
+        `**Category:** ${category}`,
+        `**Title:** ${title}`,
+        `**Body:**\n${body}`,
+        `**Labels:** ${labels}`,
+        `**Author:** @${author}`,
+    ];
+    // Add PR-specific context
+    if (!isIssue) {
+        const pr = item;
+        contextParts.push(`**Changes:** +${pr.additions}/-${pr.deletions} in ${pr.changed_files} file(s)`);
+    }
+    return contextParts.join('\n\n');
+}
+/**
+ * Builds complete prompt context (system + user prompts).
+ *
+ * @param persona - Persona configuration
+ * @param category - Response category
+ * @param payload - GitHub webhook payload
+ * @returns Complete prompt context
+ */
+export function buildPrompt(persona, category, payload) {
+    return {
+        system: buildSystemPrompt(persona),
+        user: buildUserPrompt(category, payload),
+    };
+}
+//# sourceMappingURL=persona.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/persona.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,MAAM,gBAAgB,GAAG;QACvB,MAAM,EAAE,yBAAyB;QACjC,QAAQ,EAAE,uBAAuB;QACjC,SAAS,EAAE,sBAAsB;QACjC,MAAM,EAAE,4BAA4B;QACpC,MAAM,EAAE,kCAAkC;KAC3C,CAAC;IAEF,MAAM,iBAAiB,GAAG;QACxB,QAAQ,EAAE,iDAAiD;QAC3D,YAAY,EAAE,mCAAmC;QACjD,MAAM,EAAE,mDAAmD;QAC3D,IAAI,EAAE,wCAAwC;KAC/C,CAAC;IAEF,MAAM,oBAAoB,GAAG;QAC3B,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EACN,uGAAuG;KAC1G,CAAC;IAEF,OAAO,mCAAmC,OAAO,CAAC,cAAc;;;OAG3D,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;mBAClB,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC;IACxD,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC;kBACxB,OAAO,CAAC,cAAc;;;;;;;;;;;;;;;+CAeO,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA0B,EAC1B,OAAuB;IAEvB,MAAM,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO;QAClB,CAAC,CAAE,OAA8B,CAAC,KAAK;QACvC,CAAC,CAAE,OAA2B,CAAC,YAAY,CAAC;IAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,yBAAyB,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IAE/B,IAAI,YAAY,GAAG;QACjB,mBAAmB,SAAS,EAAE;QAC9B,iBAAiB,QAAQ,EAAE;QAC3B,cAAc,KAAK,EAAE;QACrB,cAAc,IAAI,EAAE;QACpB,eAAe,MAAM,EAAE;QACvB,gBAAgB,MAAM,EAAE;KACzB,CAAC;IAEF,0BAA0B;IAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,IAAuC,CAAC;QACnD,YAAY,CAAC,IAAI,CACf,iBAAiB,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC,aAAa,UAAU,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,OAAsB,EACtB,QAA0B,EAC1B,OAAuB;IAEvB,OAAO;QACL,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAClC,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC"}

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"}