@shepai/cli 1.37.3 → 1.38.0

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

@@ -0,0 +1,111 @@
+'use client';
+
+import { useState } from 'react';
+import {
+  Code2,
+  Terminal,
+  FolderOpen,
+  ChevronDown,
+  Copy,
+  Check,
+  Loader2,
+  CircleAlert,
+} from 'lucide-react';
+import { Button } from '@/components/ui/button';
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from '@/components/ui/dropdown-menu';
+import type { OpenActionMenuProps } from './config';
+
+const COPY_FEEDBACK_DELAY = 2000;
+
+export function OpenActionMenu({ actions, repositoryPath, showSpecs }: OpenActionMenuProps) {
+  const [copied, setCopied] = useState(false);
+
+  const handleCopyPath = () => {
+    void navigator.clipboard.writeText(repositoryPath);
+    setCopied(true);
+    setTimeout(() => setCopied(false), COPY_FEEDBACK_DELAY);
+  };
+
+  const anyLoading = actions.ideLoading || actions.shellLoading || actions.specsLoading;
+  const anyError = actions.ideError ?? actions.shellError ?? actions.specsError;
+
+  return (
+    <DropdownMenu modal={false}>
+      <DropdownMenuTrigger asChild>
+        <Button variant="outline" size="sm" className="gap-1.5" disabled={anyLoading}>
+          {anyLoading ? (
+            <Loader2 className="size-4 animate-spin" />
+          ) : anyError ? (
+            <CircleAlert className="text-destructive size-4" />
+          ) : (
+            <FolderOpen className="size-4" />
+          )}
+          Open
+          <ChevronDown className="size-3 opacity-60" />
+        </Button>
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align="start" className="w-48">
+        <DropdownMenuLabel>Open in</DropdownMenuLabel>
+
+        <DropdownMenuItem
+          onClick={actions.openInIde}
+          disabled={actions.ideLoading}
+          className="gap-2"
+        >
+          {actions.ideLoading ? (
+            <Loader2 className="size-4 animate-spin" />
+          ) : actions.ideError ? (
+            <CircleAlert className="text-destructive size-4" />
+          ) : (
+            <Code2 className="size-4" />
+          )}
+          IDE
+        </DropdownMenuItem>
+
+        <DropdownMenuItem
+          onClick={actions.openInShell}
+          disabled={actions.shellLoading}
+          className="gap-2"
+        >
+          {actions.shellLoading ? (
+            <Loader2 className="size-4 animate-spin" />
+          ) : actions.shellError ? (
+            <CircleAlert className="text-destructive size-4" />
+          ) : (
+            <Terminal className="size-4" />
+          )}
+          Terminal
+        </DropdownMenuItem>
+
+        <DropdownMenuItem
+          onClick={actions.openSpecsFolder}
+          disabled={actions.specsLoading || !showSpecs}
+          className="gap-2"
+        >
+          {actions.specsLoading ? (
+            <Loader2 className="size-4 animate-spin" />
+          ) : actions.specsError ? (
+            <CircleAlert className="text-destructive size-4" />
+          ) : (
+            <FolderOpen className="size-4" />
+          )}
+          Specs Folder
+        </DropdownMenuItem>
+
+        <DropdownMenuSeparator />
+
+        <DropdownMenuItem onClick={handleCopyPath} className="gap-2">
+          {copied ? <Check className="size-4 text-green-600" /> : <Copy className="size-4" />}
+          {copied ? 'Copied!' : 'Copy path'}
+        </DropdownMenuItem>
+      </DropdownMenuContent>
+    </DropdownMenu>
+  );
+}

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

@@ -0,0 +1,10 @@
+export { PrdQuestionnaire } from './prd-questionnaire';
+export { PrdQuestionnaireDrawer } from './prd-questionnaire-drawer';
+export type {
+  PrdQuestionnaireProps,
+  PrdQuestionnaireDrawerProps,
+  PrdOption,
+  PrdQuestion,
+  PrdFinalAction,
+  PrdQuestionnaireData,
+} from './prd-questionnaire-config';

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

