@shepai/cli 1.60.0 → 1.62.0

package/web/.next/standalone/src/presentation/web/.next/server/server-reference-manifest.json

@@ -1,6 +1,6 @@
 {
   "node": {
-    "005002b953331ef2b32b0ee2a29b030254fa27d4f8": {
+    "007a62721e1bc5362586b473fae8c3f95131819457": {
       "workers": {
         "app/_not-found/page": {
           "moduleId": 66973,
@@ -43,7 +43,7 @@
       "filename": "src/presentation/web/app/actions/pick-folder.ts",
       "exportedName": "pickFolder"
     },
-    "603678ffdda82d766bd57b7cf3a44583c6af1bd731": {
+    "6009aa3c55bba1ddde7b13bf164dcd3ca47c18796e": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -58,7 +58,7 @@
       "filename": "src/presentation/web/app/actions/approve-feature.ts",
       "exportedName": "approveFeature"
     },
-    "6088bf597ba6473c1afca4f0297666105be5a15c9e": {
+    "60cfc37a2191fd62989f5c7336084946887366097e": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -73,7 +73,7 @@
       "filename": "src/presentation/web/app/actions/reject-feature.ts",
       "exportedName": "rejectFeature"
     },
-    "40bc811484a5f239d58ee65a0bd59328811ff2b4e3": {
+    "4048eaf5f7609b4ef04f879498d18d73ca951fe1a6": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -88,7 +88,7 @@
       "filename": "src/presentation/web/app/actions/get-feature-artifact.ts",
       "exportedName": "getFeatureArtifact"
     },
-    "4007171cf7da2fd054e5e014401e5c9cc36635fd04": {
+    "40957ee941603cfc08dfa297df5bb4a4349446eae2": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -103,7 +103,7 @@
       "filename": "src/presentation/web/app/actions/get-research-artifact.ts",
       "exportedName": "getResearchArtifact"
     },
-    "00db78a75eeac6610a7482f83c2d6e9cf7821846dd": {
+    "00800d322465815891a1a89a535319abbc467a4764": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -118,7 +118,7 @@
       "filename": "src/presentation/web/app/actions/get-workflow-defaults.ts",
       "exportedName": "getWorkflowDefaults"
     },
-    "4090f202fed23dc9161fabe4c27979ced8bead4ba9": {
+    "40ccc596c8732aa1aea4988c8c4849c043d6e8cfd0": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -133,7 +133,7 @@
       "filename": "src/presentation/web/app/actions/get-merge-review-data.ts",
       "exportedName": "getMergeReviewData"
     },
-    "407d5afd78499db86e3eff56fdb63e778de00b36b1": {
+    "4061cc10691887f77f67e764939de05c9e670098a2": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -148,7 +148,7 @@
       "filename": "src/presentation/web/app/actions/open-ide.ts",
       "exportedName": "openIde"
     },
-    "409f8daa4548d14a38c6edfc3041836f18795b19d9": {
+    "40a654c23471f5749fd5a822bb7bde886b4a18803d": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -163,7 +163,7 @@
       "filename": "src/presentation/web/app/actions/open-shell.ts",
       "exportedName": "openShell"
     },
-    "406dc7ef8c8774e1e72b1453fc61d10d0c28e8c665": {
+    "4095e26b914b90885e19c106f328bf95e365943a01": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -178,7 +178,7 @@
       "filename": "src/presentation/web/app/actions/open-folder.ts",
       "exportedName": "openFolder"
     },
-    "402fada86fc26ca8ede1ba9c4c6b166807b445ec7e": {
+    "4028cbc8b7daaf40907e6b11b058b81357f988dce5": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -193,7 +193,7 @@
       "filename": "src/presentation/web/app/actions/create-feature.ts",
       "exportedName": "createFeature"
     },
-    "40d8a084578197cb61b49f374df7aebd4123184ee8": {
+    "40a5f2b9870c264affcc0afed840b19d7736760d09": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -208,7 +208,7 @@
       "filename": "src/presentation/web/app/actions/delete-feature.ts",
       "exportedName": "deleteFeature"
     },
-    "407df636fc8220cd03b329236c8672fe57a23588d7": {
+    "40ec31fc0e50addf6a63fe78fd2265089ea6fc2436": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -223,7 +223,7 @@
       "filename": "src/presentation/web/app/actions/add-repository.ts",
       "exportedName": "addRepository"
     },
-    "404d9996266111ff820086d49653feeaf03304d055": {
+    "40f152f20c14e3edf19b73729aad8232a78f9bddcd": {
       "workers": {
         "app/page": {
           "moduleId": 16555,
@@ -240,5 +240,5 @@
     }
   },
   "edge": {},
-  "encryptionKey": "BSWjcQYQYXudhnah0VC2q2mhJZ50qvsRRMCnweVbWwU="
+  "encryptionKey": "OdTyfJgxB9kSZVRPajI4sJD9Ig3KfcfHQ67zTSc0fRs="
 }

package/web/.next/standalone/src/presentation/web/components/common/action-button/action-button.stories.tsx

@@ -24,7 +24,7 @@ function noop() {
   // intentional no-op for stories
 }
 
-/** Default labeled button with outline variant. */
+/** Default labeled button with outline variant. Plays "click" sound on press. */
 export const Default: Story = {
   args: {
     onClick: noop,

package/web/.next/standalone/src/presentation/web/components/common/action-button/action-button.tsx

@@ -4,6 +4,7 @@ import type { LucideIcon } from 'lucide-react';
 import { Loader2, CircleAlert } from 'lucide-react';
 import { cn } from '@/lib/utils';
 import { Button } from '@/components/ui/button';
+import { useSoundAction } from '@/hooks/use-sound-action';
 
 export interface ActionButtonProps {
   label: string;
@@ -29,13 +30,20 @@ export function ActionButton({
   variant = 'outline',
   size = 'sm',
 }: ActionButtonProps) {
+  const clickSound = useSoundAction('click');
+
+  const handleClick = () => {
+    clickSound.play();
+    onClick();
+  };
+
   return (
     <Button
       variant={variant}
       size={size}
       aria-label={label}
       disabled={loading}
-      onClick={onClick}
+      onClick={handleClick}
       className={cn(
         'gap-1.5',
         error && 'text-destructive hover:text-destructive',

package/web/.next/standalone/src/presentation/web/components/common/drawer-action-bar/drawer-action-bar.stories.tsx

@@ -0,0 +1,82 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { fn } from '@storybook/test';
+import { Check } from 'lucide-react';
+import { DrawerActionBar } from './drawer-action-bar';
+
+const meta: Meta<typeof DrawerActionBar> = {
+  title: 'Composed/DrawerActionBar',
+  component: DrawerActionBar,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'centered',
+  },
+  args: {
+    onApprove: fn().mockName('onApprove'),
+    approveLabel: 'Approve',
+  },
+  decorators: [
+    (Story) => (
+      <div className="w-[400px] rounded-md border">
+        <Story />
+      </div>
+    ),
+  ],
+};
+
+export default meta;
+type Story = StoryObj<typeof DrawerActionBar>;
+
+/** Default — approve button only. Plays "approve" sound on click. */
+export const Default: Story = {};
+
+/** With approve icon. */
+export const WithIcon: Story = {
+  args: {
+    approveLabel: 'Approve PRD',
+    approveIcon: <Check className="mr-1.5 h-4 w-4" />,
+  },
+};
+
+/** With reject button. Plays "reject" sound on reject click, "approve" on approve. */
+export const WithReject: Story = {
+  args: {
+    onReject: fn().mockName('onReject'),
+    approveLabel: 'Approve',
+  },
+};
+
+/** Processing state — buttons disabled, no sounds play. */
+export const Processing: Story = {
+  args: {
+    onReject: fn().mockName('onReject'),
+    approveLabel: 'Approve',
+    isProcessing: true,
+  },
+};
+
+/** Rejecting state — buttons disabled. */
+export const Rejecting: Story = {
+  args: {
+    onReject: fn().mockName('onReject'),
+    approveLabel: 'Approve',
+    isRejecting: true,
+  },
+};
+
+/** With revision input and reject button. */
+export const WithRevisionInput: Story = {
+  args: {
+    onReject: fn().mockName('onReject'),
+    approveLabel: 'Approve',
+    revisionPlaceholder: 'Ask AI to revise the plan...',
+  },
+};
+
+/** Custom reject dialog title. */
+export const CustomRejectTitle: Story = {
+  args: {
+    onReject: fn().mockName('onReject'),
+    approveLabel: 'Approve Plan',
+    rejectDialogTitle: 'Reject Plan',
+  },
+};

package/web/.next/standalone/src/presentation/web/components/common/drawer-action-bar/drawer-action-bar.tsx

@@ -5,6 +5,7 @@ import { X } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { RejectFeedbackDialog } from '@/components/common/reject-feedback-dialog';
 import { DrawerRevisionInput } from '@/components/common/drawer-revision-input';
+import { useSoundAction } from '@/hooks/use-sound-action';
 import type { DrawerActionBarProps } from './drawer-action-bar-config';
 
 export function DrawerActionBar({
@@ -20,6 +21,8 @@ export function DrawerActionBar({
   children,
 }: DrawerActionBarProps) {
   const [rejectDialogOpen, setRejectDialogOpen] = useState(false);
+  const approveSound = useSoundAction('approve');
+  const rejectSound = useSoundAction('reject');
   const disabled = isProcessing || isRejecting;
 
   return (
@@ -40,7 +43,10 @@ export function DrawerActionBar({
               variant="outline"
               className="text-destructive hover:text-destructive"
               disabled={disabled}
-              onClick={() => setRejectDialogOpen(true)}
+              onClick={() => {
+                rejectSound.play();
+                setRejectDialogOpen(true);
+              }}
             >
               <X className="mr-1.5 h-4 w-4" />
               Reject
@@ -54,7 +60,15 @@ export function DrawerActionBar({
             />
           </>
         ) : null}
-        <Button type="button" className="flex-1" disabled={disabled} onClick={onApprove}>
+        <Button
+          type="button"
+          className="flex-1"
+          disabled={disabled}
+          onClick={() => {
+            approveSound.play();
+            onApprove();
+          }}
+        >
           {approveIcon}
           {approveLabel}
         </Button>

package/web/.next/standalone/src/presentation/web/components/common/feature-create-drawer/feature-create-drawer.tsx

@@ -14,6 +14,7 @@ import {
   CheckIcon,
 } from 'lucide-react';
 import { cn } from '@/lib/utils';
+import { useSoundAction } from '@/hooks/use-sound-action';
 import {
   Drawer,
   DrawerContent,
@@ -93,6 +94,9 @@ export function FeatureCreateDrawer({
   features,
   initialParentId,
 }: FeatureCreateDrawerProps) {
+  const drawerOpenSound = useSoundAction('drawer-open');
+  const drawerCloseSound = useSoundAction('drawer-close');
+  const createSound = useSoundAction('create');
   const defaultGates = workflowDefaults?.approvalGates ?? EMPTY_GATES;
   const defaultPush = workflowDefaults?.push ?? false;
   const defaultOpenPr = workflowDefaults?.openPr ?? false;
@@ -105,6 +109,13 @@ export function FeatureCreateDrawer({
   const [openPr, setOpenPr] = useState(defaultOpenPr);
   const [parentId, setParentId] = useState<string | undefined>(undefined);
 
+  // Play drawer-open sound when the drawer opens
+  useEffect(() => {
+    if (open) {
+      drawerOpenSound.play();
+    }
+  }, [open, drawerOpenSound]);
+
   // Sync state when workflowDefaults load asynchronously
   useEffect(() => {
     if (workflowDefaults) {
@@ -134,17 +145,19 @@ export function FeatureCreateDrawer({
   const handleOpenChange = useCallback(
     (nextOpen: boolean) => {
       if (!nextOpen) {
+        drawerCloseSound.play();
         resetForm();
         onClose();
       }
     },
-    [onClose, resetForm]
+    [onClose, resetForm, drawerCloseSound]
   );
 
   const handleSubmit = useCallback(
     (e: React.FormEvent) => {
       e.preventDefault();
       if (!name.trim()) return;
+      createSound.play();
       const trimmedDescription = description.trim() || undefined;
       onSubmit({
         name: name.trim(),
@@ -160,6 +173,7 @@ export function FeatureCreateDrawer({
         openPr,
         ...(parentId ? { parentId } : {}),
       });
+      resetForm();
     },
     [
       name,
@@ -171,6 +185,8 @@ export function FeatureCreateDrawer({
       push,
       openPr,
       parentId,
+      createSound,
+      resetForm,
     ]
   );
 
@@ -198,7 +214,10 @@ export function FeatureCreateDrawer({
         <button
           type="button"
           aria-label="Close"
-          onClick={onClose}
+          onClick={() => {
+            drawerCloseSound.play();
+            onClose();
+          }}
           className="ring-offset-background focus:ring-ring absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden"
         >
           <XIcon className="size-4" />
@@ -357,7 +376,14 @@ export function FeatureCreateDrawer({
         {/* Footer */}
         <Separator />
         <DrawerFooter className="flex-row justify-end gap-2">
-          <Button variant="outline" onClick={onClose} disabled={isSubmitting}>
+          <Button
+            variant="outline"
+            onClick={() => {
+              drawerCloseSound.play();
+              onClose();
+            }}
+            disabled={isSubmitting}
+          >
             Cancel
           </Button>
           <Button type="submit" form="create-feature-form" disabled={!name.trim() || isSubmitting}>

package/web/.next/standalone/src/presentation/web/components/common/feature-drawer/feature-drawer.tsx

@@ -3,6 +3,7 @@
 import { XIcon, Loader2, Trash2, ExternalLink, GitCommitHorizontal } from 'lucide-react';
 import { PrStatus } from '@shepai/core/domain/generated/output';
 import { cn } from '@/lib/utils';
+import { useSoundAction } from '@/hooks/use-sound-action';
 import { OpenActionMenu } from '@/components/common/open-action-menu';
 import {
   Drawer,
@@ -44,6 +45,9 @@ export function FeatureDrawer({
   onDelete,
   isDeleting = false,
 }: FeatureDrawerProps) {
+  const drawerOpenSound = useSoundAction('drawer-open');
+  const drawerCloseSound = useSoundAction('drawer-close');
+
   return (
     <Drawer
       direction="right"
@@ -51,7 +55,12 @@ export function FeatureDrawer({
       handleOnly
       open={selectedNode !== null}
       onOpenChange={(open) => {
-        if (!open) onClose();
+        if (open) {
+          drawerOpenSound.play();
+        } else {
+          drawerCloseSound.play();
+          onClose();
+        }
       }}
     >
       <DrawerContent direction="right" className="w-96" showCloseButton={false}>
@@ -61,7 +70,10 @@ export function FeatureDrawer({
             <button
               type="button"
               aria-label="Close"
-              onClick={onClose}
+              onClick={() => {
+                drawerCloseSound.play();
+                onClose();
+              }}
               className="ring-offset-background focus:ring-ring absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden"
             >
               <XIcon className="size-4" />

package/web/.next/standalone/src/presentation/web/components/common/prd-questionnaire/prd-questionnaire.stories.tsx

@@ -194,7 +194,7 @@ const mockData: PrdQuestionnaireData = {
   finalAction: mockFinalAction,
 };
 
-/** Default state — first step shown, no selections. Click options to auto-advance. */
+/** Default state — first step shown, no selections. Click options to auto-advance. Plays "select" on option click, "navigate" on step/nav buttons. */
 export const Default: Story = {
   render: () => <InteractiveQuestionnaire data={mockData} />,
 };

package/web/.next/standalone/src/presentation/web/components/common/prd-questionnaire/prd-questionnaire.tsx

@@ -6,6 +6,7 @@ import { cn } from '@/lib/utils';
 import { Button } from '@/components/ui/button';
 import { Badge } from '@/components/ui/badge';
 import { DrawerActionBar } from '@/components/common/drawer-action-bar';
+import { useSoundAction } from '@/hooks/use-sound-action';
 import type { PrdQuestionnaireProps } from './prd-questionnaire-config';
 
 export function PrdQuestionnaire({
@@ -20,6 +21,8 @@ export function PrdQuestionnaire({
 }: PrdQuestionnaireProps) {
   const { question, context, questions, finalAction } = data;
   const [currentStep, setCurrentStep] = useState(0);
+  const selectSound = useSoundAction('select');
+  const navigateSound = useSoundAction('navigate');
 
   const total = questions.length;
   const isFirstStep = currentStep === 0;
@@ -30,13 +33,14 @@ export function PrdQuestionnaire({
 
   const handleSelect = useCallback(
     (questionId: string, optionId: string) => {
+      selectSound.play();
       onSelect(questionId, optionId);
       // Auto-advance to the next step after selection (unless last step)
       if (!isLastStep) {
         setTimeout(() => setCurrentStep((s) => s + 1), 250);
       }
     },
-    [onSelect, isLastStep]
+    [onSelect, isLastStep, selectSound]
   );
 
   if (total === 0) return null;
@@ -73,7 +77,10 @@ export function PrdQuestionnaire({
                     idx !== currentStep && selections[q.id] ? 'bg-primary/50' : '',
                     idx !== currentStep && !selections[q.id] ? 'bg-muted-foreground/25' : ''
                   )}
-                  onClick={() => setCurrentStep(idx)}
+                  onClick={() => {
+                    navigateSound.play();
+                    setCurrentStep(idx);
+                  }}
                 />
               ))}
             </div>
@@ -129,7 +136,10 @@ export function PrdQuestionnaire({
             variant="ghost"
             size="sm"
             disabled={isFirstStep || isProcessing}
-            onClick={() => setCurrentStep((s) => s - 1)}
+            onClick={() => {
+              navigateSound.play();
+              setCurrentStep((s) => s - 1);
+            }}
           >
             <ChevronLeft className="mr-1 h-4 w-4" />
             Previous
@@ -141,7 +151,10 @@ export function PrdQuestionnaire({
               variant="ghost"
               size="sm"
               disabled={isProcessing}
-              onClick={() => setCurrentStep((s) => s + 1)}
+              onClick={() => {
+                navigateSound.play();
+                setCurrentStep((s) => s + 1);
+              }}
             >
               {selections[currentQuestion.id] ? 'Next' : 'Skip'}
               <ChevronRight className="ml-1 h-4 w-4" />

package/web/.next/standalone/src/presentation/web/components/common/sidebar-collapse-toggle/sidebar-collapse-toggle.stories.tsx

@@ -25,8 +25,10 @@ const meta: Meta<typeof SidebarCollapseToggle> = {
 export default meta;
 type Story = StoryObj<typeof meta>;
 
+/** Expanded state — clicking plays "collapse" sound. */
 export const Expanded: Story = {};
 
+/** Collapsed state — clicking plays "expand" sound. */
 export const Collapsed: Story = {
   decorators: [
     (Story) => (

package/web/.next/standalone/src/presentation/web/components/common/sidebar-collapse-toggle/sidebar-collapse-toggle.tsx

@@ -4,6 +4,7 @@ import { PanelLeft } from 'lucide-react';
 import { useSidebar } from '@/components/ui/sidebar';
 import { Button } from '@/components/ui/button';
 import { cn } from '@/lib/utils';
+import { useSoundAction } from '@/hooks/use-sound-action';
 
 export interface SidebarCollapseToggleProps {
   className?: string;
@@ -11,8 +12,20 @@ export interface SidebarCollapseToggleProps {
 
 export function SidebarCollapseToggle({ className }: SidebarCollapseToggleProps) {
   const { toggleSidebar, open } = useSidebar();
+  const expandSound = useSoundAction('expand');
+  const collapseSound = useSoundAction('collapse');
   const label = open ? 'Collapse sidebar' : 'Expand sidebar';
 
+  const handleClick = () => {
+    // Play sound based on current state (before toggle)
+    if (open) {
+      collapseSound.play();
+    } else {
+      expandSound.play();
+    }
+    toggleSidebar();
+  };
+
   return (
     <div className={cn('flex', className)}>
       <Button
@@ -20,7 +33,7 @@ export function SidebarCollapseToggle({ className }: SidebarCollapseToggleProps)
         variant="ghost"
         size="icon"
         className="size-7 cursor-pointer group-data-[collapsible=icon]:size-8!"
-        onClick={toggleSidebar}
+        onClick={handleClick}
         aria-label={label}
       >
         <PanelLeft className="size-4" />

package/web/.next/standalone/src/presentation/web/components/common/sidebar-nav-item/sidebar-nav-item.stories.tsx

@@ -24,6 +24,7 @@ const meta: Meta<typeof SidebarNavItem> = {
 export default meta;
 type Story = StoryObj<typeof meta>;
 
+/** Default — clicking plays "navigate" sound. */
 export const Default: Story = {
   args: {
     icon: Home,

package/web/.next/standalone/src/presentation/web/components/common/sidebar-nav-item/sidebar-nav-item.tsx

@@ -1,7 +1,10 @@
+'use client';
+
 import Link from 'next/link';
 import type { Route } from 'next';
 import type { LucideIcon } from 'lucide-react';
 import { SidebarMenuItem, SidebarMenuButton } from '@/components/ui/sidebar';
+import { useSoundAction } from '@/hooks/use-sound-action';
 
 export interface SidebarNavItemProps {
   icon: LucideIcon;
@@ -11,10 +14,12 @@ export interface SidebarNavItemProps {
 }
 
 export function SidebarNavItem({ icon: Icon, label, href, active = false }: SidebarNavItemProps) {
+  const navigateSound = useSoundAction('navigate');
+
   return (
     <SidebarMenuItem data-testid="sidebar-nav-item">
       <SidebarMenuButton asChild isActive={active} tooltip={label}>
-        <Link href={href as Route}>
+        <Link href={href as Route} onClick={() => navigateSound.play()}>
           <Icon />
           <span>{label}</span>
         </Link>

package/web/.next/standalone/src/presentation/web/components/common/tech-decisions-review/tech-decisions-review.stories.tsx

@@ -63,7 +63,7 @@ const meta: Meta<typeof TechDecisionsReview> = {
 export default meta;
 type Story = StoryObj<typeof TechDecisionsReview>;
 
-/** Default — scrollable list of decisions taken. */
+/** Default — scrollable list of decisions taken. "Other Options Considered" toggle plays expand/collapse sounds. */
 export const Default: Story = {
   args: {
     data: mockData,

package/web/.next/standalone/src/presentation/web/components/common/tech-decisions-review/tech-decisions-review.tsx

@@ -6,6 +6,7 @@ import Markdown from 'react-markdown';
 import { Check, ChevronRight, GitCompareArrows, Layers } from 'lucide-react';
 import { Badge } from '@/components/ui/badge';
 import { DrawerActionBar } from '@/components/common/drawer-action-bar';
+import { useSoundAction } from '@/hooks/use-sound-action';
 import type { TechDecisionsReviewProps, TechDecision } from './tech-decisions-review-config';
 
 const markdownComponents: Components = {
@@ -46,6 +47,18 @@ const markdownComponents: Components = {
 
 function DecisionCard({ decision, index }: { decision: TechDecision; index: number }) {
   const [alternativesOpen, setAlternativesOpen] = useState(false);
+  const expandSound = useSoundAction('expand');
+  const collapseSound = useSoundAction('collapse');
+
+  const handleToggleAlternatives = () => {
+    // Play sound based on current state (before toggle)
+    if (alternativesOpen) {
+      collapseSound.play();
+    } else {
+      expandSound.play();
+    }
+    setAlternativesOpen((prev) => !prev);
+  };
 
   return (
     <div className="border-border rounded-lg border">
@@ -82,7 +95,7 @@ function DecisionCard({ decision, index }: { decision: TechDecision; index: numb
         <div className="border-border border-t">
           <button
             type="button"
-            onClick={() => setAlternativesOpen((prev) => !prev)}
+            onClick={handleToggleAlternatives}
             className="text-muted-foreground hover:bg-muted/50 flex w-full items-center gap-1.5 px-4 py-3 text-xs font-medium transition-colors"
           >
             <ChevronRight

package/web/.next/standalone/src/presentation/web/components/common/theme-toggle/theme-toggle.stories.tsx

@@ -13,10 +13,12 @@ const meta: Meta<typeof ThemeToggle> = {
 export default meta;
 type Story = StoryObj<typeof meta>;
 
+/** Default — click to toggle theme. Plays toggle-on (dark) or toggle-off (light) sound. */
 export const Default: Story = {
   render: () => <ThemeToggle />,
 };
 
+/** In context with label. Sounds play on each toggle click. */
 export const InContext: Story = {
   render: () => (
     <div className="flex items-center gap-4 rounded-lg border p-4">