popeye-cli 1.5.0 → 1.6.0

package/dist/workflow/website-updater.js

@@ -6,8 +6,11 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { isWorkspace } from '../types/project.js';
-import { buildWebsiteContext } from '../generators/website-context.js';
-import { generateWebsiteLandingPage, generateWebsitePricingPage, generateWebsiteLayout, generateWebsiteGlobalsCss, } from '../generators/templates/website.js';
+import { buildWebsiteContext, resolveBrandAssets, validateWebsiteContext } from '../generators/website-context.js';
+import { resolveWorkspaceRoot } from '../generators/workspace-root.js';
+import { generateWebsiteLandingPage } from '../generators/templates/website-landing.js';
+import { generateWebsitePricingPage } from '../generators/templates/website-pricing.js';
+import { generateWebsiteLayout, generateWebsiteGlobalsCss, } from '../generators/templates/website-layout.js';
 import { generateWebsiteHeader, generateWebsiteFooter, } from '../generators/templates/website-components.js';
 import { loadWebsiteStrategy } from './website-strategy.js';
 /**
@@ -47,12 +50,20 @@ export async function updateWebsiteContent(projectDir, state, language, onProgre
             logoPath: state.brandContext.logoPath,
         };
     }
+    // Resolve brand assets using workspace root for proper logo resolution
+    const workspaceRoot = await resolveWorkspaceRoot(parentDir);
+    context.brandAssets = await resolveBrandAssets(workspaceRoot, context.brand);
     // Load website strategy if available
     const strategyData = await loadWebsiteStrategy(projectDir);
     if (strategyData) {
         context.strategy = strategyData.strategy;
         onProgress?.('Loaded website strategy for content update');
     }
+    // Soft validation: report quality issues via progress callback
+    const validation = validateWebsiteContext(context, state.name);
+    for (const msg of [...validation.issues, ...validation.warnings]) {
+        onProgress?.(`[quality-gate] ${msg}`);
+    }
     onProgress?.('Updating website content with project context...');
     // Re-generate content files
     const updates = [
@@ -89,11 +100,11 @@ export async function updateWebsiteContent(projectDir, state, language, onProgre
             // Non-blocking: individual file update failures should not stop the workflow
         }
     }
-    // Copy logo to public/ if brand context has one
+    // Copy logo to public/brand/ if brand context has one
     if (context.brand?.logoPath) {
         try {
             const logoExt = path.extname(context.brand.logoPath);
-            const destPath = path.join(websiteDir, 'public', `logo${logoExt}`);
+            const destPath = path.join(websiteDir, 'public', 'brand', `logo${logoExt}`);
             await fs.copyFile(context.brand.logoPath, destPath);
         }
         catch {

package/dist/workflow/website-updater.js.map

@@ -1 +1 @@
-{"version":3,"file":"website-updater.js","sourceRoot":"","sources":["../../src/workflow/website-updater.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,KAAmB,EACnB,QAAwB,EACxB,UAAsC;IAEtC,oDAAoD;IACpD,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC;QAC1C,CAAC,CAAC,UAAU,CAAC;IAEf,oCAAoC;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,EAAE,CAAC,sDAAsD,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IAED,yDAAyD;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,mBAAmB,CACvC,SAAS,EACT,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,aAAa,CACpB,CAAC;IAEF,8CAA8C;IAC9C,IAAI,KAAK,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC;QACrC,OAAO,CAAC,KAAK,GAAG;YACd,GAAG,OAAO,CAAC,KAAK;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,YAAY;SAC9C,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,GAAG;YACd,GAAG,OAAO,CAAC,KAAK;YAChB,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,QAAQ;SACtC,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;QACzC,UAAU,EAAE,CAAC,4CAA4C,CAAC,CAAC;IAC7D,CAAC;IAED,UAAU,EAAE,CAAC,kDAAkD,CAAC,CAAC;IAEjE,4BAA4B;IAC5B,MAAM,OAAO,GAA6C;QACxD;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC;YACrD,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;SACzD;QACD;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC;YAChE,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;SACzD;QACD;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;YACvD,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;SACpD;QACD;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC;YACxD,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC;SAC5C;QACD;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC;YAC9D,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC;SACtE;QACD;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC;YAC9D,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC;SACtE;KACF,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,6EAA6E;QAC/E,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,OAAO,EAAE,CAAC,CAAC;YACnE,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,UAAU,EAAE,CAAC,8CAA8C,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"website-updater.js","sourceRoot":"","sources":["../../src/workflow/website-updater.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "popeye-cli",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Fully autonomous code generation tool powered by Claude CLI and OpenAI consensus",
   "main": "./dist/index.js",
   "bin": {

package/src/cli/commands/create.ts

@@ -5,6 +5,7 @@
 
 import { Command } from 'commander';
 import path from 'node:path';
+import { promises as fs } from 'node:fs';
 import { ProjectSpecSchema, type OutputLanguage, type OpenAIModel } from '../../types/project.js';
 import { requireAuth } from '../../auth/index.js';
 import { runWorkflow } from '../../workflow/index.js';
@@ -99,8 +100,8 @@ export function createCreateCommand(): Command {
         }
 
         // Generate project name from idea if not provided
-        const projectName = options.name || generateProjectName(idea);
         const outputDir = path.resolve(options.output);
+        const projectName = options.name || await generateProjectName(idea, outputDir);
         const projectDir = path.join(outputDir, projectName);
         const threshold = parseInt(options.threshold, 10);
         const maxIterations = parseInt(options.maxIterations, 10);
@@ -255,10 +256,63 @@ export function createCreateCommand(): Command {
 }
 
 /**
- * Generate a project name from an idea
+ * Directories that are too generic to use as project names
  */
