gut-cli 0.1.12 → 0.1.14

package/.gut/branch.md

@@ -0,0 +1,27 @@
+You are an expert at creating git branch names.
+
+Generate a clean, descriptive branch name for the following:
+
+## Description
+
+{{description}}
+
+{{#type}}
+Branch type: {{type}}
+{{/type}}
+
+{{#issue}}
+Include issue number: {{issue}}
+{{/issue}}
+
+## Rules
+
+- Use format: `<type>/<short-description>`
+- Types: feature, fix, hotfix, chore, refactor, docs, test
+- Use kebab-case for description
+- Keep it short (under 50 chars total)
+- No special characters except hyphens and slashes
+
+## Output
+
+Respond with ONLY the branch name, nothing else.

package/.gut/changelog.md

@@ -0,0 +1,38 @@
+You are an expert at writing release notes and changelogs.
+
+Generate a changelog entry for changes from {{fromRef}} to {{toRef}}.
+
+Today's date is {{todayDate}}. Use this date for the release date.
+
+## Commits
+
+{{commits}}
+
+## Diff summary
+
+```
+{{diff}}
+```
+
+## Format
+
+Use Keep a Changelog format (https://keepachangelog.com/):
+- Group changes by: Added, Changed, Deprecated, Removed, Fixed, Security
+- Each item should be a concise description of the change
+- Use past tense
+
+## Focus on
+
+- User-facing changes and improvements
+- Bug fixes and their impact
+- Breaking changes (highlight these)
+- Group related changes together
+- Write for end users, not developers (unless it's a library)
+
+## Output
+
+Respond with a JSON object containing:
+- version: Version string if detected (optional)
+- date: Release date in YYYY-MM-DD format
+- sections: Array of { type, items[] }
+- summary: Brief summary of this release (optional)

package/.gut/checkout.md

@@ -0,0 +1,29 @@
+# Checkout Branch Name Generation
+
+You are an expert at creating git branch names.
+
+Analyze the following git diff and generate a clean, descriptive branch name that captures the essence of the changes.
+
+## Git diff
+
+```
+{{diff}}
+```
+
+## Branch Naming Convention
+
+- Use format: `<type>/<short-description>`
+- Types: feature, fix, hotfix, chore, refactor, docs, test
+- Use kebab-case for description
+- Keep it short (under 50 chars total)
+- No special characters except hyphens and slashes
+
+## Focus on
+
+- The main purpose of the changes
+- Whether it's a feature, fix, refactor, etc.
+- Key files or functionality being modified
+
+## Output
+
+Respond with ONLY the branch name, nothing else.

package/.gut/commit.md

@@ -0,0 +1,22 @@
+You are an expert at writing git commit messages.
+
+Analyze the following git diff and generate a concise, meaningful commit message.
+
+## Git diff
+
+```
+{{diff}}
+```
+
+## Rules
+
+- Use format: `<type>(<scope>): <description>`
+- Types: feat, fix, docs, style, refactor, perf, test, chore, build, ci
+- Scope is optional but helpful
+- Description should be lowercase, imperative mood, no period at end
+- Keep the first line under 72 characters
+- If changes are complex, add a blank line and bullet points for details
+
+## Output
+
+Respond with ONLY the commit message, nothing else.

package/.gut/config.json

@@ -0,0 +1,3 @@
+{
+  "lang": "en"
+}

package/.gut/explain-file.md

@@ -0,0 +1,30 @@
+You are an expert at explaining code in a clear and insightful way.
+
+Analyze the following file and explain what it does, its purpose, and its role in a project.
+
+## File
+
+Path: {{filePath}}
+
+```
+{{content}}
+```
+
+## Focus on
+
+- What this file does (main functionality)
+- Its purpose and role in the codebase
+- Key functions, classes, or components it defines
+- Dependencies and what it interacts with
+- Any important patterns or architecture decisions
+
+## Output
+
+Explain in a way that helps someone quickly understand this file's purpose and how it fits into the larger codebase.
+
+Respond with a JSON object containing:
+- summary: One-line summary
+- purpose: The purpose and role of this code
+- changes: Array of { file, description }
+- impact: What impact or role this has in the project
+- notes: Important considerations or caveats (optional)

package/.gut/explain.md

@@ -0,0 +1,31 @@
+You are an expert at explaining code changes in a clear and insightful way.
+
+Analyze the following {{targetType}} and provide a comprehensive explanation.
+
+## Context
+
+{{context}}
+
+## Diff
+
+```
+{{diff}}
+```
+
+## Focus on
+
+- What the changes accomplish (not just what files changed)
+- WHY these changes were likely made
+- The broader context and purpose
+- Any important implications or side effects
+
+## Output
+
+Explain in a way that helps someone understand not just the "what" but the "why" behind these changes.
+
+Respond with a JSON object containing:
+- summary: One-line summary
+- purpose: The purpose and role of this code
+- changes: Array of { file, description }
+- impact: What impact or role this has in the project
+- notes: Important considerations or caveats (optional)

package/.gut/find.md

@@ -0,0 +1,25 @@
+You are an expert at understanding git history and finding relevant commits.
+
+The user is looking for commits related to: "{{query}}"
+
+## Commits to search
+
+```
+{{commits}}
+```
+
+## Instructions
+
+Find the commits that best match the user's query. Consider:
+- Commit messages that mention similar concepts
+- Related features, bug fixes, or changes
+- Semantic similarity (e.g., "login" matches "authentication")
+
+Return up to {{maxResults}} matching commits, ordered by relevance (most relevant first).
+Only include commits that actually match the query - if none match well, return an empty array.
+
+## Output
+
+Respond with a JSON object containing:
+- matches: Array of { hash, reason }
+- summary: Brief summary of the search results (optional)

package/.gut/gitignore.md

@@ -0,0 +1,42 @@
+You are an expert at creating .gitignore files.
+
+Analyze the following project structure and configuration files to generate an appropriate .gitignore file.
+
+## Project Structure
+
+```
+{{files}}
+```
+
+{{#configFiles}}
+## Detected Config Files
+
+{{configFiles}}
+{{/configFiles}}
+
+{{#existingGitignore}}
+## Existing .gitignore
+
+```
+{{existingGitignore}}
+```
+{{/existingGitignore}}
+
+## Rules
+
+- Detect the language/framework being used (Node.js, Python, Go, Rust, Java, Ruby, PHP, .NET, etc.)
+- Include common ignore patterns for the detected stack
+- Include OS-specific files (.DS_Store, Thumbs.db, etc.)
+- Include IDE/editor files (.vscode/, .idea/, *.swp, etc.)
+- Include environment files (.env, .env.local, etc.)
+- Include build outputs and dependencies based on detected stack
+- Include log files and temporary files
+- Do NOT ignore files that should be tracked (source code, configs, etc.)
+- Keep the file organized with comments for each section
+{{#existingGitignore}}
+- Preserve any project-specific patterns from the existing .gitignore
+{{/existingGitignore}}
+
+## Output
+
+Respond with ONLY the .gitignore content, nothing else. Include section comments for clarity.

package/.gut/merge.md

@@ -0,0 +1,30 @@
+You are an expert at resolving git merge conflicts intelligently.
+
+Analyze the following conflicted file and provide a resolution.
+
+## Context
+
+- File: {{filename}}
+- Merging: {{theirsRef}} into {{oursRef}}
+
+## Conflicted content
+
+```
+{{content}}
+```
+
+## Rules
+
+- Understand the intent of both changes
+- Combine changes when both are valid additions
+- Choose the more complete/correct version when they conflict
+- Preserve all necessary functionality
+- The resolved content should be valid, working code
+- Do NOT include conflict markers (<<<<<<, =======, >>>>>>)
+
+## Output
+
+Respond with a JSON object containing:
+- resolvedContent: The resolved file content
+- explanation: Brief explanation of how the conflict was resolved
+- strategy: "ours" | "theirs" | "combined" | "rewritten"

package/.gut/pr.md

@@ -0,0 +1,36 @@
+You are an expert at writing pull request descriptions.
+
+Generate a clear and informative PR title and description based on the following information.
+
+## Context
+
+- Branch: {{currentBranch}} -> {{baseBranch}}
+- Commits:
+{{commits}}
+
+## Diff summary
+
+```
+{{diff}}
+```
+
+## Rules for title
+
+- Title should be concise (under 72 chars), start with a verb
+
+## Rules for description
+
+- Description should have:
+  - ## Summary section with 2-3 bullet points
+  - ## Changes section listing key modifications
+  - ## Test Plan section (suggest what to test)
+
+## Output
+
+Respond in JSON format:
+```json
+{
+  "title": "...",
+  "body": "..."
+}
+```

package/.gut/review.md

@@ -0,0 +1,24 @@
+You are an expert code reviewer. Analyze the following git diff and provide a structured review.
+
+## Git diff
+
+```
+{{diff}}
+```
+
+## Focus on
+
+- Bugs and potential issues
+- Security vulnerabilities
+- Performance concerns
+- Code style and best practices
+- Suggestions for improvement
+
+## Output
+
+Be constructive and specific. Include line numbers when possible.
+
+Respond with a JSON object containing:
+- summary: Brief overall assessment
+- issues: Array of { severity: "critical"|"warning"|"suggestion", file, line?, message, suggestion? }
+- positives: Array of good practices observed

package/.gut/stash.md

@@ -0,0 +1,20 @@
+You are an expert at summarizing code changes.
+
+Generate a short, descriptive stash name for the following changes.
+
+## Diff
+
+```
+{{diff}}
+```
+
+## Rules
+
+- Start with "WIP: " prefix
+- Keep it under 50 characters total
+- Be specific about what the changes do
+- Use present tense
+
+## Output
+
+Respond with ONLY the stash name, nothing else.

package/.gut/summary.md

@@ -0,0 +1,38 @@
+You are an expert at writing work summaries and reports.
+
+Generate a clear, professional work summary for the following git activity.
+
+## Context
+
+- Author: {{author}}
+- Period: {{period}}
+- Format: {{format}}
+
+## Commits
+
+{{commits}}
+
+{{#diff}}
+## Diff summary
+
+```
+{{diff}}
+```
+{{/diff}}
+
+## Focus on
+
+- What was accomplished (not just listing commits)
+- Group related work together
+- Highlight important achievements
+- Use clear, non-technical language where possible
+- Make it suitable for sharing with team or manager
+
+## Output
+
+Respond with a JSON object containing:
+- title: One-line title for the summary
+- overview: Brief overview of what was accomplished
+- highlights: Array of key accomplishments
+- details: Array of { category, items[] }
+- stats: { commits, filesChanged?, additions?, deletions? } (optional)

package/README.md

@@ -35,6 +35,7 @@ npm install -g gut-cli
 | `gut config` | Manage configuration (language, etc.) |
 | `gut lang` | Set or show output language |
 | `gut init` | Initialize .gut/ templates in your project |
+| `gut gitignore` | Generate .gitignore from codebase |
 
 ### `gut commit`
 
@@ -389,6 +390,32 @@ gut init --provider openai
 
 Templates are automatically translated to your configured language (set via `gut lang`).
 
+### `gut gitignore`
+
+Generate a .gitignore file by analyzing your project structure.
+
+```bash
+# Generate .gitignore (prompts before overwriting)
+gut gitignore
+
+# Auto-overwrite without confirmation
+gut gitignore --yes
+
+# Print to stdout instead of file
+gut gitignore --stdout
+
+# Use specific provider
+gut gitignore --provider openai
+```
+
+**How it works:**
+- Scans your project structure (files and directories)
+- Detects config files (package.json, Cargo.toml, go.mod, pyproject.toml, etc.)
+- Identifies the language/framework stack
+- Generates appropriate ignore patterns
+
+**Template Support**: Create `.gut/gitignore.md` to customize the generation prompt.
+
 ### `gut cleanup`
 
 Delete merged branches safely.
@@ -457,6 +484,7 @@ gut looks for template files in your repository's `.gut/` folder. Each template
 | `.gut/changelog.md` | Changelog format |
 | `.gut/stash.md` | Stash name prompt |
 | `.gut/summary.md` | Work summary format |
+| `.gut/gitignore.md` | Gitignore generation prompt |
 | `.github/pull_request_template.md` | GitHub PR template (prioritized over `.gut/pr.md`) |
 
 ## Development

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/commands/cleanup.ts
 import { Command } from "commander";
@@ -735,6 +735,20 @@ async function resolveConflict(conflictedContent, context, options, template) {
   });
   return result.object;
 }
+async function generateGitignore(context, options, template) {
+  const model = await getModel(options);
+  const prompt = applyTemplate(template, "gitignore", {
+    files: context.files,
+    configFiles: context.configFiles,
+    existingGitignore: context.existingGitignore
+  });
+  const result = await generateText({
+    model,
+    prompt,
+    maxTokens: 2e3
+  });
+  return result.text.trim();
+}
 
 // src/commands/commit.ts
 var commitCommand = new Command3("commit").description("Generate a commit message using AI").option("-p, --provider <provider>", "AI provider (gemini, openai, anthropic)", "gemini").option("-m, --model <model>", "Model to use (provider-specific)").option("-c, --commit", "Automatically commit with the generated message").option("-a, --all", "Force stage all changes (default: auto-stage if nothing staged)").action(async (options) => {
@@ -2477,8 +2491,181 @@ var initCommand = new Command17("init").description("Initialize .gut/ templates
   console.log(chalk18.gray("\nYou can now customize these templates for your project."));
 });
 
+// src/commands/gitignore.ts
+import { Command as Command18 } from "commander";
+import chalk19 from "chalk";
+import ora15 from "ora";
+import { simpleGit as simpleGit15 } from "simple-git";
+import { readdirSync as readdirSync2, readFileSync as readFileSync7, existsSync as existsSync6, writeFileSync as writeFileSync4 } from "fs";
+import { join as join6 } from "path";
+var CONFIG_FILES = [
+  // JavaScript/TypeScript
+  "package.json",
+  "tsconfig.json",
+  "vite.config.ts",
+  "vite.config.js",
+  "next.config.js",
+  "next.config.mjs",
+  "nuxt.config.ts",
+  "astro.config.mjs",
+  // Python
+  "pyproject.toml",
+  "setup.py",
+  "requirements.txt",
+  "Pipfile",
+  "poetry.lock",
+  // Go
+  "go.mod",
+  "go.sum",
+  // Rust
+  "Cargo.toml",
+  "Cargo.lock",
+  // Java/Kotlin
+  "pom.xml",
+  "build.gradle",
+  "build.gradle.kts",
+  // Ruby
+  "Gemfile",
+  "Gemfile.lock",
+  // PHP
+  "composer.json",
+  "composer.lock",
+  // .NET
+  "*.csproj",
+  "*.fsproj",
+  "*.sln",
+  // Elixir
+  "mix.exs",
+  // Dart/Flutter
+  "pubspec.yaml",
+  // Swift
+  "Package.swift"
+];
+function getFiles(dir, maxDepth = 3, currentDepth = 0) {
+  if (currentDepth >= maxDepth) return [];
+  const files = [];
+  try {
+    const entries = readdirSync2(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.name === "vendor" || entry.name === "target" || entry.name === "__pycache__" || entry.name === "venv" || entry.name === ".venv") {
+        continue;
+      }
+      const fullPath = join6(dir, entry.name);
+      if (entry.isDirectory()) {
+        files.push(entry.name + "/");
+        const subFiles = getFiles(fullPath, maxDepth, currentDepth + 1);
+        files.push(...subFiles.map((f) => entry.name + "/" + f));
+      } else {
+        files.push(entry.name);
+      }
+    }
+  } catch {
+  }
+  return files;
+}
+function findConfigFiles(repoRoot) {
+  const found = /* @__PURE__ */ new Map();
+  for (const configFile of CONFIG_FILES) {
+    if (configFile.includes("*")) {
+      const ext = configFile.replace("*", "");
+      try {
+        const entries = readdirSync2(repoRoot);
+        for (const entry of entries) {
+          if (entry.endsWith(ext)) {
+            const content = readFileSync7(join6(repoRoot, entry), "utf-8");
+            found.set(entry, content.slice(0, 2e3));
+          }
+        }
+      } catch {
+      }
+    } else {
+      const filePath = join6(repoRoot, configFile);
+      if (existsSync6(filePath)) {
+        try {
+          const content = readFileSync7(filePath, "utf-8");
+          found.set(configFile, content.slice(0, 2e3));
+        } catch {
+        }
+      }
+    }
+  }
+  return found;
+}
+var gitignoreCommand = new Command18("gitignore").description("Generate .gitignore from current codebase").option("-p, --provider <provider>", "AI provider (gemini, openai, anthropic)", "gemini").option("-m, --model <model>", "Model to use (provider-specific)").option("-o, --output <file>", "Output file (default: .gitignore)", ".gitignore").option("--stdout", "Print to stdout instead of file").option("-y, --yes", "Overwrite existing .gitignore without confirmation").action(async (options) => {
+  const git = simpleGit15();
+  const repoRoot = await git.revparse(["--show-toplevel"]).catch(() => process.cwd());
+  const root = repoRoot.trim();
+  const provider = options.provider.toLowerCase();
+  const template = findTemplate(root, "gitignore");
+  if (template) {
+    console.log(chalk19.gray("Using template from project..."));
+  }
+  const spinner = ora15("Analyzing project structure...").start();
+  const files = getFiles(root);
+  const configFiles = findConfigFiles(root);
+  const gitignorePath = join6(root, options.output);
+  let existingGitignore;
+  if (existsSync6(gitignorePath)) {
+    existingGitignore = readFileSync7(gitignorePath, "utf-8");
+  }
+  let configFilesStr = "";
+  if (configFiles.size > 0) {
+    const entries = [];
+    for (const [name, content] of configFiles) {
+      entries.push(`### ${name}
+\`\`\`
+${content}
+\`\`\``);
+    }
+    configFilesStr = entries.join("\n\n");
+  }
+  spinner.text = "Generating .gitignore...";
+  try {
+    const gitignoreContent = await generateGitignore(
+      {
+        files: files.slice(0, 200).join("\n"),
+        configFiles: configFilesStr,
+        existingGitignore
+      },
+      { provider, model: options.model },
+      template || void 0
+    );
+    spinner.stop();
+    if (options.stdout) {
+      console.log(gitignoreContent);
+      return;
+    }
+    console.log(chalk19.bold("\nGenerated .gitignore:\n"));
+    console.log(chalk19.gray("\u2500".repeat(50)));
+    console.log(gitignoreContent);
+    console.log(chalk19.gray("\u2500".repeat(50)));
+    console.log();
+    if (existsSync6(gitignorePath) && !options.yes) {
+      const readline = await import("readline");
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+      const answer = await new Promise((resolve) => {
+        rl.question(chalk19.cyan(`${options.output} already exists. Overwrite? (y/N) `), resolve);
+      });
+      rl.close();
+      if (answer.toLowerCase() !== "y") {
+        console.log(chalk19.gray("Aborted."));
+        return;
+      }
+    }
+    writeFileSync4(gitignorePath, gitignoreContent);
+    console.log(chalk19.green(`\u2713 Wrote ${options.output}`));
+  } catch (error) {
+    spinner.fail("Failed to generate .gitignore");
+    console.error(chalk19.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+});
+
 // src/index.ts
-var program = new Command18();
+var program = new Command19();
 program.name("gut").description("Git Utility Tool - AI-powered git commands").version("0.1.0");
 program.addCommand(cleanupCommand);
 program.addCommand(authCommand);
@@ -2497,5 +2684,6 @@ program.addCommand(summaryCommand);
 program.addCommand(configCommand);
 program.addCommand(langCommand);
 program.addCommand(initCommand);
+program.addCommand(gitignoreCommand);
 program.parse();
 //# sourceMappingURL=index.js.map