popeye-cli 1.0.0 → 1.1.0

package/dist/workflow/ui-verification.d.ts

@@ -0,0 +1,114 @@
+/**
+ * UI/UX Verification Module
+ * Verifies visual design, responsiveness, and accessibility
+ *
+ * FUTURE IMPLEMENTATION - Requires:
+ * - Puppeteer/Playwright for screenshots
+ * - Visual regression testing
+ * - Accessibility testing (axe-core)
+ */
+/**
+ * UI Design Specification
+ * User should provide this before project generation
+ */
+export interface UIDesignSpec {
+    /** Design system to use */
+    designSystem: 'tailwind' | 'shadcn' | 'mui' | 'chakra' | 'custom';
+    /** Color palette */
+    colors: {
+        primary: string;
+        secondary: string;
+        accent: string;
+        background: string;
+        text: string;
+        error: string;
+        success: string;
+        warning: string;
+    };
+    /** Typography */
+    typography: {
+        fontFamily: string;
+        headingFont?: string;
+        baseSize: string;
+    };
+    /** Spacing scale */
+    spacing: 'compact' | 'comfortable' | 'spacious';
+    /** Border radius */
+    borderRadius: 'none' | 'small' | 'medium' | 'large' | 'full';
+    /** Dark mode support */
+    darkMode: boolean;
+    /** Responsive breakpoints to test */
+    breakpoints: ('mobile' | 'tablet' | 'desktop' | 'wide')[];
+    /** Accessibility level */
+    accessibilityLevel: 'A' | 'AA' | 'AAA';
+}
+/**
+ * Default design spec for when user doesn't provide one
+ */
+export declare const DEFAULT_DESIGN_SPEC: UIDesignSpec;
+/**
+ * UI Verification Result
+ */
+export interface UIVerificationResult {
+    passed: boolean;
+    category: string;
+    check: string;
+    message: string;
+    screenshot?: string;
+    severity: 'error' | 'warning' | 'info';
+}
+/**
+ * Generate Tailwind config from design spec
+ */
+export declare function generateTailwindConfig(spec: UIDesignSpec): string;
+/**
+ * Generate CSS variables from design spec
+ */
+export declare function generateCSSVariables(spec: UIDesignSpec): string;
+/**
+ * Component library setup instructions
+ */
+export declare const COMPONENT_LIBRARY_SETUP: Record<string, {
+    install: string;
+    setup: string;
+}>;
+/**
+ * Visual regression test configuration
+ * TODO: Implement with Playwright
+ */
+export interface VisualTestConfig {
+    /** Pages to test */
+    pages: Array<{
+        path: string;
+        name: string;
+        waitForSelector?: string;
+    }>;
+    /** Viewports to test */
+    viewports: Array<{
+        name: string;
+        width: number;
+        height: number;
+    }>;
+    /** Screenshot comparison threshold */
+    threshold: number;
+}
+/**
+ * Default visual test configuration
+ */
+export declare const DEFAULT_VISUAL_TEST_CONFIG: VisualTestConfig;
+/**
+ * Accessibility checks to perform
+ * TODO: Implement with axe-core
+ */
+export declare const ACCESSIBILITY_CHECKS: string[];
+/**
+ * FUTURE: Run visual regression tests
+ * Requires Playwright installation
+ */
+export declare function runVisualTests(_projectDir: string, _config?: VisualTestConfig): Promise<UIVerificationResult[]>;
+/**
+ * FUTURE: Run accessibility tests
+ * Requires axe-core installation
+ */
+export declare function runAccessibilityTests(_projectDir: string, _level?: 'A' | 'AA' | 'AAA'): Promise<UIVerificationResult[]>;
+//# sourceMappingURL=ui-verification.d.ts.map

package/dist/workflow/ui-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-verification.d.ts","sourceRoot":"","sources":["../../src/workflow/ui-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,YAAY,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAElE,oBAAoB;IACpB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,iBAAiB;IACjB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,oBAAoB;IACpB,OAAO,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAEhD,oBAAoB;IACpB,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAE7D,wBAAwB;IACxB,QAAQ,EAAE,OAAO,CAAC;IAElB,qCAAqC;IACrC,WAAW,EAAE,CAAC,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC;IAE1D,0BAA0B;IAC1B,kBAAkB,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAqBjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA2CjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA8B/D;AAgDD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BtF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IAEH,wBAAwB;IACxB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAYxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAShC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAA6C,GACrD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiBjC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,GAAG,GAAG,IAAI,GAAG,KAAY,GAChC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjC"}

