@shepai/cli 1.116.3 → 1.117.0-pr367.ca5b6ac

package/dist/packages/core/src/infrastructure/services/webhook/webhook-manager.service.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Webhook Manager Service
+ *
+ * Orchestrates the Cloudflare Tunnel and GitHub Webhook lifecycle.
+ * Follows the singleton pattern used by NotificationWatcherService
+ * and PrSyncWatcherService.
+ *
+ * Lifecycle:
+ * 1. Start Cloudflare Tunnel to get a public URL
+ * 2. Register GitHub webhooks pointing to the tunnel URL
+ * 3. Monitor for tunnel URL changes → update webhooks
+ * 4. On shutdown → remove webhooks → stop tunnel
+ *
+ * The manager is optional — if cloudflared is not installed or webhook
+ * registration fails, the system falls back to polling gracefully.
+ */
+import type { ITunnelService } from '../../../application/ports/output/services/tunnel-service.interface.js';
+import type { IWebhookService } from '../../../application/ports/output/services/webhook-service.interface.js';
+import type { RegisteredWebhook, WebhookDeliveryRecord } from './github-webhook.service.js';
+export interface WebhookSystemStatus {
+    running: boolean;
+    tunnel: {
+        connected: boolean;
+        publicUrl: string | null;
+    };
+    webhooks: {
+        registered: readonly RegisteredWebhook[];
+        totalDeliveries: number;
+        successCount: number;
+        errorCount: number;
+        ignoredCount: number;
+    };
+    startedAt: string | null;
+}
+export declare class WebhookManagerService {
+    private readonly tunnelService;
+    private readonly webhookService;
+    private running;
+    private startedAt;
+    constructor(tunnelService: ITunnelService, webhookService: IWebhookService);
+    /**
+     * Start the tunnel and register webhooks.
+     * Fails gracefully — logs warnings but does not throw.
+     *
+     * @param localPort - The local web server port to tunnel
+     */
+    start(localPort: number): Promise<void>;
+    /**
+     * Stop the webhook system — remove webhooks, then stop the tunnel.
+     */
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getTunnelUrl(): string | null;
+    getStatus(): WebhookSystemStatus;
+    getDeliveryHistory(): readonly WebhookDeliveryRecord[];
+}
+/**
+ * Initialize the webhook manager singleton.
+ * Must be called once during web server startup.
+ *
+ * @throws Error if the manager is already initialized
+ */
+export declare function initializeWebhookManager(tunnelService: ITunnelService, webhookService: IWebhookService): void;
+/**
+ * Get the webhook manager singleton.
+ *
+ * @returns The webhook manager service
+ * @throws Error if the manager hasn't been initialized yet
+ */
+export declare function getWebhookManager(): WebhookManagerService;
+/**
+ * Check if the webhook manager has been initialized.
+ */
+export declare function hasWebhookManager(): boolean;
+/**
+ * Reset the webhook manager singleton (for testing purposes only).
+ * Stops the manager if running before resetting.
+ *
+ * @internal
+ */
+export declare function resetWebhookManager(): void;
+//# sourceMappingURL=webhook-manager.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/webhook/webhook-manager.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-manager.service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/services/webhook/webhook-manager.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wEAAwE,CAAC;AAC7G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yEAAyE,CAAC;AAC/G,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;QACzC,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;gBAE5B,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe;IAK1E;;;;;OAKG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B,SAAS,IAAI,OAAO;IAIpB,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,SAAS,IAAI,mBAAmB;IAoChC,kBAAkB,IAAI,SAAS,qBAAqB,EAAE;CAOvD;AAoBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,cAAc,EAC7B,cAAc,EAAE,eAAe,GAC9B,IAAI,CAMN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,qBAAqB,CASzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/dist/packages/core/src/infrastructure/services/webhook/webhook-manager.service.js

