edsger 0.56.2 → 0.57.0

package/dist/commands/product-test-cases/index.js

@@ -0,0 +1,40 @@
+/**
+ * CLI command: edsger product-test-cases <productId>
+ *
+ * Clones the product's repo, asks Claude to draft a product-level regression
+ * suite (deduped against existing approved + unapproved cases), saves the new
+ * ones as drafts, and cleans up the workspace.
+ */
+import { getGitHubConfigByProduct } from '../../api/github.js';
+import { generateProductTestCases } from '../../phases/product-test-cases/index.js';
+import { logError, logInfo, logSuccess } from '../../utils/logger.js';
+export async function runProductTestCases(productId, options) {
+    const { branch, verbose } = options;
+    logInfo(`Starting product test cases generation for product ${productId}`);
+    const githubConfig = await getGitHubConfigByProduct(productId, verbose);
+    if (!githubConfig.configured ||
+        !githubConfig.token ||
+        !githubConfig.owner ||
+        !githubConfig.repo) {
+        logError(`GitHub not configured for product ${productId}: ${githubConfig.message || 'No installation found'}`);
+        process.exit(1);
+    }
+    const result = await generateProductTestCases({
+        productId,
+        githubToken: githubConfig.token,
+        owner: githubConfig.owner,
+        repo: githubConfig.repo,
+        branch,
+        verbose,
+    });
+    if (result.status === 'success') {
+        logSuccess(result.message);
+        if (result.summary) {
+            logInfo(result.summary);
+        }
+    }
+    else {
+        logError(result.message);
+        process.exit(1);
+    }
+}

package/dist/commands/screen-flow/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI command: edsger screen-flow <productId> --flow-id <id>
+ *
+ * Maps the product's user-facing screens and transitions into a structured
+ * flow stored in screen_flows / screen_flow_nodes / screen_flow_edges.
+ *
+ * The desktop UI creates a pending screen_flows row first, then invokes
+ * the CLI with --flow-id; the CLI flips status running → success/failed
+ * and populates the nodes/edges tables.
+ */
+export interface ScreenFlowCliOptions {
+    flowId: string;
+    guidance?: string;
+    verbose?: boolean;
+}
+export declare function runScreenFlow(productId: string, options: ScreenFlowCliOptions): Promise<void>;

package/dist/commands/screen-flow/index.js

@@ -0,0 +1,45 @@
+/**
+ * CLI command: edsger screen-flow <productId> --flow-id <id>
+ *
+ * Maps the product's user-facing screens and transitions into a structured
+ * flow stored in screen_flows / screen_flow_nodes / screen_flow_edges.
+ *
+ * The desktop UI creates a pending screen_flows row first, then invokes
+ * the CLI with --flow-id; the CLI flips status running → success/failed
+ * and populates the nodes/edges tables.
+ */
+import { runScreenFlowPhase } from '../../phases/screen-flow/index.js';
+import { deregisterSession, registerSession, } from '../../system/session-manager.js';
+import { logError, logInfo, logSuccess } from '../../utils/logger.js';
+export async function runScreenFlow(productId, options) {
+    const { flowId, guidance, verbose } = options;
+    if (!productId) {
+        throw new Error('Product ID is required for screen-flow');
+    }
+    if (!flowId) {
+        throw new Error('--flow-id is required (the pending screen_flows row id)');
+    }
+    await registerSession({ command: 'screen-flow', productId });
+    logInfo(`Starting screen flow generation for product ${productId}`);
+    try {
+        const result = await runScreenFlowPhase({
+            productId,
+            flowId,
+            guidance,
+            verbose,
+        });
+        if (result.status === 'success') {
+            logSuccess(result.message);
+            if (result.summary) {
+                logInfo(`\nSummary: ${result.summary}`);
+            }
+        }
+        else {
+            logError(result.message);
+            process.exit(1);
+        }
+    }
+    finally {
+        await deregisterSession();
+    }
+}

package/dist/commands/user-psychology/index.d.ts