package/dist/workflow/ui-verification.js

@@ -0,0 +1,258 @@
+/**
+ * UI/UX Verification Module
+ * Verifies visual design, responsiveness, and accessibility
+ *
+ * FUTURE IMPLEMENTATION - Requires:
+ * - Puppeteer/Playwright for screenshots
+ * - Visual regression testing
+ * - Accessibility testing (axe-core)
+ */
+/**
+ * Default design spec for when user doesn't provide one
+ */
+export const DEFAULT_DESIGN_SPEC = {
+    designSystem: 'shadcn',
+    colors: {
+        primary: '#3b82f6', // Blue 500
+        secondary: '#6b7280', // Gray 500
+        accent: '#8b5cf6', // Violet 500
+        background: '#ffffff',
+        text: '#111827', // Gray 900
+        error: '#ef4444', // Red 500
+        success: '#22c55e', // Green 500
+        warning: '#f59e0b', // Amber 500
+    },
+    typography: {
+        fontFamily: 'Inter, system-ui, sans-serif',
+        baseSize: '16px',
+    },
+    spacing: 'comfortable',
+    borderRadius: 'medium',
+    darkMode: true,
+    breakpoints: ['mobile', 'tablet', 'desktop'],
+    accessibilityLevel: 'AA',
+};
+/**
+ * Generate Tailwind config from design spec
+ */
+export function generateTailwindConfig(spec) {
+    return `/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+  ],
+  darkMode: ${spec.darkMode ? "'class'" : 'false'},
+  theme: {
+    extend: {
+      colors: {
+        primary: {
+          DEFAULT: '${spec.colors.primary}',
+          50: '${lighten(spec.colors.primary, 0.9)}',
+          100: '${lighten(spec.colors.primary, 0.8)}',
+          200: '${lighten(spec.colors.primary, 0.6)}',
+          300: '${lighten(spec.colors.primary, 0.4)}',
+          400: '${lighten(spec.colors.primary, 0.2)}',
+          500: '${spec.colors.primary}',
+          600: '${darken(spec.colors.primary, 0.1)}',
+          700: '${darken(spec.colors.primary, 0.2)}',
+          800: '${darken(spec.colors.primary, 0.3)}',
+          900: '${darken(spec.colors.primary, 0.4)}',
+        },
+        secondary: {
+          DEFAULT: '${spec.colors.secondary}',
+        },
+        accent: {
+          DEFAULT: '${spec.colors.accent}',
+        },
+      },
+      fontFamily: {
+        sans: ['${spec.typography.fontFamily}'],
+        ${spec.typography.headingFont ? `heading: ['${spec.typography.headingFont}'],` : ''}
+      },
+      borderRadius: {
+        DEFAULT: '${getBorderRadius(spec.borderRadius)}',
+      },
+    },
+  },
+  plugins: [],
+}
+`;
+}
+/**
+ * Generate CSS variables from design spec
+ */
+export function generateCSSVariables(spec) {
+    return `:root {
+  /* Colors */
+  --color-primary: ${spec.colors.primary};
+  --color-secondary: ${spec.colors.secondary};
+  --color-accent: ${spec.colors.accent};
+  --color-background: ${spec.colors.background};
+  --color-text: ${spec.colors.text};
+  --color-error: ${spec.colors.error};
+  --color-success: ${spec.colors.success};
+  --color-warning: ${spec.colors.warning};
+
+  /* Typography */
+  --font-family: ${spec.typography.fontFamily};
+  --font-size-base: ${spec.typography.baseSize};
+
+  /* Spacing */
+  --spacing-unit: ${getSpacingUnit(spec.spacing)};
+
+  /* Border Radius */
+  --border-radius: ${getBorderRadius(spec.borderRadius)};
+}
+
+${spec.darkMode ? `
+.dark {
+  --color-background: #111827;
+  --color-text: #f9fafb;
+}
+` : ''}
+`;
+}
+/**
+ * Helper to lighten a hex color
+ */
+function lighten(hex, amount) {
+    const num = parseInt(hex.replace('#', ''), 16);
+    const r = Math.min(255, Math.floor((num >> 16) + (255 - (num >> 16)) * amount));
+    const g = Math.min(255, Math.floor(((num >> 8) & 0x00FF) + (255 - ((num >> 8) & 0x00FF)) * amount));
+    const b = Math.min(255, Math.floor((num & 0x0000FF) + (255 - (num & 0x0000FF)) * amount));
+    return `#${((r << 16) | (g << 8) | b).toString(16).padStart(6, '0')}`;
+}
+/**
+ * Helper to darken a hex color
+ */
+function darken(hex, amount) {
+    const num = parseInt(hex.replace('#', ''), 16);
+    const r = Math.max(0, Math.floor((num >> 16) * (1 - amount)));
+    const g = Math.max(0, Math.floor(((num >> 8) & 0x00FF) * (1 - amount)));
+    const b = Math.max(0, Math.floor((num & 0x0000FF) * (1 - amount)));
+    return `#${((r << 16) | (g << 8) | b).toString(16).padStart(6, '0')}`;
+}
+/**
+ * Get spacing unit based on preference
+ */
+function getSpacingUnit(spacing) {
+    switch (spacing) {
+        case 'compact': return '0.25rem';
+        case 'comfortable': return '0.5rem';
+        case 'spacious': return '0.75rem';
+    }
+}
+/**
+ * Get border radius based on preference
+ */
+function getBorderRadius(radius) {
+    switch (radius) {
+        case 'none': return '0';
+        case 'small': return '0.25rem';
+        case 'medium': return '0.5rem';
+        case 'large': return '1rem';
+        case 'full': return '9999px';
+    }
+}
+/**
+ * Component library setup instructions
+ */
+export const COMPONENT_LIBRARY_SETUP = {
+    shadcn: {
+        install: 'npx shadcn@latest init',
+        setup: `
+# After init, add components as needed:
+npx shadcn@latest add button
+npx shadcn@latest add card
+npx shadcn@latest add input
+npx shadcn@latest add dialog
+# etc.
+`,
+    },
+    mui: {
+        install: 'npm install @mui/material @emotion/react @emotion/styled',
+        setup: `
+// Wrap app in ThemeProvider
+import { ThemeProvider, createTheme } from '@mui/material/styles';
+const theme = createTheme({ /* your theme */ });
+`,
+    },
+    chakra: {
+        install: 'npm install @chakra-ui/react @emotion/react @emotion/styled framer-motion',
+        setup: `
+// Wrap app in ChakraProvider
+import { ChakraProvider } from '@chakra-ui/react';
+`,
+    },
+};
+/**
+ * Default visual test configuration
+ */
+export const DEFAULT_VISUAL_TEST_CONFIG = {
+    pages: [
+        { path: '/', name: 'home' },
+        { path: '/dashboard', name: 'dashboard' },
+        { path: '/board', name: 'board', waitForSelector: '[data-testid="kanban-board"]' },
+    ],
+    viewports: [
+        { name: 'mobile', width: 375, height: 667 },
+        { name: 'tablet', width: 768, height: 1024 },
+        { name: 'desktop', width: 1280, height: 800 },
+    ],
+    threshold: 0.1, // 10% difference allowed
+};
+/**
+ * Accessibility checks to perform
+ * TODO: Implement with axe-core
+ */
+export const ACCESSIBILITY_CHECKS = [
+    'color-contrast',
+    'aria-roles',
+    'keyboard-navigation',
+    'focus-indicators',
+    'alt-text',
+    'form-labels',
+    'heading-order',
+    'link-purpose',
+];
+/**
+ * FUTURE: Run visual regression tests
+ * Requires Playwright installation
+ */
+export async function runVisualTests(_projectDir, _config = DEFAULT_VISUAL_TEST_CONFIG) {
+    // TODO: Implement with Playwright
+    // 1. Start dev server
+    // 2. Navigate to each page
+    // 3. Take screenshots at each viewport
+    // 4. Compare with baseline (if exists)
+    // 5. Report differences
+    console.warn('[UI Verification] Visual testing not yet implemented - requires Playwright');
+    return [{
+            passed: true,
+            category: 'Visual',
+            check: 'Visual regression tests',
+            message: 'Visual testing not yet implemented',
+            severity: 'warning',
+        }];
+}
+/**
+ * FUTURE: Run accessibility tests
+ * Requires axe-core installation
+ */
+export async function runAccessibilityTests(_projectDir, _level = 'AA') {
+    // TODO: Implement with axe-core
+    // 1. Start dev server
+    // 2. Navigate to each page
+    // 3. Run axe-core analysis
+    // 4. Report violations
+    console.warn('[UI Verification] Accessibility testing not yet implemented - requires axe-core');
+    return [{
+            passed: true,
+            category: 'Accessibility',
+            check: 'WCAG compliance',
+            message: 'Accessibility testing not yet implemented',
+            severity: 'warning',
+        }];
+}
+//# sourceMappingURL=ui-verification.js.map

