popeye-cli 1.4.7 → 1.5.0

package/src/generators/website-context.ts

@@ -0,0 +1,265 @@
+/**
+ * Website content context builder
+ * Discovers user documentation and brand assets to populate website templates
+ * with project-specific content instead of generic placeholders
+ */
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import {
+  stripCodeFences,
+  extractProductName,
+  extractTagline,
+  extractDescription,
+  extractFeatures,
+  extractPricing,
+  extractPrimaryColor,
+} from './doc-parser.js';
+import type { WebsiteStrategyDocument, BrandAssetsContract } from '../types/website-strategy.js';
+
+/**
+ * Structured content context for website generation
+ */
+export interface WebsiteContentContext {
+  productName: string;
+  tagline?: string;
+  description?: string;
+  features: Array<{ title: string; description: string }>;
+  pricing?: Array<{
+    name: string;
+    price: string;
+    period?: string;
+    description: string;
+    features: string[];
+    cta: string;
+    featured?: boolean;
+  }>;
+  brand?: {
+    primaryColor?: string;
+    colorScheme?: Record<string, string>;
+    logoPath?: string;
+  };
+  rawDocs: string;
+  /** Website marketing strategy (generated by AI from product context) */
+  strategy?: WebsiteStrategyDocument;
+  /** Resolved brand assets contract for deterministic logo/favicon placement */
+  brandAssets?: BrandAssetsContract;
+}
+
+/**
+ * Resolve brand assets into a deterministic contract
+ * Searches for logo/favicon in project directory, sets canonical output paths
+ *
+ * @param cwd - Directory to scan for brand assets
+ * @param brandContext - Optional existing brand context from state
+ * @returns Resolved brand assets contract
+ */
+export async function resolveBrandAssets(
+  cwd: string,
+  brandContext?: { logoPath?: string; primaryColor?: string }
+): Promise<BrandAssetsContract> {
+  const assets = await findBrandAssets(cwd);
+  const logoPath = brandContext?.logoPath || assets.logoPath;
+  const ext = logoPath ? path.extname(logoPath) : '.svg';
+
+  return {
+    logoPath,
+    logoOutputPath: `public/brand/logo${ext}`,
+    primaryColor: brandContext?.primaryColor,
+  };
+}
+
+/** Patterns to match documentation files */
+const DOC_PATTERNS = [
+  /spec/i,
+  /pricing/i,
+  /color/i,
+  /brand/i,
+  /ui[\s_-]?spec/i,
+  /^readme\.md$/i,
+  /overview/i,
+  /features/i,
+  /product/i,
+];
+
+/** Directories to exclude from scanning */
+const EXCLUDED_DIRS = [
+  'node_modules',
+  '.popeye',
+  '.git',
+  'dist',
+  'build',
+  '.next',
+  '__pycache__',
+  'venv',
+  '.venv',
+  'coverage',
+];
+
+/**
+ * Discover project documentation files in a directory
+ *
+ * @param cwd - Directory to scan for documentation
+ * @returns Array of absolute paths to discovered doc files
+ */
+export async function discoverProjectDocs(cwd: string): Promise<string[]> {
+  const docs: string[] = [];
+
+  try {
+    const entries = await fs.readdir(cwd, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (entry.isDirectory() && EXCLUDED_DIRS.includes(entry.name)) {
+        continue;
+      }
+
+      if (entry.isFile() && entry.name.endsWith('.md')) {
+        const matches = DOC_PATTERNS.some((pattern) => pattern.test(entry.name));
+        if (matches) {
+          docs.push(path.join(cwd, entry.name));
+        }
+      }
+
+      // Check one level of subdirectories (e.g., docs/)
+      if (entry.isDirectory() && entry.name === 'docs') {
+        try {
+          const subEntries = await fs.readdir(path.join(cwd, entry.name), {
+            withFileTypes: true,
+          });
+          for (const subEntry of subEntries) {
+            if (subEntry.isFile() && subEntry.name.endsWith('.md')) {
+              docs.push(path.join(cwd, entry.name, subEntry.name));
+            }
+          }
+        } catch {
+          // Skip unreadable directories
+        }
+      }
+    }
+  } catch {
+    // Directory not accessible
+  }
+
+  // Sort: color/brand docs first (small but critical), then others
+  // This ensures brand context isn't truncated by the maxLength cap
+  docs.sort((a, b) => {
+    const nameA = path.basename(a).toLowerCase();
+    const nameB = path.basename(b).toLowerCase();
+    const priorityA = /color|brand/.test(nameA) ? 0 : 1;
+    const priorityB = /color|brand/.test(nameB) ? 0 : 1;
+    return priorityA - priorityB;
+  });
+
+  return docs;
+}
+
+/**
+ * Find brand assets (logo files) in a directory
+ *
+ * @param cwd - Directory to scan for brand assets
+ * @returns Object with optional logoPath
+ */
+export async function findBrandAssets(
+  cwd: string
+): Promise<{ logoPath?: string }> {
+  const logoExtensions = ['.png', '.svg', '.jpg', '.jpeg', '.webp'];
+
+  try {
+    const entries = await fs.readdir(cwd, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (!entry.isFile()) continue;
+
+      const lowerName = entry.name.toLowerCase();
+      const hasLogoInName = lowerName.includes('logo');
+      const hasValidExt = logoExtensions.some((ext) => lowerName.endsWith(ext));
+
+      if (hasLogoInName && hasValidExt) {
+        return { logoPath: path.join(cwd, entry.name) };
+      }
+    }
+  } catch {
+    // Directory not accessible
+  }
+
+  return {};
+}
+
+/**
+ * Read and concatenate project documentation files
+ *
+ * @param docPaths - Array of absolute paths to doc files
+ * @param maxLength - Maximum combined length (default 15000 chars)
+ * @returns Combined documentation content with file headers
+ */
+export async function readProjectDocs(
+  docPaths: string[],
+  maxLength: number = 15000
+): Promise<string> {
+  const sections: string[] = [];
+  let totalLength = 0;
+
+  for (const docPath of docPaths) {
+    if (totalLength >= maxLength) break;
+
+    try {
+      const content = await fs.readFile(docPath, 'utf-8');
+      const fileName = path.basename(docPath);
+      const header = `--- ${fileName} ---`;
+      const remaining = maxLength - totalLength;
+      const trimmedContent =
+        content.length > remaining ? content.slice(0, remaining) + '...' : content;
+
+      sections.push(`${header}\n${trimmedContent}`);
+      totalLength += header.length + 1 + trimmedContent.length;
+    } catch {
+      // Skip unreadable files
+    }
+  }
+
+  return sections.join('\n\n');
+}
+
+/**
+ * Build a structured website content context from discovered docs
+ *
+ * @param cwd - Working directory to scan for docs
+ * @param projectName - The project name (folder name fallback)
+ * @param specification - Optional expanded specification text
+ * @returns Structured content context for website templates
+ */
+export async function buildWebsiteContext(
+  cwd: string,
+  projectName: string,
+  specification?: string
+): Promise<WebsiteContentContext> {
+  const docPaths = await discoverProjectDocs(cwd);
+  const rawDocs = docPaths.length > 0 ? await readProjectDocs(docPaths) : '';
+  const brandAssets = await findBrandAssets(cwd);
+
+  // Strip markdown code fences that wrap entire doc files
+  const cleanDocs = stripCodeFences(rawDocs);
+
+  const context: WebsiteContentContext = {
+    productName: extractProductName(cleanDocs, specification) || projectName,
+    features: extractFeatures(cleanDocs, specification),
+    rawDocs,
+  };
+
+  context.tagline = extractTagline(cleanDocs, context.productName);
+  context.description = extractDescription(cleanDocs, specification);
+  context.pricing = extractPricing(cleanDocs);
+
+  // Extract brand info
+  if (brandAssets.logoPath) {
+    context.brand = { ...context.brand, logoPath: brandAssets.logoPath };
+  }
+
+  const primaryColor = extractPrimaryColor(cleanDocs);
+  if (primaryColor) {
+    context.brand = { ...context.brand, primaryColor };
+  }
+
+  return context;
+}
+

