@shepai/cli 1.154.0 → 1.155.0-pr482.ac79b36

package/dist/packages/core/src/infrastructure/di/container.js

@@ -29,6 +29,7 @@ import { DaemonPidService } from '../services/daemon/daemon-pid.service.js';
 import { DeploymentService } from '../services/deployment/deployment.service.js';
 import { AttachmentStorageService } from '../services/attachment-storage.service.js';
 import { GitHubRepositoryService } from '../services/external/github-repository.service.js';
+import { TelegramService } from '../services/telegram/telegram.service.js';
 import { AgentExecutorFactory } from '../services/agents/common/agent-executor-factory.service.js';
 import { AgentExecutorProvider } from '../services/agents/common/agent-executor-provider.service.js';
 import { StructuredAgentCallerService } from '../services/agents/common/structured-agent-caller.service.js';
@@ -43,6 +44,8 @@ import { DesktopNotifier } from '../services/notifications/desktop-notifier.js';
 import { NotificationService } from '../services/notifications/notification.service.js';
 import { getNotificationBus } from '../services/notifications/notification-bus.js';
 import { spawn } from 'node:child_process';
+// Telegram use cases
+import { ConfigureTelegramUseCase } from '../../application/use-cases/telegram/configure-telegram.use-case.js';
 // Use cases
 import { InitializeSettingsUseCase } from '../../application/use-cases/settings/initialize-settings.use-case.js';
 import { LoadSettingsUseCase } from '../../application/use-cases/settings/load-settings.use-case.js';
