sofia-cli 0.1.1

package/dist/src/phases/contextSummarizer.js

@@ -0,0 +1,101 @@
+// ── Builder ──────────────────────────────────────────────────────────────────
+/**
+ * Build a summarized context object from all structured session fields.
+ * Missing fields are omitted (undefined) for graceful degradation.
+ */
+export function buildSummarizedContext(session) {
+    const ctx = {};
+    // Discover
+    if (session.businessContext) {
+        ctx.businessSummary = session.businessContext.businessDescription;
+        ctx.challenges = session.businessContext.challenges;
+    }
+    if (session.topic) {
+        ctx.topicArea = session.topic.topicArea;
+    }
+    if (session.workflow?.activities?.length) {
+        ctx.workflowSteps = session.workflow.activities.map((a) => a.name);
+    }
+    // Discovery enrichment
+    if (session.discovery?.enrichment) {
+        const enrichment = session.discovery.enrichment;
+        const highlights = [];
+        if (enrichment.industryTrends?.length) {
+            highlights.push(...enrichment.industryTrends.slice(0, 3));
+        }
+        if (enrichment.companyNews?.length) {
+            highlights.push(...enrichment.companyNews.slice(0, 3));
+        }
+        if (enrichment.workiqInsights?.teamExpertise?.length) {
+            highlights.push(`Team expertise: ${enrichment.workiqInsights.teamExpertise.join(', ')}`);
+        }
+        if (highlights.length > 0) {
+            ctx.enrichmentHighlights = highlights;
+        }
+    }
+    // Ideate
+    if (session.ideas?.length) {
+        ctx.ideaSummaries = session.ideas.map((idea) => ({
+            id: idea.id,
+            title: idea.title,
+            description: idea.description,
+        }));
+    }
+    // Design
+    if (session.evaluation) {
+        ctx.evaluationSummary = `Method: ${session.evaluation.method}, ${session.evaluation.ideas.length} ideas evaluated`;
+    }
+    // Select
+    if (session.selection) {
+        ctx.selectionSummary = `Selected: ${session.selection.ideaId} — ${session.selection.selectionRationale}`;
+    }
+    // Plan
+    if (session.plan?.milestones?.length) {
+        ctx.planMilestones = session.plan.milestones.map((m) => m.title);
+    }
+    if (session.plan?.architectureNotes) {
+        ctx.architectureNotes = session.plan.architectureNotes;
+    }
+    return ctx;
+}
+// ── Renderer ─────────────────────────────────────────────────────────────────
+/**
+ * Render a summarized context into a compact markdown section
+ * for injection into phase system prompts.
+ */
+export function renderSummarizedContext(ctx) {
+    const sections = [];
+    if (ctx.businessSummary) {
+        sections.push(`### Business Context\n- **Business**: ${ctx.businessSummary}`);
+        if (ctx.challenges?.length) {
+            sections.push(`- **Challenges**: ${ctx.challenges.join(', ')}`);
+        }
+    }
+    if (ctx.topicArea) {
+        sections.push(`- **Focus Area**: ${ctx.topicArea}`);
+    }
+    if (ctx.workflowSteps?.length) {
+        sections.push(`### Workflow\n${ctx.workflowSteps.map((s) => `- ${s}`).join('\n')}`);
+    }
+    if (ctx.enrichmentHighlights?.length) {
+        sections.push(`### Discovery Enrichment\n${ctx.enrichmentHighlights.map((h) => `- ${h}`).join('\n')}`);
+    }
+    if (ctx.ideaSummaries?.length) {
+        sections.push(`### Ideas\n${ctx.ideaSummaries.map((i) => `- **${i.title}**: ${i.description}`).join('\n')}`);
+    }
+    if (ctx.evaluationSummary) {
+        sections.push(`### Evaluation\n- ${ctx.evaluationSummary}`);
+    }
+    if (ctx.selectionSummary) {
+        sections.push(`### Selection\n- ${ctx.selectionSummary}`);
+    }
+    if (ctx.planMilestones?.length) {
+        sections.push(`### Plan\n${ctx.planMilestones.map((m) => `- ${m}`).join('\n')}`);
+        if (ctx.architectureNotes) {
+            sections.push(`- **Architecture**: ${ctx.architectureNotes}`);
+        }
+    }
+    if (sections.length === 0)
+        return '';
+    return `\n\n## Prior Phase Context\n\n${sections.join('\n\n')}`;
+}