package/dist/workflow/ui-verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-verification.js","sourceRoot":"","sources":["../../src/workflow/ui-verification.ts"],"names":[],"mappings":"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"}

package/dist/workflow/workflow-logger.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Workflow Logger
+ * Provides persistent logging of all workflow stages for transparency and debugging
+ */
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    timestamp: string;
+    stage: WorkflowStage;
+    event: string;
+    message: string;
+    data?: Record<string, unknown>;
+    level: LogLevel;
+}
+/**
+ * Log levels for filtering and display
+ */
+export type LogLevel = 'info' | 'warn' | 'error' | 'success' | 'debug';
+/**
+ * Workflow stages for categorization
+ */
+export type WorkflowStage = 'init' | 'plan-generation' | 'plan-parsing' | 'consensus' | 'arbitration' | 'execution' | 'task' | 'milestone' | 'testing' | 'verification' | 'ui-design' | 'ui-setup' | 'completion';
+/**
+ * Workflow logger class that persists logs to the project's docs folder
+ */
+export declare class WorkflowLogger {
+    private projectDir;
+    private logFile;
+    private entries;
+    private initialized;
+    constructor(projectDir: string);
+    /**
+     * Initialize the logger and load existing entries
+     */
+    initialize(): Promise<void>;
+    /**
+     * Parse existing log entries from markdown file
+     */
+    private parseExistingLog;
+    /**
+     * Log an entry to the workflow log
+     */
+    log(stage: WorkflowStage, event: string, message: string, data?: Record<string, unknown>, level?: LogLevel): Promise<void>;
+    /**
+     * Log info message
+     */
+    info(stage: WorkflowStage, event: string, message: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Log warning message
+     */
+    warn(stage: WorkflowStage, event: string, message: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Log error message
+     */
+    error(stage: WorkflowStage, event: string, message: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Log success message
+     */
+    success(stage: WorkflowStage, event: string, message: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Log stage start
+     */
+    stageStart(stage: WorkflowStage, description: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Log stage completion
+     */
+    stageComplete(stage: WorkflowStage, description: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Log stage failure
+     */
+    stageFailed(stage: WorkflowStage, description: string, error: string, data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Persist log entries to file
+     */
+    private persist;
+    /**
+     * Format log entries as markdown
+     */
+    private formatMarkdown;
+    /**
+     * Get icon for log level
+     */
+    private getLevelIcon;
+    /**
+     * Get all log entries
+     */
+    getEntries(): LogEntry[];
+    /**
+     * Get entries for a specific stage
+     */
+    getEntriesForStage(stage: WorkflowStage): LogEntry[];
+    /**
+     * Get error entries
+     */
+    getErrors(): LogEntry[];
+    /**
+     * Clear the log (for testing or reset)
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Get or create a workflow logger for a project
+ */
+export declare function getWorkflowLogger(projectDir: string): WorkflowLogger;
+/**
+ * Quick logging functions for common use cases
+ */
+export declare function logWorkflowEvent(projectDir: string, stage: WorkflowStage, event: string, message: string, data?: Record<string, unknown>, level?: LogLevel): Promise<void>;
+//# sourceMappingURL=workflow-logger.d.ts.map

package/dist/workflow/workflow-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-logger.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-logger.ts"],"names":[],"mappings":"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"}