-function generateProjectName(idea: string): string {
-  // Take first few words, lowercase, replace spaces with hyphens
+const GENERIC_DIR_NAMES = new Set([
+  'home', 'desktop', 'documents', 'downloads', 'projects', 'project',
+  'repos', 'code', 'dev', 'workspace', 'workspaces', 'src', 'tmp',
+  'temp', 'users', 'user', 'root', 'var', 'opt',
+]);
+
+/**
+ * Generate a project name, preferring CWD-derived names over prompt text.
+ *
+ * Priority: docs in CWD -> CWD basename -> idea text extraction
+ *
+ * @param idea - The user's project idea text
+ * @param cwd - Optional directory for context-aware naming
+ * @returns A kebab-case project name
+ */
+async function generateProjectName(idea: string, cwd?: string): Promise<string> {
+  const toKebab = (name: string): string =>
+    name
+      .replace(/([a-z])([A-Z])/g, '$1-$2')
+      .toLowerCase()
+      .replace(/[^a-z0-9-]/g, '-')
+      .replace(/-+/g, '-')
+      .replace(/^-|-$/g, '');
+
+  if (cwd) {
+    // Check for doc-derived name
+    try {
+      const entries = await fs.readdir(cwd, { withFileTypes: true });
+      const mdFiles = entries
+        .filter(e => e.isFile() && e.name.endsWith('.md') && !e.name.toLowerCase().startsWith('readme'))
+        .map(e => path.join(cwd, e.name));
+
+      for (const mdFile of mdFiles) {
+        try {
+          const content = await fs.readFile(mdFile, 'utf-8');
+          const headingMatch = content.match(/^#\s+([A-Z][a-zA-Z0-9]+)/m);
+          if (headingMatch && headingMatch[1] && headingMatch[1].length >= 3 && headingMatch[1].length <= 30) {
+            return toKebab(headingMatch[1]);
+          }
+        } catch {
+          // Skip unreadable files
+        }
+      }
+    } catch {
+      // Directory not readable
+    }
+
+    // Check CWD basename
+    const dirName = path.basename(cwd);
+    if (dirName.length >= 3 && !GENERIC_DIR_NAMES.has(dirName.toLowerCase())) {
+      return toKebab(dirName);
+    }
+  }
+
+  // Fallback: extract from idea text
   return idea
     .toLowerCase()
     .replace(/[^a-z0-9\s]/g, '')

package/src/cli/interactive.ts

@@ -2262,10 +2262,99 @@ async function handleResume(state: SessionState, args: string[]): Promise<void>
 }
 
 /**
- * Generate a meaningful project name from an idea
- * Extracts key nouns and creates a kebab-case name
+ * Directories that are too generic to use as project names.
+ * If the CWD basename matches one of these, we skip CWD-based naming.
  */
-function generateProjectName(idea: string): string {
+const GENERIC_DIR_NAMES = new Set([
+  'home', 'desktop', 'documents', 'downloads', 'projects', 'project',
+  'repos', 'code', 'dev', 'workspace', 'workspaces', 'src', 'tmp',
+  'temp', 'users', 'user', 'root', 'var', 'opt',
+]);
+
+/**
+ * Try to extract a product name from .md files in a directory.
+ * Looks for top-level headings (# ProductName) in markdown files.
+ *
+ * @param dir - Directory to scan for .md files
+ * @returns Product name if found, null otherwise
+ */
+export async function extractNameFromDocs(dir: string): Promise<string | null> {
+  try {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const mdFiles = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md') && !e.name.toLowerCase().startsWith('readme'))
+      .map(e => path.join(dir, e.name));
+
+    for (const mdFile of mdFiles) {
+      try {
+        const content = await fs.readFile(mdFile, 'utf-8');
+        // Look for a top-level heading like "# Gateco" or "# Gateco - Subtitle"
+        const headingMatch = content.match(/^#\s+([A-Z][a-zA-Z0-9]+)/m);
+        if (headingMatch && headingMatch[1]) {
+          const name = headingMatch[1];
+          // Validate: must be a reasonable product name (3-30 chars, not a generic word)
+          if (name.length >= 3 && name.length <= 30 && !GENERIC_DIR_NAMES.has(name.toLowerCase())) {
+            return name;
+          }
+        }
+      } catch {
+        // Skip unreadable files
+      }
+    }
+  } catch {
+    // Directory not readable
+  }
+  return null;
+}
+
+/**
+ * Generate a meaningful project name from an idea, with CWD-aware logic.
+ *
+ * Priority chain:
+ * 1. If CWD contains .md docs with a "# ProductName" heading, use that
+ * 2. If CWD basename is a meaningful name (not generic), use it
+ * 3. Fall back to extracting a name from the idea text
+ *
+ * @param idea - The user's project idea text
+ * @param cwd - Optional current working directory for context-aware naming
+ * @returns A kebab-case project name
+ */
+export async function generateProjectName(idea: string, cwd?: string): Promise<string> {
+  // Normalize to kebab-case helper
+  const toKebab = (name: string): string =>
+    name
+      .replace(/([a-z])([A-Z])/g, '$1-$2')
+      .toLowerCase()
+      .replace(/[^a-z0-9-]/g, '-')
+      .replace(/-+/g, '-')
+      .replace(/^-|-$/g, '');
+
+  if (cwd) {
+    // Priority 1: Check for doc-derived name in CWD
+    const docName = await extractNameFromDocs(cwd);
+    if (docName) {
+      return toKebab(docName);
+    }
+
+    // Priority 2: Use CWD basename if it's meaningful
+    const dirName = path.basename(cwd);
+    if (dirName.length >= 3 && !GENERIC_DIR_NAMES.has(dirName.toLowerCase())) {
+      return toKebab(dirName);
+    }
+  }
+
+  // Priority 3: Extract from idea text (original logic)
+  return generateProjectNameFromIdea(idea);
+}
+
+/**
+ * Extract a project name from the idea text alone.
+ * This is the original generateProjectName logic, used as a fallback.
+ *
+ * @param idea - The user's project idea text
+ * @returns A kebab-case project name
+ */
+export function generateProjectNameFromIdea(idea: string): string {
   // 1. First, try to find explicit project name patterns
   const explicitPatterns = [
     /(?:called|named|for|planning|project)\s+["']?([A-Z][a-zA-Z0-9]+)["']?/i,
@@ -2465,8 +2554,8 @@ async function handleIdea(idea: string, state: SessionState): Promise<void> {
     }
   }
 
-  // Generate a meaningful project name
-  const projectName = generateProjectName(idea);
+  // Generate a meaningful project name (CWD-aware: checks docs and dir name first)
+  const projectName = await generateProjectName(idea, cwd);
   const projectDir = path.join(cwd, projectName);
 
   console.log();
@@ -2581,8 +2670,8 @@ async function handleNewProject(idea: string, state: SessionState): Promise<void
 
   const cwd = state.projectDir || process.cwd();
 
-  // Generate a meaningful project name
-  const projectName = generateProjectName(idea);
+  // Generate a meaningful project name (CWD-aware: checks docs and dir name first)
+  const projectName = await generateProjectName(idea, cwd);
   const projectDir = path.join(cwd, projectName);
 
   console.log();