@ginkoai/cli 1.0.0

package/dist/types/session.d.ts

@@ -0,0 +1,257 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-10-01
+ * @tags: [types, session, insights, context-capture, session-log, adr-033]
+ * @related: [../services/insight-extractor.ts, ../services/module-generator.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * Comprehensive session data collected during development
+ */
+export interface SessionData {
+    branch: string;
+    commits: GitCommit[];
+    diff: string;
+    stagedDiff: string;
+    filesChanged: FileChange[];
+    testResults?: TestResult[];
+    errorLogs?: ErrorLog[];
+    buildOutput?: string;
+    terminalOutput?: string[];
+    sessionStart: Date;
+    sessionEnd: Date;
+    duration: number;
+    workMode: WorkMode;
+    previousHandoff?: string;
+    userEmail: string;
+}
+/**
+ * Work modes detected from git status and activity
+ */
+export type WorkMode = 'exploring' | 'developing' | 'testing' | 'debugging' | 'refactoring';
+/**
+ * Git commit information
+ */
+export interface GitCommit {
+    hash: string;
+    message: string;
+    author: string;
+    date: Date;
+    filesChanged: number;
+    insertions: number;
+    deletions: number;
+}
+/**
+ * File change details
+ */
+export interface FileChange {
+    path: string;
+    status: 'added' | 'modified' | 'deleted' | 'renamed';
+    insertions: number;
+    deletions: number;
+    language?: string;
+}
+/**
+ * Test execution results
+ */
+export interface TestResult {
+    framework: 'jest' | 'vitest' | 'mocha' | 'pytest' | 'other';
+    passed: number;
+    failed: number;
+    skipped: number;
+    duration: number;
+    failures?: TestFailure[];
+}
+/**
+ * Individual test failure
+ */
+export interface TestFailure {
+    name: string;
+    file: string;
+    error: string;
+    stack?: string;
+}
+/**
+ * Error log entry
+ */
+export interface ErrorLog {
+    timestamp: Date;
+    level: 'error' | 'warning' | 'info';
+    message: string;
+    file?: string;
+    line?: number;
+    stack?: string;
+}
+/**
+ * Extracted insight from session analysis
+ */
+export interface SessionInsight {
+    id: string;
+    type: InsightType;
+    title: string;
+    problem: string;
+    solution: string;
+    impact: string;
+    reusabilityScore: number;
+    timeSavingPotential: number;
+    relevanceScore: number;
+    codeExample?: CodeExample;
+    preventedError?: string;
+    relatedFiles?: string[];
+    dependencies?: string[];
+    tags?: string[];
+    sessionId: string;
+    timestamp: Date;
+}
+/**
+ * Types of insights that can be captured
+ */
+export type InsightType = 'gotcha' | 'pattern' | 'decision' | 'discovery' | 'optimization' | 'workaround' | 'configuration';
+/**
+ * Code example for an insight
+ */
+export interface CodeExample {
+    language: string;
+    before?: string;
+    after: string;
+    explanation?: string;
+}
+/**
+ * Context module generated from insight
+ */
+export interface ContextModule {
+    filename: string;
+    content: string;
+    metadata: ModuleMetadata;
+}
+/**
+ * Context module metadata
+ */
+export interface ModuleMetadata {
+    type: InsightType;
+    tags: string[];
+    relevance: 'critical' | 'high' | 'medium' | 'low';
+    created: string;
+    updated: string;
+    dependencies: string[];
+    sessionId: string;
+    insightId: string;
+}
+/**
+ * Options for insight extraction
+ */
+export interface ExtractionOptions {
+    maxInsights?: number;
+    minReusabilityScore?: number;
+    minTimeSaving?: number;
+    includeCodeExamples?: boolean;
+    aiModel?: string;
+    verbose?: boolean;
+}
+/**
+ * Result of insight extraction process
+ */
+export interface ExtractionResult {
+    insights: SessionInsight[];
+    modules: ContextModule[];
+    summary: string;
+    processingTime: number;
+    errors?: string[];
+}
+/**
+ * Configuration for automatic capture
+ */
+export interface CaptureConfig {
+    enabled: boolean;
+    autoCapture: boolean;
+    captureThreshold: number;
+    maxInsightsPerSession: number;
+    aiModel: string;
+    reviewBeforeSave: boolean;
+    deduplicateModules: boolean;
+    excludePatterns?: string[];
+    includeTestFailures: boolean;
+    includeBuildErrors: boolean;
+}
+/**
+ * Session log entry for continuous logging (ADR-033 Phase 2)
+ * Captured for defensive logging and handoff synthesis
+ */
+export interface SessionLogEntry {
+    timestamp: Date;
+    type: 'timeline' | 'decision' | 'file' | 'insight' | 'git' | 'achievement';
+    content: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Complete session log structure (ADR-033 Phase 2)
+ * Parsed from current-session-log.md
+ */
+export interface SessionLog {
+    sessionId: string;
+    started: Date;
+    lastUpdated: Date;
+    timeline: TimelineEntry[];
+    decisions: DecisionEntry[];
+    filesAffected: FileAffectedEntry[];
+    insights: InsightEntry[];
+    gitOperations: GitOperationEntry[];
+    achievements: string[];
+    rawEntries?: SessionLogEntry[];
+}
+/**
+ * Timeline entry showing chronological progress
+ */
+export interface TimelineEntry {
+    timestamp: Date;
+    event: string;
+    duration?: string;
+    outcome?: string;
+}
+/**
+ * Decision entry capturing architectural and implementation choices
+ */
+export interface DecisionEntry {
+    timestamp: Date;
+    title: string;
+    context: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+    impact?: string;
+}
+/**
+ * File affected entry with context
+ */
+export interface FileAffectedEntry {
+    path: string;
+    action: 'created' | 'modified' | 'deleted' | 'renamed';
+    purpose: string;
+    keyChanges?: string[];
+    relatedTo?: string[];
+}
+/**
+ * Insight entry for learnings and discoveries
+ */
+export interface InsightEntry {
+    timestamp: Date;
+    type: InsightType;
+    title: string;
+    description: string;
+    impact?: string;
+    codeExample?: CodeExample;
+}
+/**
+ * Git operation entry
+ */
+export interface GitOperationEntry {
+    timestamp: Date;
+    operation: 'commit' | 'branch' | 'merge' | 'rebase' | 'stash';
+    command: string;
+    message?: string;
+    files?: string[];
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/types/session.d.ts.map

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

package/dist/types/session.js

@@ -0,0 +1,12 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-10-01
+ * @tags: [types, session, insights, context-capture, session-log, adr-033]
+ * @related: [../services/insight-extractor.ts, ../services/module-generator.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/utils/ai-templates.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [ai, templates, prompts, enrichment]
+ * @related: [../commands/handoff-ai.ts, ../commands/capture.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * AI template and prompt utilities following ADR-024 pattern
+ * Provides consistent AI enhancement across all commands
+ */
+export interface AiTemplate {
+    content: string;
+    prompt: string;
+    markers: string[];
+}
+export interface AiEnhancementContext {
+    command: string;
+    id: string;
+    data: any;
+}
+/**
+ * DEPRECATED: Special exit codes originally used to signal AI processing
+ * These caused stderr output issues as non-zero exit codes are interpreted as errors
+ * Now all AI-enhanced commands use exit code 0 for success
+ * Keeping for reference only - DO NOT USE
+ */
+export declare const AI_PROCESSING_EXIT_CODE = 42;
+export declare const AI_EXIT_CODES: {
+    readonly CAPTURE: 42;
+    readonly HANDOFF: 42;
+    readonly EXPLORE: 43;
+    readonly ARCHITECTURE: 44;
+    readonly PLAN: 45;
+    readonly VIBECHECK: 46;
+    readonly SHIP: 47;
+};
+/**
+ * AI instruction markers in templates
+ */
+export declare const AI_MARKERS: {
+    readonly ANALYZE: "[AI: Analyze";
+    readonly EXTRACT: "[AI: Extract";
+    readonly PROVIDE: "[AI: Provide";
+    readonly DESCRIBE: "[AI: Describe";
+    readonly SUGGEST: "[AI: Suggest";
+    readonly LIST: "[AI: List";
+    readonly IDENTIFY: "[AI: Identify";
+    readonly NOTE: "[AI: Note";
+};
+/**
+ * Generate a completion prompt for AI enhancement
+ */
+export declare function generateCompletionPrompt(context: AiEnhancementContext, template: string): string;
+/**
+ * Extract AI markers from template
+ */
+export declare function extractAiMarkers(template: string): string[];
+/**
+ * Validate AI-enriched content
+ */
+export declare function validateEnrichedContent(original: string, enriched: string): {
+    valid: boolean;
+    issues: string[];
+};
+/**
+ * Create a store command for AI to call back
+ */
+export declare function createStoreCommand(command: string, id: string, content: string): string;
+/**
+ * Parse store command arguments
+ */
+export declare function parseStoreCommand(args: any): {
+    id: string;
+    content: string;
+} | null;
+/**
+ * Common AI enhancement templates
+ */
+export declare const TEMPLATES: {
+    readonly handoffSummary: "[AI: Analyze the git history and changes to provide a concise summary of what was accomplished in this session]";
+    readonly keyAchievements: "[AI: Based on the commits and changes, list the main achievements of this session]";
+    readonly technicalDecisions: "[AI: Extract key technical decisions made during this session from commit messages and file changes]";
+    readonly nextSteps: "[AI: Based on the current state and work patterns, suggest logical next steps]";
+    readonly knownIssues: "[AI: List any known issues or edge cases discovered during this session]";
+    readonly mentalModel: "[AI: Describe the mental model or approach used in this session to help maintain continuity]";
+    readonly contextAnalysis: "[AI: Analyze why this was discovered and what problem it solves based on current work]";
+    readonly codeExamples: "[AI: Include before/after code examples from actual files being worked on]";
+    readonly impact: "[AI: Describe implications, trade-offs, and downstream effects]";
+};
+/**
+ * Generate fallback content when AI is unavailable
+ */
+export declare function generateFallbackContent(template: string, context: any): string;
+//# sourceMappingURL=ai-templates.d.ts.map

package/dist/utils/ai-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-templates.d.ts","sourceRoot":"","sources":["../../src/utils/ai-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,GAAG,CAAC;CACX;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,aAAa;;;;;;;;CAQhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAkBR;AAoCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAU3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuBtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CASP;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;CAkBZ,CAAC;AAEX;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,GACX,MAAM,CAcR"}

package/dist/utils/ai-templates.js

@@ -0,0 +1,179 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [ai, templates, prompts, enrichment]
+ * @related: [../commands/handoff-ai.ts, ../commands/capture.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * DEPRECATED: Special exit codes originally used to signal AI processing
+ * These caused stderr output issues as non-zero exit codes are interpreted as errors
+ * Now all AI-enhanced commands use exit code 0 for success
+ * Keeping for reference only - DO NOT USE
+ */
+export const AI_PROCESSING_EXIT_CODE = 42; // DEPRECATED - use 0 instead
+export const AI_EXIT_CODES = {
+    CAPTURE: 42, // DEPRECATED
+    HANDOFF: 42, // DEPRECATED
+    EXPLORE: 43, // DEPRECATED
+    ARCHITECTURE: 44, // DEPRECATED
+    PLAN: 45, // DEPRECATED
+    VIBECHECK: 46, // DEPRECATED
+    SHIP: 47 // DEPRECATED
+};
+/**
+ * AI instruction markers in templates
+ */
+export const AI_MARKERS = {
+    ANALYZE: '[AI: Analyze',
+    EXTRACT: '[AI: Extract',
+    PROVIDE: '[AI: Provide',
+    DESCRIBE: '[AI: Describe',
+    SUGGEST: '[AI: Suggest',
+    LIST: '[AI: List',
+    IDENTIFY: '[AI: Identify',
+    NOTE: '[AI: Note'
+};
+/**
+ * Generate a completion prompt for AI enhancement
+ */
+export function generateCompletionPrompt(context, template) {
+    const { command, id, data } = context;
+    return `Please complete this ${command} template by analyzing the provided context:
+
+${formatContextData(data)}
+
+Instructions:
+1. Complete ALL sections marked with ${Object.values(AI_MARKERS).join(', ')}
+2. Maintain the exact template structure
+3. Use concrete, specific details from the codebase
+4. Keep responses concise and actionable
+5. When complete, call: ginko ${command} --store --id=${id} --content="[your enriched content]"
+
+Template to complete:
+${template}
+
+Remember: Follow the flow state philosophy from ADR-023 - be concise, actionable, and focused.`;
+}
+/**
+ * Format context data for AI consumption
+ */
+function formatContextData(data) {
+    const sections = [];
+    if (data.files) {
+        sections.push(`Files in context:
+${data.files.map((f) => `   - ${f}`).join('\n')}`);
+    }
+    if (data.commits) {
+        sections.push(`Recent commits:
+${data.commits.map((c) => `   - ${c.hash?.substring(0, 7)} ${c.message}`).join('\n')}`);
+    }
+    if (data.status) {
+        sections.push(`Git status:
+   - Modified: ${data.status.modified?.length || 0} files
+   - Staged: ${data.status.staged?.length || 0} files
+   - Untracked: ${data.status.not_added?.length || 0} files`);
+    }
+    if (data.branch) {
+        sections.push(`Current branch: ${data.branch}`);
+    }
+    if (data.mode) {
+        sections.push(`Work mode: ${data.mode}`);
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Extract AI markers from template
+ */
+export function extractAiMarkers(template) {
+    const markers = [];
+    const regex = /\[AI:[^\]]+\]/g;
+    let match;
+    while ((match = regex.exec(template)) !== null) {
+        markers.push(match[0]);
+    }
+    return markers;
+}
+/**
+ * Validate AI-enriched content
+ */
+export function validateEnrichedContent(original, enriched) {
+    const issues = [];
+    // Check minimum length
+    if (enriched.length < original.length * 0.8) {
+        issues.push('Enriched content appears incomplete');
+    }
+    // Check for remaining AI markers
+    const remainingMarkers = extractAiMarkers(enriched);
+    if (remainingMarkers.length > 0) {
+        issues.push(`Unprocessed AI markers found: ${remainingMarkers.join(', ')}`);
+    }
+    // Check frontmatter preservation
+    if (original.startsWith('---') && !enriched.startsWith('---')) {
+        issues.push('Frontmatter was removed');
+    }
+    return {
+        valid: issues.length === 0,
+        issues
+    };
+}
+/**
+ * Create a store command for AI to call back
+ */
+export function createStoreCommand(command, id, content) {
+    // Escape content for shell
+    const escapedContent = content
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\$/g, '\\$')
+        .replace(/`/g, '\\`');
+    return `ginko ${command} --store --id=${id} --content="${escapedContent}"`;
+}
+/**
+ * Parse store command arguments
+ */
+export function parseStoreCommand(args) {
+    if (!args.store || !args.id || !args.content) {
+        return null;
+    }
+    return {
+        id: args.id,
+        content: args.content
+    };
+}
+/**
+ * Common AI enhancement templates
+ */
+export const TEMPLATES = {
+    handoffSummary: `[AI: Analyze the git history and changes to provide a concise summary of what was accomplished in this session]`,
+    keyAchievements: `[AI: Based on the commits and changes, list the main achievements of this session]`,
+    technicalDecisions: `[AI: Extract key technical decisions made during this session from commit messages and file changes]`,
+    nextSteps: `[AI: Based on the current state and work patterns, suggest logical next steps]`,
+    knownIssues: `[AI: List any known issues or edge cases discovered during this session]`,
+    mentalModel: `[AI: Describe the mental model or approach used in this session to help maintain continuity]`,
+    contextAnalysis: `[AI: Analyze why this was discovered and what problem it solves based on current work]`,
+    codeExamples: `[AI: Include before/after code examples from actual files being worked on]`,
+    impact: `[AI: Describe implications, trade-offs, and downstream effects]`
+};
+/**
+ * Generate fallback content when AI is unavailable
+ */
+export function generateFallbackContent(template, context) {
+    // Remove AI markers and provide basic content
+    return template.replace(/\[AI:[^\]]+\]/g, (match) => {
+        if (match.includes('summary')) {
+            return context.message || 'Session work completed';
+        }
+        if (match.includes('achievements')) {
+            return '- Work in progress';
+        }
+        if (match.includes('steps')) {
+            return '1. Continue current work';
+        }
+        return '(To be completed)';
+    });
+}
+//# sourceMappingURL=ai-templates.js.map

package/dist/utils/ai-templates.js.map

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

package/dist/utils/ginko-root.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [ginko, root, directory, git-style]
+ * @related: [init.ts, capture.ts, status.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Find the ginko root directory by walking up the directory tree
+ * Similar to how git finds the .git directory
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns Path to ginko root directory, or null if not found
+ */
+export declare function findGinkoRoot(startDir?: string): Promise<string | null>;
+/**
+ * Get the ginko root directory or throw an error if not found
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to ginko root directory
+ * @throws Error if ginko is not initialized
+ */
+export declare function requireGinkoRoot(startDir?: string): Promise<string>;
+/**
+ * Check if we're in a ginko-initialized project
+ *
+ * @param startDir - Directory to start searching from
+ * @returns true if in a ginko project, false otherwise
+ */
+export declare function isGinkoProject(startDir?: string): Promise<boolean>;
+/**
+ * Get the path to a file within the .ginko directory
+ *
+ * @param relativePath - Path relative to .ginko directory
+ * @param startDir - Directory to start searching from
+ * @returns Full path to the file
+ * @throws Error if ginko is not initialized
+ */
+export declare function getGinkoPath(relativePath: string, startDir?: string): Promise<string>;
+/**
+ * Get the path to the user's session directory
+ *
+ * @param userEmail - User email (will be slugified)
+ * @param startDir - Directory to start searching from
+ * @returns Full path to user session directory
+ */
+export declare function getUserSessionPath(userEmail: string, startDir?: string): Promise<string>;
+//# sourceMappingURL=ginko-root.d.ts.map

package/dist/utils/ginko-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ginko-root.d.ts","sourceRoot":"","sources":["../../src/utils/ginko-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiC7E;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3F;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9F"}