edsger 0.30.4 → 0.31.1

package/.claude/settings.local.json

@@ -1,28 +1,8 @@
 {
   "permissions": {
     "allow": [
-      "Read(//Users/steven/development/edsger/**)",
-      "Bash(npm run build)",
-      "Bash(node:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(ls:*)",
-      "Bash(cat:*)",
-      "Bash(npm run typecheck:*)",
-      "Bash(git diff:*)",
-      "WebSearch",
-      "WebFetch(domain:supabase.com)",
-      "Bash(npm install:*)",
-      "Bash(grep:*)",
-      "Bash(npx supabase gen types typescript --help:*)",
-      "Bash(git -C /Users/steven/development/edsger status)",
-      "Bash(git -C /Users/steven/development/edsger diff)",
-      "Bash(git -C /Users/steven/development/edsger log --oneline -5)",
-      "Bash(git -C /Users/steven/development/edsger add supabase/migrations/20251231000000_drop_unused_views.sql)",
-      "Bash(git -C /Users/steven/development/edsger commit -m \"$\\(cat <<''EOF''\nchore: drop unused database views\n\nRemove test_report_summary and user_stories_with_context views that are defined but never used in the application.\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
-      "Bash(git -C /Users/steven/development/edsger commit -m \"$\\(cat <<''EOF''\nchore: drop unused database views\n\nRemove test_report_summary and user_stories_with_context views\nthat are defined but never used in the application.\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")"
-    ],
-    "deny": [],
-    "ask": []
+      "Bash(npx tsc:*)",
+      "Bash(npm run:*)"
+    ]
   }
 }

package/dist/api/github.d.ts

@@ -39,6 +39,17 @@ export declare function getGitHubDeveloperConfig(featureId: string, verbose?: bo
  * Get installation access token for GitHub API operations
  */
 export declare function getGitHubInstallationToken(installationId: number, featureId: string, verbose?: boolean): Promise<GitHubInstallationToken | null>;
+/**
+ * Get GitHub config and token by product ID (no feature required).
+ * Used for product-level operations like growth analysis.
+ */
+export declare function getGitHubConfigByProduct(productId: string, verbose?: boolean): Promise<{
+    configured: boolean;
+    token?: string;
+    owner?: string;
+    repo?: string;
+    message?: string;
+}>;
 /**
  * Get GitHub config and token in one call
  * This is the main entry point for getting GitHub config

package/dist/api/github.js

@@ -59,6 +59,50 @@ export async function getGitHubInstallationToken(installationId, featureId, verb
         return null;
     }
 }
+/**
+ * Get GitHub config and token by product ID (no feature required).
+ * Used for product-level operations like growth analysis.
+ */
+export async function getGitHubConfigByProduct(productId, verbose) {
+    if (verbose) {
+        console.log(`🔍 Fetching GitHub config for product: ${productId}`);
+    }
+    try {
+        const result = (await callMcpEndpoint('github/config_and_token_by_product', {
+            product_id: productId,
+        }));
+        if (verbose) {
+            if (result.configured) {
+                console.log(`✅ GitHub ready: ${result.repository_full_name}`);
+            }
+            else {
+                console.log(`⚠️ GitHub not configured: ${result.message}`);
+            }
+        }
+        if (result.configured && result.token && result.owner && result.repo) {
+            return {
+                configured: true,
+                token: result.token,
+                owner: result.owner,
+                repo: result.repo,
+            };
+        }
+        return {
+            configured: false,
+            message: result.message ||
+                'GitHub not configured for this product. Set repo and developer_id in product settings.',
+        };
+    }
+    catch (error) {
+        if (verbose) {
+            console.error('❌ Failed to get GitHub config for product:', error);
+        }
+        return {
+            configured: false,
+            message: error instanceof Error ? error.message : 'Failed to get GitHub config',
+        };
+    }
+}
 /**
  * Get GitHub config and token in one call
  * This is the main entry point for getting GitHub config

package/dist/auth/auth-store.d.ts

@@ -50,3 +50,16 @@ export declare function getEdsgerBaseUrl(): string;
  * Get the auth file path (for display purposes)
  */
 export declare function getAuthFilePath(): string;
+/**
+ * Watch the auth file for external changes (e.g., from Edsger Desktop app).
+ * When the file changes, the in-memory cache is invalidated so the CLI
+ * picks up new auth credentials automatically.
+ *
+ * @param onChange - Optional callback invoked when auth config changes
+ * @returns A function to stop watching
+ */
+export declare function watchAuthFile(onChange?: (config: AuthConfig | null) => void): () => void;
+/**
+ * Stop watching the auth file
+ */
+export declare function stopWatchingAuthFile(): void;

package/dist/auth/auth-store.js

@@ -4,7 +4,7 @@
  * Stores auth credentials in ~/.edsger/auth.json
  * Provides read/write/clear operations for auth tokens
  */
-import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, chmodSync } from 'fs';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, chmodSync, watch } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 const EDSGER_DIR = join(homedir(), '.edsger');
@@ -115,3 +115,40 @@ export function getEdsgerBaseUrl() {
 export function getAuthFilePath() {
     return AUTH_FILE;
 }
+/** Active file watcher for auth file changes */
+let _authWatcher = null;
+/**
+ * Watch the auth file for external changes (e.g., from Edsger Desktop app).
+ * When the file changes, the in-memory cache is invalidated so the CLI
+ * picks up new auth credentials automatically.
+ *
+ * @param onChange - Optional callback invoked when auth config changes
+ * @returns A function to stop watching
+ */
+export function watchAuthFile(onChange) {
+    // Stop any existing watcher
+    stopWatchingAuthFile();
+    ensureEdsgerDir();
+    _authWatcher = watch(EDSGER_DIR, (eventType, filename) => {
+        if (filename !== 'auth.json')
+            return;
+        // Invalidate cache so next loadAuth() reads from disk
+        _authCache = undefined;
+        const config = loadAuth();
+        if (onChange) {
+            onChange(config);
+        }
+    });
+    // Don't keep the process alive just for the watcher
+    _authWatcher.unref();
+    return () => stopWatchingAuthFile();
+}
+/**
+ * Stop watching the auth file
+ */
+export function stopWatchingAuthFile() {
+    if (_authWatcher) {
+        _authWatcher.close();
+        _authWatcher = null;
+    }
+}

package/dist/index.js

@@ -72,6 +72,25 @@ program
     }
 });
 // ============================================================