@@ -0,0 +1,7 @@
+import { type CliOptions } from '../../types/index.js';
+/**
+ * Run AI-powered user psychology analysis for a product. Reads the product
+ * repo, applies JTBD + Fogg + persona frameworks, and writes the structured
+ * profile back to user_psychology_analyses.
+ */
+export declare const runUserPsychologyAnalysis: (options: CliOptions) => Promise<void>;

package/dist/commands/user-psychology/index.js

@@ -0,0 +1,51 @@
+import { analyseUserPsychology, } from '../../phases/user-psychology/index.js';
+import { deregisterSession, registerSession, } from '../../system/session-manager.js';
+import { logError, logInfo, logSuccess } from '../../utils/logger.js';
+import { validateConfiguration } from '../../utils/validation.js';
+/**
+ * Run AI-powered user psychology analysis for a product. Reads the product
+ * repo, applies JTBD + Fogg + persona frameworks, and writes the structured
+ * profile back to user_psychology_analyses.
+ */
+export const runUserPsychologyAnalysis = async (options) => {
+    const productId = options.userPsychology;
+    if (!productId) {
+        throw new Error('Product ID is required for user psychology analysis');
+    }
+    const analysisId = options.userPsychologyAnalysisId;
+    if (!analysisId) {
+        throw new Error('--analysis-id is required (reserved by the desktop UI)');
+    }
+    const config = validateConfiguration(options);
+    await registerSession({ command: 'user-psychology', productId });
+    logInfo(`Starting user psychology analysis for product: ${productId}`);
+    try {
+        const result = await analyseUserPsychology({
+            productId,
+            analysisId,
+            verbose: options.verbose,
+            guidance: options.userPsychologyGuidance,
+        }, config);
+        if (result.status === 'success') {
+            logSuccess('User psychology analysis completed.');
+            logInfo(`  Personas: ${result.personaCount}`);
+            logInfo(`  Jobs-to-be-Done: ${result.jobCount}`);
+            logInfo(`  Pain points: ${result.painPointCount}`);
+            if (result.analysisId) {
+                logInfo(`  Analysis ID: ${result.analysisId}`);
+            }
+            logInfo('\nView full results in the Psychology tab of your product.');
+        }
+        else {
+            logError(`User psychology analysis failed: ${result.summary}`);
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        logError(`User psychology analysis failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+    finally {
+        await deregisterSession();
+    }
+};

package/dist/index.js

@@ -19,11 +19,13 @@ import { runFindBugs } from './commands/find-bugs/index.js';
 import { runFindFeatures } from './commands/find-features/index.js';
 import { parseCategoriesOption, runFindSmells, } from './commands/find-smells/index.js';
 import { runGrowthAnalysis } from './commands/growth-analysis/index.js';
+import { runScreenFlow } from './commands/screen-flow/index.js';
 import { runInit } from './commands/init/index.js';
 import { runIntelligence } from './commands/intelligence/index.js';
 import { runIssueAnalysisCommand } from './commands/issue-analysis/index.js';
 import { runPRResolve } from './commands/pr-resolve/index.js';
 import { runPRReview } from './commands/pr-review/index.js';
+import { runProductTestCases } from './commands/product-test-cases/index.js';
 import { runQualityBenchmarkCli } from './commands/quality-benchmark/index.js';
 import { runRefactor } from './commands/refactor/refactor.js';
 import { runReleaseSyncCommand } from './commands/release-sync/index.js';
@@ -34,6 +36,7 @@ import { runSyncSentryIssues } from './commands/sync-sentry-issues/index.js';
 import { runTaskWorker } from './commands/task-worker/index.js';
 import { runTechnicalDesignCommand } from './commands/technical-design/index.js';
 import { runTestCasesAnalysisCommand } from './commands/test-cases-analysis/index.js';
+import { runUserPsychologyAnalysis } from './commands/user-psychology/index.js';
 import { runUserStoriesAnalysisCommand } from './commands/user-stories-analysis/index.js';
 import { runWorkflow } from './commands/workflow/index.js';
 import { DEFAULT_MAX_FILES as FIND_ARCHITECTURE_DEFAULT_MAX_FILES } from './phases/find-architecture/index.js';
@@ -157,6 +160,51 @@ program
     }
 });
 // ============================================================
+// Subcommand: edsger screen-flow <productId>
+// ============================================================
+program
+    .command('screen-flow <productId>')
+    .description('Generate a structured screen flow (screens + transitions) for a product from its source code')
+    .requiredOption('--flow-id <id>', 'Pending screen_flows row id to populate')
+    .option('-g, --guidance <text>', 'Human direction for the AI (focus areas, exclusions)')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (productId, opts) => {
+    try {
+        await runScreenFlow(productId, {
+            flowId: opts.flowId,
+            guidance: opts.guidance,
+            verbose: opts.verbose,
+        });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
+// Subcommand: edsger user-psychology <productId>
+// ============================================================
+program
+    .command('user-psychology <productId>')
+    .description('Research the product target users and produce a structured psychographic profile (personas + JTBD + Fogg + messaging angles)')
+    .option('-v, --verbose', 'Verbose output')
+    .option('-g, --guidance <text>', 'Human direction for the AI (audience focus, market, segment)')
+    .requiredOption('--analysis-id <id>', 'ID of the pending analysis row to fill in (reserved by the desktop UI)')
+    .action(async (productId, opts) => {
+    try {
+        await runUserPsychologyAnalysis({
+            userPsychology: productId,
+            verbose: opts.verbose,
+            userPsychologyGuidance: opts.guidance,
+            userPsychologyAnalysisId: opts.analysisId,
+        });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
 // Subcommand: edsger financing-deck <productId>
 // ============================================================
 program
@@ -629,6 +677,23 @@ program
     }
 });
 // ============================================================
+// Subcommand: edsger product-test-cases <productId>
+// ============================================================
+program
+    .command('product-test-cases <productId>')
+    .description("Generate product-level regression test cases by exploring the product's repo. Existing approved cases are preserved; replaceable (draft / pending_approval) ones may be deleted and replaced.")
+    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (productId, opts) => {
+    try {
+        await runProductTestCases(productId, opts);
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
 // Subcommand: edsger pr-resolve <productId>
 // ============================================================
 program

package/dist/phases/analyze-logs/index.js

@@ -5,9 +5,11 @@
  * user's session logs (only if the latest log is >1 hour old), and creates
  * product_user_feedbacks for any issues or improvement suggestions found.
  */
-import { callMcpEndpoint } from '../../api/mcp-client.js';
+import { getProduct } from '../../api/products.js';
 import { getPendingLogsByUser, markLogsAnalyzed, } from '../../services/product-logs.js';
+import { getSupabase, hasSupabaseSession } from '../../supabase/client.js';
 import { logError, logInfo, logSuccess } from '../../utils/logger.js';
+import { callMcpEndpoint } from '../../api/mcp-client.js';
 import { executeLogAnalysis } from './agent.js';
 import { createAnalyzeLogsSystemPrompt, createAnalyzeLogsUserPrompt, } from './prompts.js';
 /**
@@ -19,9 +21,10 @@ export async function analyzeLogs(options) {
     // 1. Get product info for context
     let productName = productId;
     try {
-        const product = (await callMcpEndpoint('products/get', {
-            product_id: productId,
-        }));
+        // Use the shared product wrapper — it tries the user-JWT SDK path first
+        // and falls back to the resources/read MCP path when the row isn't
+        // directly accessible (e.g. slug lookup).
+        const product = (await getProduct(productId));
         if (product?.name) {
             productName = product.name;
         }
@@ -100,7 +103,7 @@ export async function analyzeLogs(options) {
 async function createFeedbacksFromAnalysis(productId, group, result, verbose) {
     for (const feedback of result.feedbacks) {
         try {
-            await callMcpEndpoint('product_user_feedbacks/create', {
+            const payload = {
                 product_id: productId,
                 category: feedback.category,
                 title: feedback.title,
@@ -119,7 +122,25 @@ async function createFeedbacksFromAnalysis(productId, group, result, verbose) {
                         to: group.logs[group.logs.length - 1]?.created_at,
                     },
                 },
-            });
+            };
+            let usedSdk = false;
+            if (hasSupabaseSession()) {
+                try {
+                    const { error } = await getSupabase()
+                        .from('product_user_feedbacks')
+                        .insert({ ...payload, status: 'new' });
+                    if (error) {
+                        throw new Error(error.message);
+                    }
+                    usedSdk = true;
+                }
+                catch {
+                    // Fall through to MCP
+                }
+            }
+            if (!usedSdk) {
+                await callMcpEndpoint('product_user_feedbacks/create', payload);
+            }
             if (verbose) {
                 logInfo(`Created feedback: [${feedback.category}] ${feedback.title}`);
             }

package/dist/phases/bug-fixing/context-fetcher.js

@@ -1,5 +1,6 @@
 import { getIssue, getTestCases, getUserStories, } from '../../api/issues/index.js';
 import { callMcpEndpoint } from '../../api/mcp-client.js';
+import { getSupabase, hasSupabaseSession } from '../../supabase/client.js';
 import { logError, logInfo } from '../../utils/logger.js';
 /**
  * Fetch all bug fixing context information via MCP endpoints
@@ -21,11 +22,31 @@ export async function fetchBugFixingContext(issueId, verbose) {
             if (verbose) {
                 logInfo('Fetching latest test report...');
             }
-            const testReportResult = (await callMcpEndpoint('test_reports/latest', {
-                issue_id: issueId,
-            }));
-            if (testReportResult.test_report) {
-                latestTestReport = testReportResult.test_report;
+            let raw = null;
+            if (hasSupabaseSession()) {
+                try {
+                    const { data, error } = await getSupabase()
+                        .from('test_reports')
+                        .select('*')
+                        .eq('issue_id', issueId)
+                        .order('created_at', { ascending: false })
+                        .limit(1)
+                        .maybeSingle();
+                    if (error) {
+                        throw new Error(error.message);
+                    }
+                    raw = data;
+                }
+                catch {
+                    // Fall through to MCP
+                }
+            }
+            if (raw == null) {
+                const testReportResult = (await callMcpEndpoint('test_reports/latest', { issue_id: issueId }));
+                raw = testReportResult.test_report ?? null;
+            }
+            if (raw) {
+                latestTestReport = raw;
             }
         }
         catch (error) {

package/dist/phases/find-features/index.js

@@ -15,6 +15,7 @@
 import { query } from '@anthropic-ai/claude-agent-sdk';
 import { callMcpEndpoint } from '../../api/mcp-client.js';
 import { DEFAULT_MODEL } from '../../constants.js';
+import { getSupabase, hasSupabaseSession } from '../../supabase/client.js';
 import { logError, logInfo, logSuccess, logWarning, } from '../../utils/logger.js';
 import { cleanupIssueRepo, cloneIssueRepo, ensureWorkspaceDir, syncRepoToRef, } from '../../workspace/workspace-manager.js';
 import { detectDefaultBranch } from '../find-shared/git.js';
@@ -211,11 +212,33 @@ async function fetchFeedbacks(productId, sinceIso) {
         //
         // NOT to be confused with `feedbacks/list_for_product`, which returns
         // Claude-Code phase feedback and is an internal-workflow artefact.
-        const result = (await callMcpEndpoint('product_user_feedbacks/list_for_product', {
-            product_id: productId,
-            since: sinceIso,
-        }));
-        const rows = result.feedbacks || [];
+        let rows = [];
+        let usedSdk = false;
+        if (hasSupabaseSession()) {
+            try {
+                const { data, error } = await getSupabase()
+                    .from('product_user_feedbacks')
+                    .select('*')
+                    .eq('product_id', productId)
+                    .gte('created_at', sinceIso)
+                    .order('created_at', { ascending: false });
+                if (error) {
+                    throw new Error(error.message);
+                }
+                rows = (data || []);
+                usedSdk = true;
+            }
+            catch {
+                // Fall through to MCP
+            }
+        }
+        if (!usedSdk) {
+            const result = (await callMcpEndpoint('product_user_feedbacks/list_for_product', {
+                product_id: productId,
+                since: sinceIso,
+            }));
+            rows = result.feedbacks || [];
+        }
         return rows.map((f) => ({
             id: f.id,
             body: f.title ? `${f.title}\n${f.description}`.trim() : f.description,
@@ -232,10 +255,31 @@ async function fetchIntelligenceReports(productId, focusReportId) {
     try {
         // `intelligence_reports` schema (20260327000000_create_intelligence.sql:69):
         // id, product_id, report_type, title, summary, full_report, …, created_at.
-        const result = (await callMcpEndpoint('intelligence/reports/list', {
-            product_id: productId,
-        }));
-        let reports = result.reports || [];
+        let reports = [];
+        let usedSdk = false;
+        if (hasSupabaseSession()) {
+            try {
+                const { data, error } = await getSupabase()
+                    .from('intelligence_reports')
+                    .select('id, title, summary, created_at')
+                    .eq('product_id', productId)
+                    .order('created_at', { ascending: false });
+                if (error) {
+                    throw new Error(error.message);
+                }
+                reports = (data || []);
+                usedSdk = true;
+            }
+            catch {
+                // Fall through to MCP
+            }
+        }
+        if (!usedSdk) {
+            const result = (await callMcpEndpoint('intelligence/reports/list', {
+                product_id: productId,
+            }));
+            reports = result.reports || [];
+        }
         if (focusReportId) {
             // If focused, put the focus report first and keep 5 others for context.
             const focus = reports.filter((r) => r.id === focusReportId);

package/dist/phases/find-shared/mcp.js

@@ -7,6 +7,7 @@
  * place, and the per-phase orchestrators stay focused on their own logic.
  */
 import { callMcpEndpoint } from '../../api/mcp-client.js';
+import { getSupabase, hasSupabaseSession } from '../../supabase/client.js';
 import { logError, logWarning } from '../../utils/logger.js';
 export async function fetchProductBasics(productId) {
     try {
@@ -55,6 +56,26 @@ export function isTerminalStatus(status) {
  */
 export async function createIssue(input) {
     try {
+        if (hasSupabaseSession()) {
+            try {
+                const { data, error } = await getSupabase()
+                    .from('issues')
+                    .insert({
+                    product_id: input.productId,
+                    name: input.title,
+                    description: input.description,
+                })
+                    .select('id')
+                    .single();
+                if (error) {
+                    throw new Error(error.message);
+                }
+                return data?.id || null;
+            }
+            catch {
+                // Fall through to MCP
+            }
+        }
         const result = (await callMcpEndpoint('issues/create', {
             product_id: input.productId,
             name: input.title,

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

@@ -1,16 +1,18 @@
 import { type GrowthCampaign } from '../../api/growth.js';
 import { type ProductInfo } from '../../api/products.js';
+import { type UserPsychologyAnalysis } from '../../api/user-psychology.js';
 export interface GrowthAnalysisContext {
     product: ProductInfo;
     previousCampaigns: GrowthCampaign[];
+    /** Most recent completed user-psychology profile, if any. Lets the
+     *  growth agent ground content in real personas + JTBDs + messaging
+     *  angles instead of guessing the audience from scratch. */
+    psychology: UserPsychologyAnalysis | null;
 }
 /**
  * Fetch all context needed for growth analysis via MCP endpoints
  */
 export declare function fetchGrowthAnalysisContext(productId: string, verbose?: boolean): Promise<GrowthAnalysisContext>;
-/**
- * Format context into a prompt string for the AI
- */
 export declare function formatContextForPrompt(context: GrowthAnalysisContext, guidance?: string): string;
 /**
  * Prepare the full analysis prompt with all context

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

@@ -1,5 +1,6 @@
 import { getGrowthCampaigns } from '../../api/growth.js';
 import { getProduct } from '../../api/products.js';
+import { getLatestUserPsychologyAnalysis, } from '../../api/user-psychology.js';
 import { logError, logInfo } from '../../utils/logger.js';
 import { createGrowthAnalysisPromptWithContext } from './prompts.js';
 /**
@@ -10,16 +11,18 @@ export async function fetchGrowthAnalysisContext(productId, verbose) {
         if (verbose) {
             logInfo(`Fetching growth analysis context for product: ${productId}`);
         }
-        const [product, previousCampaigns] = await Promise.all([
+        const [product, previousCampaigns, psychology] = await Promise.all([
             getProduct(productId, verbose),
             getGrowthCampaigns(productId, verbose),
+            getLatestUserPsychologyAnalysis(productId, verbose),
         ]);
         if (verbose) {
             logInfo(`Growth analysis context fetched:`);
             logInfo(`  Product: ${product.name}`);
             logInfo(`  Previous campaigns: ${previousCampaigns.length}`);
+            logInfo(`  Psychology profile: ${psychology ? 'available' : 'none'}`);
         }
-        return { product, previousCampaigns };
+        return { product, previousCampaigns, psychology };
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
@@ -30,8 +33,52 @@ export async function fetchGrowthAnalysisContext(productId, verbose) {
 /**
  * Format context into a prompt string for the AI
  */
+function formatPsychologyForPrompt(psychology) {
+    if (!psychology) {
+        return '';
+    }
+    const personas = (psychology.target_personas ?? [])
+        .slice(0, 5)
+        .map((p, i) => {
+        const drivers = p.decision_drivers?.length
+            ? ` — decision drivers: ${p.decision_drivers.join(', ')}`
+            : '';
+        return `${i + 1}. **${p.name}** — ${p.archetype}${drivers}`;
+    })
+        .join('\n');
+    const jobs = (psychology.jobs_to_be_done ?? [])
+        .slice(0, 8)
+        .map((j) => `- [${j.type}] ${j.statement}`)
+        .join('\n');
+    const pains = (psychology.pain_points ?? [])
+        .slice(0, 6)
+        .map((pp) => `- [${pp.severity}] ${pp.pain}`)
+        .join('\n');
+    const angles = (psychology.messaging_angles ?? [])
+        .slice(0, 6)
+        .map((m) => `- **${m.angle_name}** (${m.psychological_lever}): "${m.hook}" — for ${m.persona}`)
+        .join('\n');
+    return `
+
+## User Psychology Profile (latest research, dated ${psychology.created_at.slice(0, 10)})
+Use this as the authoritative source for who the audience is. Content suggestions must speak to one of these personas and answer one of their jobs-to-be-done. Reuse the messaging angles below as hooks where they fit.
+
+### Target Personas
+${personas || '(none)'}
+
+### Jobs-to-be-Done
+${jobs || '(none)'}
+
+### Pain Points
+${pains || '(none)'}
+
+### Pre-validated Messaging Angles
+${angles || '(none)'}
+
+---`;
+}
 export function formatContextForPrompt(context, guidance) {
-    const { product, previousCampaigns } = context;
+    const { product, previousCampaigns, psychology } = context;
     const campaignsList = previousCampaigns.length > 0
         ? previousCampaigns
             .map((c, i) => `${i + 1}. **${c.title}** [${c.channel}] (${c.status})
@@ -64,14 +111,14 @@ ${guidance}
 
 ## Product Issues (${product.issues?.length || 0})
 ${issuesList}
-${guidanceSection}
+${guidanceSection}${formatPsychologyForPrompt(psychology)}
 
 ## Previous Growth Campaigns (${previousCampaigns.length})
 ${campaignsList}
 
 ---
 
-**Important**: Analyze the product above and create a growth strategy.${guidance ? ' Follow the human growth guidance provided above for direction, themes, and tone.' : ''} Each content suggestion must be DIFFERENT from all previous campaigns listed above. Use the product name, description, and issues to write specific, concrete content — never use placeholder text.`;
+**Important**: Analyze the product above and create a growth strategy.${guidance ? ' Follow the human growth guidance provided above for direction, themes, and tone.' : ''}${psychology ? ' Anchor every content suggestion to a persona from the psychology profile above and answer a specific job-to-be-done.' : ''} Each content suggestion must be DIFFERENT from all previous campaigns listed above. Use the product name, description, and issues to write specific, concrete content — never use placeholder text.`;
 }
 /**
  * Prepare the full analysis prompt with all context