@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/charter/conversation-facilitator.js

@@ -0,0 +1,360 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-10
+ * @tags: [charter, conversation, facilitator, natural-dialog, adaptive-questions]
+ * @related: [confidence-scorer.ts, conversation-context.ts, question-templates.ts, ../../types/charter.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [prompts]
+ */
+import prompts from 'prompts';
+import chalk from 'chalk';
+import { CONFIDENCE_THRESHOLDS, } from '../../types/charter.js';
+import { ConversationContextManager } from './conversation-context.js';
+import { ConfidenceScorer } from './confidence-scorer.js';
+import { selectOpeningPrompt, selectQuestion, selectNudge, selectTBDMessage, selectSynthesisMessage, } from './question-templates.js';
+/**
+ * Conversation Facilitator - Manages natural charter creation dialog
+ *
+ * Core Philosophy:
+ * - Opens naturally with "What would you like to build?" (not announcing charter)
+ * - Adaptive question generation based on confidence scores
+ * - Gentle nudging when clarity needed (tact, patience, deference)
+ * - TBD handling: Mark and move on if nudge doesn't work
+ * - Completion logic: overall confidence > 70% OR all critical aspects > 40%
+ * - Uses AI's native voice (not canned questions)
+ *
+ * The facilitator guides conversation like a thoughtful technical partner,
+ * not a bureaucratic form or interrogation.
+ */
+export class ConversationFacilitator {
+    contextManager;
+    scorer;
+    questionHistory = [];
+    constructor() {
+        this.contextManager = new ConversationContextManager();
+        // Note: ConfidenceScorer constructor needs context, so we'll initialize it after first exchange
+        this.scorer = new ConfidenceScorer(this.contextManager.getContext());
+    }
+    /**
+     * Main conversation loop - orchestrates charter creation dialog
+     *
+     * Returns: Charter data ready for synthesis
+     */
+    async facilitate() {
+        console.log(chalk.cyan('\n📋 Let\'s create a project charter together!\n'));
+        // Phase 1: Opening - natural conversation starter
+        const opening = this.generateOpening();
+        const initialResponse = await this.prompt(opening);
+        if (!initialResponse) {
+            throw new Error('Conversation cancelled by user');
+        }
+        this.contextManager.addExchange(opening, initialResponse, 'purpose');
+        this.updateScorer();
+        // Phase 2: Adaptive exploration - ask questions based on what's missing
+        while (!this.isComplete()) {
+            const nextQuestion = this.generateNextQuestion();
+            if (!nextQuestion) {
+                // All aspects covered or user wants to stop
+                break;
+            }
+            const response = await this.prompt(nextQuestion);
+            if (!response) {
+                // User cancelled - treat as stop signal
+                break;
+            }
+            // Determine which aspect this question addressed
+            const aspectAddressed = this.determineAspectsAddressed(nextQuestion)[0];
+            this.contextManager.addExchange(nextQuestion, response, aspectAddressed);
+            this.updateScorer();
+            // Check if gentle nudge is needed
+            if (this.shouldNudge()) {
+                await this.gentleNudge();
+            }
+        }
+        // Phase 3: Synthesis transition
+        console.log(chalk.cyan(`\n${selectSynthesisMessage()}\n`));
+        // Extract charter content from conversation
+        const extracted = this.contextManager.getExtractedContent();
+        const workMode = this.detectWorkMode();
+        const scores = this.scorer.getScores();
+        // Build charter content structure
+        const content = {
+            purpose: this.synthesizePurpose(extracted),
+            users: extracted.userTypes,
+            successCriteria: extracted.successCriteria,
+            scope: {
+                inScope: extracted.inScope,
+                outOfScope: extracted.outOfScope,
+                tbd: [], // Will be populated based on low confidence scores
+            },
+            constraints: extracted.constraints.join('; ') || undefined,
+            timeline: extracted.timeline.join('; ') || undefined,
+            team: extracted.team,
+        };
+        return {
+            content,
+            workMode,
+            confidence: scores,
+        };
+    }
+    /**
+     * Generate opening question - natural conversation starter
+     */
+    generateOpening() {
+        return selectOpeningPrompt();
+    }
+    /**
+     * Generate next question based on confidence scores and conversation flow
+     *
+     * Adaptive strategy:
+     * - Asks about lowest-confidence aspect first
+     * - Avoids asking same question twice
+     * - Builds on previous answers (shows listening)
+     */
+    generateNextQuestion() {
+        const scores = this.scorer.getScores();
+        // Check stop conditions
+        if (this.contextManager.hasStopSignals()) {
+            return null;
+        }
+        // Find aspect with lowest confidence that needs probing
+        const unclearAspect = this.getMostUnclearAspect();
+        if (!unclearAspect) {
+            // All aspects covered sufficiently
+            return null;
+        }
+        // Build question context
+        const questionContext = {
+            previousQuestions: this.questionHistory,
+            aspectsCovered: new Set(this.contextManager.getContext().exchanges
+                .map(e => e.aspect)
+                .filter((a) => a !== undefined)),
+            responseDepth: this.assessResponseDepth(),
+            userTone: this.assessUserTone(),
+        };
+        // Select appropriate question for the aspect
+        const question = selectQuestion(unclearAspect, questionContext);
+        this.questionHistory.push(question);
+        return question;
+    }
+    /**
+     * Perform gentle nudge when aspect needs more clarity
+     *
+     * Per Chris's principle: "AI is first-class partner whose needs should be respected"
+     *
+     * Strategy:
+     * - Explain why the information would help
+     * - Ask respectfully (not demanding)
+     * - If nudge doesn't work, mark TBD and move on
+     * - Maximum 1 nudge per aspect, 3 total across conversation
+     */
+    async gentleNudge() {
+        const unclearAspect = this.getMostUnclearAspect();
+        if (!unclearAspect || this.contextManager.hasNudgedRecently()) {
+            return;
+        }
+        const nudgeMessage = selectNudge(unclearAspect);
+        console.log(chalk.yellow(`\n${nudgeMessage}\n`));
+        const response = await this.prompt('');
+        if (!response || response.length < 15) {
+            // User declined or gave very short response - record as declined
+            this.contextManager.recordNudge(unclearAspect, 'declined');
+            console.log(chalk.dim(`\n${selectTBDMessage()}\n`));
+            return;
+        }
+        // User provided more detail - record as clarified and add to conversation
+        this.contextManager.recordNudge(unclearAspect, 'clarified');
+        this.contextManager.addExchange(nudgeMessage, response, unclearAspect);
+        this.updateScorer();
+    }
+    /**
+     * Check if conversation should continue or is complete
+     *
+     * Complete if:
+     * - Overall confidence > 70%, OR
+     * - All critical aspects > 40%, OR
+     * - User showing stop signals, OR
+     * - Too many nudges attempted
+     */
+    isComplete() {
+        const scores = this.scorer.getScores();
+        const context = this.contextManager.getContext();
+        // Check overall confidence
+        if (scores.overall >= CONFIDENCE_THRESHOLDS.WORKABLE) {
+            return true;
+        }
+        // Check if all critical aspects meet minimum
+        const allCritical = scores.purpose.score >= CONFIDENCE_THRESHOLDS.CRITICAL &&
+            scores.users.score >= CONFIDENCE_THRESHOLDS.CRITICAL &&
+            scores.success.score >= CONFIDENCE_THRESHOLDS.CRITICAL &&
+            scores.scope.score >= CONFIDENCE_THRESHOLDS.CRITICAL;
+        if (allCritical) {
+            return true;
+        }
+        // Check stop signals
+        if (context.userStopSignals.length > 0) {
+            return true;
+        }
+        // Check nudge limit (max 3)
+        if (context.nudgeHistory.length >= 3) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if gentle nudge should be used
+     */
+    shouldNudge() {
+        // Don't nudge if we just nudged
+        if (this.contextManager.hasNudgedRecently()) {
+            return false;
+        }
+        // Don't nudge if we've hit limit
+        if (this.contextManager.getContext().nudgeHistory.length >= 3) {
+            return false;
+        }
+        // Nudge if any aspect critically low
+        return this.scorer.needsAdditionalProbing();
+    }
+    /**
+     * Get the aspect with lowest confidence that needs attention
+     */
+    getMostUnclearAspect() {
+        const scores = this.scorer.getScores();
+        // Build list of aspects with scores
+        const aspects = [
+            { aspect: 'purpose', score: scores.purpose.score },
+            { aspect: 'users', score: scores.users.score },
+            { aspect: 'success', score: scores.success.score },
+            { aspect: 'scope', score: scores.scope.score },
+        ];
+        // Find aspects below workable threshold
+        const needsWork = aspects.filter(a => a.score < CONFIDENCE_THRESHOLDS.WORKABLE);
+        if (needsWork.length === 0) {
+            return null;
+        }
+        // Return lowest scoring aspect
+        needsWork.sort((a, b) => a.score - b.score);
+        return needsWork[0].aspect;
+    }
+    /**
+     * Detect work mode from conversation signals
+     */
+    detectWorkMode() {
+        const signals = this.contextManager.getWorkModeSignals();
+        // Find mode with most signals
+        const modes = [
+            { mode: 'hack-ship', count: signals.hackShip },
+            { mode: 'think-build', count: signals.thinkBuild },
+            { mode: 'full-planning', count: signals.fullPlanning },
+        ];
+        modes.sort((a, b) => b.count - a.count);
+        // Default to think-build if no clear signals
+        if (modes[0].count === 0) {
+            return 'think-build';
+        }
+        return modes[0].mode;
+    }
+    /**
+     * Synthesize purpose statement from extracted content
+     */
+    synthesizePurpose(extracted) {
+        const parts = [];
+        if (extracted.problemStatements.length > 0) {
+            parts.push(`**Problem:** ${extracted.problemStatements.join('. ')}`);
+        }
+        if (extracted.valueStatements.length > 0) {
+            parts.push(`**Value:** ${extracted.valueStatements.join('. ')}`);
+        }
+        return parts.join('\n\n') || 'To be determined';
+    }
+    /**
+     * Assess depth of user responses (shallow, moderate, deep)
+     */
+    assessResponseDepth() {
+        const exchanges = this.contextManager.getContext().exchanges;
+        if (exchanges.length === 0)
+            return 'moderate';
+        const avgLength = exchanges.reduce((sum, e) => sum + e.answer.length, 0) / exchanges.length;
+        if (avgLength < 30)
+            return 'shallow';
+        if (avgLength < 100)
+            return 'moderate';
+        return 'deep';
+    }
+    /**
+     * Assess user's tone (urgent, exploratory, methodical)
+     */
+    assessUserTone() {
+        const signals = this.contextManager.getWorkModeSignals();
+        // Urgent tone correlates with hack-ship
+        if (signals.hackShip > signals.thinkBuild && signals.hackShip > signals.fullPlanning) {
+            return 'urgent';
+        }
+        // Methodical tone correlates with full-planning
+        if (signals.fullPlanning > signals.hackShip) {
+            return 'methodical';
+        }
+        return 'exploratory';
+    }
+    /**
+     * Determine which aspects a question addresses
+     */
+    determineAspectsAddressed(question) {
+        const aspects = [];
+        const lower = question.toLowerCase();
+        // Purpose indicators
+        if (lower.includes('problem') || lower.includes('pain') || lower.includes('why') ||
+            lower.includes('value') || lower.includes('solve')) {
+            aspects.push('purpose');
+        }
+        // Users indicators
+        if (lower.includes('who') || lower.includes('user') || lower.includes('team') ||
+            lower.includes('customer') || lower.includes('people')) {
+            aspects.push('users');
+        }
+        // Success indicators
+        if (lower.includes('success') || lower.includes('measure') || lower.includes('know it\'s working') ||
+            lower.includes('goal') || lower.includes('outcome')) {
+            aspects.push('success');
+        }
+        // Scope indicators
+        if (lower.includes('scope') || lower.includes('building') || lower.includes('not building') ||
+            lower.includes('minimum') || lower.includes('feature') || lower.includes('boundaries')) {
+            aspects.push('scope');
+        }
+        // Default to purpose if no clear match
+        if (aspects.length === 0) {
+            aspects.push('purpose');
+        }
+        return aspects;
+    }
+    /**
+     * Update confidence scorer with current context
+     */
+    updateScorer() {
+        this.scorer = new ConfidenceScorer(this.contextManager.getContext());
+        this.scorer.update();
+    }
+    /**
+     * Prompt user for input
+     */
+    async prompt(message) {
+        const response = await prompts({
+            type: 'text',
+            name: 'value',
+            message: message || '> ',
+            validate: (value) => {
+                // Allow empty for optional questions, but not for opening
+                if (!message && value.length === 0) {
+                    return 'Please provide a response';
+                }
+                return true;
+            },
+        });
+        return response.value || null;
+    }
+}
+//# sourceMappingURL=conversation-facilitator.js.map

package/dist/lib/charter/conversation-facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-facilitator.js","sourceRoot":"","sources":["../../../src/lib/charter/conversation-facilitator.ts"],"names":[],"mappings":"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"}

package/dist/lib/charter/question-templates.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-10
+ * @tags: [charter, conversation, questions, templates, patterns]
+ * @related: [conversation-facilitator.ts, conversation-context.ts, ../../types/charter.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { QuestionTemplate, CharterAspect, QuestionContext } from '../../types/charter.js';
+/**
+ * Natural question patterns for charter aspects
+ *
+ * These are PATTERNS, not scripts. The conversation facilitator
+ * selects questions based on context and conversation flow.
+ *
+ * Key principle: Questions feel like a thoughtful technical partner,
+ * not a bureaucratic form or interrogation.
+ */
+/**
+ * Opening prompts - natural conversation starters
+ */
+export declare const OPENING_PROMPTS: string[];
+/**
+ * Purpose exploration questions
+ */
+export declare const PURPOSE_QUESTIONS: QuestionTemplate[];
+/**
+ * Users and personas exploration questions
+ */
+export declare const USER_QUESTIONS: QuestionTemplate[];
+/**
+ * Success criteria exploration questions
+ */
+export declare const SUCCESS_QUESTIONS: QuestionTemplate[];
+/**
+ * Scope and boundaries exploration questions
+ */
+export declare const SCOPE_QUESTIONS: QuestionTemplate[];
+/**
+ * Context and constraints exploration questions
+ */
+export declare const CONTEXT_QUESTIONS: QuestionTemplate[];
+/**
+ * Gentle nudge templates for when clarity is needed
+ */
+export declare const NUDGE_TEMPLATES: {
+    purpose: string[];
+    users: string[];
+    success: string[];
+    scope: string[];
+};
+/**
+ * Stop/TBD handling templates
+ */
+export declare const TBD_TEMPLATES: string[];
+/**
+ * Completion/synthesis transition templates
+ */
+export declare const SYNTHESIS_TEMPLATES: string[];
+/**
+ * Select best question template based on context
+ */
+export declare function selectQuestion(aspect: CharterAspect, context: QuestionContext): string;
+/**
+ * Select gentle nudge for an aspect
+ */
+export declare function selectNudge(aspect: CharterAspect): string;
+/**
+ * Select TBD handling message
+ */
+export declare function selectTBDMessage(): string;
+/**
+ * Select synthesis transition message
+ */
+export declare function selectSynthesisMessage(): string;
+/**
+ * Select opening prompt
+ */
+export declare function selectOpeningPrompt(): string;
+//# sourceMappingURL=question-templates.d.ts.map

package/dist/lib/charter/question-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/charter/question-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;GAQG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,UAK3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAyC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,gBAAgB,EAyC5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAyC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAyC7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,EAyC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;CAiB3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,UAIzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAI/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,eAAe,GACvB,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CASzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C"}