git-coco 0.31.1 → 0.33.0

package/README.md

@@ -44,6 +44,7 @@ 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 init`** - Interactive setup wizard
 
 ## Usage Examples
@@ -85,6 +86,12 @@ coco recap --yesterday
 
 # Code review before committing
 coco review
+
+# Explore commit history
+coco log --all --limit 20
+coco log --author "Grace Hopper" --path src
+coco log --commit HEAD
+coco log --format json
 ```
 
 ## Configuration

package/dist/index.d.ts

@@ -11,13 +11,17 @@ import { Color } from 'chalk';
 import { TiktokenModel as TiktokenModel$1 } from 'tiktoken';
 
 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 +67,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';
@@ -84,7 +98,7 @@ type OpenAIFields = Partial<OpenAIInput> & BaseLLMParams;
 type OllamaFields = Partial<OllamaInput> & BaseLLMParams;
 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 +111,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;
@@ -216,7 +230,7 @@ interface ChangelogOptions extends BaseCommandOptions {
 }
 type ChangelogArgv = Arguments<ChangelogOptions>;
 
-declare const _default$3: {
+declare const _default$4: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -232,10 +246,14 @@ interface CommitOptions extends BaseCommandOptions {
     withPreviousCommits: number;
     conventional: boolean;
     includeBranchName: boolean;
+    noVerify: boolean;
+    split?: boolean;
+    plan?: boolean;
+    apply?: boolean;
 }
 type CommitArgv = Arguments<CommitOptions>;
 
-declare const _default$2: {
+declare const _default$3: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -245,7 +263,7 @@ declare const _default$2: {
 
 type InstallationScope = 'global' | 'project';
 
-declare const _default$1: {
+declare const _default$2: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -271,6 +289,29 @@ declare const _default$1: {
     options: Record<string, yargs.Options>;
 };
 
+type LogFormat = 'table' | 'json';
+interface LogOptions extends BaseCommandOptions {
+    all?: boolean;
+    author?: string;
+    branch?: string;
+    commit?: string;
+    format?: LogFormat;
+    limit?: number;
+    noMerges?: boolean;
+    path?: string | string[];
+    since?: string;
+    until?: string;
+}
+type LogArgv = Arguments<LogOptions>;
+
+declare const _default$1: {
+    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;
@@ -335,6 +376,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;
@@ -388,6 +443,7 @@ interface BaseParserOptions {
      * @default 6
      */
     maxConcurrent?: number;
+    metadata?: Partial<LlmCallMetadata>;
 }
 interface BaseParserInput {
     options: BaseParserOptions;
@@ -423,5 +479,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$4 as changelog, _default$3 as commit, _default$2 as init, _default$1 as log, _default as recap, types_d as types };
 export type { Config$1 as Config };