popeye-cli 1.4.6 → 1.5.0

package/dist/workflow/overview.js

@@ -0,0 +1,354 @@
+/**
+ * Project overview generator
+ * Provides a comprehensive view of project state, plan, and progress
+ * with analysis of issues and ability to fix them
+ */
+import path from 'node:path';
+import { loadProject, getProgress, storeUserDocs, storeBrandContext } from '../state/index.js';
+import { discoverProjectDocs, readProjectDocs, findBrandAssets, } from '../generators/website-context.js';
+import { updateWebsiteContent } from './website-updater.js';
+/**
+ * Generate a complete project overview from state
+ *
+ * @param projectDir - The project directory
+ * @returns Structured project overview with analysis
+ */
+export async function generateOverview(projectDir) {
+    const state = await loadProject(projectDir);
+    const progress = await getProgress(projectDir);
+    // Extract specification summary
+    const specSummary = extractSpecSummary(state);
+    const keyFeatures = extractKeyFeatures(state);
+    // Build milestone details
+    const milestones = state.milestones.map((m) => ({
+        name: m.name,
+        status: m.status,
+        taskCount: m.tasks.length,
+        completedTasks: m.tasks.filter((t) => t.status === 'complete').length,
+        tasks: m.tasks.map((t) => ({
+            name: t.name,
+            status: t.status,
+        })),
+    }));
+    // Extract user doc file names if available
+    const userDocs = state.userDocs
+        ? extractDocNames(state.userDocs)
+        : undefined;
+    // Check for available docs in CWD that haven't been discovered
+    const parentDir = path.dirname(projectDir);
+    const availableDocPaths = await discoverProjectDocs(parentDir);
+    const availableDocs = availableDocPaths.map((p) => path.basename(p));
+    // Run analysis to detect issues
+    const issues = analyzeProject(state, availableDocs, progress);
+    return {
+        name: state.name,
+        idea: state.idea,
+        language: state.language,
+        phase: state.phase,
+        status: state.status,
+        specification: {
+            summary: specSummary,
+            keyFeatures,
+        },
+        plan: {
+            totalMilestones: state.milestones.length,
+            totalTasks: state.milestones.reduce((sum, m) => sum + m.tasks.length, 0),
+            milestones,
+        },
+        progress: {
+            completedMilestones: progress.completedMilestones,
+            completedTasks: progress.completedTasks,
+            percentComplete: progress.percentComplete,
+        },
+        userDocs,
+        brandContext: state.brandContext,
+        issues,
+        availableDocs,
+    };
+}
+/**
+ * Fix detected issues by re-discovering docs and updating website content
+ *
+ * @param projectDir - The project directory
+ * @param onProgress - Optional progress callback
+ * @returns Fix result with summary of actions taken
+ */
+export async function fixOverviewIssues(projectDir, onProgress) {
+    const result = {
+        docsDiscovered: 0,
+        docsStored: false,
+        brandFound: false,
+        websiteUpdated: false,
+        messages: [],
+    };
+    let state = await loadProject(projectDir);
+    const parentDir = path.dirname(projectDir);
+    // Step 1: Re-discover project documentation
+    onProgress?.('Scanning for project documentation...');
+    const docPaths = await discoverProjectDocs(parentDir);
+    if (docPaths.length > 0) {
+        const userDocs = await readProjectDocs(docPaths);
+        state = await storeUserDocs(projectDir, userDocs);
+        result.docsDiscovered = docPaths.length;
+        result.docsStored = true;
+        const docNames = docPaths.map((p) => path.basename(p)).join(', ');
+        result.messages.push(`Discovered ${docPaths.length} doc(s): ${docNames}`);
+        onProgress?.(`Found ${docPaths.length} doc(s): ${docNames}`);
+    }
+    else {
+        result.messages.push('No project documentation found in parent directory');
+        onProgress?.('No project documentation found in parent directory');
+    }
+    // Step 2: Find brand assets
+    onProgress?.('Scanning for brand assets...');
+    const brandAssets = await findBrandAssets(parentDir);
+    if (brandAssets.logoPath) {
+        state = await storeBrandContext(projectDir, {
+            ...state.brandContext,
+            logoPath: brandAssets.logoPath,
+        });
+        result.brandFound = true;
+        result.messages.push(`Found logo: ${path.basename(brandAssets.logoPath)}`);
+        onProgress?.(`Found logo: ${path.basename(brandAssets.logoPath)}`);
+    }
+    // Extract primary/accent color from docs if not already set
+    // Use smart extraction: look for accent/primary CTA color tokens first,
+    // then fall back to brightness-filtered colors (skip very dark/light)
+    if (!state.brandContext?.primaryColor && state.userDocs) {
+        const accentMatch = state.userDocs.match(/accent[_-]?primary[^#]{0,40}(#[0-9a-fA-F]{6})/i)
+            || state.userDocs.match(/(?:primary\s+(?:brand\s+)?(?:accent|color|CTA))[^#]{0,40}(#[0-9a-fA-F]{6})/i);
+        const color = accentMatch ? accentMatch[1] : findBrightColor(state.userDocs);
+        if (color) {
+            state = await storeBrandContext(projectDir, {
+                ...state.brandContext,
+                primaryColor: color,
+            });
+            result.messages.push(`Extracted brand color: ${color}`);
+            onProgress?.(`Extracted brand color: ${color}`);
+        }
+    }
+    // Step 3: Update website content if applicable
+    const language = state.language;
+    if (language === 'website' || language === 'all' || language === 'fullstack') {
+        onProgress?.('Updating website content with discovered context...');
+        try {
+            await updateWebsiteContent(projectDir, state, language, onProgress);
+            result.websiteUpdated = true;
+            result.messages.push('Website content files updated with project context');
+        }
+        catch (err) {
+            result.messages.push(`Website update failed: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        }
+    }
+    // Summary
+    if (result.docsDiscovered === 0 && !result.brandFound) {
+        result.messages.push('Tip: Place project docs (spec, pricing, color-scheme, etc.) as .md files in the parent directory, then run /overview fix again');
+    }
+    return result;
+}
+/** Analyze project state and detect issues */
+function analyzeProject(state, availableDocs, progress) {
+    const issues = [];
+    const push = (severity, category, message, fix) => issues.push({ severity, category, message, fix });
+    if (!state.userDocs && availableDocs.length > 0) {
+        push('warning', 'docs', `Found ${availableDocs.length} doc(s) in CWD (${availableDocs.join(', ')}) but project has no user docs stored`, 'Run /overview fix to discover and apply project documentation');
+    }
+    if (!state.userDocs && availableDocs.length === 0) {
+        push('warning', 'docs', 'No project documentation found. Website will use generic placeholder content.', 'Add .md files (spec, pricing, brand, etc.) to the project parent directory, then run /overview fix');
+    }
+    if (progress.totalTasks > 0 && progress.totalTasks <= 3) {
+        push('warning', 'plan', `Project has only ${progress.totalTasks} task(s) - this may indicate an incomplete or oversimplified plan`, 'Consider resetting to plan phase with richer specification');
+    }
+    if (!state.brandContext?.primaryColor && !state.brandContext?.logoPath) {
+        push('warning', 'brand', 'No brand context (colors, logo) detected. Website uses default styling.', 'Add a color-scheme.md or logo file to the project parent directory, then run /overview fix');
+    }
+    if (state.specification) {
+        const specStart = state.specification.trim().slice(0, 200).toLowerCase();
+        const genericPats = ["here's a comprehensive", "here is a comprehensive",
+            "here's a detailed", "here is a detailed", 'based on your idea', 'based on the idea'];
+        if (genericPats.some((p) => specStart.includes(p))) {
+            push('warning', 'spec', 'Specification appears to be generic AI-generated content without project-specific documentation input', 'Add project docs to CWD and run /overview fix to re-enrich. For a full re-spec, reset to plan phase.');
+        }
+    }
+    const hasWebsite = state.language === 'website' || state.language === 'all' || state.language === 'fullstack';
+    if (hasWebsite && !state.userDocs && state.phase === 'complete') {
+        push('error', 'website', 'Project includes a website but was completed without any user documentation. Website likely has placeholder content.', 'Run /overview fix to discover docs and update website template files');
+    }
+    return issues;
+}
+/**
+ * Format a project overview for terminal display
+ *
+ * @param overview - The project overview to format
+ * @returns Formatted string for terminal output
+ */
+export function formatOverview(overview) {
+    const l = [''];
+    l.push(`  PROJECT OVERVIEW: ${overview.name}`);
+    l.push(`  ${'='.repeat(40 + overview.name.length)}`, '');
+    l.push(`  Language:  ${overview.language}`);
+    l.push(`  Phase:     ${overview.phase}`);
+    l.push(`  Status:    ${overview.status}`, '');
+    if (overview.specification.summary) {
+        l.push('  SPECIFICATION', `  ${overview.specification.summary}`);
+        if (overview.specification.keyFeatures.length > 0) {
+            l.push('', '  Key Features:');
+            for (const f of overview.specification.keyFeatures.slice(0, 8))
+                l.push(`    - ${f}`);
+        }
+        l.push('');
+    }
+    const barWidth = 30;
+    const filled = Math.round((overview.progress.percentComplete / 100) * barWidth);
+    const bar = `[${'='.repeat(filled)}${filled < barWidth ? '>' : ''}${' '.repeat(Math.max(0, barWidth - filled - 1))}]`;
+    l.push(`  Progress: ${bar} ${overview.progress.percentComplete}% (${overview.progress.completedTasks}/${overview.plan.totalTasks} tasks)`, '');
+    if (overview.plan.milestones.length > 0) {
+        l.push('  MILESTONES', `  ${'-'.repeat(50)}`);
+        for (const m of overview.plan.milestones) {
+            l.push(`  ${getStatusIcon(m.status)} ${m.name}  (${m.completedTasks}/${m.taskCount} tasks)`);
+            for (const t of m.tasks)
+                l.push(`      ${getStatusIcon(t.status)} ${t.name}`);
+            l.push('');
+        }
+    }
+    else {
+        l.push('  No milestones defined yet.', '');
+    }
+    if (overview.userDocs && overview.userDocs.length > 0) {
+        l.push('  DISCOVERED DOCS');
+        for (const doc of overview.userDocs)
+            l.push(`    - ${doc}`);
+        l.push('');
+    }
+    if (overview.brandContext) {
+        l.push('  BRAND CONTEXT');
+        if (overview.brandContext.primaryColor)
+            l.push(`    Primary Color: ${overview.brandContext.primaryColor}`);
+        if (overview.brandContext.logoPath)
+            l.push(`    Logo: ${path.basename(overview.brandContext.logoPath)}`);
+        l.push('');
+    }
+    if (overview.issues.length > 0) {
+        l.push('  ANALYSIS', `  ${'-'.repeat(50)}`);
+        for (const issue of overview.issues) {
+            const icon = issue.severity === 'error' ? '[!!]' : '[!]';
+            l.push(`  ${icon} ${issue.category.toUpperCase()}: ${issue.message}`);
+            if (issue.fix)
+                l.push(`       -> ${issue.fix}`);
+        }
+        l.push('');
+    }
+    if (overview.availableDocs.length > 0 && !overview.userDocs) {
+        l.push('  AVAILABLE DOCS (not yet imported)');
+        for (const doc of overview.availableDocs)
+            l.push(`    - ${doc}`);
+        l.push('');
+    }
+    if (overview.issues.length > 0) {
+        l.push('  Run /overview fix to auto-discover docs, detect brand assets, and update website content.', '');
+    }
+    return l.join('\n');
+}
+/**
+ * Extract a summary from the specification
+ */
+function extractSpecSummary(state) {
+    if (!state.specification)
+        return '';
+    const lines = state.specification.split('\n');
+    // Find first non-empty, non-heading line that isn't a generic AI preamble
+    const genericPrefixes = [
+        "here's a comprehensive",
+        "here is a comprehensive",
+        "here's a detailed",
+        'based on your idea',
+    ];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith('#') && trimmed.length > 20) {
+            const lower = trimmed.toLowerCase();
+            if (!genericPrefixes.some((p) => lower.startsWith(p))) {
+                return trimmed.slice(0, 500);
+            }
+        }
+    }
+    return state.specification.slice(0, 500);
+}
+/**
+ * Extract key features from specification
+ */
+function extractKeyFeatures(state) {
+    if (!state.specification)
+        return [];
+    const features = [];
+    const lines = state.specification.split('\n');
+    let inFeatures = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect feature section headers
+        if (/^#{1,3}\s*(core\s+)?features/i.test(trimmed)) {
+            inFeatures = true;
+            continue;
+        }
+        // Stop at next heading
+        if (inFeatures && /^#{1,3}\s/.test(trimmed) && !/feature/i.test(trimmed)) {
+            break;
+        }
+        // Collect bullet points in feature section
+        if (inFeatures && /^[-*+]\s+/.test(trimmed)) {
+            const feature = trimmed.replace(/^[-*+]\s+/, '').replace(/^\*\*(.+?)\*\*:?\s*/, '$1: ');
+            if (feature.length > 5) {
+                features.push(feature.slice(0, 100));
+            }
+        }
+    }
+    return features.slice(0, 10);
+}
+/**
+ * Extract doc file names from raw docs string
+ */
+function extractDocNames(rawDocs) {
+    const names = [];
+    const headerPattern = /^--- (.+) ---$/gm;
+    let match;
+    while ((match = headerPattern.exec(rawDocs)) !== null) {
+        names.push(match[1]);
+    }
+    return names;
+}
+/**
+ * Get a status icon for terminal display
+ */
+function getStatusIcon(status) {
+    switch (status) {
+        case 'complete':
+            return '[x]';
+        case 'in-progress':
+            return '[~]';
+        case 'failed':
+            return '[!]';
+        case 'paused':
+            return '[-]';
+        default:
+            return '[ ]';
+    }
+}
+/**
+ * Find first hex color that isn't very dark or very light
+ * Skips background/neutral colors to find a reasonable brand accent
+ */
+function findBrightColor(text) {
+    const allColors = [...text.matchAll(/#([0-9a-fA-F]{6})/g)];
+    for (const match of allColors) {
+        const hex = match[1];
+        const r = parseInt(hex.substring(0, 2), 16);
+        const g = parseInt(hex.substring(2, 4), 16);
+        const b = parseInt(hex.substring(4, 6), 16);
+        const brightness = (r * 299 + g * 587 + b * 114) / 1000;
+        if (brightness > 60 && brightness < 210) {
+            return '#' + hex;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=overview.js.map

package/dist/workflow/overview.js.map

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

package/dist/workflow/plan-mode.d.ts

@@ -30,9 +30,10 @@ export interface PlanModeResult {
  * @param idea - The brief project idea
  * @param language - Target programming language
  * @param onProgress - Progress callback
+ * @param userDocs - Optional user documentation for context
  * @returns Expanded specification
  */
-export declare function expandIdea(idea: string, language: OutputLanguage, onProgress?: (message: string) => void): Promise<string>;
+export declare function expandIdea(idea: string, language: OutputLanguage, onProgress?: (message: string) => void, userDocs?: string): Promise<string>;
 /**
  * Create a development plan from a specification
  *

package/dist/workflow/plan-mode.d.ts.map

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

package/dist/workflow/plan-mode.js

@@ -7,21 +7,24 @@ import path from 'node:path';
 import { isWorkspace } from '../types/project.js';
 import { expandIdea as openaiExpandIdea } from '../adapters/openai.js';
 import { createPlan as claudeCreatePlan, analyzeCodebase } from '../adapters/claude.js';
-import { createProject, loadProject, setPhase, storePlan, storeSpecification, addMilestones, } from '../state/index.js';
+import { createProject, loadProject, setPhase, storePlan, storeSpecification, storeUserDocs, storeBrandContext, storeWebsiteStrategyPath, addMilestones, } from '../state/index.js';
+import { discoverProjectDocs, readProjectDocs, findBrandAssets, resolveBrandAssets, } from '../generators/website-context.js';
 import { iterateUntilConsensus } from './consensus.js';
 import { getWorkflowLogger } from './workflow-logger.js';
 import { designUI, saveUISpecification } from './ui-designer.js';
+import { generateWebsiteStrategy, formatStrategyForPlanContext, storeWebsiteStrategy, loadWebsiteStrategy, } from './website-strategy.js';
 /**
  * Expand a brief idea into a detailed specification
  *
  * @param idea - The brief project idea
  * @param language - Target programming language
  * @param onProgress - Progress callback
+ * @param userDocs - Optional user documentation for context
  * @returns Expanded specification
  */
-export async function expandIdea(idea, language, onProgress) {
+export async function expandIdea(idea, language, onProgress, userDocs) {
     onProgress?.('Expanding idea into specification...');
-    const specification = await openaiExpandIdea(idea, language);
+    const specification = await openaiExpandIdea(idea, language, userDocs);
     onProgress?.('Specification created');
     return specification;
 }
@@ -716,11 +719,31 @@ export async function runPlanMode(spec, options) {
                 language: state.language,
             });
         }
+        // Discover user documentation from the CWD (parent of project dir)
+        let userDocs = state.userDocs || '';
+        if (!userDocs) {
+            const parentDir = path.dirname(projectDir);
+            const docPaths = await discoverProjectDocs(parentDir);
+            if (docPaths.length > 0) {
+                userDocs = await readProjectDocs(docPaths);
+                onProgress?.('doc-discovery', `Found ${docPaths.length} project doc(s)`);
+                state = await storeUserDocs(projectDir, userDocs);
+                await logger.info('init', 'docs_found', `Found ${docPaths.length} project docs`, {
+                    docCount: docPaths.length,
+                    docPaths: docPaths.map((p) => path.basename(p)),
+                });
+            }
+            const brandAssets = await findBrandAssets(parentDir);
+            if (brandAssets.logoPath) {
+                state = await storeBrandContext(projectDir, { logoPath: brandAssets.logoPath });
+                onProgress?.('doc-discovery', `Found brand logo: ${path.basename(brandAssets.logoPath)}`);
+            }
+        }
         // Expand idea if we don't have a specification
         if (!state.specification) {
             onProgress?.('expand-idea', 'Expanding idea into specification...');
             await logger.stageStart('plan-generation', 'Expanding idea into specification');
-            const specification = await expandIdea(spec.idea, spec.language, (msg) => onProgress?.('expand-idea', msg));
+            const specification = await expandIdea(spec.idea, spec.language, (msg) => onProgress?.('expand-idea', msg), userDocs || undefined);
             state = await storeSpecification(projectDir, specification);
             onProgress?.('expand-idea', 'Specification complete');
             await logger.stageComplete('plan-generation', 'Specification created', {
@@ -747,6 +770,47 @@ export async function runPlanMode(spec, options) {
                 error: uiError instanceof Error ? uiError.message : 'Unknown error',
             });
         }
+        // Generate website strategy for website projects (after spec, before plan)
+        const isWebsiteProject = spec.language === 'website' || spec.language === 'all';
+        let websiteStrategy;
+        if (isWebsiteProject && state.specification) {
+            try {
+                onProgress?.('get-context', 'Generating website marketing strategy...');
+                await logger.stageStart('website-strategy', 'Generating website marketing strategy');
+                const parentDir = path.dirname(projectDir);
+                const brandAssets = await resolveBrandAssets(parentDir, state.brandContext);
+                const strategyInput = {
+                    productContext: (userDocs || '') + '\n\n' + (state.specification || ''),
+                    projectName: spec.name || state.name,
+                    brandAssets,
+                };
+                // Check for cached strategy
+                const cached = await loadWebsiteStrategy(projectDir);
+                if (cached) {
+                    websiteStrategy = cached.strategy;
+                    onProgress?.('get-context', `Loaded cached strategy: ${cached.strategy.siteArchitecture.pages.length} pages`);
+                }
+                else {
+                    const result = await generateWebsiteStrategy(strategyInput, (msg) => onProgress?.('get-context', msg));
+                    websiteStrategy = result.strategy;
+                    await storeWebsiteStrategy(projectDir, result.strategy, result.metadata);
+                    state = await storeWebsiteStrategyPath(projectDir, '.popeye/website-strategy.json');
+                    onProgress?.('get-context', `Strategy: ${result.strategy.siteArchitecture.pages.length} pages, ` +
+                        `${result.strategy.seoStrategy.primaryKeywords.length} keywords`);
+                }
+                await logger.stageComplete('website-strategy', 'Website strategy generated', {
+                    pageCount: websiteStrategy.siteArchitecture.pages.length,
+                    keywordCount: websiteStrategy.seoStrategy.primaryKeywords.length,
+                });
+            }
+            catch (strategyError) {
+                // Non-blocking: strategy generation failure should not stop the workflow
+                onProgress?.('get-context', `Website strategy skipped: ${strategyError instanceof Error ? strategyError.message : 'Unknown error'}`);
+                await logger.warn('website-strategy', 'strategy_skipped', 'Website strategy was skipped', {
+                    error: strategyError instanceof Error ? strategyError.message : 'Unknown error',
+                });
+            }
+        }
         // Get project context
         onProgress?.('get-context', 'Gathering project context...');
         let context = await getProjectContext(projectDir, (msg) => onProgress?.('get-context', msg));
@@ -755,6 +819,11 @@ export async function runPlanMode(spec, options) {
             onProgress?.('get-context', 'Incorporating additional guidance...');
             context = `${context}\n\nADDITIONAL GUIDANCE FROM USER:\n${additionalContext}`;
         }
+        // Inject website strategy as a separate context block (not appended to specification)
+        if (websiteStrategy) {
+            const strategyContext = formatStrategyForPlanContext(websiteStrategy);
+            context = `${context}\n\n## WEBSITE STRATEGY (authoritative reference)\n${strategyContext}`;
+        }
         // Create initial plan if we don't have one
         if (!state.plan) {
             onProgress?.('create-plan', 'Creating development plan...');
@@ -789,9 +858,18 @@ export async function runPlanMode(spec, options) {
         // Run consensus loop
         onProgress?.('consensus', 'Starting consensus review...');
         await logger.stageStart('consensus', 'Starting consensus review process');
+        // Set marketing persona for website project reviews
+        const resolvedConsensusConfig = { ...consensusConfig };
+        if (isWebsiteProject && !resolvedConsensusConfig.reviewerPersona) {
+            resolvedConsensusConfig.reviewerPersona =
+                'a Senior Product Marketing Strategist, SEO expert, and Fullstack Web Architect. ' +
+                    'Evaluate for: conversion optimization, messaging clarity, SEO best practices ' +
+                    '(JSON-LD, heading hierarchy, meta tags), Lighthouse 95+ performance, WCAG 2.1 AA accessibility. ' +
+                    'Reject generic template structures. Every section must connect to real product capabilities.';
+        }
         const consensusResult = await iterateUntilConsensus(state.plan, context, {
             projectDir,
-            config: consensusConfig,
+            config: resolvedConsensusConfig,
             isFullstack: isWorkspace(spec.language),
             language: spec.language,
             onIteration: (iteration, result) => {