@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/charter/signal-detection.js

@@ -0,0 +1,338 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-10
+ * @tags: [charter, signal-detection, work-mode, conversation-analysis]
+ * @related: [charter-synthesizer.ts, confidence-scorer.ts, charter.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+// ============================================================================
+// Signal Patterns
+// ============================================================================
+/**
+ * Keyword patterns for work mode detection
+ */
+const WORK_MODE_KEYWORDS = {
+    'hack-ship': [
+        'quick',
+        'prototype',
+        'mvp',
+        'proof of concept',
+        'poc',
+        'weekend',
+        'hackathon',
+        'experiment',
+        'validate',
+        'test idea',
+        'ship',
+        'launch',
+        'try',
+        'explore',
+        'spike',
+        'minimal',
+        'fast',
+    ],
+    'think-build': [
+        'team',
+        'process',
+        'testing',
+        'architecture',
+        'maintainable',
+        'scalable',
+        'quality',
+        'users',
+        'feedback',
+        'iteration',
+        'production',
+        'release',
+        'integration',
+        'deployment',
+        'ci/cd',
+    ],
+    'full-planning': [
+        'stakeholders',
+        'governance',
+        'approval',
+        'risks',
+        'mitigations',
+        'alternatives',
+        'enterprise',
+        'compliance',
+        'security',
+        'roadmap',
+        'quarters',
+        'phases',
+        'strategy',
+        'board',
+        'executive',
+        'regulatory',
+    ],
+};
+/**
+ * Response depth indicators
+ */
+const DEPTH_INDICATORS = {
+    shallow: [
+        'yes',
+        'no',
+        'maybe',
+        'not sure',
+        'idk',
+        "don't know",
+        'skip',
+        'next',
+    ],
+    moderate: [
+        'basically',
+        'mostly',
+        'kind of',
+        'sort of',
+        'probably',
+        'generally',
+    ],
+    deep: [
+        'specifically',
+        'in detail',
+        'for example',
+        'such as',
+        'because',
+        'the reason',
+        'which means',
+        'this enables',
+        'impact',
+    ],
+};
+/**
+ * User tone indicators
+ */
+const TONE_INDICATORS = {
+    urgent: [
+        'asap',
+        'urgent',
+        'critical',
+        'now',
+        'immediately',
+        'quickly',
+        'fast',
+        'blocking',
+        'blocker',
+    ],
+    exploratory: [
+        'explore',
+        'investigate',
+        'curious',
+        'wondering',
+        'what if',
+        'could we',
+        'might',
+        'experiment',
+        'try',
+    ],
+    methodical: [
+        'process',
+        'plan',
+        'steps',
+        'approach',
+        'framework',
+        'methodology',
+        'systematic',
+        'organized',
+        'structure',
+    ],
+};
+// ============================================================================
+// Signal Detection Functions
+// ============================================================================
+/**
+ * Detect work mode from conversation context
+ */
+export function detectWorkMode(context) {
+    const signals = analyzeWorkModeSignals(context);
+    // Find mode with highest signal count
+    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';
+    }
+    // If top two modes are very close, prefer the less comprehensive one
+    // (don't over-plan unless signals are clear)
+    if (modes.length > 1 && modes[1].count > 0) {
+        const ratio = modes[1].count / modes[0].count;
+        if (ratio > 0.7) {
+            // Tie-breaking: prefer less comprehensive mode
+            if (modes[0].mode === 'full-planning' && modes[1].mode === 'think-build') {
+                return 'think-build';
+            }
+            if (modes[0].mode === 'think-build' && modes[1].mode === 'hack-ship') {
+                return 'hack-ship';
+            }
+        }
+    }
+    return modes[0].mode;
+}
+/**
+ * Analyze work mode signals from conversation
+ */
+export function analyzeWorkModeSignals(context) {
+    const allText = getAllConversationText(context.exchanges);
+    return {
+        hackShip: countSignals(allText, WORK_MODE_KEYWORDS['hack-ship']),
+        thinkBuild: countSignals(allText, WORK_MODE_KEYWORDS['think-build']),
+        fullPlanning: countSignals(allText, WORK_MODE_KEYWORDS['full-planning']),
+    };
+}
+/**
+ * Analyze response depth from exchanges
+ */
+export function analyzeResponseDepth(exchanges) {
+    if (exchanges.length === 0)
+        return 'shallow';
+    // Calculate average response length
+    const avgLength = exchanges.reduce((sum, e) => sum + e.response.length, 0) / exchanges.length;
+    // Count depth indicators
+    const allText = getAllConversationText(exchanges);
+    const shallowCount = countSignals(allText, DEPTH_INDICATORS.shallow);
+    const moderateCount = countSignals(allText, DEPTH_INDICATORS.moderate);
+    const deepCount = countSignals(allText, DEPTH_INDICATORS.deep);
+    // Determine depth based on response length and indicators
+    if (avgLength < 50 || shallowCount > deepCount + moderateCount) {
+        return 'shallow';
+    }
+    if (deepCount > moderateCount && avgLength > 150) {
+        return 'deep';
+    }
+    return 'moderate';
+}
+/**
+ * Detect user tone from exchanges
+ */
+export function detectUserTone(exchanges) {
+    if (exchanges.length === 0)
+        return 'exploratory';
+    const allText = getAllConversationText(exchanges);
+    const urgentCount = countSignals(allText, TONE_INDICATORS.urgent);
+    const exploratoryCount = countSignals(allText, TONE_INDICATORS.exploratory);
+    const methodicalCount = countSignals(allText, TONE_INDICATORS.methodical);
+    // Find dominant tone
+    const tones = [
+        { tone: 'urgent', count: urgentCount },
+        { tone: 'exploratory', count: exploratoryCount },
+        { tone: 'methodical', count: methodicalCount },
+    ];
+    tones.sort((a, b) => b.count - a.count);
+    // Default to exploratory if no clear signals
+    if (tones[0].count === 0) {
+        return 'exploratory';
+    }
+    return tones[0].tone;
+}
+/**
+ * Count occurrences of signal keywords in text
+ */
+export function countSignals(text, keywords) {
+    const lowerText = text.toLowerCase();
+    let count = 0;
+    for (const keyword of keywords) {
+        const regex = new RegExp(`\\b${keyword.toLowerCase()}\\b`, 'g');
+        const matches = lowerText.match(regex);
+        if (matches) {
+            count += matches.length;
+        }
+    }
+    return count;
+}
+/**
+ * Detect specific signals in text
+ */
+export function detectSignals(text, keywords) {
+    const lowerText = text.toLowerCase();
+    const found = [];
+    for (const keyword of keywords) {
+        const regex = new RegExp(`\\b${keyword.toLowerCase()}\\b`, 'i');
+        if (regex.test(lowerText)) {
+            found.push(keyword);
+        }
+    }
+    return found;
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get all conversation text from exchanges
+ */
+function getAllConversationText(exchanges) {
+    return exchanges
+        .map((e) => `${e.question} ${e.response}`)
+        .join(' ')
+        .toLowerCase();
+}
+/**
+ * Check if user is showing stop signals
+ */
+export function hasStopSignals(exchanges) {
+    const STOP_SIGNALS = [
+        "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",
+        'move forward',
+        'enough for now',
+    ];
+    const recentText = exchanges
+        .slice(-3) // Last 3 exchanges
+        .map((e) => e.response)
+        .join(' ')
+        .toLowerCase();
+    return STOP_SIGNALS.some((signal) => recentText.includes(signal));
+}
+/**
+ * Analyze conversation length and pacing
+ */
+export function analyzeConversationPacing(exchanges) {
+    if (exchanges.length === 0) {
+        return {
+            exchangeCount: 0,
+            avgResponseLength: 0,
+            totalDuration: 0,
+            pace: 'steady',
+        };
+    }
+    const avgResponseLength = exchanges.reduce((sum, e) => sum + e.response.length, 0) / exchanges.length;
+    const totalDuration = exchanges.length > 1
+        ? exchanges[exchanges.length - 1].timestamp.getTime() -
+            exchanges[0].timestamp.getTime()
+        : 0;
+    // Calculate pace based on exchanges per minute
+    const exchangesPerMinute = totalDuration > 0 ? (exchanges.length / totalDuration) * 60000 : 0;
+    let pace;
+    if (exchangesPerMinute > 2) {
+        pace = 'rapid';
+    }
+    else if (exchangesPerMinute > 0.5) {
+        pace = 'steady';
+    }
+    else {
+        pace = 'slow';
+    }
+    return {
+        exchangeCount: exchanges.length,
+        avgResponseLength,
+        totalDuration,
+        pace,
+    };
+}
+//# sourceMappingURL=signal-detection.js.map

package/dist/lib/charter/signal-detection.js.map

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

package/dist/lib/context-loader-events.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-04
+ * @tags: [context-loading, events, adr-043, session-cursor, graph]
+ * @related: [context-loader.ts, session-logger.ts, CloudGraphClient]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Event category types
+ */
+export type EventCategory = 'fix' | 'feature' | 'decision' | 'insight' | 'git' | 'achievement';
+/**
+ * Event from graph database
+ */
+export interface Event {
+    id: string;
+    user_id: string;
+    project_id: string;
+    timestamp: Date;
+    category: EventCategory;
+    description: string;
+    files: string[];
+    impact: 'high' | 'medium' | 'low';
+    pressure?: number;
+    branch?: string;
+    tags?: string[];
+    shared?: boolean;
+    commit_hash?: string;
+}
+/**
+ * Session cursor (pointer into event stream)
+ */
+export interface SessionCursor {
+    id: string;
+    user_id: string;
+    project_id: string;
+    started: Date;
+    last_active: Date;
+    current_event_id: string;
+    last_loaded_event_id?: string;
+    branch?: string;
+    status: 'active' | 'paused';
+}
+/**
+ * Knowledge document node from graph
+ */
+export interface KnowledgeNode {
+    id: string;
+    type: string;
+    title?: string;
+    content?: string;
+    status?: string;
+    tags?: string[];
+    created?: Date;
+    updated?: Date;
+}
+/**
+ * Sprint information
+ */
+export interface Sprint {
+    id: string;
+    title: string;
+    goals: string[];
+    progress: number;
+    started: Date;
+    deadline?: Date;
+}
+/**
+ * Context loading options
+ */
+export interface ContextLoadOptions {
+    eventLimit?: number;
+    includeTeam?: boolean;
+    teamEventLimit?: number;
+    categories?: EventCategory[];
+    documentDepth?: number;
+    teamDays?: number;
+}
+/**
+ * Loaded context from event stream
+ */
+export interface LoadedContext {
+    cursor: SessionCursor;
+    myEvents: Event[];
+    teamEvents?: Event[];
+    documents: KnowledgeNode[];
+    relatedDocs: KnowledgeNode[];
+    sprint?: Sprint;
+    loaded_at: Date;
+    event_count: number;
+    token_estimate: number;
+}
+/**
+ * Load context from cursor position by reading events backwards
+ *
+ * @param cursor - Session cursor with current position
+ * @param options - Loading options
+ * @returns Loaded context with events, documents, and metadata
+ */
+export declare function loadContextFromCursor(cursor: SessionCursor, options?: ContextLoadOptions): Promise<LoadedContext>;
+/**
+ * Format context summary for display
+ *
+ * @param context - Loaded context
+ * @returns Formatted summary string
+ */
+export declare function formatContextSummary(context: LoadedContext): string;
+//# sourceMappingURL=context-loader-events.d.ts.map

package/dist/lib/context-loader-events.d.ts.map

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