@@ -0,0 +1,48 @@
+import type {
+  PrdOption,
+  PrdQuestion,
+  PrdFinalAction,
+  PrdQuestionnaireData,
+} from '@shepai/core/domain/generated/output';
+
+export type { PrdOption, PrdQuestion, PrdFinalAction, PrdQuestionnaireData };
+
+export interface PrdQuestionnaireProps {
+  /** Questionnaire data from the domain (questions, context, finalAction) */
+  data: PrdQuestionnaireData;
+  /** Map of questionId to selected optionId (controlled state) */
+  selections: Record<string, string>;
+  /** Selection change callback */
+  onSelect: (questionId: string, optionId: string) => void;
+  /** Chat refinement submit callback */
+  onRefine: (text: string) => void;
+  /** Finalize requirements callback */
+  onApprove: (actionId: string) => void;
+  /** Controls disabled/animated state during refinement */
+  isProcessing?: boolean;
+  /** Show the goal/context header (default: false) */
+  showHeader?: boolean;
+}
+
+export interface PrdQuestionnaireDrawerProps extends PrdQuestionnaireProps {
+  /** Whether the drawer is open */
+  open: boolean;
+  /** Callback when drawer should close */
+  onClose: () => void;
+  /** Feature name shown in drawer header */
+  featureName: string;
+  /** Feature ID shown below the name */
+  featureId?: string;
+  /** Current lifecycle stage label */
+  lifecycleLabel?: string;
+  /** Absolute path to the repository on disk */
+  repositoryPath?: string;
+  /** Git branch name for this feature */
+  branch?: string;
+  /** Absolute path to the specs folder on disk */
+  specPath?: string;
+  /** Callback to delete the feature — shows delete button when provided */
+  onDelete?: (featureId: string) => void;
+  /** Whether a delete operation is in progress */
+  isDeleting?: boolean;
+}

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

@@ -0,0 +1,34 @@
+'use client';
+
+import { ReviewDrawerShell } from '@/components/common/review-drawer-shell';
+import { PrdQuestionnaire } from './prd-questionnaire';
+import type { PrdQuestionnaireDrawerProps } from './prd-questionnaire-config';
+
+export function PrdQuestionnaireDrawer({
+  open,
+  onClose,
+  featureName,
+  featureId,
+  repositoryPath,
+  branch,
+  specPath,
+  onDelete,
+  isDeleting,
+  ...questionnaireProps
+}: PrdQuestionnaireDrawerProps) {
+  return (
+    <ReviewDrawerShell
+      open={open}
+      onClose={onClose}
+      featureName={featureName}
+      featureId={featureId}
+      repositoryPath={repositoryPath}
+      branch={branch}
+      specPath={specPath}
+      onDelete={onDelete}
+      isDeleting={isDeleting}
+    >
+      <PrdQuestionnaire {...questionnaireProps} />
+    </ReviewDrawerShell>
+  );
+}

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