package/src/generators/website.ts

@@ -7,27 +7,47 @@ import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import type { ProjectSpec } from '../types/project.js';
 import {
-  generateWebsitePackageJson,
-  generateNextConfig,
-  generateWebsiteTsconfig,
-  generateWebsiteTailwindConfig,
-  generateWebsitePostcssConfig,
   generateWebsiteLayout,
   generateWebsiteGlobalsCss,
   generateWebsiteLandingPage,
   generateWebsitePricingPage,
-  generateWebsiteSitemap,
-  generateWebsiteRobots,
-  generateWebsiteDockerfile,
   generateWebsiteReadme,
   generateWebsiteSpec,
-  generateWebsiteVitestConfig,
-  generateWebsiteVitestSetup,
   generateWebsiteTest,
   generateWebsiteDocsPage,
   generateWebsiteBlogPage,
-  generateWebsiteNextEnv,
 } from './templates/website.js';
+import {
+  generateWebsitePackageJson,
+  generateNextConfig,
+  generateWebsiteTsconfig,
+  generateWebsiteTailwindConfig,
+  generateWebsitePostcssConfig,
+  generateWebsiteDockerfile,
+  generateWebsiteVitestConfig,
+  generateWebsiteVitestSetup,
+  generateWebsiteNextEnv,
+} from './templates/website-config.js';
+import {
+  generateWebsiteHeader,
+  generateWebsiteFooter,
+  generateWebsiteNavigation,
+} from './templates/website-components.js';
+import {
+  generateJsonLdComponent,
+  generateEnhancedSitemap,
+  generateEnhancedRobots,
+  generate404Page,
+  generate500Page,
+  generateWebManifest,
+  generateMetaHelper,
+} from './templates/website-seo.js';
+import {
+  generateLeadCaptureRoute,
+  generateContactForm,
+  generateLeadCaptureEnvExample,
+} from './templates/website-conversion.js';
+import type { WebsiteContentContext } from './website-context.js';
 
 /**
  * Project generation result
@@ -53,6 +73,8 @@ export interface WebsiteGeneratorOptions {
   skipDocker?: boolean;
   /** Skip README (fullstack has root README) */
   skipReadme?: boolean;
