oh-my-claude-sisyphus 3.7.3 → 3.7.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../../src/hooks/github-auto-responder/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKpD;;;GAGG;AACH,qBAAa,gBAAgB;IAQf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,EAAE,CAAuC;IACjD,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;gBAC0B,MAAM,EAAE,MAAM;IAE3C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC3B;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQxC;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASvC;;;OAGG;IACH,OAAO,IAAI,MAAM;IASjB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;;OAGG;IACH,aAAa,IAAI,iBAAiB,EAAE;IAYpC;;;OAGG;IACH,cAAc,IAAI,MAAM;IAQxB;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAOnB"}

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

@@ -0,0 +1,147 @@
+/**
+ * Idempotency Store for GitHub Auto-Responder
+ *
+ * SQLite-based deduplication using GitHub delivery IDs.
+ * Prevents duplicate webhook processing with automatic cleanup of old records.
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { IDEMPOTENCY_TTL_MS } from './constants.js';
+/**
+ * SQLite-backed idempotency store for webhook deduplication.
+ * Uses GitHub delivery IDs to track processed events.
+ */
+export class IdempotencyStore {
+    dbPath;
+    db = null;
+    initialized = false;
+    /**
+     * Create a new idempotency store.
+     * @param dbPath - Path to SQLite database file
+     */
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+    }
+    /**
+     * Initialize the database connection and schema.
+     * Dynamically imports better-sqlite3 and creates tables.
+     */
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            // Dynamic import of better-sqlite3
+            const betterSqlite3 = await import('better-sqlite3');
+            const Database = betterSqlite3.default;
+            // Ensure database directory exists
+            const dbDir = dirname(this.dbPath);
+            if (!existsSync(dbDir)) {
+                mkdirSync(dbDir, { recursive: true });
+            }
+            // Create database connection
+            this.db = new Database(this.dbPath);
+            // Enable WAL mode for concurrent access
+            this.db.pragma('journal_mode = WAL');
+            // Create schema
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS processed_events (
+          delivery_id TEXT PRIMARY KEY,
+          created_at INTEGER NOT NULL
+        );
+
+        -- Index for efficient TTL cleanup
+        CREATE INDEX IF NOT EXISTS idx_created_at ON processed_events(created_at);
+      `);
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize idempotency store at ${this.dbPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Ensure database is initialized before use.
+     * @throws {Error} If database is not initialized
+     */
+    ensureDb() {
+        if (!this.db || !this.initialized) {
+            throw new Error('IdempotencyStore not initialized. Call init() first.');
+        }
+    }
+    /**
+     * Check if a delivery ID has already been processed.
+     * @param deliveryId - GitHub webhook delivery ID
+     * @returns True if already processed, false otherwise
+     */
+    isProcessed(deliveryId) {
+        this.ensureDb();
+        const stmt = this.db.prepare('SELECT 1 FROM processed_events WHERE delivery_id = ?');
+        const result = stmt.get(deliveryId);
+        return result !== undefined;
+    }
+    /**
+     * Mark a delivery ID as processed.
+     * @param deliveryId - GitHub webhook delivery ID
+     */
+    markProcessed(deliveryId) {
+        this.ensureDb();
+        const stmt = this.db.prepare('INSERT OR IGNORE INTO processed_events (delivery_id, created_at) VALUES (?, ?)');
+        stmt.run(deliveryId, Date.now());
+    }
+    /**
+     * Remove records older than the TTL.
+     * @returns Number of records deleted
+     */
+    cleanup() {
+        this.ensureDb();
+        const cutoff = Date.now() - IDEMPOTENCY_TTL_MS;
+        const stmt = this.db.prepare('DELETE FROM processed_events WHERE created_at < ?');
+        const result = stmt.run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Close the database connection.
+     * Safe to call multiple times.
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.initialized = false;
+        }
+    }
+    /**
+     * Get all processed records (for debugging/testing).
+     * @returns Array of idempotency records
+     */
+    getAllRecords() {
+        this.ensureDb();
+        const stmt = this.db.prepare('SELECT delivery_id, created_at FROM processed_events');
+        const rows = stmt.all();
+        return rows.map(row => ({
+            deliveryId: row.delivery_id,
+            createdAt: row.created_at,
+        }));
+    }
+    /**
+     * Get count of processed records.
+     * @returns Total number of records in store
+     */
+    getRecordCount() {
+        this.ensureDb();
+        const stmt = this.db.prepare('SELECT COUNT(*) as count FROM processed_events');
+        const result = stmt.get();
+        return result.count;
+    }
+    /**
+     * Clear all records (for testing/reset).
+     * @returns Number of records deleted
+     */
+    clearAll() {
+        this.ensureDb();
+        const stmt = this.db.prepare('DELETE FROM processed_events');
+        const result = stmt.run();
+        return result.changes;
+    }
+}
+//# sourceMappingURL=idempotency.js.map

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

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

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