@shepai/cli 1.25.0 → 1.27.0

package/dist/src/presentation/web/components/features/features-canvas/features-canvas.stories.js

@@ -24,6 +24,8 @@ const singleNode = {
         lifecycle: 'requirements',
         state: 'running',
         progress: 45,
+        repositoryPath: '/home/user/my-repo',
+        branch: 'feat/auth-module',
     },
 };
 const multipleNodes = [
@@ -38,6 +40,8 @@ const multipleNodes = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 65,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
     {
@@ -51,6 +55,8 @@ const multipleNodes = [
             lifecycle: 'research',
             state: 'action-required',
             progress: 20,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/user-dashboard',
         },
     },
     {
@@ -64,6 +70,8 @@ const multipleNodes = [
             lifecycle: 'deploy',
             state: 'done',
             progress: 100,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/api-gateway',
         },
     },
     {
@@ -77,6 +85,8 @@ const multipleNodes = [
             lifecycle: 'review',
             state: 'blocked',
             progress: 40,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/payment-integration',
         },
     },
     {
@@ -90,6 +100,8 @@ const multipleNodes = [
             lifecycle: 'implementation',
             state: 'error',
             progress: 30,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/email-service',
         },
     },
 ];
@@ -105,6 +117,8 @@ const connectedNodes = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 65,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
     {
@@ -119,6 +133,8 @@ const connectedNodes = [
             state: 'blocked',
             progress: 10,
             blockedBy: 'Auth Module',
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/user-dashboard',
         },
     },
     {
@@ -132,6 +148,8 @@ const connectedNodes = [
             lifecycle: 'requirements',
             state: 'action-required',
             progress: 5,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/api-gateway',
         },
     },
     {
@@ -146,6 +164,8 @@ const connectedNodes = [
             state: 'blocked',
             progress: 0,
             blockedBy: 'User Dashboard',
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/admin-panel',
         },
     },
 ];
@@ -220,6 +240,8 @@ const repoFeatureNodes = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 65,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
     {
@@ -233,6 +255,8 @@ const repoFeatureNodes = [
             lifecycle: 'requirements',
             state: 'action-required',
             progress: 20,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/feature-flow-canvas',
         },
     },
 ];
@@ -274,6 +298,8 @@ const singleRepoSingleFeatureNodes = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 65,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
 ];
@@ -312,6 +338,8 @@ const singleRepoMultiFeatNodes = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 40,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/sso-integration',
         },
     },
     {
@@ -325,6 +353,8 @@ const singleRepoMultiFeatNodes = [
             lifecycle: 'requirements',
             state: 'action-required',
             progress: 10,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
     {
@@ -338,6 +368,8 @@ const singleRepoMultiFeatNodes = [
             lifecycle: 'research',
             state: 'running',
             progress: 25,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/api-gateway',
         },
     },
 ];
@@ -384,6 +416,8 @@ const multiRepoNodes = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 65,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
     {
@@ -397,6 +431,8 @@ const multiRepoNodes = [
             lifecycle: 'requirements',
             state: 'action-required',
             progress: 15,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/dashboard-ui',
         },
     },
 ];
@@ -448,6 +484,8 @@ const mixedRepoFeatureNodesRaw = [
             lifecycle: 'implementation',
             state: 'running',
             progress: 65,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/auth-module',
         },
     },
     {
@@ -461,6 +499,8 @@ const mixedRepoFeatureNodesRaw = [
             lifecycle: 'research',
             state: 'action-required',
             progress: 20,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/sso-integration',
         },
     },
     {
@@ -474,6 +514,8 @@ const mixedRepoFeatureNodesRaw = [
             lifecycle: 'requirements',
             state: 'running',
             progress: 10,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/api-gateway',
         },
     },
     {
@@ -487,6 +529,8 @@ const mixedRepoFeatureNodesRaw = [
             lifecycle: 'deploy',
             state: 'done',
             progress: 100,
+            repositoryPath: '/home/user/my-repo',
+            branch: 'feat/admin-panel',
         },
     },
 ];

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-shell/app-shell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKpD,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAkBnD"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/layouts/app-shell/app-shell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMpD,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAqBnD"}

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.js

@@ -4,7 +4,10 @@ import { useCallback } from 'react';
 import { SidebarProvider, SidebarInset } from '../../ui/sidebar.js';
 import { AppSidebar } from '../../layouts/app-sidebar/index.js';
 import { ThemeToggle } from '../../common/theme-toggle/index.js';