+  /** Content context from user docs for populating templates */
+  contentContext?: WebsiteContentContext;
 }
 
 /**
@@ -88,6 +110,7 @@ export async function generateWebsiteProject(
     workspaceMode = false,
     skipDocker = false,
     skipReadme = false,
+    contentContext,
   } = options;
 
   const projectName = spec.name || 'my-project';
@@ -103,11 +126,13 @@ export async function generateWebsiteProject(
     await ensureDir(path.join(projectDir, 'src', 'app', 'pricing'));
     await ensureDir(path.join(projectDir, 'src', 'app', 'docs'));
     await ensureDir(path.join(projectDir, 'src', 'app', 'blog'));
+    await ensureDir(path.join(projectDir, 'src', 'app', 'api', 'lead'));
     await ensureDir(path.join(projectDir, 'src', 'components'));
     await ensureDir(path.join(projectDir, 'src', 'lib'));
     await ensureDir(path.join(projectDir, 'content', 'blog'));
     await ensureDir(path.join(projectDir, 'content', 'docs'));
     await ensureDir(path.join(projectDir, 'public'));
+    await ensureDir(path.join(projectDir, 'public', 'brand'));
     await ensureDir(path.join(projectDir, 'tests'));
 
     // Only create .popeye dir in standalone mode
@@ -150,19 +175,19 @@ export async function generateWebsiteProject(
       // App Router files
       {
         path: path.join(projectDir, 'src', 'app', 'layout.tsx'),
-        content: generateWebsiteLayout(projectName),
+        content: generateWebsiteLayout(projectName, contentContext),
       },
       {
         path: path.join(projectDir, 'src', 'app', 'globals.css'),
-        content: generateWebsiteGlobalsCss(),
+        content: generateWebsiteGlobalsCss(contentContext),
       },
       {
         path: path.join(projectDir, 'src', 'app', 'page.tsx'),
-        content: generateWebsiteLandingPage(projectName),
+        content: generateWebsiteLandingPage(projectName, contentContext),
       },
       {
         path: path.join(projectDir, 'src', 'app', 'pricing', 'page.tsx'),
-        content: generateWebsitePricingPage(projectName),
+        content: generateWebsitePricingPage(projectName, contentContext),
       },
       {
         path: path.join(projectDir, 'src', 'app', 'docs', 'page.tsx'),
@@ -173,14 +198,64 @@ export async function generateWebsiteProject(
         content: generateWebsiteBlogPage(),
       },
 
+      // Shared components
+      {
+        path: path.join(projectDir, 'src', 'components', 'Header.tsx'),
+        content: generateWebsiteHeader(projectName, contentContext, contentContext?.strategy),
+      },
+      {
+        path: path.join(projectDir, 'src', 'components', 'Footer.tsx'),
+        content: generateWebsiteFooter(projectName, contentContext, contentContext?.strategy),
+      },
+      {
+        path: path.join(projectDir, 'src', 'components', 'JsonLd.tsx'),
+        content: generateJsonLdComponent(),
+      },
+      {
+        path: path.join(projectDir, 'src', 'components', 'ContactForm.tsx'),
+        content: generateContactForm(contentContext?.strategy),
+      },
+      {
+        path: path.join(projectDir, 'src', 'lib', 'navigation.ts'),
+        content: generateWebsiteNavigation(contentContext?.strategy),
+      },
+      {
+        path: path.join(projectDir, 'src', 'lib', 'metadata.ts'),
+        content: generateMetaHelper(projectName, contentContext?.strategy),
+      },
+
+      // Lead capture API route
+      {
+        path: path.join(projectDir, 'src', 'app', 'api', 'lead', 'route.ts'),
+        content: generateLeadCaptureRoute(
+          contentContext?.strategy?.conversionStrategy.leadCapture || 'webhook'
+        ),
+      },
+
       // SEO files
       {
         path: path.join(projectDir, 'src', 'app', 'sitemap.ts'),
-        content: generateWebsiteSitemap(projectName),
+        content: generateEnhancedSitemap(projectName, contentContext?.strategy),
       },
       {
         path: path.join(projectDir, 'src', 'app', 'robots.ts'),
-        content: generateWebsiteRobots(projectName),
+        content: generateEnhancedRobots(projectName),
+      },
+
+      // Error pages
+      {
+        path: path.join(projectDir, 'src', 'app', 'not-found.tsx'),
+        content: generate404Page(projectName, contentContext),
+      },
+      {
+        path: path.join(projectDir, 'src', 'app', 'error.tsx'),
+        content: generate500Page(projectName),
+      },
+
+      // PWA manifest
+      {
+        path: path.join(projectDir, 'public', 'manifest.webmanifest'),
+        content: generateWebManifest(projectName, contentContext),
       },
 
       // Test files
@@ -218,7 +293,10 @@ export async function generateWebsiteProject(
       // Environment
       {
         path: path.join(projectDir, '.env.example'),
-        content: 'NEXT_PUBLIC_SITE_URL=http://localhost:3001\nNEXT_PUBLIC_APP_URL=http://localhost:3000\n',
+        content: 'NEXT_PUBLIC_SITE_URL=http://localhost:3001\nNEXT_PUBLIC_APP_URL=http://localhost:3000\n' +
+          generateLeadCaptureEnvExample(
+            contentContext?.strategy?.conversionStrategy.leadCapture || 'webhook'
+          ),
       },
       {
         path: path.join(projectDir, '.gitignore'),
@@ -231,10 +309,22 @@ export async function generateWebsiteProject(
     if (!workspaceMode) {
       files.push({
         path: path.join(projectDir, '.popeye', 'website-spec.json'),
-        content: generateWebsiteSpec(projectName),
+        content: generateWebsiteSpec(projectName, contentContext),
       });
     }
 
+    // Copy logo to public/ if brand context has one
+    if (contentContext?.brand?.logoPath) {
+      try {
+        const logoExt = path.extname(contentContext.brand.logoPath);
+        const destPath = path.join(projectDir, 'public', `logo${logoExt}`);
+        await fs.copyFile(contentContext.brand.logoPath, destPath);
+        filesCreated.push(destPath);
+      } catch {
+        // Non-blocking: logo copy failure should not stop generation
+      }
+    }
+
     // Add README if not skipped
     if (!skipReadme) {
       files.push({

package/src/state/index.ts

@@ -338,6 +338,48 @@ export async function storeSpecification(
   return updateState(projectDir, { specification });
 }
 
+/**
+ * Store discovered user documentation in project state
+ *
+ * @param projectDir - The project root directory
+ * @param userDocs - Combined user documentation content
+ * @returns The updated state
+ */
+export async function storeUserDocs(
+  projectDir: string,
+  userDocs: string
+): Promise<ProjectState> {
+  return updateState(projectDir, { userDocs });
+}
+
+/**
+ * Store brand context in project state
+ *
+ * @param projectDir - The project root directory
+ * @param brandContext - Brand context with logo path and primary color
+ * @returns The updated state
+ */
+export async function storeBrandContext(
+  projectDir: string,
+  brandContext: { logoPath?: string; primaryColor?: string }
+): Promise<ProjectState> {
+  return updateState(projectDir, { brandContext });
+}
+
+/**
+ * Store website strategy path in project state
+ *
+ * @param projectDir - The project root directory
+ * @param strategyPath - Relative path to strategy JSON file
+ * @returns The updated state
+ */
+export async function storeWebsiteStrategyPath(
+  projectDir: string,
+  strategyPath: string
+): Promise<ProjectState> {
+  return updateState(projectDir, { websiteStrategy: strategyPath });
+}
+
 /**
  * Mark the project as complete
  *

package/src/types/consensus.ts

@@ -89,6 +89,8 @@ export interface ConsensusConfig {
   useOptimizedConsensus?: boolean;
   /** Additional reviewers beyond primary (for parallel reviews) */
   additionalReviewers?: AIProvider[];
+  /** Custom reviewer persona for domain-specific reviews (e.g., marketing strategist for website projects) */
+  reviewerPersona?: string;
 }
 
 /**
@@ -150,6 +152,7 @@ export const ConsensusConfigSchema = z.object({
   escalationAction: z.enum(['pause', 'continue', 'abort']).default('pause'),
   temperature: z.number().min(0).max(2).default(0.3),
   maxTokens: z.number().min(100).max(32000).default(4096),
+  reviewerPersona: z.string().optional(),
 });
 
 /**