@@ -272,11 +275,15 @@ export async function initializeContainer() {
     container.register('DesktopNotifier', {
         useFactory: () => new DesktopNotifier(),
     });
+    container.register('ITelegramService', {
+        useFactory: () => new TelegramService(),
+    });
     container.register('INotificationService', {
         useFactory: (c) => {
             const bus = c.resolve('NotificationEventBus');
             const desktopNotif = c.resolve('DesktopNotifier');
-            return new NotificationService(bus, desktopNotif);
+            const telegramSvc = c.resolve('ITelegramService');
+            return new NotificationService(bus, desktopNotif, telegramSvc);
         },
     });
     // Register use cases (singletons for performance)
@@ -325,6 +332,7 @@ export async function initializeContainer() {
     container.registerSingleton(ArchiveFeatureUseCase);
     container.registerSingleton(UnarchiveFeatureUseCase);
     container.registerSingleton(UpgradeCliUseCase);
+    container.registerSingleton(ConfigureTelegramUseCase);
     container.registerSingleton(ConflictResolutionService);
     container.register('ConflictResolutionService', {
         useFactory: (c) => c.resolve(ConflictResolutionService),
@@ -449,6 +457,9 @@ export async function initializeContainer() {
     container.register('GetBranchSyncStatusUseCase', {
         useFactory: (c) => c.resolve(GetBranchSyncStatusUseCase),
     });
+    container.register('ConfigureTelegramUseCase', {
+        useFactory: (c) => c.resolve(ConfigureTelegramUseCase),
+    });
     // Register interactive session infrastructure
     container.register('IInteractiveSessionRepository', {
         useFactory: (c) => {

package/dist/packages/core/src/infrastructure/persistence/sqlite/mappers/settings.mapper.d.ts

@@ -79,6 +79,20 @@ export interface SettingsRow {
     interactive_agent_enabled: number;
     interactive_agent_auto_timeout_minutes: number;
     interactive_agent_max_concurrent_sessions: number;
+    telegram_enabled: number;
+    telegram_bot_token: string | null;
+    telegram_chat_id: string | null;
+    telegram_notify_agent_started: number;
+    telegram_notify_phase_completed: number;
+    telegram_notify_waiting_approval: number;
+    telegram_notify_agent_completed: number;
+    telegram_notify_agent_failed: number;
+    telegram_notify_pr_merged: number;
+    telegram_notify_pr_closed: number;
+    telegram_notify_pr_checks_passed: number;
+    telegram_notify_pr_checks_failed: number;
+    telegram_notify_pr_blocked: number;
+    telegram_notify_merge_review_ready: number;
 }
 /**
  * Maps Settings domain object to database row.

package/dist/packages/core/src/infrastructure/persistence/sqlite/mappers/settings.mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.mapper.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/mappers/settings.mapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"settings.mapper.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/mappers/settings.mapper.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/mappers/settings.mapper.js

@@ -101,6 +101,21 @@ export function toDatabase(settings) {
         interactive_agent_enabled: (settings.interactiveAgent?.enabled ?? true) ? 1 : 0,
         interactive_agent_auto_timeout_minutes: settings.interactiveAgent?.autoTimeoutMinutes ?? 15,
         interactive_agent_max_concurrent_sessions: settings.interactiveAgent?.maxConcurrentSessions ?? 3,
+        // TelegramConfig (boolean → 0/1, optional strings → null; defaults applied here)
+        telegram_enabled: (settings.telegram?.enabled ?? false) ? 1 : 0,
+        telegram_bot_token: settings.telegram?.botToken ?? null,
+        telegram_chat_id: settings.telegram?.chatId ?? null,
+        telegram_notify_agent_started: (settings.telegram?.notifyEvents?.agentStarted ?? false) ? 1 : 0,
+        telegram_notify_phase_completed: (settings.telegram?.notifyEvents?.phaseCompleted ?? false) ? 1 : 0,
+        telegram_notify_waiting_approval: (settings.telegram?.notifyEvents?.waitingApproval ?? true) ? 1 : 0,
+        telegram_notify_agent_completed: (settings.telegram?.notifyEvents?.agentCompleted ?? true) ? 1 : 0,
+        telegram_notify_agent_failed: (settings.telegram?.notifyEvents?.agentFailed ?? true) ? 1 : 0,
+        telegram_notify_pr_merged: (settings.telegram?.notifyEvents?.prMerged ?? true) ? 1 : 0,
+        telegram_notify_pr_closed: (settings.telegram?.notifyEvents?.prClosed ?? false) ? 1 : 0,
+        telegram_notify_pr_checks_passed: (settings.telegram?.notifyEvents?.prChecksPassed ?? false) ? 1 : 0,
+        telegram_notify_pr_checks_failed: (settings.telegram?.notifyEvents?.prChecksFailed ?? true) ? 1 : 0,
+        telegram_notify_pr_blocked: (settings.telegram?.notifyEvents?.prBlocked ?? true) ? 1 : 0,
+        telegram_notify_merge_review_ready: (settings.telegram?.notifyEvents?.mergeReviewReady ?? true) ? 1 : 0,
     };
 }
 /**
@@ -230,6 +245,25 @@ export function fromDatabase(row) {
             autoTimeoutMinutes: row.interactive_agent_auto_timeout_minutes ?? 15,
             maxConcurrentSessions: row.interactive_agent_max_concurrent_sessions ?? 3,
         },
+        // TelegramConfig (INTEGER 0/1 → boolean, TEXT → string | undefined)
+        telegram: {
+            enabled: (row.telegram_enabled ?? 0) !== 0,
+            ...(row.telegram_bot_token !== null && { botToken: row.telegram_bot_token }),
+            ...(row.telegram_chat_id !== null && { chatId: row.telegram_chat_id }),
+            notifyEvents: {
+                agentStarted: (row.telegram_notify_agent_started ?? 0) === 1,
+                phaseCompleted: (row.telegram_notify_phase_completed ?? 0) === 1,
+                waitingApproval: (row.telegram_notify_waiting_approval ?? 1) === 1,
+                agentCompleted: (row.telegram_notify_agent_completed ?? 1) === 1,
+                agentFailed: (row.telegram_notify_agent_failed ?? 1) === 1,
+                prMerged: (row.telegram_notify_pr_merged ?? 1) === 1,
+                prClosed: (row.telegram_notify_pr_closed ?? 0) === 1,
+                prChecksPassed: (row.telegram_notify_pr_checks_passed ?? 0) === 1,
+                prChecksFailed: (row.telegram_notify_pr_checks_failed ?? 1) === 1,
+                prBlocked: (row.telegram_notify_pr_blocked ?? 1) === 1,
+                mergeReviewReady: (row.telegram_notify_merge_review_ready ?? 1) === 1,
+            },
+        },
         // Onboarding (INTEGER → boolean)
         onboardingComplete: row.onboarding_complete === 1,
     };

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/049-add-telegram-settings.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Migration 049: Add Telegram remote control settings columns to the settings table.
+ *
+ * Adds columns for the Telegram Bot integration configuration:
+ *  - telegram_enabled (INTEGER DEFAULT 0): whether Telegram integration is active
+ *  - telegram_bot_token (TEXT): Bot API token from @BotFather
+ *  - telegram_chat_id (TEXT): Paired chat ID
+ *  - telegram_notify_* (INTEGER DEFAULT 0/1): per-event-type notification filters
+ *
+ * Default values are applied via column defaults so no existing rows need updating.
+ * Guards against duplicate column errors using table_info pragma.
+ */
+import type { MigrationParams } from 'umzug';
+import type Database from 'better-sqlite3';
+export declare function up({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+export declare function down({ context: db }: MigrationParams<Database.Database>): Promise<void>;
+//# sourceMappingURL=049-add-telegram-settings.d.ts.map

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/049-add-telegram-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"049-add-telegram-settings.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/persistence/sqlite/migrations/049-add-telegram-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAmB3C,wBAAsB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3F;AAED,wBAAsB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/migrations/049-add-telegram-settings.js

@@ -0,0 +1,40 @@
+/**
+ * Migration 049: Add Telegram remote control settings columns to the settings table.
+ *
+ * Adds columns for the Telegram Bot integration configuration:
+ *  - telegram_enabled (INTEGER DEFAULT 0): whether Telegram integration is active
+ *  - telegram_bot_token (TEXT): Bot API token from @BotFather
+ *  - telegram_chat_id (TEXT): Paired chat ID
+ *  - telegram_notify_* (INTEGER DEFAULT 0/1): per-event-type notification filters
+ *
+ * Default values are applied via column defaults so no existing rows need updating.
+ * Guards against duplicate column errors using table_info pragma.
+ */
+const COLUMNS = [
+    { name: 'telegram_enabled', sql: 'INTEGER NOT NULL DEFAULT 0' },
+    { name: 'telegram_bot_token', sql: 'TEXT' },
+    { name: 'telegram_chat_id', sql: 'TEXT' },
+    { name: 'telegram_notify_agent_started', sql: 'INTEGER NOT NULL DEFAULT 0' },
+    { name: 'telegram_notify_phase_completed', sql: 'INTEGER NOT NULL DEFAULT 0' },
+    { name: 'telegram_notify_waiting_approval', sql: 'INTEGER NOT NULL DEFAULT 1' },
+    { name: 'telegram_notify_agent_completed', sql: 'INTEGER NOT NULL DEFAULT 1' },
+    { name: 'telegram_notify_agent_failed', sql: 'INTEGER NOT NULL DEFAULT 1' },
+    { name: 'telegram_notify_pr_merged', sql: 'INTEGER NOT NULL DEFAULT 1' },
+    { name: 'telegram_notify_pr_closed', sql: 'INTEGER NOT NULL DEFAULT 0' },
+    { name: 'telegram_notify_pr_checks_passed', sql: 'INTEGER NOT NULL DEFAULT 0' },
+    { name: 'telegram_notify_pr_checks_failed', sql: 'INTEGER NOT NULL DEFAULT 1' },
+    { name: 'telegram_notify_pr_blocked', sql: 'INTEGER NOT NULL DEFAULT 1' },
+    { name: 'telegram_notify_merge_review_ready', sql: 'INTEGER NOT NULL DEFAULT 1' },
+];
+export async function up({ context: db }) {
+    const columns = db.pragma('table_info(settings)');
+    const existing = new Set(columns.map((c) => c.name));
+    for (const col of COLUMNS) {
+        if (!existing.has(col.name)) {
+            db.exec(`ALTER TABLE settings ADD COLUMN ${col.name} ${col.sql}`);
+        }
+    }
+}
+export async function down({ context: db }) {
+    void db;
+}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-prompts.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAwCxD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9F;AAuCD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAAE,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAyER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CA0BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqDzD"}
+{"version":3,"file":"merge-prompts.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAyCxD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9F;AAuCD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAAE,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CA2ER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CA0BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqDzD"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/merge-prompts.js

@@ -11,6 +11,7 @@
 import yaml from 'js-yaml';
 import { EvidenceType } from '../../../../../../domain/generated/output.js';
 import { readSpecFile, buildResumeContext } from '../node-helpers.js';
+import { PR_BRANDING } from './pr-branding.js';
 /**
  * Extract merge-phase rejection feedback from spec.yaml.
  */
@@ -152,7 +153,9 @@ export function buildCommitPushPrPrompt(state, branch, baseBranch, repoUrl) {
         steps.push(`${shouldPush ? '6' : '4'}. Create a pull request:
    - Run \`gh pr create --base ${baseBranch} --head ${branch} --title "<title>" --body "<body>"\`
    - Write a descriptive PR title using conventional commit format
-   - Write a rich PR body that summarizes the changes using the spec context below`);
+   - Write a rich PR body that summarizes the changes using the spec context below
+   - The PR body MUST end with this exact branding line (on its own line): \`${PR_BRANDING}\`
+   - Do NOT include any other attribution footer (e.g. "Generated with Claude Code" or similar) — only the Shep branding line above`);
     }
     const resumeContext = buildResumeContext(state.resumeReason);
     return `${resumeContext}You are performing git operations in a feature worktree.

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/pr-branding.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export PR branding from the canonical location in git services.
+ */
+export { PR_BRANDING, applyPrBranding } from '../../../../../services/git/pr-branding.js';
+//# sourceMappingURL=pr-branding.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/pr-branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-branding.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/pr-branding.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/pr-branding.js

@@ -0,0 +1,4 @@
+/**
+ * Re-export PR branding from the canonical location in git services.
+ */
+export { PR_BRANDING, applyPrBranding } from '../../../../../services/git/pr-branding.js';

package/dist/packages/core/src/infrastructure/services/deployment/deployment.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/deployment/deployment.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAmC,MAAM,oBAAoB,CAAC;AAK5E,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACT,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAiCzD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IAC7D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACnC;AA0CD,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,EAAE,CAAkC;gBAEhC,IAAI,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIrD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAIxC;;;;;;;;;;;;OAYG;IACH,UAAU,IAAI,IAAI;IAqFlB;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,SAAe,GAAG,IAAI;IA6H5E;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA4CpD;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0D3C;;OAEG;IACH,OAAO,IAAI,IAAI;IAef;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI;IAM5C;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAM3D,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,WAAW;IAQnB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YA4Dd,aAAa;IAW3B,OAAO,CAAC,WAAW;IAUnB;;;;OAIG;YACW,kBAAkB;IAsChC;;;OAGG;IACH,OAAO,CAAC,SAAS;CAwBlB"}
+{"version":3,"file":"deployment.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/deployment/deployment.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAmC,MAAM,oBAAoB,CAAC;AAK5E,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACT,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAiCzD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IAC7D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACnC;AA0CD,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,EAAE,CAAkC;gBAEhC,IAAI,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIrD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAIxC;;;;;;;;;;;;OAYG;IACH,UAAU,IAAI,IAAI;IAqFlB;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,SAAe,GAAG,IAAI;IA8H5E;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA4CpD;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0D3C;;OAEG;IACH,OAAO,IAAI,IAAI;IAef;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI;IAM5C;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAM3D,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,WAAW;IAQnB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YA4Dd,aAAa;IAW3B,OAAO,CAAC,WAAW;IAUnB;;;;OAIG;YACW,kBAAkB;IAsChC;;;OAGG;IACH,OAAO,CAAC,SAAS;CAwBlB"}

package/dist/packages/core/src/infrastructure/services/deployment/deployment.service.js

@@ -188,14 +188,15 @@ export class DeploymentService {
             throw new Error(detection.error);
         }
         // Build spawn args based on package manager
-        const { packageManager, scriptName, command, needsInstall } = detection;
+        const { packageManager, scriptName, command, needsInstall, resolvedDir } = detection;
+        const spawnDir = resolvedDir;
         const args = packageManager === 'npm' ? ['run', scriptName] : [scriptName];
         // Install dependencies if node_modules is missing (e.g. fresh worktree)
         if (needsInstall) {
-            log.info(`node_modules missing in "${targetPath}" — running ${packageManager} install`);
+            log.info(`node_modules missing in "${spawnDir}" — running ${packageManager} install`);
             try {
                 execFileSync(packageManager, ['install'], {
-                    cwd: targetPath,
+                    cwd: spawnDir,
                     shell: true,
                     stdio: 'ignore',
                     ...(IS_WINDOWS ? { windowsHide: true } : {}),
@@ -207,10 +208,10 @@ export class DeploymentService {
                 throw new Error(`Failed to install dependencies: ${err}`);
             }
         }
-        log.info(`Spawning dev server: command="${command}", packageManager="${packageManager}", scriptName="${scriptName}", cwd="${targetPath}"`);
+        log.info(`Spawning dev server: command="${command}", packageManager="${packageManager}", scriptName="${scriptName}", cwd="${spawnDir}"`);
         const child = this.deps.spawn(packageManager, args, {
             shell: true,
-            cwd: targetPath,
+            cwd: spawnDir,
             // On Unix, detached: true creates a process group via setsid() so we can
             // kill the entire tree with process.kill(-pid). On Windows this flag causes
             // CREATE_NEW_CONSOLE which opens a visible terminal window and disconnects

package/dist/packages/core/src/infrastructure/services/deployment/detect-dev-script.d.ts

@@ -11,6 +11,8 @@ export interface DetectDevScriptSuccess {
     scriptName: string;
     command: string;
     needsInstall: boolean;
+    /** The directory where package.json was found (may differ from input when scanning subdirs) */
+    resolvedDir: string;
 }
 export interface DetectDevScriptError {
     success: false;

package/dist/packages/core/src/infrastructure/services/deployment/detect-dev-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-dev-script.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/deployment/detect-dev-script.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAIlF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAwCtE"}
+{"version":3,"file":"detect-dev-script.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/deployment/detect-dev-script.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAIlF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAetE"}

package/dist/packages/core/src/infrastructure/services/deployment/detect-dev-script.js

@@ -5,7 +5,7 @@
  * scripts (dev, start, serve), and detects the package manager from lockfile
  * presence. Returns the detected command or an error.
  */
-import { readFileSync, existsSync } from 'node:fs';
+import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { createDeploymentLogger } from './deployment-logger.js';
 /** Script names to search for, in priority order */
@@ -25,6 +25,23 @@ const log = createDeploymentLogger('[detectDevScript]');
  */
 export function detectDevScript(dirPath) {
     log.info(`scanning dirPath="${dirPath}"`);
+    // Try the given directory first
+    const directResult = detectDevScriptInDir(dirPath);
+    if (directResult.success)
+        return directResult;
+    // Fallback: scan immediate subdirectories for a package.json with a dev script.
+    // This handles monorepos and projects where the app lives in a subdirectory
+    // (e.g., worktree root has no package.json but `site/` or `app/` does).
+    log.info(`no dev script at root, scanning subdirectories of "${dirPath}"`);
+    const subdirResult = scanSubdirectories(dirPath);
+    if (subdirResult)
+        return subdirResult;
+    return directResult;
+}
+/**
+ * Attempt detection in a single directory.
+ */
+function detectDevScriptInDir(dirPath) {
     // Read and parse package.json
     let packageJson;
     try {
@@ -51,8 +68,40 @@ export function detectDevScript(dirPath) {
     // Build the command — pnpm/yarn use `<pm> <script>`, npm uses `npm run <script>`
     const command = packageManager === 'npm' ? `npm run ${scriptName}` : `${packageManager} ${scriptName}`;
     const needsInstall = !existsSync(join(dirPath, 'node_modules'));
-    log.info(`detected — packageManager="${packageManager}", scriptName="${scriptName}", command="${command}", needsInstall=${needsInstall}`);
-    return { success: true, packageManager, scriptName, command, needsInstall };
+    log.info(`detected — packageManager="${packageManager}", scriptName="${scriptName}", command="${command}", needsInstall=${needsInstall}, resolvedDir="${dirPath}"`);
+    return { success: true, packageManager, scriptName, command, needsInstall, resolvedDir: dirPath };
+}
+/**
+ * Scan immediate subdirectories for a package.json with a dev script.
+ * Skips hidden dirs, node_modules, and common non-project directories.
+ */
+function scanSubdirectories(dirPath) {
+    const SKIP_DIRS = new Set(['node_modules', '.git', '.next', 'dist', 'build', 'out', '.cache']);
+    let entries;
+    try {
+        entries = readdirSync(dirPath);
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith('.') || SKIP_DIRS.has(entry))
+            continue;
+        const subPath = join(dirPath, entry);
+        try {
+            if (!statSync(subPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const result = detectDevScriptInDir(subPath);
+        if (result.success) {
+            log.info(`found dev script in subdirectory "${entry}" — resolvedDir="${subPath}"`);
+            return result;
+        }
+    }
+    return null;
 }
 /**
  * Detect the package manager by checking for lockfile presence.

package/dist/packages/core/src/infrastructure/services/git/git-fork.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-fork.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-fork.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0EAA0E,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0EAA0E,CAAC;AAKjH,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,qBACa,cAAe,YAAW,eAAe;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C1C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC;IAiDtB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBpF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}
+{"version":3,"file":"git-fork.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-fork.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0EAA0E,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0EAA0E,CAAC;AAKjH,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,qBACa,cAAe,YAAW,eAAe;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAErE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C1C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC;IAkDtB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBpF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/packages/core/src/infrastructure/services/git/git-fork.service.js

@@ -20,6 +20,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { injectable, inject } from 'tsyringe';
 import { GitForkError, GitForkErrorCode, } from '../../../application/ports/output/services/git-fork-service.interface.js';
 import { PrStatus } from '../../../domain/generated/output.js';
+import { applyPrBranding } from './pr-branding.js';
 let GitForkService = class GitForkService {
     execFile;
     constructor(execFile) {
@@ -80,6 +81,7 @@ let GitForkService = class GitForkService {
             });
             const forkRepo = this.extractRepoFromUrl(forkUrl.trim());
             const forkOwner = forkRepo.split('/')[0];
+            const brandedBody = applyPrBranding(body);
             const { stdout } = await this.execFile('gh', [
                 'pr',
                 'create',
@@ -88,7 +90,7 @@ let GitForkService = class GitForkService {
                 '--title',
                 title,
                 '--body',
-                body,
+                brandedBody,
                 '--head',
                 `${forkOwner}:${head}`,
                 '--base',

package/dist/packages/core/src/infrastructure/services/git/git-pr.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-pr.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-pr.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git-pr.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/git-pr.service.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/services/git/git-pr.service.js

@@ -22,6 +22,7 @@ import { readFileSync, writeFileSync, unlinkSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import yaml from 'js-yaml';
+import { applyPrBranding } from './pr-branding.js';
 let GitPrService = class GitPrService {
     execFile;
     constructor(execFile) {
@@ -161,7 +162,7 @@ let GitPrService = class GitPrService {
             const prYamlContent = readFileSync(prYamlPath, 'utf-8');
             const prData = yaml.load(prYamlContent);
             const title = prData.title ?? 'Untitled PR';
-            const body = prData.body ?? '';
+            const body = applyPrBranding(prData.body ?? '');
             const args = ['pr', 'create', '--title', title, '--body', body];
             if (prData.baseBranch) {
                 args.push('--base', prData.baseBranch);

package/dist/packages/core/src/infrastructure/services/git/pr-branding.d.ts

@@ -0,0 +1,17 @@
+/**
+ * PR Branding
+ *
+ * Centralizes the branding footer used in pull request bodies
+ * created by Shep. Ensures consistent attribution across all
+ * PR creation paths (agent-driven, fork-and-PR, etc.).
+ */
+/** The branding line to append to PR bodies. */
+export declare const PR_BRANDING = "Built with Shep \uD83D\uDC11 [Shep Bot](https://github.com/shep-ai/cli)";
+/**
+ * Ensure a PR body carries the correct Shep branding.
+ *
+ * 1. Strips any unwanted AI-tool attribution footers
+ * 2. Appends the Shep branding line if not already present
+ */
+export declare function applyPrBranding(body: string): string;
+//# sourceMappingURL=pr-branding.d.ts.map

package/dist/packages/core/src/infrastructure/services/git/pr-branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-branding.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/git/pr-branding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gDAAgD;AAChD,eAAO,MAAM,WAAW,4EACmD,CAAC;AAS5E;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAapD"}

package/dist/packages/core/src/infrastructure/services/git/pr-branding.js

@@ -0,0 +1,31 @@
+/**
+ * PR Branding
+ *
+ * Centralizes the branding footer used in pull request bodies
+ * created by Shep. Ensures consistent attribution across all
+ * PR creation paths (agent-driven, fork-and-PR, etc.).
+ */
+/** The branding line to append to PR bodies. */
+export const PR_BRANDING = 'Built with Shep \uD83D\uDC11 [Shep Bot](https://github.com/shep-ai/cli)';
+/**
+ * Pattern matching common AI-tool attribution footers that should be
+ * replaced (e.g. "Generated with Claude Code", "Co-Authored-By: Claude").
+ */
+const UNWANTED_BRANDING_PATTERN = /\n*(?:🤖\s*)?Generated with \[Claude Code\]\(https:\/\/claude\.com\/claude-code\)\s*/gi;
+/**
+ * Ensure a PR body carries the correct Shep branding.
+ *
+ * 1. Strips any unwanted AI-tool attribution footers
+ * 2. Appends the Shep branding line if not already present
+ */
+export function applyPrBranding(body) {
+    // Strip unwanted branding
+    let cleaned = body.replace(UNWANTED_BRANDING_PATTERN, '');
+    // Trim trailing whitespace/newlines before appending branding
+    cleaned = cleaned.trimEnd();
+    // Only append if not already present
+    if (!cleaned.includes(PR_BRANDING)) {
+        cleaned = `${cleaned}\n\n${PR_BRANDING}`;
+    }
+    return cleaned;
+}

package/dist/packages/core/src/infrastructure/services/notifications/notification.service.d.ts

@@ -5,17 +5,25 @@
  * events to enabled channels:
  * - Notification bus (for SSE → in-app toasts and browser notifications)
  * - Desktop notifier (node-notifier for OS-level notifications)
+ * - Telegram bot (sends messages via Bot API)
  *
  * Channel enable/disable and event type filters are read from Settings.
  */
 import type { NotificationEvent } from '../../../domain/generated/output.js';
 import type { INotificationService } from '../../../application/ports/output/services/notification-service.interface.js';
+import type { ITelegramService } from '../../../application/ports/output/services/telegram-service.interface.js';
 import type { NotificationBus } from './notification-bus.js';
 import type { DesktopNotifier } from './desktop-notifier.js';
 export declare class NotificationService implements INotificationService {
     private readonly bus;
     private readonly desktopNotifier;
-    constructor(bus: NotificationBus, desktopNotifier: DesktopNotifier);
+    private readonly telegramService;
+    constructor(bus: NotificationBus, desktopNotifier: DesktopNotifier, telegramService: ITelegramService);
     notify(event: NotificationEvent): void;
+    /**
+     * Send a notification to Telegram if the channel is enabled and
+     * the specific event type is allowed in the Telegram notify events config.
+     */
+    private sendTelegramNotification;
 }
 //# sourceMappingURL=notification.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/notifications/notification.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/notifications/notification.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8EAA8E,CAAC;AAEzH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAgB7D,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,GAAG,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe;IAKlE,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;CAiBvC"}
+{"version":3,"file":"notification.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/notifications/notification.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8EAA8E,CAAC;AACzH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0EAA0E,CAAC;AAEjH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA8B7D,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;gBAGjD,GAAG,EAAE,eAAe,EACpB,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,gBAAgB;IAOnC,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAqBtC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;CAmBjC"}

package/dist/packages/core/src/infrastructure/services/notifications/notification.service.js

@@ -5,6 +5,7 @@
  * events to enabled channels:
  * - Notification bus (for SSE → in-app toasts and browser notifications)
  * - Desktop notifier (node-notifier for OS-level notifications)
+ * - Telegram bot (sends messages via Bot API)
  *
  * Channel enable/disable and event type filters are read from Settings.
  */
@@ -23,12 +24,27 @@ const EVENT_TYPE_TO_CONFIG_KEY = {
     [NotificationEventType.PrBlocked]: 'prBlocked',
     [NotificationEventType.MergeReviewReady]: 'mergeReviewReady',
 };
+const EVENT_TYPE_TO_TELEGRAM_KEY = {
+    [NotificationEventType.AgentStarted]: 'agentStarted',
+    [NotificationEventType.PhaseCompleted]: 'phaseCompleted',
+    [NotificationEventType.WaitingApproval]: 'waitingApproval',
+    [NotificationEventType.AgentCompleted]: 'agentCompleted',
+    [NotificationEventType.AgentFailed]: 'agentFailed',
+    [NotificationEventType.PrMerged]: 'prMerged',
+    [NotificationEventType.PrClosed]: 'prClosed',
+    [NotificationEventType.PrChecksPassed]: 'prChecksPassed',
+    [NotificationEventType.PrChecksFailed]: 'prChecksFailed',
+    [NotificationEventType.PrBlocked]: 'prBlocked',
+    [NotificationEventType.MergeReviewReady]: 'mergeReviewReady',
+};
 export class NotificationService {
     bus;
     desktopNotifier;
-    constructor(bus, desktopNotifier) {
+    telegramService;
+    constructor(bus, desktopNotifier, telegramService) {
         this.bus = bus;
         this.desktopNotifier = desktopNotifier;
+        this.telegramService = telegramService;
     }
     notify(event) {
         const { notifications } = getSettings();
@@ -43,5 +59,28 @@ export class NotificationService {
         }
         // Desktop notifications disabled — removed in favour of in-app toasts.
         // The DesktopNotifier dependency is kept for API compatibility but never called.
+        // Send to Telegram if enabled and event type is allowed
+        this.sendTelegramNotification(event);
+    }
+    /**
+     * Send a notification to Telegram if the channel is enabled and
+     * the specific event type is allowed in the Telegram notify events config.
+     */
+    sendTelegramNotification(event) {
+        const { telegram } = getSettings();
+        if (!telegram?.enabled || !telegram.botToken || !telegram.chatId) {
+            return;
+        }
+        // Check Telegram-specific event type filter
+        const telegramKey = EVENT_TYPE_TO_TELEGRAM_KEY[event.eventType];
+        if (telegramKey && !telegram.notifyEvents[telegramKey]) {
+            return;
+        }
+        // Fire-and-forget: don't block the notification pipeline on Telegram API calls
+        this.telegramService.sendNotification(telegram.botToken, telegram.chatId, event).catch(() => {
+            // Swallow errors silently — Telegram is a best-effort channel.
+            // Network failures, rate limits, or invalid tokens should not
+            // break the core notification flow.
+        });
     }
 }