@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/charter/charter-versioning.js

@@ -0,0 +1,283 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-10
+ * @tags: [charter, versioning, semantic-versioning, changelog]
+ * @related: [charter-storage.ts, charter.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+// ============================================================================
+// Version Utilities
+// ============================================================================
+/**
+ * Parse version string (e.g., "1.2.3") into CharterVersion
+ */
+export function parseVersion(versionString) {
+    const parts = versionString.split('.').map(Number);
+    if (parts.length !== 3 || parts.some(isNaN)) {
+        throw new Error(`Invalid version format: ${versionString}`);
+    }
+    return {
+        major: parts[0],
+        minor: parts[1],
+        patch: parts[2],
+    };
+}
+/**
+ * Convert CharterVersion to string (e.g., "1.2.3")
+ */
+export function versionToString(version) {
+    return `${version.major}.${version.minor}.${version.patch}`;
+}
+/**
+ * Create initial version (1.0.0)
+ */
+export function createInitialVersion() {
+    return { major: 1, minor: 0, patch: 0 };
+}
+/**
+ * Bump version based on type
+ */
+export function bumpVersion(current, bump) {
+    switch (bump) {
+        case 'major':
+            return { major: current.major + 1, minor: 0, patch: 0 };
+        case 'minor':
+            return { major: current.major, minor: current.minor + 1, patch: 0 };
+        case 'patch':
+            return { major: current.major, minor: current.minor, patch: current.patch + 1 };
+    }
+}
+// ============================================================================
+// Change Detection
+// ============================================================================
+/**
+ * Detect appropriate version bump based on changes between charters
+ */
+export function detectVersionBump(oldCharter, newCharter) {
+    // Major: Significant scope redefinition or work mode change
+    if (hasMajorChanges(oldCharter, newCharter)) {
+        return 'major';
+    }
+    // Minor: New details, refinements, additional sections
+    if (hasMinorChanges(oldCharter, newCharter)) {
+        return 'minor';
+    }
+    // Patch: Typo fixes, clarifications, minor wording changes
+    return 'patch';
+}
+/**
+ * Check for major changes (scope redefinition, work mode change)
+ */
+function hasMajorChanges(oldCharter, newCharter) {
+    // Work mode change is major
+    if (oldCharter.workMode !== newCharter.workMode) {
+        return true;
+    }
+    // Significant scope change (50%+ of in-scope items changed)
+    const oldInScope = new Set(oldCharter.content.scope.inScope);
+    const newInScope = new Set(newCharter.content.scope.inScope);
+    const intersection = new Set([...oldInScope].filter(x => newInScope.has(x)));
+    const scopeChangePercent = 1 - (intersection.size / Math.max(oldInScope.size, 1));
+    if (scopeChangePercent > 0.5) {
+        return true;
+    }
+    // Purpose completely rewritten (>80% content change)
+    const oldPurpose = oldCharter.content.purpose;
+    const newPurpose = newCharter.content.purpose;
+    const similarity = calculateSimilarity(oldPurpose, newPurpose);
+    if (similarity < 0.2) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check for minor changes (new details, refinements)
+ */
+function hasMinorChanges(oldCharter, newCharter) {
+    // New sections added
+    if ((!oldCharter.content.risks && newCharter.content.risks) ||
+        (!oldCharter.content.alternatives && newCharter.content.alternatives) ||
+        (!oldCharter.content.governance && newCharter.content.governance)) {
+        return true;
+    }
+    // New success criteria added
+    if (newCharter.content.successCriteria.length > oldCharter.content.successCriteria.length) {
+        return true;
+    }
+    // Significant TBD items resolved
+    const oldTbdCount = oldCharter.content.scope.tbd.length;
+    const newTbdCount = newCharter.content.scope.tbd.length;
+    if (oldTbdCount > 0 && newTbdCount < oldTbdCount - 2) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Calculate text similarity (simple Jaccard similarity on words)
+ */
+function calculateSimilarity(text1, text2) {
+    const words1 = new Set(text1.toLowerCase().split(/\s+/));
+    const words2 = new Set(text2.toLowerCase().split(/\s+/));
+    const intersection = new Set([...words1].filter(x => words2.has(x)));
+    const union = new Set([...words1, ...words2]);
+    return intersection.size / union.size;
+}
+// ============================================================================
+// Change Summarization
+// ============================================================================
+/**
+ * Generate list of changes between two charters
+ */
+export function generateChangeList(oldCharter, newCharter) {
+    const changes = [];
+    // Work mode change
+    if (oldCharter.workMode !== newCharter.workMode) {
+        changes.push(`Changed work mode from ${oldCharter.workMode} to ${newCharter.workMode}`);
+    }
+    // Purpose changes
+    if (oldCharter.content.purpose !== newCharter.content.purpose) {
+        changes.push('Updated purpose statement');
+    }
+    // Users changes
+    if (JSON.stringify(oldCharter.content.users) !== JSON.stringify(newCharter.content.users)) {
+        changes.push('Updated user personas');
+    }
+    // Success criteria changes
+    const oldCriteria = oldCharter.content.successCriteria.length;
+    const newCriteria = newCharter.content.successCriteria.length;
+    if (newCriteria > oldCriteria) {
+        changes.push(`Added ${newCriteria - oldCriteria} success criteria`);
+    }
+    else if (newCriteria < oldCriteria) {
+        changes.push(`Removed ${oldCriteria - newCriteria} success criteria`);
+    }
+    // Scope changes
+    const scopeChanges = detectScopeChanges(oldCharter.content.scope, newCharter.content.scope);
+    changes.push(...scopeChanges);
+    // New optional sections
+    if (!oldCharter.content.risks && newCharter.content.risks) {
+        changes.push('Added risks section');
+    }
+    if (!oldCharter.content.alternatives && newCharter.content.alternatives) {
+        changes.push('Added alternatives section');
+    }
+    if (!oldCharter.content.governance && newCharter.content.governance) {
+        changes.push('Added governance section');
+    }
+    // Confidence changes
+    const oldConfidence = oldCharter.confidence.overall;
+    const newConfidence = newCharter.confidence.overall;
+    const confidenceDelta = newConfidence - oldConfidence;
+    if (Math.abs(confidenceDelta) >= 5) {
+        changes.push(`Confidence ${confidenceDelta > 0 ? 'increased' : 'decreased'} to ${newConfidence}%`);
+    }
+    return changes;
+}
+/**
+ * Detect scope changes
+ */
+function detectScopeChanges(oldScope, newScope) {
+    const changes = [];
+    // In-scope additions/removals
+    const oldInScope = new Set(oldScope.inScope);
+    const newInScope = new Set(newScope.inScope);
+    const addedInScope = [...newInScope].filter(x => !oldInScope.has(x));
+    const removedInScope = [...oldInScope].filter(x => !newInScope.has(x));
+    if (addedInScope.length > 0) {
+        changes.push(`Added ${addedInScope.length} items to scope`);
+    }
+    if (removedInScope.length > 0) {
+        changes.push(`Removed ${removedInScope.length} items from scope`);
+    }
+    // Out-of-scope changes
+    const oldOutOfScope = oldScope.outOfScope.length;
+    const newOutOfScope = newScope.outOfScope.length;
+    if (newOutOfScope > oldOutOfScope) {
+        changes.push(`Clarified ${newOutOfScope - oldOutOfScope} out-of-scope boundaries`);
+    }
+    // TBD resolution
+    const oldTbd = oldScope.tbd.length;
+    const newTbd = newScope.tbd.length;
+    if (newTbd < oldTbd) {
+        changes.push(`Resolved ${oldTbd - newTbd} TBD items`);
+    }
+    return changes;
+}
+// ============================================================================
+// Changelog Generation
+// ============================================================================
+/**
+ * Create initial changelog entry for new charter
+ */
+export function createInitialChangelog(charter, participants) {
+    return {
+        version: versionToString(charter.version),
+        date: new Date().toISOString().split('T')[0],
+        changes: [
+            'Created from conversation during ginko init',
+            `Work mode: ${charter.workMode}`,
+            `Confidence: ${charter.confidence.overall}%`,
+        ],
+        participants,
+        confidence: charter.confidence.overall,
+    };
+}
+/**
+ * Create changelog entry for charter update
+ */
+export function createUpdateChangelog(oldCharter, newCharter, participants) {
+    const changes = generateChangeList(oldCharter, newCharter);
+    return {
+        version: versionToString(newCharter.version),
+        date: new Date().toISOString().split('T')[0],
+        changes,
+        participants,
+        confidence: newCharter.confidence.overall,
+    };
+}
+/**
+ * Format changelog for markdown display
+ */
+export function formatChangelogForMarkdown(changelog) {
+    const lines = ['## Changelog', ''];
+    lines.push('All changes to this charter are tracked here for transparency.');
+    lines.push('');
+    for (const entry of changelog) {
+        lines.push(`### v${entry.version} - ${entry.date}`);
+        for (const change of entry.changes) {
+            lines.push(`- ${change}`);
+        }
+        if (entry.participants.length > 0) {
+            lines.push(`- Participants: ${entry.participants.join(', ')}`);
+        }
+        if (entry.confidence !== undefined) {
+            lines.push(`- Confidence: ${entry.confidence}%`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Version Comparison
+// ============================================================================
+/**
+ * Compare two versions
+ * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ */
+export function compareVersions(v1, v2) {
+    if (v1.major !== v2.major)
+        return v1.major - v2.major;
+    if (v1.minor !== v2.minor)
+        return v1.minor - v2.minor;
+    return v1.patch - v2.patch;
+}
+/**
+ * Check if version is newer than another
+ */
+export function isNewerVersion(v1, v2) {
+    return compareVersions(v1, v2) > 0;
+}
+//# sourceMappingURL=charter-versioning.js.map

package/dist/lib/charter/charter-versioning.js.map

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

package/dist/lib/charter/confidence-scorer.d.ts

@@ -0,0 +1,263 @@
+/**
+ * @fileType: utility
+ * @status: specification
+ * @updated: 2025-11-10
+ * @tags: [charter, confidence-scoring, conversation-quality, design-spec]
+ * @related: [conversation-facilitator.ts, charter-synthesizer.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: []
+ */
+/**
+ * Confidence Scoring Specification for Charter Conversations
+ *
+ * This module defines the algorithm for assessing how well each charter aspect
+ * is understood during conversational charter creation. It tracks confidence
+ * across four critical aspects (purpose, users, success, scope) and determines
+ * when additional probing is needed versus when to accept TBD.
+ *
+ * Philosophy:
+ * - Confidence scoring guides conversation depth, not bureaucratic completeness
+ * - Low confidence triggers gentle probing (max 1 per aspect, 3 total)
+ * - TBD is acceptable when user doesn't have clarity yet
+ * - Scoring is transparent and shown to user
+ */
+/**
+ * Overall confidence assessment for charter
+ */
+export interface CharterConfidence {
+    purpose: AspectScore;
+    users: AspectScore;
+    success: AspectScore;
+    scope: AspectScore;
+    overall: number;
+    workMode?: WorkMode;
+    qualityLevel: ConfidenceLevel;
+}
+/**
+ * Confidence score for a specific charter aspect
+ */
+export interface AspectScore {
+    score: number;
+    signals: string[];
+    missing: string[];
+    needsProbing: boolean;
+    markedTBD: boolean;
+}
+/**
+ * High-level confidence indicator
+ */
+export type ConfidenceLevel = 'insufficient' | 'workable' | 'good' | 'excellent';
+/**
+ * Detected work mode from conversation signals
+ */
+export type WorkMode = 'hack-ship' | 'think-build' | 'full-planning';
+/**
+ * Conversation context passed to scorer
+ */
+export interface ConversationContext {
+    exchanges: Exchange[];
+    workModeSignals: WorkModeSignals;
+    nudgeHistory: NudgeRecord[];
+    userStopSignals: string[];
+}
+export interface Exchange {
+    question: string;
+    answer: string;
+    timestamp: Date;
+    aspect?: CharterAspect;
+}
+export interface WorkModeSignals {
+    hackShip: number;
+    thinkBuild: number;
+    fullPlanning: number;
+}
+export interface NudgeRecord {
+    aspect: CharterAspect;
+    timestamp: Date;
+    response: 'clarified' | 'stayed-vague' | 'declined' | 'frustrated';
+}
+export type CharterAspect = 'purpose' | 'users' | 'success' | 'scope';
+/**
+ * Keyword patterns for detecting understanding in each aspect
+ */
+export declare const SIGNAL_PATTERNS: {
+    readonly purpose: {
+        readonly problem: readonly ["problem", "pain", "frustration", "challenge", "issue", "difficulty", "bottleneck", "blocker", "friction"];
+        readonly value: readonly ["value", "benefit", "impact", "improve", "save", "enable", "unlock", "empower", "efficiency"];
+        readonly motivation: readonly ["because", "why", "need", "want", "goal", "vision", "mission", "opportunity"];
+        readonly urgency: readonly ["now", "urgent", "critical", "blocking", "immediately", "asap"];
+    };
+    readonly users: {
+        readonly userTypes: readonly ["users", "developers", "team", "engineers", "designers", "customers", "clients", "people", "myself", "we", "they"];
+        readonly needs: readonly ["needs", "wants", "requires", "looking for", "expects", "jobs to be done", "use cases"];
+        readonly outcomes: readonly ["achieve", "accomplish", "complete", "finish", "succeed", "get", "make", "do"];
+    };
+    readonly success: {
+        readonly qualitative: readonly ["happy", "satisfied", "delighted", "easy", "fast", "simple", "intuitive", "reliable", "quality"];
+        readonly quantitative: readonly ["time", "minutes", "hours", "seconds", "faster", "reduce", "increase", "percent", "number", "count", "metric"];
+        readonly outcomes: readonly ["results in", "leads to", "enables", "allows", "means", "demonstrates", "proves"];
+    };
+    readonly scope: {
+        readonly inScope: readonly ["includes", "covers", "handles", "supports", "provides", "features", "capabilities", "building", "creating", "implementing"];
+        readonly outOfScope: readonly ["not", "excluding", "skip", "defer", "later", "phase 2", "future", "won't", "don't"];
+        readonly boundaries: readonly ["only", "just", "limited to", "focused on", "specifically", "explicitly", "solely"];
+    };
+};
+/**
+ * Work mode detection patterns
+ */
+export declare const WORK_MODE_SIGNALS: {
+    readonly hackShip: readonly ["quick", "prototype", "mvp", "proof of concept", "poc", "weekend", "hackathon", "experiment", "validate", "test", "ship", "launch", "try", "explore"];
+    readonly thinkBuild: readonly ["team", "process", "testing", "architecture", "maintainable", "scalable", "quality", "users", "feedback", "iteration", "production", "release"];
+    readonly fullPlanning: readonly ["stakeholders", "governance", "approval", "risks", "mitigations", "alternatives", "enterprise", "compliance", "security", "roadmap", "quarters", "phases", "strategy"];
+};
+/**
+ * User stop signals (wants to conclude conversation)
+ */
+export declare const STOP_SIGNALS: readonly ["that's enough", "let's move on", "good enough", "skip", "skip this", "not sure", "don't know", "can we continue", "let's just start", "i'll figure it out"];
+/**
+ * Core confidence scorer class
+ */
+export declare class ConfidenceScorer {
+    private context;
+    private scores;
+    constructor(context: ConversationContext);
+    /**
+     * Initialize confidence scores with zero state
+     */
+    private initializeScores;
+    private createEmptyScore;
+    /**
+     * Update all confidence scores based on current conversation context
+     */
+    update(): CharterConfidence;
+    /**
+     * Get current confidence scores
+     */
+    getScores(): CharterConfidence;
+    /**
+     * Score purpose & value understanding
+     *
+     * Signals:
+     * - Problem statement mentioned
+     * - Business value articulated
+     * - Motivation clear
+     * - Urgency/timing indicated
+     *
+     * Scoring:
+     * - 0-20: No clear problem or value
+     * - 20-40: Problem mentioned, value implied
+     * - 40-60: Problem clear, value mentioned
+     * - 60-80: Problem, value, and motivation all clear
+     * - 80-100: Comprehensive with urgency and impact
+     */
+    private scorePurpose;
+    /**
+     * Score user & persona understanding
+     *
+     * Signals:
+     * - User types identified
+     * - User needs described
+     * - User outcomes mentioned
+     *
+     * Scoring:
+     * - 0-20: No user identification
+     * - 20-40: Vague user mention ("users", "people")
+     * - 40-60: Specific user type identified
+     * - 60-80: User type + needs described
+     * - 80-100: Multiple users with clear needs and outcomes
+     */
+    private scoreUsers;
+    /**
+     * Score success criteria understanding
+     *
+     * Signals:
+     * - Qualitative criteria mentioned
+     * - Quantitative criteria mentioned
+     * - User outcomes described
+     *
+     * Scoring:
+     * - 0-20: No success criteria
+     * - 20-40: Vague success mention
+     * - 40-60: Qualitative criteria clear
+     * - 60-80: Both qualitative and quantitative
+     * - 80-100: Comprehensive with timeframes and user outcomes
+     */
+    private scoreSuccess;
+    /**
+     * Score scope & boundaries understanding
+     *
+     * Signals:
+     * - In-scope features mentioned
+     * - Out-of-scope explicitly stated
+     * - Boundaries clear
+     *
+     * Scoring:
+     * - 0-20: No scope definition
+     * - 20-40: Vague scope mention
+     * - 40-60: In-scope features clear
+     * - 60-80: In-scope + some out-of-scope
+     * - 80-100: Both in/out scope with clear boundaries
+     */
+    private scoreScope;
+    /**
+     * Calculate overall confidence as weighted average
+     *
+     * Weights:
+     * - Purpose: 30% (most critical)
+     * - Scope: 25% (prevents drift)
+     * - Success: 25% (measurability)
+     * - Users: 20% (important but can be inferred)
+     */
+    private calculateOverall;
+    /**
+     * Determine quality level from overall score
+     */
+    private determineQualityLevel;
+    /**
+     * Detect work mode from conversation signals
+     */
+    private detectWorkMode;
+    /**
+     * Check if conversation needs more depth for critical aspects
+     */
+    needsAdditionalProbing(): boolean;
+    /**
+     * Get the aspect that most needs probing
+     */
+    getMostUnclearAspect(): CharterAspect | null;
+    /**
+     * Check if ready to synthesize charter
+     */
+    isReadyToSynthesize(): boolean;
+    private allCriticalAspectsCovered;
+    private hasUserStopSignals;
+    private maxNudgesReached;
+    /**
+     * Get all answers for a specific aspect
+     */
+    private getAnswersForAspect;
+    /**
+     * Get all conversation text (questions + answers)
+     */
+    private getAllConversationText;
+    /**
+     * Detect signal keywords in text
+     */
+    private detectSignals;
+    /**
+     * Check if aspect has been marked TBD by user
+     */
+    private isMarkedTBD;
+    /**
+     * Check if aspect has already been nudged
+     */
+    private hasBeenNudged;
+    /**
+     * Get human-readable confidence summary
+     */
+    getConfidenceSummary(): string;
+}
+export default ConfidenceScorer;
+//# sourceMappingURL=confidence-scorer.d.ts.map

package/dist/lib/charter/confidence-scorer.d.ts.map

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