git-coco 0.49.0 → 0.51.0

package/README.md

@@ -15,10 +15,11 @@ An AI-powered git assistant that generates meaningful commit messages, creates c
 **✨ Key Features:**
 
 - 🤖 **AI-Powered Commit Messages** - Generate contextual commits from your staged changes
-- 📋 **Conventional Commits** - Full support with automatic validation and formatting  
+- 📋 **Conventional Commits** - Full support with automatic validation and formatting (extends to `coco commit --split` too — every group's title respects the spec)
 - 🔧 **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** - Twelve top-level views (history, status, diff, compose, branches, tags, stash, worktrees, pull-request, conflicts, reflog, bisect) reachable via `g`-prefixed chords, with an interactive command palette (`:`), global search (`/`), and cross-view flows like compare-two-refs and the bisect decision keys
+- 🖥️ **Coco UI Git Workstation** - Thirteen top-level views (history, status, diff, compose, branches, tags, stash, worktrees, pull-request, conflicts, reflog, bisect, changelog) reachable via `g`-prefixed chords, with an interactive command palette (`:`), global search (`/`), and one-keystroke workflows: `S` split staged changes, `L` generate a changelog, `C` create a PR seeded from changelog, `E` open the commit draft in `$EDITOR`
+- 🎯 **`--repo <dir>` global flag** - Drive any coco command against any repository without `cd`-ing first
 - 📦 **Package Manager Friendly** - Works with npm, yarn, and pnpm
 - 👥 **Team Ready** - Shared configurations and enterprise deployment
 

package/dist/index.d.ts

@@ -33,7 +33,7 @@ type LogInkThemeConfig = {
 };
 
 type LLMProvider = 'openai' | 'ollama' | 'anthropic';
-type DynamicModelTask = 'summarize' | 'commit' | 'changelog' | 'review' | 'recap' | 'repair' | 'largeDiff';
+type DynamicModelTask = 'summarize' | 'commit' | 'commitSplit' | '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-6' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-7' | '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';
@@ -127,6 +127,38 @@ type BaseLLMService = {
          * @default false
          */
         markdown?: boolean;
+        /**
+         * Language-aware structural fast path (#883). Replace the LLM
+         * summary with a symbol-level extract ("added parseRequest();
+         * removed legacyParse()") for source files in the listed
+         * languages. Off by default; quality is harder to validate than
+         * the markdown fast path so we don't enable it without opt-in.
+         *
+         * Diffs without top-level structural signals (paragraph-only
+         * body edits, formatting changes) still go to the LLM regardless
+         * of this flag.
+         *
+         * Currently supports:
+         *   - 'ts' : `.ts` / `.tsx` / `.mts` / `.cts`
+         *   - 'js' : `.js` / `.jsx` / `.mjs` / `.cjs`
+         *   - 'py' : `.py` / `.pyi`
+         *   - 'rs' : `.rs`
+         *   - 'go' : `.go`
+         */
+        languageAware?: {
+            /**
+             * Master switch. When false (default) the languageAware path
+             * is skipped entirely regardless of `languages`.
+             *
+             * @default false
+             */
+            enabled?: boolean;
+            /**
+             * Languages to opt in. Omit / empty to enable all supported
+             * languages.
+             */
+            languages?: ('ts' | 'js' | 'py' | 'rs' | 'go')[];
+        };
     };
 };
 type Authentication = {
@@ -272,6 +304,20 @@ type BaseConfig = {
          * idle for >10s. Off by default so power users aren't distracted.
          */
         idleTips?: boolean;
+        /**
+         * Group adjacent commits in the history surface under shared section
+         * headers (`── Today ──`, `── Yesterday ──`, `── April 2026 ──`) and
+         * drop the per-row date column in favor of the headers. On by default
+         * because the bucketed view gives stronger temporal orientation at
+         * a glance and the freed cells go to the commit subject. Flip off if
+         * you prefer a date column on every row.
+         *
+         * Bucketing automatically suppresses itself while a search filter is
+         * active (results aren't chronological), regardless of this setting.
+         *
+         * @default true
+         */
+        dateBucketing?: boolean;
     };
 };
 type ConfigWithServiceObject = BaseConfig & Partial<BaseCommandOptions> & {
@@ -284,19 +330,43 @@ interface BaseArgvOptions {
     verbose: boolean;
     version: boolean;
     help: boolean;
+    /**
+     * Repository directory to operate against. When set, the command
+     * chdir's to this path before loading config / opening a git
+     * instance, so every downstream read (config lookup, simple-git
+     * baseDir, commitlint discovery, etc.) sees the same root.
+     *
+     * `--cwd` is an alias.
+     *
+     * Inherited by every coco subcommand so scripts / editor wrappers
+     * / scenario tests can target arbitrary repos without `cd`-ing
+     * first. Defaults to `process.cwd()` when omitted (unchanged
+     * behavior for users who launch via the regular `cd && coco ...`
+     * path).
+     */
+    repo?: string;
 }
 interface BaseCommandOptions extends BaseArgvOptions {
 }
 
 interface CacheOptions extends BaseCommandOptions {
+    /**
+     * Positional list of language identifiers / aliases for the
+     * `prefetch` subcommand. Empty → interactive checkbox picker.
+     * Recognized values mirror the `COCO_PREFETCH` env-var grammar:
+     * `py`, `python`, `rs`, `rust`, `go`, `golang`, `all`.
+     */
+    languages?: string[];
 }
 type CacheArgv = Arguments<CacheOptions>;
 
-declare const _default$7: {
+declare const _default$9: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<{
-        subcommand: "clear" | "info" | undefined;
+        subcommand: "clear" | "info" | "parsers" | "prefetch" | "clear-parsers" | "clear-github" | undefined;
+    } & {
+        languages: string[] | undefined;
     }>;
     handler: (argv: CacheArgv) => Promise<void>;
 };
@@ -313,7 +383,7 @@ interface ChangelogOptions extends BaseCommandOptions {
 }
 type ChangelogArgv = Arguments<ChangelogOptions>;
 
-declare const _default$6: {
+declare const _default$8: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -336,7 +406,7 @@ interface CommitOptions extends BaseCommandOptions {
 }
 type CommitArgv = Arguments<CommitOptions>;
 
-declare const _default$5: {
+declare const _default$7: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -349,7 +419,7 @@ interface DoctorOptions extends BaseCommandOptions {
 }
 type DoctorArgv = Arguments<DoctorOptions>;
 
-declare const _default$4: {
+declare const _default$6: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -358,7 +428,7 @@ declare const _default$4: {
 
 type InstallationScope = 'global' | 'project';
 
-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>>>;
@@ -370,6 +440,7 @@ declare const _default$3: {
         verbose: boolean;
         version: boolean;
         help: boolean;
+        repo?: string | undefined;
         _: (string | number)[];
         $0: string;
     } | Promise<{
@@ -380,12 +451,44 @@ declare const _default$3: {
         verbose: boolean;
         version: boolean;
         help: boolean;
+        repo?: string | undefined;
         _: (string | number)[];
         $0: string;
     }>) => Promise<void>;
     options: Record<string, yargs.Options>;
 };
 
+interface IssuesOptions extends BaseCommandOptions {
+    state?: 'open' | 'closed' | 'all';
+    assignee?: string;
+    author?: string;
+    label?: string;
+    search?: string;
+    /** Convenience flag → `--assignee @me`. */
+    mine?: boolean;
+    limit?: number;
+    /** Print machine-readable JSON instead of the formatted table. */
+    json?: boolean;
+    /**
+     * Force a fresh `gh` call even if the cached entry is within
+     * the TTL. The fresh result still gets written back to cache.
+     */
+    refresh?: boolean;
+    /**
+     * Disable cache entirely — skip read AND write. Useful when
+     * piping into tooling that manages its own freshness.
+     */
+    noCache?: boolean;
+}
+type IssuesArgv = Arguments<IssuesOptions>;
+
+declare const _default$4: {
+    command: string;
+    desc: string;
+    builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
+    handler: (argv: IssuesArgv) => Promise<void>;
+};
+
 type LogFormat = 'table' | 'json';
 type LogView = 'compact' | 'graph' | 'full';
 interface LogOptions extends BaseCommandOptions {
@@ -404,7 +507,7 @@ interface LogOptions extends BaseCommandOptions {
 }
 type LogArgv = Arguments<LogOptions>;
 
-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>>>;
@@ -412,6 +515,40 @@ declare const _default$2: {
     options: Record<string, yargs.Options>;
 };
 
+interface PrsOptions extends BaseCommandOptions {
+    state?: 'open' | 'closed' | 'merged' | 'all';
+    assignee?: string;
+    author?: string;
+    label?: string;
+    search?: string;
+    base?: string;
+    head?: string;
+    draft?: boolean;
+    /** Convenience flag → `--assignee @me`. */
+    mine?: boolean;
+    limit?: number;
+    /** Print machine-readable JSON instead of the formatted table. */
+    json?: boolean;
+    /**
+     * Force a fresh `gh` call even if the cached entry is within
+     * the TTL. The fresh result still gets written back to cache.
+     */
+    refresh?: boolean;
+    /**
+     * Disable cache entirely — skip read AND write. Useful when
+     * piping into tooling that manages its own freshness.
+     */
+    noCache?: boolean;
+}
+type PrsArgv = Arguments<PrsOptions>;
+
+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: PrsArgv) => Promise<void>;
+};
+
 interface RecapOptions extends BaseCommandOptions {
     yesterday?: boolean;
     'last-week'?: boolean;
@@ -575,6 +712,22 @@ interface BaseParserOptions {
          * @default false
          */
         markdown?: boolean;
+        /**
+         * Language-aware structural fast path (#883). Replaces the LLM
+         * summary with a symbol-level extract ("added parseRequest();
+         * removed legacyParse()") for source files in the listed
+         * languages. Off by default — lossy by design, and quality is
+         * harder to validate than the markdown fast path.
+         */
+        languageAware?: {
+            enabled?: boolean;
+            /**
+             * Languages to opt in. Omit / empty to enable all currently
+             * supported languages. Today: 'ts' (covers .ts/.tsx/.mts/.cts),
+             * 'js' (covers .js/.jsx/.mjs/.cjs).
+             */
+            languages?: ('ts' | 'js' | 'py' | 'rs' | 'go')[];
+        };
     };
     metadata?: Partial<LlmCallMetadata>;
 }
@@ -612,5 +765,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$7 as cache, _default$6 as changelog, _default$5 as commit, _default$4 as doctor, _default$3 as init, _default$2 as log, _default$1 as recap, types_d as types, _default as ui };
+export { _default$9 as cache, _default$8 as changelog, _default$7 as commit, _default$6 as doctor, _default$5 as init, _default$4 as issues, _default$3 as log, _default$2 as prs, _default$1 as recap, types_d as types, _default as ui };
 export type { Config$1 as Config };