git-coco 0.32.0 → 0.34.0

package/README.md

@@ -10,7 +10,7 @@
 [![Last Commit](https://img.shields.io/github/last-commit/gfargo/coco)](https://github.com/gfargo/coco/tree/main)
 [![Discord](https://img.shields.io/discord/1176716060825767948)](https://discord.gg/KGu9nE9Ejx)
 
-An AI-powered git assistant that generates meaningful commit messages, creates changelogs, and streamlines your development workflow.
+An AI-powered git assistant that generates meaningful commit messages, creates changelogs, explores repository history, and streamlines your development workflow.
 
 **✨ Key Features:**
 
@@ -18,6 +18,7 @@ An AI-powered git assistant that generates meaningful commit messages, creates c
 - 📋 **Conventional Commits** - Full support with automatic validation and formatting  
 - 🔧 **Commitlint Integration** - Seamless integration with your existing commitlint configuration
 - 🏠 **Local AI Support** - Run completely offline with Ollama (no API costs, full privacy)
+- 🖥️ **Coco UI Git Workstation** - Seven top-level views (history, status, diff, compose, branches, tags, stash) reachable via `g`-prefixed chords, with an interactive command palette (`:`) and global search (`/`)
 - 📦 **Package Manager Friendly** - Works with npm, yarn, and pnpm
 - 👥 **Team Ready** - Shared configurations and enterprise deployment
 
@@ -44,6 +45,8 @@ coco -i
 - **`coco changelog`** - Create changelogs from commit history  
 - **`coco recap`** - Summarize recent changes and activity
 - **`coco review`** - AI-powered code review of your changes
+- **`coco log`** - Explore commit history with graph, filters, JSON output, and commit details
+- **`coco ui`** - Open the full-screen Git workstation TUI
 - **`coco init`** - Interactive setup wizard
 
 ## Usage Examples
@@ -85,8 +88,32 @@ coco recap --yesterday
 
 # Code review before committing
 coco review
+
+# Explore commit history
+coco ui
+coco ui --view status
+coco log --limit 20
+coco log -i
+coco log --view full --limit 20
+coco log --all --limit 20
+coco log --author "Grace Hopper" --path src
+coco log --commit HEAD
+coco log --format json
+```
+
+### Navigating the TUI
+
+`coco ui` and `coco log -i` share a chord-driven navigation model. Press `g` and then a second key to jump anywhere; `<` (or `Esc`) pops the navigation stack back.
+
+```text
+g h   history          g c   compose         <    back
+g s   status           g b   branches        Esc  back / close modal
+g d   diff             g t   tags            ?    help overlay
+                       g z   stash           :    command palette
 ```
 
+The command palette (`:`) is an interactive launcher with fuzzy filter and recently-used at the top — every keybinding and workflow action is reachable from there. `/` searches the active view (history, branches, tags, or stash). See the [Coco UI](https://github.com/gfargo/coco/wiki/Coco-UI) wiki page for the full keymap.
+
 ## Configuration
 
 Configure `coco` for your workflow with the interactive setup wizard:
@@ -109,6 +136,11 @@ coco init --scope project
 {
   "mode": "interactive",
   "conventionalCommits": true,
+  "logTui": {
+    "theme": {
+      "preset": "catppuccin"
+    }
+  },
   "service": {
     "provider": "openai",
     "model": "gpt-4o"
@@ -126,6 +158,8 @@ For comprehensive guides, advanced usage, and detailed configuration options, vi
 - **[Getting Started](https://github.com/gfargo/coco/wiki/Getting-Started)** - Complete beginner's guide from installation to first commit
 - **[Command Reference](https://github.com/gfargo/coco/wiki/Command-Reference)** - Detailed command options and examples
 - **[Configuration Overview](https://github.com/gfargo/coco/wiki/Config-Overview)** - All configuration options and setup methods
+- **[Coco UI](https://github.com/gfargo/coco/wiki/Coco-UI)** - GitKraken-style terminal workstation guide
+- **[Interactive Log TUI](https://github.com/gfargo/coco/wiki/Interactive-Log-TUI)** - History-focused `coco log -i` guide
 - **[Team Collaboration](https://github.com/gfargo/coco/wiki/Team-Collaboration)** - Enterprise deployment and team adoption strategies
 
 **Advanced Resources:**

package/dist/index.d.ts

@@ -1,23 +1,49 @@
 #!/usr/bin/env node
 import * as yargs from 'yargs';
 import { Arguments } from 'yargs';
-import { OllamaInput, ChatOllama } from '@langchain/ollama';
-import { BaseLLMParams } from '@langchain/core/language_models/llms';
 import * as _langchain_openai from '@langchain/openai';
-import { TiktokenModel, OpenAIInput, ChatOpenAI } from '@langchain/openai';
+import { TiktokenModel, ChatOpenAI } from '@langchain/openai';
 import { SimpleGit } from 'simple-git';
 import { ChatAnthropic } from '@langchain/anthropic';
+import { ChatOllama } from '@langchain/ollama';
 import { Color } from 'chalk';
 import { TiktokenModel as TiktokenModel$1 } from 'tiktoken';
 
+type LogInkBorderStyle = 'round' | 'single' | 'classic';
+type LogInkThemePreset = 'default' | 'monochrome' | 'catppuccin' | 'gruvbox';
+type LogInkThemeColors = {
+    accent?: string;
+    border?: string;
+    danger?: string;
+    focusBorder?: string;
+    gitAdded?: string;
+    gitDeleted?: string;
+    gitModified?: string;
+    info?: string;
+    muted?: string;
+    selection?: string;
+    success?: string;
+    warning?: string;
+};
+type LogInkThemeConfig = {
+    ascii?: boolean;
+    borderStyle?: LogInkBorderStyle;
+    colors?: LogInkThemeColors;
+    preset?: LogInkThemePreset;
+};
+
 type LLMProvider = 'openai' | 'ollama' | 'anthropic';
+type DynamicModelTask = 'summarize' | 'commit' | 'changelog' | 'review' | 'recap' | 'repair' | 'largeDiff';
+type DynamicModelPreference = 'cost' | 'balanced' | 'quality';
 type OpenAIModel = TiktokenModel | 'gpt-4o-mini' | 'gpt-4o' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano';
 type AnthropicModel = 'claude-sonnet-4-0' | 'claude-3-7-sonnet-latest' | 'claude-3-5-haiku-latest' | 'claude-3-5-sonnet-latest' | 'claude-3-5-sonnet-20241022' | 'claude-3-5-sonnet-20240620' | 'claude-3-opus-20240229' | 'claude-3-sonnet-20240229' | 'claude-3-haiku-20240307';
 type OllamaModel = 'deepseek-r1:1.5b' | 'deepseek-r1:8b' | 'deepseek-r1:32b' | 'codegemma:2b' | 'codegemma:7b-code' | 'codegemma' | 'codellama:13b' | 'codellama:34b' | 'codellama:70b' | 'codellama:7b' | 'codellama:instruct' | 'codellama:latest' | 'codellama' | 'gemma:2b' | 'gemma:7b' | 'gemma:latest' | 'gemma' | 'llama2:13b' | 'llama2:70b' | 'llama2:chat' | 'llama2:latest' | 'llama2:text' | 'llama2' | 'llama3:70b-text' | 'llama3:70b' | 'llama3:latest' | 'llama3:text' | 'llama3.1:70b' | 'llama3.1:8b' | 'llama3.1:latest' | 'llama3.2' | 'llama3.2:latest' | 'llama3.2:1b' | 'llama3.2:3b' | 'llama3' | 'llava-llama3:latest' | 'dolphin-llama3:latest' | 'dolphin-llama3:8b' | 'dolphin-llama3:70b' | 'mistral:7b' | 'mistral:latest' | 'mistral:text' | 'mistral' | 'phi3:14b' | 'phi3:3.8b' | 'phi3:instruct' | 'phi3:medium-128k' | 'phi3:medium-4k' | 'phi3:medium' | 'phi3' | 'qwen2:0.5b' | 'qwen2:1.5b' | 'qwen2:72b-text' | 'qwen2:72b' | 'qwen2' | 'qwen2.5-coder:latest' | 'qwen2.5-coder:0.5b' | 'qwen2.5-coder:1.5b' | 'qwen2.5-coder:3b' | 'qwen2.5-coder:7b' | 'qwen2.5-coder:14b' | 'qwen2.5-coder:32b';
 type LLMModel = OpenAIModel | OllamaModel | AnthropicModel;
+type ConfiguredLLMModel = LLMModel | 'dynamic';
+type DynamicModelProfile = Partial<Record<DynamicModelTask, LLMModel>>;
 type BaseLLMService = {
     provider: LLMProvider;
-    model: LLMModel;
+    model: ConfiguredLLMModel;
     /**
      * The maximum number of tokens per request.
      *
@@ -63,6 +89,16 @@ type BaseLLMService = {
      * @default 3
      */
     maxParsingAttempts?: number;
+    /**
+     * Optional task-to-model overrides used when model is set to "dynamic".
+     */
+    dynamicModels?: DynamicModelProfile;
+    /**
+     * Default dynamic routing preference when model is set to "dynamic".
+     *
+     * @default 'balanced'
+     */
+    dynamicModelPreference?: DynamicModelPreference;
 };
 type Authentication = {
     type: 'None';
@@ -80,11 +116,16 @@ type Authentication = {
         apiKey: string;
     };
 };
-type OpenAIFields = Partial<OpenAIInput> & BaseLLMParams;
-type OllamaFields = Partial<OllamaInput> & BaseLLMParams;
+/**
+ * Provider-specific extra options forwarded to the underlying LangChain client.
+ * Decoupled from upstream input types so schema generation stays stable across
+ * langchain releases.
+ */
+type OpenAIFields = Record<string, unknown>;
+type OllamaFields = Record<string, unknown>;
 type OpenAILLMService = BaseLLMService & {
     provider: 'openai';
-    model: OpenAIModel;
+    model: OpenAIModel | 'dynamic';
     /**
      * Custom base URL for OpenAI-compatible APIs (e.g., OpenRouter, Azure OpenAI).
      * If not specified, uses the default OpenAI API endpoint.
@@ -97,13 +138,13 @@ type OpenAILLMService = BaseLLMService & {
 };
 type OllamaLLMService = BaseLLMService & {
     provider: 'ollama';
-    model: OllamaModel;
+    model: OllamaModel | 'dynamic';
     endpoint: string;
     fields?: OllamaFields;
 };
 type AnthropicLLMService = BaseLLMService & {
     provider: 'anthropic';
-    model: AnthropicModel;
+    model: AnthropicModel | 'dynamic';
     fields?: {
         temperature?: number;
         maxTokens?: number;
@@ -189,6 +230,15 @@ type BaseConfig = {
      * @example { "model": "o4-mini", "approval-mode": "auto-edit" }
      */
     autoFixToolOptions?: Record<string, string>;
+    /**
+     * Interactive log TUI settings.
+     */
+    logTui?: {
+        /**
+         * Theme settings for `coco log -i`.
+         */
+        theme?: LogInkThemeConfig;
+    };
 };
 type ConfigWithServiceObject = BaseConfig & Partial<BaseCommandOptions> & {
     service: LLMService;
@@ -216,7 +266,7 @@ interface ChangelogOptions extends BaseCommandOptions {
 }
 type ChangelogArgv = Arguments<ChangelogOptions>;
 
-declare const _default$3: {
+declare const _default$5: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -233,10 +283,13 @@ interface CommitOptions extends BaseCommandOptions {
     conventional: boolean;
     includeBranchName: boolean;
     noVerify: boolean;
+    split?: boolean;
+    plan?: boolean;
+    apply?: boolean;
 }
 type CommitArgv = Arguments<CommitOptions>;
 
-declare const _default$2: {
+declare const _default$4: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -246,13 +299,14 @@ declare const _default$2: {
 
 type InstallationScope = 'global' | 'project';
 
-declare const _default$1: {
+declare const _default$3: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
     handler: (argv: {
         [x: string]: unknown;
         scope?: InstallationScope | undefined;
+        dryRun?: boolean | undefined;
         interactive: boolean;
         verbose: boolean;
         version: boolean;
@@ -262,6 +316,7 @@ declare const _default$1: {
     } | Promise<{
         [x: string]: unknown;
         scope?: InstallationScope | undefined;
+        dryRun?: boolean | undefined;
         interactive: boolean;
         verbose: boolean;
         version: boolean;
@@ -272,6 +327,32 @@ declare const _default$1: {
     options: Record<string, yargs.Options>;
 };
 
+type LogFormat = 'table' | 'json';
+type LogView = 'compact' | 'graph' | 'full';
+interface LogOptions extends BaseCommandOptions {
+    all?: boolean;
+    author?: string;
+    branch?: string;
+    commit?: string;
+    format?: LogFormat;
+    limit?: number;
+    merges?: boolean;
+    noMerges?: boolean;
+    path?: string | string[];
+    since?: string;
+    until?: string;
+    view?: LogView;
+}
+type LogArgv = Arguments<LogOptions>;
+
+declare const _default$2: {
+    command: string;
+    desc: string;
+    builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
+    handler: (argv: LogArgv) => Promise<void>;
+    options: Record<string, yargs.Options>;
+};
+
 interface RecapOptions extends BaseCommandOptions {
     yesterday?: boolean;
     'last-week'?: boolean;
@@ -282,7 +363,7 @@ interface RecapOptions extends BaseCommandOptions {
 }
 type RecapArgv = Arguments<RecapOptions>;
 
-declare const _default: {
+declare const _default$1: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -290,6 +371,25 @@ declare const _default: {
     options: Record<string, yargs.Options>;
 };
 
+type UiView = 'history' | 'status' | 'diff';
+interface UiOptions extends BaseCommandOptions {
+    all?: boolean;
+    branch?: string;
+    limit?: number;
+    path?: string | string[];
+    theme?: LogInkThemePreset;
+    view?: UiView;
+}
+type UiArgv = Arguments<UiOptions>;
+
+declare const _default: {
+    command: string;
+    desc: string;
+    builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
+    handler: (argv: UiArgv) => Promise<void>;
+    options: Record<string, yargs.Options>;
+};
+
 /**
  * Creates and configures an LLM instance based on the provider and configuration.
  *
@@ -336,6 +436,20 @@ type TokenCounter = Awaited<ReturnType<typeof getTokenCounter>>;
  */
 declare const getTokenCounter: (modelName: TiktokenModel$1) => Promise<(text: string) => number>;
 
+type LlmCallMetadata = {
+    task: string;
+    command?: string;
+    provider?: string;
+    model?: string;
+    retryAttempt?: number;
+    parserType?: string;
+    variableKeys?: string[];
+    promptTokens?: number;
+    elapsedMs?: number;
+    inputDocuments?: number;
+    inputChunks?: number;
+};
+
 type FileChangeStatus = 'modified' | 'renamed' | 'added' | 'deleted' | 'untracked' | 'unknown';
 interface FileChange {
     summary: string;
@@ -389,6 +503,7 @@ interface BaseParserOptions {
      * @default 6
      */
     maxConcurrent?: number;
+    metadata?: Partial<LlmCallMetadata>;
 }
 interface BaseParserInput {
     options: BaseParserOptions;
@@ -424,5 +539,5 @@ declare namespace types_d {
   export type { types_d_BaseParserInput as BaseParserInput, types_d_BaseParserOptions as BaseParserOptions, types_d_CommandHandler as CommandHandler, types_d_CommitLogParserInput as CommitLogParserInput, types_d_ConfirmMessage as ConfirmMessage, types_d_ConfirmMessageCallback as ConfirmMessageCallback, types_d_DiffNode as DiffNode, types_d_DirectoryDiff as DirectoryDiff, types_d_FileChange as FileChange, types_d_FileChangeParserInput as FileChangeParserInput, types_d_FileChangeStatus as FileChangeStatus, types_d_FileDiff as FileDiff, types_d_GetChangesResult as GetChangesResult };
 }
 
-export { _default$3 as changelog, _default$2 as commit, _default$1 as init, _default as recap, types_d as types };
+export { _default$5 as changelog, _default$4 as commit, _default$3 as init, _default$2 as log, _default$1 as recap, types_d as types, _default as ui };
 export type { Config$1 as Config };