@@ -0,0 +1,206 @@
+/**
+ * Webhook Manager Service
+ *
+ * Orchestrates the Cloudflare Tunnel and GitHub Webhook lifecycle.
+ * Follows the singleton pattern used by NotificationWatcherService
+ * and PrSyncWatcherService.
+ *
+ * Lifecycle:
+ * 1. Start Cloudflare Tunnel to get a public URL
+ * 2. Register GitHub webhooks pointing to the tunnel URL
+ * 3. Monitor for tunnel URL changes → update webhooks
+ * 4. On shutdown → remove webhooks → stop tunnel
+ *
+ * The manager is optional — if cloudflared is not installed or webhook
+ * registration fails, the system falls back to polling gracefully.
+ */
+const TAG = '[WebhookManager]';
+export class WebhookManagerService {
+    tunnelService;
+    webhookService;
+    running = false;
+    startedAt = null;
+    constructor(tunnelService, webhookService) {
+        this.tunnelService = tunnelService;
+        this.webhookService = webhookService;
+    }
+    /**
+     * Start the tunnel and register webhooks.
+     * Fails gracefully — logs warnings but does not throw.
+     *
+     * @param localPort - The local web server port to tunnel
+     */
+    async start(localPort) {
+        if (this.running)
+            return;
+        try {
+            // Step 1: Start the tunnel
+            // eslint-disable-next-line no-console
+            console.log(`${TAG} Starting Cloudflare Tunnel for port ${localPort}...`);
+            const publicUrl = await this.tunnelService.start(localPort);
+            // Step 2: Listen for URL changes
+            this.tunnelService.onUrlChange(async (newUrl) => {
+                // eslint-disable-next-line no-console
+                console.log(`${TAG} Tunnel URL changed, updating webhooks...`);
+                try {
+                    await this.webhookService.updateWebhookUrl(newUrl);
+                }
+                catch (error) {
+                    const msg = error instanceof Error ? error.message : String(error);
+                    // eslint-disable-next-line no-console
+                    console.warn(`${TAG} Failed to update webhooks after URL change: ${msg}`);
+                }
+            });
+            // Step 3: Register webhooks with external services
+            await this.webhookService.registerWebhooks(publicUrl);
+            this.running = true;
+            this.startedAt = new Date().toISOString();
+            // eslint-disable-next-line no-console
+            console.log(`${TAG} Webhook system ready (tunnel: ${publicUrl})`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            // eslint-disable-next-line no-console
+            console.warn(`${TAG} Failed to start webhook system (falling back to polling): ${msg}`);
+            // Clean up partial state
+            try {
+                await this.tunnelService.stop();
+            }
+            catch {
+                // Already stopped or never started
+            }
+        }
+    }
+    /**
+     * Stop the webhook system — remove webhooks, then stop the tunnel.
+     */
+    async stop() {
+        if (!this.running)
+            return;
+        // eslint-disable-next-line no-console
+        console.log(`${TAG} Shutting down webhook system...`);
+        try {
+            await this.webhookService.removeWebhooks();
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            // eslint-disable-next-line no-console
+            console.warn(`${TAG} Failed to remove webhooks during shutdown: ${msg}`);
+        }
+        try {
+            await this.tunnelService.stop();
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            // eslint-disable-next-line no-console
+            console.warn(`${TAG} Failed to stop tunnel during shutdown: ${msg}`);
+        }
+        this.running = false;
+        // eslint-disable-next-line no-console
+        console.log(`${TAG} Webhook system stopped`);
+    }
+    isRunning() {
+        return this.running;
+    }
+    getTunnelUrl() {
+        return this.tunnelService.getPublicUrl();
+    }
+    getStatus() {
+        const ghService = this.webhookService;
+        const deliveries = typeof ghService.getDeliveryHistory === 'function' ? ghService.getDeliveryHistory() : [];
+        const registered = typeof ghService.getRegisteredWebhooks === 'function'
+            ? ghService.getRegisteredWebhooks()
+            : [];
+        let successCount = 0;
+        let errorCount = 0;
+        let ignoredCount = 0;
+        for (const d of deliveries) {
+            if (d.status === 'success')
+                successCount++;
+            else if (d.status === 'error')
+                errorCount++;
+            else
+                ignoredCount++;
+        }
+        return {
+            running: this.running,
+            tunnel: {
+                connected: this.tunnelService.isRunning(),
+                publicUrl: this.tunnelService.getPublicUrl(),
+            },
+            webhooks: {
+                registered,
+                totalDeliveries: deliveries.length,
+                successCount,
+                errorCount,
+                ignoredCount,
+            },
+            startedAt: this.startedAt,
+        };
+    }
+    getDeliveryHistory() {
+        const ghService = this.webhookService;
+        if (typeof ghService.getDeliveryHistory === 'function') {
+            return ghService.getDeliveryHistory();
+        }
+        return [];
+    }
+}
+// --- Singleton accessors ---
+//
+// The singleton is stored on globalThis so that it survives module duplication
+// across bundler contexts (e.g. Next.js Turbopack bundles API routes separately
+// from the dev-server entry point, giving each its own copy of module-level
+// variables). By using globalThis, the same manager instance is visible to both
+// the initializer (dev-server.ts / CLI) and the API route handlers.
+const GLOBAL_KEY = '__shepWebhookManager';
+function getInstance() {
+    return globalThis[GLOBAL_KEY] ?? null;
+}
+function setInstance(instance) {
+    globalThis[GLOBAL_KEY] = instance;
+}
+/**
+ * Initialize the webhook manager singleton.
+ * Must be called once during web server startup.
+ *
+ * @throws Error if the manager is already initialized
+ */
+export function initializeWebhookManager(tunnelService, webhookService) {
+    if (getInstance() !== null) {
+        throw new Error('Webhook manager already initialized. Cannot re-initialize.');
+    }
+    setInstance(new WebhookManagerService(tunnelService, webhookService));
+}
+/**
+ * Get the webhook manager singleton.
+ *
+ * @returns The webhook manager service
+ * @throws Error if the manager hasn't been initialized yet
+ */
+export function getWebhookManager() {
+    const instance = getInstance();
+    if (instance === null) {
+        throw new Error('Webhook manager not initialized. Call initializeWebhookManager() during web server startup.');
+    }
+    return instance;
+}
+/**
+ * Check if the webhook manager has been initialized.
+ */
+export function hasWebhookManager() {
+    return getInstance() !== null;
+}
+/**
+ * Reset the webhook manager singleton (for testing purposes only).
+ * Stops the manager if running before resetting.
+ *
+ * @internal
+ */
+export function resetWebhookManager() {
+    const instance = getInstance();
+    if (instance !== null) {
+        void instance.stop();
+    }
+    setInstance(null);
+}

package/dist/src/presentation/cli/commands/feat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAa3C"}

package/dist/src/presentation/cli/commands/feat/index.js

@@ -15,6 +15,7 @@ import { createLsCommand } from './ls.command.js';
 import { createShowCommand } from './show.command.js';
 import { createDelCommand } from './del.command.js';
 import { createResumeCommand } from './resume.command.js';
+import { createStartCommand } from './start.command.js';
 import { createReviewCommand } from './review.command.js';
 import { createApproveCommand } from './approve.command.js';
 import { createRejectCommand } from './reject.command.js';
@@ -30,6 +31,7 @@ export function createFeatCommand() {
         .addCommand(createShowCommand())
         .addCommand(createDelCommand())
         .addCommand(createResumeCommand())
+        .addCommand(createStartCommand())
         .addCommand(createReviewCommand())
         .addCommand(createApproveCommand())
         .addCommand(createRejectCommand())

package/dist/src/presentation/cli/commands/feat/ls.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ls.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/ls.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyKpC,wBAAgB,eAAe,IAAI,OAAO,CAsGzC"}
+{"version":3,"file":"ls.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/ls.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6KpC,wBAAgB,eAAe,IAAI,OAAO,CAsGzC"}

package/dist/src/presentation/cli/commands/feat/ls.command.js

@@ -54,6 +54,9 @@ function formatStatus(feature, run) {
     if (feature.lifecycle === 'Blocked') {
         return `${colors.warning(symbols.dotEmpty)} ${colors.warning('Blocked')}`;
     }
+    if (feature.lifecycle === 'Pending') {
+        return `${colors.muted(symbols.dotEmpty)} ${colors.muted('Pending')}`;
+    }
     if (!run) {
         return `${colors.muted(symbols.dotEmpty)} ${colors.muted(feature.lifecycle)}`;
     }

package/dist/src/presentation/cli/commands/feat/new.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/new.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4DpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAwI1C"}
+{"version":3,"file":"new.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/new.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6DpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAmJ1C"}

package/dist/src/presentation/cli/commands/feat/new.command.js

@@ -55,6 +55,7 @@ export function createNewCommand() {
         .option('--allow-merge', 'Auto-approve merge phase')
         .option('--allow-all', 'Run fully autonomous (no approval pauses)')
         .option('--parent <fid>', 'Parent feature ID (full or partial prefix)')
+        .option('--pending', 'Create feature without starting the agent')
         .option('--fast', 'Skip SDLC phases and implement directly from your prompt')
         .option('--model <model>', 'LLM model identifier for this run (e.g. claude-opus-4-6)')
         .option('--attach <path>', 'Attach a file (repeatable)', collect, [])
@@ -113,6 +114,7 @@ export function createNewCommand() {
                 push,
                 openPr,
                 ...(parentId !== undefined && { parentId }),
+                ...(options.pending && { pending: true }),
                 ...(options.fast && { fast: true }),
                 ...(options.model !== undefined && { model: options.model }),
                 ...(attachmentPaths.length > 0 && { attachmentPaths }),
@@ -129,6 +131,9 @@ export function createNewCommand() {
             if (feature.lifecycle === SdlcLifecycle.Blocked) {
                 messages.info(`Feature created in Blocked state — waiting for parent to reach Implementation`);
             }
+            if (feature.lifecycle === SdlcLifecycle.Pending) {
+                messages.info(`Feature created in Pending state — run ${colors.accent(`shep feat start ${feature.id.slice(0, 8)}`)} to begin`);
+            }
             console.log(`  ${colors.muted('ID:')}       ${colors.accent(feature.id)}`);
             console.log(`  ${colors.muted('Name:')}     ${feature.name}`);
             console.log(`  ${colors.muted('Branch:')}   ${colors.accent(feature.branch)}`);
@@ -138,7 +143,10 @@ export function createNewCommand() {
                 console.log(`  ${colors.muted('Spec:')}     ${feature.specPath}`);
             }
             if (feature.agentRunId) {
-                console.log(`  ${colors.muted('Agent:')}    ${colors.success('spawned')} (run ${feature.agentRunId.slice(0, 8)})`);
+                const agentStatus = feature.lifecycle === SdlcLifecycle.Pending
+                    ? colors.muted('pending')
+                    : colors.success('spawned');
+                console.log(`  ${colors.muted('Agent:')}    ${agentStatus} (run ${feature.agentRunId.slice(0, 8)})`);
             }
             if (push || openPr) {
                 const pushHint = openPr ? 'push + PR' : 'push only';

package/dist/src/presentation/cli/commands/feat/start.command.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Feature Start Command
+ *
+ * Starts a pending feature by transitioning it to its active lifecycle
+ * and spawning the agent.
+ *
+ * Usage:
+ *   shep feat start <id>
+ */
+import { Command } from 'commander';
+export declare function createStartCommand(): Command;
+//# sourceMappingURL=start.command.d.ts.map

package/dist/src/presentation/cli/commands/feat/start.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/start.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,kBAAkB,IAAI,OAAO,CAgC5C"}

package/dist/src/presentation/cli/commands/feat/start.command.js

@@ -0,0 +1,43 @@
+/**
+ * Feature Start Command
+ *
+ * Starts a pending feature by transitioning it to its active lifecycle
+ * and spawning the agent.
+ *
+ * Usage:
+ *   shep feat start <id>
+ */
+import { Command } from 'commander';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { StartFeatureUseCase } from '../../../../../packages/core/src/application/use-cases/features/start-feature.use-case.js';
+import { colors, messages, spinner } from '../../ui/index.js';
+export function createStartCommand() {
+    return new Command('start')
+        .description('Start a pending feature (spawn the agent)')
+        .argument('<id>', 'Feature ID (or prefix)')
+        .action(async (id) => {
+        try {
+            const useCase = container.resolve(StartFeatureUseCase);
+            const { feature, agentRun } = await spinner('Starting feature', () => useCase.execute(id));
+            messages.newline();
+            if (feature.lifecycle === 'Blocked') {
+                messages.warning(`Feature transitioned to Blocked — parent has not reached Implementation`);
+            }
+            else {
+                messages.success('Feature started');
+            }
+            console.log(`  ${colors.muted('Feature:')} ${feature.name}`);
+            console.log(`  ${colors.muted('Branch:')}  ${colors.accent(feature.branch)}`);
+            console.log(`  ${colors.muted('Status:')}  ${feature.lifecycle}`);
+            if (feature.lifecycle !== 'Blocked') {
+                console.log(`  ${colors.muted('Agent:')}   ${colors.success('spawned')} (run ${agentRun.id.slice(0, 8)})`);
+            }
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to start feature', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/ui.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/ui.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAgC1D;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CA0FzC"}
+{"version":3,"file":"ui.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/ui.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAuC1D;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAwGzC"}

package/dist/src/presentation/cli/commands/ui.command.js

@@ -23,6 +23,7 @@ import { initializeNotificationWatcher, getNotificationWatcher, } from '../../..
 import { initializePrSyncWatcher, getPrSyncWatcher, } from '../../../../packages/core/src/infrastructure/services/pr-sync/pr-sync-watcher.service.js';
 import { getExistingConnection } from '../../../../packages/core/src/infrastructure/persistence/sqlite/connection.js';
 import { BrowserOpenerService } from '../../../../packages/core/src/infrastructure/services/browser-opener.service.js';
+import { initializeWebhookManager, getWebhookManager, hasWebhookManager, } from '../../../../packages/core/src/infrastructure/services/webhook/webhook-manager.service.js';
 import { colors, fmt, messages } from '../ui/index.js';
 function parsePort(value) {
     const port = parseInt(value, 10);
@@ -70,6 +71,17 @@ Examples:
             const db = getExistingConnection();
             initializePrSyncWatcher(featureRepo, runRepo, gitPrService, notificationService, undefined, db);
             getPrSyncWatcher().start();
+            // Start webhook system (optional — falls back to polling if cloudflared is not available)
+            try {
+                const tunnelService = container.resolve('ITunnelService');
+                const webhookService = container.resolve('IWebhookService');
+                initializeWebhookManager(tunnelService, webhookService);
+                // Start is async and non-blocking — failures are logged, not thrown
+                void getWebhookManager().start(port);
+            }
+            catch {
+                // Webhook system is optional; polling continues to work
+            }
             const url = `http://localhost:${port}`;
             messages.success(`Server ready at ${fmt.code(url)}`);
             messages.info('Press Ctrl+C to stop');
@@ -91,6 +103,9 @@ Examples:
                 // Force exit after 5s if graceful shutdown stalls
                 const forceExit = setTimeout(() => process.exit(0), 5000);
                 forceExit.unref();
+                if (hasWebhookManager()) {
+                    await getWebhookManager().stop();
+                }
                 getPrSyncWatcher().stop();
                 getNotificationWatcher().stop();
                 await service.stop();

package/dist/src/presentation/web/app/actions/create-feature.d.ts

@@ -18,6 +18,8 @@ interface CreateFeatureInput {
     parentId?: string;
     /** When true, skip SDLC phases and implement directly from the prompt. */
     fast?: boolean;
+    /** When true, create the feature in pending state (no agent spawned). */
+    pending?: boolean;
     /** Optional agent type override for this feature run */
     agentType?: string;
     /** Optional model identifier for this feature run */

package/dist/src/presentation/web/app/actions/create-feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-feature.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4EhD"}
+{"version":3,"file":"create-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/create-feature.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+EhD"}

package/dist/src/presentation/web/app/actions/create-feature.js

@@ -2,7 +2,7 @@
 import { resolve } from '../../lib/server-container.js';
 import { composeUserInput } from './compose-user-input.js';
 export async function createFeature(input) {
-    const { description, repositoryPath, attachments, sessionId, approvalGates, push, openPr, parentId, fast, agentType, model, } = input;
+    const { description, repositoryPath, attachments, sessionId, approvalGates, push, openPr, parentId, fast, pending, agentType, model, } = input;
     if (!description?.trim()) {
         return { error: 'description is required' };
     }
@@ -27,6 +27,7 @@ export async function createFeature(input) {
             ...(parentId ? { parentId } : {}),
             description,
             ...(fast ? { fast } : {}),
+            ...(pending ? { pending } : {}),
             ...(agentType ? { agentType } : {}),
             ...(model ? { model } : {}),
         });
@@ -41,6 +42,7 @@ export async function createFeature(input) {
             openPr: openPr ?? false,
             ...(parentId ? { parentId } : {}),
             ...(fast ? { fast } : {}),
+            ...(pending ? { pending } : {}),
             ...(agentType ? { agentType } : {}),
             ...(model ? { model } : {}),
             ...(sessionId ? { sessionId } : {}),

package/dist/src/presentation/web/app/actions/load-webhook-status.d.ts

@@ -0,0 +1,3 @@
+import type { WebhookSystemStatus } from '../../../../../packages/core/src/infrastructure/services/webhook/webhook-manager.service.js';
+export declare function loadWebhookStatus(): Promise<WebhookSystemStatus>;
+//# sourceMappingURL=load-webhook-status.d.ts.map

package/dist/src/presentation/web/app/actions/load-webhook-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-webhook-status.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/load-webhook-status.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sEAAsE,CAAC;AAEhH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAiBtE"}

package/dist/src/presentation/web/app/actions/load-webhook-status.js

@@ -0,0 +1,19 @@
+'use server';
+import { hasWebhookManager, getWebhookManager, } from '../../../../../packages/core/src/infrastructure/services/webhook/webhook-manager.service.js';
+export async function loadWebhookStatus() {
+    if (!hasWebhookManager()) {
+        return {
+            running: false,
+            tunnel: { connected: false, publicUrl: null },
+            webhooks: {
+                registered: [],
+                totalDeliveries: 0,
+                successCount: 0,
+                errorCount: 0,
+                ignoredCount: 0,
+            },
+            startedAt: null,
+        };
+    }
+    return getWebhookManager().getStatus();
+}

package/dist/src/presentation/web/app/actions/start-feature.d.ts

@@ -0,0 +1,5 @@
+export declare function startFeature(featureId: string): Promise<{
+    started: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=start-feature.d.ts.map

package/dist/src/presentation/web/app/actions/start-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-feature.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/start-feature.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/C"}

package/dist/src/presentation/web/app/actions/start-feature.js

@@ -0,0 +1,16 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+export async function startFeature(featureId) {
+    if (!featureId.trim()) {
+        return { started: false, error: 'Feature id is required' };
+    }
+    try {
+        const useCase = resolve('StartFeatureUseCase');
+        await useCase.execute(featureId);
+        return { started: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to start feature';
+        return { started: false, error: message };
+    }
+}

package/dist/src/presentation/web/app/api/agent-events/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/app/api/agent-events/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAqEvC,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA4R9C"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/app/api/agent-events/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAsEvC,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA4R9C"}

package/dist/src/presentation/web/app/api/agent-events/route.js

@@ -34,6 +34,7 @@ const LIFECYCLE_TO_NODE = {
     [SdlcLifecycle.Review]: 'merge',
     [SdlcLifecycle.Maintain]: 'maintain',
     [SdlcLifecycle.Blocked]: 'blocked',
+    [SdlcLifecycle.Pending]: 'pending',
     [SdlcLifecycle.Deleting]: 'blocked',
 };
 const STATUS_TO_EVENT = {

package/dist/src/presentation/web/app/api/webhooks/deliveries/route.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Webhook Delivery History: GET /api/webhooks/deliveries
+ *
+ * Returns recent webhook delivery records with optional filtering.
+ * Query params: ?status=success|error|ignored&eventType=pull_request&limit=50
+ */
+export declare const dynamic = "force-dynamic";
+export declare function GET(request: Request): Promise<Response>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/webhooks/deliveries/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../src/presentation/web/app/api/webhooks/deliveries/route.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAEvC,wBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsB7D"}

package/dist/src/presentation/web/app/api/webhooks/deliveries/route.js

@@ -0,0 +1,27 @@
+/**
+ * Webhook Delivery History: GET /api/webhooks/deliveries
+ *
+ * Returns recent webhook delivery records with optional filtering.
+ * Query params: ?status=success|error|ignored&eventType=pull_request&limit=50
+ */
+import { hasWebhookManager, getWebhookManager, } from '../../../../../../../packages/core/src/infrastructure/services/webhook/webhook-manager.service.js';
+export const dynamic = 'force-dynamic';
+export async function GET(request) {
+    if (!hasWebhookManager()) {
+        return Response.json({ deliveries: [] });
+    }
+    const url = new URL(request.url);
+    const statusFilter = url.searchParams.get('status');
+    const eventTypeFilter = url.searchParams.get('eventType');
+    const limitParam = url.searchParams.get('limit');
+    const limit = limitParam ? Math.min(parseInt(limitParam, 10) || 50, 200) : 50;
+    const manager = getWebhookManager();
+    let deliveries = [...manager.getDeliveryHistory()];
+    if (statusFilter) {
+        deliveries = deliveries.filter((d) => d.status === statusFilter);
+    }
+    if (eventTypeFilter) {
+        deliveries = deliveries.filter((d) => d.eventType === eventTypeFilter);
+    }
+    return Response.json({ deliveries: deliveries.slice(0, limit) });
+}