+// Subcommand: edsger growth <productId>
+// ============================================================
+program
+    .command('growth <productId>')
+    .description('Run AI-powered growth analysis for a product')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (productId, opts) => {
+    try {
+        await runGrowthAnalysis({
+            growthAnalysis: productId,
+            verbose: opts.verbose,
+        });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
 // Default command (options-based, backward compatible)
 // ============================================================
 program
@@ -80,7 +99,6 @@ program
     .option('-f, --files <patterns...>', 'Review specific file patterns')
     .option('--refactor', 'Refactor code in current directory')
     .option('--init', 'Initialize .edsger directory with project templates')
-    .option('--growth-analysis <productId>', 'Run AI-powered growth analysis for a product')
     .option('--product-level', 'Use legacy product-level workflow (requires EDSGER_PRODUCT_ID, EDSGER_MCP_SERVER_URL, EDSGER_MCP_TOKEN env vars)')
     .option('--watch-tasks <productId>', 'Watch and execute pending tasks for a product')
     .option('--concurrency <number>', 'Max concurrent features to process (default: 3)', parseInt)
@@ -106,11 +124,6 @@ export const runEdsger = async (options) => {
         await runTaskWorker(options);
         return;
     }
-    // Handle growth analysis mode
-    if (options.growthAnalysis) {
-        await runGrowthAnalysis(options);
-        return;
-    }
     // Handle refactor mode
     if (options.refactor) {
         await runRefactor(options);

package/dist/phases/code-refine/context.js

@@ -5,6 +5,7 @@
 import { Octokit } from '@octokit/rest';
 import { getFeature } from '../../api/features/get-feature.js';
 import { downloadImagesForClaudeCode } from '../../utils/image-downloader.js';
+import { getMcpServerUrl, getMcpToken } from '../../auth/auth-store.js';
 /**
  * Extract owner, repo, and PR number from GitHub PR URL
  */
@@ -183,8 +184,8 @@ export async function fetchUserStories(featureId, verbose) {
         if (verbose) {
             console.log(`📖 Fetching user stories for ${featureId}...`);
         }
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {
@@ -230,8 +231,8 @@ export async function fetchTestCases(featureId, verbose) {
         if (verbose) {
             console.log(`🧪 Fetching test cases for ${featureId}...`);
         }
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {

package/dist/phases/code-review/context.js

@@ -4,6 +4,7 @@
  */
 import { Octokit } from '@octokit/rest';
 import { getFeature } from '../../api/features/get-feature.js';
+import { getMcpServerUrl, getMcpToken } from '../../auth/auth-store.js';
 /**
  * Extract owner, repo, and PR number from GitHub PR URL
  */
@@ -79,8 +80,8 @@ export async function fetchUserStories(featureId, verbose) {
         if (verbose) {
             console.log(`📖 Fetching user stories for ${featureId}...`);
         }
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {
@@ -126,8 +127,8 @@ export async function fetchTestCases(featureId, verbose) {
         if (verbose) {
             console.log(`🧪 Fetching test cases for ${featureId}...`);
         }
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {

package/dist/phases/functional-testing/analyzer.js

@@ -8,6 +8,7 @@ import { fetchFunctionalTestingContext, formatContextForPrompt, } from './contex
 import { updateFeatureStatus } from '../../api/features/index.js';
 import { createTestReport, } from './test-report-creator.js';
 import { preparePhaseGitEnvironment, prepareCustomBranchGitEnvironment, } from '../../utils/git-branch-manager.js';
+import { getMcpServerUrl, getMcpToken } from '../../auth/auth-store.js';
 import { getReadyForReviewBranch, } from '../../services/branches.js';
 function userMessage(content) {
     return {
@@ -299,8 +300,8 @@ export const runFunctionalTesting = async (options, config, checklistContext) =>
                 structuredTestResult.test_cases.length > 0) {
                 // Fetch test cases for this feature to get proper test_case_ids
                 try {
-                    const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-                    const mcpToken = process.env.EDSGER_MCP_TOKEN;
+                    const mcpServerUrl = getMcpServerUrl();
+                    const mcpToken = getMcpToken();
                     const testCasesResponse = await fetch(`${mcpServerUrl}/mcp`, {
                         method: 'POST',
                         headers: {

package/dist/phases/functional-testing/http-fallback.js

@@ -1,12 +1,13 @@
 import { logInfo, logError } from '../../utils/logger.js';
+import { getMcpServerUrl, getMcpToken } from '../../auth/auth-store.js';
 export async function saveFunctionalTestResultsViaHttp(options) {
     const { featureId, testStatus, testResults: _testResults, verbose } = options;
     try {
         if (verbose) {
             logInfo('🔄 Attempting to save functional test results via HTTP fallback...');
         }
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {
@@ -47,8 +48,8 @@ export async function verifyTestStatusSaved(featureId, verbose, expectedStatus)
         if (verbose) {
             logInfo('🔍 Verifying test status was saved...');
         }
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {

package/dist/phases/functional-testing/test-report-creator.js

@@ -1,4 +1,5 @@
 import { logInfo, logError } from '../../utils/logger.js';
+import { getMcpServerUrl, getMcpToken } from '../../auth/auth-store.js';
 /**
  * Create a test report via MCP endpoint
  * Uses structured data generated by Claude Code
@@ -23,8 +24,8 @@ export async function createTestReport(options) {
         timestamp: new Date().toISOString(),
     };
     try {
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         // Try to create test report via MCP endpoint
         // Claude Code should call this endpoint directly with the structured data
         const response = await fetch(`${mcpServerUrl}/mcp`, {
@@ -103,8 +104,8 @@ export async function createTestReportResults(options) {
         logInfo(`Creating ${testResults.length} test report results for report: ${testReportId}`);
     }
     try {
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',
             headers: {
@@ -157,8 +158,8 @@ async function manualMcpTestReportCreation(featureId, structuredReport, testResu
         logInfo('Manually calling MCP test_reports/create endpoint with structured data');
     }
     try {
-        const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-        const mcpToken = process.env.EDSGER_MCP_TOKEN;
+        const mcpServerUrl = getMcpServerUrl();
+        const mcpToken = getMcpToken();
         // Manually construct and send the MCP request
         const response = await fetch(`${mcpServerUrl}/mcp`, {
             method: 'POST',

package/dist/phases/growth-analysis/agent.d.ts

@@ -1,2 +1,2 @@
 import { EdsgerConfig } from '../../types/index.js';
-export declare function executeGrowthAnalysisQuery(currentPrompt: string, systemPrompt: string, config: EdsgerConfig, verbose?: boolean): Promise<any | null>;
+export declare function executeGrowthAnalysisQuery(currentPrompt: string, systemPrompt: string, config: EdsgerConfig, verbose?: boolean, cwd?: string): Promise<any | null>;

package/dist/phases/growth-analysis/agent.js

@@ -38,7 +38,7 @@ function userMessage(content) {
 async function* prompt(analysisPrompt) {
     yield userMessage(analysisPrompt);
 }
-export async function executeGrowthAnalysisQuery(currentPrompt, systemPrompt, config, verbose) {
+export async function executeGrowthAnalysisQuery(currentPrompt, systemPrompt, config, verbose, cwd) {
     let lastAssistantResponse = '';
     let structuredResult = null;
     for await (const message of query({
@@ -52,6 +52,7 @@ export async function executeGrowthAnalysisQuery(currentPrompt, systemPrompt, co
             model: DEFAULT_MODEL,
             maxTurns: 1000,
             permissionMode: 'bypassPermissions',
+            ...(cwd ? { cwd } : {}),
         },
     })) {
         if (verbose) {

package/dist/phases/growth-analysis/context.d.ts

@@ -15,7 +15,7 @@ export declare function formatContextForPrompt(context: GrowthAnalysisContext):
 /**
  * Prepare the full analysis prompt with all context
  */
-export declare function prepareGrowthAnalysisContext(productId: string, verbose?: boolean): Promise<{
+export declare function prepareGrowthAnalysisContext(productId: string, verbose?: boolean, hasCodebase?: boolean): Promise<{
     context: GrowthAnalysisContext;
     analysisPrompt: string;
 }>;

package/dist/phases/growth-analysis/context.js

@@ -40,6 +40,11 @@ export function formatContextForPrompt(context) {
    Created: ${c.created_at}`)
             .join('\n\n')
         : 'No previous campaigns.';
+    const featuresList = product.features && product.features.length > 0
+        ? product.features
+            .map((f) => `- **${f.name}**: ${f.description || 'No description'} (Status: ${f.status || 'unknown'})`)
+            .join('\n')
+        : 'No features listed.';
     return `# Growth Analysis Context
 
 ## Product Information
@@ -47,22 +52,25 @@ export function formatContextForPrompt(context) {
 - **Product ID**: ${product.id}
 - **Description**: ${product.description || 'No description provided'}
 
+## Product Features (${product.features?.length || 0})
+${featuresList}
+
 ## Previous Growth Campaigns (${previousCampaigns.length})
 ${campaignsList}
 
 ---
 
-**Important**: Analyze the product above and create a growth strategy. Each content suggestion must be DIFFERENT from all previous campaigns listed above.`;
+**Important**: Analyze the product above and create a growth strategy. Each content suggestion must be DIFFERENT from all previous campaigns listed above. Use the product name, description, and features to write specific, concrete content — never use placeholder text.`;
 }
 /**
  * Prepare the full analysis prompt with all context
  */
-export async function prepareGrowthAnalysisContext(productId, verbose) {
+export async function prepareGrowthAnalysisContext(productId, verbose, hasCodebase = false) {
     if (verbose) {
         logInfo('Fetching growth analysis context via MCP endpoints...');
     }
     const context = await fetchGrowthAnalysisContext(productId, verbose);
     const contextInfo = formatContextForPrompt(context);
-    const analysisPrompt = createGrowthAnalysisPromptWithContext(productId, contextInfo);
+    const analysisPrompt = createGrowthAnalysisPromptWithContext(productId, contextInfo, hasCodebase);
     return { context, analysisPrompt };
 }

package/dist/phases/growth-analysis/index.js

@@ -3,18 +3,41 @@ import { prepareGrowthAnalysisContext } from './context.js';
 import { createGrowthAnalysisSystemPrompt } from './prompts.js';
 import { executeGrowthAnalysisQuery } from './agent.js';
 import { saveGrowthAnalysis } from '../../api/growth.js';
+import { getGitHubConfigByProduct } from '../../api/github.js';
+import { ensureWorkspaceDir, cloneFeatureRepo, } from '../../workspace/workspace-manager.js';
 export const analyseGrowth = async (options, config) => {
     const { productId, verbose } = options;
     if (verbose) {
         logInfo(`Starting growth analysis for product ID: ${productId}`);
     }
     try {
-        const { context, analysisPrompt } = await prepareGrowthAnalysisContext(productId, verbose);
-        const systemPrompt = createGrowthAnalysisSystemPrompt();
+        // Clone product repo if GitHub is configured
+        let repoCwd;
+        try {
+            const githubConfig = await getGitHubConfigByProduct(productId, verbose);
+            if (githubConfig.configured &&
+                githubConfig.token &&
+                githubConfig.owner &&
+                githubConfig.repo) {
+                const workspaceRoot = ensureWorkspaceDir();
+                const { repoPath } = cloneFeatureRepo(workspaceRoot, `growth-${productId}`, githubConfig.owner, githubConfig.repo, githubConfig.token);
+                repoCwd = repoPath;
+                logInfo(`Repository cloned to: ${repoCwd}`);
+            }
+            else {
+                logInfo(`No GitHub repo configured for product, running without codebase access. ${githubConfig.message || ''}`);
+            }
+        }
+        catch (error) {
+            logInfo(`Could not clone repo (continuing without codebase): ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const hasCodebase = !!repoCwd;
+        const { context, analysisPrompt } = await prepareGrowthAnalysisContext(productId, verbose, hasCodebase);
+        const systemPrompt = createGrowthAnalysisSystemPrompt(hasCodebase);
         if (verbose) {
             logInfo('Starting AI query for growth analysis...');
         }
-        const analysisResult = await executeGrowthAnalysisQuery(analysisPrompt, systemPrompt, config, verbose);
+        const analysisResult = await executeGrowthAnalysisQuery(analysisPrompt, systemPrompt, config, verbose, repoCwd);
         if (!analysisResult) {
             throw new Error('No analysis results received');
         }

package/dist/phases/growth-analysis/prompts.d.ts

@@ -1,2 +1,2 @@
-export declare const createGrowthAnalysisSystemPrompt: () => string;
-export declare const createGrowthAnalysisPromptWithContext: (productId: string, contextInfo: string) => string;
+export declare const createGrowthAnalysisSystemPrompt: (hasCodebase?: boolean) => string;
+export declare const createGrowthAnalysisPromptWithContext: (productId: string, contextInfo: string, hasCodebase?: boolean) => string;

package/dist/phases/growth-analysis/prompts.js

@@ -1,14 +1,16 @@
-export const createGrowthAnalysisSystemPrompt = () => {
+export const createGrowthAnalysisSystemPrompt = (hasCodebase = false) => {
     return `You are an expert growth marketer and product strategist. Your task is to analyze a product and generate a comprehensive growth strategy with specific, actionable content recommendations for different channels.
 
 **Your Role**: Analyze the product, understand its target audience, review previous campaigns to avoid repetition, and create specific content pieces ready to be published on different platforms.
 
-**Analysis Process**:
-1. **Understand the Product**: Analyze the product's purpose, target audience, unique value proposition, and competitive positioning
-2. **Review Previous Campaigns**: Study past campaigns to understand what has been done, which channels were used, and avoid creating duplicate content
-3. **Research Current Trends**: Consider current industry trends, news, and timely topics relevant to the product
-4. **Identify Target Channels**: Recommend the best channels for growth based on the product's audience
-5. **Create Content Suggestions**: Generate specific, ready-to-publish content pieces for each recommended channel
+**Analysis Process**:${hasCodebase ? `
+1. **Explore the Codebase**: BEFORE writing any content, use your tools to explore the project's codebase. Read README files, CLAUDE.md, package.json, landing pages, documentation, and key source files to deeply understand what the product actually does, its features, technical architecture, and unique selling points. This is CRITICAL for writing specific, accurate content.
+2. **Understand the Product**: Based on your codebase exploration AND the provided context, build a complete picture of the product's purpose, target audience, unique value proposition, and competitive positioning` : `
+1. **Understand the Product**: Analyze the product's purpose, target audience, unique value proposition, and competitive positioning from the provided context`}
+${hasCodebase ? '3' : '2'}. **Review Previous Campaigns**: Study past campaigns to understand what has been done, which channels were used, and avoid creating duplicate content
+${hasCodebase ? '4' : '3'}. **Research Current Trends**: Consider current industry trends, news, and timely topics relevant to the product
+${hasCodebase ? '5' : '4'}. **Identify Target Channels**: Recommend the best channels for growth based on the product's audience
+${hasCodebase ? '6' : '5'}. **Create Content Suggestions**: Generate specific, ready-to-publish content pieces for each recommended channel${hasCodebase ? ', using real details from your codebase exploration' : ''}
 
 **Channel Expertise**:
 - Twitter/X: Short-form content, threads, engagement posts
@@ -30,6 +32,13 @@ export const createGrowthAnalysisSystemPrompt = () => {
 - Consider timing and relevance to current events
 - Content must be different from all previous campaigns
 
+**CRITICAL - NO PLACEHOLDERS**:
+- NEVER use placeholder brackets like [one-line value prop], [core problem], [link], [Screenshot], [Differentiator 1], etc.
+- ALL content must be fully written and ready to publish as-is
+- Use the actual product name, description, and features provided in the context to write concrete, specific content
+- If you don't have enough information for a detail (e.g., a URL or screenshot), either omit that part entirely or write around it naturally
+- The user should be able to copy-paste the content directly to the target platform without any edits
+
 **CRITICAL - Result Format**:
 You MUST return ONLY a JSON object. Do NOT include any text before or after the JSON.
 
@@ -67,22 +76,30 @@ You MUST return ONLY a JSON object. Do NOT include any text before or after the
 - Include a mix of content types (educational, promotional, community-building)
 - Consider the product's current stage and adjust strategy accordingly`;
 };
-export const createGrowthAnalysisPromptWithContext = (productId, contextInfo) => {
+export const createGrowthAnalysisPromptWithContext = (productId, contextInfo, hasCodebase = false) => {
+    const codebaseInstructions = hasCodebase
+        ? `
+**Step 1 - Explore the codebase FIRST**: Before writing anything, use your file reading and search tools to explore this project's codebase. Look at:
+- README.md, CLAUDE.md, package.json for project overview
+- Landing pages, marketing copy, or documentation for existing messaging
+- Key source files to understand what the product actually does technically
+- Any configuration or deployment files that reveal the tech stack
+
+**Step 2 - Analyze and create strategy**: Using your deep understanding from Step 1 plus the context above:`
+        : `
+**Analyze and create strategy**: Using the product context above:`;
     return `Please conduct comprehensive growth analysis for product ID: ${productId}
 
 ${contextInfo}
 
 ## Analysis Instructions
+${codebaseInstructions}
+1. Understand the product's real value proposition, target users, and competitive advantages
+2. Study the previous campaigns listed above - DO NOT suggest content that overlaps with what has already been published
+3. Identify the most effective channels for reaching this product's target audience
+4. Generate specific, ready-to-publish content pieces using REAL details${hasCodebase ? ' from the codebase (actual feature names, real technical details, concrete benefits)' : ' from the product context above'}
 
-Analyze the product above and create a growth strategy:
-
-1. **Product Analysis**: Understand the product's value proposition, target users, and competitive advantages
-2. **Previous Campaigns Review**: Study the previous campaigns listed above - DO NOT suggest content that overlaps with what has already been published
-3. **Channel Strategy**: Identify the most effective channels for reaching this product's target audience
-4. **Content Creation**: Generate specific, ready-to-publish content pieces for each recommended channel
-5. **Differentiation**: Ensure every suggested content piece is fresh and different from previous campaigns
-
-Focus on actionable, specific content that can be published immediately. Avoid generic advice.
+**CRITICAL**: Every content piece must be ready to copy-paste and publish. Use actual product details, not placeholders.
 
 Return ONLY the JSON response as specified in your instructions.`;
 };

package/dist/services/feedbacks.js

@@ -2,6 +2,7 @@
  * Feedbacks service for pipeline integration
  * Provides human-guided feedbacks to influence Claude Code behavior in each phase
  */
+import { getMcpServerUrl, getMcpToken } from '../auth/auth-store.js';
 import { downloadImagesForClaudeCode } from '../utils/image-downloader.js';
 /**
  * Fetch feedbacks for a specific phase
@@ -10,8 +11,8 @@ import { downloadImagesForClaudeCode } from '../utils/image-downloader.js';
  */
 export async function getFeedbacksForPhase(options, phase, branchId) {
     const { featureId, verbose } = options;
-    const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-    const mcpToken = process.env.EDSGER_MCP_TOKEN;
+    const mcpServerUrl = getMcpServerUrl();
+    const mcpToken = getMcpToken();
     // Convert phase name from hyphen to underscore format for database compatibility
     // e.g., 'feature-analysis' -> 'feature_analysis'
     const dbPhase = phase.replace(/-/g, '_');
@@ -207,8 +208,8 @@ function getPriorityBadge(priority) {
  * Used after successful verification to track which feedbacks have been addressed
  */
 export async function resolveFeedbacks(options, feedbackIds, verbose) {
-    const mcpServerUrl = process.env.EDSGER_MCP_SERVER_URL;
-    const mcpToken = process.env.EDSGER_MCP_TOKEN;
+    const mcpServerUrl = getMcpServerUrl();
+    const mcpToken = getMcpToken();
     if (!feedbackIds || feedbackIds.length === 0) {
         return;
     }

package/dist/services/lifecycle-agent/__tests__/phase-criteria.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Unit tests for phase quality criteria definitions
+ */
+export {};