vibebusiness 1.2.87 → 1.2.89

package/.next/standalone/scripts/analyze.ts

@@ -11,6 +11,7 @@
  *   npm run analyze -- --type=metrics
  *   npm run analyze -- --type=seo
  *   npm run analyze -- --type=research --topic="response time optimization" --context=<base64>
+ *   npm run analyze -- --type=growth
  */
 
 import 'dotenv/config';
@@ -19,7 +20,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { v4 as uuidv4 } from 'uuid';
 import { getAnalysisPrompt } from '../src/lib/prompts';
-import type { AnalystConfig as ImportedAnalystConfig, BusinessConfig, Priority, SizeEstimate } from '../src/lib/types';
+import type { AnalystConfig as ImportedAnalystConfig, BusinessConfig } from '../src/lib/types';
 import { atomicWriteFileSync } from './lib/json-lock';
 import { requireClaudeCLI } from './lib/ai-provider';
 import { logError, logWarn } from './lib/logger';
@@ -117,7 +118,7 @@ import {
 } from './lib/paths';
 
 // Analysis types
-type AnalysisType = 'quick' | 'deep' | 'metrics' | 'seo' | 'research';
+type AnalysisType = 'quick' | 'deep' | 'metrics' | 'seo' | 'research' | 'growth';
 
 // Parse command line arguments
 function parseArgs(): { type: AnalysisType; topic?: string; context?: string } {
@@ -129,7 +130,7 @@ function parseArgs(): { type: AnalysisType; topic?: string; context?: string } {
   for (const arg of args) {
     if (arg.startsWith('--type=')) {
       const value = arg.split('=')[1];
-      if (['quick', 'deep', 'metrics', 'seo', 'research'].includes(value)) {
+      if (['quick', 'deep', 'metrics', 'seo', 'research', 'growth'].includes(value)) {
         type = value as AnalysisType;
       }
     } else if (arg.startsWith('--topic=')) {
@@ -253,16 +254,38 @@ function updateSession(sessionId: string, updates: Partial<Session>): void {
   }
 }
 
-// Add log to session
+// Buffer for session log lines, keyed by session id
+const pendingLogs = new Map<string, string[]>();
+
+// Add log to session (buffered — call flushSessionLogs to persist)
 function addSessionLog(sessionId: string, message: string): void {
-  const sessions = loadSessions();
-  const index = sessions.sessions.findIndex((s) => s.id === sessionId);
-  if (index !== -1) {
-    const timestamp = new Date().toISOString();
-    sessions.sessions[index].logs.push(`[${timestamp}] ${message}`);
-    saveSessions(sessions);
-  }
   console.log(message);
+  const timestamp = new Date().toISOString();
+  const entry = `[${timestamp}] ${message}`;
+  const existing = pendingLogs.get(sessionId) ?? [];
+  existing.push(entry);
+  pendingLogs.set(sessionId, existing);
+}
+
+// Flush buffered log lines to disk in a single write
+function flushSessionLogs(sessionId: string): void {
+  const lines = pendingLogs.get(sessionId);
+  const n = lines?.length ?? 0;
+  console.log(`[analyze] Flushing ${n} buffered log lines for session ${sessionId}`);
+  try {
+    const sessions = loadSessions();
+    const index = sessions.sessions.findIndex((s) => s.id === sessionId);
+    if (index !== -1 && lines && lines.length > 0) {
+      sessions.sessions[index].logs.push(...lines);
+      saveSessions(sessions);
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(`[analyze] ERROR: failed to flush session logs for ${sessionId}: ${msg}`);
+    throw err;
+  } finally {
+    pendingLogs.delete(sessionId);
+  }
 }
 
 // Load goals and format as context string for prompts
@@ -409,14 +432,34 @@ function generatePrompt(
 // Parse ideas from Claude's response
 export function parseIdeas(response: string, sessionId: string): BusinessIdea[] {
   // Try to extract JSON array from the response
-  const jsonMatch = response.match(/\[\s*\{[\s\S]*\}\s*\]/);
-  if (!jsonMatch) {
+  // Strategy: first try markdown-fenced JSON, then raw JSON array
+  let jsonStr: string | null = null;
+
+  // 1. Try ```json ... ``` fenced block
+  const fencedMatch = response.match(/```json\s*\n?([\s\S]*?)```/);
+  if (fencedMatch) {
+    const inner = fencedMatch[1].trim();
+    if (inner.startsWith('[')) {
+      jsonStr = inner;
+    }
+  }
+
+  // 2. Fallback: raw JSON array anywhere in the response
+  if (!jsonStr) {
+    const rawMatch = response.match(/\[\s*\{[\s\S]*\}\s*\]/);
+    if (rawMatch) {
+      jsonStr = rawMatch[0];
+    }
+  }
+
+  if (!jsonStr) {
     console.error('No JSON array found in response');
+    console.error('Response preview (first 500 chars):', response.slice(0, 500));
     return [];
   }
 
   try {
-    const rawIdeas = JSON.parse(jsonMatch[0]) as IdeaInput[];
+    const rawIdeas = JSON.parse(jsonStr) as IdeaInput[];
     const now = new Date().toISOString();
 
     return rawIdeas.map((idea) => {
@@ -488,12 +531,9 @@ export function parseIdeas(response: string, sessionId: string): BusinessIdea[]
         title: idea.title || 'Untitled Idea',
         summary: idea.summary || '',
         category: idea.category || 'product',
-        priority: (['critical', 'high', 'medium', 'low'] as const).includes(idea.priority as Priority) ? idea.priority as Priority : 'medium',
-        effort: (['xs', 's', 'm', 'l', 'xl'] as const).includes(idea.effort as SizeEstimate) ? idea.effort as SizeEstimate : 'm',
-        impact: (['xs', 's', 'm', 'l', 'xl'] as const).includes(idea.impact as SizeEstimate) ? idea.impact as SizeEstimate : (() => {
-          if (idea.impact) logError('analyze:parseIdeas', new Error(`invalid impact "${idea.impact}" for idea "${idea.title}" — defaulting to "m"`));
-          return 'm' as SizeEstimate;
-        })(),
+        priority: idea.priority || 'medium',
+        effort: idea.effort || 'm',
+        impact: idea.impact || 'm',
         context: idea.context || '',
         rationale: idea.rationale || '',
         implementation_plan: idea.implementation_plan || '',
@@ -556,6 +596,7 @@ async function runClaudeAnalysis(
     console.log('[analyze] Prompt sent via stdin — no temp file written');
     const claude = spawn('claude', [
       '--print',
+      '--output-format', 'text',
       '--dangerously-skip-permissions',
     ], {
       cwd: workDir,
@@ -615,7 +656,13 @@ async function runClaudeAnalysis(
       if (code === 0) {
         logWarn('analyze:runClaudeAnalysis', `completed in ${elapsed}s phases=[${timing.phases.join(',')}]`);
         console.log(`Claude Code completed in ${elapsed}s`);
-        resolve(output);
+        console.log(`[analyze] stdout length: ${output.length}, stderr length: ${errorOutput.length}`);
+        if (output.length === 0 && errorOutput.length > 0) {
+          console.log('[analyze] WARNING: stdout empty but stderr has content — using stderr as response');
+          resolve(errorOutput);
+        } else {
+          resolve(output);
+        }
       } else {
         reject(new Error(`Claude Code exited with code ${code} after ${elapsed}s: ${errorOutput}`));
       }
@@ -851,6 +898,8 @@ async function main() {
     console.error('\n=== Analysis Failed ===');
     console.error(error);
     process.exit(1);
+  } finally {
+    flushSessionLogs(session.id);
   }
 }
 

package/.next/standalone/scripts/implement.ts

@@ -68,6 +68,7 @@ interface ImplementationSession {
   id: string;
   idea_id: string;
   status: string;
+  error_message?: string;
   repo_name: string;
   branch_name: string;
   workspace_path: string;
@@ -173,6 +174,27 @@ function updateIdea(ideaId: string, updates: Partial<BusinessIdea['implementatio
   }
 }
 
+// Revert idea stage from 'in_progress' back to 'approved' on failure
+export function revertIdeaStage(ideaId: string, reason: string): void {
+  try {
+    const data = loadJson<{ ideas: Array<{ id: string; stage: string; comments: Array<{ id: string; author: string; body: string; created_at: string }> }> }>(IDEAS_FILE);
+    const index = data.ideas.findIndex((i) => i.id === ideaId);
+    if (index !== -1) {
+      data.ideas[index].stage = 'approved';
+      if (!data.ideas[index].comments) data.ideas[index].comments = [];
+      data.ideas[index].comments.push({
+        id: `comment-${Date.now()}`,
+        author: 'system',
+        body: reason,
+        created_at: new Date().toISOString(),
+      });
+      saveJson(IDEAS_FILE, data);
+    }
+  } catch (e) {
+    console.error('[implement] Failed to revert idea stage', { ideaId, error: (e as Error).message });
+  }
+}
+
 // Create/update implementation session
 function createImplementation(
   ideaId: string,
@@ -198,7 +220,7 @@ function createImplementation(
   return impl;
 }
 
-function updateImplementation(id: string, updates: Partial<ImplementationSession>): void {
+export function updateImplementation(id: string, updates: Partial<ImplementationSession>): void {
   const data = loadJson<{ implementations: ImplementationSession[] }>(IMPLEMENTATIONS_FILE);
   const index = data.implementations.findIndex((i) => i.id === id);
   if (index !== -1) {
@@ -420,7 +442,7 @@ async function runImplementation(
   implId: string,
   timeoutMs: number = 300000,
   options: { model?: string; scoped?: boolean } = {}
-): Promise<boolean> {
+): Promise<void> {
   requireClaudeCLI('implementation');
 
   const modelLabel = options.model ? ` (model: ${options.model})` : '';
@@ -443,7 +465,7 @@ async function runImplementation(
 
   claudeArgs.push('-p', prompt);
 
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
     const claude = spawn('claude', claudeArgs, {
       cwd: workspacePath,
       env: { ...process.env },
@@ -475,7 +497,7 @@ async function runImplementation(
         setTimeout(() => {
           try { claude.kill('SIGKILL'); } catch {}
         }, 5000);
-        resolve(false);
+        reject(new Error(`Implementation timed out after ${timeoutMs / 1000}s`));
       }
     }, timeoutMs);
 
@@ -499,10 +521,10 @@ async function runImplementation(
       const elapsed = Math.round((Date.now() - startTime) / 1000);
       if (code === 0) {
         addLog(implId, `Claude Code completed successfully in ${elapsed}s (${output.length} chars)`);
-        resolve(true);
+        resolve();
       } else {
         addLog(implId, `Claude Code exited with code ${code} after ${elapsed}s`);
-        resolve(false);
+        reject(new Error(`Claude Code exited with code ${code}`));
       }
     });
 
@@ -511,7 +533,7 @@ async function runImplementation(
       isResolved = true;
       clearTimeout(timeout);
       addLog(implId, `Claude Code error: ${error.message}`);
-      resolve(false);
+      reject(error);
     });
   });
 }
@@ -618,11 +640,29 @@ async function main(): Promise<void> {
   if (createPrOnly) console.log(`Mode: Create PR only`);
 
   // Load config and idea
-  const config = loadConfig();
-  const idea = loadIdea(ideaId);
+  let config: ReturnType<typeof loadConfig>;
+  try {
+    config = loadConfig();
+  } catch (err: unknown) {
+    const e = err as Error;
+    console.error('[implement] Failed to load config', { error: e.message, file: CONFIG_FILE });
+    console.error(`[implement] Cannot continue without config — exiting. Check that ${CONFIG_FILE} exists and contains valid JSON.`);
+    process.exit(1);
+  }
+
+  let idea: ReturnType<typeof loadIdea>;
+  try {
+    idea = loadIdea(ideaId);
+  } catch (err: unknown) {
+    const e = err as Error;
+    console.error('[implement] Failed to load idea', { ideaId, error: e.message, file: IDEAS_FILE });
+    console.error(`[implement] Cannot continue without idea record — exiting. Check that ${IDEAS_FILE} exists and contains valid JSON.`);
+    process.exit(1);
+  }
 
   if (!idea) {
-    console.error(`Idea not found: ${ideaId}`);
+    console.error('[implement] Failed to load idea', { ideaId, error: 'idea not found in ideas file', file: IDEAS_FILE });
+    console.error(`[implement] Idea ${ideaId} not found — exiting.`);
     process.exit(1);
   }
 
@@ -657,7 +697,14 @@ async function main(): Promise<void> {
   console.log(`Workspace: ${config.workspace_dir}`);
 
   // Try to reuse an existing implementation session
-  const implData = loadJson<{ implementations: ImplementationSession[] }>(IMPLEMENTATIONS_FILE);
+  let implData: { implementations: ImplementationSession[] };
+  try {
+    implData = loadJson<{ implementations: ImplementationSession[] }>(IMPLEMENTATIONS_FILE);
+  } catch (err: unknown) {
+    const e = err as Error;
+    console.error('[implement] Failed to load implementations file, falling back to fresh session', { error: e.message, file: IMPLEMENTATIONS_FILE });
+    implData = { implementations: [] };
+  }
   const existingImpl = implData.implementations.find(
     (i) => i.idea_id === ideaId && i.status !== 'failed' && i.status !== 'completed'
   );
@@ -745,15 +792,11 @@ async function main(): Promise<void> {
     // Run implementation
     updateImplementation(impl.id, { status: 'implementing' });
     const prompt = generatePrompt(idea, scope);
-    const success = await runImplementation(workspacePath, prompt, impl.id, timeout, {
+    await runImplementation(workspacePath, prompt, impl.id, timeout, {
       model: model || (scope ? 'sonnet' : undefined), // Default to sonnet for sub-tasks
       scoped: !!scope,
     });
 
-    if (!success) {
-      throw new Error('Implementation failed');
-    }
-
     // Check for changes and commit
     if (hasChanges(workspacePath)) {
       addLog(impl.id, 'Changes detected, staging and committing...');
@@ -843,11 +886,18 @@ async function main(): Promise<void> {
     addLog(impl.id, `Error: ${err.message}`);
     updateImplementation(impl.id, {
       status: 'failed',
+      error_message: err.message,
     });
+    revertIdeaStage(ideaId, `Implementation failed: ${err.message}`);
+    console.error('[implement] Fatal error', { ideaId, implId: impl.id, error: err.message, stack: err.stack });
     console.error(`\n=== Implementation Failed ===`);
     console.error(err.message);
     process.exit(1);
   }
 }
 
-main().catch(console.error);
+// Only run main() when executed directly (not when imported in tests)
+const _scriptPath = process.argv[1] ?? '';
+if (_scriptPath.endsWith('implement.ts') || _scriptPath.endsWith('implement.js')) {
+  main().catch(console.error);
+}

package/.next/standalone/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{},"webpack":null,"eslint":{"ignoreDuringBuilds":false},"typescript":{"ignoreBuildErrors":false,"tsconfigPath":"tsconfig.json"},"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.js","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"analyticsId":"","images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[16,32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":60,"formats":["image/webp"],"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"inline","remotePatterns":[],"unoptimized":false},"devIndicators":{"buildActivity":true,"buildActivityPosition":"bottom-right"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"amp":{"canonicalBase":""},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"optimizeFonts":true,"excludeDefaultMomentLocales":true,"serverRuntimeConfig":{},"publicRuntimeConfig":{},"reactProductionProfiling":false,"reactStrictMode":true,"httpAgentOptions":{"keepAlive":true},"outputFileTracing":true,"staticPageGenerationTimeout":60,"swcMinify":true,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"experimental":{"multiZoneDraftMode":false,"prerenderEarlyExit":false,"serverMinification":true,"serverSourceMaps":false,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","middlewarePrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"outputFileTracingRoot":"/Users/luismey/Code/vibebusiness","swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"adjustFontFallbacks":false,"adjustFontFallbacksWithSizeAdjust":false,"typedRoutes":false,"instrumentationHook":false,"bundlePagesExternals":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"missingSuspenseWithCSRBailout":true,"optimizeServerReact":true,"useEarlyImport":false,"staleTimes":{"dynamic":30,"static":300},"optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"configFileName":"next.config.js"}
+const nextConfig = {"env":{},"webpack":null,"eslint":{"ignoreDuringBuilds":false},"typescript":{"ignoreBuildErrors":false,"tsconfigPath":"tsconfig.json"},"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.js","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"analyticsId":"","images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[16,32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":60,"formats":["image/webp"],"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"inline","remotePatterns":[],"unoptimized":false},"devIndicators":{"buildActivity":true,"buildActivityPosition":"bottom-right"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"amp":{"canonicalBase":""},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"optimizeFonts":true,"excludeDefaultMomentLocales":true,"serverRuntimeConfig":{},"publicRuntimeConfig":{},"reactProductionProfiling":false,"reactStrictMode":true,"httpAgentOptions":{"keepAlive":true},"outputFileTracing":true,"staticPageGenerationTimeout":60,"swcMinify":true,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"experimental":{"multiZoneDraftMode":false,"prerenderEarlyExit":false,"serverMinification":true,"serverSourceMaps":false,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","middlewarePrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":11,"memoryBasedWorkersCount":false,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"outputFileTracingRoot":"/Users/luismey/Code/100xmanager","swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"adjustFontFallbacks":false,"adjustFontFallbacksWithSizeAdjust":false,"typedRoutes":false,"instrumentationHook":false,"bundlePagesExternals":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"missingSuspenseWithCSRBailout":true,"optimizeServerReact":true,"useEarlyImport":false,"staleTimes":{"dynamic":30,"static":300},"optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"configFileName":"next.config.js"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/.next/standalone/templates/commands/distribution-google-ads.md

@@ -0,0 +1,86 @@
+# /distribution-google-ads — Google Ads Campaign Playbook
+
+## Usage
+```
+/distribution-google-ads              # Full campaign design
+/distribution-google-ads {keyword}    # Campaign for specific keyword cluster
+```
+
+## Input
+- `$ARGUMENTS` — optional: specific keyword or keyword cluster to target
+
+## Process
+
+### Step 1: Load Context
+1. Read `data/positioning.json` — value proposition, target audience, differentiators
+2. Read `data/competitors.json` — competitor SEO keywords, growth channels
+3. Read `data/business-context.json` — product name, funnels, KPIs, monetization
+
+### Step 2: Keyword Research
+Use WebSearch to find keyword opportunities:
+- `"[product category] google ads keywords [year]"`
+- `"[product category] search volume CPC benchmarks"`
+- `"[competitor name] google ads keywords"` (for each top competitor)
+- `"[product pain point] solution"` (problem-aware searches)
+
+For each keyword group, estimate:
+- Monthly search volume
+- Average CPC
+- Competition level (low/medium/high)
+- Commercial intent (informational/commercial/transactional)
+
+### Step 3: Campaign Structure
+Design campaigns following Google Ads best practices:
+
+```
+Campaign: [Product Category] — Search
+├── Ad Group: Brand Terms
+│   ├── Keywords: [product name], [product name] review, [product name] pricing
+│   └── Negative: free, open source, tutorial
+├── Ad Group: Problem-Aware
+│   ├── Keywords: [pain point] solution, how to [solve problem]
+│   └── Negative: DIY, manual
+├── Ad Group: Competitor Terms
+│   ├── Keywords: [competitor] alternative, [competitor] vs
+│   └── Negative: [competitor] login, [competitor] support
+└── Ad Group: Category Terms
+    ├── Keywords: best [category] tool, [category] software
+    └── Negative: free, open source
+```
+
+### Step 4: Generate Ad Copy
+For each ad group, queue copy generation:
+- `/promo-copy ad-google {keyword}` — generates 3 headlines (30 chars) + 2 descriptions (90 chars)
+- Ensure copy matches keyword intent
+- Include call-to-action aligned with landing page
+
+### Step 5: Landing Page Recommendations
+For each ad group:
+- Map to existing page if available (check `data/pages.json`)
+- If no matching page exists, queue `/build-page {slug}` with ad-specific messaging
+- Ensure landing page has conversion tracking (PostHog events)
+
+### Step 6: Budget & Bidding Strategy
+Recommend starting budget:
+- **Phase 1 (Week 1-2):** $10-15/day across all ad groups — gather data
+- **Phase 2 (Week 3-4):** Pause underperformers, double down on winners — $15-20/day
+- **Bidding:** Start with Maximize Clicks, switch to Target CPA after 30 conversions
+
+### Step 7: Conversion Tracking
+Define tracking setup:
+- UTM parameters: `utm_source=google&utm_medium=cpc&utm_campaign={campaign-slug}&utm_content={ad-group}`
+- PostHog events to track: page_view, signup_started, signup_completed
+- Google Ads conversion action: signup_completed
+
+### Step 8: Output
+For each campaign, create an idea in `data/ideas.json` with:
+- Category: "growth"
+- Tags: ["growth", "google-ads", "{keyword-group}"]
+- Implementation plan with full campaign structure
+- Success metrics: impressions, clicks, CTR, CPC, conversions, CPA
+- Budget recommendation
+- Queue `copy-ad-google-{keyword}` tasks
+
+## Output Files
+- `data/ideas.json` — new Google Ads campaign ideas
+- `data/campaigns/` — campaign briefs (optional)

package/.next/standalone/templates/commands/distribution-meta-ads.md

@@ -0,0 +1,106 @@
+# /distribution-meta-ads — Meta/Instagram Ads Campaign Playbook
+
+## Usage
+```
+/distribution-meta-ads                # Full campaign design
+/distribution-meta-ads {audience}     # Campaign for specific audience segment
+```
+
+## Input
+- `$ARGUMENTS` — optional: specific audience segment to target
+
+## Process
+
+### Step 1: Load Context
+1. Read `data/positioning.json` — value proposition, target audience, pain points
+2. Read `data/business-context.json` — product name, funnels, KPIs
+3. Read `data/competitors.json` — competitor ad strategies
+
+### Step 2: Audience Research
+Use WebSearch to find audience targeting opportunities:
+- `"[product category] facebook ads benchmarks CPM CPC CPA [year]"`
+- `"[product category] facebook ads targeting"`
+- `"[target audience] interests facebook ads"`
+
+Define audience segments:
+
+**Segment 1: Interest-Based (Cold)**
+- Interests: [product category tools], [competitor names], [related technologies]
+- Demographics: [age range], [job titles if B2B]
+- Estimated audience size
+
+**Segment 2: Behavior-Based (Warm)**
+- Behaviors: Technology early adopters, SaaS users, [industry-specific]
+- Layered with interests for precision
+
+**Segment 3: Retargeting (Hot)**
+- Website visitors (last 30 days) who didn't convert
+- Pricing page visitors (last 14 days)
+- Blog readers (last 60 days)
+
+**Segment 4: Lookalike**
+- Based on existing signups/customers
+- 1% lookalike for precision, 3-5% for reach
+
+### Step 3: Campaign Structure
+Design campaigns following Meta Ads best practices:
+
+```
+Campaign: [Product] — Conversions
+├── Ad Set: Interest-Based (Cold)
+│   ├── Audience: [interests + demographics]
+│   ├── Placement: Feed + Stories (auto)
+│   └── Budget: $5/day
+├── Ad Set: Retargeting (Hot)
+│   ├── Audience: Website visitors 30d, excl. signups
+│   ├── Placement: Feed + Stories (auto)
+│   └── Budget: $3/day
+└── Ad Set: Lookalike 1%
+    ├── Audience: Lookalike of signups
+    ├── Placement: Feed + Stories (auto)
+    └── Budget: $5/day
+```
+
+### Step 4: Generate Ad Copy
+For each audience segment, queue copy generation:
+- `/promo-copy ad-meta {audience}` — generates primary text + headline + CTA
+- Match messaging to audience temperature (cold=educate, warm=convince, hot=convert)
+
+### Step 5: Creative Format Recommendations
+For each ad set, recommend creative format:
+- **Cold audiences:** Carousel (3-5 feature cards) or short video (15-30s)
+- **Retargeting:** Single image with social proof / testimonial
+- **Lookalike:** Video demo or before/after comparison
+
+If video skills are available, queue `/promo-video ad-{topic}` for video creatives.
+
+### Step 6: Budget & Schedule
+- **Total daily budget:** $10-15/day starting
+- **Split:** 40% cold, 20% retargeting, 40% lookalike
+- **Schedule:** Run 7 days, then evaluate
+- **Dayparting:** If relevant, focus on business hours for B2B
+
+### Step 7: A/B Test Plan
+For each ad set:
+- Test 2-3 ad copy variations
+- Test 2 creative formats (image vs carousel vs video)
+- Measure for 7 days before declaring winner
+- Winning criteria: lowest CPA or highest CTR (depending on objective)
+
+### Step 8: Tracking
+- UTM parameters: `utm_source=meta&utm_medium=paid&utm_campaign={campaign-slug}&utm_content={ad-set}`
+- Pixel events: ViewContent, Lead, CompleteRegistration
+- CAPI (Conversions API) setup recommendation if not configured
+
+### Step 9: Output
+For each campaign, create an idea in `data/ideas.json` with:
+- Category: "growth"
+- Tags: ["growth", "meta-ads", "{audience-segment}"]
+- Implementation plan with campaign structure
+- Success metrics: impressions, reach, CPM, CPC, CTR, conversions, CPA
+- Budget recommendation
+- Queue `copy-ad-meta-{audience}` tasks
+
+## Output Files
+- `data/ideas.json` — new Meta Ads campaign ideas
+- `data/campaigns/` — campaign briefs (optional)