@@ -0,0 +1,384 @@
+import { useState } from 'react';
+import type { Meta, StoryObj } from '@storybook/react';
+import { fn } from '@storybook/test';
+import { PrdQuestionnaire } from './prd-questionnaire';
+import { PrdQuestionnaireDrawer } from './prd-questionnaire-drawer';
+import type { PrdQuestionnaireData } from './prd-questionnaire-config';
+
+const mockQuestions: PrdQuestionnaireData['questions'] = [
+  {
+    id: 'problem',
+    question: 'What specific problem does this feature solve?',
+    type: 'select',
+    options: [
+      {
+        id: 'user_pain',
+        label: 'User Pain Point',
+        rationale: 'Addresses a recurring user complaint or friction',
+        recommended: true,
+      },
+      { id: 'market_gap', label: 'Market Gap', rationale: 'Fills a gap vs competitors' },
+      { id: 'tech_debt', label: 'Technical Debt', rationale: 'Reduces accumulated technical debt' },
+      {
+        id: 'compliance',
+        label: 'Compliance',
+        rationale: 'Meets regulatory or policy requirements',
+      },
+    ],
+  },
+  {
+    id: 'priority',
+    question: 'What is the business priority level?',
+    type: 'select',
+    options: [
+      { id: 'p0', label: 'P0 - Critical', rationale: 'Blocking issue, must fix immediately' },
+      { id: 'p1', label: 'P1 - High', rationale: 'Important for next release', recommended: true },
+      { id: 'p2', label: 'P2 - Medium', rationale: 'Nice to have, schedule when possible' },
+      { id: 'p3', label: 'P3 - Low', rationale: 'Backlog item, no urgency' },
+    ],
+  },
+  {
+    id: 'success',
+    question: 'What metrics define success?',
+    type: 'select',
+    options: [
+      {
+        id: 'adoption',
+        label: 'Adoption Rate',
+        rationale: 'Percentage of users who adopt the feature',
+        recommended: true,
+      },
+      {
+        id: 'performance',
+        label: 'Performance',
+        rationale: 'Latency, throughput, or resource improvements',
+      },
+      {
+        id: 'revenue',
+        label: 'Revenue Impact',
+        rationale: 'Direct or indirect revenue contribution',
+      },
+      {
+        id: 'satisfaction',
+        label: 'User Satisfaction',
+        rationale: 'NPS or CSAT score improvement',
+      },
+    ],
+  },
+  {
+    id: 'timeline',
+    question: 'What is the target timeline?',
+    type: 'select',
+    options: [
+      {
+        id: 'sprint',
+        label: 'This Sprint',
+        rationale: 'Deliverable within the current sprint',
+        recommended: true,
+      },
+      { id: 'quarter', label: 'This Quarter', rationale: 'Target completion within 3 months' },
+      { id: 'half', label: 'This Half', rationale: 'Target completion within 6 months' },
+      { id: 'year', label: 'This Year', rationale: 'Long-term initiative for the year' },
+    ],
+  },
+  {
+    id: 'scope',
+    question: 'What is the feature scope?',
+    type: 'select',
+    options: [
+      {
+        id: 'mvp',
+        label: 'MVP',
+        rationale: 'Minimum viable product — core functionality only',
+        recommended: true,
+      },
+      {
+        id: 'full',
+        label: 'Full Feature',
+        rationale: 'Complete feature with all planned capabilities',
+      },
+      { id: 'experiment', label: 'Experiment', rationale: 'A/B test or limited rollout' },
+      {
+        id: 'platform',
+        label: 'Platform',
+        rationale: 'Foundational work enabling future features',
+      },
+    ],
+  },
+  {
+    id: 'stakeholders',
+    question: 'Who are the primary stakeholders?',
+    type: 'select',
+    options: [
+      {
+        id: 'end_users',
+        label: 'End Users',
+        rationale: 'Direct users of the product',
+        recommended: true,
+      },
+      {
+        id: 'internal',
+        label: 'Internal Teams',
+        rationale: 'Engineering, product, or design teams',
+      },
+      {
+        id: 'enterprise',
+        label: 'Enterprise Clients',
+        rationale: 'B2B customers with specific needs',
+      },
+      {
+        id: 'partners',
+        label: 'Partners',
+        rationale: 'Third-party integrations or ecosystem partners',
+      },
+    ],
+  },
+];
+
+const mockFinalAction = {
+  id: 'approve-reqs',
+  label: 'Approve Requirements',
+  description: 'Finalize and lock the requirements for implementation',
+};
+
+/* ─── Interactive wrapper for stories ─── */
+
+function InteractiveQuestionnaire({
+  selections: initialSelections = {},
+  ...props
+}: Omit<
+  React.ComponentProps<typeof PrdQuestionnaire>,
+  'onSelect' | 'onRefine' | 'onApprove' | 'selections'
+> & { selections?: Record<string, string> }) {
+  const [selections, setSelections] = useState<Record<string, string>>(initialSelections);
+
+  return (
+    <PrdQuestionnaire
+      {...props}
+      selections={selections}
+      onSelect={(qId, optId) => setSelections((prev) => ({ ...prev, [qId]: optId }))}
+      onRefine={fn().mockName('onRefine')}
+      onApprove={fn().mockName('onApprove')}
+    />
+  );
+}
+
+/* ─── Standalone PrdQuestionnaire ─── */
+
+const meta: Meta<typeof PrdQuestionnaire> = {
+  title: 'Composed/PrdQuestionnaire',
+  component: PrdQuestionnaire,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'fullscreen',
+  },
+  argTypes: {
+    onSelect: { action: 'onSelect' },
+    onRefine: { action: 'onRefine' },
+    onApprove: { action: 'onApprove' },
+  },
+  decorators: [
+    (Story) => (
+      <div style={{ height: '600px', width: '400px', border: '1px solid var(--color-border)' }}>
+        <Story />
+      </div>
+    ),
+  ],
+};
+
+export default meta;
+type Story = StoryObj<typeof PrdQuestionnaire>;
+
+const mockData: PrdQuestionnaireData = {
+  question: 'Review Feature Requirements',
+  context:
+    'Please review the AI-generated requirements below. Select the best option for each question, or ask the AI to refine them.',
+  questions: mockQuestions,
+  finalAction: mockFinalAction,
+};
+
+/** Default state — first step shown, no selections. Click options to auto-advance. */
+export const Default: Story = {
+  render: () => <InteractiveQuestionnaire data={mockData} />,
+};
+
+/** Starting with partial selections — step dots reflect answered state. */
+export const WithSelections: Story = {
+  render: () => (
+    <InteractiveQuestionnaire
+      data={mockData}
+      selections={{
+        problem: 'user_pain',
+        priority: 'p1',
+        success: 'adoption',
+      }}
+    />
+  ),
+};
+
+/** All questions answered — last step shows Approve button enabled. */
+export const AllAnswered: Story = {
+  render: () => (
+    <InteractiveQuestionnaire
+      data={mockData}
+      selections={{
+        problem: 'user_pain',
+        priority: 'p1',
+        success: 'adoption',
+        timeline: 'sprint',
+        scope: 'mvp',
+        stakeholders: 'end_users',
+      }}
+    />
+  ),
+};
+
+/** Processing state — all inputs disabled, indeterminate progress bar. */
+export const Refining: Story = {
+  args: {
+    data: mockData,
+    selections: {
+      problem: 'user_pain',
+      priority: 'p1',
+    },
+    isProcessing: true,
+  },
+};
+
+/** Single question — minimal stepper with one step. */
+export const MinimalData: Story = {
+  render: () => (
+    <InteractiveQuestionnaire
+      data={{
+        question: 'Quick Check',
+        context: 'A simple yes/no decision.',
+        questions: [
+          {
+            id: 'confirm',
+            question: 'Should we proceed?',
+            type: 'select' as const,
+            options: [
+              {
+                id: 'yes',
+                label: 'Yes',
+                rationale: 'Proceed with implementation',
+                recommended: true,
+              },
+              { id: 'no', label: 'No', rationale: 'Go back and reconsider' },
+            ],
+          },
+        ],
+        finalAction: {
+          id: 'confirm-action',
+          label: 'Confirm',
+          description: 'Confirm the decision',
+        },
+      }}
+    />
+  ),
+};
+
+/* ─── Drawer Variant ─── */
+
+type DrawerStory = StoryObj<typeof PrdQuestionnaireDrawer>;
+
+const drawerMeta = {
+  title: 'Composed/PrdQuestionnaireDrawer',
+  component: PrdQuestionnaireDrawer,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'fullscreen',
+  },
+};
+
+function DrawerTemplate({
+  selections: initialSelections = {},
+  ...props
+}: Omit<
+  React.ComponentProps<typeof PrdQuestionnaireDrawer>,
+  'open' | 'onClose' | 'onSelect' | 'onRefine' | 'onApprove' | 'selections'
+> & { selections?: Record<string, string> }) {
+  const [open, setOpen] = useState(true);
+  const [selections, setSelections] = useState<Record<string, string>>(initialSelections);
+
+  return (
+    <div style={{ height: '100vh', background: '#f8fafc', padding: '2rem' }}>
+      <button
+        type="button"
+        onClick={() => setOpen(true)}
+        style={{ padding: '8px 16px', border: '1px solid #ccc', borderRadius: '6px' }}
+      >
+        Open Drawer
+      </button>
+      <PrdQuestionnaireDrawer
+        {...props}
+        open={open}
+        onClose={() => setOpen(false)}
+        selections={selections}
+        onSelect={(qId, optId) => setSelections((prev) => ({ ...prev, [qId]: optId }))}
+        onRefine={fn().mockName('onRefine')}
+        onApprove={fn().mockName('onApprove')}
+      />
+    </div>
+  );
+}
+
+/** Drawer with stepper — navigate questions one at a time. */
+export const InDrawer: DrawerStory = {
+  ...drawerMeta,
+  render: () => (
+    <DrawerTemplate
+      featureName="User Authentication Flow"
+      featureId="FEAT-042"
+      lifecycleLabel="Requirements"
+      data={mockData}
+    />
+  ),
+};
+
+/** Drawer with partial selections showing progress dots. */
+export const InDrawerWithSelections: DrawerStory = {
+  ...drawerMeta,
+  render: () => (
+    <DrawerTemplate
+      featureName="User Authentication Flow"
+      featureId="FEAT-042"
+      lifecycleLabel="Requirements"
+      data={mockData}
+      selections={{
+        problem: 'user_pain',
+        priority: 'p1',
+        success: 'adoption',
+      }}
+    />
+  ),
+};
+
+/** Drawer with delete button visible. */
+export const WithDeleteButton: DrawerStory = {
+  ...drawerMeta,
+  render: () => (
+    <DrawerTemplate
+      featureName="User Authentication Flow"
+      featureId="FEAT-042"
+      lifecycleLabel="Requirements"
+      data={mockData}
+      onDelete={fn().mockName('onDelete')}
+    />
+  ),
+};
+
+/** Drawer with delete in progress (button disabled). */
+export const DeletingState: DrawerStory = {
+  ...drawerMeta,
+  render: () => (
+    <DrawerTemplate
+      featureName="User Authentication Flow"
+      featureId="FEAT-042"
+      lifecycleLabel="Requirements"
+      data={mockData}
+      onDelete={fn().mockName('onDelete')}
+      isDeleting
+    />
+  ),
+};