package/dist/src/phases/discoveryEnricher.js

@@ -0,0 +1,156 @@
+// ── Helpers ──────────────────────────────────────────────────────────────────
+const MAX_ITEMS = 10;
+/**
+ * Extract a likely company name from the summary.
+ * Uses the first capitalized multi-word sequence or first noun phrase.
+ */
+function extractCompanyName(summary) {
+    // Try quoted string first
+    const quoted = summary.match(/"([^"]+)"/);
+    if (quoted)
+        return quoted[1];
+    // Try first capitalized multi-word sequence
+    const capitalized = summary.match(/\b([A-Z][a-zA-Z]*(?:\s+[A-Z][a-zA-Z]*)*)\b/);
+    if (capitalized)
+        return capitalized[1];
+    // Fallback: first 3 words
+    return summary.split(/\s+/).slice(0, 3).join(' ');
+}
+/**
+ * Map search results to "Title: Snippet" strings, capped at MAX_ITEMS.
+ */
+function mapResults(results) {
+    return results.slice(0, MAX_ITEMS).map((r) => `${r.title}: ${r.snippet}`);
+}
+// ── DiscoveryEnricher ────────────────────────────────────────────────────────
+export class DiscoveryEnricher {
+    /**
+     * Run the full enrichment flow: web search + optional WorkIQ.
+     */
+    async enrich(options) {
+        const { companySummary, mcpManager, io, webSearchClient } = options;
+        let webResult = {};
+        let workiqResult = {};
+        // Run web search if client provided
+        if (webSearchClient) {
+            io.writeActivity('Searching for recent company and industry context...');
+            webResult = await this.enrichFromWebSearch(companySummary, webSearchClient);
+        }
+        // Run WorkIQ if available
+        if (mcpManager.isAvailable('workiq')) {
+            workiqResult = await this.enrichFromWorkIQ(companySummary, mcpManager, io);
+        }
+        // Merge results
+        const sourcesUsed = [...(webResult.sourcesUsed ?? []), ...(workiqResult.sourcesUsed ?? [])];
+        const enrichment = {
+            ...webResult,
+            ...workiqResult,
+            sourcesUsed: sourcesUsed.length > 0 ? sourcesUsed : undefined,
+            enrichedAt: new Date().toISOString(),
+        };
+        return enrichment;
+    }
+    /**
+     * Run only the web search enrichment step.
+     */
+    async enrichFromWebSearch(companySummary, webSearchClient) {
+        const companyName = extractCompanyName(companySummary);
+        // GET CURRENT YEAR for dynamic query generation
+        const currentYear = new Date().getFullYear();
+        // Construct multiple queries to cover different angles
+        const queries = [
+            `${companyName} recent news ${currentYear - 1} ${currentYear}`,
+            `${companyName} competitors market ${currentYear - 1}`,
+            `${companyName} industry AI trends ${currentYear}`,
+        ];
+        const allSnippets = [];
+        let companyNews = [];
+        let competitorInfo = [];
+        let industryTrends = [];
+        for (let i = 0; i < queries.length; i++) {
+            try {
+                const result = await webSearchClient.search(queries[i]);
+                if (result.degraded)
+                    continue;
+                const mapped = mapResults(result.results);
+                if (mapped.length === 0) {
+                    continue;
+                }
+                allSnippets.push(...result.results.map((r) => r.snippet));
+                if (i === 0)
+                    companyNews = mapped;
+                else if (i === 1)
+                    competitorInfo = mapped;
+                else if (i === 2)
+                    industryTrends = mapped;
+                // Stop after first successful query to avoid exhausting provider quotas
+                // across repeated enrichment calls in a single workshop run.
+                break;
+            }
+            catch {
+                // Individual query failure — continue with remaining queries
+                continue;
+            }
+        }
+        // If no results at all, return minimal object
+        if (allSnippets.length === 0) {
+            return {};
+        }
+        return {
+            companyNews,
+            competitorInfo,
+            industryTrends,
+            webSearchResults: allSnippets.join('\n'),
+            sourcesUsed: ['websearch'],
+            enrichedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Run only the WorkIQ enrichment step.
+     * Prompts the user for consent before making any WorkIQ calls.
+     */
+    async enrichFromWorkIQ(companySummary, mcpManager, io) {
+        // Prompt for consent (default No)
+        const answer = await io.readInput('May sofIA access WorkIQ for team insights? (y/N) ');
+        if (!answer || answer.trim().toLowerCase() !== 'y') {
+            return {};
+        }
+        try {
+            const response = (await mcpManager.callTool('workiq', 'analyze_team', {
+                summary: companySummary,
+                focus: ['expertise', 'collaboration', 'documentation'],
+            }, { timeoutMs: 30_000 }));
+            // Extract structured fields or fallback to insights string
+            let teamExpertise;
+            let collaborationPatterns;
+            let documentationGaps;
+            if (Array.isArray(response.teamExpertise)) {
+                teamExpertise = response.teamExpertise;
+                collaborationPatterns = (response.collaborationPatterns ?? []);
+                documentationGaps = (response.documentationGaps ?? []);
+            }
+            else if (typeof response.insights === 'string') {
+                // Fallback: split by newline
+                const lines = response.insights.split('\n').filter(Boolean);
+                teamExpertise = lines.length > 0 ? [lines[0]] : [];
+                collaborationPatterns = lines.length > 1 ? [lines[1]] : [];
+                documentationGaps = lines.length > 2 ? [lines[2]] : [];
+            }
+            if (!teamExpertise) {
+                return {};
+            }
+            return {
+                workiqInsights: {
+                    teamExpertise,
+                    collaborationPatterns,
+                    documentationGaps,
+                },
+                sourcesUsed: ['workiq'],
+            };
+        }
+        catch {
+            // Graceful degradation — return empty on any error
+            return {};
+        }
+    }
+}

package/dist/src/phases/phaseExtractors.js

@@ -0,0 +1,222 @@
+/**
+ * Phase extraction utilities.
+ *
+ * Parsers that extract structured data from LLM responses.
+ * Each extractor tries to find a JSON block in the response
+ * and validates it against the expected schema.
+ */
+import { z } from '../vendor/zod.js';
+import { businessContextSchema, workflowMapSchema, ideaCardSchema, ideaEvaluationSchema, selectedIdeaSchema, implementationPlanSchema, pocDevelopmentStateSchema, } from '../shared/schemas/session.js';
+// ---------------------------------------------------------------------------
+// JSON block extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract the first JSON object or array from a response string.
+ * Tries:
+ *   1. Markdown fenced code block (```json ... ```)
+ *   2. First `{...}` or `[...]` in plain text
+ *
+ * Returns the parsed value, or null if nothing valid is found.
+ */
+export function extractJsonBlock(response) {
+    // 1. Try fenced code block
+    const fenceMatch = response.match(/```(?:json)?\s*\n([\s\S]*?)\n```/);
+    if (fenceMatch) {
+        try {
+            return JSON.parse(fenceMatch[1].trim());
+        }
+        catch {
+            // fall through
+        }
+    }
+    // 2. Try raw JSON — find first { or [
+    const objectMatch = response.match(/(\{[\s\S]*\})/);
+    if (objectMatch) {
+        try {
+            return JSON.parse(objectMatch[1]);
+        }
+        catch {
+            // fall through
+        }
+    }
+    const arrayMatch = response.match(/(\[[\s\S]*\])/);
+    if (arrayMatch) {
+        try {
+            return JSON.parse(arrayMatch[1]);
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Multi-block JSON extraction (FR-007)
+// ---------------------------------------------------------------------------
+/**
+ * Extract ALL JSON objects/arrays from a response string.
+ * Uses /g flag for fenced blocks and bracket-depth counting for raw JSON.
+ * Returns an array of parsed values.
+ */
+export function extractAllJsonBlocks(response) {
+    const results = [];
+    const seen = new Set();
+    // 1. Try all fenced code blocks
+    const fenceRegex = /```(?:json)?\s*\n([\s\S]*?)\n```/g;
+    let fenceMatch;
+    while ((fenceMatch = fenceRegex.exec(response)) !== null) {
+        const raw = fenceMatch[1].trim();
+        if (seen.has(raw))
+            continue;
+        try {
+            const parsed = JSON.parse(raw);
+            results.push(parsed);
+            seen.add(raw);
+        }
+        catch {
+            // skip invalid JSON
+        }
+    }
+    // 2. Try bracket-depth counter for raw JSON (only if no fenced blocks found)
+    if (results.length === 0) {
+        for (const opener of ['{', '[']) {
+            const closer = opener === '{' ? '}' : ']';
+            let depth = 0;
+            let start = -1;
+            for (let i = 0; i < response.length; i++) {
+                const ch = response[i];
+                if (ch === opener) {
+                    if (depth === 0)
+                        start = i;
+                    depth++;
+                }
+                else if (ch === closer) {
+                    depth--;
+                    if (depth === 0 && start >= 0) {
+                        const raw = response.slice(start, i + 1);
+                        if (!seen.has(raw)) {
+                            try {
+                                const parsed = JSON.parse(raw);
+                                results.push(parsed);
+                                seen.add(raw);
+                            }
+                            catch {
+                                // skip invalid
+                            }
+                        }
+                        start = -1;
+                    }
+                }
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Extract the first JSON block from a response that validates against a Zod schema.
+ * Tries each extracted block with safeParse, returns the first valid match.
+ */
+export function extractJsonBlockForSchema(response, schema) {
+    const blocks = extractAllJsonBlocks(response);
+    for (const block of blocks) {
+        const result = schema.safeParse(block);
+        if (result.success)
+            return result.data;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Typed extractors
+// ---------------------------------------------------------------------------
+function safeParse(schema, data) {
+    const result = schema.safeParse(data);
+    return result.success ? result.data : null;
+}
+/**
+ * Extract BusinessContext from an LLM response containing a JSON block.
+ */
+export function extractBusinessContext(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    return safeParse(businessContextSchema, json);
+}
+/**
+ * Extract WorkflowMap from an LLM response containing a JSON block.
+ */
+export function extractWorkflow(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    return safeParse(workflowMapSchema, json);
+}
+/**
+ * Extract IdeaCard[] from an LLM response.
+ * Supports both a raw array and an `{ ideas: [...] }` wrapper.
+ */
+export function extractIdeas(response) {
+    const json = extractJsonBlock(response);
+    if (!json)
+        return null;
+    // Raw array
+    if (Array.isArray(json)) {
+        const parsed = z.array(ideaCardSchema).safeParse(json);
+        return parsed.success ? parsed.data : null;
+    }
+    // Wrapper object with `ideas` key
+    if (typeof json === 'object' && 'ideas' in json) {
+        const parsed = z.array(ideaCardSchema).safeParse(json.ideas);
+        return parsed.success ? parsed.data : null;
+    }
+    return null;
+}
+/**
+ * Extract IdeaEvaluation from an LLM response.
+ */
+export function extractEvaluation(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    return safeParse(ideaEvaluationSchema, json);
+}
+/**
+ * Extract SelectedIdea from an LLM response.
+ */
+export function extractSelection(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    return safeParse(selectedIdeaSchema, json);
+}
+/**
+ * Extract ImplementationPlan from an LLM response.
+ */
+export function extractPlan(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    return safeParse(implementationPlanSchema, json);
+}
+/**
+ * Extract a sessionName string from an LLM response JSON block.
+ * Returns the trimmed name, or null if not present/empty.
+ */
+export function extractSessionName(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    const obj = json;
+    if (typeof obj.sessionName !== 'string')
+        return null;
+    const trimmed = obj.sessionName.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/**
+ * Extract PocDevelopmentState from an LLM response.
+ */
+export function extractPocState(response) {
+    const json = extractJsonBlock(response);
+    if (!json || typeof json !== 'object' || Array.isArray(json))
+        return null;
+    return safeParse(pocDevelopmentStateSchema, json);
+}