+import { useNotifications } from '../../../hooks/use-notifications.js';
 export function AppShell({ children }) {
+    // Subscribe to agent lifecycle events and dispatch toast/browser notifications
+    useNotifications();
     const handleNewFeature = useCallback(() => {
         window.dispatchEvent(new CustomEvent('shep:open-create-drawer'));
     }, []);

package/dist/src/presentation/web/components/ui/button.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
-    size?: "default" | "icon" | "sm" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;

package/dist/src/presentation/web/hooks/use-agent-events.d.ts

@@ -0,0 +1,12 @@
+import type { NotificationEvent } from '../../../../packages/core/src/domain/generated/output.js';
+export type ConnectionStatus = 'connected' | 'connecting' | 'disconnected';
+export interface UseAgentEventsOptions {
+    runId?: string;
+}
+export interface UseAgentEventsResult {
+    events: NotificationEvent[];
+    lastEvent: NotificationEvent | null;
+    connectionStatus: ConnectionStatus;
+}
+export declare function useAgentEvents(options?: UseAgentEventsOptions): UseAgentEventsResult;
+//# sourceMappingURL=use-agent-events.d.ts.map

package/dist/src/presentation/web/hooks/use-agent-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-events.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-agent-events.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAKD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,CAkEpF"}

package/dist/src/presentation/web/hooks/use-agent-events.js

@@ -0,0 +1,58 @@
+'use client';
+import { useCallback, useEffect, useRef, useState } from 'react';
+const BASE_BACKOFF_MS = 1000;
+const MAX_BACKOFF_MS = 30_000;
+export function useAgentEvents(options) {
+    const [events, setEvents] = useState([]);
+    const [lastEvent, setLastEvent] = useState(null);
+    const [connectionStatus, setConnectionStatus] = useState('disconnected');
+    const backoffRef = useRef(BASE_BACKOFF_MS);
+    const reconnectTimerRef = useRef(null);
+    const esRef = useRef(null);
+    const runId = options?.runId;
+    const connect = useCallback(() => {
+        if (typeof window === 'undefined' || typeof EventSource === 'undefined') {
+            return;
+        }
+        const url = runId
+            ? `/api/agent-events?runId=${encodeURIComponent(runId)}`
+            : '/api/agent-events';
+        const es = new EventSource(url);
+        esRef.current = es;
+        setConnectionStatus('connecting');
+        es.onopen = () => {
+            setConnectionStatus('connected');
+            backoffRef.current = BASE_BACKOFF_MS;
+        };
+        es.onerror = () => {
+            es.close();
+            esRef.current = null;
+            setConnectionStatus('disconnected');
+            const delay = backoffRef.current;
+            backoffRef.current = Math.min(delay * 2, MAX_BACKOFF_MS);
+            reconnectTimerRef.current = setTimeout(() => {
+                reconnectTimerRef.current = null;
+                connect();
+            }, delay);
+        };
+        es.addEventListener('notification', ((event) => {
+            const parsed = JSON.parse(event.data);
+            setEvents((prev) => [...prev, parsed]);
+            setLastEvent(parsed);
+        }));
+    }, [runId]);
+    useEffect(() => {
+        connect();
+        return () => {
+            if (reconnectTimerRef.current !== null) {
+                clearTimeout(reconnectTimerRef.current);
+                reconnectTimerRef.current = null;
+            }
+            if (esRef.current) {
+                esRef.current.close();
+                esRef.current = null;
+            }
+        };
+    }, [connect]);
+    return { events, lastEvent, connectionStatus };
+}

package/dist/src/presentation/web/hooks/use-notifications.d.ts

@@ -0,0 +1,10 @@
+export interface UseNotificationsOptions {
+    browserEnabled?: boolean;
+    runId?: string;
+}
+export interface UseNotificationsResult {
+    requestBrowserPermission: () => Promise<void>;
+    browserPermissionState: NotificationPermission;
+}
+export declare function useNotifications(options?: UseNotificationsOptions): UseNotificationsResult;
+//# sourceMappingURL=use-notifications.d.ts.map

package/dist/src/presentation/web/hooks/use-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-notifications.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-notifications.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,wBAAwB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AAqBD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CAyC1F"}

package/dist/src/presentation/web/hooks/use-notifications.js

@@ -0,0 +1,57 @@
+'use client';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { toast } from 'sonner';
+import { NotificationSeverity } from '../../../../packages/core/src/domain/generated/output.js';
+import { useAgentEvents } from './use-agent-events.js';
+const SEVERITY_TO_TOAST = {
+    [NotificationSeverity.Success]: 'success',
+    [NotificationSeverity.Error]: 'error',
+    [NotificationSeverity.Warning]: 'warning',
+    [NotificationSeverity.Info]: 'info',
+};
+function dispatchToast(event) {
+    const method = SEVERITY_TO_TOAST[event.severity] ?? 'info';
+    toast[method](event.featureName, { description: event.message });
+}
+function dispatchBrowserNotification(event) {
+    if (globalThis.Notification?.permission !== 'granted') {
+        return;
+    }
+    new Notification(event.featureName, { body: event.message });
+}
+export function useNotifications(options) {
+    const browserEnabled = options?.browserEnabled ?? false;
+    const { lastEvent } = useAgentEvents({ runId: options?.runId });
+    const [browserPermissionState, setBrowserPermissionState] = useState(() => {
+        if (typeof globalThis.Notification === 'undefined')
+            return 'default';
+        return globalThis.Notification.permission;
+    });
+    // Track which events we've already dispatched to avoid re-dispatching on re-render
+    const processedRef = useRef(new Set());
+    useEffect(() => {
+        if (!lastEvent)
+            return;
+        // Create a key for deduplication
+        const key = `${lastEvent.agentRunId}-${lastEvent.eventType}-${lastEvent.timestamp}`;
+        if (processedRef.current.has(key))
+            return;
+        processedRef.current.add(key);
+        // Always dispatch toast
+        dispatchToast(lastEvent);
+        // Dispatch browser notification if enabled and permitted
+        if (browserEnabled) {
+            dispatchBrowserNotification(lastEvent);
+        }
+    }, [lastEvent, browserEnabled]);
+    const requestBrowserPermission = useCallback(async () => {
+        if (typeof globalThis.Notification === 'undefined')
+            return;
+        const result = await globalThis.Notification.requestPermission();
+        setBrowserPermissionState(result);
+    }, []);
+    return {
+        requestBrowserPermission,
+        browserPermissionState,
+    };
+}

package/dist/src/presentation/web/hooks/use-notifications.stories.d.ts

@@ -0,0 +1,6 @@
+import type { Meta, StoryObj } from '@storybook/react';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Default: Story;
+//# sourceMappingURL=use-notifications.stories.d.ts.map

package/dist/src/presentation/web/hooks/use-notifications.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-notifications.stories.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-notifications.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAwIvD,QAAA,MAAM,IAAI,EAAE,IAcX,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC;AAEtB,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC"}

package/dist/src/presentation/web/hooks/use-notifications.stories.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from 'react';
+import { toast } from 'sonner';
+import { Toaster } from '../components/ui/sonner.js';
+import { Button } from '../components/ui/button.js';
+function simulateNotification(event) {
+    const method = event.severity ?? 'info';
+    toast[method](event.featureName, { description: event.message });
+    if (globalThis.Notification?.permission === 'granted') {
+        new Notification(event.featureName, { body: event.message });
+    }
+}
+function NotificationDemo() {
+    const [browserPermission, setBrowserPermission] = useState(typeof globalThis.Notification !== 'undefined' ? globalThis.Notification.permission : 'default');
+    const requestPermission = async () => {
+        if (typeof globalThis.Notification === 'undefined')
+            return;
+        const result = await globalThis.Notification.requestPermission();
+        setBrowserPermission(result);
+    };
+    return (_jsxs("div", { className: "flex w-[420px] flex-col gap-6", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h3", { className: "text-sm font-semibold", children: "Browser Notification Permission" }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsxs("span", { className: "text-muted-foreground text-sm", children: ["Status: ", _jsx("code", { className: "bg-muted rounded px-1.5 py-0.5", children: browserPermission })] }), _jsx(Button, { size: "sm", variant: "outline", onClick: requestPermission, children: "Request Permission" })] })] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h3", { className: "text-sm font-semibold", children: "Simulate Notification Events" }), _jsx("p", { className: "text-muted-foreground text-xs", children: "Click a button to fire a toast and browser notification." }), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { size: "sm", variant: "outline", onClick: () => simulateNotification({
+                                    eventType: 'agent_started',
+                                    severity: 'info',
+                                    featureName: 'Auth Module',
+                                    message: 'Agent started running',
+                                }), children: "Agent Started" }), _jsx(Button, { size: "sm", variant: "outline", onClick: () => simulateNotification({
+                                    eventType: 'phase_completed',
+                                    severity: 'info',
+                                    featureName: 'Auth Module',
+                                    message: 'Completed analyze phase',
+                                    phaseName: 'analyze',
+                                }), children: "Phase Completed" }), _jsx(Button, { size: "sm", variant: "secondary", onClick: () => simulateNotification({
+                                    eventType: 'waiting_approval',
+                                    severity: 'warning',
+                                    featureName: 'Auth Module',
+                                    message: 'Waiting for user approval',
+                                }), children: "Waiting Approval" }), _jsx(Button, { size: "sm", onClick: () => simulateNotification({
+                                    eventType: 'agent_completed',
+                                    severity: 'success',
+                                    featureName: 'Auth Module',
+                                    message: 'Agent completed successfully',
+                                }), children: "Agent Completed" }), _jsx(Button, { size: "sm", variant: "destructive", onClick: () => simulateNotification({
+                                    eventType: 'agent_failed',
+                                    severity: 'error',
+                                    featureName: 'Auth Module',
+                                    message: 'Agent failed: token refresh error',
+                                }), children: "Agent Failed" })] })] })] }));
+}
+const meta = {
+    title: 'Hooks/useNotifications',
+    parameters: {
+        layout: 'centered',
+    },
+    tags: ['autodocs'],
+    decorators: [
+        (Story) => (_jsxs(_Fragment, { children: [_jsx(Story, {}), _jsx(Toaster, {})] })),
+    ],
+};
+export default meta;
+export const Default = {
+    render: () => _jsx(NotificationDemo, {}),
+};